1Info::Airespace(3) User Contributed Perl Documentation Info::Airespace(3)
2
6 SNMP::Info::Airespace - SNMP Interface to data from
7 AIRESPACE-WIRELESS-MIB and AIRESPACE-SWITCHING-MIB
8
10 Eric Miller
11
13 my $airespace = new SNMP::Info(
14 AutoSpecify => 1,
15 Debug => 1,
16 DestHost => 'myswitch',
17 Community => 'public',
18 Version => 2
19 )
20 or die "Can't connect to DestHost.\n";
22 my $class = $airespace->class();
24 print " Using device sub class : $class\n";
25
27 SNMP::Info::Airespace is a subclass of SNMP::Info that provides an
28 interface to AIRESPACE-WIRELESS-MIB and AIRESPACE-SWITCHING-MIB. These
29 MIBs are used in Airespace wireless switches, as well as, products from
30 Cisco, Nortel, and Alcatel which are based upon the Airespace platform.
31 The Airespace platform utilizes intelligent wireless switches which
33 control thin access points. The thin access points themselves are
34 unable to be polled for end station information.
35 This class emulates bridge functionality for the wireless switch. This
37 enables end station MAC addresses collection and correlation to the
38 thin access point the end station is using for communication.
39 Use or create a subclass of SNMP::Info that inherits this one. Do not
41 use directly.
42 Inherited Classes
44 None.
45 Required MIBs
47 AIRESPACE-WIRELESS-MIB
48 AIRESPACE-SWITCHING-MIB
49
51 These are methods that return scalar value from SNMP
52 $airespace->airespace_type()
54 ("agentInventoryMachineType")
55 $airespace->airespace_model()
57 ("agentInventoryMachineModel")
58 $airespace->airespace_serial()
60 ("agentInventorySerialNumber")
61 $airespace->airespace_maint_ver()
63 ("agentInventoryMaintenanceLevel")
64 $airespace->airespace_mac()
66 ("agentInventoryBurnedInMacAddress")
67 $airespace->airespace_os()
69 ("agentInventoryOperatingSystem")
70 $airespace->airespace_vendor()
72 ("agentInventoryManufacturerName")
73 $airespace->airespace_prod_name()
75 ("agentInventoryProductName")
76 $airespace->os_ver()
78 ("agentInventoryProductVersion")
79 $airespace->airespace_bssid_mode()
81 ("agentNetworkBroadcastSsidMode")
82 $airespace->airespace_mc_mode()
84 ("agentNetworkMulticastMode")
85 $airespace->airespace_lwapp_mode()
87 The LWAPP transport mode decides if the switch is operating in the
88 Layer2 or Layer3 mode.
89 ("agentSwitchLwappTransportMode")
91 $airespace->airespace_ul_mode()
93 Transfer upload mode configures the mode to use when uploading from
94 the switch. Normal usage tftp.
95 ("agentTransferUploadMode")
97 $airespace->airespace_ul_ip()
99 Transfer upload tftp server ip configures the IP address of the
100 server. It is valid only when the Transfer Mode is tftp.
101 ("agentTransferUploadServerIP")
103 $airespace->airespace_ul_path()
105 Transfer upload tftp path configures the directory path where the
106 file is to be uploaded to. The switch remembers the last file path
107 used.
108 ("agentTransferUploadPath")
110 $airespace->airespace_ul_file()
112 ("agentTransferUploadFilename")
113 $airespace->airespace_ul_type()
115 Transfer upload datatype configures the type of file to upload from
116 the switch.
117 The types for upload are:
119 config(2)
120 errorlog(3)
121 systemtrace(4)
122 traplog(5)
123 crashfile(6)
124 ("agentTransferUploadDataType")
126 $airespace->airespace_ul_start()
128 ("agentTransferUploadStart")
129 $airespace->airespace_ul_status()
131 ("agentTransferUploadStatus")
132 Overrides
134 $airespace->layers()
135 Returns 00000011. Class emulates Layer 2 functionality for Thin
136 APs through proprietary MIBs.
137 $airespace->serial()
139 ("agentInventorySerialNumber")
140
142 These are methods that return tables of information in the form of a
143 reference to a hash.
144 $airespace->i_ssidlist()
146 Returns reference to hash. SSID's recognized by the radio
147 interface.
148 $airespace->i_ssidbcast()
150 Returns reference to hash. Indicates whether the SSID is
151 broadcast.
152 $airespace->i_80211channel()
154 Returns reference to hash. Current operating frequency channel of
155 the radio interface.
156 Dot11 Ess Table ("bsnDot11EssTable")
158 Ess(WLAN) Configuration Table. Maximum of 17 WLANs can be created on
159 Airespace Switch. Index of 17 is reserved for WLAN for Third Party
160 APs(non-Airespace APs).
161 $airespace->airespace_ess_idx()
163 ("bsnDot11EssIndex")
164 $airespace->airespace_ess_ssid()
166 SSID assigned to ESS(WLAN)
167 ("bsnDot11EssSsid")
169 $airespace->airespace_ess_macflt()
171 Select to filter clients by MAC address. By selecting this
172 Security, you need to create MAC Filters in "bsnUsersTable" or have
173 MAC Filters configured on Radius Servers specified in
174 "bsnRadiusAuthenticationTable"
175 ("bsnDot11EssMacFiltering")
177 $airespace->airespace_ess_status()
179 Administrative Status of ESS(WLAN).
180 ("bsnDot11EssAdminStatus")
182 $airespace->airespace_ess_sec_auth()
184 Type of 802.11 Authentication.
185 ("bsnDot11EssSecurityAuthType")
187 $airespace->airespace_ess_radio_pol()
189 Radio Policy for a WLAN. It can either be All where it will be
190 applicable to ALL types of protocols or it can be set to apply to
191 combinations of 802.11a, 802.11b, 802.11g.
192 ("bsnDot11EssRadioPolicy")
194 $airespace->airespace_ess_qos()
196 Quality of Service for a WLAN.
197 ("bsnDot11EssQualityOfService")
199 $airespace->airespace_ess_ifname()
201 Name of the interface used by this WLAN.
202 ("bsnDot11EssInterfaceName")
204 $airespace->airespace_ess_aclname()
206 Name of ACL for the WLAN. This is applicable only when Web
207 Authentication is enabled.
208 ("bsnDot11EssAclName")
210 AP Table ("bsnAPTable")
212 Table of Airespace APs managed by this Airespace Switch.
213 $airespace->airespace_ap_mac()
215 The MAC address of the 802.3 interface of the AP.
216 ("bsnAPDot3MacAddress")
218 $airespace->airespace_ap_name()
220 Name assigned to this AP. If an AP is not configured its factory
221 default name will be ap:<last three byte of MAC Address>. e.g.
222 ap:af:12:be
223 ("bsnAPName")
225 $airespace->airespace_ap_ip()
227 Ip address of the AP. This will not be available when the switch is
228 operating in the Layer2 mode. In this case, the attribute will
229 return 0 as value.
230 ("bsnApIpAddress")
232 $airespace->airespace_ap_loc()
234 User specified location of this AP.
235 ("bsnAPLocation")
237 $airespace->airespace_ap_sw()
239 ("bsnAPSoftwareVersion")
240 $airespace->airespace_ap_fw()
242 ("bsnAPBootVersion")
243 $airespace->airespace_ap_model()
245 ("bsnAPModel")
246 $airespace->airespace_ap_serial()
248 ("bsnAPSerialNumber")
249 $airespace->airespace_ap_type()
251 ("bsnAPType")
252 $airespace->airespace_ap_status()
254 ("bsnAPAdminStatus")
255 AP Interface Table ("bsnAPIfTable")
257 Table of 802.11 interfaces in an Airespace APs.
258 $airespace->airespace_apif_slot()
260 The slot Id of this interface. Value will be 0 for a 802.11a (5Ghz)
261 interface and will be 1 for 802.11b/g (2.4Ghz) interface.
262 ("bsnAPIfSlotId")
264 $airespace->airespace_apif_type()
266 ("bsnAPIfType")
267 $airespace->airespace_apif_ch_num()
269 ("bsnAPIfPhyChannelNumber")
270 $airespace->airespace_apif_power()
272 The transmit power level N currently being used to transmit data.
273 ("bsnAPIfPhyTxPowerLevel")
275 $airespace->airespace_apif()
277 ("bsnAPIfOperStatus")
278 $airespace->airespace_apif_oride()
280 This flag when disabled implies that all WLANs are available from
281 this radio. However, if this is enabled, then only those WLANs
282 that appear in the ("bsnApIfWlanOverrideTable") will be available
283 from this radio.
284 ("bsnAPIfWlanOverride")
286 $airespace->airespace_apif_admin()
288 ("bsnAPIfAdminStatus")
289 Mobile Station Table ("bsnMobileStationTable")
291 $airespace->airespace_sta_mac()
292 Mac Address of the AP on which Mobile Station is associated.
293 ("bsnMobileStationAPMacAddr")
295 $airespace->airespace_sta_slot()
297 Slot Id of AP If on which mobile station is associated.
298 ("bsnMobileStationAPIfSlotId")
300 $airespace->airespace_sta_ess_idx()
302 Ess Index of the Wlan(SSID) that is being used by Mobile Station to
303 connect to the AP.
304 ("bsnMobileStationEssIndex")
306 $airespace->airespace_sta_ssid()
308 The SSID Advertised by the Mobile Station.
309 ("bsnMobileStationSsid")
311 $airespace->airespace_sta_delete()
313 Action to Deauthenticate the Mobile Station. Set the State to
314 delete.
315 ("bsnMobileStationDeleteAction")
317 Users Table ("bsnUsersTable")
319 The (conceptual) table listing Wlan Users.
320 $airespace->airespace_user_name()
322 User name. For MAC filters, this will be the MAC address (e.g.
323 000123456789).
324 ("bsnUserName")
326 $airespace->airespace_user_pw()
328 User Password. For MAC filters, this will be "nopassword".
329 ("bsnUserPassword")
331 $airespace->airespace_user_ess_idx()
333 User WLAN ID. Value 0 implies that this applies to any WLAN ID.
334 ("bsnUserEssIndex")
336 $airespace->airespace_user_access()
338 For MAC filters, this will be "readOnly".
339 ("bsnUserAccessMode")
341 $airespace->airespace_user_type()
343 User Access Mode. For MAC filters, this will be "macFilter".
344 ("bsnUserType")
346 $airespace->airespace_user_ifname()
348 ACL for MAC Filters. An interface name from
349 "agentInterfaceConfigTable"
350 ("bsnUserInterfaceName")
352 $airespace->airespace_user_rstat()
354 ("bsnUserRowStatus")
355 Black List Client Table ("bsnBlackListClientTable")
357 The table listing Wlan Black Listed Clients
358 $airespace->airespace_bl_mac()
360 ("bsnBlackListClientMacAddress")
361 $airespace->airespace_bl_descr()
363 ("bsnBlackListClientDescription")
364 $airespace->airespace_bl_rstat()
366 ("bsnBlackListClientRowStatus")
367 AP Interface WLAN Override Table ("bsnAPIfWlanOverrideTable")
369 Each entry represents an SSID added to the AP when the attribute
370 "bsnAPIfWlanOverride" on the radio is enabled. This means only those
371 WLANs on the switch that are added to this table will be available on
372 such a radio.
373 $airespace->airespace_oride_id()
375 Index of the WLAN ("bsnDot11EssIndex") added to the radio.
376 ("bsnAPIfWlanOverrideId")
378 $airespace->airespace_oride_ssid()
380 SSID assigned to the override WLAN.
381 ("bsnAPIfWlanOverrideSsid")
383 Interface Config Table ("agentInterfaceConfigTable")
385 A table of the switch's Interface Config entries. Typically, it will
386 contain entries for Service Port Interface, DS Port Interface and
387 Virtual Gateway Interface apart from other entries.
388 $airespace->airespace_if_name()
390 Interface Name. This values is 'management' for DS port,
391 'service-port' for service port and 'virtual' for virtual gateway.
392 For other interfaces, the name can be anything. These interfaces
393 are already created by default.
394 ("agentInterfaceName")
396 $airespace->airespace_if_vlan()
398 VLAN Id configured for the Interface.
399 ("agentInterfaceVlanId")
401 $airespace->airespace_if_type()
403 The interface's type. The static type is set for the interfaces
404 that are created by default on the switch and these cannot be
405 deleted. Any other interface that is created is of type dynamic
406 which can be deleted.
407 ("agentInterfaceType")
409 $airespace->airespace_if_mac()
411 Interface MAC Address. This is only applicable in case of
412 management and service-port interfaces.
413 ("agentInterfaceMacAddress")
415 $airespace->airespace_if_ip()
417 ("agentInterfaceIPAddress")
418 $airespace->airespace_if_mask()
420 ("agentInterfaceIPNetmask")
421 $airespace->airespace_if_acl()
423 Name of the Access Control List applied to the interface. This
424 attribute is applicable only to the management interface and other
425 dynamic interfaces. If it is required to remove the ACL name for
426 an interface, it should be set to an empty string.
427 ("agentInterfaceAclName")
429 $airespace->airespace_if_rstat()
431 ("agentInterfaceRowStatus")
432 Port Config Table ("agentPortConfigTable")
434 $airespace->airespace_duplex_admin()
435 ("agentPortPhysicalMode")
436 $airespace->airespace_duplex()
438 ("agentPortPhysicalStatus")
439 Overrides
441 $airespace->i_index()
442 Returns reference to map of IIDs to Interface index.
443 Extends "ifIndex" to support thin APs and WLAN virtual interfaces
445 as device interfaces.
446 $airespace->interfaces()
448 Returns reference to map of IIDs to ports. Thin APs are
449 implemented as device interfaces. The thin AP MAC address
450 airespace_ap_mac() and Slot ID airespace_apif_slot() are used as
451 the port identifier. Virtual interfaces use airespace_if_name() as
452 the port identifier.
453 $airespace->i_name()
455 Returns reference to map of IIDs to interface names. Returns
456 "ifName" for Ethernet interfaces, airespace_ap_name() for thin AP
457 interfaces, and airespace_if_name() for virtual interfaces.
458 $airespace->i_description()
460 Returns reference to map of IIDs to interface types. Returns
461 "ifDescr" for Ethernet interfaces, airespace_ap_loc() for thin AP
462 interfaces, and airespace_if_name() for virtual interfaces.
463 $airespace->i_type()
465 Returns reference to map of IIDs to interface descriptions.
466 Returns "ifType" for Ethernet interfaces, airespace_apif_type() for
467 thin AP interfaces, and airespace_if_type() for virtual interfaces.
468 $airespace->i_up()
470 Returns reference to map of IIDs to link status of the interface.
471 Returns "ifOperStatus" for Ethernet interfaces and airespace_apif()
472 for thin AP interfaces.
473 $airespace->i_up_admin()
475 Returns reference to map of IIDs to administrative status of the
476 interface. Returns "ifAdminStatus" for Ethernet interfaces and
477 airespace_apif_admin() for thin AP interfaces.
478 $airespace->i_mac()
480 Returns reference to map of IIDs to MAC address of the interface.
481 Returns "ifPhysAddress" for Ethernet interfaces and
482 airespace_if_mac() for virtual interfaces.
483 $airespace->i_vlan()
485 Returns reference to map of IIDs to VLAN ID of the interface.
486 Returns airespace_if_vlan() for virtual interfaces.
487 $airespace->i_duplex()
489 Returns reference to map of IIDs to current link duplex. Ethernet
490 interfaces only.
491 $airespace->i_duplex_admin()
493 Returns reference to hash of IIDs to admin duplex setting.
494 Ethernet interfaces only.
495 $airespace->ip_index()
497 Extends table by mapping airespace_if_ip() to the interface IID.
498 $airespace->ip_netmask()
500 Extends IP table by mapping airespace_if_mask() to
501 airespace_if_ip()
502 $airespace->bp_index()
504 Simulates bridge MIB by returning reference to a hash mapping
505 i_index() to the interface iid.
506 $airespace->fw_port()
508 Returns reference to a hash, value being airespace_sta_mac() and
509 airespace_sta_slot() combined to match the interface iid.
510 $airespace->fw_mac()
512 ("bsnMobileStationMacAddress")
513 Pseudo ENTITY-MIB information
515 These methods emulate ENTITY-MIB Physical Table methods using
516 AIRESPACE-SWITCHING-MIB and AIRESPACE-WIRELESS-MIB. Thin APs are
517 included as subcomponents of the wireless controller.
518 $airespace->e_index()
520 Returns reference to hash. Key: IID and Value: Integer. The index
521 for APs is created with an integer representation of the last three
522 octets of the AP MAC address.
523 $airespace->e_class()
525 Returns reference to hash. Key: IID, Value: General hardware type.
526 Return ap for wireless access points.
527 $airespace->e_descr()
529 Returns reference to hash. Key: IID, Value: Human friendly name.
530 $airespace->e_model()
532 Returns reference to hash. Key: IID, Value: Model name.
533 $airespace->e_name()
535 More computer friendly name of entity. Name is either 'WLAN
536 Controller' or 'AP'.
537 $airespace->e_vendor()
539 Returns reference to hash. Key: IID, Value: cisco.
540 $airespace->e_serial()
542 Returns reference to hash. Key: IID, Value: Serial number.
543 $airespace->e_pos()
545 Returns reference to hash. Key: IID, Value: The relative position
546 among all entities sharing the same parent.
547 $airespace->e_type()
549 Returns reference to hash. Key: IID, Value: Type of component.
550 $airespace->e_fwver()
552 Returns reference to hash. Key: IID, Value: Firmware revision.
553 $airespace->e_swver()
555 Returns reference to hash. Key: IID, Value: Software revision.
556 $airespace->e_parent()
558 Returns reference to hash. Key: IID, Value: The value of e_index()
559 for the entity which 'contains' this entity.
560perl v5.12.0 2009-06-12 Info::Airespace(3)