The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
IBM-StorageSystem-0.02
River stage one • 3 direct dependents • 3 total dependents
++
/ IBM::StorageSystem::Disk

NAME

IBM::StorageSystem::Disk - Class for operations with IBM StorageSystem disks

VERSION

Version 0.01

SYNOPSIS

IBM::StorageSystem::Disk is a utility class for operations with IBM StorageSystem disks.

        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";

        # Get drive ID 2 as an IBM::StorageSystem::Drive object - note that drive ID 2 
        # is not necessarily the physical disk in slot ID 2 - see notes below.
        my $drive = $ibm->drive( 2 );

        # Print the drive capacity in bytes
        print $drive->capacity;
        
        # Print the drive vendor and product IDs
        print "Vendor ID: ", $drive->vendor_id, " - Product ID: ", $drive->product_id, "\n";
        
        # Print the SAS port status and drive status for all drives in a nicely formatted list
        printf("%-20s%-20s%-20s%-20s\n", 'Drive', 'SAS Port 1 Status', 'SAS Port 2 Status', 'Status');
        printf("%-20s%-20s%-20s%-20s\n", '-'x18, '-'x18, '-'x18, '-'x18);
        map { printf( "%-20s%-20s%-20s%-20s\n", $_->id, $_->port_1_status, $_->port_2_status, $_->status) } $ibm->get_drives;

        # e.g.
        # Drive               SAS Port 1 Status   SAS Port 2 Status   Status              
        # ------------------  ------------------  ------------------  ------------------  
        # 0                   online              online              online              
        # 1                   online              online              online              
        # 2                   online              online              online              
        # 3                   online              online              online
        # ...

        # Print the drive ID, slot ID, MDisk name and member ID of all drives
        foreach my $drive ( $ibm->get_drives ) { 
                print '-'x50, "\n";
                print "Drive ID  : " . $drive->id . "\n";
                print "Slot ID   : " . $drive->slot_id . "\n";
                print "MDisk ID  : " . $drive->mdisk_name . "\n";
                print "Member ID : " . $drive->member_id . "\n";
        } 

        # e.g.  
        # --------------------------------------------------
        # Drive ID  : 0
        # Slot ID   : 17
        # MDisk ID  : host-9
        # Member ID : 3
        # --------------------------------------------------
        # Drive ID  : 1
        # Slot ID   : 19
        # MDisk ID  : host-2
        # Member ID : 11
        # --------------------------------------------------
        # Drive ID  : 2
        # Slot ID   : 19
        # MDisk ID  : host-1
        # Member ID : 8
        # --------------------------------------------------
        # ... etc.

METHODS

availability

Returns the disk availability status.

block_properties

Returns a comma-separated list of the disk block properties.

failure_group

Returns the disk failure group.

file_system

Returns the file system to which the disk is allocated.

name

Returns the name of the disk.

pool

Returns the pool of which the disk is a member.

status

Returns the disk status.

timestamp

Returns a timestamp of the last time at which the CTDB disk information was updated.

type

Returns the disk type.

AUTHOR

Luke Poskitt, <ltp at cpan.org>

BUGS

Please report any bugs or feature requests to bug-ibm-v7000-disk at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=IBM-StorageSystem-Disk. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc IBM::StorageSystem::Disk

You can also look for information at:

ACKNOWLEDGEMENTS

LICENSE AND COPYRIGHT

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.