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       For speed or debugging purposes you can call the subclass directly, but
37       not after determining a more specific class using the method above.
38
39       my $trapeze = new SNMP::Info::Layer2::Trapeze(...);
40
41   Inherited Classes
42       SNMP::Info
43       SNMP::Info::Bridge
44
45   Required MIBs
46       TRAPEZE-NETWORKS-REGISTRATION-DEVICES-MIB
47       TRAPEZE-NETWORKS-AP-STATUS-MIB
48       TRAPEZE-NETWORKS-CLIENT-SESSION-MIB
49       TRAPEZE-NETWORKS-SYSTEM-MIB
50       TRAPEZE-NETWORKS-BASIC-MIB
51
52   Inherited Classes' MIBs
53       See "Required MIBs" in SNMP::Info for its own MIB requirements.
54
55       See "Required MIBs" in SNMP::Info::Bridge for its own MIB requirements.
56

GLOBALS

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

TABLE METHODS

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