/ 
SNMP-Info-0.9_01
River stage one • 1 direct dependent • 1 total dependent
/ SNMP::Info::NortelStack

NAME

SNMP::Info::NortelStack - Perl5 Interface to Nortel Stack information using SNMP

AUTHOR

Eric Miller (eric@jeneric.org)

SYNOPSIS

# Let SNMP::Info determine the correct subclass for you. 
my $stack = new SNMP::Info(
                         AutoSpecify => 1,
                         Debug       => 1,
                         # These arguments are passed directly on to SNMP::Session
                         DestHost    => 'myswitch',
                         Community   => 'public',
                         Version     => 2
                       ) 
   or die "Can't connect to DestHost.\n";

my $class      = $stack->class();
print "SNMP::Info determined this device to fall under subclass : $class\n";

DESCRIPTION

SNMP::Info::NortelStack is a subclass of SNMP::Info that provides an interface to S5-AGENT-MIB and S5-CHASSIS-MIB. These MIBs are used across the Nortel BayStack family, as well as, older Nortel devices such as the Centillion family of ATM switches.

Use or create in a subclass of SNMP::Info. Do not use directly.

Inherited Classes

None.

Required MIBs

S5-AGENT-MIB
S5-CHASSIS-MIB
S5-ROOT-MIB and S5-TCS-MIB are required by the other MIBs.

MIBs can be found on the CD that came with your product.

Or, they can be downloaded directly from Nortel Networks regardless of support contract status.

Go to http://www.nortelnetworks.com Techninal Support, Browse Technical Support, Select by product, Java Device Manager, Software. Download the latest version. After installation, all mibs are located under the install directory under mibs and the repspective product line.

Note: Recommend versions (located in JDM\mibs\bps2000\v3100.zip) S5-AGENT-MIB s5age154.mib S5-CHASSIS-MIB s5cha135.mib

GLOBAL METHODS

These are methods that return scalar values from SNMP

$baystack->serial()

Returns (s5ChasSerNum)

$stack->os_ver()

Returns the software version extracted from (s5AgInfoVer)

$stack->os_bin()

Returns the firmware version extracted from (s5AgInfoVer)

$stack->ns_ag_ver()

Returns the version of the agent in the form 'major.minor.maintenance[letters]'.

(s5AgInfoVer)

$stack->ns_op_mode()

Returns the stacking mode.

(s5AgSysCurrentOperationalMode)

$stack->tftp_action()

This object is used to download or upload a config file or an image file.

(s5AgInfoFileAction)

$stack->tftp_result()

Returns the status of the latest action as shown by $stack->tftp_action().

(s5AgInfoFileStatus)

$stack->ns_auto_pvid()

Returns the value indicating whether adding a port as a member of a VLAN automatically results in its PVID being set to be the same as that VLAN ID.

(s5AgSysAutoPvid)

$stack->tftp_file()

Name of the binary configuration file that will be downloaded/uploaded when the $stack->tftp_action() object is set.

(s5AgSysBinaryConfigFilename)

$stack->tftp_host()

The IP address of the TFTP server for all TFTP operations.

(s5AgSysTftpServerAddress)

$stack->vlan()

Returns the VLAN ID of the system's management VLAN.

(s5AgSysManagementVlanId)

$stack->ch_ser()

Returns the serial number of the chassis.

(s5ChasSerNum)

$stack->ns_cfg_chg()

Returns the total number of configuration changes (other than attachment changes, or physical additions or removals) in the chassis that have been detected since cold/warm start.

(s5ChasGblConfChngs)

$stack->ns_cfg_time()

Returns the value of sysUpTime when the last configuration change (other than attachment changes, or physical additions or removals) in the chassis was detected.

(s5ChasGblConfLstChng)

TABLE METHODS

These are methods that return tables of information in the form of a reference to a hash.

Agent Interface Table (s5AgMyIfTable)

$stack->i_cfg_file()

Returns reference to hash. Key: Table entry, Value: Name of the file

(s5AgMyIfCfgFname)

$stack->i_cfg_host()

Returns reference to hash. Key: Table entry, Value: IP address of the load server

(s5AgMyIfLdSvrAddr)

Chassis Components Table (s5ChasComTable)

$stack->ns_com_grp_idx()

Returns reference to hash. Key: Table entry, Value: Index of the chassis level group which contains this component.

(s5ChasComGrpIndx)

$stack->ns_com_ns_com_idx()

Returns reference to hash. Key: Table entry, Value: Index of the component in the group. For modules in the 'board' group, this is the slot number.

(s5ChasComIndx)

$stack->ns_com_sub_idx()

Returns reference to hash. Key: Table entry, Value: Index of the sub-component in the component.

(s5ChasComSubIndx)

$stack->ns_com_type()

Returns reference to hash. Key: Table entry, Value: Type

(s5ChasComType)

$stack->ns_com_descr()

Returns reference to hash. Key: Table entry, Value: Description

(s5ChasComDescr)

$stack->ns_com_ver()

Returns reference to hash. Key: Table entry, Value: Version

(s5ChasComVer)

$stack->ns_com_serial()

Returns reference to hash. Key: Table entry, Value: Serial Number

(s5ChasComSerNum)

Storage Area Table (s5ChasStoreTable)

$stack->ns_store_grp_idx()

Returns reference to hash. Key: Table entry, Value: Index of the chassis level group.

(s5ChasStoreGrpIndx)

$stack->ns_store_ns_com_idx()

Returns reference to hash. Key: Table entry, Value: Index of the group.

(s5ChasStoreComIndx)

$stack->ns_store_sub_idx()

Returns reference to hash. Key: Table entry, Value: Index of the sub-component.

(s5ChasStoreSubIndx)

$stack->ns_store_idx()

Returns reference to hash. Key: Table entry, Value: Index of the storage area.

(s5ChasStoreIndx)

$stack->ns_store_type()

Returns reference to hash. Key: Table entry, Value: Type

(s5ChasStoreType)

$stack->ns_store_size()

Returns reference to hash. Key: Table entry, Value: Size

(s5ChasStoreCurSize)

$stack->ns_store_ver()

Returns reference to hash. Key: Table entry, Value: Version

(s5ChasStoreCntntVer)