CISCO-LWAPP-LINKTEST-MIB: View SNMP OID List / Download MIB

This MIB is intended to be implemented on all those devices operating as Central controllers, that terminate the Light Weight Access Point Protocol tunnel from Cisco Light-weight LWAPP Access Points. Link Test is performed to learn the radio link quality between AP and Client. CCX linktest is performed for CCX clients. With CCX linktest radio link can be measured in both direction i.e. AP->Client(downLink) and Client->AP(uplink). When client does not support CCX or CCX linktest fails,ping is done between AP and Client. In ping test, only uplink (client->AP) quality can be measured. The relationship between the controller and the LWAPP APs is depicted as follows. +......+ +......+ +......+ +......+ + + + + + + + + + CC + + CC + + CC + + CC + + + + + + + + + +......+ +......+ +......+ +......+ .. . . . .. . . . . . . . . . . . . . . . . . . . . . . . +......+ +......+ +......+ +......+ +......+ + + + + + + + + + + + AP + + AP + + AP + + AP + + AP + + + + + + + + + + + +......+ +......+ +......+ +......+ +......+ . . . . . . . . . . . . . . . . . . . . . . . . +......+ +......+ +......+ +......+ +......+ + + + + + + + + + + + MN + + MN + + MN + + MN + + MN + + + + + + + + + + + +......+ +......+ +......+ +......+ +......+ The LWAPP tunnel exists between the controller and the APs. The MNs communicate with the APs through the protocol defined by the 802.11 standard. LWAPP APs, upon bootup, discover and join one of the controllers and forward all the 802.11 frames to them encapsulated inside LWAPP frames. GLOSSARY Access Point ( AP ) An entity that contains an 802.11 medium access control ( MAC ) and physical layer ( PHY ) interface and provides access to the distribution services via the wireless medium for associated clients. LWAPP APs encapsulate all the 802.11 frames in LWAPP frames and sends them to the controller to which it is logically connected. Central Controller ( CC ) The central entity that terminates the LWAPP protocol tunnel from the LWAPP APs. Throughout this MIB, this entity also referred to as 'controller'. Cisco Compatible eXtensions (CCX) Wireless LAN Access Points (APs) manufactured by Cisco Systems have features and capabilities beyond those in related standards (e.g., IEEE 802.11 suite of standards, Wi-Fi recommendations by WECA, 802.1X security suite, etc). A number of features provide higher performance. For example, Cisco AP transmits a specific Information Element, which the clients adapt to for enhanced performance. Similarly, a number of features are implemented by means of proprietary Information Elements, which Cisco clients use in specific ways to carry out tasks above and beyond the standard.Other examples of feature categories are roaming and power saving. Light Weight Access Point Protocol ( LWAPP ) This is a generic protocol that defines the communication between the Access Points and the Central controller. Mobile Node ( MN ) A roaming 802.11 wireless device in a wireless network associated with an access point. Mobile Node and client are used interchangeably. Received Signal Strength Indicator ( RSSI ) A measure of the strength of the signal as observed by the entity that received it, expressed in 'dbm'. Signal-Noise Ratio ( SNR ) A measure of the quality of the signal relative to the strength of noise expressed in 'dB'. REFERENCE [1] Wireless LAN Medium Access Control ( MAC ) and Physical Layer ( PHY ) Specifications. [2] Draft-obara-capwap-lwapp-00.txt, IETF Light Weight Access Point Protocol

This object is used to control the AP's response to the linktests initiated by the client. When set to 'true', the AP is expected to respond to the linktests performed by the client. The AP won't respond to the linktests initiated by the client, when this object is set to 'false'.

This object indicates the number of bytes to be sent by the AP to the client in one linktest packet.

This object indicates the number of linktest packets sent by the AP to the client.

This object indicates the duration for which the results of a particular run of linktest is available in cLLtClientLtResultsTable from the time of completion of that run of linktest. At the expiry of this time after the completion of the linktest, the entries corresponding to the linktest and the corresponding results are removed from cLLtClientLinkTestTable and cLLtClientLtResultsTable respectively.

This table is used to initiate linktests between an AP and one of its associated clients. CCX linktests are done on clients that support CCX. For all non-CCX clients, ping test is done. Note that ping test is also done when the CCX linktests fail. With CCX LinkTest support, the controller can test the link quality in downstream (direction of traffic from AP to client) direction by issuing LinkTest requests towards the client and let client record in the response packet the RF parameters like received signal strength, signal-to-noise etc., of the received request packet. With ping test only those RF parameters that are seen by the AP are measured. User initiates one run of linktest by adding a row to this table through explicit management action from the network manager. A row is created by specifying cLLtClientLtIndex, cLLtClientLtMacAddress and setting the RowStatus object to 'createAndGo'. This indicates the the request made to start the linktest on the client identified by cLLtClientLtMacAddress. cLLtClientLtIndex identifies the particular instance of the test. The added row is deleted by setting the corresponding instance of the RowStatus object to 'destroy'. In case if the agent finds that the time duration represented by cLLtTestPurgeTime has elapsed since the completion of the linktest, it proceeds to delete the row automatically, if the row exists at that point of time. The results of the linktest identified by cLLtClientLtIndex can be obtained from the queries to cLLtClientLtResultsTable.

Each entry in this table represents one instance of the linktest initiated by the user through a network manager.

This object uniquely identifies one particular run of the linktest initiated between the client identified by cLLtClientLtMacAddress and the AP it is currently associated with.

This object represents the mac address of the client involved in the particular run of linktest. This object must be set to a valid value when setting cLLtClientRowStatus to 'createAndGo' to initiate a run of linktest.

This object is the status column used for creating and deleting instances of the columnar objects in this table.

This table populates the results of the linktests initiated by the user through the cLLtClientLinkTestTable. This table has a sparse dependent relationship with cLLtClientLinkTestTable. There exists a row in this table corresponding to the row for each row in cLLtClientLinkTestTable identified by cLLtClientLtIndex. A row is added to this table when user, through the network manager, adds a row to cLLtClientLinkTestTable and initiates one run of linktest. A row is deleted by the agent when the corresponding row of cLLtClientLinkTestTable is deleted. The manager is expected to poll cLLtClientLtStatus to check the status of the linktest. Depending on the status read through this object cLLtClientLtStatus, the appropriate columns for CCX or ping tests are read and linktest statistics are gathered.

Each entry in this table represents the results of the linktest identified by cLLtClientLtIndex.

The number of packets sent to the target client specified by cLLtClientLtMacAddress by the AP it is associated to.

The number of packets sent by the client specified by cLLtClientLtMacAddress to the AP it is associated to.

The total number of packets lost during the linktest in both the upstream and downstream directions.

The number of packets lost during the linktest in the downstream (direction of traffic from AP to client) direction.

The number of packets lost during the linktest in the upstream (direction of traffic from client to AP) direction.

The minimum round trip time observed on the linktest packet between the AP and the client.

The maximum round trip time observed on the linktest packet between the AP and the client.

The average round trip time observed on the linktest packet between the AP and the client.

The minimum RSSI value as observed at the AP.

The maximum RSSI value as observed at the AP.

The average RSSI value as observed at the AP.

The minimum RSSI value as observed at the client.

The maximum RSSI value as observed at the client.

The average RSSI value as observed at the client.

The minimum SNR value as observed at the AP.

The maximum SNR value as observed at the AP.

The average SNR value as observed at the AP.

The minimum SNR value as observed at the client.

The maximum SNR value as observed at the client.

The average SNR value as observed at the client.

The total number of linktest packet transmission retries as observed at the AP.

The maximum number of linktest packet transmission retries observed at the AP.

The total number of linktest packet transmission retries at the client.

The maximum number of linktest packet transmission retries observed at the client.

This object indicates the status of the linktest this particular entry corresponds to. The semantics as follows. 'cLLtClientLtStatusFailed' - This value indicates that this particular linktest has failed. 'cLLtClientLtCcxStatusInProgress' - This value indicates that the CCX linktest is in progress. 'cLLtClientLtPngStatusInProgress' - This value indicates that the Ping-based linktest is in progress. 'cLLtClientLtStatusPingSuccess' - This value indicates that ping-based linktest between AP and client has succeeded. Only the following columns of this table should be considered for collecting data from the ping responses. cLLtClientLtPacketsSent, cLLtClientLtPacketsRx, cLLtClientLtUplinkAvgRSSI, cLLtClientLtUplinkAvgSNR cLLtClientLtStatusCcxLtSuccess - This value indicates that CCX linktest done to test the link between the client and the AP is successful. All the columns of this table are applicable and valid for collecting data from the CCX responses. Enumeration: 'cLLtClientLtStatusFailed': 0, 'cLLtClientLtStatusPingSuccess': 3, 'cLLtClientLtStatusCcxLtSuccess': 4, 'cLLtClientLtStatusPngInProgress': 2, 'cLLtClientLtStatusCcxInProgress': 1.

This table provides the results of CCX Link tests classified on different data rates between AP and clients. A row is added to this table automatically by the agent corresponding to one linktest identified by cLLtClientLtIndex and deleted when the corresponding row in cLLtClientLinkTestTable is deleted.

Each entry represents a conceptual row and populates the number of packets sent in the linktest identified by cLLtClientLtIndex. The statistics of the linktest are classified based on the respective data rates identified by cLLtClientLtDataRate.

This object identifies the rate at which packets are transmitted. The rates are defined in Mbps with the following being the possible values. Rates - 1,2,5.5,6,9,11,12,18,24,36,48,54,108.

The number of packets sent by the AP at the rate identified by cLLtClientLtDataRate.

The number of packets sent by the client at the rate identified by cLLtClientLtDataRate.

The compliance statement for the SNMP entities that implement the ciscoLwappLinkTestMIB module.

This collection of objects represent the linktest parameters for use during the various of the tests.

This collection of objects is used to initiate linktests and retrieve the results of the respective runs of the tests.

This collection of objects provide information about the linktest results.