- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
02-WLAN Service Commands | 463.43 KB |
WLAN global service control commands
802.11 MAC configuration commands
client max-count (radio policy view)
client max-count (service template view)
display wlan statistics ap connect-history
display wlan statistics client
display wlan statistics service-template
service-template (service template view)
AC-AP tunnel configuration commands
tunnel encryption ipsec pre-shared-key
display user-isolation statistics
reset user-isolation statistics
user-isolation permit broadcast
user-isolation vlan permit-mac
AP group configuration commands
SSID-based access control configuration commands
AC hot backup configuration commands
WLAN global service control commands
wlan enable
Syntax
wlan enable
undo wlan enable
View
System view
Default level
2: System level
Parameters
None
Description
Use wlan enable to enable WLAN service.
Use undo wlan enable to disable WLAN service.
By default, WLAN service is enabled.
|
NOTE: All WLAN services are available if and only if WLAN service is enabled. |
Examples
# Enable WLAN service if it is disabled.
<Sysname> system-view
[Sysname] wlan enable
802.11 MAC configuration commands
a-mpdu enable
Syntax
a-mpdu enable
undo a-mpdu enable
View
Radio view
Default level
2: System level
Parameters
None
Description
Use a-mpdu enable to enable the A-MPDU function for the radio.
Use undo a-mpdu enable to disable the A-MPDU function for the radio.
By default, the A-MPDU function is enabled.
This command is only effective on 802.11n radios.
If you change the radio type of an 802.11n radio, the default setting for this function of the new radio type is restored.
Examples
# Disable the A-MPDU function.
<Sysname> system-view
[Sysname] wlan ap ap3 model WA2620-AGN
[Sysname-wlan-ap-ap3] radio 1 type dot11an
[Sysname-wlan-ap-ap3-radio-1] undo a-mpdu enable
a-msdu enable
Syntax
a-msdu enable
undo a-msdu enable
View
Radio view
Default level
2: System level
Parameters
None
Description
Use a-msdu enable to enable the A-MSDU function for the radio.
Use undo a-msdu enable to disable the A-MSDU function for the radio.
By default, the A-MSDU function is enabled.
This command is only effective on 802.11n radios. If you change the radio type of an 802.11n radio, the default setting for this function of the new radio type is restored.
The device only receives but does not send A-MSDU frames.
Examples
# Disable the A-MSDU function.
<Sysname> system-view
[Sysname] wlan ap ap3 model WA2620-AGN
[Sysname-wlan-ap-ap3] radio 1 type dot11an
[sysname-wlan-ap-ap3-radio-1] undo a-msdu enable
ani enable
Syntax
ani enable
undo ani enable
View
Radio view
Default level
2: System level
Parameters
None
Description
Use ani enable to enable the Adaptive Noise Immunity (ANI) function.
Use undo ani enable to disable the ANI function.
By default, ANI is enabled.
After the ANI function is enabled, the device automatically adjusts the noise immunity level according to the surrounding signal environment to eliminate RF interference.
Examples
# Disable ANI.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2100
[Sysname-wlan-ap-ap1] radio 1
[Sysname-wlan-ap-ap1-radio-1] undo ani enable
antenna type
Syntax
antenna type type
undo antenna type
View
Radio view
Default level
2: System level
Parameters
type: Specifies the antenna type.
Description
Use antenna type to specify the antenna type.
Use undo antenna type to restore the default.
The default setting of the command depends on the device model.
Examples
# Specify the antenna type.
<Sysname> system-view
[Sysname] wlan ap ap1 model wa2620e-agn
[Sysname-wlan-ap-ap1] radio 1
[Sysname-wlan-ap-ap1-radio-1] antenna type C5060
beacon ssid-hide
Syntax
beacon ssid-hide
undo beacon ssid-hide
View
Service template view
Default level
2: System level
Parameters
None
Description
Use beacon ssid-hide to configure hiding the Service Set Identifier (SSID) in beacon frames.
Use undo beacon ssid-hide to restore the default.
By default, the SSID is not hidden in beacon frames.
If the SSID in beacon frames is hidden, the SSID must be configured for the clients to associate with the AP.
Hiding the SSID in beacon frames does little good to wireless security. Allowing the advertising of the SSID in beacon frames enables a client to discover an AP more easily.
Examples
# Hide the SSID in beacon frames.
<Sysname> system-view
[Sysname] wlan service-template 1 clear
[Sysname-wlan-st-1] beacon ssid-hide
beacon-interval
Syntax
beacon-interval interval
undo beacon-interval
View
Radio policy view
Default level
2: System level
Parameters
interval: Specifies the interval for sending beacon frames. The value is in the range of 32 to 8191 time units (TUs).
Description
Use beacon-interval to set the interval for sending beacon frames. Beacon frames are transmitted at a regular interval to allow mobile clients to join the network.
Use undo beacon-interval to restore the default beacon interval.
By default, the beacon interval is 100 TUs.
Examples
# Specify the beacon interval as 1000 TUs.
<Sysname> system-view
[Sysname] wlan radio-policy radio1
[Sysname-wlan-rp-radio1] beacon-interval 1000
bind wlan-ess
Syntax
bind wlan-ess interface-index
undo bind wlan-ess
View
Service template view
Default level
2: System level
Parameters
interface-index: Specifies the index of the WLAN-ESS interface. The value range varies with AC models. For more information about AC models, see About the WX Series Access Controllers Command References.
Description
Use bind wlan-ess to bind the specified WLAN-ESS interface to the service template.
Use undo bind wlan-ess to unbind the WLAN-ESS interface to the service template.
By default, no WLAN-ESS interface is bound to the service template.
Examples
# Bind interface WLAN-ESS 1 to service template 1.
<Sysname> system-view
[Sysname] interface WLAN-ESS 1
[Sysname-WLAN-ESS1] quit
[Sysname] wlan service-template 1 clear
[Sysname-wlan-st-1] bind wlan-ess 1
broadcast-probe reply
Syntax
broadcast-probe reply
undo broadcast-probe reply
View
AP template view
Default level
2: System level
Parameters
None
Description
Use broadcast-probe reply to enable the AP to respond to the probe requests that carry no SSID.
Use undo broadcast-probe reply to configure the AP to respond only to probe requests that carry an SSID.
By default, an AP responds to probe requests that carry no SSID.
Examples
# Enable AP3 to respond to probe requests that carry no SSID.
<Sysname> system-view
[Sysname] wlan ap ap3 model WA2100
[Sysname-wlan-ap-ap3] broadcast-probe reply
channel
Syntax
channel { channel-number | auto }
undo channel
View
Radio view
Default level
2: System level
Parameters
channel-number: Specifies a channel. The working channels depend on the country code and radio mode.
auto: Specifies that the channel is automatically selected by the device according to the actual environment during system initialization.
Description
Use channel to specify a channel for the radio. Different radios support different channels. Channels may differ for each country.
Use undo channel to restore the default.
By default, auto mode is set.
The channel channel-number, if specified, is always used, and you do not need to configure the channel lock command. If you configure the channel lock command first, and then the channel channel-number command, the earlier configuration is overwritten.
Before configuring DFS, be sure that the AC adopts the auto mode. Otherwise, DFS does not work. For more information about DFS, see WLAN Configuration Guide.
Related commands: channel lock, dot11a calibrate-channel, and dot11bg calibrate-channel.
Examples
# Specify channel 6 for radio 1 of AP3.
<Sysname> system-view
[Sysname] wlan ap ap3 model WA2100
[Sysname-wlan-ap-ap3] radio 1 type dot11b
[Sysname-wlan-ap-ap3-radio-1] channel 6
channel band-width
Syntax
channel band-width { 20 | 40 }
undo channel band-width
View
Radio view
Default level
2: System level
Parameters
20: Specifies the channel bandwidth of the 802.11n radio as 20 MHz.
40: Specifies the channel bandwidth of the 802.11n radio as 40 MHz.
Description
Use channel band-width to specify the channel bandwidth of the 802.11n radio.
Use undo channel band-width to restore the default.
By default, the channel bandwidth of the 802.11an radio is 40 MHz, and that of the 802.11gn radio is 20 MHz.
This command is only effective on 802.11n radios.
If you change the radio type of an 802.11n radio, the default setting for this function of the new radio type is restored.
If the channel bandwidth of the radio is set to 40 MHz, a 40 MHz channel is used as the working channel. If no 40 MHz channel is available, only a 20 MHz channel can be used.
Examples
# Configure the channel bandwidth of the radio as 20 MHz.
<Sysname> system-view
[Sysname]wlan ap ap3 model WA2620-AGN
[Sysname-wlan-ap-ap3] radio 1 type dot11an
[Sysname-wlan-ap-ap3-radio-1] channel band-width 20
channel lock
Syntax
channel lock
undo channel lock
View
Radio view
Default level
2: System level
Parameters
None
Description
Use channel lock to lock the current channel.
Use undo channel lock to unlock the current channel.
By default, the current channel is not locked.
The channel clock command takes effect only when the radio adopts the auto mode (configured with the channel auto command).
If you configure the channel lock command and then enable the radio by using the radio enable command, the radio automatically selects an optimal channel, and then locks the channel.
When the AC detects any radar signals on its channel, it immediately selects another channel even if the channel lock command is configured, and locks the new channel.
If you configure the channel lock command first, and then enable dynamic frequency selection (DFS), DFS does not work because the channel is locked. Therefore, before enabling DFS, make sure the current channel is not locked. If you enable DFS and then configure the channel lock command, the last selected channel is locked. For more information about DFS, see the WLAN Configuration Guide.
Related commands: channel, dot11a calibrate-channel, and dot11bg calibrate-channel.
Examples
# Lock the current channel.
<Sysname> system-view
[Sysname] wlan ap ap3 model WA2100
[Sysname-wlan-ap-ap3] radio 1 type dot11g
[Sysname-wlan-ap-ap3-radio-1] channel lock
client dot11n-only
Syntax
client dot11n-only
undo client dot11n-only
View
Radio view
Default level
2: System level
Parameters
None
Description
Use client dot11n-only to allow only 802.11n clients to access.
Use undo client dot11n-only to restore the default.
By default, an 802.11an radio permits both 802.11a and 802.11an clients to access, and an 802.11gn radio permits both 802.11b/g and 802.11gn clients to access.
An 802.11n radio supports both 2.4GHz and 5GHz bands and can allow 802.11a/b/g stations to access, providing good compatibility.
The client dot11n-only command prohibits non-802.11n clients from access. Therefore, if you want to provide access for all 802.11a/b/g clients, disable this command.
Related commands: dot11n mandatory maximum-mcs.
Examples
# Configure the radio to allow only 802.11n clients to access.
<Sysname> system-view
[Sysname]wlan ap ap3 model WA2620-AGN
[Sysname-wlan-ap-ap3] radio 1 type dot11an
[Sysname-wlan-ap-ap3-radio-1] client dot11n-only
client forwarding-mode local
Syntax
client forwarding-mode local [ vlan vlan-id-list ]
undo client forwarding-mode local
View
Service template view
Parameters
vlan vlan-id-list: VLANs used for local forwarding. This argument is expressed in the format of vlan-id-list = { vlan-id1 [ to vlan-id2 ] }& <1-10>, where vlan-id is in the range of 1 to 4094 and &<1-10> indicates that you can specify up to 10 VLAN IDs or VLAN ID ranges. If this parameter is not specified, local forwarding is enabled on all the VLANs.
Description
Use client forwarding-mode local to enable AP local forwarding in the service template.
Use undo client forwarding-mode local to disable AP local forwarding in the service template.
By default, remote forwarding is enabled in the service template.
After the service template is bound with an AP:
· If local forwarding is enabled in the service template, the AP forwards data frames from associated clients.
· If remote forwarding is enabled, the AC forwards data frames from associated clients.
Local forwarding greatly reduces the load of the AC by enabling APs to forward client traffic, especially in a WLAN servicing many clients.
Examples
# Enable local forwarding in service template 1.
<Sysname> system-view
[Sysname] wlan service-template 1 clear
[Sysname-wlan-st-1] client forwarding-mode local
client idle-timeout
Syntax
client idle-timeout interval
undo client idle-timeout
View
AP template view
Default level
2: System level
Parameters
interval: Specifies the time for which the link between AP and client ( power-save or awake ) can be idle. The value is in the range of 60 to 86400 seconds.
Description
Use client idle-timeout to specify the client idle timeout interval. If a client is idle for more than the specified interval, or, if the AP does not receive any data from the client within a specified interval, the client is removed from the network.
Use undo client idle-timeout to restore the default.
By default, the client idle timeout interval is 3600 seconds.
Examples
# Specify the client idle timeout as 600 seconds.
<Sysname> system-view
[Sysname] wlan ap ap3 model WA2100
[Sysname-wlan-ap-ap3] client idle-timeout 600
client keep-alive
Syntax
client keep-alive interval
undo client keep-alive
View
AP template view
Default level
2: System level
Parameters
interval: Interval between keep-alive requests. The value is in the range of 3 to 1800 seconds.
Description
Use client keep-alive to specify the client keep-alive interval.
Use undo client keep-alive to disable the client keep-alive functionality.
The client keep-alive mechanism is used to detect clients segregated from the system due to various reasons such as power failure or crash, and disconnect them from AP.
By default, the client keep-alive functionality is disabled.
Examples
# Specify the client keep-alive interval as 60 seconds.
<Sysname> system-view
[Sysname] wlan ap ap3 model WA2100
[Sysname-wlan-ap-ap3] client keep-alive 60
client max-count (radio policy view)
Syntax
client max-count max-number
undo client max-count
View
Radio policy view
Default level
2: System level
Parameters
max-number: Maximum number of allowed clients, in the range of 1 to 124.
Description
Use client max-count to specify the maximum number of allowed clients for the radio policy.
Use undo client max-count to restore the default.
The default maximum number is 64.
Examples
# Specify that radio policy radio1 can accommodate at most 10 clients.
<Sysname> system-view
[Sysname] wlan radio-policy radio1
[Sysname-wlan-rp-radio1] client max-count 10
client max-count (service template view)
Syntax
client max-count max-number
undo client max-count
View
Service template view
Default level
2: System level
Parameters
max-number: Maximum number of clients associated to an SSID, in the range of 1 to 64.
Description
Use client max-count to specify the maximum number of clients associated to an SSID on a radio.
Use undo client max-count to restore the default.
By default, up to 64 clients can be associated to an SSID on a radio.
When the number of clients associated to an SSID on a radio reaches the maximum number, the SSID is automatically hidden.
Examples
# Specify the maximum number of clients associated to the SSID service on a radio as 10.
<Sysname> system-view
[Sysname] wlan service-template 1 clear
[Sysname-wlan-st-1] ssid service
[Sysname-wlan-st-1] client max-count 10
country-code
Syntax
country-code code
undo country code
View
AP template view
Default level
2: System level
Parameters
code: Country code. For information about country codes, see Table 11.
Description
Use country-code to specify the country code of the AP.
Use undo country-code to remove the configuration.
By default, no country code is configured for the AP, and the AP uses the global country code.
An AP configured with a country code uses its own country code.
Related commands: wlan country-code, display wlan country-code.
Examples
# Specify the country code for the AP as US.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2620-AGN
[Sysname-wlan-ap-ap1] country-code us
display wlan client
Syntax
display wlan client [ ap ap-name [ radio radio-number ] | mac-address mac-address | service-template service-template-number ] [ verbose ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
ap ap-name: Displays the information of clients which are connected to the specified AP.
radio radio-number: Displays the information of clients attached to the specified radio. The radio number value is 1.
mac-address mac-address: Specifies the MAC address of a client.
service-template service-template-number: Displays client information based on the specified service template. The service template number is in the range of 1 to 1024.
verbose: Displays detailed client information.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display wlan client to display WLAN client information. The information is displayed in the order of client MAC address.
Examples
# Display information about all clients.
<Sysname> display wlan client
Total Number of Clients : 3
Client Information
SSID: office
--------------------------------------------------------------------------------
MAC Address User Name APID/RID IP Address VLAN
--------------------------------------------------------------------------------
000f-e265-6400 –NA- 1/1 1.1.1.1 1
000f-e265-6401 user 1024/1 3.0.0.3 3
000f-e265-6402 mac@office.com 103 /1 FE:11:12:03::11:25:13 1
Table 1 Command output
Field |
Description |
SSID |
SSID with which the client is associated. |
MAC address |
MAC address of the client. |
User Name |
Username of the client: · The field displays -NA- if the client adopts plaintext authentication or ciphertext authentication with no username. · The field is irrelevant to the portal authentication method. If the client uses the portal authentication method, the field does not display the portal username of the client. |
APID/RID |
ID of the AP or radio that the client is associated with. |
IP Address |
IP address of the client. |
VLAN |
VLAN to which the client belongs. |
# Display detailed information about all clients.
<Sysname> display wlan client verbose
Total Number of Clients : 1
Client Information
-------------------------------------------------------------------------------
MAC Address : 001e-58f6-01bf
User Name : -NA-
AID : 1
AP Name : 2
Radio Id : 2
SSID : office
BSSID : 0026-3e08-1150
Port : WLAN-DBSS0:3
VLAN : 1
State : Running
Power Save Mode : Active
Wireless Mode : 11gn
Channel Band-width : 20MHz
SM Power Save Enable : Disabled
Short GI for 20MHz : Not Supported
Short GI for 40MHz : Supported
Support MCS Set : 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15
BLOCK ACK-TID 0 : IN
QoS Mode : WMM
Listen Interval (Beacon Interval) : 10
RSSI : 62
Rx/Tx Rate : 130/11
Client Type : PRE-RSNA
Authentication Method : Open System
AKM Method : None
4-Way Handshake State : -NA-
Group Key State : -NA-
Encryption Cipher : Clear
Roam Status : Normal
Roam Count : 0
Up Time (hh:mm:ss) : 00:01:13
-------------------------------------------------------------------------------
Table 2 Command output
Field |
Description |
MAC address |
MAC address of the client. |
User Name |
Username of the client: · The field displays -NA- if the client adopts plaintext authentication or ciphertext authentication with no username. · The field is irrelevant to the portal authentication method. If the client uses the portal authentication method, the field does not display the portal username of the client. |
AID |
Association ID of the client. |
AP Name |
Name of the associated access point. |
Radio ID |
ID of the radio associated with the client. |
SSID |
SSID of the client. |
BSSID |
ID of the BSS. |
Port |
WLAN-DBSS interface associated with the client. |
VLAN |
VLAN to which the client belongs. |
State |
State of the client such as running. Backup indicates a backup client. |
Power Save Mode |
Client's power save mode such as active or sleep. |
Wireless Mode |
Wireless mode such as 802.11a, 802.11b, 802.11g, 802.11gn, 802.11an. |
Channel Band-width |
Channel bandwidth, 20 MHz or 40 MHz. |
SM Power Save Enable |
SM Power Save enables a client to have one antenna in the active state, and others in sleep state to save power. · Enabled—SM Power Save is enabled. · Disabled—SM Power Save is disabled. |
Short GI for 20MHz |
Whether the client supports short GI when its channel bandwidth is 20 MHz. |
Short GI for 40MHz |
Whether the client supports short GI when its channel bandwidth is 40 MHz. |
Support MCS Set |
MCS supported by the client. |
BLOCK ACK-TID 0 |
BLOCK ACK is negotiated based on traffic identifier (TID) 0: · OUT—Outbound direction. · IN—Inbound direction. · BOTH—Both outbound and inbound directions. |
BLOCK ACK-TID 3 |
BLOCK ACK is negotiated based on TID 3: · OUT—Outbound direction. · IN—Inbound direction. · BOTH—Both outbound and inbound directions. |
QoS Mode |
WMM indicates that the WMM function is supported; None indicates that the WMM function is not supported. WMM information negotiation is carried out between an AP and a client that both support WMM. |
Listen Interval |
Number of times the client has woken up to listen to beacon frames. |
RSSI |
Received signal strength indication. This value indicates the client signal strength detected by the AP. |
Rx/Tx Rate |
Represents the receiving and sending rates of the frames such as data, management, and control frames. For the AC + fit AP architecture, there is delay because Rx Rate is transmitted from AP to AC periodically depending on the statistics interval. |
Client Type |
Client type such as WPA2(RSN), WPA, or Pre-RSNA. |
Authentication Method |
Authentication method such as open system or shared key. |
AKM Method |
AKM suite used such as Dot1X or PSK. |
4-Way Handshake State |
Displays either of the 4-way handshake states: · IDLE—Displayed in initial state. · PTKSTART—Displayed when the 4–way handshake is initialized. · PTKNEGOTIATING—Displayed after sending valid message 3. · PTKINITDONE—Displayed when the 4-way handshake is successful. |
Group Key State |
Displays the group key state such as: · IDLE—Displayed in initial state. · REKEYNEGOTIATE—Displayed after the AC sends the initial message to the client. · REKEYESTABLISHED—Displayed when re-keying is successful. |
Encryption Cipher |
Encryption cipher such as clear or crypto. |
Roam Status |
Displays the roam status such as Normal or Fast Roaming. |
Roam Count |
Roaming count of the client, including intra-AC roaming and inter-AC roaming. · For intra-AC roaming, this field is reset after the client is de-associated with the AP connected to the AC. · For inter-AC roaming, this field is reset after the client leaves the mobility group to which the AC belongs. |
Up Time |
Time for which the client has been associated with the AP. |
display wlan country-code
Syntax
display wlan country-code ap { name ap-name | all } [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
name ap-name: Specifies the name of the AP, a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.
all: Displays the country code information of all APs.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display wlan country-code to display the country code information of a specified AP or all APs.
Related commands: country-code.
Examples
# Display the country code information of all APs.
<Sysname> display wlan country-code ap all
Country Code
-------------------------------------------------------------------------------
AP Country Code
-------------------------------------------------------------------------------
ap1 CN China
ap2 US United States
-------------------------------------------------------------------------------
display wlan radio-policy
Syntax
display wlan radio-policy [ radio-policy-name ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
radio-policy-name: Name of a radio policy, a case-insensitive string of 1 to 15 characters which can contain letters, digits and underscores, with spaces excluded.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display wlan radio-policy to display information about a radio policy or all radio policies. The information displayed is in the order of radio-policy name.
Examples
# Display the configuration information for radio policy rp.
<Sysname> display wlan radio-policy rp
Radio Policy Parameters
----------------------------------------------------------------------
Radio Policy Name : rp
Fragmentation Threshold (Bytes) : 2346
Beacon Interval (TU) : 100
RTS Threshold (Bytes) : 2346
DTIM Period (Beacon Interval) : 1
Long Retry Threshold : 4
Short Retry Threshold : 7
Maximum Rx Duration (ms) : 2000
Maximum clients per Radio : 64
----------------------------------------------------------------------
QoS Mode : WMM
Admission Control Policy : Users
Threshold users count : 20
CAC-Free's AC Request Policy : Response Success
CAC Unauthed Frame Policy : Downgrade
CAC Medium Time Limitation(us) : 100000
CAC AC-VO's Max Delay(us) : 50000
CAC AC-VI's Max Delay(us) : 300000
SVP packet mapped AC number : Disabled
Radio's WMM Parameters:
AC-BK AC-BE AC-VI AC-VO
ECWmin 4 4 3 2
ECWmax 10 6 4 3
AIFSN 7 3 1 1
TXOPLimit 0 0 94 47
AckPolicy Normal Normal Normal Normal
Client's WMM Parameters:
AC-BK AC-BE AC-VI AC-VO
ECWmin 4 4 3 2
ECWmax 10 10 4 3
AIFSN 7 3 2 2
TXOPLimit 0 0 94 47
CAC Disable Disable Disable Disable
----------------------------------------------------------------------
# Display the configuration information for all radio policies.
<Sysname> display wlan radio-policy
Radio Policy Parameters
----------------------------------------------------------------------
Radio Policy Name : default_rp
Fragmentation Threshold (Bytes) : 2346
Beacon Interval (TU) : 100
RTS Threshold (Bytes) : 2346
DTIM Period (Beacon Interval) : 1
Long Retry Threshold : 4
Short Retry Threshold : 7
Maximum Rx Duration (ms) : 2000
Maximum clients per Radio : 64
----------------------------------------------------------------------
QoS Mode : WMM
Admission Control Policy : Users
Threshold users count : 20
CAC-Free's AC Request Policy : Response Success
CAC Unauthed Frame Policy : Downgrade
CAC Medium Time Limitation(us) : 100000
CAC AC-VO's Max Delay(us) : 50000
CAC AC-VI's Max Delay(us) : 300000
SVP packet mapped AC number : Disabled
Radio's WMM Parameters:
AC-BK AC-BE AC-VI AC-VO
ECWmin 4 4 3 2
ECWmax 10 6 4 3
AIFSN 7 3 1 1
TXOPLimit 0 0 94 47
AckPolicy Normal Normal Normal Normal
Client's WMM Parameters:
AC-BK AC-BE AC-VI AC-VO
ECWmin 4 4 3 2
ECWmax 10 10 4 3
AIFSN 7 3 2 2
TXOPLimit 0 0 94 47
CAC Disable Disable Disable Disable
--------------------------------------------------------------------------
Radio Policy Parameters
--------------------------------------------------------------------------
Radio Policy Name : radio1
Fragmentation Threshold (Bytes) : 2346
Beacon Interval (TU) : 100
RTS Threshold (Bytes) : 2346
DTIM Period (Beacon Interval) : 1
Long Retry Threshold : 4
Short Retry Threshold : 7
Maximum Rx Duration (ms) : 2000
Maximum clients per Radio : 64
--------------------------------------------------------------------------
QoS Mode : WMM
Admission Control Policy : Channelutilization
Threshold utilization (%) : 70
CAC-Free's AC Request Policy : Response Success
CAC Unauthed Frame Policy : Downgrade
CAC Medium Time Limitation(us) : 100000
CAC AC-VO's Max Delay(us) : 50000
CAC AC-VI's Max Delay(us) : 300000
SVP packet mapped AC number : Disabled
Radio's WMM Parameters:
AC-BK AC-BE AC-VI AC-VO
ECWmin 4 4 3 2
ECWmax 10 6 4 3
AIFSN 7 3 1 1
TXOPLimit 0 0 94 47
AckPolicy Normal Normal Normal Normal
Client's WMM Parameters:
AC-BK AC-BE AC-VI AC-VO
ECWmin 4 4 3 2
ECWmax 10 10 4 3
AIFSN 7 3 2 2
TXOPLimit 0 0 94 47
CAC Disable Disable Disable Disable
--------------------------------------------------------------------------
Table 3 Command output
Field |
Description |
|
Radio Policy Name |
Radio policy name. |
|
Fragmentation Threshold |
Fragmentation threshold. If the length of a packet exceeds the threshold, the packet is fragmented before being transmitted. |
|
Beacon Interval |
Interval for sending beacon frames. |
|
RTS Threshold |
RTS threshold. If the length of a packet received on an AP exceeds the specified RTS threshold, the AP enables the RTS/CTS mechanism. |
|
DTIM Period |
DTIM period in units of beacon intervals. Delivery traffic indication messages (DTIMs) are used to tell whether the buffered multicast packets can be transmitted. |
|
Long Retry Threshold |
Maximum number of retransmission attempts allowed for a frame greater than the RTS threshold. |
|
Short Retry Threshold |
Maximum number of retransmission attempts allowed for a frame shorter than the RTS threshold. |
|
Maximum Rx Duration |
Maximum time that a received packet can stay in the buffer. |
|
Maximum clients per Radio |
Maximum number of clients allowed per radio. |
|
QoS Mode |
WMM indicates that the WMM function is supported; None indicates that the WMM function is not supported. |
|
Admission Control Policy |
Admission control policy. |
|
Threshold users count |
Threshold when the users-based admission policy is applied. |
|
Threshold users utilization (%) |
Threshold when channel utilization-based admission policy is applied. |
|
CAC-Free's AC Request Policy |
Response policy adopted for CAC-incapable ACs. |
|
CAC Unauthed Frame Policy |
Policy of processing frames unauthorized by CAC. |
|
CAC Medium Time Limitation(us) |
Maximum medium time allowed by the CAC policy (in microseconds). |
|
CAC AC-VO's Max Delay(us) |
Maximum voice traffic delay allowed by the CAC policy (in microseconds). |
|
CAC AC-VI's Max Delay(us) |
Maximum video traffic delay allowed by the CAC policy (in microseconds). |
|
SVP packet mapped AC number |
Number of the AC to which SVP packets are mapped. |
|
ECWmin |
ECWmin value (Exponent form of CWmin) |
ECWmin and ECWmax determine the average backoff slots, which increase as the two values increase. For the detailed description of EDCA parameters, see WLAN Configuration Guide. |
ECWmax |
ECWmax value (Exponent form of CWmax). |
|
AIFSN |
AIFSN value. |
|
TXOPLimit |
TXOPLimit value. |
|
AckPolicy |
ACK policy adopted by an AC. |
|
CAC |
Indicates whether an AC is controlled by CAC: Disabled indicates that the AC is not controlled by CAC, Enabled indicates that the AC is controlled by CAC. |
display wlan service-template
Syntax
display wlan service-template [ service-template-number ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
service-template-number: Displays information about the specified service template. The value is in the range of 1 to 1024. If no service template is specified, all service templates are displayed.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display wlan service-template to display WLAN service template information.
Examples
# Display the configuration information for service template 1.
<Sysname> display wlan service-template 1
Service Template Parameters
----------------------------------------------------------------------
Service Template Number : 1
SSID : sharedkey
Binding Interface : WLAN-ESS1
Service Template Type : Crypto
Security IE : Not Configured
Authentication Method : Shared Key
SSID-hide : Disable
Cipher Suite : WEP40
WEP Key Index 1 : WEP40
WEP Key Mode : ASCII
WEP Key : -_'PV5%9O`CQ=^Q`MAF4<1!!
WEP Key Index : 1
TKIP Countermeasure Time(s) : 60
PTK Life Time(s) : 43200
GTK Rekey : Enable
GTK Rekey Method : Time-based
GTK Rekey Time(s) : 86400
Bridge Mode : Remote Forwarding
Service Template Status : Enable
Maximum clients per BSS : 64
--------------------------------------------------------------------------
Table 4 Command output
Field |
Description |
Service Template Number |
Current service template number. |
SSID |
Service set identifier with which the client associates. |
Binding Interface |
Name of the interface bound with the service template. |
Service Template Type |
Service template type crypto or clear. |
Security IE |
Security IE such as WPA and WPA2(RSN). |
Authentication Algorithm |
Type of authentication used. |
SSID-hide |
Enabled or disabled. |
Forwarding Mode |
Forwarding mode, local or remote. |
Cipher Suite |
Cipher suite such as AES-CCMP, TKIP, WEP40, WEP104 or WEP128. |
WEP Key Index |
Key index to encrypt or decrypt frames. |
WEP Key Mode |
WEP key format. · HEX—Hexadecimal string. · ASCII—ASCII character string. |
TKIP Countermeasure Time(s) |
Counter measure time for MIC failure in seconds. |
PTK Life Time(s) |
PTK lifetime in seconds. |
GTK Rekey |
GTK rekey configured. |
GTK Rekey Method |
GTK rekey method configured such as packet based or time based. |
GTK Rekey Time |
Time for GTK rekey in seconds. |
Bridge Mode |
Forwarding mode: · Local forwarding—APs forward client data. · Remote forwarding—The AC forwards client data. |
Service Template Status |
Status such as enabled or disabled. |
Maximum clients per BSS |
Maximum number of associated clients per BSS. |
display wlan statistics ap connect-history
Syntax
display wlan statistics ap { all | name ap-name } connect-history [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
all: Displays the connection statistics of all APs.
name ap-name: Specifies the name of the AP, a case-insensitive string of 1 to 32 characters.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display wlan statistics ap connect-history to display AP connection statistics.
Examples
# Display the connection statistics of AP1.
<sysname> display wlan statistics ap name ap1 connect-history
Connection History
--------------------------------------------------------------------------------
AP Name : ap1
Associations : 120
Reassociations :16
Failures : 3
Rejections : 23
Exceptional Deassociations : 2
Current Associations : 51
Table 5 Command output
Field |
Description |
AP name |
AP name |
Associations |
Total number of associations |
Reassociations |
Total number of reassociations |
Failures |
Total number of failed associations |
Rejections |
Total number of associations rejected |
Exceptional Deassociations |
Total number of exceptional associations |
Current Associations |
Number of current associations |
display wlan statistics client
Syntax
display wlan statistics client { all | mac-address mac-address } [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
client: Displays client statistics.
all: Displays the statistics of all clients.
mac-address mac-address: Displays the statistics of the client with the specified MAC address.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display wlan statistics client to display client statistics.
Examples
# Display the statistics of all the clients.
<Sysname> display wlan statistics client all
Client Statistics
--------------------------------------------------------------------------
AP Name : ap1
Radio Id : 1
SSID : office-1
BSSID : 000f-e2ff-7700
MAC Address : 0014-6c8a-43ff
RSSI : 31
--------------------------------------------------------------------------
Transmitted Frames:
Back Ground (Frames/Bytes) : 0/0
Best Effort (Frames/Bytes) : 9/1230
Video (Frames/Bytes) : 0/0
Voice (Frames/Bytes) : 2/76
Received Frames:
Back Ground (Frames/Bytes) : 0/0
Best Effort (Frames/Bytes) : 18/2437
Video (Frames/Bytes) : 0/0
Voice (Frames/Bytes) : 7/468
Discarded Frames:
Back Ground (Frames/Bytes) : 0/0
Best Effort (Frames/Bytes) : 0/0
Video (Frames/Bytes) : 0/0
Voice (Frames/Bytes) : 5/389
--------------------------------------------------------------------------
Table 6 Command output
Field |
Description |
AP Name |
Access Point name |
Radio Id |
Radio ID |
SSID |
SSID to which the client is associated |
BSSID |
ID of the BSS |
MAC Address |
MAC address of the client |
RSSI |
Received Signal Strength Indicator. It indicates the client signal strength detected by the AP. |
Transmitted Frames |
Transmitted Frames |
Back Ground |
Statistics of background traffic |
Best Effort |
Statistics of best effort traffic |
Video |
Statistics of video traffic |
Voice |
Statistics of voice traffic |
Received Frames |
Received frames |
Discarded Frames |
Discarded frames |
|
NOTE: Statistics for background, best effort, video, and voice traffic are only for QoS-capable clients. For QoS-incapable clients, only best effort traffic statistics are available (including SVP packets) and may be inconsistent with the real physical output queues because the priority-queue statistics can only identify priorities carried in Dot11E and WMM packets. Otherwise, statistics of received packets cannot be collected. |
display wlan statistics radio
Syntax
display wlan statistics radio [ ap ap-name ] [ load ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
radio: Displays radio statistics.
ap ap-name: Displays the radio statistics of an AP. The AP name is a case-insensitive string of 1 to 32 characters that can contain letters, digits, underscores (_), square brackets ([ ]), slashes (/), and hyphens (-), but not spaces. If the ap ap-name option is not specified, the radio statistics of all APs are displayed.
load: Displays the load information.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display wlan statistics radio to display radio statistics.
Use display wlan statistics radio load to display radio load information.
Examples
# Display the radio statistics of AP 1.
<Sysname> display wlan statistics radio ap1
Radio Statistics
-------------------------------------------------------------------------------
AP Name: ap1 Radio Id: 1
-------------------------------------------------------------------------------
Transmitted Frames Statistics:
Total Frames (Frames/Bytes) : 0/0
Unicast Frames (Frames/Bytes) : 0/0
Broadcast/Multicast Frames (Frames/Bytes) : 0/0
Discarded Frames : 0 Failed RTS : 0
Retry Count : 0 Successful RTS : 0
Multiple Retry Count : 0 Failed ACK : 0
Authentication Frames : 0 Association Frames : 0
Packet Count Statistics Based on Size:
128 >= size : 0
128 < size <= 512 : 0
512 < size <= 1024 : 0
1024 < size : 0
Packet Count Statistics Based on Rate:
6 Mbps : 0 9 Mbps : 0
12 Mbps : 0 18 Mbps : 0
24 Mbps : 0 36 Mbps : 0
48 Mbps : 0 54 Mbps : 0
Packet Count Statistics Based on MCS Rate:
6.5 Mbps : 0 13 Mbps : 0
13.5 Mbps : 0 15 Mbps : 0
19.5 Mbps : 0 26 Mbps : 0
27 Mbps : 0 30 Mbps : 0
39 Mbps : 0 40.5 Mbps : 0
45 Mbps : 0 52 Mbps : 0
54 Mbps : 0 58.5 Mbps : 0
60 Mbps : 0 65 Mbps : 0
78 Mbps : 0 81 Mbps : 0
90 Mbps : 0 104 Mbps : 0
108 Mbps : 0 117 Mbps : 0
120 Mbps : 0 121.5 Mbps : 0
130 Mbps : 0 135 Mbps : 0
150 Mbps : 0 162 Mbps : 0
180 Mbps : 0 216 Mbps : 0
240 Mbps : 0 243 Mbps : 0
270 Mbps : 0 300 Mbps : 0
-------------------------------------------------------------------------------
Received Frames Statistics:
Total Frames (Frames/Bytes) : 0/0
Unicast Frames (Frames/Bytes) : 0/0
Broadcast/Multicast Frames (Frames/Bytes) : 0/0
Fragmented Frames : 0 Duplicate Frames : 0
FCS Failures : 0 Decryption Errors : 0
Authentication Frames : 0 Association Frames : 0
Packet Count Statistics Based on Size:
128 >= size : 0
128 < size <= 512 : 0
512 < size <= 1024 : 0
1024 < size : 0
Packet Count Statistics Based on Rate:
6 Mbps : 0 9 Mbps : 0
12 Mbps : 0 18 Mbps : 0
24 Mbps : 0 36 Mbps : 0
48 Mbps : 0 54 Mbps : 0
Packet Count Statistics Based on MCS Rate:
6.5 Mbps : 0 13 Mbps : 0
13.5 Mbps : 0 15 Mbps : 0
19.5 Mbps : 0 26 Mbps : 0
27 Mbps : 0 30 Mbps : 0
39 Mbps : 0 40.5 Mbps : 0
45 Mbps : 0 52 Mbps : 0
54 Mbps : 0 58.5 Mbps : 0
60 Mbps : 0 65 Mbps : 0
78 Mbps : 0 81 Mbps : 0
90 Mbps : 0 104 Mbps : 0
108 Mbps : 0 117 Mbps : 0
120 Mbps : 0 121.5 Mbps : 0
130 Mbps : 0 135 Mbps : 0
150 Mbps : 0 162 Mbps : 0
180 Mbps : 0 216 Mbps : 0
240 Mbps : 0 243 Mbps : 0
270 Mbps : 0 300 Mbps : 0
-------------------------------------------------------------------------------
Table 7 Command output
Field |
Description |
AP name |
Access Point name |
Radio ID |
Radio ID |
Transmitted Frames Statistics |
|
Total Frames |
Number of frames transmitted, including probe responses and beacon frames |
Unicast Frames |
Number of unicast frames transmitted, excluding probe responses |
Broadcast/Multicast Frames |
Number of broadcast or multicast frames transmitted |
Others (Frames/Bytes) |
Number of other frames transmitted |
Discard Frames |
Number of frames discarded. |
Failed RTS |
Number of RTS failed during transmission |
Retry Count |
Number of transmission retries |
Successful RTS |
Number of RTS transmitted successfully |
Multiple Retry Count |
Number of transmission retries |
Failed Ack |
Number of transmitted frames for which no acknowledgement is received |
Authentication Frames |
Number of authentication response frames transmitted |
Association Frames |
Number of association response frames transmitted |
Packet Count Statistics Based on Size |
Packet statistics classified by packet size |
Packet Count Statistics Based on Rate |
Packet statistics classified by rate |
Packet Count Statistics Based on 802.11n Rate |
Packet statistics classified by 802.11n rate. The field is not displayed if the device does not support 802.11n. |
Received Frames Statistics |
|
Total Frames |
Number of fragmented frames received |
Unicast Frames |
Number of unicast frames received |
Broadcast/Multicast Frames |
Number of broadcast or multicast frames received |
Fragmented Frames |
Number of fragmented frames received |
Duplicate Frames |
Number of duplicate frames received |
FCS Failures |
Number of frames dropped due to FCS failure |
Decryption Errors |
Number of frames dropped due to decryption error |
Authentication Frames |
Number of authentication request frames received |
Association Frames |
Number of association request frames received |
# Display the radio load information of all APs.
<sysname> display wlan statistics radio load
Radio Load
--------------------------------------------------------------------------------
AP Name Radio Client Number
--------------------------------------------------------------------------------
ap1 1 0
ap1 2 11
ap2 1 20
ap_chinanet_1 1 5
ap_chinanet_2 2 35
--------------------------------------------------------------------------------
Table 8 Command output
Field |
Description |
AP name |
Access Point name |
Radio ID |
Radio ID |
Client Number |
Number of associated clients |
display wlan statistics service-template
Syntax
display wlan statistics service-template service-template-number [ connect-history ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
service-template-number: Service template number, in the range of 1 to 1024.
connection-history: Displays the connection history.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display wlan statistics service-template to display service template statistics.
Use display wlan statistics service-template service-template-number connect-history to display the connection statistics for all APs bound to the service template.
Examples
# Display the statistics of service template office.
<sysname> display wlan statistics service-template office
Service Template Statistics
--------------------------------------------------------------------------------
Service Template : office
--------------------------------------------------------------------------------
AP Name : ap1
Radio : 1
Receive :
Frame Count : 1713
Frame Bytes : 487061
Data Frame Count : 1683
Data Frame Bytes : 485761
Associate Frame Count : 2
Send :
Frame Count : 62113
Frame Bytes : 25142076
Data Frame Count : 55978
Data Frame Bytes : 22626600
Associate Frame Count : 2
--------------------------------------------------------------------------------
Table 9 Command output
Field |
Description |
Service Template |
Service template number |
AP Name |
AP name |
Receive |
Receive statistics: · Frame Count—Number of frames received · Frame Bytes—Number of bytes received · Data Frame Count—Number of data frames received · Data Frame Bytes—Number of data bytes received · Associate Frame Count—Number of association requests received |
Send |
Send statistics: · Frame Count—Number of frames sent · Frame Bytes—Number of bytes sent · Data Frame Count—Number of data frames sent · Data Frame Bytes—Number of data bytes sent · Associate Frame Count—Number of association requests sent |
# Display the connection history of service template office.
<sysname> display wlan statistics service-template office connect-history
Connect History
--------------------------------------------------------------------------------
Service Template : office
--------------------------------------------------------------------------------
AP Name : ap1
Radio : 1
Associations : 132
Failures : 3
Reassociations : 30
Rejections : 12
Exceptional Deassociations : 2
Current Associations : 57
--------------------------------------------------------------------------------
AP Name : ap1
Radio : 2
Associations : 1004
Failures : 35
Reassociations : 59
Rejections : 4
Exceptional Deassociations : 22
Current Associations : 300
--------------------------------------------------------------------------------
Table 10 Command output
Field |
Description |
Service Template |
Service template number |
AP name |
AP name |
Radio |
Radio number |
Associations |
Total number of associations |
Failures |
Total number of failed associations |
Reassociations |
Total number of reassociations |
Rejections |
Total number of associations rejected |
Exceptional Deassociations |
Total number of exceptional associations |
Current Associations |
Number of current associations |
distance
Syntax
distance distance
undo distance
View
Radio view
Default level
2: System level
Parameters
distance: Specifies the maximum distance that the radio can cover, in the range of 1 to 40 km (0.62 to 24.86 miles).
Description
Use distance to configure the maximum distance that the radio can cover.
Use undo distance to restore the default.
By default, the radio can cover 1 km (0.62 miles) at most.
Examples
# Configure the maximum distance that the radio can cover as 5 km (3.11 miles).
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2100
[Sysname-wlan-ap-ap1] radio 1
[Sysname-wlan-ap-ap1-radio-1] distance 5
dtim
Syntax
dtim counter
undo dtim
View
Radio policy view
Default level
2: System level
Parameters
counter: Number of beacon intervals between delivery traffic indication message (DTIM) transmissions. The value is in the range of 1 to 31.
Description
Use dtim to set the number of beacon intervals an AP waits before it sends buffered multicast and broadcast frames. The AP sends buffered broadcast/multicast frames when the DTIM counter reaches the configured value.
Use undo dtim to restore the default.
By default, the DTIM counter is 1.
Examples
# Set the DTIM counter to 10.
<Sysname> system-view
[Sysname] wlan radio-policy rp
[Sysname-wlan-rp-rp] dtim 10
fast-association enable
Syntax
fast-association enable
undo fast-association enable
View
Service template view
Default level
2: System level
Parameters
None
Description
Use fast-association enable to enable fast association.
Use undo fast-association enable to disable fast association.
By default, fast association is disabled.
When fast association is enabled, the AP does not perform band navigation and load balancing calculations for clients bound to the SSID.
Examples
# Enable fast association.
<Sysname> system-view
[Sysname] wlan service-template 1
[Sysname-wlan-st-1] fast-association enable
fragment-threshold
Syntax
fragment-threshold size
undo fragment-threshold
View
Radio policy view
Default level
2: System level
Parameters
size: Maximum frame length without fragmentation. The value is in the range of 256 to 2346 bytes and must be an even number.
Description
Use fragment-threshold to specify the maximum length of frames that can be transmitted without fragmentation. When the length of a frame exceeds the specified fragment threshold value, it is fragmented.
Use undo fragment-threshold to restore the default value.
By default, the fragment threshold is 2346 bytes. Frames that exceed 2346 bytes are fragmented.
Examples
# Specify the fragment threshold as 2048 bytes.
<Sysname> system-view
[Sysname] wlan radio-policy rp
[Sysname-wlan-rp-rp] fragment-threshold 2048
long-retry threshold
Syntax
long-retry threshold count
undo long-retry threshold
View
Radio policy view
Default level
2: System level
Parameters
count: Number of retransmission attempts for frames larger than the RTS threshold, in the range of 1 to 15.
Description
Use long-retry threshold to set the number of retransmission attempts for frames larger than the RTS threshold.
Use undo long-retry threshold to restore the default.
By default, the long retry threshold is 4.
Examples
# Specify the long-retry threshold as 10.
<Sysname> system-view
[Sysname] wlan radio-policy rp
[Sysname-wlan-rp-rp] long-retry threshold 10
max-power
Syntax
max-power radio-power
undo max-power
View
Radio view
Default level
2: System level
Parameters
radio-power: Maximum radio transmission power, which varies with country codes and radio types. The value depends on the device model.
Description
Use max-power to configure the maximum transmission power on the radio.
Use undo max-power to restore the default.
By default, the maximum radio power varies with country codes, channels, AP models, radio types and antenna types. If 802.11n is adopted, the maximum radio power also depends on the bandwidth mode.
Related commands: wlan country-code and radio type.
Examples
# Specify the max transmission power of radio 1 as 5.
<Sysname> system-view
[Sysname] wlan ap ap3 model WA2100
[Sysname-wlan-ap-ap3] radio 1 type dot11b
[Sysname-wlan-ap-ap3-radio-1] max-power 5
max-rx-duration
Syntax
max-rx-duration interval
undo max-rx-duration
View
Radio policy view
Default level
2: System level
Parameters
interval: Maximum interval for which a frame received by an AP can stay in the buffer memory. The value is in the range of 500 to 250000 milliseconds.
Description
Use max-rx-duration to specify the maximum interval for the AP to hold a received frame.
Use undo max-rx-duration to restore the default.
By default, the max-rx-duration is 2000 milliseconds.
Examples
# Set the max-rx-duration as 5000 milliseconds.
<Sysname> system-view
[Sysname] wlan radio-policy radio1
[Sysname-wlan-rp-radio1] max-rx-duration 5000
nas-id
Syntax
nas-id text
undo nas-id
View
AP template view
Default level
2: System level
Parameters
text: Sets the network access server (NAS)-ID for an AP. It is a case-sensitive string of 1 to 20 characters.
Description
Use nas-id to set the NAS-ID for an AP.
Use undo nas-id to remove the NAS-ID.
By default, no NAS-ID is configured for an AP.
Examples
# Set the NAS-ID for AP 1 to 0002053110000460.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2100
[Sysname-ap-ap1] nas-id 0002053110000460
nas-port-id
Syntax
nas-port-id text
undo nas-port-id
View
AP template view
Default level
2: System level
Parameters
text: Sets the NAS-PORT-ID for an AP. It is a case-sensitive string of 1 to 63 characters.
Description
Use nas-port-id to set the NAS-PORT-ID for an AP.
Use undo nas-port-id to remove the NAS-PORT-ID.
By default, no NAS-PORT-ID is configured for an AP.
Examples
# Set the NAS-PORT-ID for AP 1 to abcd1234.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2100
[Sysname-ap-ap1] nas-port-id abcd1234
power lock
Syntax
power lock
undo power lock
View
Radio view
Default level
2: System level
Parameters
None
Description
Use power lock to lock the current power, and set the current power as the maximum power.
Use undo power lock to unlock the current power, and restore the maximum power set by the max-power command.
By default, the current power is not locked.
If you configure the power lock command first, and then enable power selection, Transmit power control (TPC) does not work because the power is locked. Therefore, before enabling TPC, be sure that the current power is not locked. If you enable TPC, and then configure the power lock command, the last selected power is locked. For more information about TPC, see WLAN Configuration Guide.
Related commands: max-power, dot11a calibrate-power, and dot11bg calibrate-power.
Examples
# Lock the current power.
<Sysname> system-view
[Sysname] wlan ap ap3 model WA2100
[Sysname-wlan-ap-ap3] radio 1 type dot11g
[Sysname-wlan-ap-ap3-radio-1] power lock
preamble
Syntax
preamble { long | short }
undo preamble
View
Radio view
Default level
2: System level
Parameters
long: Indicates that only frames with long preamble can be transmitted.
short: Indicates that frames with either short preamble or long preamble can be transmitted.
Description
Use preamble to specify the preamble type.
Use undo preamble to restore the default.
Preamble is a pattern of bits at the beginning of a frame so that the receiver can sync up and be ready for the real data. There are two different kinds of preambles, short and long.
By default, the short preamble is supported.
|
NOTE: 802.11a and 802.11an do not support this configuration. |
Examples
# Configure the AP to support long preamble.
<Sysname> system-view
[Sysname] wlan ap ap2 model WA2100
[Sysname-wlan-ap-ap2] radio 1 type dot11b
[Sysname-wlan-ap-ap2-radio-1] preamble long
protection-mode
Syntax
protection-mode { cts-to-self | rts-cts }
undo protection-mode
View
Radio policy view
Default level
2: System level
Parameters
cts-to-self: Specifies the Clear to Send (CTS)-to-Self collision avoidance mechanism.
rts-cts: Specifies the Request to Send (RTS)/CTS collision avoidance mechanism.
Description
Use protection-mode to specify a collision avoidance mechanism. When the size of a data frame sent by the AP exceeds the specified threshold, the specified collision avoidance mechanism is used.
Use undo protection-mode to restore the default.
By default, the collision avoidance mechanism is RTS/CTS.
|
NOTE: For more information about CTS-to-Self and RTS/CTS, see WLAN Configuration Guide. |
Examples
# Configure the collision avoidance mechanism as CTS-to-Self.
<Sysname> system-view
[Sysname] wlan radio-policy test
[Sysname-wlan-rp-test] protection-mode cts-to-self
radio
Syntax
radio { disable | enable }
undo radio
View
Radio view
Default level
2: System level
Parameters
disable: Disables the radio.
enable: Enables the radio.
Description
Use radio to enable or disable the radio.
Use undo radio to remove the configuration.
By default, all radios are disabled.
Examples
# Enable radio 1 of the AP.
<Sysname> system-view
[Sysname] wlan ap ap3 model WA2100
[Sysname-wlan-ap-ap3] radio 1 type dot11b
[Sysname-wlan-ap-ap3-radio-1] radio enable
radio type
Syntax
radio radio-number [ type { dot11a | dot11an | dot11b | dot11g | dot11gn } ]
View
AP template view
Default level
2: System level
Parameters
radio-number: Radio number. The radio number value is 1 or 2. The actual value range is based on the AP model.
dot11a: Indicates the wireless radio type is 802.11a.
dot11an: Indicates the wireless radio type is 802.11an (5GHz).
dot11b: Indicates the wireless radio type is 802.11b.
dot11g: Indicates the wireless radio type is 802.11g.
dot11gn: Indicates the wireless radio type is 802.11gn (2.4GHz).
Description
Use radio type to specify the radio type to be used by a radio, and enter radio view.
The default setting varies depending on the AP model.
Examples
# Specify the radio type as 802.11g for radio 1.
<Sysname> system-view
[Sysname] wlan ap ap3 model WA2100
[Sysname-wlan-ap-ap3] radio 1 type dot11g
# Specify the radio type as 802.11an for radio 1.
<sysname> system-view
[sysname] wlan ap ap1 model WA2620-AGN
[sysname-wlan-ap-ap1] radio 1 type dot11an
radio-policy
Syntax
radio-policy radio-policy-name
undo radio-policy
View
Radio view
Default level
2: System level
Parameters
radio-policy-name: Name of the radio policy, a case-insensitive string of 1 to 15 characters that can contain letters, digits and underscores but not spaces.
Description
Use radio-policy to map a radio policy to a radio.
Use undo radio-policy to remove the mapping.
By default, the default_rp radio policy is mapped to a radio. The default_rp radio policy contains all the default parameters.
The radio policy to be bound must have been created with the wlan radio-policy command.
Related commands: display wlan radio-policy and wlan radio-policy.
Examples
# Map radio policy radiorp to radio 1.
<Sysname> system-view
[Sysname] wlan ap ap3 model WA2100
[Sysname-wlan-ap-ap3] radio 1 type dot11b
[Sysname-wlan-ap-ap3-radio-1] radio-policy radiorp
reset wlan client
Syntax
reset wlan client { all | mac-address mac-address }
View
User view
Default level
2: System level
Parameters
all: Terminates connections of all clients to the AP.
mac address mac-address: Specifies the MAC address of the client whose connection to the AP is to be terminated.
Description
Use reset wlan client to terminate connections of a client or all clients to the AP. When this command is used, the AP sends a de-authentication frame to the client and the client is removed from the WLAN service.
Examples
# Terminate the connection of the client with MAC address 000f-e2cc-8501 to the AP.
<Sysname> reset wlan client mac-address 000f-e2cc-8501
reset wlan statistics
Syntax
reset wlan statistics { client { all | mac-address mac-address } | radio [ ap-name ] }
View
User view
Default level
2: System level
Parameters
all: Clears the statistics of all clients.
mac-address mac-address: Clears the statistics of the client.
ap-name: Clears the radio statistics of an AP. The AP name is a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.
Description
Use reset wlan statistics to clear statistics of the specified AP or client, or all clients.
Examples
# Clear the radio statistics of AP1.
<Sysname> reset wlan statistics radio ap1
rts-threshold
Syntax
rts-threshold size
undo rts-threshold
View
Radio policy view
Default level
2: System level
Parameters
size: Length of frames for which the request to send (RTS) mechanism is used. The value is in the range of 0 to 2346 bytes.
Description
Use rts-threshold to specify the RTS threshold length. If a frame is larger than this value, the RTS mechanism is used.
Use undo rts-threshold to restore the default.
By default, the RTS threshold is 2346 bytes.
RTS is used to avoid data collisions in a WLAN.
A small value causes RTS packets to be sent more often, consuming more of the available bandwidth. However, the more often RTS packets are sent, the quicker the system can recover from interference or collisions.
Examples
# Specify the RTS threshold as 2046 bytes.
<Sysname> system-view
[Sysname] wlan radio-policy rp
[Sysname-wlan-rp-rp] rts-threshold 2046
service-template (radio view)
Syntax
service-template service-template-number [ vlan-id vlan-id1 [ vlan-id2 ] ] [ nas-port-id nas-port-id | nas-id nas-id ] [ ssid-hide ]
undo service-template service-template-number
View
Radio view
Default level
2: System level
Parameters
service-template-number: Number of a service template in the range of 1 to 1024.
vlan-id vlan-id1 vlan-id2: Sets the ID of a VLAN to be bound, in the range of 1 to 1024. You can select two VLANs for QinQ application.
nas-port-id nas-port-id: Sets the ID of the NAS port to be bound. The ID is a case-insensitive string of 1 to 63 characters, without spaces.
nas-id nas-id: Sets the ID of the NAS to be bound. The ID is a case-insensitive string of 1 to 20 characters, without spaces.
ssid-hide: Sets to hide the SSID in beacon frames for the service bound to the AP. If you do not specify this keyword, whether the SSID is hidden or not depends on the beacon ssid-hide command.
Description
Use service-template to map a service template to the current radio.
Use undo service-template to remove the mapping.
By default, no service template is mapped to a radio.
You can map multiple service templates to a radio.
Examples
# Map service template 1 to radio 1.
<Sysname> system-view
[Sysname] wlan ap ap3 model WA2100
[Sysname-wlan-ap-ap3] radio 1
[Sysname-wlan-ap-ap3-radio-1] service-template 1
service-template (service template view)
Syntax
service-template { disable | enable }
undo service-template enable
View
Service template view
Default level
2: System level
Parameters
disable: Disables the service template.
enable: Enables the service template.
Description
Use service-template enable to enable the service template.
Use service-template disable or undo service-template enable to disable the service template.
By default, the service template is disabled.
Examples
# Enable service template 1.
<Sysname> system-view
[Sysname] wlan service-template 1 clear
[Sysname-wlan-st-1] ssid clear
[Sysname-wlan-st-1] bind wlan-ess 1
[Sysname-wlan-st-1] authentication-method open-system
[Sysname-wlan-st-1] service-template enable
short-gi enable
Syntax
short-gi enable
undo short-gi enable
View
Radio view
Default level
2: System level
Parameters
None
Description
Use short-gi enable to enable the short GI function.
Use undo short-gi enable to disable the short GI function.
By default, the short GI function is enabled.
This command is only effective on 802.11n radios.
If you change the radio type of an 802.11n radio, the default setting for this function of the new radio type is restored.
Delays may occur during receiving radio signals due to factors like multi-path reception. Therefore, a subsequently sent frame may interfere with a previously sent frame. The GI function is used to avoid such interference.
The GI interval in 802.11a/g is 800 us. The short GI function can be configured for 802.11n. This can shorten the GI interval to 400 ns, which increases the data speed by 10 percent.
Examples
# Disable the short GI function.
<sysname> system-view
[sysname] wlan ap ap3 model WA2620-AGN
[sysname-wlan-ap-ap3] radio 1 type dot11an
[sysname-wlan-ap-ap3-radio-1] undo short-gi enable
short-retry threshold
Syntax
short-retry threshold count
undo short-retry threshold
View
Radio policy view
Default level
2: System level
Parameters
count: Number of times the AP can send a short unicast frame (less than the RTS threshold) if no acknowledgment is received for it. The value is in the range of 1 to 15.
Description
Use short-retry threshold to specify the maximum number of attempts to transmit a frame less than the RTS threshold.
Use undo short-retry threshold to restore the default.
By default, the short retry threshold is 7.
Examples
# Specify the short retry threshold as 10.
<Sysname> system-view
[Sysname] wlan radio-policy rp
[Sysname-wlan-rp-rp] short-retry threshold 10
shut-all-led enable
Syntax
shut-all-led enable
undo shut-all-led enable
View
AP template view
Default level
2: System level
Parameters
None
Description
Use shut-all-led enable to shut down all LEDs on all the online APs of the current AP template.
Use undo shut-all-led enable to restore the default.
By default, all LEDs on all the online APs of the current AP template light based on AP status.
Examples
# Shut down all LEDs on all the online APs of AP template ap5.
<Sysname>system-view
[Sysname]wlan ap ap5 model WA2620-AGN
[Sysname-wlan-ap-ap5]shut-all-led enable
ssid
Syntax
ssid ssid-name
undo ssid
View
Service template view
Default level
2: System level
Parameters
ssid-name: Name of the service set identifier, a case-sensitive string of 1 to 32 characters that can contain letters, digits, underlines, and spaces.
Description
Use ssid to set the SSID for the current service template.
Use undo ssid to remove the SSID.
By default, no SSID is set for the service template.
An SSID must be as unique as possible. For security, the company name must not be contained in the SSID. Meanwhile, it is not recommended to use a long random string as the SSID, because a long random string only adds payload to the header field, without any improvement to wireless security.
Examples
# Set the SSID as firstfloor for service template 1.
<Sysname> system-view
[Sysname] wlan service-template 1 clear
[Sysname-wlan-st-1] ssid firstfloor
trap enable
Syntax
trap enable
undo trap enable
View
AP template view
Default level
2: System level
Parameters
None
Description
Use trap enable to enable traps for the AP.
Use undo trap enable to disable traps for the AP.
By default, traps are disabled.
Examples
# Enable traps for the AP.
<AC>system-view
[AC]wlan ap ap2 model WA2610-AGN id 2
[AC-wlan-ap-ap2] trap enable
[AC-wlan-ap-ap2]device-detection enable
[AC-wlan-ap-ap2]
#Nov 19 14:10:30:003 2009 H3C WMAC/4/AP WorkMode Changed: Work mode of AP change
d:1.3.6.1.4.1.2011.10.2.75.2.3.0.1<h3cDot11APMtWorkModeChgTrap> Serial ID:210235
A35XB09B000008 WorkMode: 3
wlan country-code
Syntax
wlan country-code code
undo wlan country-code
View
System view
Default level
2: System level
Parameters
code: Specifies a global country code. See Table 11.
Table 11 Country code information
Country |
Code |
Country |
Code |
Andorra |
AD |
Korea, Republic of Korea |
KR |
United Arab Emirates |
AE |
Kenya |
KE |
Albania |
AL |
Kuwait |
KW |
Armenia |
AM |
Kazakhstan |
KZ |
Australia |
AU |
Lebanon |
LB |
Argentina |
AR |
Liechtenstein |
LI |
Australia |
AT |
Sri Lanka |
LK |
Azerbaijan |
AZ |
Lithuania |
LT |
Bosnia and Herzegovina |
BA |
Luxembourg |
LU |
Belgium |
BE |
Latvia |
LV |
Bulgaria |
BG |
Libyan |
LY |
Bahrain |
BH |
Morocco |
MA |
Brunei Darussalam |
BN |
Monaco |
MC |
Bolivia |
BO |
Moldova |
MD |
Brazil |
BR |
Macedonia |
MK |
Bahamas |
BS |
Macau |
MO |
Belarus |
BY |
Martinique |
MQ |
Belize |
BZ |
Malta |
MT |
Canada |
CA |
Mauritius |
MU |
Switzerland |
CH |
Mexico |
MX |
Cote d'ivoire |
CI |
Malay Archipelago |
MY |
Chile |
CL |
Namibia |
NA |
China |
CN |
Nigeria |
NG |
Colombia |
CO |
Nicaragua |
NI |
Costarica |
CR |
Netherlands |
NL |
Serbia |
RS |
Norway |
NO |
Cyprus |
CY |
New Zealand |
NZ |
Czech Republic |
CZ |
Oman |
OM |
Germany |
DE |
Panama |
PA |
Denmark |
DK |
Peru |
PE |
Dominica |
DO |
Poland |
PL |
Algeria |
DZ |
Philippines |
PH |
Ecuador |
EC |
Pakistan |
PK |
Estonia |
EE |
Puerto Rico |
PR |
Egypt |
EG |
Portugal |
PT |
Spain |
ES |
Paraguay |
PY |
Faroe Islands |
FO |
Qatar |
QA |
Finland |
FI |
Romania |
RO |
France |
FR |
Russian Federation |
RU |
Britain |
GB |
Saudi Arabia |
SA |
Georgia |
GE |
Sweden |
SE |
Gibraltar |
GI |
Singapore |
SG |
Greenland |
GL |
Slovenia |
SI |
Guadeloupe |
GP |
Slovak |
SK |
Greece |
GR |
San Marino |
SM |
Guatemala |
GT |
Salvador |
SV |
Guyana |
GY |
Syrian |
SY |
Honduras |
HN |
Thailand |
TH |
Hong Kong |
HK |
Tunisia |
TN |
Croatia |
HR |
Turkey |
TR |
Hungary |
HU |
Trinidad and Tobago |
TT |
Iceland |
IS |
, Province of China |
TW |
India |
IN |
Ukraine |
UA |
Indonesia |
ID |
United States of America |
US |
Ireland |
IE |
Uruguay |
UY |
Israel |
IL |
Uzbekistan |
UZ |
Iraq |
IQ |
The Vatican City State |
VA |
Italy |
IT |
Venezuela |
VE |
Iran |
IR |
Virgin Islands |
VI |
Jamaica |
JM |
Vietnam |
VN |
Jordan |
JO |
Yemen |
YE |
Japan |
JP |
South Africa |
ZA |
Democratic People's Republic of Korea |
KP |
Zimbabwe |
ZW |
Description
Use wlan country-code to specify the global country code.
Use undo wlan country-code to restore the default.
By default, the global country code is CN.
|
NOTE: · The country code determines characteristics such as the power level, total number of channels. You must set the correct country code or area code for a WLAN device (AC or AP). · If an AP is configured with a country code in AP template view or has a fixed country code, changing the global country code does not affect the country code of the AP. |
Related commands: country-code.
Examples
# Specify the country code as US.
<Sysname> system-view
[Sysname] wlan country-code us
wlan link-test
Syntax
wlan link-test mac-address
View
User view
Default level
1: Monitor level
Parameters
mac-address: MAC address of a client. Only clients that have been associated with the AP can be RFPinged.
Description
Use wlan link-test to RFPing a client.
Examples
# Perform an RFPing operation to the client with the MAC address 000f-e201-0101.
<Sysname> wlan link-test 000f-e201-0101
Testing link to 000f-e201-0101, press CTRL_C to break......
Link Status
RTT: Round trip time
--------------------------------------------------------------------------------
MAC Address: 000f-e201-0101
--------------------------------------------------------------------------------
No. Rate(Mbps) TxCnt RxCnt RSSI Retries RTT(ms)
--------------------------------------------------------------------------------
0 1 5 2 62 0 0
1 2 5 5 10 0 0
2 5.5 5 5 10 0 1
3 6 5 5 10 0 0
4 9 5 5 11 0 0
5 11 5 5 11 0 0
6 12 5 5 10 0 0
7 18 5 5 10 0 0
8 24 5 5 11 0 0
9 36 5 5 11 0 0
10 48 5 5 10 0 0
11 54 5 5 11 0 0
Table 12 RFPing operation results
Field |
Description |
No./MCS |
· The No. field is displayed for an RFPing operation to a non 802.11n client, indicating the rate index of the client. · The MCS field is displayed for an RFPing operation to an 802.11n client, indicating the MCS value of the client. |
Rate(Mbps) |
Rate for the radio interface to send ping packets |
TxCnt |
Number of ping packets sent by the radio interface |
RxCnt |
Number of ping packets received by the radio interface from the client |
RSSI |
Received signal strength indicator (RSSI), |
Retries |
Number of retries when the radio interface failed to send ping packets |
RTT(ms) |
Round-trip time (RTT) from the time when the radio interface send a ping packet to the time when it receives a response from the client |
wlan radio
Syntax
wlan radio { disable | enable } { all | dot11a | dot11an | dot11b | dot11g | dot11gn | radio-policy radio-policy-name }
View
System view
Default level
2: System level
Parameters
disable: Disables WLAN radios.
enable: Enables WLAN radios.
all: Enables or disables all the WLAN radios.
dot11a: Enables or disables 802.11a WLAN radios.
dot11an: Enables or disables 802.11an WLAN radios.
dot11b: Enables or disables 802.11b WLAN radios.
dot11g: Enables or disables 802.11g WLAN radios.
dot11gn: Enables or disables 802.11gn WLAN radios.
radio-policy radio-policy-name: Specifies a radio policy, a case-insensitive string of 1 to 15 characters that can contain letters, digits and underscores but not spaces.
Description
Use wlan radio enable to enable WLAN radios.
Use wlan radio disable to disable WLAN radios.
By default, no wlan radio is enabled.
Examples
# Enable all the radios.
<Sysname> system-view
[Sysname] wlan radio enable all
# Enable 802.11g radios.
<Sysname> system-view
[Sysname] wlan radio enable dot11g
wlan radio-policy
Syntax
wlan radio-policy radio-policy-name
undo wlan radio-policy radio-policy-name
View
System view
Default level
2: System level
Parameters
radio-policy-name: Name of a radio policy, a case-insensitive string of 1 to 15 characters that can contain letters, digits and underlines but not spaces.
Description
Use wlan radio-policy to create a radio policy, or enter radio policy view, or both. A radio policy is a set of radio attributes. If the radio policy is mapped to a radio, the radio will have all the attributes configured in the radio policy.
A WLAN radio policy includes the following attributes:
· Radio policy name
· Fragmentation threshold (Bytes)
· Beacon interval (TU)
· RTS threshold (Bytes)
· DTIM period (Beacon Intervals)
· Long retry threshold
· Short retry threshold
· Maximum Rx duration (ms)
· Maximum Tx duration (ms)
· The maximum duration that the frames received by the AP can be kept in the buffer (ms)
Use undo wlan radio-policy to delete the radio policy, and all related configurations.
If the radio-policy is mapped with a radio, it cannot be directly deleted before it is un-mapped.
By default, the default radio policy default_rp is mapped with a WLAN radio.
Examples
# Create a radio policy named radio1.
<Sysname> system-view
[Sysname] wlan radio-policy radio1
[Sysname-wlan-rp-radio1]
wlan radio-policy auto-create
Syntax
wlan radio-policy auto-create
undo wlan radio-policy auto-create
View
System view
Default level
2: System level
Description
Use wlan radio-policy auto-create to enable automatic creation of radio policies.
Use undo wlan radio-policy auto-create to disable automatic creation of radio policies.
By default, automatic creation of radio policies is disabled.
Examples
# Enable automatic creation of radio policies.
<Sysname> system-view
[Sysname] wlan radio-policy auto-create
# Disable automatic creation of radio policies.
<Sysname> system-view
[Sysname] undo wlan radio-policy auto-create
wlan service-template
Syntax
wlan service-template service-template-number { clear | crypto }
undo wlan service-template service-template-number
View
System view
Default level
2: System level
Parameters
service-template-number: Number of the service template, in the range of 1 to 1024.
clear: Sets the current service template type to clear, which means data is sent in clear text after the template is mapped to an AP.
crypto: Sets the current service template type to crypto, which means data is sent in cipher text after the template is mapped to an AP.
Description
Use wlan service-template to create a service template and enter service template view. If the service template exists, then you can directly enter service template view.
Use undo wlan service-template to delete the service template. If the specified service template is mapped to a radio, it cannot be directly deleted before it is un-mapped.
No service template is configured by default.
You cannot change an existing service template to another type. To do so, you must delete the service template, and configure a new service template with the new type.
Examples
# Create service template 1.
<Sysname> system-view
[Sysname] wlan service-template 1 crypto
AC-AP tunnel configuration commands
ac
ac { host-name host-name | ip ip-address | ipv6 ipv6-address }
undo ac { host-name | ip { ip-address | all } | ipv6 { ipv6-address | all } }
View
AP configuration view
Default level
2: System level
Parameters
host-name host-name: Specifies the host name of an AC, a case-insensitive string of 1 to 255 characters. The string can contain letters, digits, "-", "_" and ".", and must contain at least one letter.
ip ip-address: Specifies the IPv4 address of an AC.
ipv6 ipv6-address: Specifies the IPv6 address of an AC.
all: Removes the IPv4/IPv6 addresses of all ACs.
Description
Use ac to specify an AC so that the AP can discover the AC.
Use undo ac to remove the AC configuration.
By default, no AC is specified for the AP.
You can specify at most three ACs' IP addresses, three ACs' IPv6 addresses, and an AC's host name for the AP.
The wlan ap-provision ac command takes effect for all APs, and the ac command in AP configuration view takes effect for the specified AP. If you configure both commands, the configuration in AP configuration view takes effect for the AP.
Related commands: wlan ap-provision ac.
Examples
# Specify the AC 192.168.100.11 so that AP 1 can discover the AC.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2100
[Sysname-wlan-ap-ap1] provision
[Sysname-wlan-ap-ap1-prvs] ac ip 192.168.100.11
ap-name
Syntax
ap-name name
undo ap-name
View
AP template view
Default level
2: System level
Parameters
name: AP name, a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces..
Description
Use ap-name to specify the name for the AP.
Use undo ap-name to clear the name of the AP.
By default, no AP name is specified.
Examples
# Set the name for an AP as admin.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2100
[Sysname-ap-ap1] ap-name admin
backup-ac
Syntax
backup-ac { ip ipv4-address | ipv6 ipv6-address }
undo backup-ac { ip | ipv6 }
View
AP template view
View
System view
Default level
2: System level
Parameters
ipv4-address: Specifies an IPv4 address for a backup AC.
Ipv6-address: Specifies an IPv6 address for a backup AC.
Description
Use backup-ac to specify an IPv4/IPv6 backup AC.
Use undo backup-ac to remove the IPv4/IPv6 backup ACs.
By default, the global backup AC, if specified, is used by the AP.
The backup AC configured in AP template view takes precedence over that configured in system view.
Examples
# Specify the backup AC at 192.168.1.2 for AP 1.
<Sysname> system-view
[Sysname] wlan backup-ac ip 192.168.1.1
[Sysname] wlan ap ap1 model WA2100
[Sysname-wlan-ap-ap1] backup-ac ip 192.168.1.2
cir
Syntax
cir committed-information-rate [ cbs committed-burst-size ]
undo cir
View
AP template view
Default level
2: System level
Parameters
cir committed-information-rate: Committed information rate in kbps, in the range of 40 to 1000000.
cbs committed-burst-size: Committed burst size in bytes, in the range of 2500 to 62500000. By default, the CBS is the number of bytes transmitted in 500 ms at the rate of CIR.
Description
Use cir to set the CIR for packets sent from AC to AP.
Use undo cir to restore the default.
By default, no CIR is set for an AP.
For more information about CIR, see ACL and QoS Command Reference.
Examples
# Set the CIR to 60 kbps, and CBS to 3000 bytes for the AP.
<Sysname> system-view
[Sysname] wlan ap ap_001 model wa2100
[Sysname-wlan-ap-ap_001] cir 60 cbs 3000
cpu-usage threshold
Syntax
cpu-usage threshold integer
View
AP template view
Default level
3: Manage level
Parameters
integer: An integer in the range of 0 to 100.
Description
Use cpu-usage threshold to set the CPU usage threshold of the AP. If the CPU usage of the AP exceeds the threshold, the AP generates an alarm.
By default, the default CPU usage threshold of the AP is 90.
Examples
# Set the CPU usage threshold of AP 3 to 95.
[Sysname] wlan ap ap3 model WA2100
[Sysname-wlan-ap-ap3] cpu-usage threshold 95
data-tunnel encryption enable
Syntax
data-tunnel encryption enable
undo data-tunnel encryption enable
View
AP configuration view
Default level
2: System level
Parameters
None
Description
Use data-tunnel encryption enable to configure the AP to use IPsec to encrypt the data tunnel.
Use undo data-tunnel encryption enable to remove the configuration.
By default, the AP does not encrypt the data tunnel.
Related commands: tunnel encryption ipsec pre-shared-key.
Examples
# Configure the AP to use IPsec to encrypt the data tunnel.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2620-AGN
[Sysname-wlan-ap-ap1] provision
[Sysname-wlan-ap-ap1-prvs] tunnel encryption ipsec pre-shared-key simple 12345
[Sysname-wlan-ap-ap1-prvs] data-tunnel encryption enable
description
Syntax
description text
undo description
View
AP template view
Default level
2: System level
Parameters
text: Description for the AP, a string of 1 to 64 characters. A description string can be entered in uppercase as well as lower case and can have special characters and spaces, but spaces at the beginning and end of the description string are discarded if given.
Description
Use description to set a description for an AP.
Use undo description to clear the description of an AP.
By default, no description is set for an AP.
Examples
# Set a description for an AP.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2100
[Sysname-ap-ap1] description L3-office
display wlan ap
Syntax
display wlan ap { all | name ap-name } [ verbose ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
all: Displays the information of all the APs.
name ap-name: Displays information about the AP. An AP name is a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.
verbose: Displays the detailed information.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display wlan ap to display the information of a specified AP or all APs.
Examples
# Display the configuration information of AP1.
<Sysname> display wlan ap name ap1
AP Profile
State : I = Idle, J = Join, JA = JoinAck, IL = ImageLoad
C = Config, R = Run, KU = KeyUpdate, KC = KeyCfm
--------------------------------------------------------------------------------
AP Name State Model Serial-ID
--------------------------------------------------------------------------------
ap R/M WA2620-AGN 210235A35V0088000005
-------------------------------------------------------------------------------
Table 13 Command output
Field |
Description |
State |
Current state of the AP: · Idle—Idle · J—Join · JA—Join acknowledge · IL—The AP is downloading the version. · C—Configuration exchange. This state is an instantaneous state. It indicates that the AC is delivering configuration file to the fit AP, and the fit AP is collecting radio information through the radio interface and reporting to the AC. · R—The AP is operating. It indicates that the AP has associated with the AC. This field also indicates the active/standby state of the AC. Run/M indicates the AC is an active AC, and Run/B indicates the AC is a standby AC. · KU—Key update · KC—Key update confirm |
# Display the detailed configuration information of AP1.
<Sysname> display wlan ap name ap1 verbose
AP Profile: ap1
-------------------------------------------------------------------------------
APID : 1
AP System Name : Not Configured
Map Configuration : Not Configured
State : Run
Up Time(hh:mm:ss) : 00:01:04
Model : WA2620-AGN
Serial-ID : 210235A35V0088000005
IP Address : 192.168.100.99
H/W Version : Ver.A
S/W Version : V100R001B96D001
Boot-Rom Version : 1.20
Description : Not Configured
Connection Type : Master
Peer AC MAC Address : -NA-
Priority Level : 4
Echo Interval(s) : 10
Statistics report Interval(s) : 50
Cir(Kbps) : -NA-
Cbs(Bytes) : -NA-
Jumboframe Threshold : Disable
Transmitted control packets : 372
Received control packets : 372
Transmitted data packets : 104
Received data packets : 370
Configuration Failure Count : 0
Last Failure Reason :
Last Reboot Reason : Tunnel Initiated
Latest IP Address : 192.168.100.99
Tunnel Down Reason : Neighbor Dead Timer Expire
Connection Count : 3
-------------------------------------------------------------------------------
AP Mode : Split
AP operation mode : Normal
Portal Service : Disable
Device Detection : Disable
Maximum Number of Radios : 2
Current Number of Radios : 2
Client Keep-alive Interval : Disable
Client Idle Interval(s) : 3600
Broadcast-probe Reply Status : Enable
Radio 1:
Basic BSSID : 000f-e233-9000
Current BSS Count : 1
Running Clients Count : 0
Wireless Mode : 11an
Client Dot11n-only : Disabled
Channel Band-width : 20/40MHz
Secondary Channel Offset : SCA
HT Protection Mode : no protection
Short GI for 20MHz : Not supported
Short GI for 40MHz : Supported
Mandatory MCS Set :
Support MCS Set : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
A-MSDU : Enabled
A-MPDU : Enabled
Configured Channel : auto<149>
Configured Power (dBm) : 24
Interference (%) : -NA-
Channel Load (%) : -NA-
Utilization (%) : -NA-
Co-channel Neighbor Count : -NA-
Channel Health : -NA-
Radio Policy : 257
Service Template : 1
SSID : office
Port : WLAN-DBSS0:6
Mesh Policy : default_mp_plcy
ANI Support : Enable
Admin State : UP
Physical State : UP
Operational Rates (Mbps):
6 : mandatory
9 : supported
12 : mandatory
18 : supported
24 : mandatory
36 : supported
48 : supported
54 : supported
Radar detected Channels : None
Antenna Type : TLB-5000-2HW 2dBi Omni Antenna
Resource Using Ratio (%) : 0
Noise Floor (dBm) : 0
Radio 2:
Basic BSSID : 000f-e233-9010
Current BSS Count : 1
Running Clients Count : 1
Wireless Mode : 11gn
Client Dot11n-only : Disabled
Channel Band-width : 20MHz
Secondary Channel Offset : SCN
HT Protection Mode : no protection
Short GI for 20MHz : Not supported
Short GI for 40MHz : Not supported
Mandatory MCS Set :
Support MCS Set : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
A-MSDU : Enabled
A-MPDU : Enabled
Configured Channel : auto<11>
Configured Power (dBm) : 19
Interference (%) : -NA-
Channel Load (%) : -NA-
Utilization (%) : -NA-
Co-channel Neighbor Count : -NA-
Channel Health : -NA-
Preamble Type : short
Radio Policy : 258
Service Template : 1
SSID : office
Port : WLAN-DBSS0:7
Mesh Policy : default_mp_plcy
ANI Support : Enable
11g Protection : Disable
Admin State : UP
Physical State : UP
Operational Rates (Mbps):
1 : mandatory
2 : mandatory
5.5 : mandatory
6 : supported
9 : supported
11 : mandatory
12 : supported
18 : supported
24 : supported
36 : supported
48 : supported
54 : supported
Radar detected Channels : None
Antenna Type : TLB-2400-2HW 2dBi Omni Antenna
Resource Using Ratio (%) : 0
Noise Floor (dBm) : 0
----------------------------------------------------------------------------
Table 14 Command output
Field |
Description |
AP System Name |
Access point name |
Map Configuration |
Configuration file mapped to the AP |
State |
Current state of the AP: · ImageDownload—The AP is downloading the version. If the ImageDownload state persists, check the following: 1) The version of the fit AP saved on the AC matches with the version that the AC requires; 2) The space of the flash is enough. · Idle—The AP is idle. If the Idle state persists, check the following: 1) If the fields of Latest IP Address and Tunnel Down Reason are displayed as -NA-, it indicates that the AP has never connected to the AC successfully. You must check the network cable, power supply of the fit AP, and the AP serial number if the serial number was manually input. 2) If the fields of Latest IP Address and Tunnel Down Reason are displayed as other contents, it indicates that the AP has connected to the AC successfully. See the output of the Tunnel Down Reason field for the detailed reason. · Run—The AP is operating. It indicates that the AP has connected to the AC successfully. · Config—The AC is delivering configuration file to the fit AP, and the fit AP is collecting radio information through the radio interface and reporting to the AC. This state is an instantaneous state. |
Up Time |
Time duration for which the AP has been connected to the AC. NA indicates no AP is connected to the AC. |
Model |
AP Model name |
Serial-ID |
Serial ID of the AP |
IP Address |
IP address of the AP |
H/W Version |
Hardware version of the AP |
S/W Version |
Software version of the AP |
Boot-Rom version |
Boot ROM version of the AP. |
Description |
Description of the AP |
Connection Type |
AP connection type: "Master" or "Backup" |
Peer AC MAC Address |
Peer AC MAC address when dual-AC mode is adopted |
Priority Level |
AP connection priority |
Echo Interval |
Interval for sending echo requests in seconds |
Statistics report Interval |
Interval for sending statistics information messages |
Configuration Failure Count |
Count of configuration request message failures |
Last Failure Reason |
Last configuration request failure reason |
Last Reboot Reason |
Last reboot reason of the AP: · Normal—The AP was powered off. · Crash—The AP crashed, and the information is needed for analysis. · Tunnel Initiated—The reset wlan ap command is executed on the AC (the Tunnel Down Reason is displayed as Reset AP). · Tunnel Link Failure—The fit AP rebooted abnormally because an error occurred when the AP was establishing a connection with the AC. |
Latest IP Address |
IP address of the last AP |
Tunnel Down Reason |
The CAPWAP tunnel between the AC and the AP is down when one of the following occurs: · Neighbor Dead Timer Expire—The AC does not receive an Echo request from the AP within three times the handshake interval. · Response Timer Expire—The AC sends a control packet to the AP but does not receive any response within the specified waiting time. · Reset AP—The AP is rebooted by the execution of a command on the AC. · AP Config Change—The corresponding configurations are modified on the AC. · No Reason—Other reasons. |
Connection Count |
Connection count between the AP and AC. This field is reset in one of the following situations: · The AC is rebooted. · You re-configure an AP template after deleting the old one. The reset wlan ap command does not reset the connection count. |
AP Mode |
Mode supported by the AP. Currently only the split MAC mode is supported. |
AP operation mode |
Operation mode of AP. Currently Normal and Monitor modes are supported. |
Device Detection |
Whether device detection is enabled or not. |
Maximum Number of Radios |
Maximum number of radios supported by the AP. |
Current Number of Radios |
Number of radios in use on the AP. |
Client Keep-alive Interval |
Interval to detect clients segregated from the system due to various reasons such as power failure or crash, and disconnect them from the AP |
Client Idle Interval(s) |
If the client is idle for more than the specified interval, or, if the AP does not receive any data from the client within the specified interval, the client is removed from the network. |
Broadcast-probe Reply Status |
Whether the AP is enabled to respond to broadcast probe requests or not. |
Basic BSSID |
MAC address of the radio |
Current BSS Count |
Number of BSSs present in the radio |
Running Clients Count |
Number of running clients. If wireless mode is 11g, it displays the count of 11b stations and count of 11g stations |
Wireless Mode |
Wireless mode such as 802.11a, 802.11b, 802.11g, 802.11gn, 802.11an |
Client Dot11n-only |
· Enabled—Only 802.11n clients can be associated with the AP. · Disabled—802.11a/b/g/n clients can be associated with the AP. |
Secondary channel offset |
Secondary channel information for 802.11n radio mode: · SCA (Second Channel Above)—The AP operates in 40 MHz bandwidth mode, and the secondary channel is above the primary channel. · SCB (Second Channel Below)—The AP operates in 40 MHz bandwidth mode, and the secondary channel is above the primary channel. · SCN—The AP operates in 20 MHz bandwidth mode. |
HT protection mode |
802.11n protection modes: · no protection mode(0)—The clients associated with the AP, and the wireless devices within the coverage of the AP operate in 802.11n mode, and all the clients associated with the AP operate in either 40 MHz or 20 MHz mode. · Non-member mode(1)—The clients associated with the AP operate in 802.11n mode, but non-802.11n wireless devices exist within the coverage of the AP, · 20 MHz mode(2)—The radio mode of the AP is 40 MHz. The clients associated with the AP and the wireless devices within the coverage of the AP operate in 802.11n mode, and at least one 802.11n client operating in 20 MHz mode is associated with the radio of the AP. · Non-HT mix mode(3)—All situations except the above three. |
Short GI for 20MHz |
Whether the AP supports short GI when it operates in 20 MHz mode. |
Short GI for 40MHz |
Whether the AP supports short GI when it operates in 40 MHz mode. |
Mandatory MCS Set |
Mandatory MCS set for the AP |
Supported MCS Set |
Supported MCS set for the AP |
Configured Channel |
Operating channel: · If the channel is manually configured, the configured channel number is displayed. · If the channel is automatically selected, auto(channel) is displayed, where channel is the optimal channel automatically selected by the AC. |
Configured Power (dBm) |
Transmission power on the radio. |
Interference |
Interference observed on the operating channel in percentage |
Channel Load |
Load observed on the operating channel in percentage |
Utilization |
Utilization rate of the operating channel in percentage |
Co-channel Neighbor Count |
Number of neighbors found on the operating channel |
Channel Health |
Health of the channel such as good or bad based on the configured thresholds |
Preamble Type |
Type of preamble the AP can support such as short or long |
Radio-Policy |
Radio policy |
SSID |
SSID with which the client associates |
Port |
WLAN-DBSS interface associated with the service template |
Admin State |
Administrative state of the radio |
Physical State |
Physical state of the radio |
Radar detected Channels |
Channels on which radar signals are detected |
display wlan ap address
Syntax
display wlan ap { all | name ap-name } address [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
all: Displays the address information of all APs.
name ap-name: Displays the address information of the AP. An AP name is a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.
address: Displays the address information of the specified AP.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display wlan ap address to display information about a specified AP or all APs.
Examples
# Display the address information for all APs.
<Sysname> display wlan ap all address
Total Number of APs configured : 3
Total Number of configured APs connected : 3
Total Number of auto APs connected : 0
AP Address
-------------------------------------------------------------------------------
AP Name IP Address MAC Address
-------------------------------------------------------------------------------
ap1 1.1.1.5 ... 000b-6b8f-fc6a
ap2 2001::1 ... 000f-e000-0052
ap3 2.2.2.2 ... 000f-e200-0000
-------------------------------------------------------------------------------
Table 15 Command output
Field |
Description |
Total Number of APs configured |
All APs configured through the AP template |
Total Number of configured APs connected |
All online APs that are configured on the AC |
Total Number of auto APs connected |
All online APs that are automatically connected to the AC |
IP Address |
IP address of the AP. If the AP is not online, the field displays -NA-. |
MAC Address |
MAC address of the AP. If the AP is not online, the field displays -NA-. |
display wlan ap radio
Syntax
display wlan ap { all | name ap-name } radio [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
all: Displays the radio information of all APs.
name ap-name: Displays the radio information of the specified AP. An AP name is a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.
radio: Displays the radio information of the AP.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display wlan ap radio to display information about a specified AP or all APs.
Examples
# Display the radio information for all APs.
Sysname> display wlan ap all radio
Total Number of APs configured : 3
Total Number of configured APs connected : 3
Total Number of auto APs connected : 0
AP Radio
-------------------------------------------------------------------------------
AP Name Radio ID Channel Tx Power (dBm)
-------------------------------------------------------------------------------
ap1 2 1 20
ap2 2 6 19
ap3 2 11 20
Table 16 Command output
Field |
Description |
Total Number of APs configured |
All APs configured through the AP template |
Total Number of configured APs connected |
All online APs that are configured on the AC |
Total Number of auto APs connected |
All online APs that are automatically connected to the AC |
AP Name |
AP name |
Radio ID |
ID of the radio associated with the client |
Channel |
Working channel of the radio |
Tx Power (dBm) |
Maximum transmission rate of the radio |
display wlan ap reboot-log
Syntax
display wlan ap reboot-log name ap-name [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
name ap-name: Displays the reboot log information of the AP. An AP name is a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display wlan ap reboot-log to display the reboot log information of the AP. This command is useful to see crash details if any crash occurred on the AP. The AP specified in the command must be in the running state.
Examples
# Display the reboot log information of an AP named ap1.
<Sysname> display wlan ap reboot-log name ap1
.Debug information is not available on AC
Do you wish to start debug data downloading from AP [Y/N]:y
Downloading debug data. Please wait...
Please enter the same command again to view details
<Sysname> display wlan ap reboot-log name ap1
display wlan ap-model
Syntax
display wlan ap-model { all | name ap-name } [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
2: System level
Parameters
all: Displays all model information.
name ap-name: Displays the model information of the AP. An AP name is a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display wlan ap-model to display the model information of a specified AP or all the APs.
The display wlan ap-model all command can be used to view all the AP model information in the order of AP model alias.
Examples
# Display information about model WA2100.
<Sysname> display wlan ap-model name WA2100
AP Model : WA2100
---------------------------------------------------
Alias : WA2100
Vendor Name : H3C
Vendor ID : -NA-
Radio Count : 1
---------------------------------------------------
Radio1 :
Mode : 802.11a/b/g
Default Mode : 802.11g
BSS Count : 16
---------------------------------------------------
Version Support List :
Hardware Version Ver.A :
Software Version : V100R001B96D001
Image Name : WA2100.bin
Hardware Version Ver.B :
Software Version : V100R001B96D001
Image Name : WA2100.bin
Hardware Version Ver.C :
Software Version : V100R001B96D001
Image Name : WA2100.bin
Hardware Version Ver.D :
Software Version : V100R001B96D001
Image Name : WA2100.bin
---------------------------------------------------
Table 17 Command output
Field |
Description |
Alias |
Alias of the AP model |
Vendor Name |
Vendor name of the AP model |
Vendor ID |
Vendor ID of the AP model |
Radio Count |
Total number of radios for the AP model |
Mode |
Supported radio modes such as 802.11a and 802.11b. |
Default Mode |
Default radio mode |
BSS Count |
Maximum number of BSSs supported |
Hardware Version |
Hardware Version of the AP model |
Boot Version |
Boot Version of the AP model |
Software Version |
Software Version of the AP model |
Image Name |
AP image file name which is a complete file name. |
dns domain
Syntax
dns domain domain-name
undo dns domain
View
AP provision view
Default Level
2: System level
Parameters
domain-name: Specifies a domain name for the DNS server. It is a case-insensitive string of 1 to 238 characters separated by dots and can contain letters, digits, hyphens, and underlines.
Description
Use dns domain to specify a domain name for the AP.
Use undo dns domain to remove the configuration.
By default, no domain name is specified for the AP.
You can specify at most one domain name for the AP.
The wlan ap-provision dns domain command takes effect on all APs, and the dns domain command in AP provision view takes effect on the specified AP. If you configure both commands, the configuration in AP provision view applies to the specified AP.
Related commands: wlan ap-provision dns domain.
Examples
# Specify the domain name for AP 1 as com.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2100
[Sysname-wlan-ap-ap1] provision
[Sysname-wlan-ap-ap1-prvs] dns domain com
dns server
Syntax
dns server { ip ip-address | ipv6 ipv6-address }
undo dns server { ip | ipv6 }
View
AP provision view
Default Level
2: System level
Parameters
ip ip-address: Specifies the IPv4 address of the DNS server.
ipv6 ip-address: Specifies the IPv6 address of the DNS server.
Description
Use dns server to specify a DNS server for the AP.
Use undo dns server to remove the DNS server for the AP.
By default, no DNS server is specified for the AP.
You can specify at most one IPv4 DNS server and one IPv6 DNS server.
The wlan ap-provision dns server command takes effect on all APs, and the dns server command in AP provision view takes effect on the specified AP. If you configure both commands, the configuration in AP provision view applies to the specified AP.
Related commands: wlan ap-provision dns server.
Examples
# Specify the IPv4 address of the DNS server as 192.168.100.123.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2100
[Sysname-wlan-ap-ap1] provision
[Sysname-wlan-ap-ap1-prvs] dns server ip 192.168.100.123
echo-interval
Syntax
echo-interval interval
undo echo-interval
View
AP template view
Default level
2: System level
Parameters
interval: Interval for sending echo requests, in the range of 5 to 80 seconds.
Description
Use echo-interval to set the interval for sending echo requests.
Use undo echo-interval to restore the default.
There is a keep-live mechanism between AP and AC, which is used to confirm whether the control channel is working or not. To keep the control channel alive, an AP periodically sends echo requests to an AC. The AC responds to echo requests by sending echo responses.
By default, the echo interval is 10 seconds.
Examples
# Set an echo interval of 15 seconds for AP3.
<Sysname> system-view
[Sysname] wlan ap ap3 model WA2100
[Sysname-wlan-ap-ap3] echo-interval 15
gateway
Syntax
gateway { ip ip-address | ipv6 ipv6-address }
undo gateway { ip | ipv6 | all }
View
AP configuration view
Default level
2: System level
Parameters
ip ip-address: Specifies the IPv4 address of the gateway.
ipv6 ipv6-address: Specifies the IPv6 address of the gateway.
all: Removes all IP addresses of gateways.
Description
Use gateway to specify a gateway for the AP.
Use undo gateway to remove gateway configuration.
By default, no gateway is specified for the AP.
You can specify an IPv4 gateway and an IPv6 gateway for the AP at most.
Examples
# Specify the gateway 192.168.100.1 for AP 1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2100
[Sysname-wlan-ap-ap1] provision
[Sysname-wlan-ap-ap1-prvs] gateway ip 192.168.100.1
hybrid-remote-ap enable
Syntax
hybrid-remote-ap enable
undo hybrid-remote-ap enable
View
AP template view
Default level
3: Management level
Parameters
None
Description
Use hybrid-remote-ap enable to enable hybrid mode for the AP. When the connection between an AP in hybrid mode and the AC is terminated, the AP automatically enables local forwarding mode (disregarding whether local forwarding is configured on the AC) to forward packets for associated clients, but it does not accept new association requests from clients. When the AP re-establishes a CAPWAP connection with the AC, the AP automatically switches back to centralized forwarding mode, and logs out all clients associated with it.
Use undo hybrid-remote-ap enable to restore the default.
By default, hybrid mode is disabled.
|
NOTE: · Before you enable hybrid mode for an AP, H3C recommends that you disable online user handshake function if 802.1X authentication is used. · Do not use the remote AP function together with the WLAN mesh function. |
Examples
# Enable hybrid mode for AP 1.
<Sysname> system-view
[Sysname] wlan ap ap1 model wa2100
[Sysname-ap-ap1] hybrid-remote-ap enable
ip address
Syntax
ip address ip-address { mask | mask-length }
undo ip address
View
AP configuration view
Default level
2: System level
Parameters
ip-address: IP address of the management VLAN interface of the AP, in dotted decimal notation.
mask: Subnet mask in dotted decimal notation.
mask-length: Subnet mask length, the number of consecutive ones in the mask. It is in the range of 0 to 32.
Description
Use ip address to configure the IP address of the management VLAN interface of the AP.
Use undo ip address to remove the IP address of the management VLAN interface of the AP.
By default, no IP address is specified for the management VLAN interface of an AP.
The management VLAN of the AP must be VLAN 1.
Examples
# Configure the IP address of the management VLAN interface of AP 1 as 192.168.100.100/24.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2100
[Sysname-wlan-ap-ap1] provision
[Sysname-wlan-ap-ap1-prvs] ip address 192.168.100.100 24
ipv6 address
Syntax
ipv6 address { ipv6-address prefix-length | ipv6-address/prefix-length }
undo ipv6 address
View
AP configuration view
Default level
2: System level
Parameters
ipv6-address: IPv6 address of the management VLAN interface of the AP.
prefix-length: Prefix length, in the range of 1 to 128.
Description
Use ipv6 address to configure the IPv6 address of the management VLAN interface of the AP.
Use undo ipv6 address to remove the IPv6 address of the management VLAN interface of the AP.
By default, no IPv6 address is specified for the management VLAN interface of the AP.
The management VLAN of the AP must be VLAN 1.
Examples
# Configure the IPv6 address of the management VLAN interface of AP 1 as 2001::1/64.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2100
[Sysname-wlan-ap-ap1] provision
[Sysname-wlan-ap-ap1-prvs] ipv6 address 2001::1/64
jumboframe enable
Syntax
jumboframe enable value
undo jumboframe enable
View
AP template view
Default level
2: System level
Parameters
value: Maximum size of jumbo frames, in the range of 1500 to 1748 bytes.
Description
Use jumboframe enable to set the maximum size of jumbo frames.
Use undo jumboframe enable to restore the default.
By default, the jumbo frame support is disabled.
Examples
# Set the maximum jumbo frame size to 1500 bytes.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2100
[Sysname-ap-ap1] jumboframe enable 1500
map-configuration
Syntax
map-configuration filename
undo map-configuration
View
AP template view
Parameters
filename: Name of the build run configuration file in the flash. Using command "dir" in user view, you can know the list of files in the flash. A file name consists of 1 to 32 characters.
Description
Use map-configuration to map a configuration file to the AP.
Use undo map-configuration to remove the mapping.
By default, no file is mapped to the AP.
|
NOTE: The commands in the configuration file specified with the map-configuration command must be in their complete form. |
Examples
# Map file filename1 to the AP.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2100
[Sysname-wlan-ap-ap1] map-configuration filename1.txt
memory-usage threshold
Syntax
memory-usage threshold integer
View
AP template view
Default level
3: Manage level
Parameters
integer: An integer in the range of 0 to 100.
Description
Use memory-usage threshold to set the memory usage threshold of the AP. If the memory usage of the AP exceeds the threshold, the AP generates an alarm.
By default, the default memory usage threshold of the AP is 90.
Examples
# Set the memory usage threshold of AP 3 to 30.
[Sysname] wlan ap ap3 model WA2100
[Sysname-wlan-ap-ap3]memory-usage threshold 30
priority level
Syntax
priority level priority
undo priority level
View
AP template view
Parameters
priority: AP connection priority, in the range of 0 to 7. The higher the value, the higher the priority.
Description
Use priority level to configure the connection priority for the AP.
Use undo priority level to restore the default.
If the connection priority is 7, the AC is considered as the primary AC for the AP.
By default, the connection priority of an AP is 4.
Examples
# Configure the connection priority for ap3.
<Sysname> system-view
[Sysname] wlan ap ap3 model WA2100
[Sysname-wlan-ap-ap3] priority level 1
provision
provision
undo provision
View
AP template view
Default level
2: System level
Parameters
None
Description
Use provision to create and enter AP configuration view.
Use undo provision to remove the AP configuration view and all configurations in the view.
By default, no AP configuration view is created.
After you create the AP configuration view, the device automatically adds the vlan untagged 1 command.
Examples
# Create and enter the configuration view for AP 1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2100
[Sysname-wlan-ap-ap1] provision
[Sysname-wlan-ap-ap1-prvs]
reset wlan ap
Syntax
reset wlan ap { all | name ap-name }
View
User view
Default level
1: Monitor level
Parameters
all: Resets all the APs connected to the current AC.
name ap-name: Resets the specified AP. An AP name is a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.
Description
Use reset wlan ap to reset a specified AP or all the APs.
Examples
# Reset an AP named ap1.
<Sysname> reset wlan ap name ap1
reset wlan ap provision
Syntax
reset wlan ap provision { all | name ap-name }
View
Any view
Default level
2: System level
Parameters
all: Specifies all APs.
name ap-name: Specifies an AP by its name, a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.
Description
Use reset wlan ap provision to remove the wlan_ap_cfg.wcfg file of the specified AP or all APs.
This command takes effect only on APs in the Run state.
Examples
# AP 1 has been connected to the AC. Remove the wlan_ap_cfg.wcfg file of AP 1.
<Sysname> reset wlan ap provision name ap1
reset wlan ap reboot-log
Syntax
reset wlan ap reboot-log { all | name ap-name }
View
User view
Default level
1: Monitor level
Parameters
all: Clears the reboot log information for all APs.
name ap-name: Clears the reboot log information for the AP. An AP name is a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.
Description
Use reset wlan ap reboot-log to clear the AP reboot log information of all APs or a specific AP.
Examples
# Clear the AP reboot log information of an AP named ap1.
<Sysname> reset wlan ap reboot-log name ap1
save wlan ap provision
Syntax
save wlan ap provision { all | name ap-name }
View
Any view
Default level
2: System level
Parameters
all: Specifies all APs.
name ap-name: Specifies an AP by its name, a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.
Description
Use save wlan ap provision to save the configuration in AP configuration view to the wlan_ap_cfg.wcfg file of the specified AP or all APs.
· This command takes effect only on APs in the Run state. It does not take effect on APs that establish a CAPWAP connection with the AC after you execute the save wlan ap-provision command.
· After you execute the save wlan ap-provision command, you must restart the specified AP to validate the configuration.
· After restart, the AP executes the configuration file, the wlan_ap_cfg.wcfg file, and the configuration file specified by the map-configuration command in turn. Make sure the wlan_ap_cfg.wcfg file and the configuration file specified by the map-configuration command are correct because wrong configurations may make the three configuration files overwrite or conflict with one another.
|
CAUTION: After you execute the save wlan ap provision command on the AC, the configuration is saved to the wlan_ap_cfg.wcfg file of the specified AP. When the wlan_ap_cfg.wcfg file takes effect, the AP can only be managed by the AC specified by the ac or wlan ap-provision ac command. Make sure the correct AC is specified' otherwise, the AP cannot be managed by the specified AC, and you have to log in to the AP to modify its configuration. |
Related commands: map-configuration, reset wlan ap provision, and reset wlan ap.
Examples
# AP 1 has established a CAPWAP connection with the AC. Save the configuration in AP configuration view to the wlan_ap_cfg.wcfg file of AP 1.
<Sysname> save wlan ap provision name ap1
serial-id
Syntax
serial-id { text | auto }
undo serial-id
View
AP template view
Default level
2: System level
Parameters
text: Serial ID of an AP. It is a case-sensitive string of 1 to 32 characters that can contain special characters except question marks. All input letters are changed to uppercase letters by the system.
auto: Enables auto serial ID configuration for a generic auto AP template.
Description
Use serial-id to set a serial ID for an AP. The serial ID is the unique identity of the AP. If the AP has connected to the AC, changing or deleting its serial ID will render the AP tunnel down. The AP needs to discover the AC to connect again.
Use undo serial-id to restore the default.
By default, no serial ID is configured for an AP.
Examples
# Set the serial ID as 210235A29G007C000020 for AP 1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2100
[Sysname-wlan-ap-ap1] serial-id 210235A29G007C000020
tunnel encryption ipsec pre-shared-key
Syntax
tunnel encryption ipsec pre-shared-key { cipher | simple } key
undo tunnel encryption ipsec pre-shared-key
View
AP configuration view
Default level
2: System level
Parameters
cipher: Specifies a ciphertext key.
simple: Specifies a plaintext key.
key: Encryption key. It is a case-sensitive string of 1 to 128 characters for a plaintext key, or a case-sensitive string of 1 to 201 characters for a ciphertext key.
Description
Use tunnel encryption ipsec pre-shared-key to configure the AP to use IPsec to encrypt the control tunnel.
Use undo tunnel encryption ipsec pre-shared-key to remove the configuration.
By default, the AP does not encrypt the control tunnel.
This command only enables the AP to encrypt the control tunnel. To enable the AP to encrypt the data tunnel, use the data-tunnel encryption enable command. The undo tunnel encryption ipsec pre-shared-key command removes the configuration for both data tunnel encryption and control tunnel encryption.
Related commands: data-tunnel encryption enable.
Examples
# Configure the AP to use plaintext key 12345 to encrypt the control tunnel.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2620-AGN
[Sysname-wlan-ap-ap1] provision
[Sysname-wlan-ap-ap1-prvs] tunnel encryption ipsec pre-shared-key simple 12345
vlan pvid
Syntax
vlan pvid vlan-id
undo vlan pvid
View
AP configuration view
Default level
2: System level
Parameters
vlan-id: Default VLAN ID of the Ethernet interface on the AP. It is in the range of 1 to 4094.
Description
Use vlan pvid to configure the default VLAN ID of the Ethernet interface on the AP.
Use undo vlan pvid to restore the default.
By default, the default VLAN ID of the Ethernet interface on an AP is 1.
Examples
# Configure the default VLAN ID of the Ethernet interface on AP 1 as 5.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2100
[Sysname-wlan-ap-ap1] provision
[Sysname-wlan-ap-ap1-prvs] vlan pvid 5
vlan tagged
Syntax
vlan tagged vlan-id-list
undo vlan tagged vlan-id-list
View
AP configuration view
Default level
2: System level
Parameters
vlan-id-list: Specifies a list of VLANs whose packets are sent tagged on the Ethernet interface of the AP. It is in the format of vlan-id-list = { vlan-id1 [ to vlan-id2 ] }& <1-10>, where vlan-id is in the range of 1 to 4094 and &<1-10> indicates that you can specify up to 10 VLAN IDs.
Description
Use vlan tagged to configure a list of VLANs whose packets are sent tagged on the Ethernet interface of the AP.
Use undo vlan tagged to remove the configuration.
By default, no packets are sent tagged on the Ethernet interface on the AP.
Examples
# Configure packets in VLAN 6 are sent tagged on the Ethernet interface on AP 1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2100
[Sysname-wlan-ap-ap1] provision
[Sysname-wlan-ap-ap1-prvs] vlan tagged 6
vlan untagged
Syntax
vlan untagged vlan-id-list
undo vlan untagged vlan-id-list
View
AP configuration view
Default level
2: System level
Parameters
vlan-id-list: Specifies a list of VLANs whose packets are sent untagged on the Ethernet interface of the AP. It is in the format of vlan-id-list = { vlan-id1 [ to vlan-id2 ] }& <1-10>, where vlan-id is in the range of 1 to 4094 and &<1-10> indicates that you can specify up to 10 VLAN IDs.
Description
Use vlan untagged to configure a list of VLANs whose packets are sent untagged on the Ethernet interface of the specified AP.
Use undo vlan tagged to remove the configuration.
By default, no packets are sent untagged on the Ethernet interface on the AP.
Examples
# Configure packets in VLAN 7 are sent untagged on the Ethernet interface of AP 1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2100
[Sysname-wlan-ap-ap1] provision
[Sysname-wlan-ap-ap1-prvs] vlan untagged 7
wlan ap
Syntax
wlan ap ap-name model model-name [ id ap-id ]
undo wlan ap ap-name
View
System view
Default level
2: System level
Parameters
ap-name: Name of the AP, a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.
model model-name: Specifies the model number of the AP.
id ap-id: ID of the AP, which ranges from 1 to the maximum number of APs supported. If this parameter is not configured, the AC automatically assigns an ID to the AP.
Description
Use wlan ap to create a new AP template and enter AP template view. If the AP template exists, using the command enters its view.
Use undo wlan ap to remove a specific AP template. If the AP is connected to the AC, the undo wlan ap command will disconnect the AP from the AC.
Examples
# Create an AP template named ap1 and its model is WA2100.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA2100
wlan apdb
Syntax
wlan apdb model-name hardware-version software-version
undo wlan apdb model-name hardware-version
View
System view
Default level
2: System level
Parameters
model-name: AP model name.
hardware-version: Fit AP hardware version name.
software-version: Fit AP software version name.
Description
Use wlan apdb to designate the software version of a given AP model with a given hardware version.
Use undo wlan apdb to restore the default.
By default, the software versions of a fit AP and AC must be consistent.
Examples
# Designate the software version of a given AP model with a given hardware version.
<Sysname> system-view
[Sysname] wlan apdb wa2100 Ver.C V100R001B96D001
wlan ap-execute
Syntax
wlan ap-execute ap-name conversion-to-fatap
View
System view
Default level
3: Manage level
Parameters
ap-name: Name of the AP, which is a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.
conversion-to-fatap: Changes the fit AP to a fat AP.
Description
Use wlan ap-execute to convert a fit AP to a fat AP.
|
CAUTION: Download the fat AP's software to the AC before configuring the command. Otherwise, the AC cannot change the fit AP to a fat AP. |
Examples
#.Convert AP ap1_003 to a fat AP.
<Sysname> system-view
[Sysname] wlan ap-execute ap1_003 conversion-to-fatap
wlan ap-provision ac
Syntax
wlan ap-provision ac { host-name host-name | ip ip-address | ipv6 ipv6-address }
undo wlan ap-provision ac { host-name | ip { ip-address | all } | ipv6 { ipv6-address | all } }
View
System view
Default level
2: System level
Parameters
host-name host-name: Specifies the host name of a global AC. It is a case-insensitive string of 1 to 255 characters that can contain letters, digits, "-", "_" or ".", and must contain at least one letter.
ip ip-address: Specifies the IPv4 address of a global AC.
ipv6 ipv6-address: Specifies the IPv6 address of a global AC.
all: Removes the IPv4/IPv6 addresses of all global ACs.
Description
Use wlan ap-provision ac to specify a global AC so that all APs can discover the AC.
Use undo wlan ap-provision ac to remove the configuration.
By default, no global AC is specified.
The wlan ap-provision ac command takes effect on all APs, and the ac command in AP configuration view takes effect on the specified AP. If you configure both commands, the configuration in AP configuration view is preferred by the specified AP.
You can specify at most three ACs' IP addresses, three ACs' IPv6 addresses, and an AC's host name for all APs.
Related commands: ac.
Examples
# Specify the global AC 192.168.100.11 so that all APs can discover the AC.
<Sysname> system-view
[Sysname] wlan ap-provision ac ip 192.168.100.11
wlan ap-provision dns domain
Syntax
wlan ap-provision dns domain domain-name
undo wlan ap-provision dns domain
View
System view
Default Level
2: System level
Parameters
domain-name: Specifies a domain name. It is a case-insensitive string of 1 to 238 characters separated by dots. It can contain letters, digits, hyphens, and underlines.
Description
Use wlan ap-provision dns domain to specify a global domain name.
Use undo wlan ap-provision dns domain to remove the configuration.
By default, no global domain name is specified.
You can specify at most one global domain name.
The wlan ap-provision dns domain command takes effect on all APs, and the dns domain command in AP provision view takes effect on the specified AP. If you configure both commands, the configuration in AP provision view applies to the specified AP.
Related commands: dns domain.
Examples
# Specify the global domain name as com.
<Sysname> system-view
[Sysname] wlan ap-provision dns domain com
wlan ap-provision dns server
Syntax
wlan ap-provision dns server { ip ip-address | ipv6 ipv6-address }
undo wlan ap-provision dns server { ip | ipv6 }
View
System view
Default Level
2: System level
Parameters
ip ip-address: Specifies the IPv4 address of a global DNS server.
ipv6 ip-address: Specifies the IPv6 address of a global DNS server.
Description
Use wlan ap-provision dns server to specify a global DNS server.
Use undo wlan ap-provision dns server to remove the configuration.
By default, no global DNS server is specified.
You can specify at most one global IPv4 DNS server and one global IPv6 DNS server.
The wlan ap-provision dns server command takes effect on all APs, and the dns server command in AP provision view takes effect on the specified AP. If you configure both commands, the configuration in AP provision view applies to the specified AP.
Related commands: dns server.
Examples
# Specify the IPv4 address of the global DNS server as 192.168.100.124.
<Sysname> system-view
[Sysname] wlan ap-provision dns server ip 192.168.100.124
wlan auto-ap enable
Syntax
wlan auto-ap enable
undo wlan auto-ap enable
View
System view
Default level
2: System level
Parameters
None
Description
Use wlan auto-ap enable to enable the auto AP function.
Use undo wlan auto-ap enable to restore the default.
By default, the auto AP function is disabled.
The auto AP feature allows an AP to automatically connect to an AC. When you deploy a wireless network with many APs, the auto AP function avoids configuration of many AP serial IDs, simplifying configuration.
Related commands: serial-id and wlan auto-ap persistent.
Examples
# Enable the auto AP function
<Sysname> system-view
[Sysname] wlan auto-ap enable
wlan auto-ap persistent
Syntax
wlan auto-ap persistent { all | name auto-ap-name [ new-ap-name ] }
View
System view
Default level
2: System level
Parameters
all: All connected auto APs.
name auto-ap-name: Name of a connected auto AP.
new-ap-name: New name of the AP. It is a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.
Description
Use wlan auto-ap persistent name auto-ap-name new-ap-name to convert a specified auto AP to a configured AP with a specified new name.
Use wlan auto-ap persistent name auto-ap-name to convert a specified auto AP to a configured AP with the existing auto AP name.
Use wlan auto-ap persistent all to convert all connected auto APs to configured APs with existing auto AP names.
Examples
# Convert a connected auto AP to a configured AP with a new name.
<Sysname> system-view
[Sysname] wlan auto-ap persistent name auto_apm1_001 ap2
# Convert a connected auto AP to a configured AP that uses the existing auto AP name.
<Sysname> system-view
[Sysname] wlan auto-ap persistent name auto_apm1_001
# Convert all connected auto APs to configured APs that use existing auto AP names.
<Sysname> system-view
[Sysname] wlan auto-ap persistent all
wlan backup-ac
Syntax
wlan backup-ac { ip ipv4-address | ipv6 ipv6-address }
undo wlan backup-ac { ip | ipv6 }
View
System view
Parameters
ip ipv4-address: Specifies the IPv4 address of the backup AC.
ipv6 ipv6-address: Specifies the IPv6 address of the backup AC.
Description
Use wlan backup-ac to specify the backup AC.
Use undo wlan backup-ac to remove the configuration.
By default, no backup AC address exists.
Examples
# Configure a backup AC.
<Sysname> system-view
[Sysname] wlan backup-ac ip 192.168.1.1
wlan lwapp discovery-policy
Syntax
wlan lwapp discovery-policy unicast
undo wlan lwapp discovery-policy
View
System view
Default level
2: System level
Parameters
unicast: Configures the AC to accept only unicast discovery requests from an AP.
Description
Use wlan lwapp discovery-policy to set the discovery policy type used in the discovery process. If you configure the discovery policy as unicast, broadcast discovery packets are discarded.
Use undo wlan lwapp discovery-policy to restore the default.
By default, the LWAPP discovery policy is broadcast.
Examples
# Set the LWAPP discovery policy type as unicast.
<Sysname> system-view
[Sysname] wlan lwapp discovery-policy unicast
User isolation commands
display user-isolation statistics
display user-isolation statistics [ vlan vlan-id ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
vlan-id: Displays the user isolation statistics of the specified VLAN. The VLAN ID is in the range of 1 to 4094.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display user-isolation statistics to display the user isolation statistics of the specified VLAN or all VLANs. If no VLAN is specified, the user isolation statistics of all VLANs are displayed.
Examples
# Display the user isolation statistics of VLAN 3.
<Sysname> display user-isolation statistics vlan 3
User-Isolation Table
------------------------------------------------------
VLAN Status Drops Permit-MAC
4 Enabled 0
6 Disabled 0 0023-89a2-3d4d
---- Number of enabled/disabled VLANs: 1/1 ----
Table 18 Command output
Field |
Description |
VLAN |
ID of the VLAN where user isolation is enabled |
Status |
Enabled or disabled |
Drops |
Number of dropped packets in the VLAN |
Permit-MAC |
Permitted MAC address list of the VLAN |
reset user-isolation statistics
Syntax
reset user-isolation statistics [ vlan vlan-id ]
View
User View
Default level
1: Monitor level
Parameters
vlan vlan-id: ID of a VLAN, in the range of 1 to 4094.
Description
Use reset user-isolation statistics to clear the user isolation statistics of the specified VLAN or all VLANs. If no VLAN is specified, the user isolation statistics of all VLANs are cleared.
Examples
# Clear the user isolation statistics of VLAN 1.
<Sysname> reset user-isolation statistics vlan 1
user-isolation enable
Syntax
user-isolation enable
undo user-isolation enable
View
Service template view
Default Level
2: System level
Parameters
None
Description
Use user-isolation enable to enable SSID-based user isolation for the service template.
Use undo user-isolation enable to restore the default.
By default, SSID-based user isolation is disabled.
Examples
# Enable SSID-based user isolation for service template 1.
<Sysname> system-view
[Sysname] wlan service-template 1 clear
[Sysname-wlan-st-1] user-isolation enable
user-isolation permit broadcast
Syntax
user-isolation permit broadcast
undo user-isolation permit broadcast
View
System view
Default level
2: System level
Parameters
None
Description
Use user-isolation permit broadcast to permit broadcasts and multicasts from wired users to wireless users.
Use undo user-isolation permit broadcast to isolate broadcasts and multicasts from wired users to wireless users.
By default, broadcasts and multicasts from wired users to wireless users are permitted, and broadcasts and multicasts from wireless users to wireless users are isolated.
Examples
# Isolate broadcasts and multicasts from wired users to wireless users.
<Sysname> system-view
[Sysname] user-isolation permit broadcast
user-isolation vlan enable
Syntax
user-isolation vlan vlan-list enable
undo user-isolation vlan vlan-list enable
View
System view
Default level
2: System level
Parameters
vlan-list: VLAN list. This argument is expressed in the format of vlan-list = { vlan-id [ to vlan-id ] }&<1-10>, where vlan-id is in the range of 1 to 4094 and &<1-10> indicates that you can specify up to 10 VLAN IDs or VLAN ID ranges.
Description
Use user-isolation vlan enable to enable user isolation on the specified VLAN(s).
Use undo user-isolation vlan enable to disable user isolation on the specified VLAN(s).
By default, user isolation is disabled in a VLAN.
Examples
# Enable user isolation on VLAN 1.
<Sysname> system-view
[Sysname] user-isolation vlan 1 enable
user-isolation vlan permit-mac
Syntax
user-isolation vlan vlan-list permit-mac mac-list
undo user-isolation vlan vlan-list permit-mac { mac-list |all }
View
System view
Default level
2: System level
Parameters
vlan-list: Enables user isolation for the specified VLAN(s). This argument is expressed in the format of vlan-list = { vlan-id [ to vlan-id ] }&<1-10>, where vlan-id is in the range of 1 to 4094 and &<1-10> indicates that you can specify up to 10 VLAN IDs or VLAN ID ranges.
mac-list: List of permitted MAC addresses. You can configure up to 16 permitted MAC addresses. Broadcast MAC addresses or multicast MAC addresses cannot be included.
all: Deletes all the permitted MAC addresses of the specified VLAN(s).
Description
Use user-isolation vlan permit-mac to add permitted MAC addresses in the specified VLAN(s).
Use undo user-isolation vlan permit-mac to delete the specified or all permitted MAC addresses in the specified VLAN(s).
By default, no permitted MAC addresses are specified.
Examples
# Configure permitted MAC addresses 00bb-ccdd-eeff and 0022-3344-5566 in VLAN 1.
<Sysname> system-view
[Sysname] user-isolation vlan 1 permit-mac 00bb-ccdd-eeff 0022-3344-5566
AP group configuration commands
ap
Syntax
ap template-name-list
undo ap template-name-list
View
AP group view
Default level
2: System level
Parameters
template-name-list: A list of AP templates. Up to 10 AP templates can be included in the list. An AP template name is a case-insensitive string of 1 to 32 characters that can contain letters, digits, and underlines.
Description
Use ap to add specified APs into the AP group.
Use undo ap to delete specified APs from the AP group. If no AP is specified, the command removes all APs from the AP group.
By default, no AP is added into the AP group.
The command does not check whether the specified APs exist. Using the ap command repeatedly can add multiple APs in the AP group until the maximum number is reached. On a device, one AP can be included in multiple AP groups.
Examples
# Add AP 10 and AP 101 into AP group 10.
<System> system-view
[System] wlan ap-group 10
[System-ap-group10] ap ap10 ap101
description
Syntax
description string
undo description
View
AP group view
Default level
2: System level
Parameters
string: A string of 1 to 15 characters that can include letters [a-z,A-Z] and underscores.
Description
Use description to configure a description for the AP group.
Use undo description to delete the description for the AP group.
No description is configured for the AP group by default.
A newly configured description overwrites the previous description (if any).
Examples
# Configure a description of marketing for AP group 10.
<System> system-view
[System] wlan ap-group 10
[System-ap-group10] description marketing
display wlan ap-group
Syntax
display wlan ap-group [ group-id ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
group-id: ID of an AP group. The value range varies depending on the device model. For related information, see About the WX Series Access Controllers Command References.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display wlan ap-group to display AP group information. If no AP group is specified, the command displays information about all AP groups.
Examples
# Display information about AP group 10.
<Sysname> display wlan ap-group 10
AP Group Information
---------------------------------------------------------------------
AP-Group ID :10
Description :market
Access AP Lists :ap1, ap2,
ap3, ap4,
ap5, ap6
Table 19 Command output
Field |
Description |
AP-Group ID |
AP group ID |
Description |
Description of the AP group |
Access AP Lists |
Permitted APs |
wlan ap-group
Syntax
wlan ap-group group-id
undo wlan ap-group [ group-id ]
View
System view
Default level
2: System level
Parameters
group-id: ID of the AP group. The value range varies depending on the device model. For related information, see About the WX Series Access Controllers Command References.
Description
Use wlan ap-group to create an AP group and enter AP group view. If the specified AP group has been created, using the command enters AP group view only.
Use undo wlan ap-group to remove a specified AP group, or all AP groups if no AP group is specified.
Examples
# Create AP group 10.
<Sysname> system-view
[Sysname] wlan ap-group 10
[Sysname-ap-group10]
wlan permit-ap-group
Syntax
wlan permit-ap-group group-id
undo wlan permit-ap-group [ group-id ]
View
User profile view
Default level
2: System level
Parameters
group-id: ID of an AP group. The value range varies depending on the device model. For related information, see About the WX Series Access Controllers Command References.
Description
Use wlan permit-ap-group to apply a specified AP group in the user profile, which can have multiple AP groups applied.
Use undo wlan permit-ap-group to remove a specified AP group from the user profile or all AP groups from the user profile if no AP group is specified.
By default, no AP group is applied in the user profile.
Examples
# Apply AP group 10 in user profile management.
<Sysname> system-view
[Sysname] user-profile management
[Sysname-user-profile-management] wlan permit-ap-group 10
SSID-based access control configuration commands
wlan permit-ssid
Syntax
wlan permit-ssid ssid-name
undo wlan permit-ssid [ ssid-name ]
View
User profile view
Default level
2: System level
Parameters
ssid-name: Name of a permitted SSID, a case-sensitive string of 1 to 32 characters that can contain letters, digits, underscores, and spaces. The maximum number of permitted SSIDs in a user profile varies depending on the device model. For related information, see About the WX Series Access Controllers Command References.
Description
Use wlan permit-ssid to specify a permitted SSID for a user profile.
Use undo wlan permit-ssid to remove a permitted SSID or all permitted SSIDs.
By default, no permitted SSID is specified for a user profile, and a client can access any available SSID.
Examples
# Specify permitted SSID VIPguest for user profile management.
<System> system-view
[System] user-profile management
[System-user-profile-management] wlan permit-ssid VIPguest
Uplink detection commands
wlan uplink track
Syntax
wlan uplink track track-entry-number
undo wlan uplink track
View
System view
Default level
2: System level
Parameters
track track-entry-number: Number of the track entry to be detected, in the range of 1 to 1024.
Description
Use wlan uplink track to specify a track entry for uplink detection.
Use undo wlan uplink track to remove the configuration.
By default, no track entry is specified for uplink detection.
Examples
# Specify a track entry for uplink detection.
<Sysname> system
[Sysname] wlan uplink track 1
AC hot backup configuration commands
display hot-backup state
Syntax
display hot-backup state [ | { begin | exclude | include } regular-expression ]
View
System view
Default level
2: System level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use display hot-backup state to display the AC hot backup state. Support for this command depends on your AC model. For related information, see About the WX Series Access Controllers Command References.
Examples
# Display the AC hot backup state.
<Sysname> system-view
[Sysname]display hot-backup state
********************************************************
Vlan ID : 21
Domain ID : 1
Link State : Connect
Peer Board MAC : 000f-e212-ff02
Peer Board State : Normal
Table 20 Command output
Field |
Description |
Vlan ID |
ID of the VLAN to which the ports are assigned |
Domain ID |
Domain to which the AC belongs |
Link State |
AC link state: · Close—Not connected. · Init—Being connection. · Connect—Connected. |
Peer Board MAC |
MAC address of the peer AC |
Peer Board State |
Status of the peer AC: · Normal · Abnormal · Unknown |
hot-backup enable
Syntax
hot-backup enable [ domain domain-id ] *
undo hot-backup enable
View
System view
Default level
2: System level
Parameters
domain domain-id: Domain ID of the AC. It is in the range of 1 to 16 and defaults to 1.
Description
Use hot-backup enable to enable the AC hot backup function.
Use undo hot-backup enable to disable the AC hot backup function.
You can manually configure the domain to which the AC belongs.
By default, the AC hot backup function is disabled.
|
NOTE: · Executing the hot-backup command repeatedly on an AC enabled with hot backup does not take effect. · Executing the undo hot-backup command repeatedly on an AC disabled with hot backup does not take effect. · Support for the hot-backup command depends on the device model. For related information, see About the WX Series Access Controllers Command References. |
Examples
# Enable the AC hot backup function.
<Sysname> system-view
[Sysname]hot-backup enable
hot-backup enable successfully.
hot-backup hellointerval
Syntax
hot-backup hellointerval hellointerval
View
System view
Default level
2: System level
Parameters
hellointerval: Sets the interval for sending heartbeat messages, in milliseconds. The default value is 2000 milliseconds. The value range depends on your AC model. For related information, see About the WX Series Access Controllers Command References.
Description
Use hot-backup hellointerval to set the interval for sending heartbeat messages. If the master AC or backup AC does not receive any heartbeat packets from the peer within three heartbeat intervals, it considers the peer device disconnected.
Support for this command depends on your AC model. For related information, see About the WX Series Access Controllers Command References.
Examples
# Set the heartbeat interval to 100 milliseconds.
<Sysname> system-view
[Sysname]hot-backup hellointerval 100
hot-backup vlan
Syntax
hot-backup vlan vlan-id
View
System view
Default level
2: System level
Parameters
vlan vlan-id: Sets the ID of the VLAN to which the port connected to another AC belongs. A vlan-id is in the range of 1 to 4094.
Description
Use hot-backup vlan to set the ID of the VLAN to which the port connected to another AC belongs. Support for this command depends on your AC model. For related information, see About the WX Series Access Controllers Command References.
By default, the port connected to the other AC belongs to VLAN 1.
Examples
# Set the ID of the VLAN to which the port connected to another AC belongs to 5.
<Sysname> system-view
[Sysname]hot-backup vlan 5
wlan backup-ac switch-delay
Syntax
wlan backup-ac switch-delay time
undo wlan backup-ac switch-delay
View
System view
Default level
2: System level
Parameters
time: Sets the delay for an AP to switch from a master AC to a backup AC. The value is in the range of 0 to 600 seconds.
Description
Use wlan backup-ac switch-delay to set the delay for an AP to switch from a master AC to a backup AC.
Use undo wlan backup-ac switch-delay to remove the configuration.
By default, the delay for an AP to switch from a master AC to a backup AC is 5 seconds.
Examples
# Set the delay for an AP to switch from a master AC to a backup AC to 10 seconds.
<Sysname> system-view
[Sysname] wlan backup-ac switch-delay 10