[Docs] [txt|pdf] [Tracker] [WG] [Email] [Diff1] [Diff2] [Nits]

Versions: (draft-yangshi-capwap-802dot11-mib) 00 01 02 03 04 05 06 RFC 5834

Internet Engineering Task Force                              Y. Shi, Ed.
Internet-Draft                                        H3C Tech. Co., Ltd
Intended status: Standards Track                         D. Perkins, Ed.
Expires: April 30, 2009                                         SNMPinfo
                                                         C. Elliott, Ed.
                                                     Cisco Systems, Inc.
                                                           Y. Zhang, Ed.
                                                          Fortinet, Inc.
                                                        October 27, 2008


              CAPWAP Protocol Binding MIB for IEEE 802.11
                   draft-ietf-capwap-802dot11-mib-02

Status of This Memo

   By submitting this Internet-Draft, each author represents that any
   applicable patent or other IPR claims of which he or she is aware
   have been or will be disclosed, and any of which he or she becomes
   aware will be disclosed, in accordance with Section 6 of BCP 79.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF), its areas, and its working groups.  Note that
   other groups may also distribute working documents as Internet-
   Drafts.

   Internet-Drafts are draft documents valid for a maximum of six months
   and may be updated, replaced, or obsoleted by other documents at any
   time.  It is inappropriate to use Internet-Drafts as reference
   material or to cite them other than as "work in progress."

   The list of current Internet-Drafts can be accessed at
   http://www.ietf.org/ietf/1id-abstracts.txt.

   The list of Internet-Draft Shadow Directories can be accessed at
   http://www.ietf.org/shadow.html.

   This Internet-Draft will expire on April 30, 2009.

Abstract

   This memo defines a portion of the Management Information Base (MIB)
   for use with network management protocols.  In particular, it
   describes managed objects for modeling the Control And Provisioning
   of Wireless Access Points (CAPWAP) Protocol for IEEE 802.11 wireless
   binding.





Shi, et al.              Expires April 30, 2009                 [Page 1]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


Table of Contents

   1.  Introduction . . . . . . . . . . . . . . . . . . . . . . . . .  3
   2.  The Internet-Standard Management Framework . . . . . . . . . .  3
   3.  Terminology  . . . . . . . . . . . . . . . . . . . . . . . . .  3
   4.  Conventions  . . . . . . . . . . . . . . . . . . . . . . . . .  3
   5.  Overview . . . . . . . . . . . . . . . . . . . . . . . . . . .  4
   6.  Structure of the MIB Module  . . . . . . . . . . . . . . . . .  4
     6.1.  The capwapDot11Objects Subtree . . . . . . . . . . . . . .  5
     6.2.  The capwapDot11Conformance Subtree . . . . . . . . . . . .  5
     6.3.  Brief Description of MIB Objects . . . . . . . . . . . . .  5
   7.  Relationship to Other MIB Modules  . . . . . . . . . . . . . .  5
     7.1.  Relationship to the SNMPv2-MIB . . . . . . . . . . . . . .  5
     7.2.  Relationship to the IF-MIB . . . . . . . . . . . . . . . .  6
     7.3.  Relationship to CAPWAP-BASE-MIB  . . . . . . . . . . . . .  8
     7.4.  Relationship to the MIBs defined in IEEE 802.11
           standard and its amendments  . . . . . . . . . . . . . . .  8
     7.5.  MIB modules required for IMPORTS . . . . . . . . . . . . .  8
   8.  Example of CAPWAP-DOT11-MIB Usage  . . . . . . . . . . . . . .  8
   9.  Definitions  . . . . . . . . . . . . . . . . . . . . . . . . . 12
   10. Security Considerations  . . . . . . . . . . . . . . . . . . . 19
   11. IANA Considerations  . . . . . . . . . . . . . . . . . . . . . 20
     11.1. IANA Considerations for CAPWAP-DOT11-MIB . . . . . . . . . 20
     11.2. IANA Considerations for ifType . . . . . . . . . . . . . . 20
   12. Contributors . . . . . . . . . . . . . . . . . . . . . . . . . 20
   13. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 20
   14. References . . . . . . . . . . . . . . . . . . . . . . . . . . 20
     14.1. Normative References . . . . . . . . . . . . . . . . . . . 20
     14.2. Informative References . . . . . . . . . . . . . . . . . . 22






















Shi, et al.              Expires April 30, 2009                 [Page 2]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


1.  Introduction

   The CAPWAP Protocol [I-D.ietf-capwap-protocol-specification] defines
   a standard, interoperable protocol, which enables an Access
   Controller (AC) to manage a collection of Wireless Termination
   Points(WTPs).  CAPWAP supports the use of various wireless
   technologies by the WTPs, with one being specified in the 802.11
   binding document [I-D.ietf-capwap-protocol-binding-ieee80211].

   This document defines a MIB module that can be used to manage CAPWAP
   implementations for IEEE 802.11 wireless binding.  This MIB module
   covers both configuration for WLAN and a way to reuse the MIBs
   defined in IEEE 802.11 standard and its amendments.

2.  The Internet-Standard Management Framework

   For a detailed overview of the documents that describe the current
   Internet-Standard Management Framework, please refer to section 7 of
   RFC 3410 [RFC3410].

   Managed objects are accessed via a virtual information store, termed
   the Management Information Base or MIB.  MIB objects are generally
   accessed through the Simple Network Management Protocol (SNMP).
   Objects in the MIB are defined using the mechanisms defined in the
   Structure of Management Information (SMI).  This memo specifies a MIB
   module that is compliant to the SMIv2, which is described in STD 58,
   RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580
   [RFC2580].

3.  Terminology

   This document uses terminology from the document describing the
   CAPWAP Protocol specification for 802.11 binding
   [I-D.ietf-capwap-protocol-binding-ieee80211].  Besides terminology
   defined in the IEEE 802.11 standard and CAPWAP specification, an
   important conception is WLAN service.  In the document, WLAN service
   refers to a logical component instantiated on a WTP device.  A single
   physical WTP may operate a number of WLAN services, and the way is
   called as virtual AP.  Each Basic Service Set Identifier (BSSID) and
   its constituent wireless terminal radios are denoted as a distinct
   WLAN on a physical WTP.  To support physical WTP with multiple WLANs
   is an important feature for CAPWAP protocol's 802.11 binding, and it
   is also for MIB design.

4.  Conventions

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this



Shi, et al.              Expires April 30, 2009                 [Page 3]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


   document are to be interpreted as described in RFC 2119 [RFC2119].

5.  Overview

   The [I-D.ietf-capwap-base-mib] provides a way to configure and manage
   WTP and radio objects through SNMP.  It's a basis for manage and
   control a IEEE 802.11 binding.

   The CAPWAP Protocol's IEEE 802.11 binding MIB module (CAPWAP-DOT11-
   MIB) provides a way to configure WLAN service, and it also allows to
   easily reuse current and future MIBs defined in IEEE 802.11 standard
   and its amendments.

   It is designed to satisfy the following requirements and constraints:

   - The MIB module could easily reuse current and future MIBs defined
   in IEEE 802.11 standard and its amendments, and not require to
   redefine them.

   - From AC to centrally manage and configure WLAN service;

   - Operators could configure MAC type and tunnel mode for a specific
   WLAN service by SNMP;

   - The MIB module supports virtual AP;

   Before coming to details of CAPWAP-DOT11-MIB module, it will
   introduce how it is able to reuse IEEE MIB standard.  According to
   [I-D.ietf-capwap-protocol-binding-ieee80211], each WLAN service is
   identified by WLAN Id.  In the MIBs defined in IEEE 802.11 standard
   and its amendments, the MIB tables such as
   Dot11AuthenticationAlgorithmsTable are able to support wireless
   configuration (such as authentication algorithm), and these tables
   use ifIndex as index.  To support 802.11 parameters for a specific
   WLAN service, and consider that the operator has to prepare
   configurations for each WLAN service on the AC before WTPs connect to
   AC, a wireless service could be abstracted as a 'WLAN Service
   Interface' on the AC, and which could be identified by ifIndex.  On
   the AC, the MIB table CapwapDot11WlanConfigTable will indicate the
   mapping relation between a 'WLAN Id" and ifIndex of a 'WLAN Service
   Interface'.  With ifIndex of a 'WLAN Service Interface', system is
   able to reuse the MIBs defined in IEEE 802.11 standard and its
   amendments.

6.  Structure of the MIB Module






Shi, et al.              Expires April 30, 2009                 [Page 4]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


6.1.  The capwapDot11Objects Subtree

   The subtree provides information for configuration parameters of WLAN
   service and binding WLAN service to a specific radio.

6.2.  The capwapDot11Conformance Subtree

   The subtree provides conformance information of MIB objects.

6.3.  Brief Description of MIB Objects

   The MIB objects were derived from the CAPWAP protocol binding for
   802.11 document [I-D.ietf-capwap-protocol-binding-ieee80211].

   1) capwapDot11WlanConfigTable

   The table is used for providing configuration such as MAC type and so
   on for WLANs.  For a specific WLAN service which is identified by
   capwapDot11WlanId, an interface of 'WLAN Service Interface' ifType
   will be created.  By the ifIndex of interface, it provides a way to
   reuse the MIBs defined in IEEE 802.11 standard and its amendments.
   For example, according to
   [I-D.ietf-capwap-protocol-binding-ieee80211], Auth Type needs to be
   configured for a WLAN.  In IEEE 802.11 MIB, the MIB object
   dot11AuthenticationAlgorithm in the
   dot11AuthenticationAlgorithmsTable is corresponding to Auth Type.
   Considering both capwapDot11WlanConfigTable and
   dot11AuthenticationAlgorithmsTable use ifIndex as index, CAPWAP-
   DOT11-MIB are able to easily reuse dot11AuthenticationAlgorithm
   object in IEEE 802.11 MIB.  It is same for other objects in the MIBs
   defined in IEEE 802.11 standard and its amendments.

   2) capwapDot11WlanBindTable

   The table provides a way to bind WLAN service to a radio, then
   supports virtual AP.  The binding operation will dynamically create
   'WLAN BSS Interface', and this logical interface is used for data
   forwarding function.

7.  Relationship to Other MIB Modules

7.1.  Relationship to the SNMPv2-MIB

   The 'system' group in the SNMPv2-MIB [RFC3418] is defined as being
   mandatory for all systems, and the objects apply to the entity as a
   whole.  The 'system' group provides identification of the management
   entity and certain other system-wide data.  The CAPWAP-DOT11-MIB does
   not duplicate those objects.



Shi, et al.              Expires April 30, 2009                 [Page 5]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


7.2.  Relationship to the IF-MIB

   The Interfaces Group [RFC2863] defines generic managed objects for
   managing interfaces.  This memo contains the media-specific
   extensions to the Interfaces Group for managing WLAN service that are
   modeled as interfaces.

   For each WLAN, it will have a logical interface of 'WLAN Service
   Interface' responding to it on the AC.  The interface SHOULD be
   modeled as an ifEntry and provide appropriate interface information.
   'WLAN Service Interface' provides a way to configure IEEE 802.11
   parameters for a specific WLAN service, and reuse the MIBs defined in
   IEEE 802.11 standard and its amendments.

   To provide data forwarding service, system will dynamically create
   logical interface of 'WLAN BSS Interface'.  The interface SHOULD be
   modeled as an ifEntry and provide appropriate interface information.
   The interface enables the virtual AP function.

   Some specific interpretations of ifTable for CAPWAP-DOT11-MIB are as
   follow.

   1) WLAN Service Interface

      Object          Use for the CAPWAP-DOT11-MIB

   ifIndex         Each interface of 'WLAN Service Interface' type
                   maybe be represented by an ifEntry.

   ifDescr         Description of the interface of 'WLAN Service
                   Interface' type.

   ifType          IANAifType of 'WLAN Service Interface'.

   ifName          Textual name (unique on this system) of the interface
                   or an octet string of zero length.

   ifAlias         The nonvolatile 'alias' name for the interface, as
                   specified by a network manager.

   ifPhysAddress   Unused.

   ifAdminStatus   This variable indicates the administrator's intent as
                   to whether PHY should be enabled, disabled. Could be
                   always enabled.

   ifOperStatus    This value reflects the actual or operational status
                   of interface. Could be always enabled.



Shi, et al.              Expires April 30, 2009                 [Page 6]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


                   Also see [RFC2863].

   ifLastChange    The value of sysUpTime at the time the interface
                   entered its current operational state.
                   Also see [RFC2863].

   The other objects such as ifInOctets, ifOutOctets, ifInErrors,
   ifOutErrors are unused.

   2) WLAN BSS Interface

      Object          Use for the CAPWAP-DOT11-MIB

   ifIndex         Each interface of 'WLAN BSS Interface' type maybe
                   be represented by an ifEntry.

   ifDescr         Description of the interface of 'WLAN BSS Interface'
                   type.

   ifType          IANAifType of 'WLAN BSS Interface'.

   ifName          Textual name (unique on this system) of the interface
                   or an octet string of zero length.

   ifAlias         The nonvolatile 'alias' name for the interface, as
                   specified by a network manager.

   ifPhysAddress   The physical address of interface, i.e. WTP assigned
                   BSSID.

   ifAdminStatus   This variable indicates the administrator's intent as
                   to whether PHY should be enabled, disabled, or
                   running in some diagnostic testing mode on this
                   interface.
                   Also see [RFC2863].

   ifOperStatus    This value reflects the actual or operational status
                   of interface.
                   Also see [RFC2863].

   ifLastChange    The value of sysUpTime at the time the interface
                   entered its current operational state.
                   Also see [RFC2863].

   ifInOctets      The number of octets received as IEEE 802.11 frames.

   ifOutOctets     The number of octets transmitted as IEEE 802.11
                   frames.



Shi, et al.              Expires April 30, 2009                 [Page 7]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


   ifInErrors      The number of inbound IEEE 802.11 frames dropped due
                   to uncorrectable errors.

   ifInUnknownProtos
                   The number of received IEEE 802.11 frame discarded
                   during frame header validation, including frames with
                   unrecognized label values.

   ifOutErrors     The number of outbound IEEE 802.11 frames dropped due
                   to uncorrectable errors.

7.3.  Relationship to CAPWAP-BASE-MIB

   The CAPWAP-BASE-MIB provides a way to manage and control WTP and
   radio objects.  Especially, CAPWAP-BASE-MIB has a mechanism of 'WTP
   Virtual Radio Interface' which enable system to reuse the MIBs
   defined in IEEE 802.11 standard and its amendments.  With it,
   administrator could configure an IEEE 802.11 AP radio's parameter and
   query radio's traffic statistics.  Based on CAPWAP-BASE-MIB, CAPWAP-
   DOT11-MIB provides more information from WLAN service perspective.

7.4.  Relationship to the MIBs defined in IEEE 802.11 standard and its
      amendments

   Through ifIndex of 'WLAN Service Interface' and 'WLAN BSS Interface'
   ifType, the MIB module is able to reuse MIB objects in the MIBs
   defined in IEEE 802.11 standard and its amendments.

   In the 802.11 binding document [I-D.ietf-capwap-protocol-binding-
   ieee80211], it involves a part of MIB objects defined by IEEE 802.11
   standard and its amendments.  Although CAPWAP-DOT11-MIB uses the
   802.11 binding document as a reference, it could reuse all the MIB
   objects defined by IEEE 802.11 standard and its amendments , and not
   limited by the scope of the 802.11 binding document.

7.5.  MIB modules required for IMPORTS

   The following MIB modules are required for IMPORTS: SNMPv2-SMI
   [RFC2578], SNMPv2-TC [RFC2579], SNMPv2-CONF [RFC2580], IF-MIB
   [RFC2863] and CAPWAP-BASE-MIB [I-D.ietf-capwap-base-mib].

8.  Example of CAPWAP-DOT11-MIB Usage

   In the CAPWAP-BASE-MIB, each PHY radio is identified by WTP Id and
   radio ID, and which has a corresponding 'WTP Virtual Radio Interface'
   on the AC. The IEEE 802.11 MIB associated with this interface
   can be used to configure IEEE 802.11 wireless binding parameters for
   radio such as RTS Threshold.



Shi, et al.              Expires April 30, 2009                 [Page 8]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


   In the CAPWAP 802.11 Binding MIB, each WLAN service is identified
   by WLAN Id, and which has a corresponding 'WLAN Service Interface'
   on the AC. The MIBs defined in IEEE 802.11 standard and its
   amendments associated with this interface can be used to configure
   WLAN parameters for a WLAN service, such as Authentication Algorithm.

   The 'WLAN BSS Interface', created by binding 'WTP Virtual Radio
   Interface' and 'WLAN Service Interface', is used for data forwarding.
   Combining the example provided in the [I-D.ietf-capwap-base-mib],
   the following is a whole example for configuration and management of
   WTP, radio and WLAN service for IEEE 802.11 binding.

   1) Identify each PHY radio by 'WTP Virtual Radio Interface'
   According to [I-D.ietf-capwap-protocol-specification], each radio on
   a WTP will be identified by a radio Id. Each WTP could be identified
   by its serial number.
   When configuration for a WTP is prepared before a WTP connects to AC,
   the following information is available in the
   CapwapBaseRadioBindTable.

   In CapwapBaseRadioBindTable
   {
     capwapBaseWTPId                     = 12345678,
     capwapBaseRadioId                   = 1,
     capwapBaseWtpVirtualRadioifIndex    = 10,
     capwapBaseWirelessBinding           = dot11(2)
   }

   Suppose WTP's serial number is 12345678, and first PHY radio's id
   is 1. On the AC, the ifIndex of 'WTP Virtual Radio Interface' is
   10 which represents the PHY radio 1.
   By the mechanism of 'WTP Virtual Radio Interface', it seemed that WTP
   PHY radios are located on the AC.
   The interface of 'WTP Virtual Radio Interface' is modeled by ifTable.

   In ifTable
   {
     ifIndex              = 10,
     ifDescr              = 'WTP Virtual Radio Interface',
     ifType               = IANAifType of 'WTP Virtual Radio
                            Interface',
     ifMtu                = 0,
     ifSpeed              = 0,
     ifPhysAddress        = 0.0.0.0.0.0,
     ifAdminStatus        = true,
     ifOperStatus         = false,
     ifLastChange         = 0,
     ifInOctets           = 0,



Shi, et al.              Expires April 30, 2009                 [Page 9]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


     ifInUcastPkts        = 0,
     ifInDiscards         = 0,
     ifInErrors           = 0,
     ifInUnknownProtos    = 0,
     ifOutOctets          = 0,
     ifOutUcastPkts       = 0,
     ifOutDiscards        = 0,
     ifOutErrors          = 0
   }

   2) Configure IEEE 802.11 wireless binding parameters for 'WTP Virtual
   Radio Interface'
   It will be done on the AC through the MIBs defined in IEEE 802.11
   standard and its amendments.
   For example, to configure parameter for 'WTP Virtual Radio Interface'
   by IEEE 802.11 Dot11OperationTable.

   In Dot11OperationTable
   {
     ifIndex                         = 10,
     dot11MACAddress                 = 0.0.0.0.0.0,
     dot11RTSThreshold               = 2347,
     dot11ShortRetryLimit            = 7,
     dot11LongRetryLimit             = 4,
     dot11FragmentationThreshold     = 256,
     dot11MaxTransmitMSDULifetime    = 512,
     dot11MaxReceiveLifetime         = 512,
     dot11ManufacturerID             = 'capwap',
     dot11ProductID                  = 'capwap'
   }

   In the example, it supposes ifIndex of a 'WTP Virtual Radio
   Interface' is 10.

   3) Configure WLAN service

   WLAN service configuration will be done through CAPWAP-DOT11-MIB,
   and the MIBs defined in IEEE 802.11 standard and its amendments.

   First step is to create a 'WLAN Service Interface' through
   CAPWAP-DOT11-MIB on the AC.

   In CapwapDot11WlanConfigTable
   {
     capwapDot11WlanId                 = 1,
     capwapDot11WlanServiceIfIndex     = 20,
     capwapDot11WlanMacType            = splitMAC(2),
     capwapDot11WlanTunnelMode         = dot3Tunnel(2),



Shi, et al.              Expires April 30, 2009                [Page 10]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


     capwapDot11WlanConfigRowStatus    = create
   }

   Here supposes to configure a WLAN service which is identified by
   capwapDot11WlanId 1. A 'WLAN Service Interface' is created
   for it and identified by ifIndex 20.
   Corresponding to 'WLAN Service Interface', it SHOULD be modeled as an
   ifEntry on the AC and provide appropriate interface information.

   In ifTable
   {
     ifIndex              = 20,
     ifDescr              = 'WLAN Service Interface',
     ifType               = IANAifType of 'WLAN Service Interface',
     ifMtu                = 0,
     ifSpeed              = 0,
     ifPhysAddress        = 0.0.0.0.0.0,
     ifAdminStatus        = true,
     ifOperStatus         = true,
     ifLastChange         = 0,
     ifInOctets           = 0,
     ifInUcastPkts        = 0,
     ifInDiscards         = 0,
     ifInErrors           = 0,
     ifInUnknownProtos    = 0,
     ifOutOctets          = 0,
     ifOutUcastPkts       = 0,
     ifOutDiscards        = 0,
     ifOutErrors          = 0
   }

   Second step is to configure WLAN parameters of 'WLAN Service
   Interface' through the MIBs defined in IEEE 802.11 standard and
   its amendments on the AC.

   In Dot11AuthenticationAlgorithmsTable
   {
     ifIndex                                = 20,
     dot11AuthenticationAlgorithmsIndex     = 1,
     dot11AuthenticationAlgorithm           = Shared Key,
     dot11AuthenticationAlgorithmsEnable    = true
   }

   Here ifIndex 20 is for interface of 'WLAN Service Interface'
   ifType. Suppose the index of authentication algorithm is 1.

   4) Bind WLAN service to WTP radio
   On the AC, through CapwapDot11WlanBindTable, it configures which



Shi, et al.              Expires April 30, 2009                [Page 11]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


   WLAN service (identified by capwapDot11WlanId) will be provided
   on which radio (identified by ifIndex).
   Suppose capwapDot11WlanMacType of WLAN service is splitMAC(2),
   the interface of 'WLAN BSS Interface' will be created on the AC.
   The AC will use it for split data forwarding. Here supposes ifIndex
   of interface in 'WLAN BSS Interface' ifType is 30.

   In CapwapDot11WlanBindTable
   {
     ifIndex                        = 10,
     capwapDot11WlanId              = 1,
     capwapDot11WlanBssIfIndex      = 30,
     capwapDot11WlanBssRowStatus    = create
   }

   5) WTP reports its current configuration status

   After join phase and before WTP get configuration from AC, it will
   report its current configuration status to AC through configuration
   status request message. The MIB data will be updated on the AC.
   As an example, for ifIndex 10 (which identifies an interface of 'WLAN
   Virtual Radio Interface' ifType), its ifOperStatus in ifTable will
   be updated with current radio operational status.

   6) Query WTP and radio statistics data
   After WTPs come to run status, administrator could query WTP and
   radio statistics data through CAPWAP-BASE-MIB and CAPWAP-DOT11-MIB.
   For example, through dot11CountersTable in the IEEE 802.11 MIB,
   administrator could query counter data for radio which is identified
   by ifIndex of a 'WLAN Virtual Radio Interface'.

   7) Query other statistics data

   For example, administrator could query the configuration of
   WLAN service through Dot11AuthenticationAlgorithmsTable and statistic
   data of 'WLAN BSS Interface' through ifTable;

9.  Definitions

CAPWAP-DOT11-MIB DEFINITIONS ::= BEGIN

IMPORTS
   RowStatus, TEXTUAL-CONVENTION
       FROM SNMPv2-TC
   OBJECT-GROUP, MODULE-COMPLIANCE
       FROM SNMPv2-CONF
   MODULE-IDENTITY, OBJECT-TYPE, mib-2, Unsigned32
       FROM SNMPv2-SMI



Shi, et al.              Expires April 30, 2009                [Page 12]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


   ifIndex, InterfaceIndex
       FROM IF-MIB
   CapwapBaseMacTypeTC, CapwapBaseTunnelModeTC
       FROM CAPWAP-BASE-MIB;

capwapDot11MIB MODULE-IDENTITY
    LAST-UPDATED "200810270000Z"        -- Oct 27th, 2008
    ORGANIZATION "IETF Control And Provisioning of Wireless Access
                  Points (CAPWAP) Working Group
                  http://www.ietf.org/html.charters/capwap-charter.html"
    CONTACT-INFO
        "General Discussion: capwap@frascone.com
         To Subscribe: http://lists.frascone.com/mailman/listinfo/capwap

         Yang Shi
         H3C, Digital Technology Plaza, NO.9 Shangdi 9th Street,Haidian
         District,Beijing,China(100085)
         Email:  young@h3c.com

         David T. Perkins
         228 Bayview Dr
         San Carlos, CA 94070
         USA
         Phone: +1 408 394-8702
         Email:  dperkins@snmpinfo.com

         Chris Elliott
         Cisco Systems, Inc.
         7025 Kit Creek Rd., P.O. Box 14987
         Research Triangle Park  27709
         USA
         Phone: +1 919-392-2146
         Email: chelliot@cisco.com

         Yong Zhang
         Fortinet, Inc.
         1090 Kifer Road
         Sunnyvale, CA 94086
         USA
         Email: yzhang@fortinet.com"

   DESCRIPTION
       "Copyright (C) 2008 The Internet Society.  This version of
        the MIB module is part of RFC xxx; see the RFC itself
        for full legal notices.

        This MIB module contains managed object definitions for
        the IEEE 802.11 bindings for the CAPWAP Protocol."



Shi, et al.              Expires April 30, 2009                [Page 13]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


   REVISION    "200810270000Z"
   DESCRIPTION
       "Initial version, published as RFC xxx"
        ::= { mib-2 xxx }

-- Textual conventions

CapwapDot11WlanIdTC ::= TEXTUAL-CONVENTION
    DISPLAY-HINT "d"
    STATUS      current
    DESCRIPTION
        "Represents an unique identifier of a WLAN."
    SYNTAX      Unsigned32 (1..16)


-- Top level components of this MIB

-- Tables, Scalars
capwapDot11Objects OBJECT IDENTIFIER
    ::= { capwapDot11MIB 1 }
-- Conformance
capwapDot11Conformance OBJECT IDENTIFIER
    ::= { capwapDot11MIB 2 }


-- capwapDot11WlanConfigTable Table

capwapDot11WlanConfigTable OBJECT-TYPE
    SYNTAX      SEQUENCE OF CapwapDot11WlanConfigEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "A table of objects that display and control the WLAN
         service.
         Values of all read-create objects in this
         table are persistent at restart/reboot."
    ::= { capwapDot11Objects 1 }

capwapDot11WlanConfigEntry  OBJECT-TYPE
    SYNTAX      CapwapDot11WlanConfigEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "A set of objects that display and control the WLAN
         service."
    INDEX { capwapDot11WlanId }
    ::= { capwapDot11WlanConfigTable 1 }




Shi, et al.              Expires April 30, 2009                [Page 14]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


CapwapDot11WlanConfigEntry ::=
    SEQUENCE {
      capwapDot11WlanId                 CapwapDot11WlanIdTC,
      capwapDot11WlanServiceIfIndex     InterfaceIndex,
      capwapDot11WlanMacType            CapwapBaseMacTypeTC,
      capwapDot11WlanTunnelMode         CapwapBaseTunnelModeTC,
      capwapDot11WlanConfigRowStatus    RowStatus
    }

capwapDot11WlanId OBJECT-TYPE
    SYNTAX      CapwapDot11WlanIdTC
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "Represents the WLAN Id for a WLAN which has a
         capwapDot11WlanServiceIfIndex interface corresponding to it."
    REFERENCE
        "Section 6.1. of CAPWAP Protocol Binding for IEEE 802.11,
         RFC xxx."
    ::= { capwapDot11WlanConfigEntry 1 }

capwapDot11WlanServiceIfIndex OBJECT-TYPE
    SYNTAX      InterfaceIndex
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "Represents the index value that uniquely identifies a
         'WLAN Service Interface'. The interface identified by a
         particular value of this index is the same interface as
         identified by the same value of ifIndex.
         Before WTPs connect to AC and get configuration, administrator
         will prepare configuration for them. For a specific WLAN
         service, a logical interface of 'WLAN Service Interface'
         ifType will be created, and administrator could configure WLAN
         parameter through it. For example, according to IEEE 802.11
         '6.1. IEEE 802.11 Add WLAN' in the
         [I-D.ietf-capwap-protocol-binding-ieee80211], administrator
         could configure Auth Type for a WLAN. The 'WLAN
         Service Interface' provides a way to uniquely identify each
         WLAN by logical on the AC. As most MIBs use ifIndex to
         identify an interface for configuration and statistic data,
         for example, dot11AuthenticationAlgorithmsTable in IEEE 802.11
         MIB use ifIndex as index, and dot11AuthenticationAlgorithm
         object is for Auth Type mentioned in the CAPWAP '6.1. IEEE
         802.11 Add WLAN', With the way of 'WLAN Service Interface',
         it will easily reuse MIB table like
         dot11AuthenticationAlgorithmsTable, while only care for other
         configurations like capwapDot11WlanTunnelMode."



Shi, et al.              Expires April 30, 2009                [Page 15]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


    ::= { capwapDot11WlanConfigEntry 2 }

capwapDot11WlanMacType OBJECT-TYPE
    SYNTAX      CapwapBaseMacTypeTC
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
        "Represents whether the WTP should support the WLAN in
         Local or Split MAC modes."
    REFERENCE
        "Section 6.1. of CAPWAP Protocol Binding for IEEE 802.11,
         RFC xxx."
    ::= { capwapDot11WlanConfigEntry 3 }

capwapDot11WlanTunnelMode OBJECT-TYPE
    SYNTAX      CapwapBaseTunnelModeTC
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
        "Represents the frame tunneling type to be used for 802.11 data
         frames from all stations associated with the WLAN.
         Bits are exclusive with each other for a specific WLAN Id."
    REFERENCE
        "Section 6.1. of CAPWAP Protocol Binding for IEEE 802.11,
         RFC xxx."
    ::= { capwapDot11WlanConfigEntry 4 }

capwapDot11WlanConfigRowStatus OBJECT-TYPE
    SYNTAX      RowStatus
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
        "This variable is used to create, modify, and/or delete a row in
         this table."
    ::= { capwapDot11WlanConfigEntry 5 }

-- End of capwapDot11WlanConfigTable Table


-- capwapDot11WlanBindTable Table

capwapDot11WlanBindTable OBJECT-TYPE
    SYNTAX      SEQUENCE OF CapwapDot11WlanBindEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "A table of objects that display and control the mapping
         relationship between interface of 'WTP Virtual Radio Interface'



Shi, et al.              Expires April 30, 2009                [Page 16]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


         interface and interface of 'WLAN BSS Interface'.
         The PHY address for interface of  'WTP Virtual Radio
         Interface' ifType will be base BSSID address for PHY
         radio."
    REFERENCE
        "Section 6.1. of CAPWAP Protocol Binding for IEEE 802.11,
         RFC xxx."
    ::= { capwapDot11Objects 2 }

capwapDot11WlanBindEntry OBJECT-TYPE
    SYNTAX      CapwapDot11WlanBindEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "A set of objects that display the mapping relationship
         between interface of 'WTP Virtual Radio Interface' and
         interface of 'WLAN BSS Interface'."
    INDEX { ifIndex, capwapDot11WlanId }
    ::= { capwapDot11WlanBindTable 1 }

CapwapDot11WlanBindEntry ::=
    SEQUENCE {
      capwapDot11WlanBssIfIndex      InterfaceIndex,
      capwapDot11WlanBssRowStatus    RowStatus
    }

capwapDot11WlanBssIfIndex OBJECT-TYPE
    SYNTAX      InterfaceIndex
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "Represents the index value that uniquely identifies a
         'WLAN BSS Interface'. The interface identified by a
         particular value of this index is the same interface as
         identified by the same value of ifIndex.
         Each capwapDot11WlanBssIfIndex will corresponding to a
         WLAN service on the PHY radio which is identified by ifIndex.
         The PHY address for capwapDot11WlanBssIfIndex is BSSID.
         While manufacturers are free to assign BSSIDs using any
         arbitrary mechanism, it is advised that where possible the
         BSSIDs are assigned as a contiguous block.
         When assigned as a block, implementations can still assign
         any of the available BSSIDs to any WLAN.  One possible method
         is for the WTP to assign the address using the following
         algorithm: base BSSID address + WLAN ID."
    REFERENCE
        "Section  2.4.  of CAPWAP Protocol Binding for IEEE 802.11,
         RFC xxx."



Shi, et al.              Expires April 30, 2009                [Page 17]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


    ::= { capwapDot11WlanBindEntry 1 }

capwapDot11WlanBssRowStatus OBJECT-TYPE
    SYNTAX      RowStatus
    MAX-ACCESS  read-create
    STATUS      current
    DESCRIPTION
        "This variable is used to create, modify, and/or delete a row
         in this table."
    ::= { capwapDot11WlanBindEntry 2 }

-- End of capwapDot11WlanBindTable Table


-- Module compliance

capwapDot11Groups OBJECT IDENTIFIER
    ::= { capwapDot11Conformance 1 }

capwapDot11Compliances OBJECT IDENTIFIER
    ::= { capwapDot11Conformance 2 }

capwapDot11Compliance MODULE-COMPLIANCE
    STATUS current
    DESCRIPTION
        "Describes the requirements for conformance to the
         CAPWAP-DOT11-MIB."

    MODULE -- this module
      MANDATORY-GROUPS {
        capwapDot11WlanConfigGroup,
        capwapDot11WlanBindGroup
      }
    ::= { capwapDot11Compliances 1 }

capwapDot11WlanConfigGroup    OBJECT-GROUP
    OBJECTS {
      capwapDot11WlanServiceIfIndex,
      capwapDot11WlanMacType,
      capwapDot11WlanTunnelMode,
      capwapDot11WlanConfigRowStatus
    }
    STATUS  current
    DESCRIPTION
        "The collection of objects which are used to configure
         property of WLAN."
    ::= { capwapDot11Groups 1 }




Shi, et al.              Expires April 30, 2009                [Page 18]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


capwapDot11WlanBindGroup    OBJECT-GROUP
    OBJECTS {
      capwapDot11WlanBssIfIndex,
      capwapDot11WlanBssRowStatus
    }
    STATUS  current
    DESCRIPTION
        "The collection of objects which are used to configure
         WLAN BSS."
    ::= { capwapDot11Groups 2 }

END

10.  Security Considerations

   There are a number of management objects defined in this MIB module
   with a MAX-ACCESS clause of read-write and/or read-create.  Such
   objects may be considered sensitive or vulnerable in some network
   environments.  The support for SET operations in a non-secure
   environment without proper protection can have a negative effect on
   network operations.  The followings are the tables and objects and
   their sensitivity/vulnerability:

   o  - Unauthorized changes to the capwapDot11WlanConfigTable and
      capwapDot11WlanBindTable may disrupt allocation of resources in
      the network, also change the behavior of WLAN system such as MAC
      type.

   SNMP versions prior to SNMPv3 did not include adequate security.
   Even if the network itself is secure (for example by using IPSec),
   even then, there is no control as to who on the secure network is
   allowed to access and GET/SET (read/change/create/delete) the objects
   in this MIB module.

   It is RECOMMENDED that implementers consider the security features as
   provided by the SNMPv3 framework (see [RFC3410], section 8),
   including full support for the SNMPv3 cryptographic mechanisms (for
   authentication and privacy).

   Further, deployment of SNMP versions prior to SNMPv3 is NOT
   RECOMMENDED.  Instead, it is RECOMMENDED to deploy SNMPv3 and to
   enable cryptographic security.  It is then a customer/operator
   responsibility to ensure that the SNMP entity giving access to an
   instance of this MIB module is properly configured to give access to
   the objects only to those principals (users) that have legitimate
   rights to indeed GET or SET (change/create/delete) them.





Shi, et al.              Expires April 30, 2009                [Page 19]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


11.  IANA Considerations

11.1.  IANA Considerations for CAPWAP-DOT11-MIB

        The MIB module in this document uses the following IANA-assigned
        OBJECT IDENTIFIER values recorded in the SMI Numbers registry:

        Descriptor        OBJECT IDENTIFIER value
        ----------        -----------------------

        capwapDot11MIB  { mib-2 XXX }

11.2.  IANA Considerations for ifType

   Require IANA to assign a ifType for 'WLAN Service Interface' type.

   Require IANA to assign a ifType for 'WLAN BSS Interface' type.

12.  Contributors

   This MIB is based on contributions from Long Gao.

13.  Acknowledgements

   The authors wish to thank David Harrington, Yu Liu, Xi Yao, Sachin
   Dutta, Yujin Zhao, Haitao Zhang.

14.  References

14.1.  Normative References

   [RFC2119]                                     Bradner, S., "Key words
                                                 for use in RFCs to
                                                 Indicate Requirement
                                                 Levels", BCP 14,
                                                 RFC 2119, March 1997.

   [RFC2578]                                     McCloghrie, K., Ed.,
                                                 Perkins, D., Ed., and
                                                 J. Schoenwaelder, Ed.,
                                                 "Structure of
                                                 Management Information
                                                 Version 2 (SMIv2)",
                                                 STD 58, RFC 2578,
                                                 April 1999.

   [RFC2579]                                     McCloghrie, K., Ed.,
                                                 Perkins, D., Ed., and



Shi, et al.              Expires April 30, 2009                [Page 20]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


                                                 J. Schoenwaelder, Ed.,
                                                 "Textual Conventions
                                                 for SMIv2", STD 58,
                                                 RFC 2579, April 1999.

   [RFC2580]                                     McCloghrie, K.,
                                                 Perkins, D., and J.
                                                 Schoenwaelder,
                                                 "Conformance Statements
                                                 for SMIv2", STD 58,
                                                 RFC 2580, April 1999.

   [RFC2863]                                     McCloghrie, K. and F.
                                                 Kastenholz, "The
                                                 Interfaces Group MIB",
                                                 RFC 2863, June 2000.

   [RFC3418]                                     Presuhn, R.,
                                                 "Management Information
                                                 Base (MIB) for the
                                                 Simple Network
                                                 Management Protocol
                                                 (SNMP)", STD 62,
                                                 RFC 3418,
                                                 December 2002.

   [I-D.ietf-capwap-base-mib]                    Shi, Y., Perkins, D.,
                                                 Elliott, C., and Y.
                                                 Zhang, "CAPWAP Protocol
                                                 Base MIB", draft-ietf-
                                                 capwap-base-mib-01
                                                 (work in progress),
                                                 October 2008.

   [I-D.ietf-capwap-protocol-specification]      Montemurro, M.,
                                                 Stanley, D., and P.
                                                 Calhoun, "CAPWAP
                                                 Protocol
                                                 Specification", draft-
                                                 ietf-capwap-protocol-
                                                 specification-14 (work
                                                 in progress),
                                                 October 2008.

   [I-D.ietf-capwap-protocol-binding-ieee80211]  Montemurro, M.,
                                                 Stanley, D., and P.
                                                 Calhoun, "CAPWAP
                                                 Protocol Binding for



Shi, et al.              Expires April 30, 2009                [Page 21]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


                                                 IEEE 802.11", draft-
                                                 ietf-capwap-protocol-
                                                 binding-ieee80211-11
                                                 (work in progress),
                                                 October 2008.

14.2.  Informative References

   [RFC3410]                                     Case, J., Mundy, R.,
                                                 Partain, D., and B.
                                                 Stewart, "Introduction
                                                 and Applicability
                                                 Statements for
                                                 Internet-Standard
                                                 Management Framework",
                                                 RFC 3410,
                                                 December 2002.

Authors' Addresses

   Yang Shi (editor)
   H3C Tech. Co., Ltd
   Digital Technology Plaza, NO.9 Shangdi 9th Street,Haidian District,
   Beijing
   China(100085)

   Phone: +86 010 82775276
   EMail: young@h3c.com


   David Perkins (editor)
   SNMPinfo
   288 Quailbrook Ct San Carlos,
   CA 94070
   USA

   Phone: +1 408 394-8702
   EMail: dperkins@snmpinfo.com













Shi, et al.              Expires April 30, 2009                [Page 22]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


   Chris Elliott (editor)
   Cisco Systems, Inc.
   7025 Kit Creek Rd., P.O. Box 14987 Research Triangle Park
   27709
   USA

   Phone: +1 919-392-2146
   EMail: chelliot@cisco.com


   Yong Zhang (editor)
   Fortinet, Inc.
   1090 Kifer Road
   Sunnyvale, CA 94086
   USA

   EMail: yzhang@fortinet.com


































Shi, et al.              Expires April 30, 2009                [Page 23]

Internet-Draft         CAPWAP Protocol Binding MIB          October 2008


Full Copyright Statement

   Copyright (C) The IETF Trust (2008).

   This document is subject to the rights, licenses and restrictions
   contained in BCP 78, and except as set forth therein, the authors
   retain all their rights.

   This document and the information contained herein are provided on an
   "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
   OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY, THE IETF TRUST AND
   THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS
   OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF
   THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
   WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Intellectual Property

   The IETF takes no position regarding the validity or scope of any
   Intellectual Property Rights or other rights that might be claimed to
   pertain to the implementation or use of the technology described in
   this document or the extent to which any license under such rights
   might or might not be available; nor does it represent that it has
   made any independent effort to identify any such rights.  Information
   on the procedures with respect to rights in RFC documents can be
   found in BCP 78 and BCP 79.

   Copies of IPR disclosures made to the IETF Secretariat and any
   assurances of licenses to be made available, or the result of an
   attempt made to obtain a general license or permission for the use of
   such proprietary rights by implementers or users of this
   specification can be obtained from the IETF on-line IPR repository at
   http://www.ietf.org/ipr.

   The IETF invites any interested party to bring to its attention any
   copyrights, patents or patent applications, or other proprietary
   rights that may cover technology that may be required to implement
   this standard.  Please address the information to the IETF at
   ietf-ipr@ietf.org.












Shi, et al.              Expires April 30, 2009                [Page 24]


Html markup produced by rfcmarkup 1.109, available from https://tools.ietf.org/tools/rfcmarkup/