1SNMP::Info::Layer2::TraUpseezre(C3o)ntributed Perl DocumSeNnMtPa:t:iIonnfo::Layer2::Trapeze(3)
2
3
4

NAME

6       SNMP::Info::Layer2::Trapeze - SNMP Interface to Juniper (Trapeze)
7       Wireless Controllers
8

AUTHOR

10       Eric Miller
11

SYNOPSIS

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

DESCRIPTION

29       Provides abstraction to the configuration information obtainable from
30       Juniper (Trapeze) Wireless Controllers through SNMP.
31
32       This class emulates bridge functionality for the wireless switch. This
33       enables end station MAC addresses collection and correlation to the
34       thin access point the end station is using for communication.
35
36   Inherited Classes
37       SNMP::Info::Layer2
38
39   Required MIBs
40       TRAPEZE-NETWORKS-REGISTRATION-DEVICES-MIB
41       TRAPEZE-NETWORKS-AP-STATUS-MIB
42       TRAPEZE-NETWORKS-CLIENT-SESSION-MIB
43       TRAPEZE-NETWORKS-SYSTEM-MIB
44       TRAPEZE-NETWORKS-BASIC-MIB
45
46   Inherited Classes' MIBs
47       See "Required MIBs" in SNMP::Info::Layer2 for its own MIB requirements.
48

GLOBALS

50       These are methods that return scalar value from SNMP
51
52       $trapeze->vendor()
53           Returns 'juniper'
54
55       $trapeze->os()
56           Returns 'trapeze'
57
58       $trapeze->os_ver()
59           ("trpzVersionString")
60
61       $trapeze->model()
62           Tries to reference $trapeze->id() to TRAPEZE-NETWORKS-REGISTRATION-
63           DEVICES-MIB
64
65           Removes 'wirelessLANController' for readability.
66
67       $trapeze->serial()
68           ("trpzSerialNumber")
69
70       $trapeze->mac()
71           ("dot1dBaseBridgeAddress")
72
73   Overrides
74       $trapeze->layers()
75           Returns 00000011.  Class emulates Layer 2 functionality for Thin
76           APs through proprietary MIBs.
77
78   Global Methods imported from SNMP::Info::Layer2
79       See documentation in "GLOBALS" in SNMP::Info::Layer2 for details.
80

TABLE METHODS

82       These are methods that return tables of information in the form of a
83       reference to a hash.
84
85       $trapeze->i_ssidlist()
86           Returns reference to hash.  SSID's recognized by the radio
87           interface.
88
89       $trapeze->i_80211channel()
90           Returns reference to hash.  Current operating frequency channel of
91           the radio interface.
92
93       $trapeze->dot11_cur_tx_pwr_mw()
94           Returns reference to hash.  Current transmit power, in milliwatts,
95           of the radio interface.
96
97       cd11_mac()
98           Client MAC address.
99
100   AP Status Table  ("trpzApStatApStatusTable")
101       A table describing all the APs currently present and managed by the
102       controller.
103
104       $trapeze->trapeze_ap_mac()
105           ("trpzApStatApStatusBaseMac")
106
107       $trapeze->trapeze_ap_name()
108           ("trpzApStatApStatusApName")
109
110       $nws2300->trapeze_ap_ip()
111           ("trpzApStatApStatusIpAddress")
112
113       $nws2300->trapeze_ap_sw()
114           ("trpzApStatApStatusSoftwareVer")
115
116       $nws2300->trapeze_ap_fw()
117           ("trpzApStatApStatusBootVer")
118
119       $nws2300->trapeze_ap_model()
120           ("trpzApStatApStatusModel")
121
122       $nws2300->trapeze_ap_type()
123           ("trpzApStatApStatusModel")
124
125       $nws2300->trapeze_ap_status()
126           ("trpzApStatApStatusApState")
127
128       $nws2300->trapeze_ap_vendor()
129           ("trpzApStatApStatusManufacturerId")
130
131       $nws2300->trapeze_ap_num()
132           ("trpzApStatApStatusApNum")
133
134       $nws2300->trapeze_ap_dapnum()
135           ("trpzApStatApStatusPortOrDapNum")
136
137   AP Radio Status Table  ("trpzApStatRadioStatusTable")
138       A table describing all radios on all the APs currently present and
139       managed by the controller.
140
141       $nws2300->trapeze_apif_mac()
142           ("trpzApStatRadioStatusBaseMac")
143
144       $nws2300->trapeze_apif_type()
145           ("trpzApStatRadioStatusRadioPhyType")
146
147       $nws2300->trapeze_apif_ch_num()
148           ("trpzApStatRadioStatusCurrentChannelNum")
149
150       $nws2300->trapeze_apif_power()
151           ("trpzApStatRadioStatusCurrentPowerLevel")
152
153       $nws2300->trapeze_apif_admin()
154           ("trpzApStatRadioStatusRadioMode")
155
156   AP Radio Status Service Table ("trpzApStatRadioServiceTable")
157       A table describing radio services associated with APs currently present
158       and managed by the controller.
159
160       $nws2300->trapeze_apif_bssid()
161           ("trpzApStatRadioServBssid")
162
163       $nws2300->trapeze_apif_prof()
164           ("trpzApStatRadioServServiceProfileName")
165
166   AP Service Profile Config Table ("trpzApConfServiceProfileTable")
167       $nws2300->trapeze_ess_bcast()
168           ("trpzApConfServProfBeaconEnabled")
169
170   AP Radio Config Table ("trpzApConfRadioConfigTable")
171       $nws2300->trapeze_apcr_txpwr()
172           ("trpzApConfRadioConfigTxPower")
173
174       $nws2300->trapeze_apcr_ch()
175           ("trpzApConfRadioConfigChannel")
176
177       $nws2300->trapeze_apcr_mode()
178           ("trpzApConfRadioConfigRadioMode")
179
180   AP Config Table ("trpzApConfApConfigTable")
181       $nws2300->trapeze_apc_descr()
182           ("trpzApConfApConfigDescription")
183
184       $nws2300->trapeze_apc_loc()
185           ("trpzApConfApConfigLocation")
186
187       $nws2300->trapeze_apc_name()
188           ("trpzApConfApConfigApName")
189
190       $nws2300->trapeze_apc_model()
191           ("trpzApConfApConfigApModelName")
192
193       $nws2300->trapeze_apc_serial()
194           ("trpzApConfApConfigApSerialNum")
195
196   Client Session Table ("trpzClSessClientSessionTable")
197       $nws2300->trapeze_sta_slot()
198           ("trpzClSessClientSessRadioNum")
199
200       $nws2300->trapeze_sta_serial()
201           ("trpzClSessClientSessApSerialNum")
202
203       $nws2300->trapeze_sta_ssid()
204           ("trpzClSessClientSessSsid")
205
206       $nws2300->trapeze_sta_ip()
207           ("trpzClSessClientSessIpAddress")
208
209   Client Session Statistics Table ("trpzClSessClientSessionStatisticsTable")
210       These emulate the CISCO-DOT11-MIB
211
212       $nws2300->cd11_sigstrength()
213           ("trpzClSessClientSessStatsLastRssi")
214
215       $nws2300->cd11_sigqual()
216           ("trpzClSessClientSessStatsLastSNR")
217
218       $nws2300->cd11_txrate()
219           ("trpzClSessClientSessStatsLastRate")
220
221       $nws2300->cd11_rxbyte()
222           ("trpzClSessClientSessStatsUniOctetIn")
223
224       $nws2300->cd11_txbyte()
225           ("trpzClSessClientSessStatsUniOctetOut")
226
227       $nws2300->cd11_rxpkt()
228           ("trpzClSessClientSessStatsUniPktIn")
229
230       $nws2300->cd11_txpkt()
231           ("trpzClSessClientSessStatsUniPktOut")
232
233   Table Methods imported from SNMP::Info
234       See documentation in "TABLE METHODS" in SNMP::Info::Layer2 for details.
235
236   Overrides
237       $trapeze->i_index()
238           Returns reference to map of IIDs to Interface index.
239
240           Extends "ifIndex" to support thin APs and WLAN virtual interfaces
241           as device interfaces.
242
243       $trapeze->interfaces()
244           Returns reference to map of IIDs to ports.  Thin APs are
245           implemented as device interfaces.  The thin AP MAC address and Slot
246           ID trapeze_apif_slot() are used as the port identifier.
247
248       $trapeze->i_name()
249           Returns reference to map of IIDs to interface names.  Returns
250           "ifName" for Ethernet interfaces and trapeze_ap_name() for thin AP
251           interfaces.
252
253       $trapeze->i_description()
254           Returns reference to map of IIDs to interface types.  Returns
255           "ifDescr" for Ethernet interfaces, trapeze_ap_name() for thin AP
256           interfaces.
257
258       $trapeze->i_type()
259           Returns reference to map of IIDs to interface descriptions.
260           Returns "ifType" for Ethernet interfaces and
261           'capwapWtpVirtualRadio' for thin AP interfaces.
262
263       $trapeze->i_up()
264           Returns reference to map of IIDs to link status of the interface.
265           Returns "ifOperStatus" for Ethernet interfaces and
266           trapeze_apif_admin() for thin AP interfaces.
267
268       $trapeze->i_up_admin()
269           Returns reference to map of IIDs to administrative status of the
270           interface.  Returns "ifAdminStatus" for Ethernet interfaces and
271           trapeze_apif_admin() for thin AP interfaces.
272
273       $trapeze->i_mac()
274           Returns reference to map of IIDs to MAC address of the interface.
275           Returns "ifPhysAddress" for Ethernet interfaces.
276
277       $trapeze->bp_index()
278           Simulates bridge MIB by returning reference to a hash mapping
279           i_index() to the interface iid.
280
281       $trapeze->fw_port()
282           Returns reference to a hash, value being mac and trapeze_sta_slot()
283           combined to match the interface iid.
284
285       $trapeze->fw_mac()
286           Extracts the MAC from the trapeze_sta_serial() index.
287
288   Pseudo ARP Cache Entries
289       The controller snoops on the MAC->IP mappings.  Using this as ARP cache
290       data allows us to get MAC->IP mappings even for stations that only
291       communicate locally.  The data is gathered from trapeze_sta_ip().
292
293       $trapeze->at_paddr()
294           Returns reference to hash of Pseudo Arp Cache Entries to MAC
295           address
296
297       $trapeze->at_netaddr()
298           Returns reference to hash of Pseudo Arp Cache Entries to IP Address
299
300   Pseudo ENTITY-MIB information
301       These methods emulate ENTITY-MIB Physical Table methods using TRAPEZE-
302       NETWORKS-AP-STATUS-MIB.  Thin APs are included as subcomponents of the
303       wireless controller.
304
305       $trapeze->e_index()
306           Returns reference to hash.  Key: IID and Value: Integer. The index
307           for APs is created with an integer representation of the last three
308           octets of the AP MAC address.
309
310       $trapeze->e_class()
311           Returns reference to hash.  Key: IID, Value: General hardware type.
312           Return ap for wireless access points.
313
314       $trapeze->e_descr()
315           Returns reference to hash.  Key: IID, Value: Human friendly name.
316
317       $trapeze->e_model()
318           Returns reference to hash.  Key: IID, Value: Model name.
319
320       $trapeze->e_name()
321           More computer friendly name of entity.  Name is either 'WLAN
322           Controller' or 'AP'.
323
324       $trapeze->e_vendor()
325           Returns reference to hash.  Key: IID, Value: avaya.
326
327       $trapeze->e_serial()
328           Returns reference to hash.  Key: IID, Value: Serial number.
329
330       $trapeze->e_pos()
331           Returns reference to hash.  Key: IID, Value: The relative position
332           among all entities sharing the same parent.
333
334       $trapeze->e_type()
335           Returns reference to hash.  Key: IID, Value: Type of component.
336
337       $trapeze->e_fwver()
338           Returns reference to hash.  Key: IID, Value: Firmware revision.
339
340       $trapeze->e_swver()
341           Returns reference to hash.  Key: IID, Value: Software revision.
342
343       $trapeze->e_parent()
344           Returns reference to hash.  Key: IID, Value: The value of e_index()
345           for the entity which 'contains' this entity.
346
347
348
349perl v5.32.1                      2021-01-27    SNMP::Info::Layer2::Trapeze(3)