NAME

Cisco::UCS::Common::SwitchCard - Class for operations with a Cisco UCS switch card.

SYNOPSIS

        print $ucs->interconnect(A)->card(1)->operability;
        print $ucs->interconnect(A)->card(1)->serial;

        my $switchcard = $ucs->interconnect(A)->card(1);

        print $switchcard->num_ports;
        print $switchcard->description;

Cisco::UCS::Common::SwitchCard is a class used to represent a single Ethernet port in a Cisco::UCS system. This class provides functionality to retrieve information and statistics for Ethernet ports.

Please note that you should not need to call the constructor directly as Cisco::UCS::Common::SwitchCard objects are created for you by the methods in other Cisco::UCS packages like Cisco::UCS::Interconnect.

Dependent on UCSM version, some attributes of the Ethernet port may not be provided and hence the accessor methods may return an empty string.

METHODS

description

Returns the vendor description of the switchcard.

dn

Returns the distinguished name of the switchcard object in the UCSM management information model.

eth_port ( $id )

Returns a Cisco::UCS::Common::EthernetPort object representing the requested Ethernet port (given by the value of $id) on the switchcard.

Note that this is a caching method and a previously retrieved Ethernet port object will be returned if present. Should you require a fresh object, use the get_eth_port method described below.

get_eth_port ( $id )

Returns a Cisco::UCS::Common::EthernetPort object representing the requested Ethernet port (given by the value of $id) on the switchcard.

Note that this is a non-caching method and the UCSM will always be queried when this method is invoked. Subsequently, this method may be more expensive than the caching method eth_port described above.

get_eth_ports

Returns an array of Cisco::UCS::Common::EthernetPort objects representing all Etehrnet ports present on the specified card.

id

Returns the numerical identifier of the switchcard within the fabric interconnect.

model

Returns the model identifier of the switchcard.

num_ports

Returns the number of ports present on the switchcard.

operability

Returns the operability status of the switchcard.

performance

Returns the performance status of teh switchcard.

power

Returns the power status of the switchcard.

presence

Returns the presence status of the switchcard.

revision

Returns the hardware revision number of the switchcard.

serial

Returns the serial number of the switchcard.

state

Returns the operational state of the switchcard.

slot

returns the slot number of the switchcard.

thermal

Returns the thermal status of the switchcard.

vendor

Returns the vendor identification string of the switchcard.

voltage

Returns the voltage status of the siwtchcard.

AUTHOR

Luke Poskitt, "<ltp at cpan.org>"

BUGS

Please report any bugs or feature requests to "bug-cisco-ucs-common-switchcard at rt.cpan.org", or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Cisco-UCS-Common-SwitchCard>. 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 Cisco::UCS::Common::SwitchCard

You can also look for information at:

RT: CPAN's request tracker
<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Cisco-UCS-Common-SwitchCard>
AnnoCPAN: Annotated CPAN documentation
<http://annocpan.org/dist/Cisco-UCS-Common-SwitchCard>
CPAN Ratings
<http://cpanratings.perl.org/d/Cisco-UCS-Common-SwitchCard>
Search CPAN
<http://search.cpan.org/dist/Cisco-UCS-Common-SwitchCard/>

LICENSE AND COPYRIGHT

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.