GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CISCO::UCS::INTERCONNECT (3)

.ds Aq ’

NAME

Cisco::UCS::Interconnect - Class for operations with a Cisco UCS Fabric Interconnect

CONTENTS

SYNOPSIS



        print Memory:  . $ucs->interconnect(A)->serial . " Mb\n";

        print map { Interconnect  . $_->id .  serial:  . $_->serial . "\n" } $ucs->get_interconnects;



DESCRIPTION

Cisco::UCS::Interconnect is a class used to represent an abstracted interface to a Cisco Fabric Interconnect object in a Cisco::UCS system. This class provides functionality to retrieve information, statistics and child objects (like Cisco::UCS::Common::EthernetPorts).

Please note that you should not need to call the constructor directly as Cisco::UCS::Interconnect objects are created for you by the methods in the Cisco::UCS package parent class.

Because of the inexorible relationship of a Cisco UCS Fabric Interconnect as a hardware platform and the concept of a Cisco UCS management entity as a logical instance of the Cisco USCM running on the hardware platform of a Cisco UCS Interconnect, some boundaries between the two become blurred within this package.

This class can be used for monitoring load and retrieving physical interface and component states and statistics, however before employing it to do so, consider that SNMP provides similar interface statistic access with less complexity without requiring session management.

    METHODS

    dn

Returns the distinguished name of the fabric interconnect in the UCSM management informantion model.

    id

Returns the identifier (either A or B) of the fabric interconnect.

    model

Returns the vendor model code of the fabric interconnect.

    operability

Returns the operability status of the fabric interconnect.

    serial

Returns the serial number of the fabric interconnect.

    vendor

Returns the vendor identification of the fabric interconnect.

    memory

Returns the total installed memory in Mb.

    mgmt_ip

Returns the configured management interface IP address.

    mgmt_gw

Returns the configured management interface gateway IP address.

    mgmt_net

Returns the configured management interface netmask.

    get_fans



        my @fans = $ucs->interconnect(A)->get_fans;
        foreach my $fan (@fans) {
                print "Fan " . $fan->id . " thermal : " . $fan->thermal . "\n";
        }



Returns an array of Cisco::UCS::Common::Fan objects representing the fans installed in the fabric interconnect.

<B>PLEASE NOTEB>

Fan objects for Interconnects in the Cisco UCSM management information heirarchy changed from using the object identifier/description ’equipmentFan’ to ’equipmentFanModule’ somewhere between versions 2.0(1w) and 2.0(4a). Consequently if you find that the <B>fanB> methods do not work or return no output for your installation, then please use the comparitive <B>fanmoduleB> methods instead.

    get_fans



        my @fans = $ucs->interconnect(A)->get_fans;
        foreach my $fan (@fans) {
                print "Fan " . $fan->id . " thermal : " . $fan->thermal . "\n";
        }



Returns an array of Cisco::UCS::Common::Fan objects representing the fans installed in the fabric interconnect.

get_fan ( CW$id )



        print "Fan 1 operability: " . $ucs->interconnect(A)->fan(1)->operability . "\n";



Returns a Cisco::UCS::Common::Fan object corresponding to the fans specified by the numerical identifier. Note that this is a non-caching method and when invoked will always query the UCSM. Consequently this method may be more expensive than the functionally equivalent caching <B>fanB> method.

fan ( CW$id )

Returns a Cisco::UCS::Common::Fan object corresponding to the fans specified by the numerical identifier. Note that this is a caching method and when invoked will return an object retrieved in a previous query if one is available.

get_fanmodules ( CW$id )

Returns an array of Cisco::UCS::Common::Fan objects representing the fans installed in the fabric interconnect.

<B>PLEASE NOTEB> : This method behaves identically to the aforementioned <B>get_fansB> method but due to USCM object naming changes between later versions, this method is to be used as an alternative to the <B>get_fansB> method only when the <B>get_fansB> method fails to work.

get_fanmodule ( CW$id )

Returns a Cisco::UCS::Common::Fan object corresponding to the fans specified by the numerical identifier.

<B>PLEASE NOTEB> : This method behaves identically to the aforementioned <B>get_fanB> method but due to USCM object naming changes between later versions, this method is to be used as an alternative to the <B>get_fanB> method only when the <B>get_fanB> method fails to work.

fanmodule ( CW$id )

Returns a Cisco::UCS::Common::Fan object corresponding to the fans specified by the numerical identifier.

<B>PLEASE NOTEB> : This method behaves identically to the aforementioned <B>fanB> method but due to USCM object naming changes between later versions, this method is to be used as an alternative to the <B>fanB> method only when the <B>fanB> method fails to work.

    get_psus



        my @psus = $ucs->interconnect(A)->get_psus;
        foreach my $psu (@psus) {
                print "PSU " . $psu->id . " thermal : " . $psu->thermal . "\n";
        }



Returns an array of Cisco::UCS::Common::PSU objects representing the PSUs installed in the fabric interconnect.

    get_psus



        my @psus = $ucs->interconnect(A)->get_psus;
        foreach my $psu (@psus) {
                print "PSU " . $psu->id . " thermal : " . $psu->thermal . "\n";
        }



Returns an array of Cisco::UCS::Common::PSU objects representing the PSUs installed in the fabric interconnect.

get_psu ( CW$id )



        print "PSU 1 operability: " . $ucs->interconnect(A)->psu(1)->operability . "\n";



Returns a Cisco::UCS::Common::PSU object corresponding to the PSUs specified by the numerical identifier. Note that this is a non-caching method and when invoked will always query the UCSM. Consequently this method may be more expensive than the functionally equivalent caching <B>psuB> method.

psu ( CW$id )

Returns a Cisco::UCS::Common::PSU object corresponding to the PSUs specified by the numerical identifier. Note that this is a caching method and when invoked will return an object retrieved in a previous query if one is available.

    get_cards



        my @cards = $ucs->interconnect(A)->get_cards;
        foreach my $card (@cards) {
                print "Switchcard " . $card->id . " description : " . $card->description . "\n";
        }



Returns an array of Cisco::UCS::Common::SwitchCard objects representing the interface cards installed in the fabric interconnect.

get_card ( CW$id )



        print "Switchcard 1 operability: " . $ucs->interconnect(A)->card(1)->operability . "\n";



Returns a Cisco::UCS::Common::SwitchCard object corresponding to the interface card specified by the numerical identifier. Note that this is a non-caching method and when invoked will always query the UCSM. Consequently this method may be more expensive than the functionally equivalent caching <B>cardB> method.

card ( CW$id )

Returns a Cisco::UCS::Common::SwitchCard object corresponding to the interface card specified by the numerical identifier. Note that this is a caching method and when invoked will return an object retrieved in a previous query if one is available.

AUTHOR

Luke Poskitt, <ltp at cpan.org>

BUGS

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



You can also look for information at:
o RT: CPAN’s request tracker

<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Cisco-UCS-Interconnect>

o AnnoCPAN: Annotated CPAN documentation

<http://annocpan.org/dist/Cisco-UCS-Interconnect>

o CPAN Ratings

<http://cpanratings.perl.org/d/Cisco-UCS-Interconnect>

o Search CPAN

<http://search.cpan.org/dist/Cisco-UCS-Interconnect/>

LICENSE AND COPYRIGHT

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.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 CISCO::UCS::INTERCONNECT (3) 2012-10-17

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.