- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
02-WLAN Access Commands | 221.48 KB |
WLAN access configuration commands·
client max-count (service template view)
display wlan client beacon-report
display wlan statistics client
display wlan statistics service-template
green-energy-management enable
service-template (WLAN-Radio interface view)
service-template (service template view)
a-mpdu enable
Use a-mpdu enable to enable the Aggregated MAC Protocol Data Unit (A-MPDU) function for the radio.
Use undo a-mpdu enable to disable the A-MPDU function for the radio.
Syntax
a-mpdu enable
undo a-mpdu enable
Default
The A-MPDU function is enabled.
Views
WLAN-Radio interface view
Default command level
2: System level
Usage guidelines
This command only takes effect 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] interface WLAN-Radio 1/0/1
[sysname-WLAN-Radio1/0/1] undo a-mpdu enable
a-msdu enable
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.
Syntax
a-msdu enable
undo a-msdu enable
Default
The A-MSDU function is enabled.
Views
WLAN-Radio interface view
Default command level
2: System level
Usage guidelines
This command only takes 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] interface wlan-radio 1/0/1
[sysname-WLAN-Radio1/0/1] undo a-msdu enable
ani enable
Use ani enable to enable the Adaptive Noise Immunity (ANI) function.
Use undo ani enable to disable the ANI function.
Syntax
ani enable
undo ani enable
Default
ANI is enabled.
Views
WLAN-Radio interface view
Default command level
2: System level
Usage guidelines
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] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio 1/0/1] undo ani enable
antenna type
Use antenna type to specify the antenna type.
Use undo antenna type to restore the default.
Syntax
antenna type type
undo antenna type
Default
The default antenna type is internal for WA4620i-ACN and WA4300 series and Ext-Def for WA4620E-ACN.
Views
WLAN-Radio interface view
Default command level
2: System level
Parameters
type: Specifies the antenna type.
Examples
# Specify the antenna type.
<sysname> system-view
[sysname] interface wlan-radio 1/0/1
[sysname-WLAN-Radio1/0/1] antenna type internal
beacon-measurement enable
Use beacon-measurement enable to enable beacon measurement.
Use undo beacon-measurement enable to disable beacon measurement.
Syntax
beacon-measurement enable
undo beacon-measurement enable
Default
Beacon measurement is disabled.
Views
Service template view
Default command level
2: System level
Usage guidelines
Enable beacon measurement for the AP to send beacon measurement requests to clients that support the 802.11k protocol.
Examples
# Disable beacon measurement.
<Sysname> system-view
[Sysname] wlan service-template 1 clear
[Sysname-wlan-st-1] beacon-measurement enable
beacon-measurement interval
Use beacon-measurement interval to set the interval at which the AP sends beacon measurement requests to clients.
Use undo beacon-measurement interval to restore the default.
Syntax
beacon-measurement interval interval
undo beacon-measurement interval
Default
The interval is 60 seconds.
Views
Service template view
Default command level
2: System level
Parameters
interval: Specifies the interval at which the AP sends beacon measurement requests to clients, in the range of 10 to 200 seconds.
Examples
# Set the interval for sending beacon measurement requests to 60 seconds.
<Sysname> system-view
[Sysname] wlan service-template 1 clear
[Sysname-wlan-st-1] beacon-measurement enable
beacon-measurement type
Use beacon-measurement type to set the beacon measurement mode.
Use undo beacon-measurement type to restore the default.
Syntax
beacon-measurement type { active | beacon-table | passive }
undo beacon-measurement type
Default
The beacon-table mode is used.
Views
Service template view
Default command level
2: System level
Parameters
active: Enables the active beacon measurement mode. In this mode, the AP sends a beacon measurement request to a client. Upon receiving the request, the client broadcasts probe requests on all supported channels, sets a measurement duration timer, and, at the end of the measurement duration, compiles all received beacons and probe responses into a measurement report.
beacon-table: Enables the beacon-table beacon measurement mode. In this mode, the AP sends a beacon measurement request to a client. Upon receiving the request, the client measures beacons and returns a report to the AP. The report contains all beacon information stored on the client.. The client does not perform any additional measurements.
passive: Enables the passive beacon measurement mode. In this mode, the AP sends a beacon measurement request to a client. Upon receiving the request, the client sets a measurement duration timer, and, at the end of the measurement duration, compiles all received beacons and probe responses into a measurement report.
Examples
# Set the beacon measurement mode to active.
<Sysname> system-view
[Sysname] wlan service-template 1 clear
[Sysname-wlan-st-1] beacon-measurement type active
beacon ssid-hide
Use beacon ssid-hide to disable the advertising of the Service Set Identifier (SSID) in beacon frames.
Use undo beacon ssid-hide to restore the default.
Syntax
beacon ssid-hide
undo beacon ssid-hide
Default
The SSID is advertised in beacon frames.
Views
Service template view
Default command level
2: System level
Usage guidelines
If the advertising of the SSID in beacon frames is disabled, the SSID must be configured for the clients to associate with the AP.
Disabling the advertising of the SSID in beacon frames inhibits wireless security. Allowing the advertising of the SSID in beacon frames enables clients to discover an AP more easily.
Examples
# Disable the advertising of the SSID in beacon frames.
<Sysname> system-view
[Sysname] wlan service-template 1 clear
[Sysname-wlan-st-1] beacon ssid-hide
beacon-interval
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.
Syntax
beacon-interval interval
undo beacon-interval
Default
The beacon interval is 100 TUs.
Views
WLAN-Radio interface view
Default command 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).
Examples
# Specify the beacon interval as 1000 TUs.
<Sysname> System-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] beacon-interval 1000
channel
Use channel to specify a channel for the radio.
Use undo channel to restore the default.
Syntax
channel { channel-number | auto }
undo channel
Default
auto mode is set.
Views
WLAN-Radio interface view
Default command level
2: System level
Parameters
channel-number: Specifies a channel. The working channels depend on the country code and radio mode. An 802.11a, 802.11ac, or 802.11an radio interface supports the 36, 40, 44, 48, 52, 56, 60, 64, 149, 153, 157, 161, and 165 channels. An 802.11b, 802.11g, or 802.11gn radio interface supports channels 1 through 13.
auto: Configures the channel to be automatically selected by the device according to the actual environment during system initialization.
Examples
# Specify channel 6 for radio interface 1/0/2.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/2
[Sysname-WLAN-Radio1/0/2] radio-type dot11b
[Sysname-WLAN-Radio1/0/2] channel 6
channel band-width
Use channel band-width to specify the channel bandwidth of the radio.
Use undo channel band-width to restore the default.
Syntax
channel band-width { 20 | 40 | 80 }
undo channel band-width
Default
The channel bandwidths of an 802.11an radio, the 802.11gn radio and the 802.11ac radio are 40 MHz, 20 MHz, and 80 MHz, respectively.
Views
WLAN-Radio interface view
Default command 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.
80: Specifies the channel bandwidth for the 802.11ac radio as 80 MHz.
Usage guidelines
This command is only effective on 802.11n and 802.11ac 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. For more information, see IEEE 802.11n-2009.
Examples
# Configure the channel bandwidth of the radio as 40 MHz.
<sysname> system-view
[sysname] interface WLAN-Radio 1/0/1
[sysname-WLAN-Radio1/0/1] radio-type dot11ac
[sysname-WLAN-Radio1/0/1] channel band-width 40
client
Use client to allow 802.11n or 802.11ac client access.
Use undo client to restore the default.
Syntax
client { dot11n-only | dot11ac-only }
undo client { dot11n-only | dot11ac-only }
Default
An 802.11an or 802.11ac radio permits 802.11a, 802.11an, and 802.11ac clients access. An 802.11gn radio permits both 802.11b/g and 802.11gn client access.
Views
WLAN-Radio interface view
Default command level
2: System level
Parameters
dot11n-only: Permits 802.11n or 802.11ac clients in 5 GHz radio interface view. Permits 802.11n clients in 2.4 GHz radio interface view.
dot11ac-only: Permits only 802.11ac clients.
Usage guidelines
The client dot11n-only command permits only 802.11n or 802.11ac clients' access. To provide access for all 802.11a/b/g clients, disable this command.
The client dot11ac-only command permits only 802.11ac clients to access the WLAN. To provide access for 802.11a/n clients, disable this command.
Examples
# Configure the radio to allow only 802.11n and 802.11ac clients to access the WLAN.
<sysname> system-view
[sysname] interface WLAN-Radio 1/0/1
[sysname-WLAN-Radio1/0/1] radio-type dot11an
[sysname-WLAN-Radio1/0/1] client dot11n-only
# Configure the radio to allow only 802.11ac clients to access the WLAN.
<Sysname>system-view
[sysname] interface WLAN-Radio 1/0/1
[sysname-WLAN-Radio1/0/1] radio 1 type dot11ac
[sysname-WLAN-Radio1/0/1] client dot11ac-only
Related commands
· dot11n mandatory maximum-mcs
· dot11ac mandatory maximum-nss
client max-count (service template view)
Use client max-count to specify the maximum number of allowed clients for a radio.
Use undo client max-count to restore the default.
Syntax
client max-count max-number
undo client max-count
Default
Up to 64 clients can be associated with an SSID on a radio.
Views
Service template view
Default command level
2: System level
Parameters
max-number: Maximum number of clients associated with an SSID, in the range of 1 to 124.
Usage guidelines
When the maximum number is reached, the SSID is automatically hidden.
Examples
# Specify the maximum number of clients associated with 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
debugging wlan mac
Use debugging wlan mac to enable the WLAN MAC to output debugging information such as error, event, packet, frame, and FSM debugging information.
Use undo debugging wlan mac to disable the specified debugging.
Syntax
debugging wlan mac { all | error | event | frame [ acl acl-number | verbose ] | fsm [ acl acl-number ] | timer }
undo debugging wlan mac { all | error | event | frame | fsm | timer }
Default
No WLAN debugging is enabled.
Views
User view
Default command level
2: System level
Parameters
all: Enables all WLAN MAC debugging.
error: Enables WLAN MAC error debugging.
event: Enables WLAN MAC event debugging.
frame: Enables WLAN MAC frame debugging.
acl acl-number: Specifies an ACL for frames. The value is in the range of 4000 to 4999.
verbose: Displays detailed debugging information.
fsm: Enables WLAN MAC FSM debugging.
timer: Enables WLAN MAC timer debugging.
Examples
# Enable WLAN MAC error debugging on the AC.
<Sysname> debugging wlan mac error
display wlan client
Use display wlan client to display WLAN client information. The information is displayed in the order of client MAC address.
Syntax
display wlan client { interface wlan-radio [ radio-number ] | mac-address mac-address | service-template service-template-number } [ verbose ] [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
interface wlan-radio radio-number: Displays information about clients that are attached to the specified WLAN-radio interface.
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, which is a case sensitive string of 1 to 256 characters.
Examples
# Display information about all the 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 [email protected] 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 is displayed as -NA- if the client adopts plain-text authentication or cipher-text 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 : 60a4-4c82-c1ee
User Name : -NA-
IP Address : 50.30.1.3
AID : 1
Radio Interface : WLAN-Radio1/0/1
Service Template Number : 1
SSID : office
BSSID : 0023-8900-4320
Port : WLAN-BSS32
VLAN : 30
State : Running
Power Save Mode : Active
Wireless Mode : 11ac
Channel Band-width : 20/40/80MHz
SM Power Save Enable : Disabled
Short GI for 20MHz : Supported
Short GI for 40MHz : Supported
Short GI for 80MHz : Supported
Short GI for 160/80+80MHz : Not Supported
LDPC RX capability : Not Supported
STBC TX capability : Supported
STBC RX capability : Supported For 1 Nss
Support VHT-MCS and Nss Set : 2,2,2,3,3,3,3,3
BLOCK ACK-TID 0 : IN
QoS Mode : WMM
Listen Interval (Beacon Interval) : 10
RSSI : 54
Rx/Tx Rate : 6/1300
Client Type : PRE-RSNA
Authentication Method : Open System
Authentication Mode : Central
AKM Method : None
Key Derivation : -NA-
4-Way Handshake State : -NA-
Group Key State : -NA-
Encryption Cipher : Clear
PMF Status : -NA-
Roam Status : Normal
Roam Count : 0
Up Time (hh:mm:ss) : 00:05:25
-------------------------------------------------------------------------------
Table 2 Command output
Field |
Description |
MAC address |
MAC address of the client. |
User Name |
Username of the client: · The field is displayed as -NA- if the client adopts plain-text authentication or cipher-text 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. |
Radio Interface |
WLAN radio interface. |
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. |
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, and 802.11ac. |
Channel Band-width |
Channel bandwidth, 20 MHz, 40 MHz, or 80 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. |
Short GI for 80MHz |
Whether the client supports short GI when its channel bandwidth is 80 MHz. |
Short GI for 160/80+80MHz |
Whether the client supports short GI when its channel bandwidth is 160/80+80 MHz. |
LDPC |
Whether LDPC is supported: · Not Supported. · Supported. |
STBC Tx Capability |
STBC transmission capability: · Not Supported. · Supported. The AP and a client negotiate the STBC transmission capability. The negotiation can succeed only when both the AP and client have STBC transmission capability. |
STBC Rx Capability |
STBC receive capability: · Not Supported. · Supported. The AP and a client negotiate the STBC receive capability. The negotiation can succeed only when both the AP and client have STBC receive capability. |
Support MCS Set |
MCS supported by the client. |
Support VHT-MCS and Nss Set |
VHT-MCS and NSS 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. |
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(Beacon 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. |
Client Type |
Client type such as RSN, WPA, or Pre-RSN. |
Authentication Method |
Authentication method such as open system or shared key. |
AKM Method |
AKM suite used such as Dot1X or PSK. |
Key Derivation |
Key derivation type: · SHA1—Uses the HMAC-SHA1 hash algorithm. · SHA256—Uses the HMAC-SHA256 hash algorithm. · -NA-—No key derivation algorithm is involved for the authentication type. |
4-Way Handshake State |
Display 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 |
Display 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. |
PMF Status |
Management frame protection state: · Active. · Inactive. · -NA-—No PMF is involved for the authentication type. |
Roam Status |
Display the roam status such as Normal or Fast Roaming. |
Roam Count |
Roaming count of the client, including intra-AC roaming and inter-AC roaming. |
Up Time |
Time for which the client has been associated with the AP. |
display wlan client beacon-report
Use display wlan client beacon-report to display beacon reports received from clients.
Syntax
display wlan client [ mac-address mac-address ] beacon-report [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
mac-address mac-address: Specifies the MAC address of a client. If the mac-address mac-address option is not specified, beacon reports from all clients 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.
Examples
# Display beacon reports received from the specified client.
<Sysname> display wlan client mac-address 000f-e265-6400 beacon-report
Report Information
-------------------------------------------------------------------------------------
MAC Address : 000f-e265-6400
Total Number of Reports : 4
----------------------------------------------------------------------------------------Channel BSSID Regulatory Class Antenna ID SSID
1 0026-3e08-1150 12 1 eagle
1 0026-3e08-1151 12 1 eagle
6 0026-3e08-1152 12 1 eagle
6 0026-3e08-1153 12 1 eagle
-------------------------------------------------------------------------------------
Table 3 Command output
Field |
Description |
MAC address |
MAC address of the client. |
Total Number of Reports |
Total number of received beacon reports. |
Channel |
Channel number. |
BSSID |
ID of the BSS. |
Regulatory Class |
Regulatory class with the value of 12 or 5. For more information, see the 802.11k protocol. |
Antenna ID |
ID of the antenna. |
SSID |
SSID with which the client is associated. |
display wlan client bridge
Use display wlan client bridge to display information about bridge clients.
Syntax
display wlan client bridge [ interface wlan-radio [ radio-number ] ] [ verbose ] [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
interface wlan-radio radio-number: Specifies a WLAN-Radio interface by its number.
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, which is a case-sensitive string of 1 to 256 characters.
Usage guidelines
Clients mentioned in this command refer to bridges working as clients to associate with the AP.
This command can display information about only H3C wireless bridges.
Examples
# Display information about all clients.
<Sysname> display wlan client bridge
Total Number of Clients : 1
Client Information
SSID: dragon
--------------------------------------------------------------------------------
MAC Address User Name APID/RID IP Address VLAN
--------------------------------------------------------------------------------
5866-baf2-d7cd -NA- 2 /2 192.168.1.48 1
--------------------------------------------------------------------------------
Table 4 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 is displayed as -NA- if the client uses plain-text authentication or cipher-text authentication with no username. · 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 with which the client is associated. |
IP Address |
IP address of the client. |
VLAN |
VLAN to which the client belongs. |
# Display detailed information about all clients.
<Sysname> display wlan client bridge verbose
Total Number of Clients : 1
Client Information
-------------------------------------------------------------------------------
MAC Address : 5866-baf2-d7cd
User Name : -NA-
IP Address : 192.168.1.48
AID : 1
AP Name : floor11
Radio Id : 2
Service Template Number : 1
SSID : dragon
BSSID : 5866-ba21-2770
Port : WLAN-DBSS1:0
VLAN : 1
State : Running
Power Save Mode : Active
Wireless Mode : 11gn
Channel Band-width : 20MHz
SM Power Save Enable : Disabled
Short GI for 20MHz : Supported
Short GI for 40MHz : Not Supported
STBC TX capability : Supported
STBC RX capability : Supported
Support MCS Set : 0,1,2,3,4,5,6,7
BLOCK ACK-TID 0 : IN
QoS Mode : WMM
Listen Interval (Beacon Interval) : 1
RSSI : 80
Rx/Tx Rate : 52/0
Client Type : PRE-RSNA
Authentication Method : Open System
Authentication Mode : Central
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:13:56
Serial Number : 219801A0BHM125002207
Device Information : WB524
Software Version : WB524V100R004
Associated AP RSSI : -NA-
Associated AP SNR : -NA-
Tx Power (dBm) : -NA-
Rx Packets : 0
Rx Bytes : 0
Tx Packets : 0
Tx Bytes : 0
Tx Dropped Packets : 0
Command Execution Result : -NA-
Table 5 Command output
Field |
Description |
MAC address |
MAC address of the client. |
User Name |
Username of the client: · The field is displayed as -NA- if the client uses plain-text authentication or cipher-text authentication with no username. · If the client uses the portal authentication method, the field does not display the portal username of the client. |
IP Address |
IP address of the client. |
AID |
Association ID of the client. |
AP Name |
Name of the associated AP. |
Radio Id |
ID of the radio with which the client is associated. |
Service Template Number |
Serial number of the service template. |
SSID |
SSID of the client. |
Port |
WLAN-DBSS interface associated with the client. |
VLAN |
VLAN to which the client belongs. |
State |
State of the client: · Running—The client is connected to the AC through the primary link. · Running (Backup)—The client is connected to the AC through the backup link. |
Power Save Mode |
Client's power save mode, active or sleep. |
Wireless Mode |
Wireless mode such as 802.11a, 802.11b, 802.11g, 802.11gn, and 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. · 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. |
STBC Tx Capability |
· Not Supported. · Supported. The AP and a client negotiate the STBC transmission capability. The negotiation can succeed only when both the AP and client have STBC transmission capability. |
STBC Rx Capability |
· Not Supported. · Supported. The AP and a client negotiate the STBC receive capability. The negotiation can succeed only when both the AP and client have STBC receive capability. |
Support MCS Set |
MCS supported by the client. |
BLOCK ACK-TID |
BLOCK ACK is negotiated based on traffic identifier (TID): · 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 (Beacon 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 |
The sending and receiving rates of the frames such as data, management, and control frames. For the AC + fit AP architecture, there is delay because Rx rate information is transmitted periodically from AP to AC. |
Client Type |
Client type such as RSN, WPA, or Pre-RSN. |
Authentication Method |
Authentication method such as open system or shared key. |
Authentication Mode |
Authentication mode: · Central—Central authentication. The AC authenticates clients. · Local—Local authentication. The AP authenticates clients. |
AKM Method |
AKM suite used such as Dot1X or PSK. |
4-Way Handshake State |
Display either of the 4-way handshake states: · IDLE—Displayed in initializing state. · PTKSTART—Displayed when the 4–way handshake initialization is completed. · PTKNEGOTIATING—Displayed after valid message 3 is sent. · PTKINITDONE—Displayed when the 4-way handshake is successful. |
Group Key State |
Display the group key state: · IDLE—Displayed in initializing state. · REKEYNEGOTIATE—Displayed after the AC sends the initial message to the client. · REKEYESTABLISHED—Displayed when re-keying is successful. |
Encryption Cipher |
Encryption mode such as clear or crypto. |
Roam Status |
Display the roam status: · Normal · Intra-AC roam association · Inter-AC roam association |
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. |
Serial Number |
Serial number of the client. |
Device Information |
Device model of the client. |
Software Version |
Software version of the client. |
Associated AP RSSI |
Received Signal Strength Indicator. It indicates the associated AP's signal strength detected by the client. |
Associated AP SNR |
The associated AP's SNR detected by the client. |
Tx Power (dBm) |
Transmission rate of the client radio. |
Rx Packets |
Total number of packets received by the client. |
Rx Bytes |
Total number of bytes received by the client. |
Tx Packets |
Total number of packets sent by the client. |
Tx Bytes |
Total number of bytes sent by the client. |
Tx Dropped Packets |
Total number of dropped packets by the client. |
Command Execution Result |
Command execution result reported by the client. The field is displayed as -NA- if the device did not receive any command execution results reported by the client. For more information about the output, see the wireless bridge manual. |
display wlan service-template
Use display wlan service-template to display WLAN service template information. If no service template is specified, all service templates are displayed.
Syntax
display wlan service-template [ service-template-number ] [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
service-template-number: Number of a service template, in the range of 1 to 1024.
|: 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.
Examples
# Display the configuration information for service template 1.
<Sysname> display wlan service-template 1
Service Template Parameters
--------------------------------------------------------------------------
Service Template Number : 1
SSID : nsw-nsw
Description : Not Configured
Service Template Type : Crypto
Security IE : WPA2(RSN) WPA
Authentication Method : Open System
Beacon-measurement : Enable
Beacon-measurement Interval : 30
Beacon-measurement Type : Passive
SSID-hide : Disabled
Cipher Suite : TKIP AES-CCMP
WEP Key Index 1 : WEP40
WEP Key Mode : ASCII
WEP Key : ******
TKIP Countermeasure Time(s) : 60
PTK Life Time(s) : 180
GTK Rekey : Enabled
GTK Rekey Method : Packet-based
GTK Rekey Packets : 5000
PMF Status : Optional
Service Template Status : Enabled
Maximum clients per BSS : 35
--------------------------------------------------------------------------
Field |
Description |
Service Template Number |
Current service template number. |
SSID |
SSID that is associated with the client. |
Service Template Type |
Service template type crypto or clear. |
Security IE |
Security IE such as WPA and WPA2 (RSN). |
Authentication Method |
Type of authentication used, open system or shared key. |
Authentication Mode |
Authentication mode: · Central—Central authentication. The AC authenticates clients. · Local—Local authentication. The AP authenticates clients. · Backup—Backup authentication. |
Beacon-measurement |
Enable—The beacon measurement function is enabled. |
Beacon-measurement Interval |
Interval for the AP to send beacon requests to clients. The interval is in seconds. |
Beacon-measurement Type |
Beacon measurement mode: · Passive. · Active. · Beacon-table. |
SSID-hide |
Enabled or disabled. |
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(s) |
Time for GTK rekey in seconds. |
PMF Status |
Management frame protection status: · Disable. · Optional—PMF is enabled. All clients can associate with the AP. · Mandatory—PMF is enabled. Only clients supporting PMF can associate with the AP. |
Service Template Status |
Status such as enabled or disabled. |
Maximum clients per BSS |
Maximum number of associated clients per BSS. |
display wlan statistics client
Use display wlan statistics client to display client statistics.
Syntax
display wlan statistics client { all | mac-address mac-address } [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command 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.
Examples
# Display the statistics of all the clients.
<Sysname> display wlan statistics client all
Client Statistics
--------------------------------------------------------------------------
AP Name : sysname
Radio Id : 1
SSID : office
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 7 Command output
Field |
Description |
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. |
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 service-template
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.
Syntax
display wlan statistics service-template service-template-number [ connect-history ] [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command 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.
Examples
# Display the statistics of service template 1.
<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 8 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 9 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
Use distance to configure the maximum distance that the radio can cover.
Use undo distance to restore the default.
Syntax
distance distance
undo distance
Default
The radio can cover 1 km (0.62 miles) at most.
Views
WLAN-Radio interface view
Default command 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).
Examples
# Configure the maximum distance that the radio can cover as 5 km (3.11 miles).
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] distance 5
dtim
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.
Syntax
dtim counter
undo dtim
Default
The DTIM is 1.
Views
WLAN-Radio interface view
Default command level
2: System level
Parameters
counter: Number of beacon intervals between DTIM transmissions. The value is in the range of 1 to 31.
Examples
# Set the DTIM counter to 10.
<Sysname> System-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] dtim 10
fast-association enable
Use fast-association enable to enable fast association.
Use undo fast-association enable to disable fast association.
Syntax
fast-association enable
undo fast-association enable
Default
Fast association is disabled.
Views
Service template view
Default command level
2: System level
Usage guidelines
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
Use fragment-threshold to specify the maximum length of frames that can be transmitted without fragmentation. A packet that exceeds the specified fragment threshold is fragmented.
Use undo fragment-threshold to restore the default value.
Syntax
fragment-threshold size
undo fragment-threshold
Default
The fragment threshold is 2346 bytes. Frames that exceed 2346 bytes are fragmented.
Views
WLAN-Radio interface view
Default command 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.
Examples
# Specify the fragment threshold as 2048 bytes.
<Sysname> System-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] fragment-threshold 2048
green-energy-management enable
Use green-energy-management enable to enable the energy saving function. When this function is enabled, a radio transmits and receives 1 spatial stream at a time to save power if no clients are associated with the radio.
Use undo green-energy-management enable to disable the energy saving function.
Syntax
green-energy-management enable
undo green-energy-management enable
Default
The energy saving function is disabled.
Views
WLAN-Radio interface view
Default command level
2: System level
Examples
# Enable the energy saving function.
<sysname> system-view
[sysname] interface wlan-radio 1/0/1
[sysname-WLAN-Radio1/0/1] green-energy-management enable
long-retry threshold
Use long-retry threshold to set the number of re-transmission attempts for frames larger than the RTS threshold.
Use undo long-retry threshold to restore the default.
Syntax
long-retry threshold count
undo long-retry threshold
Default
The long retry threshold is 4.
Views
WLAN-Radio interface view
Default command level
2: System level
Parameters
count: Number of retransmission attempts for frames larger than the RTS threshold, in the range of 1 to 15.
Examples
# Specify the long-retry threshold as 10.
<Sysname> System-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] long-retry threshold 10
max-power
Use max-power to configure the maximum transmission power on the radio.
Use undo max-power to restore the default.
Syntax
max-power radio-power
undo max-power
Default
The maximum radio power varies with country codes, channels, AP models, radio types, and antenna types. If 802.11n or 802.11ac is adopted, the maximum radio power also depends on the bandwidth mode.
Views
WLAN-Radio interface view
Default command level
2: System level
Parameters
radio-power: Maximum radio transmission power, which varies with country codes and radio types.
Examples
# Specify the max transmission power of radio 1/0/1 as 5.
<Sysname> System-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] radio-type dot11a
[Sysname-WLAN-Radio1/0/1] max-power 5
max-rx-duration
Use max-rx-duration to specify the interval for the AP to hold a received frame. An AP holds received packets in its buffer memory.
Use undo max-rx-duration to restore the default.
Syntax
max-rx-duration interval
undo max-rx-duration
Default
The max-rx-duration is 2000 milliseconds.
Views
WLAN-Radio interface view
Default command level
2: System level
Parameters
interval: 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.
Examples
# Set the max-rx-duration as 5000 milliseconds.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] max-rx-duration 5000
mimo
Use mimo to set the MIMO mode for a radio.
Use undo mimo to restore the default.
Syntax
mimo { 1x1 | 2x2 | 3x3 }
undo mimo
Default
No MIMO mode is set for a radio.
Views
WLAN-Radio interface view
Default command level
2: System level
Parameters
1x1: Enables the radio to transmit and receive 1 space stream at a time.
2x2: Enables the radio to transmit and receive 2 space streams at a time.
3x3: Enables the radio to transmit and receive 3 space streams at a time.
Usage guidelines
The following matrix shows the command and hardware compatibility:
Hardware series |
Model |
Command compatibility |
WA4600 series |
WA4620i-ACN |
Yes |
WA4620E-ACN |
Yes |
|
WA4300 series |
WA4320H-ACN WA4320i-ACN WA4320-ACN WA4320-ACN-PI |
Yes The 3x3 keyword is not supported. |
The MIMO mode supported by an AP depends on the space streams that the AP can transmit and receive. For example, if an AP can transmit and receive 1 space stream at a time, the MIMO mode of the AP can only be 1x1. If an AP can transmit and receive 2 space streams at a time, the MIMO mode of the AP can be 1x1 or 2x2.
Examples
# Set the MIMO mode for WLAN-radio 1/0/1 to 1×1.
<sysname> system-view
[sysname] interface wlan-radio 1/0/1
[sysname-WLAN-Radio1/0/1] mimo 1x1
preamble
Use preamble to specify the type of preamble that an AP can support.
Use undo preamble to restore the default.
Syntax
preamble { long | short }
undo preamble
Default
The short preamble is supported.
Views
WLAN-Radio interface view
Default command level
2: System level
Parameters
long: Indicates that only frames with a long preamble can be transmitted.
short: Indicates that frames with either a short preamble or a long preamble can be transmitted.
Usage guidelines
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.
802.11a, 802.11an, and 802.11ac does not support this configuration.
Examples
# Configure the AP to support long preamble.
<Sysname> System-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] radio-type dot11b
[Sysname-WLAN-Radio1/0/1] preamble long
protection-mode
Use protection-mode to specify a collision avoidance mechanism.
Use undo protection-mode to restore the default.
Syntax
protection-mode { cts-to-self | rts-cts }
undo protection-mode
Default
The collision avoidance mechanism is CTS-to-Self.
Views
WLAN-Radio interface view
Default command 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.
Usage guidelines
Compared with RTS/CTS, CTS-to-Self reduces the number of control frames. However, data collisions still occur when some clients are hidden and thus cannot receive the CTS frames sent by the AP. Therefore, the RTS/CTS mechanism can solve the data collision problem in a larger coverage than RTS/CTS.
For more information about CTS-to-Self and RTS/CTS, see WLAN Configuration Guide.
Examples
# Configure the collision avoidance mechanism as RTS/CTS.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] protection-mode rts-cts
radio-type
Use radio-type to specify the radio type to be used by a radio.
Use undo radio-type to restore the default.
Syntax
radio-type { dot11a | dot11an | dot11ac | dot11b | dot11g | dot11gn }
undo radio-type
Default
The default radio type depends on the antenna model.
Views
WLAN-Radio interface view
Parameters
dot 11a: Specifies the 802.11a radio type.
dot11an: Specifies the 802.11an radio type.
dot11ac: Specifies the 802.11ac radio type.
dot 11b: Specifies the 802.11b radio type.
dot 11g: Specifies the 802.11g radio type.
dot11gn: Specifies the 802.11gn (2.4 GHz) radio type.
Usage guidelines
WLAN allows you to modify the default radio type for different types of AP.
Examples
# Specify the radio type as 802.11an for interface WLAN-Radio 1/0/1.
<Sysname> System-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] radio-type dot11an
reset wlan statistics
Use reset wlan statistics to clear client or radio statistics.
Syntax
reset wlan statistics client { all | mac-address mac-address }
Views
User view
Default command 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.
Examples
# Clear the radio statistics of all clients.
<Sysname> reset wlan statistics client all
reset wlan client
Use reset wlan client to cut off a client or all clients. When this command is used, the AP sends a de-authentication frame to the client and the client is removed from the WLAN service.
Syntax
reset wlan client { all | mac-address mac-address }
Views
User view
Default command level
2: System level
Parameters
all: Cuts off all clients.
mac address mac-address: Cuts off the client specified by the MAC address.
Examples
# Cut off the client with MAC address 000f-e2cc-8501.
<Sysname> reset wlan client mac-address 000f-e2cc-8501
rts-threshold
Use rts-threshold to specify the request to send (RTS) threshold length. If a frame is larger than this value, the RTS mechanism is used.
Use undo rts-threshold to restore the default.
Syntax
rts-threshold size
undo rts-threshold
Default
The RTS threshold is 2346 bytes.
Views
WLAN-Radio interface view
Default command level
2: System level
Parameters
size: Length of frames for which the request to send (RTS) method is used. The value is in the range of 0 to 2346 bytes.
Usage guidelines
Request to Send (RTS) is used to avoid data sending collisions in a WLAN. You need to set a rational value:
A small value causes RTS packets to be sent more often, consuming more of the available bandwidth. However, the system can recover more quickly from interference or collisions when RTS packets are sent more frequently.
Examples
# Specify the RTS threshold as 2046 bytes.
<Sysname> System-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] rts-threshold 2046
service-template (WLAN-Radio interface view)
Use service-template to map a service template to the current radio.
Use undo service-template to remove the mapping.
Syntax
service-template service-template-number interface wlan-bss wlan-bss-number
undo service-template service-template-number
Default
No service-template is mapped to a radio.
Views
WLAN-Radio interface view
Default command level
2: System level
Parameters
service-template-number: Number of a service template in the range of 1 to 1024.
wlan-bss-number: Number of a WLAN-BSS interface in the range of 0 to 255.
Examples
# Map service template 1 to interface WLAN-BSS 1 on interface WLAN-Radio 1/0/1.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] service-template 1 interface WLAN-BSS 1
service-template (service template view)
Use service-template to map a service template to a WLAN-BSS interface on the current WLAN-Radio interface.
Use undo service-template to remove the mapping.
Syntax
service-template { disable | enable }
Default
The service template is disabled.
Views
Service template view
Default command level
2: System level
Parameters
disable: Disables the service template.
enable: Enables the service template.
Examples
# Enable service template 1.
<Sysname> system-view
[Sysname] wlan service-template 1 clear
[Sysname-wlan-st-1] ssid clear
[Sysname-wlan-st-1] authentication-method open-system
[Sysname-wlan-st-1] service-template enable
short-gi enable
Use short-gi enable to enable the short GI function.
Use undo short-gi enable to disable the short GI function.
Syntax
short-gi enable
undo short-gi enable
Default
The short GI function is enabled.
Views
WLAN-Radio interface view
Default command level
2: System level
Usage guidelines
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] interface wlan-radio 1/0/1
[sysname-WLAN-Radio1/0/1] undo short-gi enable
short-retry threshold
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.
Syntax
short-retry threshold count
undo short-retry threshold
Default
The short retry threshold is 7.
Views
WLAN-Radio interface view
Default command 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.
Examples
# Specify the short retry threshold as 10.
<Sysname> System-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] short-retry threshold 10
shut-all-led enable
Use shut-all-led enable to shut down all LEDs on the AP.
Use undo shut-all-led enable to restore the default.
Syntax
shut-all-led enable
undo shut-all-led enable
Default
LEDs on the AP light based on AP status.
Views
System view
Default command level
2: System level
Examples
# Shut down all LEDs on the AP.
<Sysname> system-view
[Sysname] shut-all-led enable
ssid
Use ssid to set the SSID for the current service template.
Use undo ssid to remove the SSID.
Syntax
ssid ssid-name
undo ssid
Default
No SSID is set for the service template.
Views
Service template view
Default command level
2: System level
Parameters
ssid-name: Name of the service set identifier, a case-sensitive string of 1 to 32 characters.
Usage guidelines
An SSID should be as unique as possible. For security, do not include the company name in the SSID. Additionally, do not use a long random string as the SSID. Doing so only adds payload to the header field and does not improve 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
stbc enable
Use stbc enable to enable Space Time Block Coding (STBC).
Use undo stbc enable to disable STBC.
Syntax
stbc enable
undo stbc enable
Default
STBC is enabled.
Views
WLAN-Radio interface view
Default command level
2: System level
Usage guidelines
Enabling STBC improves the SNR of the receiver and data transmission reliability.
STBC takes effect only when the number of antennas on an AP is greater than the number of spatial streams corresponding to the rates used by the radio. For example, if the MCS is 8 and the corresponding spatial stream number is 2, STBC takes effect only when the AP has at least three antennas.
Examples
# Enable STBC.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] stbc enable
wlan broadcast-probe reply
Use wlan broadcast-probe reply to enable the AP to respond to the probe requests without SSID.
Use undo wlan broadcast-probe reply to remove the configuration to cause the AP to only respond to probe requests that carry the specified SSID.
Syntax
wlan broadcast-probe reply
undo wlan broadcast-probe reply
Default
An AP responds to probe requests without SSID.
Views
System view
Examples
# Enable the AP to respond to probe requests without SSID.
<Sysname> system-view
[Sysname] wlan broadcast-probe reply
wlan client idle-timeout
Use wlan client idle-timeout to specify the client idle timeout.
Use undo wlan client idle-timeout to restore the default.
Syntax
wlan client idle-timeout interval
undo wlan client idle-timeout
Default
The client idle timeout is 3600 seconds.
Views
System view
Default command level
2: System level
Parameters
interval: Maximum interval for which the link between the AP and a client ( power-save or awake ) can be idle. The value is in the range of 60 to 86400 seconds.
Usage guidelines
If the AP does not receive any data from a client within the client idle timeout interval, it removes the client from the network.
Examples
# Specify the client idle timeout as 600 seconds.
<Sysname> system-view
[Sysname] wlan client idle-timeout 600
wlan client keep-alive
Use client keep-alive to specify the client keep alive interval.
Use undo client keep-alive to restore the default.
Syntax
wlan client keep-alive interval
undo wlan client keep-alive
Default
The client keep-alive functionality is disabled.
Views
System view
Default command level
2: System level
Parameters
interval: Interval between keep alive requests. The value is in the range of 3 to 1800 seconds.
Usage guidelines
The keep-alive mechanism is used to detect clients that are segregated from the system for various reasons such as power failure or crash, and disconnect them from the AP.
Examples
# Specify the client keep-alive interval as 60 seconds.
<Sysname> system-view
[Sysname] wlan client keep-alive 60
wlan country-code
Use wlan country-code to specify the global country code.
Use undo wlan country-code to restore the default.
Syntax
wlan country-code code
undo wlan country-code
Default
The global country code value is CN.
Views
System view
Default command level
2: System level
Parameters
code: Specifies a global country code. See Table 10.
Table 10 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 |
Usage guidelines
The country code determines characteristics such as the power level and the total number of channels. You must set the correct country code or area code for the AP.
Examples
# Specify the global country code as US.
<Sysname> system-view
[Sysname] wlan country-code us
wlan link-test
Use wlan link-test to RFPing a client.
Syntax
wlan link-test mac-address
Views
User view
Default command level
1: Monitor level
Parameters
mac-address: MAC address of a client. Only clients that have been associated with the AP can be RFPinged.
Examples
# Perform an RFPing operation on 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
--------------------------------------------------------------------------------
VHT-MCS Rate(Mbps) TxCnt RxCnt RSSI Retries RTT(ms)
--------------------------------------------------------------------------------
NSS = 1
--------------------------------------------------------------------------------
0 29.3 5 5 68 0 3
1 58.5 5 5 69 0 0
2 97.5 5 4 70 2 0
3 117 5 4 71 2 0
4 175.5 5 5 70 0 0
5 234 5 5 69 0 0
6 263.3 5 5 69 0 0
7 292.5 5 5 69 0 0
8 351 5 5 69 0 0
9 390 5 5 69 0 0
--------------------------------------------------------------------------------
NSS = 2
--------------------------------------------------------------------------------
0 58.5 5 5 69 0 0
1 117 5 4 70 2 0
2 175.5 5 5 70 0 0
3 234 5 5 70 0 0
4 351 5 5 69 0 0
5 520 5 4 70 2 0
6 526.5 5 4 69 2 0
7 585 5 5 69 0 0
8 702 5 5 70 0 0
9 780 5 5 69 0 0
--------------------------------------------------------------------------------
NSS = 3
--------------------------------------------------------------------------------
0 87.8 5 5 70 0 0
1 175.5 5 5 70 0 0
2 263.3 5 5 70 0 0
3 351 5 5 70 0 0
4 526.5 5 4 69 2 0
5 702 5 4 69 6 0
6 NA 5 0 0 0 0
7 975 5 0 0 10 0
8 1170 5 0 0 10 0
9 1300 5 0 0 10 0
--------------------------------------------------------------------------------
Table 11 RFPing operation results
Field |
Description |
No./MCS |
· The VHT-MCS field is displayed for an RFPing operation to an 802.11ac client to indicate the VHT-MCS value of the client. · The No. field is displayed for an RFPing operation to a non-802.11n client or a non-802.11ac client to indicate the rate index of the client. · The MCS field is displayed for an RFPing operation to an 802.11n client to indicate 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) |
RTT from the time the radio interface sends a ping packet to the time it receives a response from the client. |
NSS |
The NSS field is displayed for an RFPing operation to an 802.11ac client to indicate the supported number of spatial streams of the client. |
wlan service-template
Use wlan service-template to create a service template and enter service template view. If the service template exists, you can directly enter service template view.
Use undo wlan service-template to delete the service template and related configurations. If the specified service template is mapped to a radio, it cannot be directly deleted before it is un-mapped.
Syntax
wlan service-template service-template-number { clear | crypto }
undo wlan service-template service-template-number
Default
The default setting for this command depends on your device model.
Views
System view
Default command 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 will be sent in clear text after the template is mapped to an AP.
crypto: Sets the current service template type to crypto, which means data will be sent in cipher text after the template is mapped to an AP.
Usage guidelines
You cannot change an existing service template to another type. To do so, delete the existing 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
[Sysname-wlan-st-1]
wlan-client-isolation enable
Use wlan-client-isolation enable to enable WLAN client isolation.
Use undo wlan-client-isolation enable to disable WLAN client isolation.
Syntax
wlan-client-isolation enable
undo wlan-client-isolation enable
Default
WLAN client isolation is enabled.
Views
System view
Default command level
2: System level
Examples
# Disable WLAN client isolation.
<Sysname> system-view
[Sysname] undo wlan-client-isolation enable
wlan uplink-interface
Use wlan uplink-interface to specify an uplink interface.
Use undo wlan uplink-interface to remove the configuration.
Syntax
wlan uplink-interface interface-type interface-number
undo wlan uplink-interface interface-type interface-number
Default
No uplink interface is configured.
Views
System view
Default command level
2: System level
Parameters
interface-type interface-number: Specifies an interface by its type and number.
Usage guidelines
If all configured uplink interfaces are down, WLAN service is unavailable. If one of them is up, WLAN service is available.
You can specify an Ethernet port or a WLAN-Radio interface as an uplink interface as needed. If you specify a WLAN-Radio interface as an uplink interface, you also need to map a mesh profile to the interface.
You can use this command to configure multiple uplink interfaces.
Examples
# Configure GigabitEthernet 1/0/1 as an uplink interface.
<Sysname> system-view
[Sysname] wlan uplink-interface GigabitEthernet 1/0/1