- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
01-WLAN access commands | 343.80 KB |
client-mode authentication-method
client-mode roam calibration-interval
client-mode roam rssi-threshold
client-mode roam scan-interval
display wlan ap all client-number
display wlan ap all radio client-number
display wlan client online-duration
display wlan client-mode packet-statistics
display wlan client-mode radio
display wlan client-mode roam-enhance bss
display wlan client-mode roaming-state
display wlan statistics client
display wlan statistics connect-history
display wlan statistics service template
reset wlan statistics service-template
wlan client bss-load-ie enable
wlan client keep-alive interval
wlan client reauthentication-period
wlan dynamic-blacklist lifetime
wlan static-blacklist mac-address
wlan web-server max-client-entry
WLAN access commands
access-control acl
Use access-control acl to specify an ACL for ACL-based access control.
Use undo access-control acl to restore the default.
Syntax
access-control acl acl-number
undo access-control acl
Default
No ACL is specified.
Views
Service template view
Predefined user roles
network-admin
Parameters
acl-number: Specifies the number of a Layer 2 ACL, in the range of 4000 to 4999.
Usage guidelines
This feature controls client access by using the specified ACL rules. When the device receives an association request, it performs the following actions:
· Allows the client to access the WLAN if the MAC address of the client matches the MAC address attribute or MAC address OUI attribute in a rule and the rule action is permit. If multiple clients match the OUI attribute, all these clients are allowed to access the WLAN.
· Denies the client's access to the WLAN if no match is found or the matched rule has a deny statement.
When you configure this feature, follow these restrictions and guidelines:
· If the specified ACL contains a deny statement, configure a permit statement for the ACL to permit all clients. If you do not do so, no clients can come online.
· ACL-based access control configuration takes precedence over whitelist and blacklist configuration.
· You can specify only one ACL. If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Create ACL 4000 and create ACL rules to permit the client with MAC address 000e-35b2-000e and clients with the specified OUI. Specify ACL 4000 for service template service1.
<Sysname> system-view
[Sysname] acl mac 4000
[Sysname-acl-mac-4000] rule 0 permit source-mac 000e-35b2-000e ffff-ffff-ffff
[Sysname-acl-mac-4000] rule 1 permit source-mac 000e-35b2-000f ffff-ff00-0000
[Sysname-acl-mac-4000] rule 2 deny
[Sysname-acl-mac-4000] quit
[Sysname] wlan service-template service1
[Sysname-wlan-st-service1] access-control acl 4000
beacon ssid-advertise
Use beacon ssid-advertise to enable Service Set Identifier (SSID) broadcast in beacon frames.
Use undo beacon ssid-advertise to restore the default.
Syntax
beacon ssid-advertise
undo beacon ssid-advertise
Default
An AP hides SSIDs in beacon frames when the maximum number of associated clients is reached.
Views
Service template view
Predefined user roles
network-admin
Usage guidelines
This feature enables new clients to discover APs even if the number of associated clients reaches the upper limit. However, these clients still cannot associate with the APs.
Examples
# Enable SSID broadcast in beacon frames.
<Sysname> system-view
[Sysname] wlan service-template service1
[Sysname-wlan-st-s1] beacon ssid-advertise
Related commands
client max-count
beacon ssid-hide
Use beacon ssid-hide to enable SSID hidden in beacon frames.
Use undo beacon ssid-hide to restore the default.
Syntax
beacon ssid-hide
undo beacon ssid-hide
Default
SSIDs are not hidden in beacon frames.
Views
Service template view
Predefined user roles
network-admin
Usage guidelines
This command disables a radio from broadcasting SSIDs in the beacon frames and responding to probe requests after the specified service template is bound to the radio.
Examples
# Enable SSID hidden in beacon frames.
<Sysname> system-view
[Sysname] wlan service-template service1
[Sysname-wlan-st-service1] beacon ssid-hide
client max-count
Use client max-count to set the maximum number of associated clients for a radio or a service template.
Use undo client max-count to restore the default.
Syntax
client max-count max-number
undo client max-count
Default
The number of associated clients for a radio or a service template is not limited.
Views
Service template view
Predefined user roles
network-admin
Parameters
max-number: Specifies the maximum number of clients in the range of 1 to 512.
Usage guidelines
With this feature configured, new clients cannot access the WLAN and the SSID is hidden when the maximum number is reached.
Examples
# Set the maximum number of associated clients to 38 for service template service1.
<Sysname> system-view
[Sysname] wlan service-template service1
[Sysname-wlan-st-service1] client max-count 38
Related commands
beacon ssid-hide
client smart-access enable
Use client smart-access enable to enable smart client access.
Use undo client smart-access enable to restore the default.
Syntax
client smart-access enable
undo client smart-access enable
Default
Smart client access is disabled.
Views
Service template view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
This feature enables H3C wireless clients to access the WLAN automatically when the AKM mode is set to PSK or when the radio is bound to an empty service template.
Examples
# Enable smart client access.
<Sysname> system-view
[Sysname] wlan service-template service1
[Sysname-wlan-st-service1] client smart-access enable
client-mode access-retransmit
Use client-mode access-retransmit to set the maximum number of retransmissions for authentication and association requests and set the response timeout for the client-mode AP during wireless service association.
Use undo client-mode access-retransmit to restore the default.
Syntax
client-mode access-retransmit interval interval [ count count ]
undo client-mode access-retransmit
Default
The authentication and association response timeout is 300 milliseconds and a client-mode AP does not retransmit authentication or association requests during wireless service association.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
interval: Specifies the authentication and association response timeout in the range of 100 to 5000 in milliseconds.
count: Specifies the maximum number of retransmissions in the range of 1 to 10.
Usage guidelines
This command is configurable only on a radio interface enabled with the client mode. Disabling the client mode removes the configuration.
With this feature configured, the client-mode AP retransmits the authentication or association request after the timeout timer expires during wireless service association. If the maximum number of retransmissions is reached but no response is received, the AP attempts to associate with another BSS.
Examples
# Set the maximum number of retransmissions for authentication and association requests to 3 and set the response timeout to 500 ms.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] client-mode access-retransmit interval 500 count 3
Related commands
client-mode enable
client-mode authentication-method
Use client-mode authentication-method to specify the authentication method for the client-mode AP.
Use undo client-mode authentication-method to restore the default.
Syntax
client-mode authentication-method { open-system | shared-key | wpa2-psk }
undo client-mode authentication-method
Default
A client-mode AP uses the open-system authentication method.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
open-system: Specifies open-system authentication.
shared-key: Specifies shared-key authentication.
wpa2-psk: Specifies WPA2-PSK authentication.
Usage guidelines
This command is configurable only on a radio interface enabled with the client mode. Disabling the client mode removes the configuration.
If the WPA2-PSK authentication method is specified, you must configure the CCMP or TKIP cipher suite.
Examples
# Specify the authentication method as shared-key for the client-mode AP.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] client-mode authentication-method shared-key
Related commands
client-mode cipher-suite
client-mode enable
client-mode beacon-keepalive
Use client-mode beacon-keepalive to enable beacon keepalive for the client-mode AP.
Use undo client-mode beacon-keepalive to disable beacon keepalive for the client-mode AP.
Syntax
client-mode beacon-keepalive interval interval count count
undo client-mode beacon-keepalive
Default
Beacon keepalive is disabled for a client-mode AP.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
interval: Specifies the beacon keepalive interval in the range of 100 to 8191 in milliseconds.
count: Specifies the number of beacon keepalive attempts in the range of 1 to 100.
Usage guidelines
This command is configurable only on a radio interface enabled with the client mode. Disabling the client mode removes the configuration.
With this feature enabled, if the maximum number of keepalive attempts is reached but the client-mode AP fails to receive a beacon frame from the associated wireless service, the AP disconnects from the service.
As a best practice, set the beacon keepalive interval to a value twice the beacon sending interval or larger.
Examples
# Enable beacon keepalive for the client-mode AP, set the beacon keepalive interval to 100 milliseconds, and set the number of keepalive attempts to 5.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] client-mode beacon-keepalive interval 100 count 5
Related commands
client-mode enable
client-mode cipher-suite
Use client-mode cipher-suite to set the cipher suite and preshared key for the client-mode AP.
Use undo client-mode cipher-suite to restore the default.
Syntax
client-mode cipher-suite { ccmp | tkip | { wep40 | wep104 | wep128 } [ key-id key-id ] } key [ cipher | simple ] string
undo client-mode cipher-suite
Default
No cipher suite or preshared key is specified for a client-mode AP.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
ccmp: Specifies the AES-CCMP cipher suite.
tkip: Specifies the TKIP cipher suite.
wep40: Sets the WEP40 key.
wep104: Sets the WEP104 key.
wep128: Sets the WEP128 key.
key-id key-id: Sets the key ID in the range of 1 to 4. The default key ID is 1.
cipher: Sets a key in encrypted form.
simple: Sets a key in plaintext form. For security purposes, the key specified in plaintext form will be stored in encrypted form.
string: Specifies a key string. This argument is case sensitive. If you do not specify the simple or cipher keyword, the command sets a plaintext key. The key length varies by key type:
· ccmp or tkip simple—8 to 63 characters.
· wep40 simple—5 characters.
· wep104 simple—13 characters.
· wep128 simple—16 characters.
· ccmp or tkip cipher—8 to 117 characters.
· wep40, wep104, or wep128 cipher—37 to 73 characters.
Usage guidelines
This command is configurable only on a radio interface enabled with the client mode. Disabling the client mode removes the configuration.
Examples
# Specify the CCMP cipher suite and set the preshared key to 12345678 for the client-mode AP.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] client-mode cipher-suite ccmp key simple 12345678
Related commands
client-mode enable
client-mode connect
Use client-mode connect to connect the client-mode AP to a wireless service.
Syntax
client-mode connect
Views
Radio interface view
Predefined user roles
network-admin
Usage guidelines
Before executing this command, perform the following tasks:
· Enable the client mode.
· Specify the SSID with which the client-mode AP associates.
Client-mode APs can associate only with wireless services using the RSN security IE and PSK mode if the wireless services are encrypted.
After using the client-mode disconnect command to disconnect the client-mode AP from a wireless service, you can use this command to reconnect the AP to the service.
Examples
# Connect the client-mode AP to a wireless service.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] client-mode ssid service1
[Sysname-WLAN-Radio1/0/1] client-mode connect
Related commands
client-mode disconnect
client-mode enable
client-mode disconnect
Use client-mode disconnect to disconnect the client-mode AP from the wireless service.
Syntax
client-mode disconnect
Views
Radio interface view
Predefined user roles
network-admin
Usage guidelines
Before executing the command, make sure the client mode is enabled.
Examples
# Disconnect the client-mode AP from the wireless service.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] client-mode disconnect
Related commands
client-mode connect
client-mode enable
client-mode enable
Use client-mode enable to enable the client mode.
Use undo client-mode enable to disable the client mode.
Syntax
client-mode enable
undo client-mode enable
Default
The client mode is disabled.
Views
Radio interface view
Predefined user roles
network-admin
Usage guidelines
In client mode:
· Client-mode configuration can be deployed.
· The radio interface cannot be bound to any service templates or provide wireless access services.
· WDS cannot be enabled for the radio interface.
Disabling the client mode removes all client mode-related configurations.
Examples
# Enable the client mode.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] client-mode enable
client-mode link-hold-rssi
Use client-mode link-hold-rssi to set the client-mode link hold RSSI, the minimum signal strength for a client-mode link to be retained.
Use undo client-mode link-hold-rssi to restore the default.
Syntax
client-mode link-hold-rssi rssi
undo client-mode link-hold-rssi
Default
The client-mode link hold RSSI is 0.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
rssi: Specifies the link hold RSSI in the range of 0 to 100. Setting the value to 0 disables active link disconnection.
Usage guidelines
With this feature enabled, if the RSSI of the associated wireless service drops below the link hold RSSI, the client-mode AP disconnects from the current service and associates with a better one.
This command is configurable only on a radio interface enabled with the client mode.
Examples
# Set the client-mode link hold RSSI to 8.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] client-mode link-hold-rssi 18
Related commands
client-mode enable
client-mode min-record-rssi
Use client-mode min-record-rssi to set the minimum recording RSSI for the client-mode AP to record detected wireless services.
Use undo client-mode min-record-rssi to restore the default.
Syntax
client-mode min-record-rssi rssi
undo client-mode min-record-rssi
Default
The minimum recording RSSI for the client-mode AP to record detected wireless services is 15.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
rssi: Specifies the minimum recording RSSI in the range of 0 to 100.
Usage guidelines
The client-mode AP generates a BSS entry for each BSS detected during scanning. If the RSSI of a BSS is lower than the minimum recording RSSI, the AP does not update the BSS entry and reduces the roaming scanning aging count by one.
If enhanced roaming is disabled, this feature is configuration only on a radio interface enabled with the client mode. Disabling the client mode removes the configuration.
If enhanced roaming is enabled, this feature is configurable only on a radio interface enabled with enhanced roaming. Disabling enhanced roaming removes the configuration.
Examples
# Set the minimum recording RSSI to 20 for the client-mode AP to record detected wireless services.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] client-mode min-record-rssi 20
Related commands
client-mode enable
client-mode probe-keepalive
Use client-mode probe-keepalive to enable probe keepalive for the client-mode AP.
Use undo client-mode probe-keepalive to disable probe keepalive for the client-mode AP.
Syntax
client-mode probe-keepalive [ interval interval retry retries ]
undo client-mode probe-keepalive
Default
Probe keepalive is enabled for a client-mode AP. The probe request sending interval is 1000 milliseconds and the number of retransmissions is 5.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
interval interval: Specifies the probe request sending interval in the range of 100 to 60000 in milliseconds. The default interval is 1000.
retry retries: Specifies the number of retransmissions in the range of 1 to 100. The default value is 5.
Usage guidelines
With probe keepalive enabled, if the maximum number of retransmissions is reached but the client-mode AP fails to receive a probe response from the associated wireless service, the AP disconnects from the service. Then, the AP attempts to associate with another wireless service.
This feature is configurable only on a radio interface enabled with the client mode. Disabling the client mode removes the configuration.
Examples
# Enable probe keepalive for the client-mode AP. Set the probe request sending interval to 100 milliseconds and set the number of retransmissions to 5.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] client-mode probe-keepalive interval 100 retry 5
Related commands
client-mode enable
client-mode roam
Use client-mode roam to enable roaming for the client-mode AP and set the roaming mode.
Use undo client-mode roam to restore the default.
Syntax
client-mode roam { quick | slow }
undo client-mode roam
Default
Roaming is disabled for a client-mode AP.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
quick: Specifies quick roaming to use the RSSI gap threshold to determine whether to perform roaming.
slow: Specifies slow roaming to use the RSSI threshold and RSSI gap threshold to determine whether to perform roaming.
Usage guidelines
This feature is configurable only on a radio interface enabled with the client mode. Disabling the client mode removes the configuration.
This feature enables the client-mode AP to roam between wireless services in the same ESS. With this feature disabled, the client-mode AP cannot perform roaming.
Examples
# Enable roaming for the client-mode AP and set the roaming mode to quick.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] client-mode roam quick
Related commands
client-mode enable
client-mode roam rssi-threshold
client-mode roam calibration-interval
Use client-mode roam calibration-interval to set the roaming calibration interval for the client-mode AP.
Use undo client-mode roam calibration-interval to restore the default.
Syntax
client-mode roam calibration-interval interval
undo client-mode roam calibration-interval
Default
The roaming calibration interval is 1000 milliseconds for the client-mode AP.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
interval: Specifies the roaming calibration interval in the range of 1000 to 10000 in milliseconds.
Usage guidelines
This feature is configurable only on a radio interface enabled with the client mode. Disabling the client mode removes the configuration.
The client-mode AP determines whether to perform roaming at the specified calibration intervals. If the interval is too short, the AP might switch the associated wireless service frequently, which affects network stability. If the interval is too long, the AP might fail to switch to the optimal wireless service in time, which affects service quality.
Examples
# Set the roaming calibration interval to 1000 milliseconds for the client-mode AP.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] client-mode roam calibration-interval 1000
Related commands
client-mode enable
client-mode roam rssi-threshold
Use client-mode roam rssi-threshold to set the roaming RSSI threshold and RSSI gap threshold for the client-mode AP.
Use undo client-mode roam rssi-threshold to restore the default.
Syntax
client-mode roam rssi-threshold rssi-value [ gap gap-value ]
undo client-mode roam rssi-threshold
Default
Both the roaming RSSI threshold and the gap threshold are 20.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
rssi-value: Specifies the roaming RSSI threshold in the range of 1 to 50.
gap gap-value: Specifies the RSSI gap threshold in the range of 1 to 50.
Usage guidelines
In quick roaming, the client-mode AP performs roaming as long as the RSSI gap between the associated service and a better service exceeds the gap threshold. In slow roaming, the client-mode performs roaming only when the RSSI of the associated service is below the roaming RSSI threshold and the RSSI gap between the associated service and a better service exceeds the gap threshold.
This feature is configurable only on a radio interface enabled with the client mode. Disabling the client mode removes the configuration.
Examples
# Set the roaming RSSI threshold to 10 and the RSSI gap threshold to 2 for the client-mode AP.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] client-mode roam rssi-threshold 10 gap 2
Related commands
client-mode enable
client-mode roam
client-mode roam scan-aging
Use client-mode roam scan-aging to set the AP roaming scanning aging count for the client-mode AP.
Use undo client-mode roam scan-aging to restore the default.
Syntax
client-mode roam scan-aging count
undo client-mode roam scan-aging
Default
The aging count for the client-mode AP to perform roaming scanning is 5.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
count: Specifies the aging count for roaming scanning in the range of 1 to 10.
Usage guidelines
This feature is configurable only on a radio interface enabled with the client mode. Disabling the client mode removes the configuration.
The client-mode AP generates a BSS entry for each BSS detected during scanning. If the aging count is reached but the BSS cannot be detected again, the AP deletes the BSS entry. If the BSS is the currently associated BSS of the AP, the AP goes offline and then attempts to come online from another BSS.
Examples
# Set aging count for roaming scanning to 5 for the client-mode AP.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] client-mode roam scan-aging 5
Related commands
client-mode enable
client-mode roam scan-interval
Use client-mode roam scan-interval to set the roaming scanning interval for the client-mode AP.
Use undo client-mode roam scan-interval to restore the default.
Syntax
client-mode roam scan-interval interval
undo client-mode roam scan-interval
Default
The roaming scanning interval is 5000 milliseconds for a client-mode AP.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
interval: Specifies the roaming scanning interval in the range of 100 to 10000 in milliseconds.
Usage guidelines
If enhanced roaming is disabled, this feature is configurable only on a radio interface enabled with the client mode. Disabling the client mode removes the configuration.
If enhanced roaming is enabled, this feature is configurable only on a radio interface enabled with enhanced roaming. Disabling enhanced roaming removes the configuration.
If enhanced roaming is disabled, setting a short scanning interval might cause the client-mode AP to scan the network frequently, leading to severe packet loss and affecting service quality.
If the roaming scanning interval is too long, the AP might fail to detect the optimal service in time.
Examples
# Set the roaming scanning interval to 2000 milliseconds for the client-mode AP.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/2
[Sysname-WLAN-Radio1/0/2] client-mode roam scan-interval 2000
Related commands
client-mode enable
client-mode roam-enhance
Use client-mode roam-enhance to enable enhanced roaming for the client-mode AP and set the roaming mode.
Use undo client-mode roam-enhance to restore the default.
Syntax
client-mode roam-enhance { quick | slow }
undo client-mode roam-enhance
Default
Enhanced roaming is disabled for a client-mode AP.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
quick: Specifies quick roaming to use only the RSSI gap threshold to determine whether to perform roaming.
slow: Specifies slow roaming to use the RSSI threshold and RSSI gap threshold to determine whether to perform roaming.
Usage guidelines
In an AGV wireless network, the network contains onboard devices deployed on vehicles and network-side devices. Network-side devices provide wireless access for onboard client-mode APs, while the client-mode APs act as wireless clients to provide wireless NIC functions for onboard devices without wireless NICs.
This feature is configurable only on 2.4 GHz radios on onboard devices, and cannot be configured on the same radio where the client mode is enabled.
Enable the client mode on the 5GHz radios of onboard devices and connect the radios to the wireless network. Disable scanning and do not specify a manual channel on the 5GHz radios. If you enable scanning, do not configure the 2.4GHz radios to provide wireless access services because the 2.4GHz radios will be used for scanning and cannot provide stable wireless services.
If you enable enhanced roaming for the client-mode AP, the AP goes offline from the associated wireless service and comes online again.
If roaming is enabled on the 5GHz radio of the client-mode AP, do not enable enhanced roaming on the 2.4GHz radio. If enhanced roaming is enabled on the 2.4GHz radio, do not enable roaming on the 5GHz radio.
To use the client-mode disconnect command to disconnect the client-mode AP from the associated wireless service, first disable enhanced roaming.
Examples
# Enable enhanced roaming for the client-mode AP and set the roaming mode to quick.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/2
[Sysname-WLAN-Radio1/0/2] client-mode roam-enhance quick
Related commands
client-mode roam rssi-threshold
client-mode ssid
Use client-mode ssid to specify a SSID for the client-mode AP to associate.
Use undo client-mode ssid to restore the default.
Syntax
client-mode ssid ssid
undo client-mode ssid
Default
No SSID is specified for the client-mode AP to associate.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
ssid: Specifies an SSID, a case-sensitive string of 1 to 32 characters.
Usage guidelines
This feature is configurable only on a radio interface enabled with the client mode. Disabling the client mode removes the configuration.
To connect the client-mode AP to an encrypted wireless service, make sure the wireless service uses the RSN security IE and the PSK mode.
Examples
# Specify SSID service1 for the client-mode AP to associate.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] client-mode ssid service1
Related commands
client-mode enable
client-mode vlan
Use client-mode vlan to specify a VLAN for the client-mode radio interface.
Use undo client-mode vlan to restore the default.
Syntax
client-mode vlan vlan-id
undo client-mode vlan
Default
A client-mode radio interface is in VLAN 1.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
vlan-id: Specifies a VLAN ID in the range of 1 to 4094. If the specified VLAN does not exist, the system creates the VLAN automatically.
Usage guidelines
This feature is configurable only on a radio interface enabled with the client mode. Disabling the client mode removes the configuration.
Examples
# Specify VLAN 2 for the client-mode radio interface.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] client-mode vlan 2
Related commands
client-mode enable
customlog format wlan
Use customlog format wlan to enable the device to generate client logs in the specified format.
Use undo customlog format wlan to restore the default.
Syntax
customlog format wlan { normal | sangfor }
undo customlog format wlan
Default
The device generates client logs only in H3C format.
Views
System view
Predefined user roles
network-admin
Parameters
normal: Specifies normal format.
sangfor: Specifies sangfor format.
Usage guidelines
By default, the device generates client logs only in H3C format that logs AP name, radio ID, client MAC address, SSID, BSSID, and client online status.
You can configure the device to generate client logs in one of the following formats:
· Normal—Logs AP MAC address, AP name, client IP address, client MAC address, SSID, and BSSID.
· Sangfor—Logs AP MAC address, client IP address, and client MAC address.
This feature does not affect the generation of client logs in H3C format.
Examples
# Enable the device to generate client logs in sangfor format.
<Sysname> system-view
[Sysname] customlog format wlan sangfor
description
Use description to configure a description for a service template.
Use undo description to restore the default.
Syntax
description text
undo description
Default
No description is configured for a service template.
Views
Service template view
Predefined user roles
network-admin
Parameters
text: Specifies a description, a case-sensitive string of 1 to 64 characters.
Examples
# Configure a description for service template service1.
<Sysname> system-view
[Sysname] wlan service-template service1
[Sysname-wlan-st-service1] description wlanst
display interface wlan-radio
Use display interface wlan-radio to display WLAN radio interface information.
Syntax
display interface wlan-radio [ interface-number ] [ brief ]
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
interface-number: Specifies a WLAN radio interface by its number. If you do not specify this argument, the command displays information about all WLAN radio interfaces.
brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information.
Examples
# Display detailed information about WLAN-Radio 1/0/1.
<Sysname> display interface wlan-radio 1/0/1
WLAN-Radio1/0/1
Current state: UP
Description: WLAN-Radio1/0/1 Interface
IP Packet Frame Type: PKTFMT_IEEE_802.11, Hardware Address: d461-fe59-4d20
current mode: 802.11ac, current channel: 36
Last link flapping: 0 hours 31 minutes 6 seconds
Last clearing of counters: Never
Current system time:2016-01-01 00:31:19
Last time when physical state changed to up:2016-01-01 00:00:13
Last time when physical state changed to down:2016-01-01 00:00:13
Input (total): 0 packets, 0 bytes
Input (normal): 0packets, 0bytes
0 management, 0 control, 0 data
Input (error): 0 total, 0 CRC, 0 decrypt errors
0 mic failures, 0 phy errors, 0 other errors
Output (total): 0 packets, 0 bytes
Output (normal): Q[0]:0, Q[1]:0, Q[2]:0, Q[3]:0 packets
Q[0]:0, Q[1]:0, Q[2]:0, Q[3]:0 bytes
0 management, 0 control, 0 data
Output (bcn&probe): 0 packets, 0 bytes
Output (error): 0 total, 0 discard, 0 buffer failures
0 ack failures, 0 rts successed, 0 rts failures
Table 1 Command output
Field |
Description |
Current state |
Physical link state of the interface: · UP—The interface is physically up. · DOWN—The interface is physically down. · ADM—The interface was shut down with the shutdown command. To bring up the interface, execute the undo shutdown command. · Stby—The interface is a backup interface. |
IP Packet Frame Type |
This field displays PKTFMT_IEEE_802.11, which indicates that the frame is 802.11 encapsulated. |
Hardware Address |
Interface MAC address. |
current mode |
Current radio mode. |
current channel |
Current working channel. |
Last link flapping |
The amount of time that has elapsed since the most recent physical state change of the interface. This field displays Never if the interface has been physically down since device startup. |
Last clearing of counters |
Time when the reset counters interface command was last used to clear the interface statistics. This field displays Never if the reset counters interface command has never been used on the interface since device startup. |
Current system time |
Current system time in the YYYY/MM/DD HH:MM:SS format. If a time zone is specified, this field displays the system time in the HH:MM:SS UTC±HH:MM:SS format. |
Last time when physical state changed to up |
Last time when the physical link state of the interface changed to up. This field displays - if the physical link state has never been changed. |
Last time when physical state changed to down |
Last time when the physical link state of the interface changed to down. This field displays - if the physical link state has never been changed. |
Input(total): 0 packets, 0 bytes |
Inbound packet statistics (in packets and bytes) for the interface. All inbound normal packets and abnormal packets were counted. |
Input (normal): 0packets, 0bytes 0 management, 0 control, 0 data |
Inbound normal packet statistics (in packets and bytes) for the interface. All normal inbound management, control, and data packets were counted. |
Input (error) |
Inbound error packet statistics for the interface. |
Output (total): 0 packets, 0 bytes |
Outbound packet statistics (in packets and bytes) for the interface. All outbound normal packets and abnormal packets were counted. |
Output (normal): Q[0]:0, Q[1]:0, Q[2]:0, Q[3]:0 packets Q[0]:0, Q[1]:0, Q[2]:0, Q[3]:0 bytes 0 management, 0 control, 0 data |
Outbound normal packet statistics (in packets and bytes) for the interface. All normal outbound management, control, and data packets were counted. Q[n] represents an AC queue, where n represents the queue ID. |
Output (bcn&probe) |
Outbound beacon and probe frame statistics (in packets and bytes) for the interface. |
Output (error) |
Outbound error packet statistics for the interface. |
# Display brief information about WLAN-Radio 1/0/1.
<Sysname> display interface wlan-radio 1/0/1 brief
Brief information on interfaces in bridge mode:
Link: ADM - administratively down; Stby - standby
Speed: (a) - auto
Duplex: (a)/A - auto; H - half; F - full
Type: A - access; T - trunk; H - hybrid
Interface Link Speed Duplex Type PVID Description
WLAN-Radio1/0/1 UP -- -- -- --
Table 2 Command output
Field |
Description |
Brief information on interfaces in bridge mode |
Brief information about Layer 2 interfaces. |
Link |
Physical link state of the interface: · ADM—The interface was shut down with the shutdown command. To restore the physical state of the interface, execute the undo shutdown command. · Stby—The interface is a backup interface. To display the primary interface, use the display interface-backup state command. |
Speed |
Speed of the interface, in Mbps. This field displays the (a) flag next to the speed if the speed is automatically negotiated. This field displays -- for WLAN radio interfaces. |
Duplex |
Duplex mode of the interface: · (a)/A—Autonegotiation. · H—Half duplex. · F—Full duplex. This field displays -- for WLAN radio interfaces. |
Type |
Link type of the interface: · A—Access. · H—Hybrid. · T—Trunk. This field displays -- for WLAN radio interfaces. |
PVID |
This field displays -- for WLAN radio interfaces. |
Related commands
interface wlan-radio
display wlan ap all client-number
Use display wlan ap all client-number to display the number of online clients at the 2.4 GHz band and the 5 GHz band.
Syntax
display wlan ap all client-number
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display the number of online clients at both the 2.4 GHz and 5 GHz bands.
<System> display wlan ap all client-number
AP name Clients 2.4GHz 5GHz
fatap 2 2 0
Table 3 Command output
Field |
Description |
Clients |
Total number of online clients. |
2.4GHz |
Number of online clients at the 2.4 GHz band. |
5GHz |
Number of online clients at the 5 GHz band. |
display wlan ap all radio client-number
Use display wlan ap all radio client-number to display the number of online clients and channel information for each radio.
Syntax
display wlan ap all radio client-number
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display the number of online clients and channel information for each radio.
<Sysname> display wlan ap all radio client-number
AP name RID Channel Clients
fatap 1 44 12
fatap 2 11 4
display wlan blacklist
Use display wlan blacklist to display blacklist entries.
Syntax
display wlan blacklist { dynamic | static }
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
dynamic: Specifies the dynamic blacklist.
static: Specifies the static blacklist.
Examples
# Display static blacklist entries.
<Sysname> display wlan blacklist static
Total number of clients: 3
MAC addresses:
000e-35b2-000e
0019-5b8e-b709
001c-f0bf-9c92
# Display dynamic blacklist entries.
<Sysname> display wlan blacklist dynamic
Total number of clients: 3
MAC address APID RID Lifetime (s) Duration (hh:mm:ss)
000f-e2cc-0001 1 1 300 00:02:11
000f-e2cc-0002 2 1 300 00:01:17
000f-e2cc-0003 3 1 300 00:02:08
Table 4 Command output
Field |
Description |
MAC address |
Client MAC address. |
APID |
ID of the AP that detects the rogue client. |
RID |
ID of the radio that detects the rogue client. |
Lifetime (s) |
Lifetime of the entry in seconds. |
Duration (hh:mm:ss) |
Duration for the entry since the entry was added to the dynamic blacklist. |
display wlan bss
Use display wlan bss to display basic service set (BSS) information.
Syntax
display wlan bss { all | bssid bssid } [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
all: Displays all BSSs.
bssid bssid: Specifies a BSS by its ID. The value is a 48-bit hexadecimal number in the format of H-H-H.
verbose: Displays detailed client information. If you do not specify this keyword, the command displays brief client information.
Examples
# Display brief information about all BSSs.
<Sysname> display wlan bss all
Total number of BSSs: 4
AP name RID SSID BSSID
fatap 1 SSID1 001c-f08f-f804
fatap 2 SSID1 001c-f08f-f806
# Display detailed information about the BSS with ID 001c-f08f-f804.
<Sysname> display wlan bss bssid 001c-f08f-f804 verbose
AP name : fatap
BSSID : 001c-f08f-f804
Radio ID : 1
Service template name : servcie1
SSID : SSID1
VLAN ID : 1
AKM mode : Not configured
User authentication mode : Bypass
Table 5 Command output
Field |
Description |
AKM mode |
AKM mode: · 802.1X. · PSK. · Not configured. |
User authentication mode |
User authentication mode: · Bypass—No client authentication. · MAC. · 802.1X. · OUI. |
display wlan client
Use display wlan client to display client information.
Syntax
display wlan client [ interface wlan-radio interface-number | mac-address mac-address | service-template service-template-name ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface wlan-radio interface-number: Displays information about clients that are connected to the specified radio interface.
mac-address mac-address: Specifies a client by its MAC address.
service-template service-template-name: Displays information about clients that are associated with the specified service template. The service template name is a case-insensitive string of 1 to 63 characters.
verbose: Displays detailed client information. If you do not specify this keyword, the command displays brief client information.
Examples
# Display brief information about all clients.
<Sysname> display wlan client
Total number of clients: 3
MAC address Username R IP address VLAN
000f-e265-6400 N/A 1 1.1.1.1 100
000f-e265-6401 user 1 3.0.0.3 200
84db-ac14-dd08 N/A 1 5.5.5.3 1
Table 6 Command output
Field |
Description |
MAC address |
Client MAC address. |
Username |
Client username: · The field displays the client username if the client uses 802.1X or MAC authentication. · The field displays N/A if the client does not use 802.1X or MAC authentication. NOTE: If the client uses portal authentication, this field does not display the portal username of the client. |
AP name |
Name of the AP that the client is associated with. |
R |
ID of the radio that the client is associated with. |
IP address |
IPv4 address of the client. |
VLAN ID |
ID of the VLAN to which the client belongs. |
# Display detailed information about the client with MAC address 000f-e265-6400.
<Sysname> display wlan client mac-address 000f-e265-6400 verbose
Total number of clients: 1
MAC address : 000f-e265-6400
IPv4 address : 10.1.1.114
IPv6 address : 2001::1234:5678:0102:0304
Username : N/A
AID : 1
Radio ID : 1
Channel : 36
SSID : office
BSSID : 0026-3e08-1150
VLAN ID : 3
Sleep count : 3
Wireless mode : 802.11gn
Channel bandwidth : 20MHz
SM power save : Enabled
Short GI for 20MHz : Supported
Short GI for 40MHz : Supported
Short GI for 80MHz : Supported
Short GI for 160/80+80MHz : Not supported
STBC RX capability : Not supported
STBC TX capability : Not supported
LDPC RX capability : Not supported
SU beamformee capability : Not supported
MU beamformee capability : Not supported
Beamformee STS capability : N/A
Block Ack : TID 0 In
Supported VHT-MCS set : NSS1 0, 1, 2, 3, 4, 5, 6, 7, 8, 9
NSS2 0, 1, 2, 3, 4, 5, 6, 7, 8, 9
Supported HT MCS set : 0, 1, 2, 3, 4, 5, 6, 7,
8, 9, 10, 11, 12, 13, 14,
15
Supported rates : 1, 2, 5.5, 6, 9, 11,
12, 18, 24, 36, 48, 54 Mbps
QoS mode : WMM
Listen interval : 10
RSSI : 62
Rx/Tx rate : 130/195 Mbps
Speed : N/A
Authentication method : Open system
Security mode : PRE-RSNA
AKM mode : Not configured
Cipher suite : N/A
User authentication mode : Bypass
WPA3 status : Disabled
Authorization ACL ID : 3001(Not effective)
Authorization user profile : N/A
Authorization CAR :
Average input rate : 102400 bps
Average output rate : 102400 bps
Roam status : N/A
Key derivation : SHA1
PMF status : Enabled
Forwarding policy name : Not configured
Online time : 0days 0hours 1minutes 13seconds
FT status : Inactive
Table 7 Command output
Field |
Description |
MAC address |
Client MAC address. |
IPv4 address |
Client IPv4 address. |
IPv6 address |
Client IPv6 address. |
Username |
Client username: · The field displays the client username if the client uses 802.1X or MAC authentication. · The field displays N/A if the client does not use 802.1X or MAC authentication. NOTE: If the client uses portal authentication, this field does not display the portal username of the client. |
AID |
Association ID. |
Radio ID |
ID of the radio that the client is associated with. |
Channel |
Channel with which the client is associated. |
SSID |
SSID with which the client is associated. |
VLAN ID |
ID of the VLAN to which the client belongs. |
Sleep count |
Client sleep times. |
Wireless mode |
Wireless mode: · 802.11a. · 802.11b. · 802.11g. · 802.11gn. · 802.11an. · 802.11ac. · 802.11gac. |
Channel bandwidth |
Channel bandwidth: · 20 MHz. · 40 MHz. · 80 MHz. · 160 MHz. |
20/40 BSS Coexistence Management |
Whether the client supports 20/40MHz channel bandwidth coexistence. |
SM Power Save |
SM Power Save status: · Enabled—Only one antenna of a client operates in active state, and others operate in sleep state to save power. · Disabled. |
Short GI for 20MHz |
Whether the client supports short GI when its channel bandwidth is 20 MHz: · Supported. · Not supported. |
Short GI for 40MHz |
Whether the client supports short GI when its channel bandwidth is 40 MHz: · Supported. · Not supported. |
Short GI for 80MHz |
Whether the client supports short GI when its channel bandwidth is 80 MHz: · Supported. · Not supported. |
Short GI for 160/80+80MHz |
Whether the client supports short GI when its channel bandwidth is 160 MHz or 80 + 80 MHz: · Supported. · Not supported. |
STBC Rx Capability |
Client STBC receive capability; · Not supported. · Supported. |
STBC Tx Capability |
Client STBC transmission capability: · Not supported. · Supported. |
LDPC Rx capability |
Client LDPC receive capability; · Not supported. · Supported. |
SU beamformee capability |
Client SU beamformee capability: · Not supported. · Supported. |
MU beamformee capability |
Client MU beamformee capability: · Not supported. · Supported. |
Beamformee STS capability |
Supported spatial stream quantity if the client is a beamformee receiver, in the range of 0 to 7 (the maximum spatial stream quantity specified by the MIMO mode minus one). This field displays N/A if the client cannot act as a beamformee receiver. |
Number of Sounding Dimensions |
Supported spatial stream quantity if the client is a beamformee transmitter, in the range of 0 to 7 (the maximum spatial stream quantity specified by the MIMO mode minus one). This field displays N/A if the client cannot act as a beamformee transmitter. |
Block Ack |
Negotiation result of Block ACK with TID: · TID 0 In—Sends Block ACK for inbound traffic. · TID 0 Out—Sends Block ACK for outbound traffic. · TID 0 Both—Sends Block ACK for both inbound and outbound traffic. · N/A—Does not send Block ACK for both inbound and outbound traffic. |
Supported VHT-MCS set |
VHT-MCS supported by the client. |
Supported HT MCS set |
HT-MCS supported by the client. |
QoS mode |
QoS mode: · N/A—WMM is not supported. · WMM—WMM is supported. WMM information negotiation is carried out between an AP and a client that both support WMM. |
Listen interval |
Interval at which the client wakes up to listen for beacon frames. It is counted by beacon interval. |
RSSI |
Received signal strength indication. This value indicates the client signal strength detected by the AP. |
Rx/Tx rate |
Sending and receiving rates of data, management, and control frames. |
Speed |
Sending and receiving rates in the past 2 minutes in Kbps, rounded to three decimal places. This field displays N/A if both the sending and receiving rates are 0. |
Authentication method |
Authentication method: · Open system. · Shared key. · SAE. |
Security mode |
Security mode: · RSN—Beacons and probe responses carry RSN IE. · WPA—Beacons and probe responses carry WPA IE. · PRE-RSNA—Beacons and probe responses do not carry RSN IE or WPA IE. |
AKM mode |
AKM mode: · 802.1X. · PSK. · OWE. · Not configured. |
Cipher suite |
Cipher suite: · N/A. · WEP40. · WEP104. · WEP128. · CCMP. · TKIP. · GCMP. |
User authentication mode |
User authentication mode: · Bypass—No client authentication. · MAC. · 802.1X. · OUI. |
WPA3 status |
WPA3 status: · Disabled. · Enabled. · N/A. |
Authorization ACL ID |
Authorized ACL number: · This field displays the ACL number if the authorized ACL takes effect. · This field displays ACL number(Not effective) if the authorized ACL does not take effect. · This field displays N/A if the authentication server is configured without any authorized ACL. |
Authorization user profile |
Name of the authorized user profile: · This field displays the authorized user profile name if the authorized user profile takes effect. · This field displays authorized user profile name + Not effective if the authorized user profile does not take effect. · This field displays N/A if the authentication server is configured without any authorized user profile. |
Authorization CAR |
Authorization CAR: · Average input rate—Average uplink rate in bps. · Average output rate—Average downlink rate in bps. · N/A—This field displays N/A if the authentication server is not configured with authorization CAR for users. |
Roam status |
This field is not supported in the current software version. Roam status: · Roaming in progress. · Inter-AC roam. · Inter-MA roam. · Intra-AC roam. · Intra-MA roam. · This field displays N/A if the client stays in one BSS after coming online. |
Key derivation |
Key derivation type: · SHA1—Uses the HMAC-SHA1 hash algorithm. · SHA256—Uses the HMAC-SHA256 hash algorithm. · SHA384—Uses the HMAC-SHA384 hash algorithm. · N/A—No key derivation algorithm is involved for the authentication type. |
PMF status |
PMF status: · Enabled—Management frame protection is enabled. · Disabled—Management frame protection is disabled. · N/A—Management frame protection is not involved. |
Forwarding policy name |
This field is not supported in the current software version. WLAN forwarding policy name: · Not configured. · Policy-name. |
Online time |
Client online duration. |
FT status |
Fast BSS transition (FT): · Active—FT is enabled. · Inactive—FT is disabled. |
display wlan client ipv6
Use display wlan client ipv6 to display information about client IPv6 addresses.
Syntax
display wlan client ipv6
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display brief status information about the specified client.
<Sysname> display wlan client ipv6
MAC address AP name IPv6 address VLAN
84db-ac14-dd08 fatap 1 1::2:0:0:3 300
Table 8 Command output
Field |
Description |
MAC address |
Client MAC address. |
IPv6 address |
Client IPv6 address. |
VLAN |
Client VLAN. |
display wlan client online-duration
Use display wlan client online-duration to display client online duration.
Syntax
display wlan client online-duration [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
verbose: Displays detailed information. If you do not specify this keyword, the command displays brief information.
Examples
# Display brief information about client online duration.
<Sysname> display wlan client online-duration
Total number of online clients: 2
MAC address IPv4 address Online duration
a4c1-5b79-fa5b-1d62 192.168.11.123 0days 0hours 2minutes 23seconds
22d3-c5b7-a4b5-96fa 192.168.11.234 0days 0hours 5minutes 34seconds
Table 9 Command output
Field |
Description |
MAC address |
Client MAC address. |
IPv4 address |
Client IPv4 address. |
Online duration |
Client online duration. |
display wlan client status
Use display wlan client status to display client status information.
Syntax
display wlan client status [ mac-address mac-address ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
mac-address mac-address: Specifies a client by its MAC address in the format of H-H-H. If you do not specify this option, the command displays status information about all clients.
verbose: Displays detailed client status information. If you do not specify this keyword, the command displays brief client status information.
Examples
# Display brief status information about the specified client.
<Sysname> display wlan client status mac-address 001c-f08f-f804
Total number of clients: 1
MAC address RSSI Rx/Tx rate(bps) Speed(bps) Discard AP name RID
001c-f08f-f804 0 39/117Mbps N/A 0.00 fatap 2
# Display brief status information about all clients.
<Sysname> display wlan client status
Total number of clients: 2
MAC address RSSI Rx/Tx rate(bps) Speed(bps) Discard AP name RID
000b-c002-9d09 65 39/117Mbps N/A 0.00% fatap 2
000f-e265-6401 62 130/195Mbps N/A 0.00% fatap 1
Table 10 Command output
Field |
Description |
MAC address |
Client MAC address. |
RSSI |
RSSI of the client. |
Rx/Tx rate(bps) |
Rates at which the client receives and sends data, management packets, and control packets. |
Speed(bps) |
Rates at which the client receives and sends packets in the past 2 minutes, rounded to one decimal place. If a rate is smaller than 1 Mbps, the value is displayed in Kbps. If a rate equals 1 Mbps or is larger than 1 Mbps, the value is displayed in Mbps. This field displays N/A if both the sending and receiving rates are 0. |
Discard |
Ratio of packets discarded by the client. |
AP name |
Name of the AP with which the client is associated. |
RID |
ID of the radio with which the client is associated. |
# Display detailed status information about the specified client.
<Sysname> display wlan client status mac-address 001c-f08f-f804 verbose
Total number of clients: 1
MAC address : 001c-f08f-f804
AP name : ap2
Radio ID : 2
RSSI : 0
Rx/Tx rate : 39/117 Mbps
Speed : N/A
Received:
Retransmitted packets : 84
Retransmitted packet ratio : 64.12%
Sent:
Retransmitted packets : 0
Retransmitted packet ratio : 0.00%
Discarded:
Discarded packets : 0
Discarded packet ratio : 0.00%
Table 11 Command output
Field |
Description |
MAC address |
Client MAC address. |
AP name |
Name of the AP that the client is associated with. |
Radio ID |
ID of the radio that the client is associated with. |
RSSI |
RSSI of the client. |
Rx/Tx rate |
Rates at which the client receives and sends data, management packets, and control packets. |
Speed |
Sending and receiving rates in the past 2 minutes in Kbps, rounded to three decimal places. This field displays N/A if both the sending and receiving rates are 0. |
Received |
Statistics about packets received by the AP: · Retransmitted packets. · Retransmitted packet ratio. |
Sent |
Statistics about packets sent by the AP: · Retransmitted packets. · Retransmitted packet ratio. |
Discarded |
Statistics about packets discarded by the client: · Discarded packets. · Discarded packet ratio. |
display wlan client-mode packet-statistics
Use display wlan client-mode packet-statistics to display packet statistics on the client-mode AP.
Syntax
display wlan client-mode packet-statistics radio radio-id
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
radio-id: Specifies a radio by its ID.
Examples
# Display packet statistics on radio 1 of the client-mode AP.
<Sysname> display wlan client-mode packet-statistics radio 1
Packet statistics:
unknown : 0
recv beacon in scan : 65
recv beacon in run : 47164
recv probe response in fsm : 49
recv probe response in run : 0
recv probe response in scan : 322
recv auth in fsm : 50
recv assoc response in fsm : 50
recv deauth in fsm : 0
recv disassoc in fsm : 0
recv action in fsm : 5
recv other frame in fsm : 5
recv other frame in scan : 0
send auth success : 50
send auth failed : 0
send assoc success : 50
send assoc failed : 0
send deauth success : 49
send deauth failed : 0
send unicast probe success : 50
send unicast probe failed : 0
send broadcast probe(ssid) success : 8
send broadcast probe(ssid) failed : 0
send broadcast probe success : 16
send broadcast probe failed : 0
send null data success : 0
send null data failed : 0
Table 12 Command output
Field |
Description |
unknown |
Number of received unknown frames. |
recv beacon in scan |
Number of beacon frames received during scanning. |
recv beacon in run |
Number of beacon frames received after the AP comes online. |
recv probe response in fsm |
Number of probe responses received during AP association. |
recv probe response in run |
Number of probe responses received after the AP comes online. |
recv probe response in scan |
Number of probe responses received during scanning. |
recv auth in fsm |
Number of Auth frames received during AP association. |
recv assoc response in fsm |
Number of Assoc responses received during AP association. |
recv deauth in fsm |
Number of Deauth frames received during AP association. |
recv disassoc in fsm |
Number of Disassoc frames received during AP association. |
recv action in fsm |
Number of Action frames received during AP association. |
recv other frame in fsm |
Number of other frames received during AP association. |
recv other frame in scan |
Number of other frames received during scanning. |
send auth success |
Number of Auth frames sent successfully. |
send auth failed |
Number of Auth frames failed to be sent. |
send assoc success |
Number of Assoc frames sent successfully. |
send assoc failed |
Number of Assoc frames failed to be sent. |
send deauth success |
Number of Deauth frames sent successfully. |
send deauth failed |
Number of Deauth frames failed to be sent. |
send unicast probe success |
Number of unicast probe requests sent successfully. |
send unicast probe failed |
Number of unicast probe requests failed to be sent. |
send broadcast probe(ssid) success |
Number of broadcast probe requests with an SSID included sent successfully. |
send broadcast probe(ssid) failed |
Number of broadcast probe requests with an SSID included failed to be sent. |
send broadcast probe success |
Number of broadcast probe requests sent successfully. |
send broadcast probe failed |
Number of broadcast probe requests failed to be sent. |
send null data success |
Number of null data packets sent successfully. |
send null data failed |
Number of null data packets failed to be sent. |
Related commands
client-mode enable
reset wlan client-mode packet-statistics
display wlan client-mode radio
Use display wlan client-mode radio to display information about the client-mode radio interface.
Syntax
display wlan client-mode radio
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display information about the client-mode radio interface.
<Sysname> display wlan client-mode radio
Radio : 2
Mode : 802.11ax
Authentication method : Open-system
Cipher suite : N/A
Key (simple) : N/A
WEP Key ID : N/A
SSID : service1
BSSID : 6CF0-49CD-30BB
Status : Connected
Received data packets : 1324939
Received management packets : 34876
Sent data packets : 46365
Discarded packets : 38272
Supported VHT-MCS set : NSS1 0, 1, 2, 3, 4, 5, 6, 7, 8, 9
NSS2 0, 1, 2, 3, 4, 5, 6, 7, 8, 9
NSS3 0, 1, 2, 3, 4, 5, 7, 8, 9
NSS4 0, 1, 2, 3, 4, 5, 6, 7, 8, 9
Supported rates : 6, 9, 12, 18, 24, 36, 48, 54 Mbps
Supported HE-MCS set : NSS1 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11
NSS2 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11
NSS3 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11
NSS4 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11
Online time : 0 days 0 hours 45 minutes 5 seconds
Table 13 Command output
Field |
Description |
Radio |
Radio ID. |
Mode |
Radio mode: · 802.11a. · 802.11b. · 802.11g. · 802.11an. · 802.11gn. · 802.11ac. · 802.11ax. · 802.11gax. The supported radio modes depend on the device model. |
Authentication method |
Authentication method: · Open-system. · Shared-key. · WPA2-PSK. |
Cipher suite |
Cipher suite: · CCMP—AES-CCMP cipher suite. · TKIP. · WEP40. · WEP104. · WEP128. · N/A—Plaintext. No encryption. |
Key |
Key: · (Cipher)—Show the key in ciphertext. · (Simple)—Show the key in plaintext. · N/A—Plaintext. No encryption. |
WEP key ID |
WEP key ID. This field displays N/A if the plaintext format is used (no encryption). |
SSID |
SSID with which the client-mode radio interface associates. |
BSSID |
Basic service set identifier. |
Status |
Association status: · Connected—Connected to a wireless service. · Disconnected—Not connected to a wireless service. |
Received data packets |
Number of received data packets. |
Received management packets |
Number of received management packets. |
Sent data packets |
Number of sent data packets. |
Discarded packets |
Number of discarded packets. |
Supported set |
Supported MCSs. |
Supported rates |
Supported rates. |
Online time |
Online duration since AP association. |
display wlan client-mode roam-enhance bss
Use display wlan client-mode roam-enhance bss to display information about BSSs detected by the client-mode AP.
Syntax
display wlan client-mode roam-enhance bss
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
After enabling enhanced roaming, you can use this command to display BSS information about the five BSSs detected most recently in beacon frames or probe responses.
Examples
# Display information about BSSs detected by the client-mode AP.
<Sysname> display wlan client-mode roam-enhance bss
Total number of BSSs: 2
BSSID Time MSec RSSI AVER CHL AGE SSID
84d9-3100-4b00 16:51:09 0244 37 36 149 5 agv-work
16:51:08 0834 37
16:51:08 0732 36
16:51:08 0642 37
16:51:09 0253 36
50da-00df-33e0 16:51:08 0802 45 45 149 5 agv-work
16:51:08 0699 44
16:51:08 0597 46
16:51:08 0261 46
16:51:09 0251 45
Table 14 Command output
Field |
Description |
Total number of BSSs |
Number of BSSs. |
BSSID |
BSSID in the received beacon frame or probe response. |
Time |
Time at which the beacon frame or probe response was received. |
MSec |
Time in milliseconds at which the beacon frame or probe response was received. |
RSSI |
RSSI of the received beacon frame or probe response. |
AVER |
Average RSSI of the five beacon frames or probe responses received most recently. |
CHL |
Channel in the beacon frame or probe response received most recently. |
AGE |
BSS aging count. |
SSID |
SSID in the received beacon frame or probe response. |
display wlan client-mode roaming-state
Use display wlan client-mode roaming-state to display roaming state information for the client-mode AP.
Syntax
display wlan client-mode roaming-state
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display roaming state information for the client-mode AP.
<Sysname> display wlan client-mode roaming-state
Radio ID: 1 FSM changes: 9 SSID: agv
Index FSM BSSID RSSI Chl FsmChangeCause Time
1 UnAu 50da-00df-33e0 55 36 Send prob(Bss) Day 2 18:12:36 987
2 Auth 50da-00df-33e0 55 36 Auth direct(Bss) Day 2 18:12:36 35
3 Asso 50da-00df-33e0 55 36 Send assoc Day 2 18:12:36 37
4 Run 50da-00df-33e0 55 36 Rec assoc Day 2 18:12:36 38
5 UnAu 50da-00df-33e0 55 36 Scan aging Day 2 18:12:41 39
6 UnAu 50da-00df-33e0 47 149 Send prob(chlchg) Day 4 8:49:5 41
7 Auth 50da-00df-33e0 47 149 Auth direct(Bss) Day 4 8:49:5 42
8 Asso 50da-00df-33e0 47 149 Send assoc Day 4 8:49:5 43 9
9 Run 50da-00df-33e0 47 149 Rec assoc Day 4 8:49:5 46
Table 15 Command output
Field |
Description |
Radio ID |
ID of the client-mode radio. |
FSM changes |
Number of state changes occurred during the AP association. |
SSID |
SSID of the wireless service with which the client-mode AP associates. |
FSM |
State of the client-mode AP during association: · Init—Initialized. · UnAu—Unauthenticated. · Auth—Authenticated. · Asso—Associated. · Run—Running. · N/A—Abnormal. |
BSSID |
BSSID of the wireless service with which the client-mode AP associates. |
RSSI |
RSSI of the wireless service with which the client-mode AP associates. |
Chl |
Channel of the client-mode AP used to associate with the wireless service. |
FsmChangeCause |
State change reason during AP association: · Rec prob resp—The client-mode AP receives a probe response and then sends an authentication frame. · Send assoc req—The client-mode AP sends an association request. · Rec assoc resp—The client-mode AP receives an association response. · Rec deauth—The client-mode AP receives a deauthentication frame. · Rec disasso—The client-mode AP receives a disassociation frame. · Unauth timeout—The client-mode AP sends an authentication frame upon unauthentication timeout. · Unauth timeout fail—The client-mode AP fails to send an authentication frame upon unauthentication timeout. · Auth timeout—Authentication timeout. · Asso timeout—Association timeout. · Keepalive beacon timeout—Beacon keepalive timeout. · Rec action—The client-mode AP receives an Action frame. · Init to unauth—The state of the client-mode AP changes from initialization to unauthentication. · Disconnect(cfg) —The client-mode AP connection is configured to be disconnected. · Undo SSID—The SSID for the client-mode AP is undone. · Send prob req(chlchg)—After changing the channel, the client-mode AP sends a probe request. · Send prob req fail(chlchg)—After changing the channel, the client-mode AP fails to send a probe request. · Radio down—The radio connecting to the wireless service is unavailable. · Prob resp fail—The client-mode AP fails to process the probe response. · Auth fail(open system)—The client-mode AP fails to process the open-system authentication frame. · Auth fail(share key)—The client-mode AP fails to process the preshared-key authentication frame. · Asso resp fail—The client-mode AP fails to process the association response. · Chl Chg IE(beacon)—The client-mode AP receives a beacon frame and changes the channel. · Chl Chg IE(probe)—The client-mode AP receives a probe response and changes the channel. · Send prob req(unchlchg)—The client-mode AP sends a probe request but does not change the channel. · Connect BSS fail—The client-mode AP fails to associate with the wireless service. · Share-key fail—The client-mode AP fails shared-key authentication during association. · 4H fail—The client-mode AP fails four-way handshake during association. · Select BSS by roam—The client-mode AP selects a BSS for roaming. · Disconnect(dbm)—The client mode is disabled and the AP is disconnected. · Scan aging—The client-mode AP goes offline because of scanning aging. · Unauth timeout—The client-mode AP fails to receive any probe response in UnAuth state and waits in UnAuth state. · Auth direct—The client-mode AP fails to receive any probe response and sends an authentication frame directly. · Active detect timeout—Probe request sending of the client-mode AP timed out. · Disconnect(RSSI)—The RSSI of the associated wireless service is lower than the link hold RSSI and the AP disconnects from the service. · Roam enhance enabled—Enhanced roaming is enabled for the client-mode AP. · Unknown. |
Time |
Time at which the AP state changed during association. |
Related commands
client-mode enable
reset wlan client-mode roaming-state
display wlan client-mode ssid
Use display wlan client-mode ssid to display detected wireless services with an RSSI higher than 15 on the client-mode AP.
Syntax
display wlan client-mode ssid [ ssid ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
ssid: Specifies an SSID, a case-sensitive string of 1 to 32 characters. If you do not specify this argument, the command displays all the detected wireless services with an RSSI higher than 15.
Examples
# Display detected wireless services with an RSSI higher than 15.
<Sysname> display wlan client-mode ssid
SSID name BSSID Type RSSI Quality
service1 1A76-2435-FD21 Clear 55 *****
Temp 2334-5431-BDA1 WPA2 19 **
TC 6CF0-AAFD-12FF WEP 22 **
Test 4512-ABC4-F555 - 17 **
Lab 4138-FAB7-8545 Clear 39 ****
Home_123456789000000000000000000 F643-ABD4-439F WPA2 27 ***
Table 16 Command output
Field |
Description |
SSID name |
Name of the detected SSID. |
BSSID |
Basic service set identifier. |
Type |
Wireless service security encryption type: · Clear. · WPA2. · WEP. This field displays a hyphen (-) if the wireless service cannot be identified. |
RSSI |
Received Signal Strength Indicator, which represents the signal strength of the detected wireless service. |
Quality |
Signal quality: · *****—Extremely excellent (RSSI ≥ 45). · ****—Excellent (35 ≤ RSSI < 45). · ***—Good (25 ≤ RSSI < 35). · **—Low (15 ≤ RSSI < 25). · *—Poor (0 < RSSI < 15). · No Signal—RSSI=0. |
display wlan service-template
Use display wlan service-template to display service template information.
Syntax
display wlan service-template [ service-template-name ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
service-template-name: Specifies a service template by its name, a case-insensitive string of 1 to 63 characters. If you do not specify this argument, the command displays information about all service templates.
verbose: Displays detailed service template information.
Examples
# Display brief information about all service templates.
[Sysname] display wlan service-template
Total number of service templates: 2
Service template name SSID Status
1 2333 Enabled
2 3222 Enabled
# Display detailed information about all service templates.
<Sysname> display wlan service-template verbose
Service template name : service1
Description : Not configured
SSID : wuxianfuwu
SSID-hide : Disabled
User-isolation : Disabled
Service template status : Disabled
Maximum clients per BSS : 64
VLAN ID : 1
AKM mode : PSK
Security IE : RSN
Cipher suite : CCMP
WEP key ID : 1
TKIP countermeasure time : 100 sec
PTK lifetime : 43200 sec
PTK rekey : Enabled
GTK rekey : Enabled
GTK rekey method : Time-based
GTK rekey time : 86400 sec
GTK rekey client-offline : Enabled
WPA3 status : Disabled
Enhance-open status : Enabled
Enhanced-open transition-mode service-template : N/A
User authentication mode : Bypass
Intrusion protection : Disabled
Intrusion protection mode : Temporary-block
Temporary block time : 180 sec
Temporary service stop time : 20 sec
Fail VLAN ID : 1
802.1X handshake : Enabled
802.1X handshake secure : Disabled
802.1X domain : my-domain
MAC-auth domain : Not configured
Max 802.1X users per BSS : 4096
Max MAC-auth users per BSS : 4096
802.1X re-authenticate : Enabled
Authorization fail mode : Online
Accounting fail mode : Online
Authorization : Permitted
Key derivation : SHA1
PMF status : Optional
Hotspot policy number : Not configured
Forwarding policy status : Disabled
Forwarding policy name : Not configured
Forwarder : AP
FT status : Disabled
QoS trust : Port
QoS priority : 0
Table 17 Command output
Field |
Description |
SSID |
SSID of the service template. |
SSID-hide |
Whether the SSID is hidden in beacons: · Disabled. · Enabled. |
User-isolation |
Use isolation: · Disabled. · Enabled. |
Service template status |
Service template status: · Disabled. · Enabled. |
Maximum clients per BSS |
Maximum number of clients that the BSS supports. |
VLAN ID |
ID of the VLAN to which clients belong after they come online through the service template. |
AKM mode |
AKM mode: · 802.1X. · PSK. |
Security IE |
Security IE: · RSN. · WPA. |
Cipher suite |
Cipher suite: · WEP40. · WEP104. · WEP128. · TKIP. · CCMP. · GCMP. |
TKIP countermeasure time |
TKIP countermeasure time. The value 0 indicates no countermeasures are taken. |
PTK rekey |
Whether PTK rekey is enabled: · Enabled. · Disabled. |
GTK rekey |
Whether GTK rekey is enabled: · Enabled. · Disabled. |
GTK rekey method |
GTK rekey method: · Time-based. · Packet-based. |
GTK rekey time |
GTK rekey interval. |
GTK rekey packets |
Number of packets that can be transmitted before the GTK is refreshed. |
GTK rekey client-offline |
Whether client-off GTK rekey is enabled: · Enabled. · Disabled. |
WPA3 status |
WPA3 security mode: · Disabled. · Mandatory. · Optional. |
Enhance-open status |
Whether enhanced open system authentication is enabled: · Disabled. · Enabled. |
Enhanced-open transition-mode service-template |
Recommended service template in transition mode. If no service template is specified, this field displays N/A. |
User authentication mode |
Authentication mode: · Bypass—No authentication. · MAC. · MAC-or-802.1X—MAC authentication is performed first. If MAC authentication fails, 802.1X authentication is performed. · 802.1X. · 802.1X-or-MAC—802.1X authentication is performed first. If 802.1X authentication fails, MAC authentication is performed. · OUI-or-802.1X—OUI authentication is performed first. If OUI authentication fails, 802.1X authentication is performed. |
Intrusion protection |
Whether intrusion protection is enabled: · Enabled. · Disabled. |
Intrusion protection mode |
Intrusion protection mode: · Temporary-block—Temporarily adds intruders to the block list. · Service-stop—Stops all services provided by the BSS that receives illegal packets until it resets. · Temporary-service-stop—Temporarily stops the access service provided by the BSS that receives illegal packets. |
Temporary block time |
Temporary block time in seconds. |
Temporary service stop time |
Temporary service stop time in seconds. |
Fail VLAN ID |
ID of the VLAN to which clients are added if they cannot pass the authentication when the authentication server can be reached. This field displays Not configured if the fail VLAN ID is not configured. |
Critical VLAN ID |
ID of the VLAN to which clients are added if they cannot pass the authentication because the authentication server cannot be reached. This field displays Not configured if the critical VLAN ID is not configured. |
802.1X handshake |
Whether 802.1X handshake is enabled: · Enabled. · Disabled. |
802.1X handshake secure |
Whether secure 802.1X handshake is enabled: · Enabled. · Disabled. |
802.1X domain |
802.1X authentication domain. This field displays Not configured if the domain is not configured. |
MAC-auth domain |
MAC authentication domain. This field displays Not configured if the domain is not configured. |
Max 802.1X users per BSS |
Maximum number of supported 802.1X users in a BSS. |
Max MAC-auth users per BSS |
Maximum number of supported users that pass the MAC authentication in a BSS. |
802.1X re-authenticate |
Whether 802.1X reauthentication is enabled: · Enabled. · Disabled. |
Authorization fail mode |
Authorization fail mode: · Offline—Clients are logged off when authorization fails. · Online—Clients are not logged off when authorization fails. |
Accounting fail mode |
Accounting fail mode: · Offline—Clients are logged off when accounting fails. · Online—Clients are not logged off when accounting fails. |
Authorization |
Authorization information: · Permitted—Applies the authorization information issued by the RADIUS server or the local device. · Ignored—Ignores the authorization information issued by the RADIUS server or the local device. |
Key derivation |
Key derivation type: · SHA1—Uses the HMAC-SHA1 hash algorithm. · SHA256—Uses the HMAC-SHA256 hash algorithm. · SHA1-AND-SHA256—Uses the HMAC SHA1 and SHA256 hash algorithm. |
PMF status |
PMF status: · Disabled—Management frame protection is disabled. · Optional—Management frame protection in optional mode is enabled. · Mandatory—Management frame protection in mandatory mode is enabled. |
Hotspot policy number |
This field is not supported in the current software version. Hotspot 2.0 policy number. |
Forwarding policy status |
This field is not supported in the current software version. WLAN forwarding policy status: · Disabled. · Enabled. |
Forward policy name |
This field is not supported in the current software version. WLAN forwarding policy name: · Not configured—No WLAN forwarding policy is configured. · policy-name. |
Forwarder |
Client traffic forwarder: AP. |
FT status |
FT status: · Disabled. · Enabled. |
FT method |
FT method: · over-the-air. · over-the-ds. |
FT reassociation deadline |
FT reassociation timeout timer in seconds. |
QoS trust |
QoS priority trust mode: · Port—Port priority trust mode. · Dot11e—802.11e priority trust mode. |
QoS priority |
Port priority in the range of 0 to 7. |
display wlan statistics client
Use display wlan statistics client to display client statistics.
Syntax
display wlan statistics client [ mac-address mac-address ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
mac-address mac-address: Specifies a client by its MAC address. If you do not specify this option, the command displays statistics for all clients.
Examples
# Display statistics for all clients.
<Sysname> display wlan statistics client
MAC address : 0014-6c8a-43ff
AP name : fatap
Radio ID : 1
SSID : office
BSSID : 000f-e2ff-7700
RSSI : 31
Sent frames:
Back ground : 0/0 (frames/bytes)
Best effort : 9/1230 (frames/bytes)
Video : 0/0 (frames/bytes)
Voice : 2/76 (frames/bytes)
Received frames:
Back ground : 0/0 (frames/bytes)
Best effort : 18/2437 (frames/bytes)
Video : 0/0 (frames/bytes)
Voice : 7/468 (frames/bytes)
Discarded frames:
Back ground : 0/0 (frames/bytes)
Best effort : 0/0 (frames/bytes)
Video : 0/0 (frames/bytes)
Voice : 5/389 (frames/bytes)
Table 18 Command output
Field |
Description |
SSID |
SSID of the service template. |
MAC address |
Client MAC address. |
Back ground |
AC-BK queue. |
Best effort |
AC-BE queue. |
Video |
AC-VI queue. |
Voice |
AC-VO queue. |
display wlan statistics connect-history
Use display wlan statistics connect-history to display client connection history.
Syntax
display wlan statistics connect-history service-template service-template-name
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
service-template service-template-name: Specifies a service template by its name.
Examples
# Display the connection history for service template 1.
<Sysname> display wlan statistics connect-history service-template 1
AP name : fatap
Radio ID : 1
Associations : 132
Association failures : 3
Reassociations : 30
Rejections : 12
Abnormal disassociations : 2
Current associations : 57
display wlan statistics service template
Use display wlan statistics service-template to display service template statistics.
Syntax
display wlan statistics service-template service-template-name
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
service-template service-template-name: Specifies a service template by its name.
Examples
# Display statistics for service template 1.
<Sysname> display wlan statistics service-template 1
AP name : fatap
Radio ID : 1
Received:
Frame count : 1713
Frame bytes : 487061
Data frame count : 1683
Data frame bytes : 485761
Association request count : 2
Sent:
Frame count : 62113
Frame bytes : 25142076
Data frame count : 55978
Data frame bytes : 22626600
Association response count : 2
display wlan whitelist
Use display wlan whitelist to display whitelist entries.
Syntax
display wlan whitelist
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display whitelist entries.
<Sysname> display wlan whitelist
Total number of clients: 3
MAC addresses:
000e-35b2-000e
0019-5b8e-b709
001c-f0bf-9c92
interface wlan-radio
Use interface wlan-radio to enter WLAN radio interface view.
Syntax
interface wlan-radio interface-number
Views
System view
Predefined user roles
network-admin
Examples
interface-number: Specifies the WLAN radio interface ID.
Examples
# Enter interface view of WLAN-Radio 1/0/1.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1]
Related commands
display interface wlan-radio
nas-id
Use nas-id to set the network access server identifier (NAS ID).
Syntax
nas-id nas-id
undo nas-id
Default
No NAS ID is specified.
Views
Global configuration view
Predefined user roles
network-admin
Parameters
nas-id: Specifies a NAS ID, a case-sensitive string of 1 to 63 characters.
Usage guidelines
After coming online, a client sends a RADIUS request that carries the NAS ID to the RADIUS server to indicate its network access server.
Examples
# Set the global NAS ID to abc123.
<Sysname> system-view
[Sysname] wlan global-configuration
[Sysname-wlan-global-configuration] nas-id abc123
nas-port-type
Use nas-port-type to set the NAS port type attribute in RADIUS requests.
Use the undo nas-port-type to restore the default.
Syntax
nas-port-type value
undo nas-port-type
Default
The NAS port type is Wireless-IEEE 802.11.
Views
Service template view
Predefined user roles
network-admin
Parameters
value: Specifies a NAS port type by its code value in the range of 0 to 255. Table 19 lists the most commonly used NAS port types and their code values.
Table 19 Common NAS port types and their code values
NAS port type |
Code value |
Async |
0 |
Sync |
1 |
ISDN Sync |
2 |
ISDN Async V.120 |
3 |
ISDN Async V.110 |
4 |
Virtual |
5 |
PIAFS |
6 |
HDLC Clear Channel |
7 |
X.25 |
8 |
X.75 |
9 |
G.3 Fax |
10 |
SDSL |
11 |
ADSL-CAP |
12 |
ADSL-DMT |
13 |
IDSL |
14 |
Ethernet |
15 |
xDSL |
16 |
Cable |
17 |
Wireless-Other |
18 |
Wireless-IEEE 802.11 |
19 |
Usage guidelines
You can execute this command to set the NAS port type attribute in RADIUS requests for 802.11X and MAC-authenticated clients.
Make sure the service template is disabled before you execute this command.
Examples
# Set the NAS port type in RADIUS requests to 15 (Ethernet).
<Sysname> system-view
[Sysname] wlan service-template 1
[Sysname-wlan-st-1] nas-port-type 15
quick-association enable
Use quick-association to enable quick association.
Use undo quick-association to disable quick association.
Syntax
quick-association enable
undo quick-association enable
Default
Quick association is disabled.
Views
Service template view
Predefined user roles
network-admin
Usage guidelines
This command disables APs from performing load balancing or band navigation on clients associated with the specified service template.
Examples
# Enable quick association for service template service1.
<Sysname> system-view
[Sysname] wlan service-template service1
[Sysname-wlan-st-service1]quick-association enable
reset wlan client
Use reset wlan client to log off a client or all clients.
Syntax
reset wlan client { all | mac-address mac-address }
View
User view
Predefined user roles
network-admin
Parameters
all: Specifies all clients.
mac-address mac-address: Specifies a client by its MAC address.
Examples
# Log off all clients.
<Sysname> reset wlan client all
Related commands
display wlan client
reset wlan dynamic-blacklist
Use reset wlan dynamic-blacklist to remove the specified client or all clients from the dynamic blacklist.
Syntax
reset wlan dynamic-blacklist [ mac-address mac-address ]
Views
User view
Predefined user roles
network-admin
Parameters
mac-address mac-address: Specifies a client by its MAC address. If you do not specify this option, the command removes all clients from the dynamic blacklist.
Examples
# Remove all clients from the dynamic blacklist.
<Sysname> reset wlan dynamic-blacklist
# Remove the specified client from the dynamic blacklist.
<Sysname> reset wlan dynamic-blacklist mac-address b8ca-32a2-df69
Related commands
display wlan blacklist
reset wlan statistics client
Use reset wlan statistics client to clear client statistics.
Syntax
reset wlan statistics client { all | mac-address mac-address }
View
User view
Predefined user roles
network-admin
Parameters
all: Specifies all clients.
mac-address mac-address: Specifies a client by its MAC address.
Examples
# Clear statistics about all clients.
<Sysname> reset wlan statistics client all
Related commands
display wlan statistics
reset wlan statistics service-template
Use reset wlan statistics service-template to clear service template statistics.
Syntax
reset wlan statistics service-template service-template-name
View
User view
Predefined user roles
network-admin
Parameters
service-template-name: Specifies a service template by its name, a case-insensitive string of 1 to 63 characters.
Examples
# Clear statistics about service template service1.
<Sysname> reset wlan statistics service-template service1
Related commands
display wlan statistics
service-template
Use service-template to bind a service template to a radio interface.
Use undo service-template to unbind a service template from a radio interface.
Syntax
service-template service-template-name
undo service-template service-template-name
Default
In radio interface view, no service template is bound to a radio interface.
Views
Radio interface view
Predefined user roles
network-admin
Parameters
service-template-name: Specifies a service template by its name, a case-insensitive string of 1 to 63 characters.
Usage guidelines
Before you bind a service template to a radio or a radio interface, you must create the service template.
Examples
# Bind service template service1 to interface WLAN-Radio 1/0/1.
<Sysname> system-view
[Sysname] interface wlan-radio 1/0/1
[Sysname-WLAN-Radio1/0/1] service-template service1
service-template enable
Use service-template enable to enable a service template.
Use undo service-template enable to disable a service template.
Syntax
service-template enable
undo service-template enable
Default
A service template is disabled.
Views
Service template view
Predefined user roles
network-admin
Usage guidelines
If the number of BSSs on a device exceeds the limit, you cannot enable a new service template.
Examples
# Enable service template service1.
<Sysname> system-view
[Sysname] wlan service-template service1
[Sysname-wlan-st-service1] service-template enable
ssid
Use ssid to set an SSID for a service template.
Use undo ssid to restore the default.
Syntax
ssid ssid-name
undo ssid
Default
No SSID is configured for a service template.
Views
Service template view
Predefined user roles
network-admin
Parameters
ssid-name: Specifies an SSID name, a case-sensitive string of 1 to 32 characters.
Usage guidelines
Disable the service template before you execute this command.
Examples
# Set the SSID to lynn for service template service1.
<Sysname> system-view
[Sysname] wlan service-template service1
[Sysname-wlan-st-service1] ssid lynn
unknown-client
Use unknown-client to set the way that an AP processes traffic from unknown clients.
Use undo unknown-client to restore the default.
Syntax
unknown-client { deauthenticate | drop }
undo unknown-client
Default
An AP drops packets from unknown clients and deauthenticates these clients.
Views
Service template view
Predefined user roles
network-admin
Parameters
deauthenticate: Drops packets from unknown clients and deauthenticates these clients.
drop: Drops packets from unknown clients.
Examples
# Configure APs that use service template example to drop packets from unknown clients but not deauthenticate these clients.
<Sysname> system-view
[Sysname] wlan service-template example
[Sysname-wlan-st-example] unknown-client drop
vip limit rate
Use vip limit rate to enable VIP client rate limit.
Use undo vip limit rate to disable VIP client rate limit.
Syntax
vip limit rate level level { inbound | outbound } mode { dynamic [ min min-cir ] [ max max-cir ] | static } cir cir
undo vip limit rate level level { inbound | outbound }
Default
VIP client rate limit is disabled.
Views
VIP client group view
Predefined user roles
network-admin
Parameters
level level: Specifies the VIP client level. Only 2 is available.
inbound: Limits the rate of incoming traffic.
outbound: Limits the rate of outgoing traffic.
dynamic: Specifies the dynamic rate limit mode. In this mode, the limited rate for each client is the total CIR divided by the number of clients.
min min-cir: Specifies the minimum CIR for each client, in the range of 16 to 1700000 Kbps. If you do not specify this option, the command does not limit the minimum total CIR.
max max-cir: Specifies the maximum CIR for each client, in the range of 16 to 1700000 Kbps. The maximum CIR must be larger than the minimum CIR. If you do not specify this option, the command does not limit the maximum total CIR.
static: Specifies the static rate limit mode. In this mode, the limited rate for each client is a fixed value.
cir cir: Specifies the CIR in Kbps. The value range for the cir argument is 16 to 1700000 Kbps.
Usage guidelines
If a large number of VIP clients are online, you can perform this task to rate limit VIP clients to guarantee bandwidth for each client and ensure good user experience.
If you specify both the minimum and maximum CIRs for dynamic rate limit, the feature operates as follows:
· If the specified CIR divided by the total number of clients is smaller than the minimum CIR, the minimum CIR takes effect for each client.
· If the specified CIR divided by the total number of clients is larger than the maximum CIR, the maximum CIR takes effect for each client.
· If the specified CIR divided by the total number of clients is between the minimum and maximum CIRs, the specified CIR divided by the total number of clients takes effect for each client.
You can execute this command multiple times to limit the rates of both the incoming and outgoing traffic.
If you configure both VIP client rate limit and radio-based client rate limit, the configuration that takes effect depends on the rate limit modes (static or dynamic):
· If different rate limit modes are configured, VIP client rate limit takes effect.
· If the static mode is configured, the smaller CIR takes effect.
· If the dynamic mode is configured, VIP client rate limit takes effect.
Examples
# Configure static VIP client rate limit: set the CIR to 500 Kbps for incoming traffic and set the CIR to 100 Kbps for outgoing traffic.
<Sysname> system-view
[Sysname] wlan vip-client-group
[Sysname-vip-client-group] vip limit rate level 2 inbound mode static cir 500
[Sysname-vip-client-group] vip limit rate level 2 outbound mode static cir 100
Related commands
client-rate-limit (radio view/AP group radio view)
vlan
Use vlan to assign clients coming online through a service template to the specified VLAN.
Use undo vlan to restore the default.
Syntax
vlan vlan-id
undo vlan [ vlan-id ]
Default
Clients are assigned to VLAN 1 after coming online through a service template.
Views
Service template view
Predefined user roles
network-admin
Parameters
vlan-id: Specifies a VLAN by its VLAN ID, in the range of 1 to 4094. If the specified VLAN does not exist, this command creates the VLAN when clients come online.
Usage guidelines
Disable the service template before you execute this command.
If the specified VLAN does not exist, this command creates the VLAN when clients come online.
Examples
# Assign clients coming online through service template service1 to VLAN 2.
<Sysname> system-view
[Sysname] wlan service-template service1
[Sysname-wlan-st-service1] vlan 2
wlan association optimization
Use wlan association optimization to set the index for optimizing client association ratios.
Use undo wlan association optimization to restore the default.
Syntax
wlan association optimization value
undo wlan association optimization
Default
The index is 0. The device does not optimize client association ratios.
Views
System view
Predefined user roles
network-admin
Parameters
value: Specifies the index for optimizing client association ratios, in the range of 900 to 1000. The smaller the index is, the smaller the calculated association success ratio will be and the larger the calculated congestion ratio and abnormal disassociation ratio will be.
Usage guidelines
This feature enables the device to recalculate the client association success ratio, association congestion ratio, and abnormal disassociation ratio by using the specified index to get smaller ratio values.
The client association success ratio is the number of successful client associations divided by the total number of client association attempts. The client association congestion ratio is the number of failed client associations caused by AP overloading divided by the total number of client association attempts. The client abnormal disassociation ratio is the number of abnormal disassociations divided by the sum of successful associations and online clients.
Examples
# Set the index for optimizing client association ratios to 950.
<Sysname> system-view
[Sysname] wlan association optimization 950
wlan broadcast-probe reply
Use wlan broadcast-probe reply to enable the AP to respond to broadcast probe requests.
Use undo wlan broadcast-probe reply to disable the AP from responding to broadcast probe requests.
Syntax
wlan broadcast-probe reply [ rssi-threshold rssi-value ] [ frequency-band { 2.4 | 5 } ]
undo wlan broadcast-probe reply [ frequency-band { 2.4 | 5 } ]
Default
The AP responds to broadcast probe requests from clients operating at any frequency band.
Views
System view
Predefined user roles
network-admin
Parameters
rssi-threshold rssi-value: Specifies an RSSI threshold in the range of 1 to 100. If you do not specify this option, the command enables the AP to respond to broadcast probe requests with any RSSIs.
frequency-band: Specifies a frequency band. If you do not specify this keyword, the command enables the AP to respond to broadcast probe requests received at both the 5 GHz and 2.4 GHz bands.
2.4: Specifies the 2.4 GHz band.
5: Specifies the 5 GHz band.
Usage guidelines
Broadcast probe requests do not carry any SSIDs. Upon receiving a broadcast probe request, the AP responds with a probe response that carries service information for the AP.
By default, the AP responds to all broadcast probe requests, which might threat network security and decrease AP performance. However, disabling responding to broadcast probe requests might forbid clients from roaming to the optimal AP in time, affecting client access.
You can perform this task to enable the AP to respond to broadcast requests from a specific frequency band with strong signal strength.
Examples
# Disable the AP from responding to broadcast probe requests from clients operating at all frequency bands.
<Sysname> system-view
[Sysname] undo wlan broadcast-probe reply
wlan client bss-load-ie enable
Use wlan client bss-load-ie enable to enable beacon frames and probe responses to carry the BSS Load IE.
Use undo wlan client bss-load-ie enable to disable beacon frames and probe responses from carrying the BSS Load IE.
Syntax
wlan client bss-load-ie enable [ update-interval interval ]
undo wlan client bss-load-ie enable
Default
Beacon frames and probe responses do not carry the BSS Load IE.
Views
System view
Predefined user roles
network-admin
Parameters
update-interval interval: Specifies the update interval for the BSS Load IE, in the range of 5 to 30 seconds. The default value is 15.
Usage guidelines
With this feature enabled, the beacon frames and probe responses send by the device carry the BSS Load IE. The IE contains the number of clients in each BSS on the radio, the channel usage, and the remaining media time.
In a roaming network, enable this feature as a best practice for clients to use the BSS Load IE to select the optimal network.
Examples
# Enable beacon frames and probe responses to carry the BSS Load IE.
<Sysname> system-view
[Sysname] wlan client bss-load-ie enable
wlan client idle-timeout
Use wlan client idle-timeout to set the client idle timeout timer.
Use undo wlan client idle-timeout to restore the default.
Syntax
wlan client idle-timeout timeout
undo wlan client idle-timeout
Default
The client idle timeout timer is 3600 seconds.
Views
System view
Predefined user roles
network-admin
Parameters
timeout: Specifies the client idle timeout timer in the range of 60 to 86400 seconds.
Usage guidelines
If an online client does not send any frames to the associated AP before the client idle timeout timer expires, the AP logs off the client.
Examples
# Set the client idle timeout timer to 2000 seconds.
<Sysname> system-view
[Sysname] wlan client idle-timeout 2000
wlan client keep-alive
Use wlan client keep-alive enable to enable client keepalive.
Use undo wlan client keep-alive to disable client keepalive.
Syntax
wlan client keep-alive enable
undo wlan client keep-alive
Default
Client keepalive is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
This feature enables the AP to send keepalive packets to clients at the specified intervals to determine whether the clients are online. If the AP does not receive any replies from a client within three keepalive intervals, it logs off the client.
Examples
# Enable client keepalive.
<Sysname> system-view
[Sysname] client keep-alive enable
Related commands
wlan client keep-alive interval
wlan client keep-alive interval
Use wlan client keep-alive interval to set the client keepalive interval.
Use undo wlan client keep-alive interval to restore the default.
Syntax
wlan client keep-alive interval interval
undo wlan client keep-alive interval
Default
The client keepalive interval is 300 seconds.
Views
System view
Predefined user roles
network-admin
Parameters
interval: Specifies the client keepalive interval in the range of 3 to 1800 seconds.
Usage guidelines
Enable client keepalive on the fat AP before you execute this command.
This feature enables an AP to send keepalive packets to clients at the client keepalive interval to determine whether the clients are online. If the AP does not receive any replies from a client within three keepalive intervals, it logs off the client.
Examples
# Set the client keepalive interval to 1000 seconds.
<Sysname> system-view
[Sysname] wlan client keep-alive interval 1000
Related commands
wlan client keep-alive
wlan client reauthentication-period
Use wlan client reauthentication-period to set the idle period before client reauthentication.
Use undo wlan client reauthentication-period to restore the default.
Syntax
wlan client reauthentication-period [ period-value ]
undo wlan client reauthentication-period
Default
The idle period is 10 seconds.
Views
System view
Predefined user roles
network-admin
Parameters
period-value: Specifies the idle period in the range of 1 to 3600 seconds.
Usage guidelines
When URL redirection for WLAN MAC authentication is enabled, an AP redirects clients whose information is not recorded on the RADIUS server to the specified URL for Web authentication. Clients passing Web authentication are logged off and must perform MAC reauthentication to come online. However, MAC reauthentication fails if the IP addresses assigned to the clients have not expired.
Perform this task to add these clients to the dynamic blacklist for the specified idle period after they pass Web authentication to reduce reauthentication failures.
Examples
# Set the idle period before client reauthentication to 100 seconds.
<Sysname> system-view
[Sysname] wlan client reauthentication-period 100
wlan dynamic-blacklist lifetime
Use wlan dynamic-blacklist lifetime to set the aging time for dynamic blacklist entries.
Use undo wlan dynamic-blacklist lifetime to restore the default.
Syntax
wlan dynamic-blacklist lifetime lifetime
undo wlan dynamic-blacklist lifetime
Default
The aging time is 300 seconds for dynamic blacklist entries.
Views
System view
Predefined user roles
network-admin
Parameters
lifetime: Specifies the aging time in the range of 1 to 3600 seconds.
Usage guidelines
The configured aging time takes effect only on entries added to the dynamic blacklist after this command is executed.
The aging time for dynamic blacklist entries only applies to rogue client entries.
Examples
# Set the aging time for dynamic blacklist entries to 3600 seconds.
<Sysname> system-view
[Sysname] wlan dynamic-blacklist lifetime 3600
wlan link-test
Use wlan link-test to test wireless link quality.
Syntax
wlan link-test mac-address
Views
Any view
Predefined user roles
network-admin
Parameters
mac-address: Specifies the client MAC address in the H-H-H format.
Usage guidelines
Wireless link quality detection enables an AP to test the quality of the link to a wireless client. The AP sends empty data frames to the client at each supported rate. Then it calculates link quality information such as RSSI, packet retransmissions, and RTT based on the responses from the client.
The timeout timer for wireless link quality detection is 10 seconds. If wireless link detection is not completed within the timeout timer, test results cannot be obtained.
Examples
# Test the quality of the wireless link to the client with MAC address 60a4-4cda-eff0.
<Sysname> wlan link-test 60a4-4cda-eff0
Testing link to 60a4-4cda-eff0. Press CTRL + C to break.
Link Status
-----------------------------------------------------------------------
MAC address: 60a4-4cda-eff0
-----------------------------------------------------------------------
VHT-MCS Rate(Mbps) Tx packets Rx packets RSSI Retries RTT(ms)
-----------------------------------------------------------------------
NSS = 1
-----------------------------------------------------------------------
0 32.5 5 5 54 0 0
1 65 5 5 51 0 0
2 97.5 5 5 49 0 0
3 130 5 5 47 0 0
4 195 5 5 45 0 0
5 260 5 5 45 0 0
6 292.5 5 5 44 0 0
7 325 5 5 44 0 0
8 390 5 5 44 0 0
9 433.3 5 5 43 0 0
-----------------------------------------------------------------------
NSS = 2
-----------------------------------------------------------------------
0 65 5 5 44 0 0
1 130 5 5 44 0 0
2 195 5 5 44 0 0
3 260 5 5 44 0 0
4 390 5 5 44 0 0
5 520 5 5 44 0 0
6 585 5 5 43 0 0
7 650 5 5 43 0 0
8 780 5 5 43 0 0
9 866.7 5 5 43 0 0
# Test the quality of the wireless link to the client with MAC address 60a4-4cda-eff0.
<Sysname> wlan link-test 784f-43b6-077c
Testing link to 784f-43b6-077c. Press CTRL + C to break.
Link Status
-----------------------------------------------------------------------
MAC address: 784f-43b6-077c
-----------------------------------------------------------------------
MCS Rate(Mbps) Tx packets Rx packets RSSI Retries RTT(ms)
-----------------------------------------------------------------------
0 6.5 5 5 54 0 0
1 13 5 5 51 0 0
2 19.5 5 5 49 0 0
3 26 5 5 47 0 0
4 39 5 5 45 0 0
5 52 5 5 45 0 0
6 58.5 5 5 44 0 0
7 72.2 5 5 44 0 0
8 13 5 5 44 0 0
9 26 5 5 43 0 0
10 39 5 5 44 0 0
11 52 5 5 44 0 0
12 78 5 5 44 0 0
13 104 5 5 44 0 0
14 117 5 5 44 0 0
15 144.4 5 5 44 11 0
-----------------------------------------------------------------------
Table 20 Command output
Field |
Description |
No./MCS/VHT-MCS |
· No.—Rate number for link quality test on 802.11a, 802.11b, or 802.11g clients. · MCS—MCS index for link quality test on 802.11n clients. · VHT-MCS—VHT-MCS index for link quality test on 802.11ac clients. |
Rate(Mbps) |
Rate at which the AP sends wireless link quality detection frames. |
Tx packets |
Number of wireless link quality detection frames sent by the AP. |
Rx packets |
Number of responses received by the AP. |
RSSI |
RSSI of the client detected by the AP. |
Retries |
Number of wireless link quality retransmission frames sent by the AP. |
RTT(ms) |
Round trip time for link quality test frames from the AP to the client. |
NSS |
Number of spatial streams for link quality test on 802.11n or 802.11ac clients. |
wlan nas-port-id format
Use wlan nas-port-id format to set the format of NAS port IDs for wireless clients.
Use undo wlan nas-port-id format to restore the default.
Syntax
wlan nas-port-id format { 2 | 4 }
undo wlan nas-port-id format
Default
Clients use format 2 to generate NAS port IDs.
Views
System view
Predefined user roles
network-admin
Parameters
2: Specifies the SlotID00IfNOVlanID format.
· SlotID—Slot ID for client access, a string of two characters.
· IfNO—Interface number for client access, a string of three characters.
· VlanID—VLAN ID for client access, a string of nine characters.
4: Specifies the slot=**;subslot=**;port=**;vlanid=**;vlanid2=** format. The vlanid2 field is available only for clients accessing the WLAN through an interface configured with VLAN termination.
Usage guidelines
802.1X and MAC-authenticated clients fill NAS port IDs in the specified format in RADIUS packets.
Examples
# Set the NAS port ID format to format 4.
<Sysname> system-view
[Sysname] wlan nas-port-id format 4
wlan service-template
Use wlan service-template to create a service template and enter its view, or enter the view of an existing service template.
Use undo wlan service-template to delete a service template.
Syntax
wlan service-template service-template-name
undo wlan service-template service-template-name
Default
No service template exists.
Views
System view
Predefined user roles
network-admin
Parameters
service-template-name: Specifies a service template by its name, a case-insensitive string of 1 to 63 characters.
Usage guidelines
You cannot delete a service template that has been bound to a radio.
Examples
# Create service template service1 and enter its view.
<Sysname> system-view
[Sysname] wlan service-template service1
wlan static-blacklist mac-address
Use wlan static-blacklist mac-address to add a client to the static blacklist.
Use undo wlan static-blacklist mac-address to remove a client from the static blacklist.
Syntax
wlan static-blacklist mac-address mac-address
undo wlan static-blacklist [ mac-address mac-address ]
Default
No clients exist in the static blacklist.
Views
System view
Predefined user roles
network-admin
Parameters
mac-address mac-address: Specifies a client by its MAC address in the format of H-H-H.
Usage guidelines
If you add an online client to the static blacklist, the command logs off the client.
You cannot add a client to both the whitelist and the static blacklist.
The undo form of the command removes all clients from the static blacklist if you do not specify the mac-address mac-address option.
Do not add multicast or broadcast MAC addresses to the static blacklist.
Examples
# Add MAC address 001c-f0bf-9c92 to the static blacklist.
<Sysname> system-view
[Sysname] wlan static-blacklist mac-address 001c-f0bf-9c92
Related commands
display wlan blacklist
wlan web-server api-path
Use wlan web-server api-path to specify the path of the Web server to which client information is reported.
Use undo wlan web-server api-path to restore the default.
Syntax
wlan web-server api-path path
undo wlan web-server api-path
Default
The path of the Web server is not specified.
Views
System view
Predefined user roles
network-admin
Parameters
path: Specifies a path, a case-sensitive string of 1 to 256 characters.
Usage guidelines
The Web server accepts client information only when the server's host name, port number, and path are specified.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Specify the path of the Web server as /wlan/dev-cfg.
<Sysname> system-view
[Sysname] wlan web-server api-path /wlan/dev-cfg
Related commands
wlan web-server host
wlan web-server max-client-entry
wlan web-server host
Use wlan web-server host to specify the host name and port number of the Web server to which client information is reported.
Use undo wlan web-server host to restore the default.
Syntax
wlan web-server host host-name port port-number
undo wlan web-server host
Default
The host name and port number of the Web server are not specified.
Views
System view
Predefined user roles
network-admin
Parameters
host host-name: Specifies a host name, a case-insensitive string of 3 to 127 characters that can contain letters, digits, hyphens (-), underscores (_), and dots (.).
port port-number: Specifies a port number in the range of 1 to 65534.
Usage guidelines
The Web server accepts client information only when the server's host name, port number, and path are specified.
Client information changes are reported to the Web server in real time.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Specify the host name and port number of the Web server as www.abc.com and 668, respectively.
<Sysname> system-view
[Sysname] wlan web-server host www.abc.com port 668
Related commands
wlan web-server api-path
wlan web-server max-client-entry
wlan web-server max-client-entry
Use wlan web-server max-client-entry to set the maximum number of client entries that can be reported at a time.
Use undo wlan web-server max-client-entry to restore the default.
Syntax
wlan web-server max-client-entry number
undo wlan web-server max-client-entry
Default
A maximum of ten client entries can be reported at a time.
Views
System view
Predefined user roles
network-admin
Parameters
number: Specifies a maximum number of client entries that can be reported at a time, in the range of 1 to 25.
Examples
# Set the maximum of client entries that can be reported at a time to 12.
<Sysname> system-view
[Sysname] wlan web-server max-client-entry 12
Related commands
wlan web-server api-path
wlan web-server host
wlan whitelist mac-address
Use wlan whitelist mac-address to add a client to the whitelist.
Use undo wlan whitelist mac-address to remove a client from the whitelist.
Syntax
wlan whitelist mac-address mac-address
undo wlan whitelist [ mac-address mac-address ]
Default
No clients exist in the whitelist.
Views
System view
Predefined user roles
network-admin
Parameters
mac-address mac-address: Specifies a client by its MAC address in the format of H-H-H.
Usage guidelines
When you add the first client to the whitelist, the system asks you whether to disconnect all online clients. Enter Y at the prompt to configure the whitelist.
If you remove an online client from the whitelist, the command logs off the client. If you remove all clients from the whitelist, online clients will not be logged off.
You cannot add a client to both the whitelist and the static blacklist.
The undo form of the command removes all clients from the whitelist if you do not specify the mac-address mac-address option.
Do not add multicast or broadcast MAC addresses to the whitelist.
Examples
# Add MAC address 001c-f0bf-9c92 to the whitelist.
<Sysname> system-view
[Sysname] wlan whitelist mac-address 001c-f0bf-9c92
This command will disconnect all clients. Continue? [Y/N]:
Related commands
display wlan whitelist