NAME

SNMP::Info::Layer3::ArubaInstant - SNMP Interface to Aruba Instant access points

DESCRIPTION

Support for Aruba Instant 8.x wireless networks using AI-AP-MIB. Inherits physical interface and system information from SNMP::Info::Layer3::Aruba. ArubaOS 10 is not validated by this class.

Required MIBs

AI-AP-MIB

Inherited MIBs from SNMP::Info::Layer3::Aruba

Interfaces and wireless networks

i_index, interfaces, i_name, i_description, i_type, i_mac, i_up and i_up_admin preserve physical interfaces and add one port per AP radio, named after the AP MAC address and radio number. A radio port's index is the AP and radio index with a trailing .0. Radio status comes from the radio table.

i_ssidlist, i_ssidmac and i_ssidbcast expose each WLAN's name, BSSID and broadcast flag on the radio that serves it, keyed by the radio port index and the WLAN number. A WLAN's BSSID counts up from its radio's MAC address, so each radio owns the addresses from its MAC address up to the next radio's MAC address on the same AP. The highest radio owns a range as wide as the gap below it, or 16 addresses on a single-radio AP. A WLAN no range holds is omitted. When a radio on the AP reports no MAC address, its addresses could lie in any other radio's range, so each radio on that AP keeps only the 8 addresses from its own MAC address, the fewest Aruba assigns a radio.

Radio channel and power

i_80211channel exposes the numeric channel for each separate radio interface. Channel suffixes such as +, E and S remain in the radio interface description. dot11_cur_tx_pwr_mw converts radio power from dBm to integer milliwatts, rounding to the nearest milliwatt. The dBm interpretation follows the LibreNMS Aruba Instant implementation.

Wireless clients

fw_mac, fw_port and bp_index map associated clients onto the radio port that serves their BSSID, preserving wired forwarding entries. Clients whose BSSID belongs to no radio are omitted. Q-BRIDGE ports, which this agent numbers by ifIndex without a dot1dBasePortTable, are not mapped.

Aruba Instant Tables (AI-AP-MIB)

These methods return the AI-AP-MIB columns the class reads.

instant_radio_channel

Returns reference to hash. Key: AP MAC and radio index, Value: channel, with any +, -, E or S suffix.

(aiRadioChannel)

instant_radio_power

Returns reference to hash. Key: AP MAC and radio index, Value: transmit power.

(aiRadioTransmitPower)

instant_radio_mac

Returns reference to hash. Key: AP MAC and radio index, Value: radio MAC address.

(aiRadioMACAddress)

instant_radio_status

Returns reference to hash. Key: AP MAC and radio index, Value: radio state.

(aiRadioStatus)

instant_wlan_ssid

Returns reference to hash. Key: AP MAC and WLAN index, Value: ESSID.

(aiWlanESSID)

instant_wlan_mac

Returns reference to hash. Key: AP MAC and WLAN index, Value: BSSID.

(aiWlanMACAddress)

instant_ap_name

Returns reference to hash. Key: AP MAC, Value: AP name.

(aiAPName)

instant_ap_status

Returns reference to hash. Key: AP MAC, Value: AP status.

(aiAPStatus)

instant_ssid

Returns reference to hash. Key: SSID index, Value: SSID.

(aiSSID)

instant_ssid_hide

Returns reference to hash. Key: SSID index, Value: whether the SSID is hidden.

(aiSSIDHide)

instant_client_mac

Returns reference to hash. Key: client MAC, Value: client MAC address.

(aiClientMACAddress)

instant_client_bssid

Returns reference to hash. Key: client MAC, Value: BSSID the client is associated with.

(aiClientWlanMACAddress)

instant_client_snr

Returns reference to hash. Key: client MAC, Value: signal to noise ratio.

(aiClientSNR)

instant_client_txrate

Returns reference to hash. Key: client MAC, Value: transmit rate in Mbps.

(aiClientTxRate)

instant_client_uptime

Returns reference to hash. Key: client MAC, Value: uptime since the last mobility event.

(aiClientUptime)

instant_client_txbytes

Returns reference to hash. Key: client MAC, Value: bytes transmitted.

(aiClientTxDataBytes)

instant_client_rxbytes

Returns reference to hash. Key: client MAC, Value: bytes received.

(aiClientRxDataBytes)

instant_client_txframes

Returns reference to hash. Key: client MAC, Value: frames transmitted.

(aiClientTxDataFrames)

instant_client_rxframes

Returns reference to hash. Key: client MAC, Value: frames received.

(aiClientRxDataFrames)

Interface methods

i_index

Returns physical indexes and synthetic radio identifiers.

interfaces

Returns physical port names and stable radio names.

i_name

Returns the same stable radio names alongside physical interface names.

i_description

Returns the AP name, radio number and raw channel for each radio.

i_type

Returns ieee80211 for radio interfaces.

i_mac

Returns the radio MAC address, when available, for each radio.

i_up

Returns radio status for radio interfaces.

i_up_admin

Returns radio operational status for radio interfaces; separate administrative status is not available from these tables.

i_ssidlist

Returns SSID names indexed by radio port and WLAN number.

i_ssidmac

Returns BSSIDs using the same indexes as i_ssidlist.

i_ssidbcast

Returns broadcast flags from the SSID hide setting, when available.

i_80211channel

Returns numeric channels indexed by synthetic radio interface.

dot11_cur_tx_pwr_mw

Returns radio transmit power converted from dBm to integer milliwatts.

bp_index

Adds BSSID to radio port mappings to physical bridge mappings.

fw_mac

Adds associated wireless client MAC addresses to wired forwarding entries.

fw_port

Maps associated clients to BSSIDs, which bp_index maps to radio ports.

Wireless Client Table Emulation

These methods emulate the CISCO-DOT11-ASSOCIATION-MIB cd11_* methods using the AI-AP-MIB aiClientTable. Keys are the client table index, the client MAC address. Only clients whose BSSID belongs to a radio are returned.

cd11_mac

Returns the client MAC address, decoded from the client table's index, so aiClientMACAddress is not walked.

cd11_ssid

Returns the SSID of the WLAN whose BSSID the client is associated with.

(aiClientWlanMACAddress, aiWlanESSID)

cd11_txrate

Returns reference to an array holding the client transmit rate in Mbps.

(aiClientTxRate)

cd11_sigqual

Returns the client signal to noise ratio.

(aiClientSNR)

cd11_sigstrength

Returns an empty hash: AI-AP-MIB reports no client RSSI.

cd11_uptime

Returns the client uptime, reset on each mobility event.

(aiClientUptime)

cd11_txbyte

Returns bytes transmitted by the client.

(aiClientTxDataBytes)

cd11_rxbyte

Returns bytes received by the client.

(aiClientRxDataBytes)

cd11_txpkt

Returns frames transmitted by the client.

(aiClientTxDataFrames)

cd11_rxpkt

Returns frames received by the client.

(aiClientRxDataFrames)