IBM::StorageSystem::Interface - Class for operations with a IBM StorageSystem network interfaces
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"; # Get interface ethX0 on management node mgmt001st001 as an IBM::StorageSystem::Interface object my $interface = $ibm->interface('mgmt001st001:ethX0'); # Print the interface status print $interface->up_or_down; # Print the interface status print $interface->speed; # Alternately; print $ibm->interface('mgmt001st001:ethX0')->speed; # Print a list of all interfaces, the node on which they reside, # their status, speed and role foreach my $interface ( $ibm->get_interfaces ) { print "Node: " . $interface->node . "\n"; print "Interface: " . $interface->interface . "\n"; print "\tStatus: " . $interface->up_or_down . "\n"; print "\tSpeed: " . $interface->speed . "\n"; print "\tRole: " . $interface->subordinate_or_master . "\n----------\n"; }
Returns the interface bonding mode - Note that this attribute will likely be null for subordinate interfaces.
Returns the IP address(es) associated with the interface - note that this may be a single address, a comma-separated list of multiple addresses or null.
Returns the interface system name (e.g. ethX1).
Returns the MAC (Media Access Controll) address of the interface. <BNote> that the MAC address is returned in a URL percent encoded string - i.e. the colon character is encoded as the string "%3A".
Returns the MTU (Maximum Transmissable Unit) for the interface in MD.
Returns the role of the interface - either MASTER or SUBORDINATE.
returns the node on which the interface resides.
Returns the interfaces media speed in MB/s.
Returns the interface transmit hash policy - Note that this attribute will likely be null for subordinate interfaces.
Returns the up or down state of the interface - either UP or DOWN.
Luke Poskitt, <ltp at cpan.org>
<ltp at cpan.org>
Please report any bugs or feature requests to bug-ibm-v7000-interface at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=IBM-StorageSystem-Interface. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
bug-ibm-v7000-interface at rt.cpan.org
You can find documentation for this module with the perldoc command.
perldoc IBM::StorageSystem::Interface
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-Interface
AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/IBM-StorageSystem-Interface
CPAN Ratings
http://cpanratings.perl.org/d/IBM-StorageSystem-Interface
Search CPAN
http://search.cpan.org/dist/IBM-StorageSystem-Interface/
Copyright 2012 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.