1-- *******************************************************************
2-- CISCO-LWAPP-CLIENT-ROAMING-MIB.my: Wireless client roaming MIB
3-- December 2005, Devesh Pujari , Prasanna Viswakumar
4--
5-- Copyright (c) 2005-2006, 2009-2017 by Cisco Systems, Inc.
6-- *******************************************************************
7
8CISCO-LWAPP-CLIENT-ROAMING-MIB DEFINITIONS ::= BEGIN
9
10IMPORTS
11    MODULE-IDENTITY,
12    OBJECT-TYPE,
13    Counter32,
14    Integer32,
15    TimeTicks
16        FROM SNMPv2-SMI
17    MODULE-COMPLIANCE,
18    OBJECT-GROUP
19        FROM SNMPv2-CONF
20    MacAddress,
21    TimeInterval
22        FROM SNMPv2-TC
23    cLApSysMacAddress,
24    cLApDot11IfSlotId
25        FROM CISCO-LWAPP-AP-MIB
26    CLDot11Channel,
27    CLDot11RfParamMode
28        FROM CISCO-LWAPP-TC-MIB
29    ciscoMgmt
30        FROM CISCO-SMI;
31
32
33ciscoLwappClRoamMIB MODULE-IDENTITY
34    LAST-UPDATED    "201704270000Z"
35    ORGANIZATION    "Cisco Systems, Inc."
36    CONTACT-INFO
37            "Cisco Systems,
38            Customer Service
39            Postal: 170 West Tasman Drive
40            San Jose, CA  95134
41            USA
42            Tel: +1 800 553-NETS
43
44            Email: cs-wnbu-snmp@cisco.com"
45    DESCRIPTION
46        "This MIB is intended to be implemented on all those
47        devices operating as Central controllers, that
48        terminate the Light Weight Access Point Protocol
49        tunnel from Cisco Light-weight LWAPP Access Points.
50
51        Information provided by this MIB is for CCX related
52        features as specified in the CCX specifications.
53        This MIB covers roaming RF parameters for CCX
54        clients.
55
56        The relationship between CC and the LWAPP APs
57        can be depicted as follows:
58
59              +......+     +......+     +......+
60              +      +     +      +     +      +
61              +  CC  +     +  CC  +     +  CC  +
62              +      +     +      +     +      +
63              +......+     +......+     +......+
64                ..            .             .
65                ..            .             .
66               .  .            .             .
67              .    .            .             .
68             .      .            .             .
69            .        .            .             .
70        +......+ +......+     +......+      +......+
71        +      + +      +     +      +      +      +
72        +  AP  + +  AP  +     +  AP  +      +  AP  +
73        +      + +      +     +      +      +      +
74        +......+ +......+     +......+      +......+
75                   .              .             .
76                 .  .              .             .
77                .    .              .             .
78               .      .              .             .
79              .        .              .             .
80           +......+ +......+     +......+      +......+
81           +      + +      +     +      +      +      +
82           +  MN  + +  MN  +     +  MN  +      +  MN  +
83           +      + +      +     +      +      +      +
84           +......+ +......+     +......+      +......+
85
86
87        The LWAPP tunnel exists between the controller and
88        the APs.  The MNs communicate with the APs through
89        the protocol defined by the 802.11 standard.
90
91        LWAPP APs, upon bootup, discover and join one of the
92        controllers and the controller pushes the configuration,
93        that includes the WLAN parameters, to the LWAPP APs.
94        The APs then encapsulate all the 802.11 frames from
95        wireless clients inside LWAPP frames and forward
96        the LWAPP frames to the controller.
97
98                           GLOSSARY
99
100        Access Point ( AP )
101
102        An entity that contains an 802.11 medium access
103        control ( MAC ) and physical layer ( PHY ) interface
104        and provides access to the distribution services via
105        the wireless medium for associated clients.
106
107        LWAPP APs encapsulate all the 802.11 frames in
108        LWAPP frames and sends them to the controller to which
109        it is logically connected.
110
111        Basic Service Set ( BSS )
112
113        The IEEE 802.11 BSS of an AP comprises of the
114        stations directly associating with the AP.
115
116        Central Controller ( CC )
117
118        The central entity that terminates the LWAPP protocol
119        tunnel from the LWAPP APs.  Throughout this MIB,
120        this entity is also referred to as 'controller'.
121
122        Cisco Compatible eXtensions (CCX)
123
124        Wireless LAN Access Points (APs) manufactured by Cisco
125        Systems have features and capabilities beyond those in
126        related standards (e.g., IEEE 802.11 suite of
127        standards ,Wi-Fi recommendations by WECA, 802.1X
128        security suite,etc). A number of features provide
129        higher performance.For example, Cisco AP transmits a
130        specific Information Element, which the clients adapt
131        to for enhanced performance. Similarly, a number of
132        features are implemented by means of proprietary
133        Information Elements, which Cisco clients use in
134        specific ways to carry out tasks above and beyond the
135        standard. Other examples of feature categories are
136        roaming and power saving.
137
138        Client Roaming
139
140        A client may decide to reassociate with another AP for
141        reasons of its own choosing. The decision of whether
142        or not to use the information contained in the AP list
143        is up to the discretion of the implementor, as long as
144        the roam time requirement is met.
145
146        Light Weight Access Point Protocol ( LWAPP )
147
148        This is a generic protocol that defines the
149        communication between the Access Points and the
150        Central Controller.
151
152        Mobile Node ( MN )
153
154        A roaming 802.11 wireless device in a wireless
155        network associated with an access point. Mobile Node
156        and client are used interchangeably.
157
158        REFERENCE
159
160        [1] Wireless LAN Medium Access Control ( MAC ) and
161        Physical Layer ( PHY ) Specifications
162
163        [2] Draft-obara-capwap-lwapp-00.txt, IETF Light
164        Weight Access Point Protocol"
165    REVISION        "201704270000Z"
166    DESCRIPTION
167        "Added following attribute:-
168        clcrRoamIntraCount"
169    REVISION        "201001290000Z"
170    DESCRIPTION
171        "Deprecated following attributes:-
172        clcrDot11aMinRssi, clcrDot11aHysteresis,
173        clcrDot11aAdaptiveScanThreshold, clcrDot11aTransitionTime,
174        clcrDot11bMinRssi, clcrDot11bHysteresis,
175        clcrDot11bAdaptiveScanThreshold, clcrDot11bTransitionTime.
176        clcrMIBCompliance, ciscoLwappClRoamDot11aRfParamsGroup,
177        ciscoLwappClRoamDot11bRfParamsGroup
178
179        Added following attributes:-
180        clcrDot11aMinRssiV2, clcrDot11aHysteresisV2,
181        clcrDot11aAdaptiveScanThresholdV2, clcrDot11aTransitionTimeV2,
182        clcrDot11bMinRssiV2, clcrDot11bHysteresisV2,
183        clcrDot11bAdaptiveScanThresholdV2, clcrDot11bTransitionTimeV2.
184        clcrMIBComplianceRev1, ciscoLwappClRoamDot11aRfParamsGroupSup1,
185        ciscoLwappClRoamDot11bRfParamsGroupSup1"
186    REVISION        "200604110000Z"
187    DESCRIPTION
188        "Initial version of this MIB module."
189    ::= { ciscoMgmt 523 }
190
191
192ciscoLwappClRoamMIBNotifs  OBJECT IDENTIFIER
193    ::= { ciscoLwappClRoamMIB 0 }
194
195ciscoLwappClRoamMIBObjects  OBJECT IDENTIFIER
196    ::= { ciscoLwappClRoamMIB 1 }
197
198ciscoLwappClRoamMIBConform  OBJECT IDENTIFIER
199    ::= { ciscoLwappClRoamMIB 2 }
200
201clcrRoamDot11aRfParamConfig  OBJECT IDENTIFIER
202    ::= { ciscoLwappClRoamMIBObjects 1 }
203
204clcrRoamDot11bRfParamConfig  OBJECT IDENTIFIER
205    ::= { ciscoLwappClRoamMIBObjects 2 }
206
207clcrRoamReasonReport  OBJECT IDENTIFIER
208    ::= { ciscoLwappClRoamMIBObjects 3 }
209
210clcrRoamDot11Stats  OBJECT IDENTIFIER
211    ::= { ciscoLwappClRoamMIBObjects 4 }
212
213clcrRoamStats  OBJECT IDENTIFIER
214    ::= { ciscoLwappClRoamMIBObjects 5 }
215
216
217-- ********************************************************************
218-- Clients Roaming RF Parameters for 802.11a band.
219-- ********************************************************************
220
221clcrDot11aMode OBJECT-TYPE
222    SYNTAX          CLDot11RfParamMode
223    MAX-ACCESS      read-write
224    STATUS          current
225    DESCRIPTION
226        "This object specifies how the controller chooses
227        the values of the RF parameters needed to manage
228        roaming in 802.11a networks."
229    DEFVAL          { default }
230    ::= { clcrRoamDot11aRfParamConfig 1 }
231
232clcrDot11aMinRssi OBJECT-TYPE
233    SYNTAX          Integer32 (-90..-80)
234    UNITS           "dBm"
235    MAX-ACCESS      read-write
236    STATUS          deprecated
237    DESCRIPTION
238        "This object specifies the Minimum Received Signal
239        Strength Indication (RSSI) in dBm required to
240        associate with the AP. It also defines the edge of
241        coverage for the BSS. If the client's average
242        received signal power dips below this threshold,
243        clients  must have roamed to another AP with a
244        stronger signal.
245
246        This object is superceded by clcrDot11aMinRssiV2
247        clcrDot11aMinRssi object is superseded by clcrDot11aMinRssiV2."
248    DEFVAL          { -85 }
249    ::= { clcrRoamDot11aRfParamConfig 2 }
250
251clcrDot11aHysteresis OBJECT-TYPE
252    SYNTAX          Integer32 (2..4)
253    UNITS           "dB"
254    MAX-ACCESS      read-write
255    STATUS          deprecated
256    DESCRIPTION
257        "This object specifies how much stronger the signal
258        strength (dB) of a neighbor AP must be, in order
259        for the client to roam to it.  The use of roaming
260        hysteresis is intended to reduce the amount of
261        clients roaming back and forth between BSSs if the
262        client is physically located on or near the border
263        between two BSSs.
264
265        This object is superceded by clcrDot11aHysteresisV2
266        clcrDot11aHysteresis object is superseded by clcrDot11aHysteresisV2."
267    DEFVAL          { 2 }
268    ::= { clcrRoamDot11aRfParamConfig 3 }
269
270clcrDot11aAdaptiveScanThreshold OBJECT-TYPE
271    SYNTAX          Integer32 (-77..-70)
272    UNITS           "dBm"
273    MAX-ACCESS      read-write
274    STATUS          deprecated
275    DESCRIPTION
276        "This object specifies the threshold for the
277        strength of the signals received(RSSI) from an AP,
278        as seen by an associated client, below which the
279        client must be able to roam to a neighbor AP within
280        the specified Transition Time configured through
281        clcrDot11aTransitionTime.
282
283        This object is superceded by clcrDot11aAdaptiveScanThresholdV2
284        clcrDot11aAdaptiveScanThreshold object is superseded by clcrDot11aAdaptiveScanThresholdV2."
285    DEFVAL          { -72 }
286    ::= { clcrRoamDot11aRfParamConfig 4 }
287
288clcrDot11aTransitionTime OBJECT-TYPE
289    SYNTAX          TimeInterval (100..10000)
290    MAX-ACCESS      read-write
291    STATUS          deprecated
292    DESCRIPTION
293        "This object specifies the maximum time duration
294        permitted for the client to detect a suitable
295        neighbor AP to roam to and to complete the roam,
296        whenever the RSSI from the clients associated AP
297        is below the adaptive scan threshold configured
298        through clcrDot11aAdaptiveScanThreshold.  The time
299        is expressed in 100th of a second.
300
301        This object is superceded by clcrDot11aTransitionTimeV2
302        clcrDot11aTransitionTime object is superseded by clcrDot11aTransitionTimeV2."
303    DEFVAL          { 500 }
304    ::= { clcrRoamDot11aRfParamConfig 5 }
305
306clcrDot11aMinRssiV2 OBJECT-TYPE
307    SYNTAX          Integer32 (-255..255)
308    UNITS           "dBm"
309    MAX-ACCESS      read-write
310    STATUS          current
311    DESCRIPTION
312        "This object specifies the Minimum Received Signal
313        Strength Indication (RSSI) in dBm required to
314        associate with the AP. It also defines the edge of
315        coverage for the BSS. If the client's average
316        received signal power dips below this threshold,
317        clients  must have roamed to another AP with a
318        stronger signal."
319    ::= { clcrRoamDot11aRfParamConfig 6 }
320
321clcrDot11aHysteresisV2 OBJECT-TYPE
322    SYNTAX          Integer32 (0..255)
323    UNITS           "dB"
324    MAX-ACCESS      read-write
325    STATUS          current
326    DESCRIPTION
327        "This object specifies how much stronger the signal
328        strength (dB) of a neighbor AP must be, in order
329        for the client to roam to it.  The use of roaming
330        hysteresis is intended to reduce the amount of
331        clients roaming back and forth between BSSs if the
332        client is physically located on or near the border
333        between two BSSs."
334    ::= { clcrRoamDot11aRfParamConfig 7 }
335
336clcrDot11aAdaptiveScanThresholdV2 OBJECT-TYPE
337    SYNTAX          Integer32 (-255..255)
338    UNITS           "dBm"
339    MAX-ACCESS      read-write
340    STATUS          current
341    DESCRIPTION
342        "This object specifies the threshold for the
343        strength of the signals received(RSSI) from an AP,
344        as seen by an associated client, below which the
345        client must be able to roam to a neighbor AP within
346        the specified Transition Time configured through
347        clcrDot11aTransitionTime."
348    ::= { clcrRoamDot11aRfParamConfig 8 }
349
350clcrDot11aTransitionTimeV2 OBJECT-TYPE
351    SYNTAX          TimeInterval (0..10000)
352    MAX-ACCESS      read-write
353    STATUS          current
354    DESCRIPTION
355        "This object specifies the maximum time duration
356        permitted for the client to detect a suitable
357        neighbor AP to roam to and to complete the roam,
358        whenever the RSSI from the clients associated AP
359        is below the adaptive scan threshold configured
360        through clcrDot11aAdaptiveScanThreshold.  The time
361        is expressed in 100th of a second."
362    ::= { clcrRoamDot11aRfParamConfig 9 }
363
364-- ********************************************************************
365-- Clients Roaming RF Parameters for 802.11b/g band.
366-- ********************************************************************
367
368clcrDot11bMode OBJECT-TYPE
369    SYNTAX          CLDot11RfParamMode
370    MAX-ACCESS      read-write
371    STATUS          current
372    DESCRIPTION
373        "This object specifies how the controller chooses
374        the values of the RF parameters needed to manage
375        roaming in 802.11b/g networks."
376    DEFVAL          { default }
377    ::= { clcrRoamDot11bRfParamConfig 1 }
378
379clcrDot11bMinRssi OBJECT-TYPE
380    SYNTAX          Integer32 (-90..-80)
381    UNITS           "dBm"
382    MAX-ACCESS      read-write
383    STATUS          deprecated
384    DESCRIPTION
385        "This object specifies the minimum Received Signal
386        Strength Indication (RSSI) in dBm required to
387        associate with the AP. It also defines the edge of
388        coverage for the BSS. If the client's average
389        received signal power dips below this threshold,
390        clients  must have roamed to another AP with a
391        stronger signal.
392
393        This object is superceded by clcrDot11bMinRssiV2
394        clcrDot11bMinRssi object is superseded by clcrDot11bMinRssiV2."
395    DEFVAL          { -85 }
396    ::= { clcrRoamDot11bRfParamConfig 2 }
397
398clcrDot11bHysteresis OBJECT-TYPE
399    SYNTAX          Integer32 (2..4)
400    UNITS           "dB"
401    MAX-ACCESS      read-write
402    STATUS          deprecated
403    DESCRIPTION
404        "This object specifies how much stronger the signal
405        strength (dB) of a neighbor AP must be, in order
406        for the client to roam to it.  The use of roaming
407        hysteresis is intended to reduce the amount of
408        clients roaming back and forth between BSSs if the
409        client is physically located on or near the border
410        between two BSSs.
411
412        This object is superceded by clcrDot11bHysteresisV2
413        clcrDot11bHysteresis object is superseded by clcrDot11bHysteresisV2."
414    DEFVAL          { 2 }
415    ::= { clcrRoamDot11bRfParamConfig 3 }
416
417clcrDot11bAdaptiveScanThreshold OBJECT-TYPE
418    SYNTAX          Integer32 (-77..-70)
419    UNITS           "dBm"
420    MAX-ACCESS      read-write
421    STATUS          deprecated
422    DESCRIPTION
423        "This object specifies the threshold for the
424        strength of the signals received(RSSI) from an AP,
425        as seen by an associated client, below which the
426        client must be able to roam to a neighbor AP within
427        the specified Transition Time configured through
428        clcrDot11bTransitionTime.
429
430        This object is superceded by clcrDot11bAdaptiveScanThresholdV2
431        clcrDot11bAdaptiveScanThreshold object is superseded by clcrDot11bAdaptiveScanThresholdV2."
432    DEFVAL          { -72 }
433    ::= { clcrRoamDot11bRfParamConfig 4 }
434
435clcrDot11bTransitionTime OBJECT-TYPE
436    SYNTAX          TimeInterval (100..10000)
437    MAX-ACCESS      read-write
438    STATUS          deprecated
439    DESCRIPTION
440        "This object specifies the maximum time duration
441        permitted for the client to detect a suitable
442        neighbor AP to roam to and to complete the roam,
443        whenever the RSSI from the client is associated AP
444        is below the adaptive scan threshold configured
445        through clcrDot11aAdaptiveScanThreshold.  The
446        time is expressed in 100th of a second.
447
448        This object is superceded by clcrDot11bTransitionTimeV2
449        clcrDot11bTransitionTime object is superseded by clcrDot11bTransitionTimeV2.."
450    DEFVAL          { 500 }
451    ::= { clcrRoamDot11bRfParamConfig 5 }
452
453clcrDot11bMinRssiV2 OBJECT-TYPE
454    SYNTAX          Integer32 (-255..255)
455    UNITS           "dBm"
456    MAX-ACCESS      read-write
457    STATUS          current
458    DESCRIPTION
459        "This object specifies the minimum Received Signal
460        Strength Indication (RSSI) in dBm required to
461        associate with the AP. It also defines the edge of
462        coverage for the BSS. If the client's average
463        received signal power dips below this threshold,
464        clients  must have roamed to another AP with a
465        stronger signal."
466    ::= { clcrRoamDot11bRfParamConfig 6 }
467
468clcrDot11bHysteresisV2 OBJECT-TYPE
469    SYNTAX          Integer32 (0..255)
470    UNITS           "dB"
471    MAX-ACCESS      read-write
472    STATUS          current
473    DESCRIPTION
474        "This object specifies how much stronger the signal
475        strength (dB) of a neighbor AP must be, in order
476        for the client to roam to it.  The use of roaming
477        hysteresis is intended to reduce the amount of
478        clients roaming back and forth between BSSs if the
479        client is physically located on or near the border
480        between two BSSs."
481    ::= { clcrRoamDot11bRfParamConfig 7 }
482
483clcrDot11bAdaptiveScanThresholdV2 OBJECT-TYPE
484    SYNTAX          Integer32 (-255..255)
485    UNITS           "dBm"
486    MAX-ACCESS      read-write
487    STATUS          current
488    DESCRIPTION
489        "This object specifies the threshold for the
490        strength of the signals received(RSSI) from an AP,
491        as seen by an associated client, below which the
492        client must be able to roam to a neighbor AP within
493        the specified Transition Time configured through
494        clcrDot11bTransitionTime."
495    ::= { clcrRoamDot11bRfParamConfig 8 }
496
497clcrDot11bTransitionTimeV2 OBJECT-TYPE
498    SYNTAX          TimeInterval (0..10000)
499    MAX-ACCESS      read-write
500    STATUS          current
501    DESCRIPTION
502        "This object specifies the maximum time duration
503        permitted for the client to detect a suitable
504        neighbor AP to roam to and to complete the roam,
505        whenever the RSSI from the client is associated AP
506        is below the adaptive scan threshold configured
507        through clcrDot11aAdaptiveScanThreshold.  The
508        time is expressed in 100th of a second."
509    ::= { clcrRoamDot11bRfParamConfig 9 }
510-- ********************************************************************
511-- Client Roam Reason Report
512-- ********************************************************************
513
514clcrRoamReasonReportTable OBJECT-TYPE
515    SYNTAX          SEQUENCE OF ClcrRoamReasonReportEntry
516    MAX-ACCESS      not-accessible
517    STATUS          current
518    DESCRIPTION
519        "This table provides the reasons for CCX clients
520        roaming from one AP to another.
521
522        When a CCX client associates to an AP, it will always
523        send an IAPP information packet to the new AP listing
524        the characteristics of the previous AP.
525
526        An entry is added to this table when a roam reason
527        report is sent by a CCX client when it roams to a
528        new AP."
529    ::= { clcrRoamReasonReport 1 }
530
531clcrRoamReasonReportEntry OBJECT-TYPE
532    SYNTAX          ClcrRoamReasonReportEntry
533    MAX-ACCESS      not-accessible
534    STATUS          current
535    DESCRIPTION
536        "Each entry corresponds to the roam reason report
537        sent by a CCX client to the new AP to which client
538        associates."
539    INDEX           {
540                        clcrRoamClientMacAddress,
541                        clcrRoamClientTimeStamp
542                    }
543    ::= { clcrRoamReasonReportTable 1 }
544
545ClcrRoamReasonReportEntry ::= SEQUENCE {
546        clcrRoamClientMacAddress     MacAddress,
547        clcrRoamClientTimeStamp      TimeTicks,
548        clcrRoamNewApMacAddress      MacAddress,
549        clcrRoamPrevApMacAddress     MacAddress,
550        clcrRoamPrevApChannel        CLDot11Channel,
551        clcrRoamPrevApSsid           OCTET STRING,
552        clcrRoamDisassocTimeInterval TimeInterval,
553        clcrRoamReason               INTEGER
554}
555
556clcrRoamClientMacAddress OBJECT-TYPE
557    SYNTAX          MacAddress
558    MAX-ACCESS      not-accessible
559    STATUS          current
560    DESCRIPTION
561        "This object indicates the mac address of the
562        client which has roamed to a new AP."
563    ::= { clcrRoamReasonReportEntry 1 }
564
565clcrRoamClientTimeStamp OBJECT-TYPE
566    SYNTAX          TimeTicks
567    MAX-ACCESS      not-accessible
568    STATUS          current
569    DESCRIPTION
570        "This object indicates the time instance at which
571        this report was received by the new AP, to which
572        client roamed to.  This represents number of
573        seconds elapsed since 00:00:00 on January 1, 1970,
574        Coordinated Universal Time (UTC).  So a value of
575        '1131362704' means 'Mon Nov  7 16:55:04 2005'."
576    ::= { clcrRoamReasonReportEntry 2 }
577
578clcrRoamNewApMacAddress OBJECT-TYPE
579    SYNTAX          MacAddress
580    MAX-ACCESS      read-only
581    STATUS          current
582    DESCRIPTION
583        "This object indicates the mac address of the
584        current AP to which client has roamed to. This AP
585        receives the roam reason report."
586    ::= { clcrRoamReasonReportEntry 3 }
587
588clcrRoamPrevApMacAddress OBJECT-TYPE
589    SYNTAX          MacAddress
590    MAX-ACCESS      read-only
591    STATUS          current
592    DESCRIPTION
593        "This object indicates the mac address of the
594        previous AP to which client was associated."
595    ::= { clcrRoamReasonReportEntry 4 }
596
597clcrRoamPrevApChannel OBJECT-TYPE
598    SYNTAX          CLDot11Channel
599    MAX-ACCESS      read-only
600    STATUS          current
601    DESCRIPTION
602        "This object indicates the channel number at which
603        the client was associated to the previous AP."
604    ::= { clcrRoamReasonReportEntry 5 }
605
606clcrRoamPrevApSsid OBJECT-TYPE
607    SYNTAX          OCTET STRING (SIZE  (1..32))
608    MAX-ACCESS      read-only
609    STATUS          current
610    DESCRIPTION
611        "This object indicates the SSID at which the client
612        was associated to the previous AP."
613    ::= { clcrRoamReasonReportEntry 6 }
614
615clcrRoamDisassocTimeInterval OBJECT-TYPE
616    SYNTAX          TimeInterval
617    MAX-ACCESS      read-only
618    STATUS          current
619    DESCRIPTION
620        "This object indicates the time elapsed since the
621        client disassociated, in hundredth of a second."
622    ::= { clcrRoamReasonReportEntry 7 }
623
624clcrRoamReason OBJECT-TYPE
625    SYNTAX          INTEGER  {
626                        clcrUnspecified(0),
627                        clcrPoorLink(1),
628                        clcrLoadBalancing(2),
629                        clcrInsufficientCapacity(3),
630                        clcrDirectedRoam(4),
631                        clcrFirstAssociation(5),
632                        clcrRoamingIn(6),
633                        clcrRoamingOut(7),
634                        clcrBetterAp(8),
635                        clcrDisassociated(9)
636                    }
637    MAX-ACCESS      read-only
638    STATUS          current
639    DESCRIPTION
640        "This object indicates the reason for a client to
641        roam to a new AP.
642
643        The semantics are as follows.
644
645        clcrUnspecified - The reason is not known or can't
646        be found.
647
648        clcrPoorLink - Normal roam due to poor link
649        (excessive retries, too much interference, RSSI too
650        low, etc.)
651
652        clcrLoadBalancing - Normal roam due to load
653        balancing
654
655        clcrInsufficientCapacity - Roaming occured due to
656        the insufficient capacity on the previous AP
657        (TSPEC rejected)
658
659        clcrDirectedRoam - Roaming is directed by the
660        802.11 wireless Infrastructure
661
662        clcrFirstAssociation - This is the first
663        association to a particular WLAN
664
665        clcrRoamingIn - Roaming in from cellular or other
666        WAN
667
668        clcrRoamingOut - Roaming out to cellular or other
669        WAN
670
671        clcrBetterAp - Normal roam due to better AP found
672
673        clcrDisassociated - Deauthenticated or
674        Disassociated from the previous AP."
675    ::= { clcrRoamReasonReportEntry 8 }
676
677
678-- ********************************************************************
679-- Roaming Stats per 802.11 interface.
680-- ********************************************************************
681
682clcrDot11StatsTable OBJECT-TYPE
683    SYNTAX          SEQUENCE OF ClcrDot11StatsEntry
684    MAX-ACCESS      not-accessible
685    STATUS          current
686    DESCRIPTION
687        "This table populates the statistics collected when
688        the client roamed in the WLAN.
689
690        There exists a row in this table for each conceptual
691        row in cLApDot11IfTable that represents a dot11
692        interface of an AP."
693    ::= { clcrRoamDot11Stats 1 }
694
695clcrDot11StatsEntry OBJECT-TYPE
696    SYNTAX          ClcrDot11StatsEntry
697    MAX-ACCESS      not-accessible
698    STATUS          current
699    DESCRIPTION
700        "Each entry represents a conceptual row in
701        clcrDot11StatsTable and corresponds to the roam
702        reason report  sent by a CCX client to the new AP
703        which the client associates to."
704    INDEX           {
705                        cLApSysMacAddress,
706                        cLApDot11IfSlotId
707                    }
708    ::= { clcrDot11StatsTable 1 }
709
710ClcrDot11StatsEntry ::= SEQUENCE {
711        clcrDot11NeighborRequestRx  Counter32,
712        clcrDot11NeighborReplySent  Counter32,
713        clcrDot11RoamReasonReportRx Counter32,
714        clcrDot11BcastUpdatesSent   Counter32
715}
716
717clcrDot11NeighborRequestRx OBJECT-TYPE
718    SYNTAX          Counter32
719    MAX-ACCESS      read-only
720    STATUS          current
721    DESCRIPTION
722        "This object indicates the count of the number
723        of requests received from an E2E client for
724        neighbor updates."
725    ::= { clcrDot11StatsEntry 1 }
726
727clcrDot11NeighborReplySent OBJECT-TYPE
728    SYNTAX          Counter32
729    MAX-ACCESS      read-only
730    STATUS          current
731    DESCRIPTION
732        "This object indicates the count of the number
733        of replies sent to the client in reply to the
734        request for neighbor updates received from the
735        client."
736    ::= { clcrDot11StatsEntry 2 }
737
738clcrDot11RoamReasonReportRx OBJECT-TYPE
739    SYNTAX          Counter32
740    MAX-ACCESS      read-only
741    STATUS          current
742    DESCRIPTION
743        "This object reports the count of the number
744        of roam reason reports received from CCX
745        clients."
746    ::= { clcrDot11StatsEntry 3 }
747
748clcrDot11BcastUpdatesSent OBJECT-TYPE
749    SYNTAX          Counter32
750    MAX-ACCESS      read-only
751    STATUS          current
752    DESCRIPTION
753        "This object indicates the count of the number of
754        broadcast neighbor updates sent by an AP."
755    ::= { clcrDot11StatsEntry 4 }
756
757
758
759-- ********************************************************************
760-- Roaming Stats per WLC
761-- ********************************************************************
762
763clcrRoamIntraCount OBJECT-TYPE
764    SYNTAX          Counter32
765    MAX-ACCESS      read-only
766    STATUS          current
767    DESCRIPTION
768        "This object indicates the count of successful
769        intra-WLC roaming."
770    ::= { clcrRoamStats 1 }
771-- ********************************************************************
772-- *    Compliance statements
773-- ********************************************************************
774
775ciscoLwappClRoamMIBCompliances  OBJECT IDENTIFIER
776    ::= { ciscoLwappClRoamMIBConform 1 }
777
778ciscoLwappClRoamMIBGroups  OBJECT IDENTIFIER
779    ::= { ciscoLwappClRoamMIBConform 2 }
780
781
782clcrMIBCompliance MODULE-COMPLIANCE
783    STATUS          deprecated
784    DESCRIPTION
785        "The compliance statement for the SNMP entities that
786        implement the ciscoLwappRoamMIB module."
787    MODULE          -- this module
788    MANDATORY-GROUPS {
789                        ciscoLwappClRoamDot11aRfParamsGroup,
790                        ciscoLwappClRoamDot11bRfParamsGroup,
791                        ciscoLwappClRoamroamReasonGroup,
792                        ciscoLwappClRoamroamingStatsGroup
793                    }
794    ::= { ciscoLwappClRoamMIBCompliances 1 }
795
796clcrMIBComplianceRev1 MODULE-COMPLIANCE
797    STATUS          current
798    DESCRIPTION
799        "The compliance statement for the SNMP entities that
800        implement the ciscoLwappRoamMIB module."
801    MODULE          -- this module
802    MANDATORY-GROUPS {
803                        ciscoLwappClRoamDot11aRfParamsGroupSup1,
804                        ciscoLwappClRoamDot11bRfParamsGroupSup1,
805                        ciscoLwappClRoamroamReasonGroup,
806                        ciscoLwappClRoamroamingStatsGroup
807                    }
808    ::= { ciscoLwappClRoamMIBCompliances 2 }
809
810-- ********************************************************************
811-- *    Units of conformance
812-- ********************************************************************
813
814ciscoLwappClRoamDot11aRfParamsGroup OBJECT-GROUP
815    OBJECTS         {
816                        clcrDot11aMode,
817                        clcrDot11aMinRssi,
818                        clcrDot11aHysteresis,
819                        clcrDot11aAdaptiveScanThreshold,
820                        clcrDot11aTransitionTime
821                    }
822    STATUS          deprecated
823    DESCRIPTION
824        "This collection of objects represent the radio
825        parameters for the 802.11a networks.
826        ciscoLwappClRoamDot11aRfParamsGroup object is superseded by ciscoLwappClRoamDot11aRfParamsGroupSup1."
827    ::= { ciscoLwappClRoamMIBGroups 1 }
828
829ciscoLwappClRoamDot11bRfParamsGroup OBJECT-GROUP
830    OBJECTS         {
831                        clcrDot11bMode,
832                        clcrDot11bMinRssi,
833                        clcrDot11bHysteresis,
834                        clcrDot11bAdaptiveScanThreshold,
835                        clcrDot11bTransitionTime
836                    }
837    STATUS          deprecated
838    DESCRIPTION
839        "This collection of objects represent the radio
840        parameters for the 802.11b/g bands.
841        ciscoLwappClRoamDot11bRfParamsGroup object is superseded by ciscoLwappClRoamDot11bRfParamsGroupSup1."
842    ::= { ciscoLwappClRoamMIBGroups 2 }
843
844ciscoLwappClRoamroamReasonGroup OBJECT-GROUP
845    OBJECTS         {
846                        clcrRoamNewApMacAddress,
847                        clcrRoamPrevApMacAddress,
848                        clcrRoamPrevApChannel,
849                        clcrRoamPrevApSsid,
850                        clcrRoamDisassocTimeInterval,
851                        clcrRoamReason
852                    }
853    STATUS          current
854    DESCRIPTION
855        "This collection of objects provide the reasons for
856        clients roaming between APs."
857    ::= { ciscoLwappClRoamMIBGroups 3 }
858
859ciscoLwappClRoamroamingStatsGroup OBJECT-GROUP
860    OBJECTS         {
861                        clcrDot11NeighborRequestRx,
862                        clcrDot11NeighborReplySent,
863                        clcrDot11RoamReasonReportRx,
864                        clcrDot11BcastUpdatesSent,
865                        clcrRoamIntraCount
866                    }
867    STATUS          current
868    DESCRIPTION
869        "This collection of objects provide the counters
870        related to roaming."
871    ::= { ciscoLwappClRoamMIBGroups 4 }
872
873ciscoLwappClRoamDot11aRfParamsGroupSup1 OBJECT-GROUP
874    OBJECTS         {
875                        clcrDot11aMode,
876                        clcrDot11aMinRssiV2,
877                        clcrDot11aHysteresisV2,
878                        clcrDot11aAdaptiveScanThresholdV2,
879                        clcrDot11aTransitionTimeV2
880                    }
881    STATUS          current
882    DESCRIPTION
883        "This collection of objects represent the radio
884        parameters for the 802.11a networks."
885    ::= { ciscoLwappClRoamMIBGroups 5 }
886
887ciscoLwappClRoamDot11bRfParamsGroupSup1 OBJECT-GROUP
888    OBJECTS         {
889                        clcrDot11bMode,
890                        clcrDot11bMinRssiV2,
891                        clcrDot11bHysteresisV2,
892                        clcrDot11bAdaptiveScanThresholdV2,
893                        clcrDot11bTransitionTimeV2
894                    }
895    STATUS          current
896    DESCRIPTION
897        "This collection of objects represent the radio
898        parameters for the 802.11b/g bands."
899    ::= { ciscoLwappClRoamMIBGroups 6 }
900
901END
902
903
904
905
906