1SNMP::Info::Layer2::BayUsstearckC(o3n)tributed Perl DocuSmNeMnPt:a:tIinofno::Layer2::Baystack(3)
2
3
4

NAME

6       SNMP::Info::Layer2::Baystack - SNMP Interface to Avaya Ethernet Switch
7       (Baystack) and VSP 7000 series switches
8

AUTHOR

10       Eric Miller
11

SYNOPSIS

13        # Let SNMP::Info determine the correct subclass for you.
14        my $baystack = new SNMP::Info(
15                                 AutoSpecify => 1,
16                                 Debug       => 1,
17                                 DestHost    => 'myswitch',
18                                 Community   => 'public',
19                                 Version     => 2
20                               )
21         or die "Can't connect to DestHost.\n";
22
23        my $class = $baystack->class();
24        print "SNMP::Info determined this device to fall under subclass : $class\n";
25

DESCRIPTION

27       Provides abstraction to the configuration information obtainable from
28       an Avaya Ethernet Switch (formerly Nortel/Bay Baystack) and VSP 7000
29       series through SNMP.
30
31       For speed or debugging purposes you can call the subclass directly, but
32       not after determining a more specific class using the method above.
33
34       my $baystack = new SNMP::Info::Layer2::Baystack(...);
35
36   Inherited Classes
37       SNMP::Info::SONMP
38       SNMP::Info::NortelStack
39       SNMP::Info::RapidCity
40       SNMP::Info::LLDP
41       SNMP::Info::Layer3
42
43   Required MIBs
44       BAY-STACK-PETH-EXT-MIBB
45
46   Inherited MIBs
47       See "Required MIBs" in SNMP::Info::SONMP for its MIB requirements.
48
49       See "Required MIBs" in SNMP::Info::NortelStack for its MIB
50       requirements.
51
52       See "Required MIBs" in SNMP::Info::RapidCity for its MIB requirements.
53
54       See "Required MIBs" in SNMP::Info::LLDP for its MIB requirements.
55
56       See "Required MIBs" in SNMP::Info::Layer3 for its MIB requirements.
57

GLOBALS

59       These are methods that return scalar value from SNMP
60
61       $baystack->vendor()
62           Returns 'avaya'
63
64       $baystack->model()
65           Cross references $baystack->id() to the SYNOPTICS-MIB and returns
66           the results.  303s and 304s have the same ID, so we have a hack to
67           return depending on which it is.
68
69           Returns BPS for Business Policy Switch
70
71           For others extracts and returns the switch numeric designation.
72
73       $baystack->os()
74           Returns 'baystack' or 'boss' depending on software version.
75
76       $baystack->os_bin()
77           Returns the firmware version extracted from "sysDescr".
78
79       $baystack->stp_ver()
80           Returns the particular STP version running on this device.
81
82           Values: "nortelStpg", "pvst", "rstp", "mstp", "ieee8021d"
83
84           ("s5AgSysSpanningTreeOperMode")
85
86   Overrides
87       $baystack->index_factor()
88           Required by SNMP::Info::SONMP.  Number representing the number of
89           ports reserved per slot within the device MIB.
90
91           Index factor on the Baystack switches are determined by the
92           formula: Index Factor = 64 if (model = 470 or (os eq 'boss' and
93           operating in pure mode)) or else Index factor = 32.
94
95           Returns either 32 or 64 based upon the formula.
96
97   Global Methods imported from SNMP::Info::SONMP
98       See "GLOBALS" in SNMP::Info::SONMP for details.
99
100   Globals imported from SNMP::Info::NortelStack
101       See "GLOBALS" in SNMP::Info::NortelStack for details.
102
103   Global Methods imported from SNMP::Info::RapidCity
104       See "GLOBALS" in SNMP::Info::RapidCity for details.
105
106   Globals imported from SNMP::Info::LLDP
107       See documentation in "GLOBALS" in SNMP::Info::LLDP for details.
108
109   Globals imported from SNMP::Info::Layer3
110       See "GLOBALS" in SNMP::Info::Layer3 for details.
111

TABLE METHODS

113       These are methods that return tables of information in the form of a
114       reference to a hash.
115
116   Overrides
117       $baystack->interfaces()
118           Returns reference to the map between IID and physical Port.
119
120             Slot and port numbers on the Baystack switches are determined by the
121             formula:
122
123             port = (Interface index % Index factor)
124             slot = (int(Interface index / Index factor)) + Slot offset
125
126             The physical port name is returned as slot.port.
127
128       $baystack->i_ignore()
129           Returns reference to hash of IIDs to ignore.
130
131       $baystack->i_mac()
132           Returns the "ifPhysAddress" table entries.
133
134           Removes all entries matching '00:00:00:00:00:00' -- Certain
135           revisions of Baystack firmware report all zeros for each port mac.
136
137       $baystack->i_name()
138           Crosses "ifName" with "ifAlias" and returns the human set port name
139           if exists.
140
141       $baystack->peth_port_ifindex()
142           Maps the "pethPsePortTable" to "ifIndex" by way of the ENTITY-MIB.
143
144       $baystack->peth_port_power()
145           Power supplied by PoE ports, in milliwatts
146
147           ("bspePethPsePortExtMeasuredPower")
148
149   ENTITY-MIB Information
150       For older devices which do not support ENTITY-MIB, these methods
151       emulate Physical Table methods using S5-CHASSIS-MIB.  See "TABLE
152       METHODS" in SNMP::Info::NortelStack for details on ns_e_* methods.
153
154       $baystack->e_index()
155           If the device doesn't support "entPhysicalDescr", this will try
156           ns_e_index().  Note that this is based on "entPhysicalDescr" due to
157           implementation details of SNMP::Info::Entity::e_index().
158
159       $baystack->e_class()
160           If the device doesn't support "entPhysicalClass", this will try
161           ns_e_class().
162
163       $baystack->e_descr()
164           If the device doesn't support "entPhysicalDescr", this will try
165           ns_e_descr().
166
167       $baystack->e_name()
168           If the device doesn't support "entPhysicalName", this will try
169           ns_e_name().
170
171       $baystack->e_fwver()
172           If the device doesn't support "entPhysicalFirmwareRev", this will
173           try ns_e_fwver().
174
175       $baystack->e_hwver()
176           If the device doesn't support "entPhysicalHardwareRev", this will
177           try ns_e_hwver().
178
179       $baystack->e_parent()
180           If the device doesn't support "entPhysicalContainedIn", this will
181           try ns_e_parent().
182
183       $baystack->e_pos()
184           If the device doesn't support "entPhysicalParentRelPos", this will
185           try ns_e_pos().
186
187       $baystack->e_serial()
188           If the device doesn't support "entPhysicalSerialNum", this will try
189           ns_e_serial().
190
191       $baystack->e_swver()
192           If the device doesn't support "entPhysicalSoftwareRev", this will
193           try ns_e_swver().
194
195       $baystack->e_type()
196           If the device doesn't support "entPhysicalVendorType", this will
197           try ns_e_type().
198
199       $baystack->e_vendor()
200           If the device doesn't support "entPhysicalMfgName", this will try
201           ns_e_vendor().
202
203   Layer 2 Forwarding Database
204       These methods try to obtain the layer 2 forwarding database entries via
205       the normal bridge methods as well as SPBM entries via rapid city
206       methods.
207
208       $baystack->fw_mac()
209           Returns reference to hash of forwarding table MAC Addresses
210
211       $baystack->fw_port()
212           Returns reference to hash of forwarding table entries port
213           interface identifier (iid)
214
215       $baystack->qb_fw_vlan()
216           Returns reference to hash of forwarding table entries VLAN ID
217
218       $baystack->fw_status()
219           Returns reference to hash of forwarding table entries status
220
221   Table Methods imported from SNMP::Info::SONMP
222       See "TABLE METHODS" in SNMP::Info::SONMP for details.
223
224   Table Methods imported from SNMP::Info::NortelStack
225       See "TABLE METHODS" in SNMP::Info::NortelStack for details.
226
227   Table Methods imported from SNMP::Info::RapidCity
228       See "TABLE METHODS" in SNMP::Info::RapidCity for details.
229
230   Table Methods imported from SNMP::Info::LLDP
231       See documentation in "TABLE METHODS" in SNMP::Info::LLDP for details.
232
233   Table Methods imported from SNMP::Info::Layer3
234       See "TABLE METHODS" in SNMP::Info::Layer3 for details.
235
236
237
238perl v5.28.0                      2018-11-29   SNMP::Info::Layer2::Baystack(3)