CISCO-LWAPP-MESH-LINKTEST-MIB

All MIBs › CISCO-LWAPP-MESH-LINKTEST-MIB

Organization: Cisco Systems Inc.

Last Updated: 2010-09-30

Category: Cisco Devices, Wireless and WLAN

Description: Manages link test operations between mesh APs on Cisco wireless controllers for backhaul quality assessment.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

What Is CISCO-LWAPP-MESH-LINKTEST-MIB?

CISCO-LWAPP-MESH-LINKTEST-MIB is a Cisco enterprise MIB implemented on Wireless LAN Controllers acting as Central Controllers for mesh-based LWAPP access points, used to run backhaul link-quality tests between neighboring mesh nodes (root and mesh APs). It exposes a link-test table capturing source/destination MAC addresses, data rate, packet rate, packet size, and test duration, along with row-status control to start/stop tests. This is a performance/diagnostic monitoring MIB rather than a hardware-sensor MIB: it lets operators actively probe and assess wireless mesh backhaul quality (throughput and packet delivery at a given data rate) between mesh nodes, revealing weak or degraded mesh links before they affect client traffic. It depends on the broader LWAPP/CAPWAP mesh-controller architecture shared with other CISCO-LWAPP-* MIBs. It is deployed on Cisco wireless controllers managing outdoor or indoor mesh AP deployments where backhaul link quality between mesh nodes must be periodically verified. Engineers can download the CISCO-LWAPP-MESH-LINKTEST-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in CISCO-LWAPP-MESH-LINKTEST-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

Cisco Wireless LAN Controller (WLC)
Cisco mesh access point

Monitoring Examples

An administrator would create a row in clMeshLtTable/clMeshLtEntry (via clMeshLtRowStatus) specifying clMeshLtSrcMacAddress, clMeshLtDestMacAddress, clMeshLtDataRate, and clMeshLtDuration, then poll the resulting clMeshLtPktsPerSec and clMeshLtPktSize results. A low measured packet rate at a requested clMeshLtDataRateValue compared to the theoretical rate would indicate a degraded backhaul link between two mesh APs, perhaps due to interference or distance. clMeshLtPurgeTime controls how long completed test results remain available before being purged.

What Can Be Monitored

mesh backhaul link test results
measured packet rate and packet size
tested data rate between mesh nodes
link test duration and status

Imported Objects

From CISCO-SMI

ciscoMgmt

OBJECT-IDENTITY

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Integer32
MODULE-IDENTITY
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

MacAddress
RowStatus

How to Use in IPNetwork Monitor

Example using clMeshLtTxPkts OID:

Select a Cisco Wireless LAN Controller / mesh access point as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type clMeshLtTxPkts into the Find box to locate it in the OID tree, selecting the specific row/instance you want to monitor since this is a table column, then select it and click OK. The total number of packets sent to the destination mesh node specified by clMeshLtDestMacAddress from AP specified by clMeshLtSrcMacAddress. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is a Counter32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases sharply between polls relative to its normal baseline (in packets), since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
ciscoLwappMeshLinkTestMIB	1.3.6.1.4.1.9.9.606			This MIB is intended to be implemented on all those devices operating as Central Controllers (CC) that terminate the Light Weight Access Point Protocol (LWAPP) tunnel from Light-weight Access Points. Link Test is performed to learn the backhaul link quality between two neighboring mesh nodes. The deployment of the controller (referred to as CC in the diagram), mesh nodes (RAP and MAP) LWAPP APs, client(MS) and NMS appear as follows. +.......+ +.......+ + + + + + NMS + + NMS + + + + + +.......+ +.......+ . . . . . . . . . . . . . . +......+ +......+ +......+ +......+ + + + + + + + + + CC + + CC + + CC + + CC + + + + + + + + + +......+ +......+ +......+ +......+ .. . . . .. . . . . . . . . . . . . . . . . . . . . . . . +......+ +......+ +......+ +......+ +......+ + + + + + + + + + + + RAP + + RAP + + RAP + + RAP + + RAP + + + + + + + + + + + +......+ +......+ +......+ +......+ +......+ . . . . . . . . . . . . . . . . . . . . . . . . . +......+ +......+ +......+ +......+ +......+ + + + + + + + + + + + MAP + + MS + + MAP + + MAP + + MAP + + + + + + + + + + + +......+ +......+ +......+ +......+ +......+ . . .. . . . . .. . . . . .. . . . . . . +......+ +......+ +......+ +......+. +......+ + + + + + + + + + + + MAP + + MAP + + MAP + + MAP + + MS + + + + + + + + + + + +......+ +......+ +......+ +......+ +......+ 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 the controller pushes the configuration, that includes the WLAN parameters to the LWAPP APs. The APs encapsulate all the 802.11 frames from wireless clients inside LWAPP frames and forward the LWAPP frames to the controller. 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 is also referred to as 'controller'. Mobile Station ( MS ) A roaming 802.11 wireless device in a wireless network associated with an access point. Mobile Station and client are used interchangeably. Network Management System ( NMS ) The station from which the administrator manages the wired and wireless networks. Mesh Node A mesh node is defined as a physical or logical entity in the mesh network participating in forming the mesh backhaul. There are two types of mesh nodes supported in Cisco mesh network:RAP and MAP. Root AP (RAP) The AP forming the bridge between a wired and a mesh network with an Ethernet interface to the wired network and a 802.11 radio interface to the mesh network Mesh AP (MAP). The AP extending wireless coverage similar to a repeater in a mesh network and consists of a 802.11 uplink and a 802.11 downlink. On a single-radio backhaul, both uplink and downlink exist on the same radio and are logical links only. On a multi-radio backhaul, they may exist on different radios. Mesh Network Network starting with the wireless backhaul downlink of the RAP and all the entities below except any attached network to the Ethernet link of MAPs. A mesh network below a single RAP is also referred to as a 'Mesh Sector'.A mesh network consists of mesh nodes. A single mesh network is always augmented to a single wired network. Mesh Link A logical 802.11 link between two mesh nodes. A single link is point-to-point. All point-to-multipoint links are considered as multiple mesh links. Often referred to as mesh backhaul link. Mesh Backhaul A Mesh backhaul consists of mesh nodes and mesh links terminating at a RAP. This necessarily creates a one- to-one relationship between a 'mesh network', 'mesh sector' and a 'mesh backhaul' where these terms can be used interchangeably. SNR Signal to Noise ratio on the 802.11 radio. RSSI Received Signal Strength Indication (RSSI), the IEEE 802.11 standard defines a mechanism by which RF energy is to be measured by the circuitry on a wireless NIC. Its value is measured in dBm and ranges from -128 to 0. Bridged network The bridged network is defined as the network(s) attached to the Ethernet port of any MAP. There can be multiple such networks attached to a single mesh network. Mesh Node Roaming A mesh node may change its parent mesh node naturally when the RF/network condition changes.Child Mesh node will re-associate and re-authenticate to new parent mesh node. Mesh Security supports two types of mesh node roaming: Intra-controller roaming: LWAPP session remains and no LWAPP session roam is necessary Inter-controller roaming: LWAPP session is lost and LWAPP session roam may be necessary 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
ciscoLwappMeshLinkTestMIBNotifs	1.3.6.1.4.1.9.9.606.0
ciscoLwappMeshLinkTestMIBObjects	1.3.6.1.4.1.9.9.606.1
ciscoLwappMeshLinkTestConfig	1.3.6.1.4.1.9.9.606.1.1
U32 clMeshLtPurgeTime	1.3.6.1.4.1.9.9.606.1.1.1	Unsigned32	read-write	This object indicates the duration for which the results of a particular run of linktest is available in clMeshLtResultsTable 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 clMeshLtTable and clMeshLtResultsTable respectively.
ciscoLwappMeshLinkTestRun	1.3.6.1.4.1.9.9.606.1.2
clMeshLtTable	1.3.6.1.4.1.9.9.606.1.2.1		not-accessible	This table is used to initiate linktests between two neighbor mesh node AP. With LinkTest support, the controller can test the backhaul link. 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 clMeshLtIndex, clMeshLtSrcMacAddress and clMeshLtDestMacAddress setting the RowStatus object to 'createAndGo'. This indicates the the request made to start the linktest between two mesh nodes. 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 clMeshLtPurgeTime 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 clMeshLtIndex can be obtained from the queries to clMeshLtResultsTable.
clMeshLtEntry	1.3.6.1.4.1.9.9.606.1.2.1.1		not-accessible	Each entry in this table represents one instance of the linktest initiated by the user through a network manager.
U32 clMeshLtIndex	1.3.6.1.4.1.9.9.606.1.2.1.1.1	Unsigned32	not-accessible	This object uniquely identifies one particular run of the linktest initiated between the two mesh node neighbors identified by clMeshLtSrcMacAddress and clMeshLtDestMacAddress.
MAC clMeshLtSrcMacAddress	1.3.6.1.4.1.9.9.606.1.2.1.1.2	MacAddress	read-create	This object represents the source mac address of AP which initiates the link test to 'clMeshLtDestMacAddress' involved in the particular run of linktest. This object must be set to a valid value when setting clMeshLtRowStatus to 'createAndGo' to initiate a run of linktest.
MAC clMeshLtDestMacAddress	1.3.6.1.4.1.9.9.606.1.2.1.1.3	MacAddress	read-create	This object represents the destination mac address of AP involved in the particular run of linktest. This object must be set to a valid value when setting clMeshLtRowStatus to 'createAndGo' to initiate a run of linktest.
U32 clMeshLtDataRate	1.3.6.1.4.1.9.9.606.1.2.1.1.4	Unsigned32	read-create	This object represents the data rate on backhaul link at which link test will be performed. Depending on the backhaul radio type, data rate will vary. if the backhaul radio is 802.11a, data rates can be one of the following possible values. Rates - 6,9,11,12,18,24,36,48,54,108 Mbps. If backhaul link is 802.11b then data rate can be 1,2,5.5,6,9,11 If backhaul link is 802.11g 1,2,5.5,6,9,11,12,18,24,36,48,54,108. This object must be set to a valid value when setting clMeshLtRowStatus to 'createAndGo' to initiate a run of linktest. This object is deprecated and superceded by clMeshLtDataRateValue object.
U32 clMeshLtPktsPerSec	1.3.6.1.4.1.9.9.606.1.2.1.1.5	Unsigned32	read-create	This object represents the number of packets to be sent per sec during link test.
U32 clMeshLtPktSize	1.3.6.1.4.1.9.9.606.1.2.1.1.6	Unsigned32	read-create	This object represents the size of packets to be sent during link test.
U32 clMeshLtDuration	1.3.6.1.4.1.9.9.606.1.2.1.1.7	Unsigned32	read-create	This object represents the duration, in seconds, of link test to be performed.
ROW clMeshLtRowStatus	1.3.6.1.4.1.9.9.606.1.2.1.1.8	RowStatus	read-create	This object is the status column used for creating and deleting instances of the columnar objects in this table.
INT clMeshLtDataRateValue	1.3.6.1.4.1.9.9.606.1.2.1.1.9	INTEGER	read-create	This object represents the data rate on backhaul link at which link test will be performed. Depending on the backhaul radio type, data rate will vary. If the value of clMeshNodeBackhaul object is 'dot11a', data rates can be one of the following possible values. mbps6(4) mbps9(5) mbps12(7) mbps18(8) mbps24(9) mbps36(10) mbps48(11) mbps54(12) mbps108(13) Additionally following data rates are supported if 802.11a supports 11n. htMcs0(14) htMcs1(15) htMcs2(16) htMcs3(17) htMcs4(18) htMcs5(19) htMcs6(20) htMcs7(21) htMcs8(22) htMcs9(23) htMcs10(24) htMcs11(25) htMcs12(26) htMcs13(27) htMcs14(28) htMcs15(29) If the value of clMeshNodeBackhaul object is 'dot11b', then data rate can be one of the following possible values. mbps1(1) mbps2(2) mbps5point5(3) mbps6(4) mbps9(5) mbps11(6) If the value of clMeshNodeBackhaul object is 'dot11g', then data rate can be one of the following possible values. mbps1(1) mbps2(2) mbps5point5(3) mbps6(4) mbps9(5) mbps11(6) mbps12(7) mbps18(8) mbps24(9) mbps36(10) mbps48(11) mbps54(12) mbps108(13) This object cannot be modified when the value of clMeshLtRowStatus object in the same row is 'active'.
ciscoLwappMeshLinkTestStatus	1.3.6.1.4.1.9.9.606.1.3
clMeshLtResultsTable	1.3.6.1.4.1.9.9.606.1.3.1		not-accessible	This table populates the results of the mesh linktests initiated by the user through the clMeshLtTable. This table has a sparse dependent relationship with clMeshLtEntry. There exists a row in this table corresponding to each row in clMeshLtEntry identified by clMeshLtIndex. A row is added to this table when user, through the network manager, adds a row to clMeshLtEntry and initiates one run of linktest. A row can be deleted by the agent when the corresponding row of clMeshLtEntry is deleted or it will get deleted when the clMeshLtPurgeTime expires. The manager is expected to poll clMeshLtStatus to check the status of the linktest.
clMeshLtResultsEntry	1.3.6.1.4.1.9.9.606.1.3.1.1		not-accessible	Each entry in this table represents the results of the linktest identified by clMeshLtIndex.
C32 clMeshLtTxPktsEx	1.3.6.1.4.1.9.9.606.1.3.1.1.1	Counter32	read-only	The total number of packets sent to the destination mesh node specified by clMeshLtDestMacAddress from AP specified by clMeshLtSrcMacAddress.
C32 clMeshLtRxPkts	1.3.6.1.4.1.9.9.606.1.3.1.1.2	Counter32	read-only	The total number of packets received by mesh node specified by clMeshLtDestMacAddress from mesh node specified by clMeshLtSrcMacAddress.
C32 clMeshLtRxGoodPkts	1.3.6.1.4.1.9.9.606.1.3.1.1.3	Counter32	read-only	The total number of packets received without any errors by mesh node specified by clMeshLtDestMacAddress from mesh node AP specified by clMeshLtSrcMacAddress .
C32 clMeshLtRxDupPkts	1.3.6.1.4.1.9.9.606.1.3.1.1.4	Counter32	read-only	The total number of packets received with same sequence number by mesh node specified by clMeshLtDestMacAddress from mesh node specified by clMeshLtSrcMacAddress.
C32 clMeshLtRxShortPkts	1.3.6.1.4.1.9.9.606.1.3.1.1.5	Counter32	read-only	The total number of packets received that were shorter than the 802.11 frame size by mesh node specified by clMeshLtDestMacAddress from mesh node specified by clMeshLtSrcMacAddress.
C32 clMeshLtRxBigPkts	1.3.6.1.4.1.9.9.606.1.3.1.1.6	Counter32	read-only	The total number of packets received that were larger than the 802.11 frame size by mesh node specified by clMeshLtDestMacAddress from mesh node specified by clMeshLtSrcMacAddress.
C32 clMeshLtRxPhyErrPkts	1.3.6.1.4.1.9.9.606.1.3.1.1.7	Counter32	read-only	The total number of packets with error detected at physical layer received by mesh node specified by clMeshLtDestMacAddress from mesh node specified by clMeshLtSrcMacAddress.
C32 clMeshLtRxCRCErrPkts	1.3.6.1.4.1.9.9.606.1.3.1.1.8	Counter32	read-only	The total number of packets with CRC error received by mesh node specified by clMeshLtDestMacAddress from mesh node specified by clMeshLtSrcMacAddress.
C32 clMeshLtRxSeqErrPkts	1.3.6.1.4.1.9.9.606.1.3.1.1.9	Counter32	read-only	The total number of packets that were received with sequence number out of order by mesh node specified by clMeshLtDestMacAddress from mesh node specified by clMeshLtSrcMacAddress.
I32 clMeshLtRxAvgSNR	1.3.6.1.4.1.9.9.606.1.3.1.1.10	Integer32	read-only	The average SNR value observed at the mesh node specified by clMeshLtDestMacAddress.
I32 clMeshLtRxHighestSNR	1.3.6.1.4.1.9.9.606.1.3.1.1.11	Integer32	read-only	The highest SNR value observed at the mesh node specified by clMeshLtDestMacAddress.
I32 clMeshLtRxLowestSNR	1.3.6.1.4.1.9.9.606.1.3.1.1.12	Integer32	read-only	The lowest SNR value observed at the mesh node specified by clMeshLtDestMacAddress.
I32 clMeshLtRxAvgNoiseFloor	1.3.6.1.4.1.9.9.606.1.3.1.1.13	Integer32	read-only	The average noise floor value observed at the mesh node specified by clMeshLtDestMacAddress. The noise floor is the measure of the signal created from the sum of all the noise sources and unwanted signals within a measurement system.
I32 clMeshLtRxHighestNoiseFloor	1.3.6.1.4.1.9.9.606.1.3.1.1.14	Integer32	read-only	The highest Noise Floor value observed at the mesh node specified by clMeshLtDestMacAddress. The noise floor is the measure of the signal created from the sum of all the noise sources and unwanted signals within a measurement system.
I32 clMeshLtRxLowestNoiseFloor	1.3.6.1.4.1.9.9.606.1.3.1.1.15	Integer32	read-only	The lowest Noise Floor value observed at the mesh node specified by clMeshLtDestMacAddress. The noise floor is the measure of the signal created from the sum of all the noise sources and unwanted signals within a measurement system.
I32 clMeshLtRxAvgRSSI	1.3.6.1.4.1.9.9.606.1.3.1.1.16	Integer32	read-only	The average RSSI value observed at the mesh node specified by clMeshLtDestMacAddress.
I32 clMeshLtRxHighestRSSI	1.3.6.1.4.1.9.9.606.1.3.1.1.17	Integer32	read-only	The highest RSSI value observed at the mesh node specified by clMeshLtDestMacAddress.
I32 clMeshLtRxLowestRSSI	1.3.6.1.4.1.9.9.606.1.3.1.1.18	Integer32	read-only	The lowest RSSI value as observed at the mesh node specified by clMeshLtDestMacAddress.
INT clMeshLtStatus	1.3.6.1.4.1.9.9.606.1.3.1.1.19	INTEGER	read-only	This object indicates the status of the linktest this particular entry corresponds to. The semantics as follows. 'clMeshLtStatusFailed' - This value indicates that this particular linktest has failed. 'clMeshLtStatusInProgress' - This value indicates that the linktest is in progress. 'clMeshLtStatusSuccess' - This value indicates that linktest has succeeded.
ciscoLwappMeshLinkTestMIBConform	1.3.6.1.4.1.9.9.606.2
ciscoLwappMeshLinkTestMIBCompliances	1.3.6.1.4.1.9.9.606.2.1
ciscoLwappMeshLinkTestMIBCompliance	1.3.6.1.4.1.9.9.606.2.1.1			The compliance statement for the SNMP entities that implement the ciscoLwappMeshLinkTestMIB module.
ciscoLwappMeshLinkTestMIBComplianceRev1	1.3.6.1.4.1.9.9.606.2.1.2			The compliance statement for the SNMP entities that implement the ciscoLwappMeshLinkTestMIB module.
ciscoLwappMeshLinkTestMIBGroups	1.3.6.1.4.1.9.9.606.2.2
ciscoLwappMeshLinkTestConfigGroup	1.3.6.1.4.1.9.9.606.2.2.1			This collection of objects represent the linktest parameters for configuration and result.
ciscoLwappMeshLinkTestRunGroup	1.3.6.1.4.1.9.9.606.2.2.2			This collection of objects is used to initiate linktests and retrieve the results of the respective runs of the link test.
ciscoLwappMeshLinkTestRunGroupRev1	1.3.6.1.4.1.9.9.606.2.2.3			This collection of objects is used to initiate linktests and retrieve the results of the respective runs of the link test.

RFC description

Cisco vendor-private MIB for Lightweight Access Point Protocol (LWAPP); defines mesh network link test and diagnostics objects for Cisco wireless mesh networks.

Start monitoring Cisco Wireless LAN Controller / mesh access point with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download CISCO-LWAPP-MESH-LINKTEST-MIB