Table Of Contents
Cisco IOS Commands for Access Points
and Bridges
accounting (SSID configuration mode)
antenna
authentication (local server configuration mode)
authentication client
authentication key-management
authentication network-eap (SSID configuration mode)
authentication open (SSID configuration mode)
authentication shared (SSID configuration mode)
beacon
boot buffersize
boot ios-break
boot upgrade
bridge aging-time
bridge forward-time
bridge hello-time
bridge max-age
bridge priority
bridge protocol ieee
bridge-group block-unknown-source
bridge-group path-cost
bridge-group port-protected
bridge-group priority
bridge-group spanning-disabled
bridge-group subscriber-loop-control
bridge-group unicast-flooding
broadcast-key
cca
channel
class-map
clear dot11 aaa authentication mac-authen filter-cache
clear dot11 cckm-statistics
clear dot11 client
clear dot11 hold-list
clear dot11 statistics
clear iapp rogue-ap-list
clear iapp statistics
clear wlccp wds
concatenation
countermeasure tkip hold-time
debug dot11
debug dot11 aaa
debug dot11 dot11radio
debug iapp
debug radius local-server
debug wlccp ap
debug wlccp packet
debug wlccp rmlib
debug wlccp wds
distance
dot11 association mac-list
dot11 aaa authentication attributes service-type login-only
dot11 aaa authentication mac-authen filter-cache
dot11 aaa csid
dot11 activity-timeout
dot11 adjacent-ap age-timeout
dot11 antenna-alignment
dot11 arp-cache
dot11 carrier busy
dot11 extension aironet
dot11 holdoff-time
dot11 igmp snooping-helper
dot11 linktest
dot11 location isocc
dot11 meter
dot11 network-map
dot11 phone
dot11 priority_map avvid
dot11 ssid
dot11 update-group-key
dot11 vlan-name
dot1x reauth-period
eapfast authority
eapfast pac expiry
eapfast server-key
encryption key
encryption mode ciphers
encryption mode wep
exception crashinfo buffersize
exception crashinfo file
fragment-threshold
group (local server configuration mode)
guest-mode (SSID configuration mode)
iapp standby mac-address
iapp standby poll-frequency
iapp standby primary-shutdown
iapp standby timeout
information-element ssidl (SSID configuration mode)
infrastructure-client
infrastructure-ssid (SSID configuration mode)
interface dot11radio
ip redirection
l2-filter bridge-group-acl
led flash
logging buffered
logging snmp-trap
match (class-map configuration)
max-associations (SSID configuration mode)
mobile station
mobility network-id
nas (local server configuration mode)
packet retries
parent
parent timeout
payload-encapsulation
power client
power local
preamble-short
radius local-server pac-generate
radius-server local
rts
short-slot-time
show controllers dot11radio
show dot11 aaa authentication mac-authen filter-cache
show dot11 adjacent-ap
show dot11 associations
show dot11 carrier busy
show dot11 network-map
show dot11 statistics client-traffic
show dot11 vlan-name
show environment
show iapp rogue-ap-list
show iapp standby-parms
show iapp statistics
show interfaces dot11radio
show interfaces dot11radio aaa
show interfaces dot11radio statistics
show led flash
show power-injector
show radius local-server statistics
show running-config ssid
show spanning-tree
show wlccp
snmp-server enable traps envmon temperature
snmp-server location
speed
ssid
station-role
station-role install
traffic-class
user (local server configuration mode)
vlan (SSID configuration mode)
wlccp ap
wlccp authentication-server
wlccp wds aaa authentication mac-authen filter-cache
wlccp wds priority
wlccp wnm ip address
workgroup-bridge client-vlan
world-mode
wpa-psk
Cisco IOS Commands for Access Points
and Bridges
This chapter lists and describes Cisco IOS commands in Cisco IOS Release 12.3(2)XT that you use to configure and manage your access point, bridge, and wireless LAN. The commands are listed alphabetically. Refer to Appendix A, "List of Supported Cisco IOS Commands," for a complete list of Cisco IOS commands supported by access points and bridges.
accounting (SSID configuration mode)
Use the accounting SSID configuration mode command to enable RADIUS accounting for the radio interface (for the specified SSID). Use the no form of the command to disable accounting.
[no] accounting list-name
Syntax Description
list-name
|
Specifies the name of an accounting list.
|
Defaults
This command has no defaults.
Command Modes
SSID configuration interface
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Usage Guidelines
You create accounting lists using the aaa accounting command. These lists indirectly reference the server where the accounting information is stored.
Examples
This example shows how to enable RADIUS accounting and set the RADIUS server name:
AP(config-if-ssid)# accounting radius1
This example shows how to disable RADIUS accounting:
AP(config-if-ssid)# no accounting
Related Commands
Command
|
Description
|
ssid
|
Specifies the SSID and enters the SSID configuration mode
|
antenna
Use the antenna configuration interface command to configure the radio receive or transmit antenna settings. Use the no form of this command to reset the receive antenna to defaults.
[no] antenna {receive | transmit {diversity | left | right}}
Syntax Description
receive
|
Specifies the antenna that the access uses to receive radio signals
|
transmit
|
Specifies the antenna that the access uses to transmit radio signals
|
diversity
|
Specifies the antenna with the best signal
|
left
|
Specifies the left antenna
|
right
|
Specifies the right antenna
|
Defaults
The default antenna configuration is diversity.
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to specify the right receive antenna option:
AP(config-if)# antenna receive right
This example shows how to set the receive antenna option to defaults:
AP(config-if)# no antenna receive
Related Commands
Command
|
Description
|
power local
|
Configures the radio power level
|
show running-config
|
Displays the current access point operating configuration
|
authentication (local server configuration mode)
Use the authentication local server configuration command to specify the authentication types that are allowed on the local authenticator. By default, a local authenticator access point performs LEAP, EAP-FAST, and MAC-based authentication for up to 50 client devices. You use the no form of the authentication command to limit the local authenticator to one or more authentication types.
[no] authentication [eapfast] [leap] [mac]
Note
This command is not supported on bridges.
Syntax Description
eapfast
|
Specifies that the local authenticator performs EAP-FAST authentication for client devices.
|
leap
|
Specifies that the local authenticator performs LEAP authentication for client devices.
|
mac
|
Specifies that the local authenticator performs MAC-address authentication for client devices.
|
Defaults
By default, a local authenticator access point performs LEAP, EAP-FAST, and MAC-based authentication. To limit the local authenticator to one or two authentication types, use the no form of the command to disable unwanted authentication types.
Command Modes
Local server configuration mode
Command History
Release
|
Modification
|
12.3(2)JA
|
This command was introduced.
|
Examples
This example shows how to limit the local authenticator to perform only LEAP authentications for client devices:
AP(config-radsrv)# no authentication eapfast
AP(config-radsrv)# no authentication mac
Related Commands
authentication client
Use the authentication client configuration interface command to configure a LEAP username and password that the access point uses when authenticating to the network as a repeater.
authentication client username username password password
Syntax Description
username
|
Specifies the repeater's LEAP username
|
password
|
Specifies the repeater's LEAP password
|
Defaults
This command has no defaults.
Command Modes
SSID configuration interface
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to configure the LEAP username and password that the repeater uses to authenticate to the network:
AP(config-if-ssid)# authentication client username ap-north password buckeye
Related Commands
Command
|
Description
|
ssid
|
Specifies the SSID and enters the SSID configuration mode
|
show running-config
|
Displays the current access point operating configuration
|
authentication key-management
Use the authentication key-management SSID configuration mode command to configure the radio interface (for the specified SSID) to support authenticated key management. Cisco Centralized Key Management (CCKM) and Wi-Fi Protected Access (WPA) are the key management types supported on the access point.
authentication key-management { [wpa] [cckm] } [ optional ]
Note
This command is not supported on bridges.
Syntax Description
wpa
|
Specifies WPA authenticated key management for the SSID
|
cckm
|
Specifies CCKM authenticated key management for the SSID
|
optional
|
Specifies that client devices that do not support authenticated key management can use the SSID
|
Defaults
This command has no defaults.
Command Modes
SSID configuration interface
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was introduced.
|
12.2(13)JA
|
This command was modified to allow you to enable both WPA and CCKM for an SSID.
|
Usage Guidelines
Use this command to enable authenticated key management for client devices.
•
To enable authenticated key management, you must enable a cipher suite using the encryption mode ciphers command.
•
To support WPA on a wireless LAN where 802.1x-based authentication is not available, you must use the wpa-psk command to configure a pre-shared key for the SSID.
•
When you enable both WPA and CCKM for an SSID, you must enter wpa first and cckm second in the command. Any WPA client can attempt to authenticate, but only CCKM voice clients can attempt to authenticate. Only 802.11b and 802.11g radios support WPA and CCKM simultaneously.
•
To enable both WPA and CCKM, you must set the encryption mode to a cipher suite that includes TKIP.
Examples
This example shows how to enable both WPA and CCKM for an SSID:
AP(config-if-ssid)# authentication key-management wpa cckm
Related Commands
Command
|
Description
|
encryption mode ciphers
|
Specifies a cipher suite
|
ssid
|
Specifies the SSID and enters SSID configuration mode
|
wpa-psk
|
Specifies a pre-shared key for an SSID
|
authentication network-eap (SSID configuration mode)
Use the authentication network-eap SSID configuration mode command to configure the radio interface (for the specified SSID) to support network-EAP authentication with optional MAC address authentication. Use the no form of the command to disable network-eap authentication for the SSID.
[no] authentication
network-eap list-name
[mac-address list-name]
Note
The mac-address option is not supported on bridges.
Syntax Description
list-name
|
Specifies the list name for EAP authentication
|
mac-address list-name
|
Specifies the list name for MAC authentication
|
Defaults
This command has no defaults.
Command Modes
SSID configuration interface
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Usage Guidelines
Use this command to authenticate clients using the network EAP method, with optional MAC address screening. You define list names for MAC addresses and EAP using the aaa authentication login command. These lists define the authentication methods activated when a user logs in and indirectly identify the location where the authentication information is stored.
Examples
This example shows how to set the authentication to open for devices on a specified address list:
AP(config-if-ssid)# authentication network-eap list1
This example shows how to reset the authentication to default values:
AP(config-if-ssid)# no authentication network-eap
Related Commands
authentication open (SSID configuration mode)
Use the authentication open SSID configuration mode command to configure the radio interface (for the specified SSID) to support open authentication and optionally MAC address authentication or EAP authentication. Use the no form of the command to disable open authentication for the SSID.
[no] authentication open
[mac-address list-name [alternate] ]
[eap list-name]
Note
The mac-address and alternate options are not supported on bridges.
Syntax Description
mac-address list-name
|
Specifies the list name for MAC authentication
|
alternate
|
Specifies the use of either EAP authentication or MAC address authentication
|
eap list-name
|
Specifies the list name for EAP authentication
|
Defaults
This command has no defaults.
Command Modes
SSID configuration interface
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Usage Guidelines
Use this command to authenticate clients using the open method, with optional MAC address or EAP screenings. If you use the alternate keyword, the client must pass either the MAC address or EAP authentication. Otherwise, the client must pass both authentications. You define list names for MAC addresses and EAP using the aaa authentication login command. These lists define the authentication methods activated when a user logs in and indirectly identify the location where the authentication information is stored.
Examples
This example shows how to enable open authentication with MAC address restrictions:
AP(config-if-ssid)# authentication open mac-address mac-list1
This example shows how to disable open authentication for the SSID:
AP(config-if-ssid)# no authentication open
Related Commands
authentication shared (SSID configuration mode)
Use the authentication shared SSID configuration mode command to configure the radio interface (for the specified SSID) to support shared authentication with optional MAC address authentication and EAP authentication. Use the no form of the command to disable shared authentication for the SSID.
[no] authentication shared
[mac-address list-name]
[eap list-name]
Note
The mac-address option is not supported on bridges.
Syntax Description
mac-address list-name
|
Specifies the list name for MAC authentication
|
eap list-name
|
Specifies the list name for EAP authentication
|
Defaults
This command has no defaults.
Command Modes
SSID configuration interface
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Usage Guidelines
Use this command to authenticate clients using the shared method, with optional MAC address or EAP screenings. You define list names for MAC addresses and EAP using the aaa authentication login command. These lists define the authentication methods activated when a user logs in and indirectly identify the location where the authentication information is stored.
Examples
This example shows how to set the authentication to shared for devices on a MAC address list:
AP(config-if-ssid)# authentication shared mac-address mac-list1
This example shows how to reset the authentication to default values:
AP(config-if-ssid)# no authentication shared
Related Commands
beacon
Use the beacon configuration interface command to specify how often the beacon contains a Delivery Traffic Indicator Message (DTIM). Use the no form of this command to reset the beacon interval to defaults.
[no] beacon {period Kms | dtim-period count}
Syntax Description
period Kms
|
Specifies the beacon time in Kilomicroseconds (Kms). Kms is a unit of measurement in software terms. K = 1024, m = 10-6, and s = seconds, so Kms = 0.001024 seconds, 1.024 milliseconds, or 1024 microseconds.
|
dtim-period count
|
Specifies the number of DTIM beacon periods to wait before delivering multicast packets.
Note The dtim-period option is not supported on bridges.
|
Defaults
The default period is 100.
The default dtim-period is 2.
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Usage Guidelines
Clients normally wake up each time a beacon is sent to check for pending packets. Longer beacon periods let the client sleep longer and preserve power. Shorter beacon periods reduce the delay in receiving packets.
Controlling the DTIM period has a similar power-saving result. Increasing the DTIM period count lets clients sleep longer, but delays the delivery of multicast packets. Because multicast packets are buffered, large DTIM period counts can cause a buffer overflow.
Examples
This example shows how to specify a beacon period of 15 Kms (15.36 milliseconds):
AP(config-if)# beacon period 15
This example shows how to set the beacon parameter to defaults:
Related Commands
Command
|
Description
|
show running-config
|
Displays the current access point operating configuration
|
boot buffersize
To modify the buffer size used to load configuration files, use the boot buffersize global configuration command. Use the no form of the command to return to the default setting.
[ no ] boot buffersize bytes
Syntax Description
bytes
|
Specifies the size of the buffer to be used. Enter a value from 4 KB to 512 KB.
|
Defaults
The default buffer size for loading configuration files is 32 KB.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.3(2)JA
|
This command was introduced.
|
Usage Guidelines
Increase the boot buffer size if your configuration file size exceeds 512 KB.
Examples
This example shows how to set the buffer size to 512 KB:
AP(config)# boot buffersize 524288
boot ios-break
Use the boot ios-break global configuration command to enable an access point or bridge to be reset using a send break Telnet command.
After you enter the boot ios-break command, you can connect to the access point console port and press Ctrl-] to bring up the Telnet prompt. At the Telnet prompt, enter send break. The access point reboots and reloads the image.
[ no ] boot ios-break
Syntax Description
This command has no arguments or keywords.
Defaults
This command is disabled by default.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.3(2)JA
|
This command was introduced.
|
Examples
This example shows how to enable an access point or bridge to be reset using a send break Telnet command:
AP(config)# boot ios-break
boot upgrade
Use the boot upgrade global interface command to configure access points and bridges to automatically load a configuration and use DHCP options to upgrade system software.
When your access point renews its IP address with a DHCP request, it uses the details configured on the DHCP server to download a specified configuration file from a TFTP server. If a boot system command is part of the configuration file and the unit's current software version is different, the access point or bridge image is automatically upgraded to the version in the configuration. The access point or bridge reloads and executes the new image.
[ no ] boot upgrade
Syntax Description
This command has no arguments or keywords.
Defaults
This command is enabled by default.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(13)JA
|
This command was introduced.
|
Examples
This example shows how to prevent an access point or bridge from automatically loading a configuration and upgrading system software:
AP(config)# no boot upgrade
bridge aging-time
Use the bridge aging-time global configuration command to configure the length of time that a dynamic entry can remain in the bridge table from the time the entry is created or last updated.
bridge group aging-time seconds
Note
This command is supported only on bridges.
Syntax Description
group
|
Specifies the bridge group
|
seconds
|
Specifies the aging time in seconds
|
Defaults
The default aging time is 300 seconds.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was introduced.
|
Examples
This example shows how to configure the aging time for bridge group 1:
bridge(config)# bridge 1 aging-time 500
Related Commands
bridge forward-time
Use the bridge forward-time global configuration command to configure the forward delay interval on the bridge.
bridge group aging-time seconds
Note
This command is supported only on bridges.
Syntax Description
group
|
Specifies the bridge group
|
seconds
|
Specifies the forward time in seconds
|
Defaults
The default forward time is 30 seconds.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was introduced.
|
Examples
This example shows how to configure the forward time for bridge group 2:
bridge(config)# bridge 2 forward-time 60
Related Commands
Command
|
Description
|
bridge protocol ieee
|
Enables STP on the bridge
|
bridge aging-time
|
Specifies the length of time that a dynamic entry can remain in the bridge table from the time the entry is created or last updated
|
bridge hello-time
|
Specifies the interval between the hello BPDUs
|
bridge max-age
|
Specifies the interval that the bridge waits to hear BPDUs from the spanning tree root
|
bridge priority
|
Specifies the bridge STP priority
|
bridge hello-time
Use the bridge hello-time global configuration command to configure the interval between hello bridge protocol data units (BPDUs).
bridge group hello-time seconds
Note
This command is supported only on bridges.
Syntax Description
group
|
Specifies the bridge group
|
seconds
|
Specifies the hello interval in seconds
|
Defaults
The default hello time is 2 seconds.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was introduced.
|
Examples
This example shows how to configure the hello time for bridge group 1:
bridge(config)# bridge 1 hello-time 15
Related Commands
Command
|
Description
|
bridge protocol ieee
|
Enables STP on the bridge
|
bridge aging-time
|
Specifies the length of time that a dynamic entry can remain in the bridge table from the time the entry is created or last updated
|
bridge forward-time
|
Specifies a forward delay interval on the bridge
|
bridge max-age
|
Specifies the interval that the bridge waits to hear BPDUs from the spanning tree root
|
bridge priority
|
Specifies the bridge STP priority
|
bridge max-age
Use the bridge max-age global configuration command to configure the interval that the bridge waits to hear BPDUs from the spanning tree root. If the bridge does not hear BPDUs from the spanning tree root within this specified interval, it assumes that the network has changed and recomputes the spanning-tree topology.
bridge group max-age seconds
Note
This command is supported only on bridges.
Syntax Description
group
|
Specifies the bridge group
|
seconds
|
Specifies the max-age interval in seconds (enter a value between 10 and 200 seconds)
|
Defaults
The default max-age is 15 seconds.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was introduced.
|
Examples
This example shows how to configure the max age for bridge group 1:
bridge(config)# bridge 1 max-age 20
Related Commands
bridge priority
Use the bridge priority global configuration command to configure the spanning tree priority for the bridge. STP uses the bridge priority to select the spanning tree root. The lower the priority, the more likely it is that the bridge will become the spanning tree root.
The radio and Ethernet interfaces and the native VLAN on the bridge are assigned to bridge group 1 by default. When you enable STP and assign a priority on bridge group 1, STP is enabled on the radio and Ethernet interfaces and on the primary VLAN, and those interfaces adopt the priority assigned to bridge group 1. You can create bridge groups for sub-interfaces and assign different STP settings to those bridge groups.
bridge group priority priority
Note
This command is supported only on bridges.
Syntax Description
group
|
Specifies the bridge group to be configured
|
priority
|
Specifies the STP priority for the bridge
|
Defaults
The default bridge priority is 32768.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was introduced.
|
Examples
This example shows how to configure the priority for the bridge:
bridge(config-if)# bridge 1 priority 900
Related Commands
Command
|
Description
|
bridge protocol ieee
|
Enables STP on the bridge
|
bridge aging-time
|
Specifies the length of time that a dynamic entry can remain in the bridge table from the time the entry is created or last updated
|
bridge forward-time
|
Specifies a forward delay interval on the bridge
|
bridge hello-time
|
Specifies the interval between the hello BPDUs
|
bridge max-age
|
Specifies the interval that the bridge waits to hear BPDUs from the spanning tree root
|
bridge protocol ieee
Use the bridge number protocol ieee global configuration command to enable Spanning Tree Protocol (STP) on the bridge. STP is enabled for all interfaces assigned to the bridge group that you specify in the command.
The radio and Ethernet interfaces and the native VLAN on the bridge are assigned to bridge group 1 by default. When you enable STP and assign a priority on bridge group 1, STP is enabled on the radio and Ethernet interfaces and on the primary VLAN, and those interfaces adopt the priority assigned to bridge group 1. You can create bridge groups for sub-interfaces and assign different STP settings to those bridge groups.
bridge number protocol ieee [ suspend ]
Note
This command is supported only on bridges.
Syntax Description
number
|
Specifies the bridge group for which STP is enabled
|
suspend
|
Suspends STP on the bridge until you re-enable it.
|
Defaults
STP is disabled by default.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to enable STP for bridge group 1:
bridge(config)# bridge 1 protocol ieee
Related Commands
Command
|
Description
|
bridge aging-time
|
Specifies the length of time that a dynamic entry can remain in the bridge table from the time the entry is created or last updated
|
bridge forward-time
|
Specifies a forward delay interval on the bridge
|
bridge hello-time
|
Specifies the interval between the hello BPDUs
|
bridge max-age
|
Specifies the interval that the bridge waits to hear BPDUs from the spanning tree root
|
bridge-group block-unknown-source
Use the bridge-group block-unknown-source configuration interface command to block traffic from unknown MAC addresses on a specific interface. Use the no form of the command to disable unknown source blocking on a specific interface.
For STP to function properly, block-unknown-source must be disabled for interfaces participating in STP.
bridge-group group block-unknown-source
Syntax Description
group
|
Specifies the bridge group to be configured
|
Defaults
When you enable STP on an interface, block unknown source is disabled by default.
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was introduced.
|
Examples
This example shows how to disable block unknown source for bridge group 2:
bridge(config-if)# no bridge-group 2 block-unknown-source
Related Commands
bridge-group path-cost
Use the bridge-group path-cost configuration interface command to configure the path cost for the bridge Ethernet and radio interfaces. Spanning Tree Protocol (STP) uses the path cost to calculate the shortest distance from the bridge to the spanning tree root.
bridge-group group path-cost cost
Note
This command is supported only on bridges.
Syntax Description
group
|
Specifies the bridge group to be configured
|
cost
|
Specifies the path cost for the bridge group
|
Defaults
The default path cost for the Ethernet interface is 19, and the default path cost for the radio interface is 33.
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was introduced.
|
Examples
This example shows how to configure the path cost for bridge group 2:
bridge(config-if)# bridge-group 2 path-cost 25
Related Commands
bridge-group port-protected
Use the bridge-group port-protected configuration interface command to enable protected port for public secure mode configuration. In Cisco IOS software, there is no exchange of unicast, broadcast, or multicast traffic between protected ports.
bridge-group bridge-group
port-protected
Syntax Description
bridge-group
|
Specifies the bridge group for port protection
|
Defaults
This command has no defaults.
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to enable protected port for bridge group 71:
AP(config-if)# bridge-group 71 port-protected
Related Commands
bridge-group priority
Use the bridge-group priority configuration interface command to configure the spanning tree priority for the bridge Ethernet and radio interfaces. Spanning Tree Protocol (STP) uses the interface priority to select the root interface on the bridge.
The radio and Ethernet interfaces and the native VLAN on the bridge are assigned to bridge group 1 by default. When you enable STP and assign a priority on bridge group 1, STP is enabled on the radio and Ethernet interfaces and on the primary VLAN, and those interfaces adopt the priority assigned to bridge group 1. You can create bridge groups for sub-interfaces and assign different STP settings to those bridge groups.
bridge-group group priority priority
Syntax Description
group
|
Specifies the bridge group to be configured
|
priority
|
Specifies the STP priority for the bridge group
|
Defaults
The default priority for both the Ethernet and radio interfaces is 128.
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was introduced.
|
Examples
This example shows how to configure the priority for an interface on bridge group 2:
bridge(config-if)# bridge-group 2 priority 150
Related Commands
bridge-group spanning-disabled
Use the bridge-group spanning-disabled configuration interface command to disable Spanning Tree Protocol (STP) on a specific interface. Use the no form of the command to enable STP on a specific interface.
For STP to function properly, spanning-disabled must be disabled for interfaces participating in STP.
bridge-group group spanning-disabled
Syntax Description
group
|
Specifies the bridge group to be configured
|
Defaults
STP is disabled by default.
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was introduced.
|
Examples
This example shows how to disable STP for bridge group 2:
bridge(config-if)# bridge-group 2 spanning-disabled
Related Commands
bridge-group subscriber-loop-control
Use the bridge-group subscriber-loop-control configuration interface command to enable loop control on virtual circuits associated with a bridge group. Use the no form of the command to disable loop control on virtual circuits associated with a bridge group.
For Spanning Tree Protocol (STP) to function properly, subscriber-loop-control must be disabled for interfaces participating in STP.
bridge-group group subscriber-loop-control
Syntax Description
group
|
Specifies the bridge group to be configured
|
Defaults
When you enable STP for an interface, subscriber loop control is disabled by default.
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was introduced.
|
Examples
This example shows how to disable subscriber loop control for bridge group 2:
bridge(config-if)# no bridge-group 2 subscriber-loop-control
Related Commands
bridge-group unicast-flooding
Use the bridge-group unicast-flooding configuration interface command to enable unicast flooding for a specific interface. Use the no form of the command to disable unicast flooding for a specific interface.
bridge-group group unicast-flooding
Syntax Description
group
|
Specifies the bridge group to be configured
|
Defaults
Unicast flooding is disabled by default.
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was introduced.
|
Examples
This example shows how to configure unicast flooding for bridge group 2:
bridge(config-if)# bridge-group 2 unicast-flooding
Related Commands
broadcast-key
Use the broadcast-key configuration interface command to configure the time interval between rotations of the broadcast encryption key used for clients. Use the no form of the command to disable broadcast key rotation.
[no] broadcast-key
[vlan vlan-id]
[change secs]
[ membership-termination ]
[ capability-change ]
Note
Client devices using static WEP cannot use the access point when you enable broadcast key rotation. When you enable broadcast key rotation, only wireless client devices using 802.1x authentication (such as LEAP, EAP-TLS, or PEAP) can use the access point.
Note
This command is not supported on bridges.
Syntax Description
vlan vlan-id
|
(Optional) Specifies the virtual LAN identification value
|
change secs
|
(Optional) Specifies the amount of time (in seconds) between the rotation of the broadcast encryption key
|
membership-termination
|
(Optional) If WPA authenticated key management is enabled, this option specifies that the access point generates and distributes a new group key when any authenticated client device disassociates from the access point. If clients roam frequently among access points, enabling this feature might generate significant overhead.
|
capability-change
|
(Optional) If WPA authenticated key management is enabled, this option specifies that the access point generates and distributes a dynamic group key when the last non-key management (static WEP) client disassociates, and it distributes the statically configured WEP key when the first non-key management (static WEP) client authenticates. In WPA migration mode, this feature significantly improves the security of key-management capable clients when there are no static-WEP clients associated to the access point.
|
Defaults
This command has no defaults.
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to configure vlan10 to support broadcast key encryption with a 5-minute key rotation interval:
AP(config-if)# broadcast-key vlan 10 change 300
This example shows how to disable broadcast key rotation:
AP(config-if)# no broadcast-key
cca
Use the cca configuration interface command to configure the clear channel assessment (CCA) noise floor level for the bridge radio. The value you enter is used as an absolute value of dBm.
cca number
Note
This command is supported only on bridges.
Syntax Description
number
|
Specifies the radio noise floor in dBm. Enter a number from -60 to 0. Zero configures the radio to use a received validate frame as the CCA indication.
|
Defaults
The default CCA level is -62 dBm.
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was introduced.
|
Examples
This example shows how to configure the CCA level for the bridge radio:
bridge(config-if)# cca 50
channel
Use the channel configuration interface command to set the radio channel frequency. Use the no form of this command to reset the channel frequency to defaults.
[no] channel {number | frequency | least-congested}
Syntax Description
number
|
Specifies a channel number. For a list of channels for the 2.4-GHz radio, see Table 2-1. For a list of channels for the 5-GHz radio, see Table 2-2.
Note The valid numbers depend on the channels allowed in your regulatory region and are set during manufacturing.
|
frequency
|
Specifies the center frequency for the radio channel. For a list of center frequencies for the 2.4-GHz access point radio, see Table 2-1. For a list of center frequencies for the 5-GHz access point radio, see Table 2-2. For a list of center frequencies for the 5-GHz bridge radio, see Table 2-3.
Note The valid frequencies depend on the channels allowed in your regulatory region and are set during manufacturing.
|
least-congested
|
Enables or disables the scanning for a least busy radio channel to communicate with the client adapter
|
Table 2-1 Channels and Center Frequencies for 2.4-GHz Radios (both 802.11b and 802.11g)
Channel Identifier
|
Center Frequency (MHz)
|
Regulatory Domains
|
Americas (-A)
|
EMEA (-E)
|
Japan (-J)
|
Israel (-I)
|
China (-C)
|
1
|
2412
|
X
|
X
|
X
|
-
|
X
|
2
|
2417
|
X
|
X
|
X
|
-
|
X
|
3
|
2422
|
X
|
X
|
X
|
X
|
X
|
4
|
2427
|
X
|
X
|
X
|
X
|
X
|
5
|
2432
|
X
|
X
|
X
|
X
|
X
|
6
|
2437
|
X
|
X
|
X
|
X
|
X
|
7
|
2442
|
X
|
X
|
X
|
X
|
X
|
8
|
2447
|
X
|
X
|
X
|
X
|
X
|
9
|
2452
|
X
|
X
|
X
|
X
|
X
|
10
|
2457
|
X
|
X
|
X
|
-
|
X
|
11
|
2462
|
X
|
X
|
X
|
-
|
X
|
12
|
2467
|
-
|
X
|
X
|
-
|
-
|
13
|
2472
|
-
|
X
|
X
|
-
|
-
|
14
|
2484
|
-
|
-
|
X
|
-
|
-
|
Table 2-2 Channels and Center Frequencies for 5-GHz Access Point Radios
Channel Identifier
|
Frequency in MHz
|
Regulatory Domains
|
Americas (-A)
|
Japan (-J)
|
Singapore (-S)
|
Taiwan (-T)
|
34
|
5170
|
-
|
X
|
-
|
-
|
36
|
5180
|
X
|
-
|
X
|
-
|
38
|
5190
|
-
|
X
|
-
|
-
|
40
|
5200
|
X
|
-
|
X
|
-
|
42
|
5210
|
-
|
X
|
-
|
-
|
44
|
5220
|
X
|
-
|
X
|
-
|
46
|
5230
|
-
|
X
|
-
|
-
|
48
|
5240
|
X
|
-
|
X
|
-
|
52
|
5260
|
X
|
-
|
-
|
X
|
56
|
5280
|
X
|
-
|
-
|
X
|
60
|
5300
|
X
|
-
|
-
|
X
|
64
|
5320
|
X
|
-
|
-
|
X
|
149
|
5745
|
-
|
-
|
-
|
-
|
153
|
5765
|
-
|
-
|
-
|
-
|
157
|
5785
|
-
|
-
|
-
|
-
|
161
|
5805
|
-
|
-
|
-
|
-
|
Note
All channel sets for the 5-GHz access point radio are restricted to indoor usage except the Americas (-A), which allows for indoor and outdoor use on channels 52 through 64 in the United States.
Table 2-3 Channels and Center Frequencies for 5-GHz Bridge Radios
Channel Identifier
|
Frequency in MHz
|
Regulatory Domains
|
Americas (-A)
|
Japan (-J)
|
Singapore (-S)
|
Taiwan (-T)
|
149
|
5745
|
-
|
-
|
-
|
-
|
153
|
5765
|
-
|
-
|
-
|
-
|
157
|
5785
|
-
|
-
|
-
|
-
|
161
|
5805
|
-
|
-
|
-
|
-
|
Note
All bridge channel sets are restricted to outdoor usage.
Defaults
The default channel is least-congested.
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
12.2(8)JA
|
Parameters were added to support the 5-GHz access point radio.
|
12.2(11)JA
|
Parameters were added to support the 5-GHz bridge radio.
|
Examples
This example shows how to set the access point radio to channel 10 with a center frequency of 2457.
AP(config-if)# channel 2457
This example shows how to set the access point to scan for the least-congested radio channel.
AP(config-if)# channel least-congested
This example shows how to set the frequency to the default setting:
AP(config-if)# no channel
Related Commands
Command
|
Description
|
show controllers dot11radio
|
Displays the radio controller information and status
|
class-map
Use the class-map global configuration command to create a class map to be used for matching packets to the class whose name you specify and to enter class-map configuration mode. Use the no form of this command to delete an existing class map and return to global configuration mode.
[no] class-map name
Syntax Description
name
|
Specifies the name of the class map
|
Defaults
This command has no defaults, and there is not a default class map.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Usage Guidelines
Use this command to specify the name of the class for which you want to create or modify class-map match criteria and to enter class-map configuration mode. In this mode, you can enter one match command to configure the match criterion for this class.
The class-map command and its subcommands are used to define packet classification, marking, and aggregate policing as part of a globally named service policy applied on a per-interface basis.
After you are in quality of service (QoS) class-map configuration mode, these configuration commands are available:
•
description: describes the class map (up to 200 characters). The show class-map privileged EXEC command displays the description and the name of the class-map.
•
exit: exits from QoS class-map configuration mode.
•
match: configures classification criteria. For more information, see the match (class-map configuration) command.
•
no: removes a match statement from a class map.
•
rename: renames the current class map. If you rename a class map with a name already in use, the message A class-map with this name already exists is displayed.
Only one match criterion per class map is supported. For example, when defining a class map, only one match command can be issued.
Because only one match command per class map is supported, the match-all and match-any keywords function the same.
Only one access control list (ACL) can be configured in a class map. The ACL can have multiple access control entries (ACEs).
Examples
This example shows how to configure the class map called class1. class1 has one match criterion, which is an access list called 103.
AP(config)# access-list 103 permit any any dscp 10
AP(config)# class-map class1
AP(config-cmap)# match access-group 103
This example shows how to delete the class map class1:
AP(config)# no class-map class1
You can verify your settings by entering the show class-map privileged EXEC command.
Related Commands
Command
|
Description
|
match (class-map configuration)
|
Defines the match criteria ACLs, IP precedence, or IP Differentiated Services Code Point (DSCP) values to classify traffic
|
policy-map
|
Creates or modifies a policy map that can be attached to multiple interfaces to specify a service policy
|
show class-map
|
Displays QoS class maps
|
clear dot11 aaa authentication mac-authen filter-cache
Use the clear dot11 aaa authentication mac-authen filter-cache privileged EXEC command to clear entries from the MAC authentication cache.
clear dot11 aaa authentication mac-authen filter-cache [address]
Syntax Description
address
|
Specifies a specific MAC address to clear from the cache.
|
Defaults
This command has no defaults.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(15)JA
|
This command was introduced.
|
Examples
This example shows how to clear a specific MAC address from the MAC authentication cache:
ap# clear dot11 aaa authentication mac-authen filter-cache 7643.798a.87b2
Related Commands
clear dot11 cckm-statistics
Use the clear dot11 cckm-statistics privileged EXEC command to reset CCKM statistics.
clear dot11 cckm-statistics
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default setting.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(15)JA
|
This command was introduced.
|
Examples
This example shows how to clear CCKM statistics:
AP# clear dot11 cckm-statistics
Related Commands
clear dot11 client
Use the clear dot11 client privileged EXEC command to deauthenticate a radio client with a specified MAC address. The client must be directly associated with the access point, not a repeater.
clear dot11 client {mac-address}
Syntax Description
mac-address
|
Specifies a radio client MAC address (in xxxx.xxxx.xxxx format)
|
Defaults
This command has no defaults.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to deauthenticate a specific radio client:
AP# clear dot11 client 0040.9645.2196
You can verify that the client was deauthenticated by entering the following privileged EXEC command:
AP# show dot11 associations 0040.9645.2196
Related Commands
Command
|
Description
|
show dot11 associations
|
Displays the radio association table or optionally displays association statistics or association information about repeaters or clients
|
clear dot11 hold-list
Use the clear dot11 hold-list privileged EXEC command to reset the MAC, LEAP, and EAP authentications hold list.
clear dot11 hold-list
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default setting.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to clear the hold-off list of MAC authentications:
AP# clear dot11 hold-list
clear dot11 statistics
Use the clear dot11 statistics privileged EXEC command to reset statistic information for a specific radio interface or for a particular client with a specified MAC address.
clear dot11 statistics
{interface | mac-address}
Syntax Description
interface
|
Specifies a radio interface number
|
mac-address
|
Specifies a client MAC address (in xxxx.xxxx.xxxx format)
|
Defaults
This command has no default setting.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to clear radio statistics for radio interface 0:
AP# clear dot11 statistics dot11radio 0
This example shows how to clear radio statistics for the client radio with a MAC address of 0040.9631.81cf:
AP# clear dot11 statistics 0040.9631.81cf
You can verify that the radio interface statistics are reset by entering the following privileged EXEC command:
AP# show dot11 associations statistics
Related Commands
clear iapp rogue-ap-list
Use the clear iapp rogue-ap-list privileged EXEC command to clear the list of IAPP rogue access points.
clear iapp rogue-ap-list
Note
This command is not supported on bridges.
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default setting.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to clear the IAPP rogue access point list:
AP# clear iapp rogue-ap-list
You can verify that the rogue AP list was deleted by entering the show iapp rogue-ap-list privileged EXEC command.
Related Commands
clear iapp statistics
Use the clear iapp statistics privileged EXEC command to clear all the IAPP statistics.
clear iapp statistics
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no default setting.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to clear the IAPP statistics:
AP# clear iapp statistics
You can verify that the IAPP statistics were cleared by entering the following privileged EXEC command:
Related Commands
clear wlccp wds
Use the clear wlccp wds privileged EXEC command to clear WDS statistics and to remove devices from the WDS database.
clear wlccp wds {[ap [mac-address]] | [mn [mac-address]] | statistics |
aaa authentication mac-authen filter-cache [mac-address]}
Syntax Description
ap [mac-address]
|
Removes access points from the WDS database. If you specify a MAC address (in the hhhh.hhhh.hhhh format), the command removes the specified device from the WDS database. If you do not specify a MAC address, the command removes all access points from the WDS database.
|
mn [mac-address]
|
Removes client devices (mobile nodes) from the WDS database. If you specify a MAC address (in the hhhh.hhhh.hhhh format), the command removes that device from the WDS database. If you do not specify a MAC address, the command removes all clients from the WDS database.
|
statistics
|
Resets all WDS statistics.
|
aaa authentication mac-authen filter-cache [mac-address]
|
Removes MAC addresses from the access point's MAC authentication filter cache. If you specify a MAC address (in the hhhh.hhhh.hhhh format), the command removes that device from the filter cache. If you do not specify a MAC address, the command removes all addresses from the cache.
|
Defaults
This command has no default setting.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(15)JA
|
This command was introduced.
|
Examples
This example shows how to remove an access point from the WDS database:
AP# clear wlccp wds ap 1572.342d.97f4
Related Commands
concatenation
Use the concatenation configuration interface command to enable packet concatenation on the bridge radio. Using concatenation, the bridge combines multiple packets into one packet to reduce packet overhead and overall latency, and to increase transmission efficiency.
concatenation [ bytes ]
Note
This command is supported only on bridges.
Syntax Description
bytes
|
(Optional) Specifies a maximum size for concatenated packets in bytes. Enter a value from 1600 to 4000.
|
Defaults
Concatenation is enabled by default, and the default maximum concatenated packet size is 3500.
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was introduced.
|
Examples
This example shows how to configure concatenation on the bridge radio:
bridge(config-if)# concatenation 4000
countermeasure tkip hold-time
Use the countermeasure tkip hold-time configuration interface command to configure a TKIP MIC failure holdtime. If the access point detects two MIC failures within 60 seconds, it blocks all the TKIP clients on that interface for the holdtime period.
countermeasure tkip hold-time seconds
Syntax Description
seconds
|
Specifies the length of the TKIP holdtime in seconds (if the holdtime is 0, TKIP MIC failure hold is disabled)
|
Defaults
TKIP holdtime is enabled by default, and the default holdtime is 60 seconds.
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was introduced.
|
Examples
This example shows how to configure the TKIP holdtime on the access point radio:
ap(config-if)# countermeasure tkip hold-time 120
debug dot11
Use the debug dot11 privileged EXEC command to begin debugging of radio functions. Use the no form of this command to stop the debug operation.
[no] debug dot11
{events | packets | forwarding | mgmt | network-map | syslog | virtual-interface}
Syntax Description
events
|
Activates debugging of all radio related events
|
packets
|
Activates debugging of radio packets received and transmitted
|
forwarding
|
Activates debugging of radio forwarded packets
|
mgmt
|
Activates debugging of radio access point management activity
|
network-map
|
Activates debugging of radio association management network map
|
syslog
|
Activates debugging of radio system log
|
virtual-interface
|
Activates debugging of radio virtual interfaces
|
Defaults
Debugging is not enabled.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to begin debugging of all radio-related events:
This example shows how to begin debugging of radio packets:
This example shows how to begin debugging of the radio system log:
This example shows how to stop debugging of all radio related events:
AP# no debug dot11 events
Related Commands
Command
|
Description
|
show debugging
|
Displays all debug settings and the debug packet headers
|
show interfaces dot11radio
|
Displays configuration and status information for the radio interface
|
debug dot11 aaa
Use the debug dot11 aaa privileged EXEC command to activate debugging of dot11 authentication, authorization, and accounting (AAA) operations. Use the no form of this command to stop the debug operation.
[no] debug dot11 aaa
{accounting | authenticator | dispatcher | manager }
Syntax Description
accounting
|
Activates debugging of 802.11 AAA accounting packets
|
authenticator { all | dispatcher | mac-authen | process | rxdata | state-machine | txdata }
|
Activates debugging of MAC and EAP authentication packets. Use these options to activate authenticator debugging:
• all—activates debugging for all authenticator packets
• dispatcher—activates debugging for authentication request handler packets
• mac-authen—activates debugging for MAC authentication packets
• process—activates debugging for authenticator process packets
• rxdata—activates debugging for EAPOL packets from client devices
• state-machine—activates debugging for authenticator state-machine packets
• txdata—activates debugging for EAPOL packets sent to client devices
|
dispatcher
|
Activates debugging of 802.11 AAA dispatcher (interface between Association & Manager) packets
|
manager { all | dispatcher | keys | rxdata | state-machine | supplicant | txdata }
|
Activates debugging information for the AAA manager. Use these options to activate AAA manager debugging:
• all—activates all AAA manager debugging
• dispatcher—activates debug information for AAA manager-authenticator dispatch traffic
• keys—activates debug information for AAA manager key processing
• rxdata—activates debugging for AAA manager packets received from client devices
• state-machine—activates debugging for AAA manager state-machine packets
• supplicant—activates debugging for LEAP supplicant packets
• txdata—activates debugging for AAA manager packets sent to client devices
|
Defaults
Debugging is not enabled.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
12.2(15)JA
|
This command was modified to include the accounting, authenticator, dispatcher, and manager debugging options.
|
Examples
This example shows how to begin debugging of dot11 AAA accounting packets:
AP# debug dot11 aaa accounting
Related Commands
debug dot11 dot11radio
Use the debug dot11 dot11radio privileged EXEC command to turn on radio debug options. These options include run RF monitor mode and trace frames received or transmitted on the radio interface. Use the no form of this command to stop the debug operation.
[no] debug dot11 dot11radio interface-number {accept-radio-firmware |
monitor {ack | address | beacon | crc | lines | plcp | print | probe | store} |
print { hex | if | iv | lines | mic | plcp | printf | raw | shortadr } |
radio_debug flag-value | stop-on-failure |
trace {off | print | store}}
Syntax Description
interface-number
|
Specifies a radio interface number (the 2.4-GHz radio is radio 0, and the 5-GHz radio is radio 1).
|
accept-radio-firmware
|
Configures the access point to disable checking the radio firmware version
|
monitor
|
Enables RF monitor mode. Use these options to turn on monitor modes:
• ack—Displays ACK packets. ACK packets acknowledge receipt of a signal, information, or packet.
• address—Displays packets to or from the specified IP address
• beacon—Displays beacon packets
• crc—Displays packets with CRC errors
• lines—Specifies a print line count
• plcp—Displays plcp packets
• print—Enables RF monitor printing mode
• probe—Displays probe packets
• store—Enables RF monitor storage mode
|
print
|
Enables packet printing. Use these options to turn on packet printing:
• hex—Prints entire packets without formatting
• if—Prints the in and out interfaces for packets
• iv—Prints the packet WEP IV
• lines—Prints the line count for the trace
• mic—Prints the Cisco MIC
• plcp—Displays the PLCP
• printf—Prints using printf instead of buginf
• raw—Prints without formatting data
• shortadr—Prints MAC addresses in short form
|
stop-on-failure
|
Configures the access point to not restart when the radio driver fails
|
trace
|
Enables trace mode. Use these options to turn on trace modes:
• off—Turns off traces
• print—Enables trace printing
• store—Enables trace storage
|
Defaults
Debugging is not enabled.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to enable packet printing with MAC addresses in short form:
AP# debug dot11 dot11radio 0 print shortadr
This example shows how to begin monitoring of all packets with CRC errors:
AP# debug dot11 dot11radio 0 monitor crc
This example shows how to stop monitoring of packets with CRC errors:
AP# no debug dot11 dot11radio 0 monitor crc
Related Commands
debug iapp
Use the debug iapp privileged EXEC command to begin debugging of IAPP operations. Use the no form of this command to stop the debug operation.
[no] debug iapp
{packets | event | error}
Syntax Description
packets
|
Displays IAPP packets sent and received by the access point. Link test packets are not displayed
|
event
|
Displays significant IAPP events
|
error
|
Displays IAPP software and protocol errors
|
Defaults
This command has no default setting.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to begin debugging of IAPP packets:
This example shows how to begin debugging of IAPP events:
This example shows how to begin debugging of IAPP errors:
Related Commands
Command
|
Description
|
show debugging
|
Displays all debug settings
|
debug radius local-server
Use the debug radius local-server privileged EXEC mode command to control the display of debug messages for the local authenticator.
debug radius local-server {client | eapfast | error | packets }
Syntax Description
Command
|
Description
|
client
|
Activates display of error messages related to failed client authentications to the local authenticator
|
eapfast {encryption | events | pac | pkts}
|
Activates display of messages related to EAP-FAST on the local authenticator.
• encryption—displays enecryption and decryption of packets sent and received
• events—displays EAP-FAST events on the local authenticator
• pac—displays PAC generations and verifications
• pkts—displays packets received and transmitted from EAP-FAST clients
|
error
|
Activates display of error messages related to the local authenticator
|
packets
|
Activates display of the content of RADIUS packets sent from and received by the local authenticator
|
Defaults
Debugging is not enabled.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was first introduced.
|
Examples
This example shows how to begin debugging for local authenticator errors:
AP# debug radius local-server error
Related Commands
Command
|
Description
|
radius-server local
|
Enables the access point as a local authenticator
|
show debugging
|
Displays all debug settings and the debug packet headers
|
debug wlccp ap
Use the debug wlccp ap privileged EXEC command to enable debugging for devices that interact with the access point that provides wireless domain services (WDS).
debug wlccp ap {mn | wds-discovery | state | rm [statistics | context | packet]}
Note
This command is not supported on bridges.
Syntax Description
Command
|
Description
|
mn
|
(Optional) Activates display of debug messages related to client devices
|
wds-discovery
|
(Optional) Activates display of debug messages related to the WDS discovery process
|
state
|
(Optional) Activates display of debug messages related to access point authentication to the WDS access point
|
rm [statistics | context | packet]
|
(Optional) Activates display of debug messages related to radio management
• statistics—shows statistics related to radio management
• context—shows the radio management contexts
• packet—shows output related to packet flow
|
Defaults
Debugging is not enabled.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was first introduced.
|
Examples
This example shows how to begin debugging for LEAP-enabled client devices participating in Cisco Centralized Key Management (CCKM):
Related Commands
Command
|
Description
|
show debugging
|
Displays all debug settings and the debug packet headers
|
show wlccp
|
Displays WLCCP information
|
debug wlccp packet
Use the debug wlccp packet privileged EXEC command to activate display of packets to and from the access point that provides wireless domain services (WDS).
debug wlccp packet
Note
This command is not supported on bridges.
Syntax Description
This command has no arguments or keywords.
Defaults
Debugging is not enabled.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was first introduced.
|
Examples
This example shows how to activate display of packets to and from the WDS access point:
Related Commands
Command
|
Description
|
show debugging
|
Displays all debug settings and the debug packet headers
|
show wlccp
|
Displays WLCCP information
|
debug wlccp rmlib
Use the debug wlccp rmlib privileged EXEC command to activate display of radio management library functions on the access point that provides wireless domain services (WDS).
debug wlccp rmlib
Note
This command is not supported on bridges.
Syntax Description
This command has no arguments or keywords.
Defaults
Debugging is not enabled.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(13)JA
|
This command was first introduced.
|
Examples
This example shows how to activate display of radio management library functions on the access point that provides WDS:
Related Commands
Command
|
Description
|
show debugging
|
Displays all debug settings and the debug packet headers
|
show wlccp
|
Displays WLCCP information
|
debug wlccp wds
Use the debug wlccp wds privileged EXEC command to activate display of wireless domain services (WDS) debug messages.
debug wlccp wds
aggregator [packet]
authenticator {all | dispatcher | mac-authen | process | rxdata | state-machine | txdata}
nm [packet | loopback]
state
statistics
Note
This command is not supported on bridges.
Syntax Description
Command
|
Description
|
aggregator [packet]
|
(Optional) Activates display of debug messages related to radio management. Use the packet option to display packets from and to the radio management aggregator.
|
authenticator {all | dispatcher | mac-authen | process | rxdata | state-machine | txdata}
|
(Optional) Use this command and its options to turn on display of WDS debug messages related to authentication.
• all—Enables all authenticator debugging
• dispatcher—Enables debugging related to handling authentication requests
• mac-authen—Enables debugging related to MAC address authentication
• process—Enables debugging related to authenticator processes
• rxdata—Enables display of EAPOL packets from clients
• state-machine—Enables authenticator state-machine debugging
• txdata—Enables display of EAPOL packets to clients
|
nm [packet | loopback]
|
(Optional) Activates display of debug messages from the wireless network manager (WNM). The packet option displays Cisco IOS packets from and to the network manager, and the loopback option re-routes packets sent to the WNM to the WDS access point console instead.
|
state
|
(Optional) Activates display of state transitions for access points interacting with the WDS access point.
|
statistics
|
(Optional) Activates display of WDS statistics.
|
Defaults
Debugging is not enabled.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was first introduced.
|
12.2(13)JA
|
This command was modified to include the aggregator and nm options.
|
Examples
This example shows how to begin debugging for LEAP-enabled client devices participating in Cisco Centralized Key Management (CCKM):
Related Commands
Command
|
Description
|
show debugging
|
Displays all debug settings and the debug packet headers
|
show wlccp
|
Displays WLCCP information
|
distance
Use the distance configuration interface command to specify the distance from a root bridge to the non-root bridge or bridges with which it communicates. The distance setting adjusts the bridge's timeout values to account for the time required for radio signals to travel from bridge to bridge. If more than one non-root bridge communicates with the root bridge, enter the distance from the root bridge to the non-root bridge that is farthest away. You do not need to adjust this setting on non-root bridges.
distance kilometers
Note
This command is supported only on bridges.
Syntax Description
kilometers
|
Specifies the bridge distance setting (enter a value from 0 to 99 km)
|
Defaults
In installation mode, the default distance setting is 99 km. In all other modes, such as root and non-root, the default distance setting is 0 km.
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was introduced.
|
Examples
This example shows how to configure the distance setting for the root bridge radio:
bridge(config-if)# distance 40
dot11 association mac-list
To specify a MAC address access list used for dot11 association use the dot11 association mac-list command.
dot11 association mac-list number
Syntax Description
number
|
Specifies a number (700 to 799) for a 48-bit MAC address access list.
|
Defaults
No MAC address access list is assigned.
Examples
This example shows the creation of a MAC address access list used to filter one client with a MAC
address of 0000.1234.5678.
AP(config)# access-list 700 deny 0000.1234.5678 0000.0000.0000
AP(config)# dot11 association mac-list 700
Related Commands
Command
|
Description
|
show access-list
|
Displays the configured access-lists.
|
dot11 aaa authentication attributes service-type login-only
Use the dot11 aaa authentication attributes service-type login-only global configuration command to set the service-type attribute in reauthentication requests to login-only. By default, the access point sends reauthentication requests to the server with the service-type attribute set to authenticate-only. However, some Microsoft IAS servers do not support the authenticate-only service-type attribute. Changing the service-type attribute to login-only ensures that Microsoft IAS servers recognize reauthentication requests from the access point.
dot11 aaa authentication attributes service-type login-only
Syntax Description
This command has no arguments or keywords.
Defaults
The default service-type attribute in reauthentication requests is set to authenticate-only. This command sets the service-type attribute in reauthentication requests to login-only.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(15)JA
|
This command was introduced.
|
Related Commands
Command
|
Description
|
dot11 aaa csid
|
Selects the format for MAC addresses in Called-Station-ID (CSID) and Calling-Station-ID attributes
|
dot11 aaa authentication mac-authen filter-cache
Use the dot11 aaa authentication mac-authen filter-cache global configuration command to enable MAC authentication caching on the access point. MAC authentication caching reduces overhead because the access point authenticates devices in its MAC-address cache without sending the request to your authentication server. When a client device completes MAC authentication to your authentication server, the access point adds the client's MAC address to the cache.
dot11 aaa authentication mac-authen filter-cache [timeout seconds]
Syntax Description
timeout seconds
|
Specifies a timeout value for MAC authentications in the cache.
|
Defaults
MAC authentication caching is disabled by default. When you enable it, the default timeout value is 1800 (30 minutes).
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(15)JA
|
This command was introduced.
|
Examples
This example shows how to configure MAC authentication caching with a one-hour timeout:
ap(config)# dot11 aaa authentication mac-authen filter-cache timeout 3600
Related Commands
dot11 aaa csid
Use the dot11 aaa csid global configuration command to select the format for MAC addresses in Called-Station-ID (CSID) and Calling-Station-ID attributes in RADIUS packets.
dot11 aaa csid { default | ietf | unformatted }
Syntax Description
default
|
Specifies the default format for MAC addresses in CSID attributes. The default format looks like this example:
|
ietf
|
Specifies the Internet Engineering Task Force (IETF) format for MAC addresses in CSID attributes. The IETF format looks like this example:
|
unformatted
|
Specifies no formatting for MAC addresses in CSID attributes. An unformatted MAC address looks like this example:
|
Defaults
The default CSID format looks like this example:
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(13)JA
|
This command was introduced.
|
Usage Guidelines
You can also use the wlccp wds aaa csid command to select the CSID format.
Related Commands
Command
|
Description
|
debug dot11 aaa
|
Begin debugging of dot11 authentication, authorization, and accounting (AAA) operations
|
dot11 activity-timeout
Use the dot11 activity-timeout global configuration command to configure the number of seconds that the access point tracks an inactive device (the number depends on its device class). The access point applies the unknown device class to all non-Cisco Aironet devices.
dot11 activity-timeout { [ client-station | repeater | bridge | workgroup-bridge | unknown ]
[ default <1 - 100000> ] [ maximum <1 - 100000> ] }
Syntax Description
client-station, repeater, bridge, workgroup- bridge
|
Specify Cisco Aironet device classes
|
unknown
|
Specifies unknown (non-Cisco Aironet) device class
|
default <1 - 100000>
|
Specifies the activity timeout value that the access point uses when a device associates and proposes a zero-refresh rate or does not propose a refresh rate
|
maximum <1 - 100000>
|
Specifies the maximum activity timeout allowed for a device regardless of the refresh rate proposed by a device when it associates
|
Defaults
Table 2-4 lists the default activity timeouts for each device class. All values are in seconds.
Table 2-4 Default Activity Timeouts
Device Class
|
Default Timeout
|
unknown
|
60
|
client-station
|
1800
|
repeater
|
28800
|
bridge
|
28800
|
workgroup-bridge
|
28800
|
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(13)JA
|
This command was introduced.
|
Examples
This example shows how to configure default and maximum activity timeouts for all device classes:
AP(config)# dot11 activity-timeout default 5000 maximum 24000
Usage Guidelines
To set an activity timeout for all device types, set a default or maximum timeout without specifying a device class (for example, enter dot11 activity-timeout default 5000). The access point applies the timeout to all device types that are not already configured with a timeout.
Related Commands
dot11 adjacent-ap age-timeout
Use the dot11 adjacent-ap age-timeout global configuration command to specify the number of hours an inactive entry remains in the list of adjacent access points.
dot11 adjacent-ap age-timeout hours
Note
This command is not supported on bridges.
Syntax Description
hours
|
Specifies the number of hours an inactive entry remains in the list of adjacent access points
|
Defaults
The default age-timeout is 24 hours.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was introduced.
|
Examples
This example shows how to configure the timeout setting for inactive entries in the adjacent access point list:
AP# dot11 adjacent-ap age-timeout 12
Related Commands
dot11 antenna-alignment
Use the dot11 antenna-alignment privileged EXEC command to activate the antenna-alignment tool for an radio interface. Use this tool to test and align the access point antenna with another remote antenna.
dot11 interface-number antenna-alignment [timeout]
Syntax Description
interface-number
|
Specifies the radio interface number (The 2.4-GHz radio is radio 0, and the 5-GHz radio is radio 1.)
|
timeout
|
Specifies the duration of the alignment test, in seconds
|
Defaults
The default alignment timeout is 5 seconds.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Usage Guidelines
During the antenna alignment test, the radio disassociates from its parent, probes adjacent access points, and records the MAC address and signal strength of responses it receives. After the timeout, the radio reassociates with its parent. Clients connected to the access point through its parent lose their connection for the duration of the test; clients connected to a repeater maintain their connection and can abort the test using the escape sequence (Ctrl key and ^ key).
You display the last 10 results using the show dot11 antenna-alignment command, which lists the MAC address and signal level for the access points that responded to the probe.
Examples
This example shows how to start the antenna-alignment test for radio interface 0:
AP# dot11 dot11radio 0 antenna-alignment
Related Commands
dot11 arp-cache
Use the dot11 arp-cache global configuration command to enable client ARP caching on the access point. ARP caching on the access point reduces the traffic on your wireless LAN and increases client battery life by stopping ARP requests for client devices at the access point. Instead of forwarding ARP requests to client devices, the access point responds to requests on behalf of associated client devices and drops ARP requests that are not directed to clients associated to the access point. When ARP caching is optional, the access point responds on behalf of clients with IP addresses known to the access point but forwards through its radio port any ARP requests addressed to unknown clients. When the access point knows all the IP addresses for associated clients, it drops any ARP requests not directed to its clients. In its beacon, the access point includes an information element to alert client devices that they can safely ignore broadcast messages to increase battery life.
[no] dot11 arp-cache [optional]
Syntax Description
optional
|
Configures the access point to respond to ARP requests addressed to clients for which the access point knows the IP address but forward through its radio port ARP requests addressed to client devices that the access point does not recognize. When the access point learns all the IP addresses for associated clients, it drops any ARP requests not directed to its clients.
|
Defaults
ARP caching is disabled by default.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(13)JA
|
This command was introduced.
|
Examples
This example shows how to enable ARP caching:
AP(config)# dot11 arp-cache
dot11 carrier busy
Use the dot11 carrier busy privileged exec command to display levels of radio activity on each channel.
dot11 interface-number carrier busy
Syntax Description
interface-number
|
Specifies the radio interface number (The 2.4-GHz radio is radio 0, and the 5-GHz radio is radio 1.)
|
Defaults
This command has no defaults.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was introduced.
|
Usage Guidelines
During the carrier busy test, the access point or bridge drops all associations with wireless networking devices for about 4 seconds while it conducts the carrier test and then displays the test results.
You can re-display the carrier busy results using the show dot11 carrier busy command.
Examples
This example shows how to run the carrier busy test for radio interface 0:
AP# dot11 d0 carrier busy
This example shows the carrier busy test results:
Related Commands
dot11 extension aironet
Use the dot11 extension aironet configuration interface command to enable or disable Cisco Aironet extensions to the IEEE 802.11b standard. Use the no form of this command to disable the Cisco Aironet extensions.
[no] dot11 extension aironet
Note
You cannot disable Cisco Aironet extensions on bridges.
Syntax Description
This command has no arguments or keywords.
Defaults
Cisco Aironet extensions are enabled by default.
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Usage Guidelines
The Cisco Aironet extensions help clients choose the best access point. You must enable these extensions to use advanced features such as Cisco MIC and key hashing. Disable these extensions for non-Cisco clients that misinterpret the extensions.
Examples
This example shows how to enable Cisco Aironet extensions for the radio interface:
AP(config-if)# dot11 extension aironet
This example shows how to disable Cisco Aironet extensions for the radio interface:
AP(config-if)# no dot11 extension aironet
Related Commands
Command
|
Description
|
show running-config
|
Displays the current access point operating configuration
|
dot11 holdoff-time
Use the dot11 holdoff-time global configuration command to specify the hold-off time for EAP and MAC address authentication. The holdoff time is invoked when a client fails three login attempts or fails to respond to three authentication requests from the access point. Use the no form of the command to reset the parameter to defaults.
[no] dot11 holdoff-time seconds
Syntax Description
seconds
|
Specifies the hold-off time (1 to 65555 seconds)
|
Defaults
The default holdoff time is 0 (disabled).
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to specify a 2-minute hold-off time:
AP(config)# dot11 holdoff-time 120
This example shows how reset the hold-off time to defaults:
AP(config)# dot11 no holdoff-time
Related Commands
Command
|
Description
|
show running-config
|
Displays information on the current running access point configuration
|
dot1x reauth-period
|
Configures the timeout period that the access point waits for clients to respond to EAP requests
|
dot11 igmp snooping-helper
Use the dot11 igmp snooping-helper global configuration command to begin sending IGMP Query requests when a new client associates with the access point. Use the no form of this command to disable the IGMP Query requests.
[no] dot11 igmp snooping-helper
Syntax Description
This command has no arguments or keywords.
Defaults
IGMP Query requests are disabled.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to enable IGMP Query requests:
AP(config)# dot11 igmp snooping-helper
This example shows how to stop or disable the IGMP Query requests:
AP(config)# no dot11 igmp snooping-helper
dot11 linktest
Use the dot11 linktest privileged EXEC command to test a radio link between the access point and a client device.
dot11 interface-number linktest
[target mac-address]
[count packet-number]
[interval sec]
[packet-size size]
[rate value]
Syntax Description
interface-number
|
Specifies the radio interface number (The 2.4-GHz radio is radio 0, and the 5-GHz radio is radio 1.)
|
target mac-address
|
(Optional) Specifies the MAC address (in xxxx.xxxx.xxxx format) of the client device
|
count packet-number
|
(Optional) Specifies the number of packets (1 to 9999) to send to the client device
|
interval sec
|
(Optional) Specifies the time interval between tests (from 1 to 10000 seconds)
|
packet-size size
|
(Optional) Specifies the size of each packet (from 1 to 1400 bytes)
|
rate value
|
(Optional) Specifies a specific link test data rate.
• Rates for the 802.11b, 2.4-GHz radio are 1, 2, 5, or 11 Mbps.
• Rates for the 802.11g, 2.4-GHz radio are 1, 2, 5, 6, 9, 11, 12, 18, 24, 36, 48, or 54 Mbps.
• Rates for the 5-GHz radio are 6, 9, 12, 18, 24, 36, 48, or 54 Mbps.
|
Defaults
The default target for a root access point is the first client. The default target for a repeater is its parent access point.
The default count specifies that test runs once.
The default interval is 5 seconds.
The default packet-size is 512 bytes.
The default rate is the automatic rate-shifting algorithm.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
12.2(8)JA
|
Parameters were added to support the 5-GHz access point radio.
|
12.2(11)JA
|
Parameters were added to support the 5.8-GHz bridge radio.
|
12.2(13)JA
|
Parameters were added to support the 802.11g, 2.4-GHz access point radio.
|
Usage Guidelines
The link test verifies the radio link between the access point and a client device by sending the client a series of special packets, which the client returns to the access point.
Note
Some client devices, such as non-Cisco wireless clients, wired clients that are connected to a workgroup bridge, or non-Cisco clients connected to a repeater access point, might not respond to link test packets.
The client adds information to the packets that quantify how well it received the request. Results are displayed as a table of packet statistics, quality, and signal-level information.
If you specify an interval, the test repeats continuously separated by the specified number of seconds. To abort the test, type the escape sequence (Ctrl key and ^ key). Without an interval, the test runs once.
Examples
This example shows how to initiate a radio link test to send 10 packets to client MAC address 0040963181CF on radio interface 0:
AP# dot11 dot11radio 0 linktest target 0040.9631.81CF count 10
This example shows how to initiate a radio link test to send 100 packets of 500 bytes to client MAC address 0040963181CF on radio interface 0:
AP# dot11 dot11radio 0 linktest target 0040.9631.81CF packet-size 500 count 100
Related Commands
dot11 location isocc
Use the dot11 location isocc privileged EXEC command to configure location identifiers that the access point sends with all RADIUS authentication and accounting requests.
dot11 location isocc ISO-country-code cc country-code ac area-code
Syntax Description
isocc ISO-country-code
|
Specifies the ISO country code that the access point includes in RADIUS authentication and accounting requests
|
cc country-code
|
Specifies the International Telecommunication Union (ITU) country code that the access point includes in RADIUS authentication and accounting requests
|
ac area-code
|
Specifies the ITU area code that the access point includes in RADIUS authentication and accounting requests
|
Defaults
This command has no defaults.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(13)JA
|
This command was introduced.
|
Usage Guidelines
You can find a list of ISO and ITU country and area codes at the ISO and ITU websites. Cisco IOS software does not check the validity of the country and area codes that you enter with this command.
Examples
This example shows how to configure the ISO and ITU location codes on the access point:
ap# dot11 location isocc us cc 1 ac 408
This example shows how the access point adds the SSID used by the client device and how it formats the location-ID string:
isocc=us,cc=1,ac=408,network=ACMEWISP_NewarkAirport
Related Commands
Command
|
Description
|
snmp-server location
|
Specifies the SNMP system location and the WISPr location-name attribute
|
dot11 meter
Use the dot11 meter privileged EXEC command to measure the performance of packet forwarding. To display the results, use the show dot11 statistics metered-traffic command.
dot11 interface-number meter
Syntax Description
interface-number
|
Specifies the radio interface number. The 2.4-GHz radio is radio 0. The 5-GHz radio is radio 1.
|
Defaults
This command has no defaults.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to activate the meter tool for radio interface 0:
AP# dot11 dot11radio 0 meter
Related Commands
Command
|
Description
|
show dot11 statistics metered-traffic
|
Displays packet forwarding performance
|
dot11 network-map
Use the dot11 network-map global configuration command to enable the radio network map feature. When enabled, the access point broadcasts a IAPP GenInfo Request every collection interval. This request solicits information from all Cisco access points in the same Layer 2 domain. Upon receiving a GetInfo Request, the access point sends a unicast IAPP GenInfo Response back to the requester. The access point uses these IAPP GenInfo Responses to build a network-map.
dot11 network-map [collect-interval]
Syntax Description
collect-interval
|
Specifies the time interval between IAPP GenInfo Requests (1 to 60 seconds)
|
Defaults
The default collect interval is 5 seconds.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to generate a radio network map with a collection interval of 30 seconds:
AP(config)# dot11 network-map 30
You can verify the network map by using the show dot11 network-map EXEC command.
Related Commands
dot11 phone
Use the dot11 phone global configuration command to enable or disable IEEE 802.11 compliance phone support. Use the no form of this command to disable the IEEE 802.11 phone.
[no] dot11 phone
Note
This command is not supported on bridges.
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no defaults.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Usage Guidelines
Enabling IEEE 802.11 compliance phone support adds information to the access point beacons and probe responses. This information helps some 802.11 phones make intelligent choices about the access point to which they should associate. Some phones do not associate with an access point without this additional information.
Examples
This example shows how to enable IEEE 802.11 phone support:
This example shows how to stop or disable the IEEE 802.11 phone support:
AP(config)# no dot11 phone
dot11 priority_map avvid
Use the dot11 priority_map avvid global configuration command to enable or disable Cisco AVVID (Architecture for Voice, Video and Integrated Data) priority mapping. AVVID priority mapping maps Ethernet packets tagged as class of service 5 to class of service 6. This feature enables the access point to apply the correct priority to voice packets for compatibility with Cisco AVVID networks. Use the no form of this command to disable AVVID priority mapping.
[no] dot11 priority_map avvid
Note
This command is not supported on bridges.
Syntax Description
This command has no arguments or keywords.
Defaults
AVVID priority mapping is enabled by default.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(13)JA
|
This command was introduced.
|
Examples
This example shows how to stop or disable AVVID priority mapping:
AP(config)# no dot11 priority_map avvid
This example shows how to enable AVVID priority mapping:
AP(config)# dot11 priority_map avvid
Related Commands
Command
|
Description
|
class-map
|
Creates a class map to be used for matching packets to the class whose name you specify
|
show class-map
|
Displays quality of service (QoS) class maps
|
dot11 ssid
Use the dot11 ssid global configuration command to create a global SSID. The SSID is inactive until you use the ssid configuration interface command to assign the SSID to a specific radio interface.
dot11 ssid ssid
In Cisco IOS Release 12.3(2)JA, you can configure SSIDs globally or for a specific radio interface. When you use the dot11 ssid global configuration command to create an SSID, you can use the ssid configuration interface command to assign the SSID to a specific interface.
When an SSID has been created in global configuration mode, the ssid configuration interface command attaches the SSID to the interface but does not enter ssid configuration mode. However, if the SSID has not been created in global configuration mode, the ssid command puts the CLI into SSID configuration mode for the new SSID.
Note
When you create an SSID in global configuration mode, you can assign or change the SSID attributes only in global configuration mode. Similarly, when you create an SSID in configuration interface mode, you can assign or change the SSID attributes only in configuration interface mode.
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no defaults.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.3(2)JA
|
This command was introduced.
|
Examples
This example shows how to:
•
Create an SSID in global configuration mode
•
Configure the SSID for RADIUS accounting
•
Set the maximum number of client devices that can associate using this SSID to 15
•
Assign the SSID to a VLAN
•
Assign the SSID to a radio interface
AP(config)# dot11 ssid batman
AP(config-ssid)# accounting accounting-method-list
AP(config-ssid)# max-associations 15
AP(config-ssid)# vlan 3762
AP(config)# interface dot11radio 0
AP(config-if)# ssid batman
Related Commands
Command
|
Description
|
show running-config ssid
|
Displays configuration details for SSIDs created in global configuration mode
|
ssid
|
Creates an SSID in configuration interface mode or assigns a globally configured SSID to a specific radio interface
|
dot11 update-group-key
Use the dot11 update-group-key privileged EXEC command to trigger an update of the WPA group key. When you enter the command, the access point distributes a new WPA group key to authenticated client devices.
dot11 interface-number update-group-key [vlan vlan-id]
Syntax Description
interface-number
|
Specifies the radio interface number (the 2.4-GHz radio is radio 0; the 5-GHz radio is radio 1)
|
vlan-id
|
Specifies the VLAN on which the access point sends out the group key update
|
Defaults
This command has no defaults.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was introduced.
|
Examples
This example shows how to trigger a group key update on VLAN 2:
AP# dot11 dot11radio 0 group-key-update vlan 2
Related Commands
dot11 vlan-name
Use the dot11 vlan-name global configuration command to assign a name to a VLAN in addition to its numerical ID.
dot11 vlan-name name vlan vlan-id
Syntax Description
name
|
Specifies a name to assign to a VLAN ID. The name can contain up to 32 ASCII characters.
|
vlan-id
|
Specifies the VLAN ID to which the name is assigned.
|
Defaults
This command has no default setting.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.3(2)JA
|
This command was introduced.
|
Usage Guidelines
Keep these guidelines in mind when using VLAN names:
•
The mapping of a VLAN name to a VLAN ID is local to each access point, so across your network, you can assign the same VLAN name to a different VLAN ID.
Note
If clients on your wireless LAN require seamless roaming, Cisco recommends that you assign the same VLAN name to the same VLAN ID across all access points, or that you use only VLAN IDs without names.
•
Every VLAN configured on your access point must have an ID, but VLAN names are optional.
•
VLAN names can contain up to 32 ASCII characters. However, a VLAN name cannot be a number between 1 and 4095. For example, vlan4095 is a valid VLAN name, but 4095 is not. The access point reserves the numbers 1 through 4095 for VLAN IDs.
Examples
This example shows how to assign a name to a VLAN:
AP(config)# dot11 vlan-name chicago vlan 121
You can view VLAN name and ID pairs by using the show dot11 vlan-name EXEC command.
Related Commands
dot1x reauth-period
Use the dot1x reauth-period configuration interface command to configure the dot1x client- reauthentication period. The no form of the command disables reauthentication.
[no] dot1x reauth-period {1-65555 | server}
Syntax Description
1-65555
|
Specifies a number of seconds (1 to 65555)
|
server
|
Specifies reauthentication period configured on the authentication server. If you use this option, configure your authentication server with RADIUS attribute 27, Session-Timeout. This attribute sets the maximum number of seconds of service to be provided to a client device before termination of the session. The server sends this attribute to the access point when a client performs EAP authentication.
|
Defaults
The default is disabled.
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to configure a 2-minute dot1x client-reauthentication period:
AP(config-if)# dot1x reauth-period 120
Related Commands
eapfast authority
Use the eapfast authority command to configure an EAP-FAST authority ID (AID) for a local authenticator access point. The EAP-FAST AID identifies the server that authenticates the EAP-FAST client. The local authenticator sends its AID to an authenticating client, and the client checks its database for a matching AID. If the client does not recognize the AID, it requests a new Protected Access Credential (PAC).
[no] eapfast authority {id identifier | info string}
Syntax Description
id identifier
|
Specifies an authority identifier for the local authenticator access point. Enter up to 32 hexadecimal digits for the AID.
|
info string
|
Specifies an AID information string. The information string is not used during EAP-FAST authentication, but it provides additional information about the local authenticator. Enter up to 32 ASCII characters.
|
Defaults
The default AID is LOCAL RADIUS SER.
Command Modes
Configuration mode for local authenticators
Command History
Release
|
Modification
|
12.3(2)JA
|
This command was introduced.
|
Examples
This example shows how to configure an AID for the local authenticator access point:
AP(config-radsrv)#eapfast authority id ap1200
This example shows how to configure an information string for the AID:
AP(config-radsrv)#eapfast authority id AP1200 A+G North
Related Commands
eapfast pac expiry
Use the eapfast pac expiry global configuration command to set the Protected Access Credential (PAC) expiration time and grace period for a group of EAP-FAST clients associated to a local authenticator access point.
[no] eapfast pac expiry days [grace days]
Syntax Description
days
|
Specifies the number of days that the PAC is valid for a group of EAP-FAST clients. Enter a number of days from 1 to 4095.
|
grace days
|
Specifies the grace period after the PAC expires. The PAC remains valid until the end of the grace period. Enter a number of days from 1 to 4095.
|
Defaults
The default is infinite days for both the expiration time and the grace period.
Command Modes
Client group configuration mode for local authenticators
Command History
Release
|
Modification
|
12.3(2)JA
|
This command was introduced.
|
Examples
In this example, PACs for the user group clerks expire in 10 days with a grace period of two days:
AP(config)#radius-server local
AP(config-radsrv)#group clerks
AP(config-radsrv-group)#eapfast pac expiry 10 grace 2
Related Commands
eapfast server-key
Use the eapfast server-key command to configure EAP-FAST server keys. The local authenticator uses server keys to encrypt Protected Access Credential (PAC) files that it generates and to decrypt PACs when it is authenticating clients. The server maintains two keys, a primary key and a secondary key, and uses the primary key to encrypt PACs. Periodically, the local authenticator switches keys, making the primary key the secondary and using the secondary key as the primary. If you do not configure server keys, the local authenticator generates keys automatically.
When the local authenticator receives a client PAC, it attempts to decrypt the PAC with the primary key. If decryption fails with the primary key, the authenticator attempts to decrypt the PAC with the secondary key. If decryption fails with the secondary key, the authenticator rejects the PAC as invalid.
[no] eapfast server-key {primary {auto-generate | [0 | 7] key} |
secondary [0 | 7] key}
Syntax Description
primary {auto-generate | [0 | 7] key
|
Specifies a primary EAP-FAST server key. Use the auto-generate option to configure the local authenticator to generate a primary server key automatically. To configure a specific key, enter the key preceded by 0 or 7. Keys can contain up to 32 hexadecimal digits. Enter 0 before the key to enter an unencrypted key. Enter 7 before the key to enter an encrypted key.
|
secondary [0 | 7] key
|
Specifies a secondary EAP-FAST server key. Enter the key preceded by 0 or 7. Keys can contain up to 32 hexadecimal digits. Enter 0 before the key to enter an unencrypted key. Enter 7 before the key to enter an encrypted key.
|
Defaults
By default, the local authenticator generates server keys automatically.
Command Modes
Configuration mode for local authenticators
Command History
Release
|
Modification
|
12.3(2)JA
|
This command was introduced.
|
Examples
This example shows how to configure a primary server key for the local authenticator access point:
AP(config-radsrv)#eapfast server-key primary 0 2468
This example shows how to configure a secondary server key:
AP(config-radsrv)#eapfast server-key secondary 0 9753
Related Commands
encryption key
Use the encryption key configuration interface command to define a WEP key used for data encryption on the wireless LAN or on a specific virtual LAN (VLAN). Use the no form of the command to remove a specific encryption key.
Note
You need to configure static WEP keys only if your access point supports client devices that use static WEP. If all the client devices that associate to the access point use key management (WPA, CCKM, or 802.1x authentication) you do not need to configure static WEP keys.
[no] encryption
[vlan vlan-id ]
key 1-4
size {40bit | 128Bit}
encryption-key
[transmit-key]
Syntax Description
vlan vlan-id
|
Specifies the VLAN number (1 to 4095)
|
key 1-4
|
Specifies the number of the key (1 to 4) that is being configured. (A total of four encryption keys can be configured for each VLAN.)
Note If you configure static WEP with MIC or CMIC, the access point and associated client devices must use the same WEP key as the transmit key, and the key must be in the same key slot on the access point and the clients. See Table 2-5 for a list of WEP key restrictions based on your security configuration.
|
size 40bit
|
Specifies a 40-bit encryption key
|
size 128bit
|
Specifies a 128-bit encryption key
|
encryption-key
|
Specifies the value of the encryption key:
• A 40-bit encryption key requires 10 (hexadecimal) digits.
• A 128-bit encryption key requires 26 (hexadecimal) digits.
|
transmit-key
|
Specifies the key for encrypting transmit data from the access point. Key slot 1 is the default key slot.
|
Defaults
This command has no defaults.
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Usage Guidelines
Using security features such as authenticated key management can limit WEP key configurations. Table 2-5 lists WEP key restrictions based on your security configuration.
Table 2-5 WEP Key Restrictions
Security Configuration
|
WEP Key Restriction
|
CCKM or WPA authenticated key management
|
Cannot configure a WEP key in key slot 1
|
LEAP or EAP authentication
|
Cannot configure a WEP key in key slot 4
|
Cipher suite with 40-bit WEP
|
Cannot configure a 128-bit key
|
Cipher suite with 128-bit WEP
|
Cannot configure a 40-bit key
|
Cipher suite with TKIP
|
Cannot configure any WEP keys
|
Cipher suite with TKIP and 40-bit WEP or 128-bit WEP
|
Cannot configure a WEP key in key slot 1 and 4
|
Static WEP with MIC or CMIC
|
Access point and client devices must use the same WEP key as the transmit key, and the key must be in the same key slot on both access point and clients
|
Broadcast key rotation
|
Keys in slots 2 and 3 are overwritten by rotating broadcast keys
|
Examples
This example shows how to configure a 40-bit encryption key with a value of 11aa33bb55 as
WEP key 1 used on VLAN number 1:
AP(config-if)# encryption vlan 1 key 1 size 40bit 11aa33bb55 transmit-key
This example shows how to remove WEP key 1 on VLAN 1:
AP(config-if)# no encryption vlan 1 key 1
Related Commands
Command
|
Description
|
show running-config
|
Displays the current access point operating configuration
|
encryption mode ciphers
Use the encryption mode ciphers configuration interface command to enable a cipher suite. Cipher suites are sets of encryption algorithms that, like WEP, protect radio communication on your wireless LAN. You must use a cipher suite to enable Wi-Fi Protected Access (WPA) or Cisco Centralized Key Management (CCKM).
Because cipher suites provide the protection of WEP while also allowing use of authenticated key management, Cisco recommends that you enable WEP by using the encryption mode ciphers command in the CLI or by using the cipher drop-down menu in the web-browser interface. Cipher suites that contain TKIP provide the best security for your wireless LAN, and cipher suites that contain only WEP are the least secure.
Note
You can also use the encryption mode wep command to set up static WEP. However, you should use encryption mode wep only if all clients that associate to the access point are not capable of key management.
encryption [vlan vlan] mode ciphers
{[aes-ccm | ckip | cmic | ckip-cmic | tkip]}
{[wep128 | wep40]}
Syntax Description
vlan vlan
|
(Optional) Specifies the VLAN number
|
aes-ccm
|
Specifies that AES-CCMP is included in the cipher suite.
|
ckip1
|
Specifies that ckip is included in the cipher suite.
|
cmic1
|
Specifies that cmic is included in the cipher suite.
|
ckip-cmic1
|
Specifies that both ckip and cmic are included in the cipher suite.
|
tkip
|
Specifies that TKIP is included in the cipher suite.
Note If you enable a cipher suite with two elements (such as TKIP and 128-bit WEP), the second cipher becomes the group cipher.
|
wep128
|
Specifies that 128-bit WEP is included in the cipher suite.
|
wep40
|
Specifies that 40-bit WEP is included in the cipher suite.
|
Defaults
This command has no defaults.
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
12.2(15)JA
|
This command was modified to include support for AES-CCMP.
|
Usage Guidelines
If you configure your access point to use WPA or CCKM authenticated key management, you must
select a cipher suite compatible with the authenticated key management type. Table 2-6 lists the cipher
suites that are compatible with WPA and CCKM.
Table 2-6 Cipher Suites Compatible with WPA and CCKM
Authenticated Key Management Types
|
Compatible Cipher Suites
|
CCKM
|
• encryption mode ciphers wep128
• encryption mode ciphers wep40
• encryption mode ciphers ckip
• encryption mode ciphers cmic
• encryption mode ciphers ckip-cmic
• encryption mode ciphers tkip
• encryption mode ciphers tkip wep128
• encryption mode ciphers tkip wep40
|
WPA
|
• encryption mode ciphers tkip
• encryption mode ciphers tkip wep128
• encryption mode ciphers tkip wep40
|
Note
You must enable Aironet extensions to include CKIP, CMIC, or CKIP-CMIC in a cipher suite. Use the dot11 extension aironet command to enable Aironet extensions.
Refer to the Cisco IOS Software Configuration Guide for Cisco Aironet Access Points for a complete description of WPA and CCKM and instructions for configuring authenticated key management.
Examples
This example sets up a cipher suite for VLAN 22 that enables CKIP, CMIC, and 128-bit WEP.
ap(config-if)# encryption vlan 22 mode ciphers ckip-cmic wep128
Related Commands
encryption mode wep
Use the encryption mode wep configuration interface command to enable a specific encryption type that is used to communicate on the wireless LAN or on a specific VLAN. When encryption is enabled, all client devices on the wireless LAN or on a VLAN must support the specified encryption methods to communicate with the access point. Use the no form of the command to disable the encryption features on a specific VLAN.
Note
Because cipher suites provide the protection of WEP while also allowing use of authenticated key management, Cisco recommends that you enable WEP by using the encryption mode ciphers command. Cipher suites that contain TKIP provide the best security for your wireless LAN, and cipher suites that contain only WEP are the least secure.
[no] encryption [vlan vlan-id ] mode wep
{mandatory | optional}
{key-hash | mic [key-hash] }
Syntax Description
vlan vlan-id
|
(Optional) Specifies the VLAN number
|
mandatory
|
Specifies that encryption is mandatory for the client to communicate with the access point
|
optional
|
Specifies that client devices can communicate with the access point with or without using encryption
|
key-hash
|
(Optional) Specifies that encryption key hashing is required for client devices to communicate with the access point
|
mic
|
(Optional) Specifies that encryption with message integrity check (MIC) is required for client devices to communicate with the access point
|
Defaults
This command has no defaults.
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to specify that encryption key hashing must be used on VLAN number 1:
AP(config-if)# encryption vlan 1 mode wep mandatory key-hash
This example shows how to disable mandatory encryption on VLAN 1:
AP(config-if)# no encryption vlan 1 mode wep mandatory
Related Commands
Command
|
Description
|
show running-config
|
Displays the current access point operating configuration
|
exception crashinfo buffersize
To change the size of the buffer used for crashinfo files, use the exception crashinfo buffersize command in global configuration mode. To revert to the default buffersize, use the no form of this command.
exception crashinfo buffersize kilobytes
no exception crashinfo buffersize kilobytes
Syntax Description
kilobytes
|
Sets the size of the buffersize to the specified value within the range of 32 to 100 kilobytes. The default is 32 KB.
|
Defaults
Crashinfo buffer is 32 KB.
Command Modes
Global config
Command History
Release
|
Modification
|
12.2(15)JA
|
This command was introduced.
|
Usage Guidelines
The crashinfo file saves information that helps Cisco technical support representatives to debug
problems that caused the Cisco IOS image to fail (crash). The access point writes the crash
information to the console at the time of the failure, and the file is created the next time you boot the
Cisco IOS image after the failure (instead of while the system is failing).
Examples
This example sets the crashinfo buffer to 100 KB:
ap(config)# exception crashinfo buffersize 100
Related Commands
Command
|
Description
|
exception crashinfo file
|
Enables the creation of a diagnostic file at the time of unexpected system shutdowns.
|
exception crashinfo file
To enable the creation of a diagnostic file at the time of unexpected system shutdowns, use the exception crashinfo file command in global configuration mode. To disable the creation of crashinfo files, use the no form of this command.
exception crashinfo file device:filename
no exception crashinfo file device:filename
Syntax Description
device:filename
|
Specifies the flash device and file name to be used for storing the diagnostic information. The colon is required.
|
Defaults
Creation of crashinfo files is disabled by default.
Command Modes
Global config
Command History
Release
|
Modification
|
12.2(15)JA
|
This command was introduced.
|
Usage Guidelines
The crashinfo file saves information that helps Cisco technical support representatives to debug
problems that caused the Cisco IOS image to fail (crash). The access point writes the crash
information to the console at the time of the failure, and the file is created the next time you boot the
Cisco IOS image after the failure (instead of while the system is failing). The filename will be
filename_yyyymmdd-hhmmss, where y is year, m is month, d is date, h is hour, and s is seconds.
Examples
In this example, the access point creates a crashinfo file called crashdata in the default flash memory device if a system crash occurs:
ap(config)# exception crashinfo file flash:crashinfo
Related Commands
fragment-threshold
Use the fragment-threshold configuration interface command to set the size at which packets are fragmented. Use the no form of the command to reset the parameter to defaults.
[no] fragment-threshold 256-2346
Syntax Description
256-2346
|
Specifies the packet fragment threshold size (256 to 2346 bytes)
|
Defaults
The default threshold is 2346 bytes
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to set the packet fragment threshold size to 1800 bytes:
AP(config-if)# fragment-threshold 1800
This example shows how to reset the packet fragment threshold size to defaults:
AP(config-if)# no fragment-threshold
Related Commands
Command
|
Description
|
show running-config
|
Displays the current access point operating configuration
|
group (local server configuration mode)
Use the group local server configuration mode command to enter user group configuration mode and configure a user group to which you can assign shared settings. In user group configuration mode you can specify settings for the user group such as VLAN and SSID.
group group
Note
This command is not supported on bridges.
Syntax Description
group
|
Specifies the name of the user group
|
Defaults
This command has no defaults.
Command Modes
Local server configuration mode
Command History
Release
|
Modification
|
12.2(11)JA
|
This command was introduced.
|
Examples
This example shows how to create a user group on the local authenticator:
AP(config-radsrv)# group hoosiers
Related Commands
guest-mode (SSID configuration mode)
Use the guest-mode SSID configuration mode command to configure the radio interface (for the specified SSID) to support guest mode. Use the no form of the command to disable the guest mode.
[no] guest-mode
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no defaults.
Command Modes
SSID configuration interface
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Usage Guidelines
The access point can have one guest-mode SSID or none at all. The guest-mode SSID is used in beacon frames and response frames to probe requests that specify the empty or wildcard SSID. If no guest-mode SSID exists, the beacon contains no SSID and probe requests with the wildcard SSID are ignored. Disabling the guest mode makes the networks slightly more secure. Enabling the guest mode helps clients that passively scan (do not transmit) associate with the access point. It also allows clients configured without a SSID to associate.
Examples
This example shows how to set the wireless LAN for the specified SSID into guest mode:
AP(config-if-ssid)# guest-mode
This example shows how to reset the guest-mode parameter to default values:
AP(config-if-ssid)# no guest-mode
Related Commands
Command
|
Description
|
ssid
|
Specifies the SSID and enters the SSID configuration mode
|
show running-config
|
Displays the current access point operating configuration
|
iapp standby mac-address
Use the iapp standby mac-address global configuration command to configure an access point to be in standby mode and specify the monitored access point's MAC address. Use the no form of this command to disable the access point standby mode.
[no] iapp standby mac-address mac-address
Note
This command is not supported on bridges.
Syntax Description
mac-address
|
Specifies the MAC address (in xxxx.xxxx.xxxx format) of the active access point
|
Defaults
This command has no default setting.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to place the access point in standby mode and indicate the MAC address of the active access point:
AP(config)# iapp standby mac-address 0040.9631.81cf
This example shows how to stop or disable the standby mode:
AP(config)# no iapp standby mac-address 0040.9631.81cf
Related CommandsYou can verify your settings by entering the show class-map privileged EXEC command.
iapp standby poll-frequency
Use the iapp standby poll-frequency global configuration command to configure the standby mode polling interval. Use the no form of this command to clear the access point standby mode poll frequency.
[no] iapp standby poll-frequency sec [mac-address]
Note
This command is not supported on bridges.
Syntax Description
sec
|
Specifies the standby mode poll frequency in seconds
|
mac-address
|
Specifies the MAC address of an access point
|
Defaults
When you enable hot standby, the default poll frequency is 2 seconds.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to specify the standby mode poll frequency of 5 minutes:
AP(config)# iapp standby poll-frequency 300
This example shows how to stop or disable the standby mode:
AP(config)# no iapp standby mac-address 0040.9631.81cf
Related CommandsYou can verify your settings by entering the show class-map privileged EXEC command.
iapp standby primary-shutdown
Use the iapp standby primary-shutdown global configuration command to disable the radio interfaces on the monitored access point when the standby access point becomes active. The standby access point sends a Dumb Device Protocol (DDP) message to disable the radios of the monitored access point when it detects a failure (for example, if the standby unit cannot associate to the monitored access point, or if the standby unit detects a link test failure on any of the monitored interfaces).
[no] iapp standby primary-shutdown
Note
This command is not supported on bridges.
Note
When the monitored access point receives the message to disable its radios it puts the radio interfaces into the admin down state. You must re-enable the radios to bring the radio interfaces back up.
Syntax Description
This command has no arguments or keywords.
Defaults
This feature is disabled by default.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(13)JA
|
This command was introduced.
|
Examples
This example shows how to enable the primary shutdown feature on a standby access point:
AP(config)# iapp standby primary-shutdown
Related CommandsYou can verify your settings by entering the show class-map privileged EXEC command.
iapp standby timeout
Use the iapp standby timeout global configuration command to configure the standby mode polling timeout value. Use the no form of this command to clear the standby mode polling timeout value.
[no] iapp standby timeout sec
Syntax Description
sec
|
Specifies the standby mode polling timeout in seconds
|
Defaults
When you enable hot standby, the default standby timeout is 20 seconds.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to specify the standby mode polling timeout of 1 minute:
AP(config)# iapp standby timeout 60
This example shows how to clear the standby mode timeout value:
AP(config)# no iapp standby timeout
Related CommandsYou can verify your settings by entering the show class-map privileged EXEC command.
information-element ssidl (SSID configuration mode)
Use the information-element ssidl SSID configuration command to designate an SSID for inclusion in an SSIDL information element (IE) that the access point includes in beacons. When you designate an SSID to be included in an SSIDL IE, client devices detect that the SSID is available, and they also detect the security settings required to associate using that SSID.
[no] information-element ssidl {[advertisement] [wps]}
Syntax Description
advertisement
|
Includes the SSID name and capabilities in the access point SSIDL IE.
|
wps
|
Sets the WPS capability flag in the SSIDL IE.
|
Defaults
By default, the access point does not include SSIDL IEs in beacons.
Command Modes
SSID configuration mode
Command History
Release
|
Modification
|
12.3(2)JA
|
This command was introduced.
|
Examples
This example shows how to designate an SSID for inclusion in the WPS IE:
AP(config-if-ssid)# information-element ssidl advertisement wps
Related Commands
Command
|
Description
|
ssid
|
Configures an SSID.
|
infrastructure-client
Use the infrastructure-client configuration interface command to configure a virtual interface for a workgroup bridge client. Use the no form of the command to disable the workgroup bridge client virtual interface.
[no] infrastructure-client
Note
Enter this command on an access point or bridge. This command is not supported on devices configured as workgroup bridges.
Syntax Description
This command has no arguments or keywords.
Defaults
The default is infrastructure client disabled.
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Usage Guidelines
Enable the infrastructure client feature to increase the reliability of multicast messages to workgroup bridges. When enabled, the access point sends directed packets containing the multicasts, which are retried if necessary, to the associated workgroup bridge. Enable only when necessary because it can greatly increase the load on the radio cell.
Examples
This example shows how to configure a virtual interface for a workgroup bridge client.
AP(config-if)# infrastructure-client
This example shows how to specify that a workgroup bridge client virtual interface is not supported.
AP(config-if)# no infrastructure-client
Related Commands
Command
|
Description
|
show running-config
|
Displays information on the current running access point configuration
|
infrastructure-ssid (SSID configuration mode)
Use the infrastructure-ssid command in SSID configuration mode to reserve this SSID for infrastructure associations, such as those from one access point or bridge to another. Use the no form of the command to revert to a normal non-infrastructure SSID.
[ no ] infrastructure-ssid [ optional ]
Syntax Description
optional
|
Specifies that both infrastructure and mobile client devices are allowed to associate using the SSID
|
Defaults
This command has no defaults.
Command Modes
SSID configuration interface
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Usage Guidelines
This command controls the SSID that access points and bridges use when associating with one another. A root access point only allows a repeater access point to associate using the infrastructure SSID, and a root bridge only allows a non-root bridge to associate using the infrastructure SSID. Repeater access points and non-root bridges use this SSID to associate with root devices. Configure authentication types and VLANs for an SSID to control the security of access points and bridges.
Examples
This example shows how to reserve the specified SSID for infrastructure associations on the wireless LAN:
AP(config-if-ssid)# infrastructure-ssid
This example shows how to restore the SSID to non-infrastructure associations:
AP(config-if-ssid)# no infrastructure-ssid
Related Commands
Command
|
Description
|
ssid
|
Specifies the SSID and enters the SSID configuration mode
|
interface dot11radio
Use the interface dot11radio global configuration command to place access point into the radio configuration mode.
interface dot11radio interface-number
Syntax Description
interface-number
|
Specifies the radio interface number (The 2.4-GHz radio is radio 0, and the 5-GHz radio is radio 1.)
|
Defaults
The default radio interface number is 0.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to place the access point into the radio configuration mode:
AP# interface dot11radio 0
Related Commands
ip redirection
Use the ip redirection SSID configuration mode command to enable IP redirection for an SSID. When you configure IP redirection for an SSID, the access point redirects packets sent from client devices associated to that SSID to a specific IP address. IP redirection is used mainly on wireless LANs serving handheld devices that use a central software application and are statically configured to communicate with a specific IP address.
You can redirect all packets from client devices associated using an SSID or redirect only packets directed to specific TCP or UDP ports (as defined in an access control list). When you configure the access point to redirect only packets addressed to specific ports, the access point redirects those packets from clients using the SSID and drops all other packets from clients using the SSID.
Note
When you perform a ping test from the access point to a client device that is associated using an IP-redirect SSID, the response packets from the client are redirected to the specified IP address and are not received by the access point.
[no] ip redirection {host ip-address [access-group {access-list-number | access-list-name} in]}
Syntax Description
ip-address
|
Specifies the IP address to which packets are redirected. If you do not specify an access control list (ACL) which defines TCP or UDP ports for redirection, the access point redirects all packets that it receives from client devices.
|
access-list-number
|
Specifies the number of the ACL used for packet redirection.
|
access-list-name
|
Specifies the name of the ACL used for packet redirection.
|
in
|
Specifies that the ACL is applied to the access point's incoming interface.
|
Defaults
IP redirection is disabled by default.
Command Modes
SSID configuration mode
Command History
Release
|
Modification
|
12.3(2)JA
|
This command was introduced.
|
Examples
This example shows how to configure IP redirection for an SSID without applying an ACL. The access point redirects all packets that it receives from client devices associated to the SSID zorro:
AP(config)# interface dot11radio 0
AP(config-if)# ssid zorro
AP(config-if-ssid)# ip redirection host 10.91.104.91
AP(config-if-ssid-redirect)# end
This example shows how to configure IP redirection only for packets sent to the specific TCP and
UDP ports specified in an ACL. When the access point receives packets from client devices associated
using the SSID robin, it redirects packets sent to the specified ports and discards all other packets:
AP(config)# interface dot11radio 0
AP(config-if)# ssid zorro
AP(config-if-ssid)# ip redirection host 10.91.104.91 access-group redirect-acl in
Related Commands
Command
|
Description
|
ssid
|
Configure an SSID for the access point radio
|
l2-filter bridge-group-acl
Use the l2-filter bridge-group-acl configuration interface command to apply a Layer 2 ACL filter to the bridge group incoming and outgoing packets between the access point and the host (upper layer). Use the no form of the command to disable the Layer 2 ACL filter.
[no] l2-filter bridge-group-acl
Syntax Description
This command has no arguments or keywords.
Defaults
This command has no defaults.
Command Modes
Configuration interface
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to apply a Layer 2 ACL filter to the bridge group packets:
AP(config-if)# l2-filter bridge-group-acl
This example shows how to activate a Layer 2 ACL filter:
AP(config-if)# no l2-filter bridge-group-acl
Related Commands
Command
|
Description
|
bridge-group port-protected
|
Enables protected port for public secure mode configuration
|
show bridge
|
Displays information on the bridge group or classes of entries in the bridge forwarding database
|
show bridge group
|
Displays information about configured bridge groups
|
led flash
Use the led flash privileged EXEC command to start or stop the blinking of the LED indicators on the access point for a specified number of seconds. Without arguments, this command blinks the LEDs continuously.
led flash [seconds | disable]
Syntax Description
seconds
|
Specifies the number of seconds (1 to 3600) that the LEDs blink
|
disable
|
Stops the blinking of the LEDs
|
Defaults
The default is continuous blinking of the LEDs.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to blink the access point LEDs for 30 seconds:
This example shows how to stop the blinking of the access point LEDs:
Related Commands
Command
|
Description
|
show led flash
|
Displays the blinking status of the LEDs
|
logging buffered
Use the logging buffered global configuration command to begin logging of messages to an internal buffer. Use the no form of this command to stop logging messages.
[no] logging buffered [size] [severity]
Syntax Description
size
|
Specifies the size of the internal buffer (4096 to 2147483647 bytes)
|
severity
|
Specifies the message severity to log (1-7)
Severity 1: alerts
Severity 2: critical
Severity 3: errors
Severity 4: warnings
Severity 5: notifications
Severity 6: informational
Severity 7: debugging
|
Defaults
This command has no defaults.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to begin logging severity 3 messages to an internal 5000-byte buffer:
AP(config)# logging buffered 5000 3
This example shows how to stop the message logging:
AP(config)# no logging buffered
Related Commands
Command
|
Description
|
show logging
|
Displays recent logging event headers or complete events
|
clear logging
|
Clears logging status count and the trace buffer
|
logging snmp-trap
Use the logging snmp-trap global configuration command to specify the severity level of syslog messages for which the access point sends SNMP traps.
[no] logging snmp-trap severity
Syntax Description
severity
|
Specifies the severity levels for which the access point sends SNMP traps. You can enter a range of severity levels--0 through 7--or a single severity level.
To specify a single severity level, enter emergencies (level 0), alerts (level 1), critical (level 2), errors (level 3), warnings (level 4), notifications (level 5), informational (level 6), or debugging (level 7).
|
Defaults
This command has no defaults.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.3(2)JA
|
This command was introduced.
|
Usage Guidelines
For the logging snmp-trap command to operate correctly, you must also configure these global configuration commands on the access point:
AP(config)# logging history severity
AP(config)# snmp-server enable traps
AP(config)# snmp-server host address syslog
Examples
This example shows how to configure the access point to send SNMP traps for all severity levels:
AP(config)# logging snmp-trap 0 7
This example shows how to configure the access point to send SNMP traps only for warning messages:
AP(config)# logging snmp-trap warnings
Related Commands
Command
|
Description
|
logging buffered
|
Controls logging of messages to an internal buffer
|
show logging
|
Displays recent logging event headers or complete events
|
clear logging
|
Clears logging status count and the trace buffer
|
match (class-map configuration)
Use the match class-map configuration command to define the match criteria to classify traffic. Use the no form of this command to remove the match criteria.
[no] match {access-group acl-index-or-name |
ip [dscp dscp-list | precedence precedence-list] |
vlan vlan-id}
Syntax Description
access-group acl-index-or-name
|
Specifies the number or name of an IP standard or extended access control list (ACL) or MAC ACL. For an IP standard ACL, the ACL index ranges are 1 to 99 and 1300 to 1999. For an IP extended ACL, the ACL index ranges are100 to 199 and 2000 to 2699.
|
ip dscp dscp-list
|
Specifies a list of up to eight IP Differentiated Services Code Point (DSCP) values to match against incoming packets. Separate each value with a space. The range is 0 to 63.
|
ip precedence precedence-list
|
Specifies a list of up to eight IP-precedence values to match against incoming packets. Separate each value with a space. The range is 0 to 7.
|
vlan vlan-id
|
Specifies the virtual LAN identification number. Valid IDs are from 1 to 4095; do not enter leading zeros.
|
Note
Though visible in the command-line help strings, the any, class-map, destination-address, input-interface, mpls, not, protocol, and source-address keywords are not supported.
Defaults
This command has no defaults.
Command Modes
Class-map configuration
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Usage Guidelines
Use the class-map global configuration command to enter the class-map configuration mode. The match command in the class-map configuration mode is used to specify which fields in the incoming packets are examined to classify the packets. Only the IP access group or the MAC access group matching to the Ether Type/Len are supported.
You can use the match ip dscp dscp-list command only in a policy map that is attached to an egress interface.
Only one match command per class map is supported.
For the match ip dscp dscp-list or the match ip precedence ip-precedence-list command, you can enter a mnemonic name for a commonly used value. For example, you can enter the match ip dscp af11 command, which is the same as entering the match ip dscp 10 command. You can enter the match ip precedence critical command, which is the same as entering the match ip precedence 5 command. For a list of supported mnemonics, enter the match ip dscp ? or the match ip precedence ? command to see the command-line help strings.
Examples
This example shows how to create a class map called class2, which matches all the incoming traffic with DSCP values of 10, 11, and 12:
AP(config)# class-map class2
AP(config-cmap)# match ip dscp 10 11 12
This example shows how to create a class map called class3, which matches all the incoming traffic with IP-precedence values of 5, 6, and 7:
AP(config)# class-map class3
AP(config-cmap)# match ip precedence 5 6 7
This example shows how to delete the IP-precedence match criteria and to classify traffic by vlan:
AP(config)# class-map class2
AP(config-cmap)# match ip precedence 5 6 7
AP(config-cmap)# no match ip precedence
AP(config-cmap)# match vlan 2
You can verify your settings by entering the show class-map privileged EXEC command.
Related Commands
Command
|
Description
|
class-map
|
Creates a class map to be used for matching packets to the class whose name you specify
|
show class-map
|
Displays quality of service (QoS) class maps
|
max-associations (SSID configuration mode)
Use the max-associations SSID configuration mode command to configure the maximun number of associations supported by the radio interface (for the specified SSID). Use the no form of the command to reset the parameter to the default value.
[no] max-associations value
Syntax Description
value
|
Specifies the maximum number (1 to 255) of associations supported
|
Defaults
This default maximum is 255.
Command Modes
SSID configuration interface
Command History
Release
|
Modification
|
12.2(4)JA
|
This command was introduced.
|
Examples
This example shows how to set the maximum number of associations to 5 on the wireless LAN for the specified SSID:
AP(config-if-ssid)# max-associations 5
This example shows how to reset the maximum number of associations to the default value:
AP(config-if-ssid)# no max-associations
Related Commands