NAME

SNMP::Info::RapidCity - SNMP Interface to the Avaya/Nortel RapidCity MIB

AUTHOR

Eric Miller

SYNOPSIS

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

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

DESCRIPTION

SNMP::Info::RapidCity is a subclass of SNMP::Info that provides an interface to the RAPID-CITY MIB. This MIB is used across the Avaya/Nortel Ethernet Routing Switch and Ethernet Switch product lines (Formerly known as Passport, BayStack, and Accelar), as well as, the VSP 9000 and 7000 series.

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

Inherited Classes

None.

Required MIBs

RAPID-CITY

GLOBAL METHODS

These are methods that return scalar values from SNMP

$rapidcity->rc_base_mac(): (rc2kChassisBaseMacAddr)
$rapidcity->rc_serial(): (rcChasSerialNumber)
$rapidcity->rc_ch_rev(): (rcChasHardwareRevision)
$rapidcity->chassis(): (rcChasType)
$rapidcity->slots(): (rcChasNumSlots)
$rapidcity->rc_virt_ip(): (rcSysVirtualIpAddr)
$rapidcity->rc_virt_mask(): (rcSysVirtualNetMask)
$rapidcity->tftp_host(): (rcTftpHost)
$rapidcity->tftp_file(): (rcTftpFile)
$rapidcity->tftp_action(): (rcTftpAction)
$rapidcity->tftp_result(): (rcTftpResult)

Overrides

$rapidcity->serial(): Returns serial number of the chassis

TABLE METHODS

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

$rapidcity->i_duplex()

Returns reference to map of IIDs to current link duplex.

$rapidcity->i_duplex_admin()

Returns reference to hash of IIDs to admin duplex setting.

$rapidcity->i_vlan()

Returns a mapping between ifIndex and the PVID or default VLAN.

$rapidcity->i_vlan_membership()

Returns reference to hash of arrays: key = ifIndex, value = array of VLAN IDs. These are the VLANs which are members of the egress list for the port.

Example:
my $interfaces = $rapidcity->interfaces();
my $vlans      = $rapidcity->i_vlan_membership();

foreach my $iid (sort keys %$interfaces) {
  my $port = $interfaces->{$iid};
  my $vlan = join(',', sort(@{$vlans->{$iid}}));
  print "Port: $port VLAN: $vlan\n";
}

$rapidcity->v_index()

Returns VLAN IDs

(rcVlanId)

$rapidcity->agg_ports()

Returns a HASH reference mapping from slave to master port for each member of a port bundle (MLT) on the device. Keys are ifIndex of the slave ports, Values are ifIndex of the corresponding master ports.

RAPID-CITY Port Table (`rcPortTable`)

$rapidcity->rc_index(): (rcPortIndex)
$rapidcity->rc_duplex(): (rcPortOperDuplex)
$rapidcity->rc_duplex_admin(): (rcPortAdminDuplex)
$rapidcity->rc_speed_admin(): (rcPortAdminSpeed)
$rapidcity->rc_auto(): (rcPortAutoNegotiate)
$rapidcity->rc_alias(): (rcPortName)

RAPID-CITY CPU Ethernet Port Table (`rc2kCpuEthernetPortTable`)

$rapidcity->rc_cpu_ifindex(): (rc2kCpuEthernetPortIfIndex)
$rapidcity->rc_cpu_admin(): (rc2kCpuEthernetPortAdminStatus)
$rapidcity->rc_cpu_oper(): (rc2kCpuEthernetPortOperStatus)
$rapidcity->rc_cpu_ip(): (rc2kCpuEthernetPortAddr)
$rapidcity->rc_cpu_mask(): (rc2kCpuEthernetPortMask)
$rapidcity->rc_cpu_auto(): (rc2kCpuEthernetPortAutoNegotiate)
$rapidcity->rc_cpu_duplex_admin(): (rc2kCpuEthernetPortAdminDuplex)
$rapidcity->rc_cpu_duplex(): (rc2kCpuEthernetPortOperDuplex)
$rapidcity->rc_cpu_speed_admin(): (rc2kCpuEthernetPortAdminSpeed)
$rapidcity->rc_cpu_speed_oper(): (rc2kCpuEthernetPortOperSpeed)
$rapidcity->rc_cpu_mac(): (rc2kCpuEthernetPortMgmtMacAddr)

RAPID-CITY VLAN Port Table (`rcVlanPortTable`)

$rapidcity->rc_i_vlan_if(): (rcVlanPortIndex)
$rapidcity->rc_i_vlan_num(): (rcVlanPortNumVlanIds)
$rapidcity->rc_i_vlan(): (rcVlanPortVlanIds)
$rapidcity->rc_i_vlan_type(): (rcVlanPortType)
$rapidcity->rc_i_vlan_pvid(): (rcVlanPortDefaultVlanId)
$rapidcity->rc_i_vlan_tag(): (rcVlanPortPerformTagging)

RAPID-CITY VLAN Table (`rcVlanTable`)

$rapidcity->rc_vlan_id(): (rcVlanId)
$rapidcity->v_name(): (rcVlanName)
$rapidcity->rc_vlan_color(): (rcVlanColor)
$rapidcity->rc_vlan_if(): (rcVlanIfIndex)
$rapidcity->rc_vlan_stg(): (rcVlanStgId)
$rapidcity->rc_vlan_type(): (rcVlanType)
$rapidcity->rc_vlan_members(): (rcVlanPortMembers)
$rapidcity->rc_vlan_mac(): (rcVlanMacAddress)

RAPID-CITY IP Address Table (`rcIpAddrTable`)

$rapidcity->rc_ip_index(): (rcIpAdEntIfIndex)
$rapidcity->rc_ip_addr(): (rcIpAdEntAddr)
$rapidcity->rc_ip_type(): (rcIpAdEntIfType)

RAPID-CITY Chassis Fan Table (`rcChasFanTable`)

$rapidcity->rc_fan_op(): (rcChasFanOperStatus)

RAPID-CITY Power Supply Table (`rcChasPowerSupplyTable`)

$rapidcity->rc_ps_op(): (rcChasPowerSupplyOperStatus)

RAPID-CITY Power Supply Detail Table (`rcChasPowerSupplyDetailTable`)

$rapidcity->rc_ps_type(): (rcChasPowerSupplyDetailType)
$rapidcity->rc_ps_serial(): (rcChasPowerSupplyDetailSerialNumber)
$rapidcity->rc_ps_rev(): (rcChasPowerSupplyDetailHardwareRevision)
$rapidcity->rc_ps_part(): (rcChasPowerSupplyDetailPartNumber)
$rapidcity->rc_ps_detail(): (rcChasPowerSupplyDetailDescription)

RAPID-CITY Card Table (`rcCardTable`)

$rapidcity->rc_c_type(): (rcCardType)
$rapidcity->rc_c_serial(): (rcCardSerialNumber)
$rapidcity->rc_c_rev(): (rcCardHardwareRevision)
$rapidcity->rc_c_part(): (rcCardPartNumber)

RAPID-CITY 2k Card Table (`rc2kCardTable`)

$rapidcity->rc2k_c_ftype(): (rc2kCardFrontType)
$rapidcity->rc2k_c_fdesc(): (rc2kCardFrontDescription)
$rapidcity->rc2k_c_fserial(): (rc2kCardFrontSerialNum)
$rapidcity->rc2k_c_frev(): (rc2kCardFrontHwVersion)
$rapidcity->rc2k_c_fpart(): (rc2kCardFrontPartNumber)
$rapidcity->rc2k_c_fdate(): (rc2kCardFrontDateCode)
$rapidcity->rc2k_c_fdev(): (rc2kCardFrontDeviations)
$rapidcity->rc2k_c_btype(): (rc2kCardBackType)
$rapidcity->rc2k_c_bdesc(): (rc2kCardBackDescription)
$rapidcity->rc2k_c_bserial(): (rc2kCardBackSerialNum)
$rapidcity->rc2k_c_brev(): (rc2kCardBackHwVersion)
$rapidcity->rc2k_c_bpart(): (rc2kCardBackPartNumber)
$rapidcity->rc2k_c_bdate(): (rc2kCardBackDateCode)
$rapidcity->rc2k_c_bdev(): (rc2kCardBackDeviations)

RAPID-CITY MDA Card Table (`rc2kMdaCardTable`)

$rapidcity->rc2k_mda_type(): (rc2kMdaCardType)
$rapidcity->rc2k_mda_desc(): (rc2kMdaCardDescription)
$rapidcity->rc2k_mda_serial(): (rc2kMdaCardSerialNum)
$rapidcity->rc2k_mda_rev(): (rc2kMdaCardHwVersion)
$rapidcity->rc2k_mda_part(): (rc2kMdaCardPartNumber)
$rapidcity->rc2k_mda_date(): (rc2kMdaCardDateCode)
$rapidcity->rc2k_mda_dev(): (rc2kMdaCardDeviations)

SET METHODS

These are methods that provide SNMP set functionality for overridden methods or provide a simpler interface to complex set operations. See "SETTING DATA VIA SNMP" in SNMP::Info for general information on set operations.

$rapidcity->set_i_speed_admin(speed, ifIndex)

Sets port speed, must be supplied with speed and port ifIndex. Speed choices are 'auto', '10', '100', '1000'.

Example:
my %if_map = reverse %{$rapidcity->interfaces()};
$rapidcity->set_i_speed_admin('auto', $if_map{'1.1'}) 
   or die "Couldn't change port speed. ",$rapidcity->error(1);

$rapidcity->set_i_duplex_admin(duplex, ifIndex)

Sets port duplex, must be supplied with duplex and port ifIndex. Speed choices are 'auto', 'half', 'full'.

Example:
my %if_map = reverse %{$rapidcity->interfaces()};
$rapidcity->set_i_duplex_admin('auto', $if_map{'1.1'}) 
  or die "Couldn't change port duplex. ",$rapidcity->error(1);

$rapidcity->set_i_vlan(vlan, ifIndex)

Changes an access (untagged) port VLAN, must be supplied with the numeric VLAN ID and port ifIndex. This method will modify the port's VLAN membership and PVID (default VLAN). This method should only be used on end station (non-trunk) ports.

Example:
my %if_map = reverse %{$rapidcity->interfaces()};
$rapidcity->set_i_vlan('2', $if_map{'1.1'}) 
  or die "Couldn't change port VLAN. ",$rapidcity->error(1);

$rapidcity->set_i_pvid(pvid, ifIndex)

Sets port PVID or default VLAN, must be supplied with the numeric VLAN ID and port ifIndex. This method only changes the PVID, to modify an access (untagged) port use set_i_vlan() instead.

Example:
my %if_map = reverse %{$rapidcity->interfaces()};
$rapidcity->set_i_pvid('2', $if_map{'1.1'}) 
  or die "Couldn't change port PVID. ",$rapidcity->error(1);

$rapidcity->set_add_i_vlan_tagged(vlan, ifIndex)

Adds the port to the egress list of the VLAN, must be supplied with the numeric VLAN ID and port ifIndex.

Example:
my %if_map = reverse %{$rapidcity->interfaces()};
$rapidcity->set_add_i_vlan_tagged('2', $if_map{'1.1'}) 
  or die "Couldn't add port to egress list. ",$rapidcity->error(1);

$rapidcity->set_remove_i_vlan_tagged(vlan, ifIndex)

Removes the port from the egress list of the VLAN, must be supplied with the numeric VLAN ID and port ifIndex.

Example:
my %if_map = reverse %{$rapidcity->interfaces()};
$rapidcity->set_remove_i_vlan_tagged('2', $if_map{'1.1'}) 
  or die "Couldn't add port to egress list. ",$rapidcity->error(1);

$rapidcity->set_delete_vlan(vlan)

Deletes the specified VLAN from the device.

$rapidcity->set_create_vlan(name, vlan)

Creates the specified VLAN on the device.

Note: This method only allows creation of Port type VLANs and does not allow for the setting of the Spanning Tree Group (STG) which defaults to 1.

To install SNMP::Info, copy and paste the appropriate command in to your terminal.

cpanm

cpanm SNMP::Info

CPAN shell

perl -MCPAN -e shell
install SNMP::Info

For more information on module installation, please visit the detailed CPAN module installation guide.

	Global
`s`	Focus search bar
`?`	Bring up this help dialog

	GitHub
`g` `p`	Go to pull requests
`g` `i`	go to github issues (only if github is preferred repository)

	POD
`g` `a`	Go to author
`g` `c`	Go to changes
`g` `i`	Go to issues
`g` `d`	Go to dist
`g` `r`	Go to repository/SCM
`g` `s`	Go to source
`g` `b`	Go to file browse

	Search terms
module: (e.g. module:Plugin)
distribution: (e.g. distribution:Dancer auth)
author: (e.g. author:SONGMU Redis)
version: (e.g. version:1.00)

NAME

AUTHOR

SYNOPSIS

DESCRIPTION

Inherited Classes

Required MIBs

GLOBAL METHODS

Overrides

TABLE METHODS

RAPID-CITY Port Table (rcPortTable)

RAPID-CITY CPU Ethernet Port Table (rc2kCpuEthernetPortTable)

RAPID-CITY VLAN Port Table (rcVlanPortTable)

RAPID-CITY VLAN Table (rcVlanTable)

RAPID-CITY IP Address Table (rcIpAddrTable)

RAPID-CITY Chassis Fan Table (rcChasFanTable)

RAPID-CITY Power Supply Table (rcChasPowerSupplyTable)

RAPID-CITY Power Supply Detail Table (rcChasPowerSupplyDetailTable)

RAPID-CITY Card Table (rcCardTable)

RAPID-CITY 2k Card Table (rc2kCardTable)

RAPID-CITY MDA Card Table (rc2kMdaCardTable)