IBM::StorageSystem::VDisk::Copy - Class for operations with IBM StorageSystem VDisk Copies
Version 0.01
use IBM::StorageSystem; my $ibm = IBM::StorageSystem->new( user => 'admin', host => 'my-v7000', key_path => '/path/to/my/.ssh/private_key' ) or die "Couldn't create object! $!\n"; # Print the status of copy 0 of VDisk 0 print "Status: " . $ibm->vdisk(0)->copy(0)->status . "\n"; # Print each VDisk by name and each of the VDisk copies status foreach my $vdisk ( $ibm->get_vdisks ) { print "VDisk : " . $vdisk->name . "\n"; foreach my $copy ( $vdisk->get_copys ) { printf( "\tCopy: %-2s - Status : %-20s\n", $copy->copy_id, $copy->status ) } }
Specifies whether autoexpand is enabled on a space-efficient volume. The value can be on or off.
Returns the volume copy capacity in bytes.
Specifies a system-assigned identifier for the volume copy. The value can be 0 or 1.
This value is set by the user and determines whether Easy Tier(R) is permitted to manage the pool.
Note:
If easy_tier is on, then easy_tier_status can take on any value.
if easy_tier is off, then easy_tier_status is measured or inactive.
Which Easy Tier functions are active for the volume copy:
May move extents of this volume copy for performance (automatic data placement).
Statistics are being gathered for this volume copy, but no extents will be moved.
No Easy Tier function is active.
Specifies the cache state of the volume copy. The value can be empty, not_empty, corrupt, or repairing. The value is always empty for non-space-efficient copies. A cache state of corrupt indicates that the volume is space-efficient and requires repair that is initiated by a recovervdisk command or the repairsevdiskcopy command.
Specifies the difference between the real_capacity and used_capacity values.
Remember: This value is zero for fully-allocated copies.
For space-efficient volume copies, returns the copy grain size chosen at creation time.
Returns the volume copy MDisk group numerical ID.
Returns the volume copy MDisk group name.
Specifies the ID of the storage pool that the volume copy belongs to.
Specifies the name of the storage pool that the volume copy belongs to.
Expressed as a percentage, specifies the ratio of volume capacity to real_capacity values. This value is always 100 for non-space-efficient volumes.
Indicates whether the volume copy is the primary copy. A volume has exactly one primary copy. The value can be yes or no.
Specifies the amount of physical storage that is allocated from an storage pool to this volume copy. If the volume copy is not space-efficient, the value is the same as the volume capacity. If the volume copy is space-efficient, the value can be different.
Remember: This value is the same as the volume capacity value for fully-allocated copies.
Specifies if the copy is space-efficient.
The value can be online or offline. A copy is offline if all nodes cannot access the storage pool that contains the copy.
Indicates whether the volume copy is synchronized.
Which tier information is being reported: generic_ssd or generic_hdd.
Note that this method returns an array of the available tier types and that the ordering of these types is preserved from the CLI output. The ordering of these types can be used to retrieve the tier capacity of each tier type with the tier_capacity command.
The total MDisk capacity assigned to the volume in the tier.
Note: For space-efficient copies, the capacity by tier will be the real capacity.
Also Note that this method returns an array of all values of tier capacity the index of which corresponds with the array indexes of tier types as returned by the tier method.
For example, to print each tier type and the corresponding tier capacity for a copy:
my $copy = $ibm->vdisk(0)->copy(0); for ( my $i = 0; $i < scalar @{ $copy->tier } ; $i++ ) { print "Tier: " . $copy->tier->[$i] . " - Capacity: " . $copy->tier_capacity->[$i] . "\n" }
Specifies the virtualization type of the volume. The value can be striped, sequential or image.
Specifies the portion of real_capacity that is being used to store data. For non-space-efficient copies, this value is the same as the volume capacity. If the volume copy is space-efficient, the value increases from zero to the real_capacity value as more of the volume is written to.
Returns the VDisk numerical ID of the volume copy.
Returns the VDisk name of the volume copy.
Expressed as a percentage, for space-efficient volume copies only. A warning is generated when the ratio of used_capacity to volume capacity reaches the specified level.
Luke Poskitt, <ltp at cpan.org>
<ltp at cpan.org>
Please report any bugs or feature requests to bug-ibm-v7000-vdisk-copy at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=IBM-StorageSystem-VDisk::Copy. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
bug-ibm-v7000-vdisk-copy at rt.cpan.org
You can find documentation for this module with the perldoc command.
perldoc IBM::StorageSystem::VDisk::Copy
You can also look for information at:
RT: CPAN's request tracker (report bugs here)
http://rt.cpan.org/NoAuth/Bugs.html?Dist=IBM-StorageSystem-VDisk::Copy
AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/IBM-StorageSystem-VDisk::Copy
CPAN Ratings
http://cpanratings.perl.org/d/IBM-StorageSystem-VDisk::Copy
Search CPAN
http://search.cpan.org/dist/IBM-StorageSystem-VDisk::Copy/
Copyright 2013 Luke Poskitt.
This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.
See http://dev.perl.org/licenses/ for more information.
To install IBM::StorageSystem, copy and paste the appropriate command in to your terminal.
cpanm
cpanm IBM::StorageSystem
CPAN shell
perl -MCPAN -e shell install IBM::StorageSystem
For more information on module installation, please visit the detailed CPAN module installation guide.