Observium_CE/mibs/cisco/CISCO-DOT11-CONTEXT-SERVICES-MANAGER-MIB

689 lines
28 KiB
Plaintext

-- *******************************************************************
-- CISCO-DOT11-CONTEXT-SERVICES-MANAGER-MIB.my
--
-- October 2003, Francis Pang
--
-- Copyright (c) 2003 by Cisco Systems, Inc.
-- All rights reserved.
-- *******************************************************************
--
CISCO-DOT11-CONTEXT-SERVICES-MANAGER-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY,
OBJECT-TYPE,
Counter32
FROM SNMPv2-SMI
MODULE-COMPLIANCE,
OBJECT-GROUP
FROM SNMPv2-CONF
TEXTUAL-CONVENTION,
TimeInterval
FROM SNMPv2-TC
InetAddressType,
InetAddress
FROM INET-ADDRESS-MIB
ciscoMgmt
FROM CISCO-SMI;
--********************************************************************
--* MODULE IDENTITY
--********************************************************************
ciscoDot11CsMgrMIB MODULE-IDENTITY
LAST-UPDATED "200311020000Z"
ORGANIZATION "Cisco Systems Inc."
CONTACT-INFO
" Cisco Systems,
Customer Service
Postal: 170 West Tasman Drive
San Jose, CA 95134
USA
Tel: +1 800 553-NETS
E-mail: cs-dot11@cisco.com"
DESCRIPTION
"This MIB is intended to be implemented on IEEE
802.11 Wireless LAN management devices for Access
Points and Wireless Bridges participating in the
context management process and making use of
the services provided by entities offering WDS
and WNS. This MIB allows NMS to access individual
configuration of wireless stations through the
SNMP agent at the management device, i.e. WSA.
The term '802.11 station' or 'wireless station'
refers to one of the Access Point or Wireless
Bridge throughout the MIB unless stated otherwise.
The hierarchy of the devices offering the wireless
domain and network services looks like the following.
+= = = = +
| |
| WNS | (Campus level)
| |
+= = = = +
/ \
/ \
/ \
/ \
\/ \/
+= = =+ += = =+
| | | |
| WNS | | WNS |
| | | |
+= = =+ += = =+
/ \ \
/ \ \
/ \ \
/ \ \
\/ \/ \/
+=====+ +=====+ +-----+ +=====+
| | | | | | | |
| WDS | | WDS | | WSA | | WDS | ( Subnet
| | | | | | | | level-
+=====+ +=====+ +-----+ +=====+ Single
/ \ \ :: :: \ broadcast
/ \ \ :: :: \ domain )
/ \ \ :: :: \
/ \ \ :: :: \
/ \ \ :: :: \
\/ \/ \/ :: :: \/
+~-~-~+ +~-~-~+ +~-~-~+ +~-~-~+
+ + + + + + + +
+ AP + + AP + + AP + + AP +
+ + + + + + + +
+~-~-~+ +~-~-~+ +~-~-~+ +~-~-~+
.. . . .
. . . . .
. . . . .
. . . . .
. . . . .
\/ \/ \/ \/ \/
+.....+ +.....+ +-.-.-.+ +~-~-~+ +......+
+ + + + + + + + + +
+ MN + + MN + + WGB + + AP + + MN +
+ + + + + + + + + +
+.....+ +.....+ +-.-.-.+ +~-~-~+ +......+
. . .
. . .
. . .
. . .
\/ \/ \/
++++++++ +......+ +......+
+ + + + + +
+ EN + + MN + + MN +
+ + + + + +
++++++++ +......+ +......+
The diagram above depicts the overall campus network
hierarchy and the services being offered at various
levels in the hierarchy. Here, authentication
services for infrastructure nodes are offered by the
root node, the node providing WNS at the topmost
(Campus) level. This node spans an enterprise campus
that resides in a geographic location. In this case,
an 802.11 station performs initial authentication
with the topmost WNS entity. It also gets the keys
needed for secure context transfer by communication
with that entity.
WNS are offered at various levels as shown in the
hierarchy to achieve scalability. WNS at the
subsequent levels other than the root level include
authentication services for MNs and are typically
confined to a single building.
At the broadcast domain level, the WDS includes
authentication and registration services for the APs.
An AP provides proxy authentication and registration
services for the MNs. The APs that connect to parent
APs through the wireless interface ( as shown by the
dotted lines ) are Repeater-APs. The WGBs are managed
in the same manner as the MNs. However, the Ethernet
Nodes ( EN ) that are connected to the WGB won't be
served as part of the WDS.
GLOSSARY
Access Point ( AP )
Any 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.
Wireless Bridge
An 802.11 entity that provides wireless connectivity
between two wired LAN segments and is used in point-
to-point or point-to-multipoint configurations.
Mobile Node ( MN )
A roaming 802.11 wireless device in a wireless
network associated with an access point.
WorkGroup Bridge ( WGB )
A work-group bridge is a non-STP AP with an 802.11
primary port and a secondary Ethernet port that
provides access to a non-STP secondary Ethernet LAN
segment. STP refers to the IEEE 802.1D Spanning Tree
Protocol. An 'STP AP' executes the 802.1D STP and
the 802.1D STP is operated on an 'STP link'. A
'non-STP AP' does not execute the 802.1D STP.
Repeater-AP
A repeater is a 'wireless AP' that is attached to a
parent AP on an 802.11 primary port. The Ethernet
port is disabled in a Repeater-AP.
Infrastructure Node ( IN )
This term refers to Access Points, Wireless Bridges
and those devices that implement and offer WNS and
WDS as shown in the network hierarchy.
Ethernet Node ( EN )
The node that gets the uplink to the Wireless AP
via the WGB. This node connects to the WGB through
its primary Ethernet port.
Context
The mobility context for an MN includes its current
mobility bindings with the APs, IP/802 address
bindings, cached configuration parameters, QoS state,
IP group membership, authentication state, accounting
statistics, and other dynamically derived protocol
state information.
Wireless Domain Services
The set of services being offered at a particular
broadcast domain that may be an IP subnet or a
particular VLAN. The services include the following.
1. MN security credential caching to provide seamless,
secure intra-subnet roaming.
2. Authenticated context transfer for roaming client
within the subnet.
Since, by definition, the WDS are bound to one subnet
( broadcast domain ), if implemented in a device
spanning multiple subnets, the implementation should
take care to provide separate set of services for
each of the subnets.
Wireless Network Services
The set of services that can be visualized as being
offered at various levels other than the lowest
(subnet) level of a hierarchical campus network.
At the topmost level, infrastructure authentication
services for all the devices in the network that
provide WNS and WDS are offered. In case if WNS are
not distributed at several levels as shown in the
hierarchy above and is confined to be offered only at
a single topmost level, the services offered also
include authentication services for the MNs.
WNS Entity
The logical entity that resides in an infrastructure
node and offers WNS to the descendants of that
infrastructure node in the wireless services
hierarchy.
WDS Entity
The logical entity that resides in an infrastructure
node and offers WDS to the descendants of that
infrastructure node in the wireless services
hierarchy.
WS Entity
Refers to one of WNS / WDS Entities.
Parent Node
The entity that immediately precedes an infrastructure
node in the hierarchy. For mobile nodes, the parent
APs provide proxy wireless services by talking to their
immediate parent entities providing WDS.
Root Node
The entity that is at the highest level in the network
hierarchy. The root node acts as the IN Authenticator
for the infrastructure nodes. In case if WNS are not
distributed, the root node also acts as the Mobile Node
Authenticator ( See description below ).
Descendant
A node that is in the sub-tree of the campus hierarchy
tree rooted at the node providing WNS at the campus
level.
Infrastructure Node ( IN ) Authenticator
The logical entity that communicates with the AAA
server and provides authentication services for the
infrastructure nodes. Details of the IN Authenticator
has to be configured in the device providing WDS
manually. The AP learns about the IN Authenticator
automatically upon registering with its immediate
parent. The WDS also includes MN authentication
services if the entity providing WDS is at the
topmost level in the hierarchy.
Mobile Node ( MN ) Authenticator
The logical entity that communicates with the AAA
server and provides authentication services for mobile
nodes. An infrastructure node learns the whereabouts
of the MN Authenticator from the root node.
Wireless Network Manager ( WNM )
The network management system that manages the
entire hierarchy of devices providing WNS and WDS.
Advertisement
The process by which the Access Points identify their
parent entities providing WDS. APs listen to the
advertisements of the WDS entities and gets registered
with one of those entities to facilitate secured
context transfer.
WLCCP
Wireless LAN Context Control Protocol. Used to
establish and manage the network topology and
securely manage the 'operational context' for mobile
stations in a campus network.
WSA
Wireless Switch Architecture. A layer II switch
which is capable of manage directly and indirectly
attached 802.11 stations within a subnet.
AAA
Authentication, Authorization, Accounting
The method by which users are authenticated,
authorized and tracked to gain access and move about
inside a network. A node will request network access
through an appropriate protocol to an authentication
server that provides protocols and services for
providing authentication, authorization and session
accounting.
Service Set Identifier ( SSID )
802.11 Service Set Identifier. An SSID identifies a
set of mobile nodes grouped into a logical 'service
set' and the APs that provide access for the service
set.
Wireless services at subnet level
=================================
+========+
| |
| WDS | ( Subnet level - Broadcast
| | domain )
+========+
/ \
/ \
/ \
/ \
/ \
\/ \/
+~-~-~+ +~-~-~+
+ + + +
+ AP + + AP +
+ + + +
+~-~-~+ +~-~-~+
. . .
. . .
. . .
. . .
. . .
. . .
\/ \/ \/
+......+ +-.-.-.+ +~-~-~-+
+ + + + + +
+ MN + + WGB + + AP +
+ + + + + +
+......+ +-.-.-.+ +~-~-~-+
The above diagram depicts how wireless services are
being offered in a network rooted at the device
implementing WDS. In such a network, the WDS entity
provides authentication services to both the
infrastructure and mobile nodes.
An 802.11 station in this hierarchy mentioned above
performs the following.
1) Provides proxy authentication and registration
services to the MNs, WGBs and repeater-APs. The
station forwards all the authentication and
registration requests of its clients to its parent
node offering WDS and acting as the IN Authenticator
to enable the authentication and registration of its
clients.
2) Participates in the election process to elect
the node that will provide WDS for a particular
broadcast domain."
REVISION "200311020000Z"
DESCRIPTION
"Initial version of this MIB module."
::= { ciscoMgmt 3228 }
ciscoDot11CsMgrMIBObjects OBJECT IDENTIFIER
::= { ciscoDot11CsMgrMIB 1 }
ciscoDot11CsMgrMIBConformance OBJECT IDENTIFIER
::= { ciscoDot11CsMgrMIB 2 }
ciscoDot11CsMgrClientConfig OBJECT IDENTIFIER
::= { ciscoDot11CsMgrMIBObjects 1 }
Cdot11CsModuleIndex ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"An arbitrary value which uniquely identifies the
physical module. The value should be a small
positive integer; index values for different
physical modules are not necessarily contiguous."
SYNTAX INTEGER (1..2147483647)
--********************************************************************
--* Configuration per parameters
--********************************************************************
cDot11CsMgrClientTable OBJECT-TYPE
SYNTAX SEQUENCE OF CDot11CsMgrClientEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains the list of 802.11 client
stations currently managed by this device on the
device interfaces. This manager device may or
may not be one of the WDS entities in the
network.
This table is not applicable on any 802.11
wireless station that implements and supports the
CISCO-CONTEXT-SERVICES-CLIENT-MIB.
Rows are created internally by the agent when
802.11 stations are attached to it."
::= { ciscoDot11CsMgrClientConfig 1 }
cDot11CsMgrClientEntry OBJECT-TYPE
SYNTAX CDot11CsMgrClientEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry represents a 802.11 station entity currently
attached and managed by this manager device. It
includes information about the WDS currently associated
with the station."
INDEX { cDot11CsMgrClntModuleIndex }
::= { cDot11CsMgrClientTable 1 }
CDot11CsMgrClientEntry ::=
SEQUENCE {
cDot11CsMgrClntModuleIndex Cdot11CsModuleIndex,
cDot11CsMgrClntAddressType InetAddressType,
cDot11CsMgrClntParentWdsAddr InetAddress,
cDot11CsMgrClntRootNodeAddr InetAddress,
cDot11CsMgrClntMnAuthenAddr InetAddress,
cDot11CsMgrClntOperMode INTEGER,
cDot11CsMgrClntRegistLifeTime TimeInterval,
cDot11CsMgrClntStateTransitions Counter32
}
cDot11CsMgrClntModuleIndex OBJECT-TYPE
SYNTAX Cdot11CsModuleIndex
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This is the 802.11 wireless station module ID
assigned by this context services manager device."
::= { cDot11CsMgrClientEntry 1 }
cDot11CsMgrClntAddressType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Represents the type of addresses stored in the
objects cDot11CsMgrClntParentWdsAddr,
cDot11CsMgrClntRootNodeAddr and
cDot11CsMgrClntMnAuthenAddr."
REFERENCE
"CISCO-DOT11-CONTEXT-SERVICES-CLIENT-MIB, object
cDot11CscAddressType"
::= { cDot11CsMgrClientEntry 2 }
cDot11CsMgrClntParentWdsAddr OBJECT-TYPE
SYNTAX InetAddress
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The address of the parent WDS entity the 802.11
station is currently registered with. The type of
InetAddress supported by this object is determined
by the cDot11CsMgrClntAddressType object.
If cDot11CsMgrClntOperMode equals 'distributed', the
value returned is 0.0.0.0 to indicate that either
the client node is not registered with a WDS entity
or that no parent WDS entity existed when the query
was made."
REFERENCE
"CISCO-DOT11-CONTEXT-SERVICES-CLIENT-MIB, object
cDot11CscParentWdsAddress"
::= { cDot11CsMgrClientEntry 3 }
cDot11CsMgrClntRootNodeAddr OBJECT-TYPE
SYNTAX InetAddress
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The address of the root node the 802.11 station
gets authenticated with. The type of InetAddress
supported by this object is determined by the
cDot11CsMgrClntAddressType object.
If the parent WDS entity acts as the root node, this
object returns the address of the parent WDS entity.
If the hierarchy contains a campus level WNS entity,
this object returns the address of that WNS entity."
REFERENCE
"CISCO-DOT11-CONTEXT-SERVICES-CLIENT-MIB, object
cDot11CscRootNodeAddress"
::= { cDot11CsMgrClientEntry 4 }
cDot11CsMgrClntMnAuthenAddr OBJECT-TYPE
SYNTAX InetAddress
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The address of the Mobile Node Authenticator to
which the 802.11 station forwards authentication
requests of the mobile nodes attempting to associate
with it. The type of InetAddress supported by
this object is determined by the
cDot11CsMgrClntAddressType object.
If the parent WDS entity acts as the root node, so
that no WNS entity is present in the network
hierarchy, this object returns the address of the
parent WDS entity.
If the parent WDS entity has the root WNS entity as
its immediate parent, this object returns the
address of the root WNS entity.
If the WDS entity has a WNS entity, that is not the
root node, as its immediate parent, this object
returns the address of that WNS entity."
REFERENCE
"CISCO-DOT11-CONTEXT-SERVICES-CLIENT-MIB, object
cDot11CscMnAuthenticatorAddress"
::= { cDot11CsMgrClientEntry 5 }
cDot11CsMgrClntOperMode OBJECT-TYPE
SYNTAX INTEGER { infrastructure(1), distributed(2) }
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The current mode of operation of the 802.11
station.
The semantics for this object are as follows.
infrastructure - An 802.11 station operates in the
'infrastructure' mode if it discovers a WDS
entity through advertisement messages and registers
with it.
distributed - If the 802.11 station couldn't
discover a WDS entity or has lost contact with the
its parent WDS entity, then the station operates in
the 'distributed' mode. However, the station
listens for the advertisement messages from the WDS
entity in the background to get back to the
'infrastructure' mode."
REFERENCE
"CISCO-DOT11-CONTEXT-SERVICES-CLIENT-MIB, object
cDot11CscOperMode"
::= { cDot11CsMgrClientEntry 6 }
cDot11CsMgrClntRegistLifeTime OBJECT-TYPE
SYNTAX TimeInterval
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The maximum time after which the registration of
the 802.11 station with its parent WDS entity
expires."
REFERENCE
"CISCO-DOT11-CONTEXT-SERVICES-CLIENT-MIB, object
cDot11CscRegistrationLifeTime"
::= { cDot11CsMgrClientEntry 7 }
cDot11CsMgrClntStateTransitions OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object counts the number of times the 802.11
station has transitioned between the infrastructure
and distributed modes since the last reboot."
REFERENCE
"CISCO-DOT11-CONTEXT-SERVICES-CLIENT-MIB, object
cDot11CscStateTransitions"
::= { cDot11CsMgrClientEntry 8 }
--********************************************************************
--* End of 802.11 station Global Configuration parameters
--********************************************************************
--********************************************************************
-- Conformance information
--********************************************************************
ciscoDot11CsMgrMIBCompliances OBJECT IDENTIFIER
::= { ciscoDot11CsMgrMIBConformance 1 }
ciscoDot11CsMgrMIBGroups OBJECT IDENTIFIER
::= { ciscoDot11CsMgrMIBConformance 2 }
--********************************************************************
--* Compliance statements
--********************************************************************
ciscoDot11CsMgrMIBCompliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The compliance statement for the SNMP entities that
implement the ciscoDot11CsMgrMIB module."
MODULE MANDATORY-GROUPS {
ciscoDot11CsMgrClientGroup
}
::= { ciscoDot11CsMgrMIBCompliances 1 }
--********************************************************************
--* Units of conformance
--********************************************************************
ciscoDot11CsMgrClientGroup OBJECT-GROUP
OBJECTS {
cDot11CsMgrClntAddressType,
cDot11CsMgrClntParentWdsAddr,
cDot11CsMgrClntRootNodeAddr,
cDot11CsMgrClntMnAuthenAddr,
cDot11CsMgrClntOperMode,
cDot11CsMgrClntRegistLifeTime,
cDot11CsMgrClntStateTransitions
}
STATUS current
DESCRIPTION
"This collection of objects provide information about
individual 802.11 station's parent WDS, its mode of
operation, the address of the IN/MN authenticators,
its registration life time and the number of times
the station has switched between the two modes."
::= { ciscoDot11CsMgrMIBGroups 1 }
--********************************************************************
--* End of units of conformance
--********************************************************************
END