SNMP::Info::Airespace - SNMP Interface to data from AIRESPACE-WIRELESS-MIB and AIRESPACE-SWITCHING-MIB
Eric Miller
my $airespace = new SNMP::Info( AutoSpecify => 1, Debug => 1, DestHost => 'myswitch', Community => 'public', Version => 2 ) or die "Can't connect to DestHost.\n"; my $class = $airespace->class(); print " Using device sub class : $class\n";
SNMP::Info::Airespace is a subclass of SNMP::Info that provides an interface to AIRESPACE-WIRELESS-MIB and AIRESPACE-SWITCHING-MIB. These MIBs are used in Airespace wireless switches, as well as, products from Cisco, Nortel, and Alcatel which are based upon the Airespace platform.
The Airespace platform utilizes intelligent wireless switches which control thin access points. The thin access points themselves are unable to be polled for end station information.
This class emulates bridge functionality for the wireless switch. This enables end station MAC addresses collection and correlation to the thin access point the end station is using for communication.
Use or create a subclass of SNMP::Info that inherits this one. Do not use directly.
These are methods that return scalar value from SNMP
(agentInventoryMachineType)
agentInventoryMachineType
(agentInventoryMachineModel)
agentInventoryMachineModel
(agentInventorySerialNumber)
agentInventorySerialNumber
(agentInventoryMaintenanceLevel)
agentInventoryMaintenanceLevel
(agentInventoryBurnedInMacAddress)
agentInventoryBurnedInMacAddress
(agentInventoryOperatingSystem)
agentInventoryOperatingSystem
(agentInventoryManufacturerName)
agentInventoryManufacturerName
(agentInventoryProductName)
agentInventoryProductName
(agentInventoryProductVersion)
agentInventoryProductVersion
(agentNetworkBroadcastSsidMode)
agentNetworkBroadcastSsidMode
(agentNetworkMulticastMode)
agentNetworkMulticastMode
The LWAPP transport mode decides if the switch is operating in the Layer2 or Layer3 mode.
(agentSwitchLwappTransportMode)
agentSwitchLwappTransportMode
Transfer upload mode configures the mode to use when uploading from the switch. Normal usage tftp.
(agentTransferUploadMode)
agentTransferUploadMode
Transfer upload tftp server ip configures the IP address of the server. It is valid only when the Transfer Mode is tftp.
(agentTransferUploadServerIP)
agentTransferUploadServerIP
Transfer upload tftp path configures the directory path where the file is to be uploaded to. The switch remembers the last file path used.
(agentTransferUploadPath)
agentTransferUploadPath
(agentTransferUploadFilename)
agentTransferUploadFilename
Transfer upload datatype configures the type of file to upload from the switch.
The types for upload are: config(2) errorlog(3) systemtrace(4) traplog(5) crashfile(6)
(agentTransferUploadDataType)
agentTransferUploadDataType
(agentTransferUploadStart)
agentTransferUploadStart
(agentTransferUploadStatus)
agentTransferUploadStatus
Returns 00000111. Class emulates Layer 2 functionality for Thin APs through proprietary MIBs.
These are methods that return tables of information in the form of a reference to a hash.
Returns reference to hash. SSID's recognized by the radio interface.
Returns reference to hash. Indicates whether the SSID is broadcast.
Returns reference to hash. Current operating frequency channel of the radio interface.
Returns reference to hash. Current transmit power, in milliwatts, of the radio interface.
With the same keys as i_ssidlist, returns the Basic service set identification (BSSID), MAC address, the AP is using for the SSID.
bsnDot11EssTable
Ess(WLAN) Configuration Table. Maximum of 17 WLANs can be created on Airespace Switch. Index of 17 is reserved for WLAN for Third Party APs(non-Airespace APs).
(bsnDot11EssIndex)
bsnDot11EssIndex
SSID assigned to ESS(WLAN)
(bsnDot11EssSsid)
bsnDot11EssSsid
Select to filter clients by MAC address. By selecting this Security, you need to create MAC Filters in bsnUsersTable or have MAC Filters configured on Radius Servers specified in bsnRadiusAuthenticationTable
bsnUsersTable
bsnRadiusAuthenticationTable
(bsnDot11EssMacFiltering)
bsnDot11EssMacFiltering
Administrative Status of ESS(WLAN).
(bsnDot11EssAdminStatus)
bsnDot11EssAdminStatus
Type of 802.11 Authentication.
(bsnDot11EssSecurityAuthType)
bsnDot11EssSecurityAuthType
Radio Policy for a WLAN. It can either be All where it will be applicable to ALL types of protocols or it can be set to apply to combinations of 802.11a, 802.11b, 802.11g.
(bsnDot11EssRadioPolicy)
bsnDot11EssRadioPolicy
Quality of Service for a WLAN.
(bsnDot11EssQualityOfService)
bsnDot11EssQualityOfService
Name of the interface used by this WLAN.
(bsnDot11EssInterfaceName)
bsnDot11EssInterfaceName
Name of ACL for the WLAN. This is applicable only when Web Authentication is enabled.
(bsnDot11EssAclName)
bsnDot11EssAclName
This attribute when enabled allows the switch to broadcast this SSID.
(bsnDot11EssBroadcastSsid)
bsnDot11EssBroadcastSsid
bsnAPTable
Table of Airespace APs managed by this Airespace Switch.
The MAC address of the 802.3 interface of the AP.
(bsnAPDot3MacAddress)
bsnAPDot3MacAddress
Name assigned to this AP. If an AP is not configured its factory default name will be ap:<last three byte of MAC Address>. e.g. ap:af:12:be
(bsnAPName)
bsnAPName
Ip address of the AP. This will not be available when the switch is operating in the Layer2 mode. In this case, the attribute will return 0 as value.
(bsnApIpAddress)
bsnApIpAddress
User specified location of this AP.
(bsnAPLocation)
bsnAPLocation
(bsnAPSoftwareVersion)
bsnAPSoftwareVersion
(bsnAPBootVersion)
bsnAPBootVersion
(bsnAPModel)
bsnAPModel
(bsnAPSerialNumber)
bsnAPSerialNumber
(bsnAPType)
bsnAPType
(bsnAPAdminStatus)
bsnAPAdminStatus
bsnAPIfTable
Table of 802.11 interfaces in an Airespace APs.
The slot Id of this interface. Value will be 0 for a 802.11a (5Ghz) interface and will be 1 for 802.11b/g (2.4Ghz) interface.
(bsnAPIfSlotId)
bsnAPIfSlotId
(bsnAPIfType)
bsnAPIfType
(bsnAPIfPhyChannelNumber)
bsnAPIfPhyChannelNumber
The transmit power level N currently being used to transmit data.
(bsnAPIfPhyTxPowerLevel)
bsnAPIfPhyTxPowerLevel
(bsnAPIfOperStatus)
bsnAPIfOperStatus
This flag when disabled implies that all WLANs are available from this radio. However, if this is enabled, then only those WLANs that appear in the (bsnApIfWlanOverrideTable) will be available from this radio.
bsnApIfWlanOverrideTable
(bsnAPIfWlanOverride)
bsnAPIfWlanOverride
(bsnAPIfAdminStatus)
bsnAPIfAdminStatus
List of comma separated absolute power levels supported by the radio.
(bsnAPIfAbsolutePowerList)
bsnAPIfAbsolutePowerList
bsnMobileStationTable
Mac Address of the AP on which Mobile Station is associated.
(bsnMobileStationAPMacAddr)
bsnMobileStationAPMacAddr
Slot Id of AP If on which mobile station is associated.
(bsnMobileStationAPIfSlotId)
bsnMobileStationAPIfSlotId
Ess Index of the Wlan(SSID) that is being used by Mobile Station to connect to the AP.
(bsnMobileStationEssIndex)
bsnMobileStationEssIndex
The SSID Advertised by the Mobile Station.
(bsnMobileStationSsid)
bsnMobileStationSsid
Action to Deauthenticate the Mobile Station. Set the State to delete.
(bsnMobileStationDeleteAction)
bsnMobileStationDeleteAction
The (conceptual) table listing Wlan Users.
User name. For MAC filters, this will be the MAC address (e.g. 000123456789).
(bsnUserName)
bsnUserName
User Password. For MAC filters, this will be "nopassword".
(bsnUserPassword)
bsnUserPassword
User WLAN ID. Value 0 implies that this applies to any WLAN ID.
(bsnUserEssIndex)
bsnUserEssIndex
For MAC filters, this will be "readOnly".
(bsnUserAccessMode)
bsnUserAccessMode
User Access Mode. For MAC filters, this will be "macFilter".
(bsnUserType)
bsnUserType
ACL for MAC Filters. An interface name from agentInterfaceConfigTable
agentInterfaceConfigTable
(bsnUserInterfaceName)
bsnUserInterfaceName
(bsnUserRowStatus)
bsnUserRowStatus
bsnBlackListClientTable
The table listing Wlan Black Listed Clients
(bsnBlackListClientMacAddress)
bsnBlackListClientMacAddress
(bsnBlackListClientDescription)
bsnBlackListClientDescription
(bsnBlackListClientRowStatus)
bsnBlackListClientRowStatus
bsnAPIfWlanOverrideTable
Each entry represents an SSID added to the AP when the attribute bsnAPIfWlanOverride on the radio is enabled. This means only those WLANs on the switch that are added to this table will be available on such a radio.
Index of the WLAN (bsnDot11EssIndex) added to the radio.
(bsnAPIfWlanOverrideId)
bsnAPIfWlanOverrideId
SSID assigned to the override WLAN.
(bsnAPIfWlanOverrideSsid)
bsnAPIfWlanOverrideSsid
A table of the switch's Interface Config entries. Typically, it will contain entries for Service Port Interface, DS Port Interface and Virtual Gateway Interface apart from other entries.
Interface Name. This values is 'management' for DS port, 'service-port' for service port and 'virtual' for virtual gateway. For other interfaces, the name can be anything. These interfaces are already created by default.
(agentInterfaceName)
agentInterfaceName
VLAN Id configured for the Interface.
(agentInterfaceVlanId)
agentInterfaceVlanId
The interface's type. The static type is set for the interfaces that are created by default on the switch and these cannot be deleted. Any other interface that is created is of type dynamic which can be deleted.
(agentInterfaceType)
agentInterfaceType
Interface MAC Address. This is only applicable in case of management and service-port interfaces.
(agentInterfaceMacAddress)
agentInterfaceMacAddress
(agentInterfaceIPAddress)
agentInterfaceIPAddress
(agentInterfaceIPNetmask)
agentInterfaceIPNetmask
Name of the Access Control List applied to the interface. This attribute is applicable only to the management interface and other dynamic interfaces. If it is required to remove the ACL name for an interface, it should be set to an empty string.
(agentInterfaceAclName)
agentInterfaceAclName
(agentInterfaceRowStatus)
agentInterfaceRowStatus
agentPortConfigTable
(agentPortPhysicalMode)
agentPortPhysicalMode
(agentPortPhysicalStatus)
agentPortPhysicalStatus
Returns reference to map of IIDs to Interface index.
Extends ifIndex to support thin APs and WLAN virtual interfaces as device interfaces.
ifIndex
Returns reference to map of IIDs to ports. Thin APs are implemented as device interfaces. The thin AP MAC address airespace_ap_mac() and Slot ID airespace_apif_slot() are used as the port identifier. Virtual interfaces use airespace_if_name() as the port identifier.
Returns reference to map of IIDs to interface names. Returns ifName for Ethernet interfaces, airespace_ap_name() for thin AP interfaces, and airespace_if_name() for virtual interfaces.
ifName
Returns reference to map of IIDs to interface descriptions. Returns ifDescr for Ethernet interfaces, airespace_ap_loc() for thin AP interfaces, and airespace_if_name() for virtual interfaces.
ifDescr
Returns reference to map of IIDs to interface types. Returns ifType for Ethernet interfaces, airespace_apif_type() for thin AP interfaces, and airespace_if_type() for virtual interfaces.
ifType
Returns reference to map of IIDs to link status of the interface. Returns ifOperStatus for Ethernet interfaces and airespace_apif() for thin AP interfaces.
ifOperStatus
Returns reference to map of IIDs to administrative status of the interface. Returns ifAdminStatus for Ethernet interfaces and airespace_apif_admin() for thin AP interfaces.
ifAdminStatus
Returns reference to map of IIDs to MAC address of the interface. Returns ifPhysAddress for Ethernet interfaces and airespace_if_mac() for virtual interfaces.
ifPhysAddress
Returns reference to map of IIDs to VLAN ID of the interface. Returns airespace_if_vlan() for virtual interfaces.
Returns reference to map of IIDs to current link duplex. Ethernet interfaces only.
Returns reference to hash of IIDs to admin duplex setting. Ethernet interfaces only.
Extends table by mapping airespace_if_ip() to the interface IID.
Extends IP table by mapping airespace_if_mask() to airespace_if_ip()
Simulates bridge MIB by returning reference to a hash mapping i_index() to the interface iid.
Returns reference to a hash, value being airespace_sta_mac() and airespace_sta_slot() combined to match the interface iid.
(bsnMobileStationMacAddress)
bsnMobileStationMacAddress
These methods emulate ENTITY-MIB Physical Table methods using AIRESPACE-SWITCHING-MIB and AIRESPACE-WIRELESS-MIB. Thin APs are included as subcomponents of the wireless controller.
Returns reference to hash. Key: IID and Value: Integer. The index for APs is created with an integer representation of the last three octets of the AP MAC address.
Returns reference to hash. Key: IID, Value: General hardware type. Return ap for wireless access points.
Returns reference to hash. Key: IID, Value: Human friendly name.
Returns reference to hash. Key: IID, Value: Model name.
More computer friendly name of entity. Name is either 'WLAN Controller' or 'AP'.
Returns reference to hash. Key: IID, Value: cisco.
Returns reference to hash. Key: IID, Value: Serial number.
Returns reference to hash. Key: IID, Value: The relative position among all entities sharing the same parent.
Returns reference to hash. Key: IID, Value: Type of component.
Returns reference to hash. Key: IID, Value: Firmware revision.
Returns reference to hash. Key: IID, Value: Software revision.
Returns reference to hash. Key: IID, Value: The value of e_index() for the entity which 'contains' this entity.
The controller has knowledge of MAC->IP mappings for wireless clients. Augmenting the arp cache data with these MAC->IP mappings enables visibility for stations that only communicate locally.
Adds MAC addresses extracted from the index of bsnMobileStationIpAddress.
bsnMobileStationIpAddress
Adds IP addresses from bsnMobileStationIpAddress.
Truncate packet values to 32 bits.
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.