- Table of Contents
-
- 03-WLAN Command References
- 00-Preface
- 01-AP management commands
- 02-Radio management commands
- 03-WLAN access commands
- 04-WLAN security commands
- 05-WLAN authentication commands
- 06-WIPS commands
- 07-WLAN QoS commands
- 08-WLAN roaming commands
- 09-WLAN load balancing commands
- 10-WLAN radio resource measurement commands
- 11-Channel scanning commands
- 12-Band navigation commands
- 13-WLAN high availability commands
- 14-802.11r commands
- 15-Wireless location commands
- 16-AC hierarchy commands
- 17-WLAN RRM commands
- 18-WLAN IP snooping commands
- 19-WLAN probe commands
- 20-WLAN forwarding commands
- 21-Spectrum management commands
- 22-WLAN radio load balancing commands
- 23-User isolation commands
- 24-Packet capture commands
- 25-802.1X client commands
- 26-IP source guard commands
- Related Documents
-
Title | Size | Download |
---|---|---|
01-AP management commands | 344.91 KB |
display wlan ap all feature capwap
display wlan ap connection-record
display wlan ap running-configuration
display wlan ap statistics association-failure-record
display wlan ap statistics online-record
display wlan ap statistics tunnel-down-record
display wlan ap tunnel latency
display wlan ap unauthenticated
display wlan ap-distribution ap-name
reset wlan ap connection-record
snmp-agent trap enable wlan ap
snmp-agent trap enable wlan capwap
statistics-interval fast-report
AP management commands
ac
Use ac to specify an AC for an AP.
Use undo ac to delete the specified AC information.
Syntax
ac { host-name hostname | ip ipv4-address }
undo ac { host-name | ip [ ipv4-address ] }
Default
In AP provision view, an AP uses the configuration in AP group provision view.
In AP group provision view, no AC is specified for an AP.
Views
AP provision view
AP group provision view
Predefined user roles
network-admin
Parameters
host-name host-name: Specifies an AC by its host name, a case-insensitive string of 1 to 253 characters. The string can contain letters, digits, hyphens (-), underscores (_), and dots (.).
ip ipv4-address: Specifies an AC by its IPv4 address.
Usage guidelines
You can configure a maximum of three AC IPv4 addresses and only one host name. If you configure multiple host names, the most recent configuration takes effect.
The configuration in AP provision view takes effect only on the AP. The configuration in AP group provision view takes effect on all APs in the AP group. The configuration in AP provision view takes precedence over the configuration in AP group provision view.
The undo form of the command deletes all AC IPv4 addresses if you do not specify the ipv4-address argument.
Examples
# Specify the AC whose IP address is 192.168.100.11 for AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan-ap-ap1] provision
[Sysname-wlan-ap-ap1-prvs] ac ip 192.168.100.11
# Specify the AC whose IP address is 192.168.100.11 for APs in AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] provision
[Sysname-wlan-ap-group-group1-prvs] ac ip 192.168.100.11
ac discovery policy ipv6
Use ac discovery policy ipv6 to enable an AP to prefer discovering ACs by IPv6 address.
Use undo ac discovery policy ipv6 to restore the default.
Syntax
ac discovery policy ipv6
undo ac discovery policy ipv6
Default
In AP provision view, an AP uses the configuration in AP group provision view.
In AP group provision view, an AP prefers to discover ACs by IPv4 address.
Views
AP provision view
AP group provision view
Predefined user roles
network-admin
Usage guidelines
This feature enables an AP to discover ACs by using static IP addresses, IPv6 multicast, DHCPv6 option, IPv6 DNS, DHCPv4 options, broadcast/IPv4 multicast, and IPv4 DNS successively. If the AP connects to an AC successfully with a discovered IP address, it stops AC discovery.
Examples
# Enable AP ap1 to prefer discovering ACs by IPv6 address.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan-ap-ap1] provision
[Sysname-wlan-ap-ap1-prvs] ac discovery policy ipv6
# Enable APs in AP group group1 to prefer discovering ACs by IPv6 address.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] provision
[Sysname-wlan-ap-group-group1-prvs] ac discovery policy ipv6
ap
Use ap to create an AP grouping rule by AP names.
Use undo ap to delete an AP grouping rule by AP names.
Syntax
ap ap-name-list
undo ap ap-name-list
Default
No AP grouping rules by AP names exist.
Views
AP group view
Predefined user roles
network-admin
Parameters
ap-name-list: Specifies a maximum of 10 space-separated AP names. An AP name is a case-sensitive string of 1 to 64 characters that can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Usage guidelines
This command does not identify whether the specified AP exists.
The priorities of AP grouping rules by AP names, serial IDs, MAC addresses, and IP addresses are in descending order. If an AP does not match any grouping rules, it is added to the default AP group.
If the created AP grouping rule already exists in another AP group, this command deletes the rule from that AP group.
You cannot execute this command in the view of the default AP group.
Examples
# Create an AP grouping rule by AP names to add APs ap1, ap2, and ap3 to AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] ap ap1 ap2 ap3
Related commands
wlan ap-group
ap-name
Use ap-name to add an AP to an AP monitor group.
Use undo ap-name to remove an AP from an AP monitor group.
Syntax
ap-name ap-name
undo ap-name ap-name
Default
No APs exist in an AP monitor group.
Views
Monitor group view
Predefined user roles
network-admin
mdc-admin
Parameters
ap-name: Specifies an AP by its name, a case-insensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Usage guidelines
APs in an AP monitor group can report client quantity, radio traffic, channel usage, and AP anomalies to the AC.
The functions and services provided by an AP are not affected after the AP is added to an AP monitor group.
You can add a maximum of 32 APs to an AP monitor group.
Examples
# Add AP ap1 to an AP monitor group.
<Sysname> system-view
[Sysname] wlan vip-ap-group
[Sysname-wlan-vip-ap-group] ap-name ap1
Related commands
report-interval
wlan vip-ap-group
ap-model
Use ap-model to create an AP model and enter its view, or enter the view of an existing AP model.
Use undo ap-model to remove an AP model and its configuration.
Syntax
ap-model ap-model
undo ap-model ap-model
Default
No AP models exist.
Views
AP group view
Predefined user roles
network-admin
Parameters
ap-model: Specifies an AP model name.
Examples
# Create an AP model named WA4320H and enter its view.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] ap-model WA4320H
[Sysname-wlan-ap-group-group1-ap-model-WA4320H]
control-address
Use control-address to specify the IP address to be carried in the CAPWAP Control IP Address message element.
Use undo control-address to restore the default.
Syntax
control-address { ip ipv4-address | ipv6 ipv6-address }
undo control-address { ip | ipv6 }
Default
In AP view, an AP uses the configuration in AP group view. If no configuration exists in AP group view, the AP uses the configuration in global configuration view.
In AP group view, an AP uses the configuration in global configuration view.
In global configuration view, the AC's IP address is inserted in the CAPWAP Control IP Address element.
Views
AP view
AP group view
Global configuration view
Predefined user roles
network-admin
Parameters
ip ipv4-address: Specifies an IPv4 address in the CAPWAP Control IPv4 Address message element.
ipv6 ipv6-address: Specifies an IPv6 address in the CAPWAP Control IPv6 Address message element.
Usage guidelines
This command takes effect only when the AC rediscovery feature is enabled.
You can specify a maximum of three IPv4 or IPv6 addresses in the CAPWAP Control IP Address message element.
The configuration in AP view takes precedence over the configuration in AP group view. The configuration in AP group view takes precedence over the configuration in global configuration view.
Examples
# Specify 192.168.1.1 as the IPv4 address to be carried in the CAPWAP Control IPv4 Address message element in AP view.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan-ap-ap1] control-address ip 192.168.1.1
# Specify 192.168.1.1 as the IPv4 address to be carried in the CAPWAP Control IPv4 Address message element in AP group view.
<Sysname> system-view
[Sysname] wlan ap-group 10
[Sysname-ap-group-10] control-address ip 192.168.1.1
# Specify 192.168.1.1 as the IPv4 address to be carried in the CAPWAP Control IPv4 Address message element in global configuration view.
<Sysname> system-view
[Sysname] wlan global-configuration
[Sysname-wlan-global-configuration] control-address ip 192.168.1.1
Related commands
control-address enable
control-address enable
Use control-address enable to enable the AC rediscovery feature.
Use control-address disable to disable the AC rediscovery feature.
Use undo control-address to restore the default.
Syntax
control-address { disable | enable }
undo control-address
Default
In AP view, an AP uses the configuration in AP group view. If no configuration exists in AP group view, the AP uses the configuration in global configuration view.
In AP group view, an AP uses the configuration in global configuration view.
In global configuration view, the AC rediscovery feature is disabled.
Views
AP view
AP group view
Global configuration view
Predefined user roles
network-admin
Usage guidelines
An AC enabled with AC rediscovery adds the CAPWAP Control IP Address message element to the discovery responses sent to APs. Upon receiving such a discovery response, an AP establishes a CAPWAP tunnel with the IP address representing the optimal AC in the CAPWAP Control IP Address message element.
An AC disabled with AC rediscovery does not add the CAPWAP Control IP Address message element in discovery responses sent to APs. APs that receive the discovery responses will send join requests to the source IP address of the discovery responses to establish CAPWAP tunnels with the AC.
The configuration in AP view takes precedence over the configuration in AP group view. The configuration in AP group view takes precedence over the configuration in global configuration view.
AC rediscovery applies to CMCC WLAN networks. According to the CMCC standard requirements, an AC must carry the CAPWAP Control IP Address message element in discovery responses.
Examples
# Enable the AC rediscovery feature in AP view.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan-ap-ap1] control-address enable
# Enable the AC rediscovery feature in AP group view.
<Sysname> system-view
[Sysname] wlan ap-group 10
[Sysname-ap-group-10] control-address enable
# Enable the AC rediscovery feature in global configuration view.
<Sysname> system-view
[Sysname] wlan global-configuration
[Sysname-wlan-global-configuration] control-address enable
Related commands
control-address
data-tunnel encryption
Use data-tunnel encryption enable to enable CAPWAP data tunnel encryption.
Use data-tunnel encryption disable to disable CAPWAP data tunnel encryption.
Use undo data-tunnel encryption to restore the default.
Syntax
data-tunnel encryption { disable | enable }
undo data-tunnel encryption
Default
In AP view, an AP uses the configuration in AP group view.
In AP group view, CAPWAP data tunnel encryption is disabled.
Views
AP view
AP group view
Predefined user roles
network-admin
Usage guidelines
When this feature is enabled, an AP exchanges encryption information including keys with the AC through the CAPWAP control tunnel upon receiving the first keepalive packet from the AC. After the exchange, the AC and the AP will encrypt data packets transmitted in a CAPWAP data tunnel. Keepalive packets are not encrypted.
This feature will cause an AP to reassociate with the AC.
The configuration in AP view takes precedence over the configuration in AP group view.
Examples
# Enable CAPWAP data tunnel encryption for AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan-ap-ap1] data-tunnel encryption enable
This operation will restart the AP. Continue? [Y/N]
# Enable CAPWAP data tunnel encryption for APs in AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] data-tunnel encryption enable
This operation will restart member APs that are not enabled with CAPWAP data tunnel encryption. Continue? [Y/N]
Related commands
tunnel encryption
delete file
Use delete file to delete a file from an AP.
Syntax
delete file filename
Views
AP view
Predefined user roles
network-admin
Parameters
filename: Specifies a file by its file name, a string of 1 to 255 characters.
Usage guidelines
This command takes effect only after an AP establishes a CAPWAP tunnel with the master AC.
Examples
# Delete file startup.cfg from AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan-ap-ap1] delete file startup.cfg
Do want to delete the flash:/startup.cfg file? [Y/N]
Related commands
display wlan ap files
download file
description (AP group view)
Use description to configure a description for an AP group.
Use undo description to restore the default.
Syntax
description text
undo description
Default
An AP group does not have a description.
Views
AP group view
Predefined user roles
network-admin
Parameters
text: Specifies a description, a case-sensitive string of 1 to 64 characters.
Usage guidelines
Configure a description for an AP group for easy identification and management purposes.
You can use the display wlan ap-group command to view the configured description.
Examples
# Configure a description for AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-ap-group-group1] description L3-office
Related commands
display wlan ap-group
wlan ap-group
description (AP view)
Use description to configure a description for an AP.
Use undo description to restore the default.
Syntax
description text
undo description
Default
An AP does not have a description.
Views
AP 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 AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-ap-ap1] description L3-office
discovery-response
Use discovery-response wait-time to set the discovery-response timeout timer.
Use undo discovery-response wait-time to restore the default.
Syntax
discovery-response wait-time seconds
undo discovery-response wait-time
Default
In AP view, an AP uses the configuration in AP group view.
In AP group view, the discovery-response timeout timer is 2 seconds.
Views
AP view
AP group view
Predefined user roles
network-admin
Parameters
seconds: Specifies the discovery-response timeout timer in the range of 2 to 20 seconds.
Usage guidelines
The discovery-response timeout timer specifies the timeout time for an AP to wait for another discovery response. Whenever an AP receives a discovery response packet, the discovery-response timeout timer is created or refreshed. When the timeout timer expires, the AP sends a join request to the optimal AC.
If the network condition is poor, set a larger discovery-response timeout timer.
The configuration in AP view takes precedence over the configuration in AP group view.
Examples
# Set the discovery-response timeout timer to 3 seconds for AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap3
[Sysname-wlan-ap-ap3] discovery-response wait-time 3
# Set the discovery-response timeout timer to 3 seconds for all APs in AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] discovery-response wait-time 3
display wlan ap
Use display wlan ap to display AP information.
Syntax
display wlan ap { all | name ap-name } [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
all: Specifies all APs.
name ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
verbose: Displays detailed information.
Examples
# Display information about all APs.
<Sysname> display wlan ap all
Total number of APs: 1
Total number of connected APs: 1
Total number of connected manual APs: 1
Total number of connected auto APs: 0
Total number of connected common APs: 1
Total number of connected WTUs: 0
Total number of inside APs: 0
Maximum supported APs: 2048
Remaining APs: 2047
Total AP licenses: 128
Local AP licenses: 128
Server AP licenses: 0
Remaining local AP licenses: 127
Sync AP licenses: 0
AP information
State : I = Idle, J = Join, JA = JoinAck, IL = ImageLoad
C = Config, DC = DataCheck, R = Run M = Master, B = Backup
AP name APID State Model Serial ID
ap1 1 I WA4320H 219801A0YG8165E00001
Table 1 Command output
Field |
Description |
Total number of connected common APs |
Total number of connected fit APs. |
Total number of inside APs |
This field is not supported in the current software version. Total number of connected inside APs. Inside APs are manual APs that are automatically created when anchor APs act as ACs. The name and the serial ID of an inside AP are the local MAC address and local serial ID, respectively. |
Maximum supported APs |
Maximum number of APs supported by the AC. |
Total AP licenses |
Total number of AP licenses. |
Local AP licenses |
Number of AP licenses installed on the AC. |
Server AP licenses |
This field is not supported in the current software version. Number of AP licenses requested from the license server. |
Remaining local AP licenses |
Number of unused AP licenses installed on the AC. |
Sync AP licenses |
This field is not supported in the current software version. Number of synchronized AP licenses. |
APID |
ID of the AP to uniquely identify the AP on the AC. |
State |
Current state of the AP: · I—Idle. · J—Join. · JA—Join acknowledge. · IL—The AP is downloading the image file. · C—The AP is downloading initial configurations. · DC—The AP is checking data. · R—The CAPWAP tunnel is operating. It indicates that the AP and the AC have established a CAPWAP tunnel. · R/M—The master CAPWAP tunnel is operating. It indicates that the AP and the master AC have established a CAPWAP tunnel. · R/B—The backup CAPWAP tunnel is operating. It indicates that the AP and the backup AC have established a CAPWAP tunnel. · M—The AP is connected to the master AC. · B—The AP is connected to the backup AC. · R/IL—The CAPWAP tunnel is operating and the AP is downloading the image file. |
Serial ID |
Serial ID of the AP. This field displays Not configured if the serial ID of the AP is not configured. |
# Display detailed information about AP ap1.
<Sysname> display wlan ap name ap1 verbose
AP name : ap1
AP ID : 1
AP group name : default-group
State : Run
Backup type : Master
Online time : 0 days 1 hours 25 minutes 12 seconds
System uptime : 0 days 2 hours 22 minutes 12 seconds
Model : WA4320H
Region code : CN
Region code lock : Disable
Serial ID : 219801A0YG8165E00001
MAC address : 0AFB-423B-893C
IP address : 192.168.1.50
UDP control port number : 18313
UDP data port number : N/A
H/W version : Ver.C
S/W version : E2321
Boot version : 1.01
USB state : N/A
Power level : N/A
Power info : N/A
Description : wtp1
Priority : 4
Echo interval : 10 seconds
Echo count : 3 counts
Keepalive interval : 10 seconds
Discovery-response wait-time : 2 seconds
Statistics report interval : 50 seconds
Fragment size (data) : 1500
Fragment size (control) : 1450
MAC type : Local MAC & Split MAC
Tunnel mode : Local Bridging & 802.3 Frame & Native Frame
CWPCAP data-tunnel status : Down
Discovery type : Static Configuration
Retransmission count : 3
Retransmission interval : 5 seconds
Firmware upgrade : Enabled
Sent control packets : 1
Received control packets : 1
Echo requests : 147
Lost echo responses : 0
Average echo delay : 3
Last reboot reason : User soft reboot
Last reboot reason (AP check) : The radio physical status was down
Last reboot reason (AC check) : The radio physical status was down
Latest IP address : 10.1.0.2
Current AC IP : 192.168.1.1
Tunnel down reason : Request wait timer expired
Connection count : 1
Backup IPv4 : Not configured
Backup IPv6 : Not configured
Data-tunnel encryption : Disabled
Data-tunnel encryption state : Not encrypted
LED mode : Normal
Remote configuration : Enabled
Radio 1:
Basic BSSID : 7848-59f6-3940
Admin state : Up
Radio type : 802.11ac
Antenna type : internal
Client dot11ac-only : Disabled
Client dot11n-only : Disabled
Channel band-width : 20/40/80MHz
Active band-width : 20/40/80MHz
Secondary channel offset : SCB
Short GI for 20MHz : Supported
Short GI for 40MHz : Supported
Short GI for 80MHz : Supported
Short GI for 160MHz : Not supported
mimo : Not Config
Green-Energy-Management : Disabled
A-MSDU : Enabled
A-MPDU : Enabled
LDPC : Not Supported
STBC : Supported
Operational VHT-MCS Set:
Mandatory : Not configured
Supported : NSS1 0,1,2,3,4,5,6,7,8,9
NSS2 0,1,2,3,4,5,6,7,8,9
Multicast : Not configured
Operational HT MCS Set:
Mandatory : Not configured
Supported : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9,
10, 11, 12, 13, 14, 15
Multicast : Not configured
Channel : 44(auto)
Channel usage(%) : 15
Max power : -102 dBm
Operational rate:
Mandatory : 6, 12, 24 Mbps
Multicast : Auto
Supported : 9, 18, 36, 48, 54 Mbps
Disabled : Not configured
Distance : 1 km
ANI : Enabled
Fragmentation threshold : 2346 bytes
Beacon interval : 100 TU
Protection threshold : 2346 bytes
Long retry threshold : 4
Short retry threshold : 7
Maximum rx duration : 2000 ms
Noise Floor : 5 dBm
Smart antenna : Enabled
Smart antenna policy : Auto
Protection mode : rts-cts
Continuous mode : N/A
HT protection mode : No protection
Radio 2:
Basic BSSID : 7848-59f6-3950
Admin state : Down
Radio type : 802.11b
Antenna type : internal
Client dot11n-only : Disabled
Channel band-width : 20MHz
Active band-width : 20MHz
Secondary channel offset : SCN
Short GI for 20MHz : Supported
Short GI for 40MHz : Supported
A-MSDU : Enabled
A-MPDU : Enabled
LDPC : Not Supported
STBC : Supported
Operational HT MCS Set:
Mandatory : Not configured
Supported : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9,
10, 11, 12, 13, 14, 15
Multicast : Not configured
Channel : 5(auto)
Channel usage(%) : 0
Max power : 20 dBm
Preamble type : Short
Operational rate:
Mandatory : 1, 2, 5.5, 11 Mbps
Multicast : Auto
Supported : 6, 9, 12, 18, 24, 36, 48, 54 Mbps
Disabled : Not configured
Distance : 1 km
ANI : Enabled
Fragmentation threshold : 2346 bytes
Beacon interval : 100 TU
Protection threshold : 2346 bytes
Long retry threshold : 4
Short retry threshold : 7
Maximum rx duration : 2000 ms
Noise Floor : 0 dBm
Smart antenna : Enabled
Smart antenna policy : Auto
Protection mode : rts-cts
Continuous mode : N/A
HT protection mode : No protection
Table 2 Command output
Field |
Description |
State |
Current state of the AP: · Idle—Idle. · Join—Join. · JoinAck—Join acknowledge. · Image—The AP is downloading the version. · Config—The AP is downloading initial configurations. · Data Check—The AP is checking data. · Run—The CAPWAP tunnel is operating. It indicates that the AP and the AC have established a CAPWAP tunnel. · R/M—The master CAPWAP tunnel is operating. It indicates that the AP and the master AC have established a CAPWAP tunnel. · R/B—The backup CAPWAP tunnel is operating. It indicates that the AP and the backup AC have established a CAPWAP tunnel. · M—The AP is connected to the master AC. · B—The AP is connected to the backup AC. |
Backup type |
CAPWAP tunnel type: · Idle—The AP has not established a CAPWAP tunnel with the AC. · Master—The CAPWAP tunnel established between the AP and the master AC. · Backup—The CAPWAP tunnel established between the AP and the backup AC. |
Region code lock |
· Enabled. · Disabled. |
Serial ID |
Serial ID of the AP. If no serial ID is configured, this field displays Not configured. |
MAC address |
MAC address of the AP. If no MAC address is configured, this field displays Not configured. |
UDP control port number |
Port number used by the AP to establish the CAPWAP control tunnel. |
UDP data port number |
Port number used by the AP to establish the CAPWAP data tunnel. |
H/W version |
Hardware version of the AP. |
S/W version |
Software version of the AP. |
USB state |
USB state: · Enabled. · Disabled. This field displays N/A if no USB state information is available. |
Power level |
Power level: · Low. · Middle. · High. This field displays N/A if the power level is unknown. Support for this field depends on the AP model. |
Power info |
Power supply information. · Power adapter—The AP uses local power supply. · PoE (port1+port2)—The AP uses PoE power supply. The port1 and port2 arguments represent the power supply status of PoE+ ports. ¡ N/A. ¡ 802.3af. ¡ 802.3at. Support for this field depends on the AP model. |
PoE status |
PoE power supply state for each PI: · Enabled. · Disabled. Support for this field depends on the AP model. |
Description |
Description for the AP. If no description is configured, this field displays Not configured. |
Priority |
AP connection priority for the AC. |
Echo interval |
Interval for an AP to send echo requests to the AC. |
Echo count |
Maximum number of echo request transmission attempts. |
Keepalive interval |
Interval for an AP to send keepalive packets through the CAPWAP data tunnel. |
Discovery-response wait-time |
Discovery-response timeout timer. |
Statistics report interval |
Interval for an AP to send statistics reports to the AC. |
Fragment size (data) |
Maximum fragment size for CAPWAP data packets. |
Fragment size (control) |
Maximum fragment size for CAPWAP control packets. |
MAC type |
MAC type of the AP-AC connection: · Local MAC—The AP encapsulates frames in 802.3 format before sending them to the AC. · Split MAC—The AP encapsulates frames in 802.11 format before sending them to the AC. · Local & Split MAC—The AP can encapsulate frames in either 802.3 format or 802.11 format before sending them to the AC. |
Tunnel mode |
Supported tunnel mode of the AP: · Local Bridging—The AP supports local bridging and does not forward data to the AC. · 802.3 Frame—The AP encapsulates the frames in 802.3 format to send them to the AC. · Native Frame—The AP encapsulates the frames in 802.11 format to send them to the AC. · Local Bridging & 802.3 Frame—The AP supports the Local Bridging mode and the 802.3 Frame mode. · 802.3 Frame & Native Frame—The AP supports the 802.3 Frame mode and the Native Frame mode. · Local Bridging & Native Frame—The AP supports the Local Bridging mode and the Native Frame mode. |
CWPCAP data-tunnel status |
Running status of the CAPWAP data tunnel: · Up. · Down. |
Discovery type |
Discovery type of the AP: · Static Configuration—The AP uses the manually configured IPv4 or IPv6 address of the AC. · DHCP—The AP gets the IP address of an AC through DHCP. · DNS—The AP gets the IP address of an AC through DNS. · Unknown. |
Retransmission count |
Number of retransmission attempts for an AC request. |
Retransmission interval |
Interval at which AC requests can be retransmitted. |
Firmware upgrade |
AP software upgrade: · Enabled. · Disabled. |
Sent control packets |
Number of sent packets, including Change State Event Response packets after the AC enters Run state. . |
Received control packets |
Number of received packets, including Change State Event Response packets after the AC enters Run state. |
Echo requests |
Number of echo requests sent by the AP in RUN state. |
Lost echo responses |
Number of echo responses not received by the AP in RUN state. |
Average echo delay |
Average echo delay in milliseconds. |
Last reboot reason |
Last reboot reason for the AP: · Power on. · Hard reboot. · Watchdog reboot. · Unknown reboot. · User soft reboot. · Kernel exception soft reboot. · Kernel deadloop soft reboot. · Auto update soft reboot. · Unknown soft reboot. · Memory exhausted. · Other unknown soft reboot. |
Last reboot reason(AP check) |
Reason for the most recent AP check failure that caused an AP reboot: · The radio state was incorrect. · The radio channel was incorrect. · The radio type was incorrect. · The radio bandwidth was incorrect. · The radio rate was incorrect. · The radio dependence was incorrect. · The radio physical status was down. |
Last reboot reason(AC check) |
Reason for the most recent AC check failure that caused an AP reboot: · The radio state was incorrect. · The radio channel was incorrect. · The radio type was incorrect. · The radio bandwidth was incorrect. · The radio rate was incorrect. · The radio dependence was incorrect. · The radio physical status was down. |
Latest IP address |
IP address that was most recently used by the AP. |
Current AC IP |
IP address of the AC that is associated with the AP. |
Tunnel down reason |
CAPWAP tunnel down reason: · Failed to create timer. · Neighbor dead timer expired. · Request wait timer expired. · Data check timer expired. · Failed to process data channel keep-alive message. · Failed to process request. · AP was reset. · AP was deleted. · Failed to come online. · Serial number changed. · MAC address changed. · Number of APs exceeded the limit. · Processed join request in Run state. · Failed to create AP context. · Received failure result code. · Failed to retransmit message. · Failed to download image file. · Image file downloaded successfully. · File operation timer expired. · Failed to add tunnel. · Received WTP tunnel down event from AP. · Backup AC closed the backup tunnel. · Master and backup tunnel switchover. · Failed to inherit configuration. · AP authentication failed. · Encryption status mismatch. This field displays N/A if the CAPWAP tunnel did not go down. |
Connection count |
Number of times that the AP connects to the AC. It is cleared in either one of the following cases: · The AC reboots. · The serial ID of the AP changes. The reset wlan ap command does not clear the connection count. |
Backup IPv4 |
IPv4 address of the backup AC. If no backup AC is specified, this field displays Not configured. |
Backup IPv6 |
IPv6 address of the backup AC. If no backup AC is specified, this field displays Not configured. |
Data-tunnel encryption |
CAPWAP data tunnel encryption: · Enabled. · Disabled. |
Data-tunnel encryption state |
CAPWAP data tunnel encryption state: · Encrypted. · Not encrypted. |
LED mode |
LED lighting mode: · quiet—All LEDs are off. · awake—All LEDs flash once every minute. · always-on—All LEDs are steady on. · normal—How LEDs flash in this mode varies by AP model. |
Remote configuration |
This field is not supported in the current software version. Remote configuration assignment: · Enabled. · Disabled. |
Basic BSSID |
MAC address of the radio. This field displays N/A if the AP has not established a CAPWAP tunnel with the AC. |
Admin state |
Radio state: · Up. · Down. |
Radio type |
Wireless mode: · 5 GHz: ¡ 802.11a. ¡ 802.11n(5GHz). ¡ 802.11ac. · 2.4 GHz: ¡ 802.11b. ¡ 802.11g. ¡ 802.11n(2.4GHz). |
Client dot11ac-only |
· Disabled—Allows 802.11a/b/g/n/ac clients to associate with the radio. · Enabled—Allows only 802.11ac clients to associate with the radio. |
Client dot11n-only |
· Disabled—Allows 802.11a/b/g/n/ac clients to associate with the radio. · Enabled—Allows only 802.11n or 802.11ac clients to associate with the radio. |
Channel band-width |
Channel bandwidth mode: · 20 MHz. · 20 or 40 MHz. · 20/40/80 MHz. · 20/40/80/160MHz. · 20/40/80/160/(80+80)MHz. |
Active band-width |
Bandwidth being used by the radio. |
Secondary channel offset |
Secondary channel information for the 802.11n and 802.11ac radio mode: · SCA (Second Channel Above)—The AP operates in 40 MHz bandwidth mode, and the secondary channel is above the primary channel. · SCB (Second Channel Below)—The AP operates in 40 MHz bandwidth mode, and the secondary channel is below the primary channel. · SCN—The AP does not operate in 40 MHz bandwidth mode. This field is available only when the bandwidth that the radio is using is 20/40/80MHz. |
Secondary channel center frequency |
Center frequency information about the 80 MHz bandwidth of the secondary channel when the radio operates in 802.11ac radio mode with a channel bandwidth of 160/(80+80)MHz. This field is available only when the bandwidth that the radio is using is 160/(80+80)MHz. |
Short GI for 20MHz |
Whether the radio supports short GI when it operates in 20 MHz mode. |
Short GI for 40MHz |
Whether the radio supports short GI when it operates in 40 MHz mode. |
Short GI for 80MHz |
Whether the radio supports short GI when it operates in 80 MHz mode. |
Short GI for 160MHz |
Whether the radio supports short GI when it operates in 160 MHz mode. |
mimo |
MIMO mode: · 1x1—The radio sends and receives signals through one spatial stream. · 2x2—The radio sends and receives signals through two spatial streams. · 3x3—The radio sends and receives signals through three spatial streams. · 4x4—The radio sends and receives signals through four spatial streams. · Not configured—The radio sends and receives signals through the maximum number of spatial streams supported by the radio. If this field also displays (PowerLow) after any value option to indicate low power level, the radio can send and receive signals only through one spatial stream. |
Green-Energy-Management |
Energy-saving: · Disabled. · Enabled. |
A-MSDU |
· Disabled. · Enabled. |
A-MPDU |
· Disabled. · Enabled. |
LDPC |
· Supported. · Not supported. |
STBC |
· Supported. · Not supported. |
Operational VHT MCS Set |
· Supported—Supported VHT MCS set. · Mandatory—Mandatory VHT MCS set. · Multicast—Multicast VHT MCS set. |
Operational HT MCS Set |
· Supported—Supported MCS set. · Mandatory—Mandatory MCS set. · Multicast—Multicast MCS set. |
Channel |
This field displays Number<auto> if the current channel is the optimal channel automatically selected by the AP. This field displays Number if the current channel is manually configured. This field displays Number<avoid radar> if the current channel is automatically selected by the AP to avoid radar signals. |
Max power |
Maximum transmission power of the radio. |
Preamble type |
Preamble type: · Short. · Long. |
Operational rate |
· Mandatory. · Supported. · Multicast. · Disabled. · Not configured. |
Distance |
Maximum distance that the radio signal can reach. |
ANI |
· Enabled. · Disabled. |
Protection threshold |
Frame length threshold required for triggering the protection mechanism. |
Long retry threshold |
Maximum number of retransmission attempts for frames whose length exceeds the RTS threshold. |
Short retry threshold |
Maximum number of retransmission attempts for frames whose length is below the RTS threshold. |
Maximum rx duration |
Maximum buffer duration for frames. |
Smart antenna |
· Enabled. · Disabled. This field is not supported in the current software version. |
Smart antenna policy |
· Auto. · High availability. · High throughput. This field is not supported in the current software version. |
Protection mode |
Conflict avoidance mode: · cts-to-self. · rts-cts. |
Continuous mode configuration: · Rate. · MCS index. · NSS index. · VHT-MCS index. This field displays N/A if the continuous mode is not configured. |
|
HT protection mode |
802.11n protection mode: · No protection. ¡ AP-associated clients and nearby wireless devices are operating in 802.11n mode and AP-associated clients are 802.11n clients with a bandwidth of 40 MHz. ¡ AP-associated clients are 802.11n clients with a bandwidth of 20 MHz. ·
Non-member protection. ·
20 MHz protection. ·
Non-HT mixed. |
MU-TxBF |
· Enabled. · Disabled. Support for this field depends on the AP model. |
SU-TxBF |
· Enabled. · Disabled. Support for this field depends on the AP model. |
display wlan ap address
Use display wlan ap address to display AP address information.
Syntax
display wlan ap { all | name ap-name } address
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
all: Specifies all APs.
name ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Examples
# Display address information for all APs.
<Sysname> display wlan ap all address
Total number of APs: 1
Total number of connected APs: 1
Total number of connected manual APs: 1
Total number of connected auto APs: 0
Total number of inside APs: 0
AP name IP address MAC address
ap1 1.1.1.5 000b-6b8f-fc6a
Table 3 Command output
Field |
Description |
Total number of APs |
Total number of fit APs. |
Total number of connected APs |
Total number of connected fit APs. |
Total number of connected manual APs |
Total number of connected manual fit APs. |
Total number of connected auto APs |
Total number of connected auto fit APs. |
Total number of inside APs |
This field is not supported in the current software version. Total number of connected inside APs. Inside APs are manual APs that are automatically created when anchor APs act as ACs. The name and the serial ID of an inside AP are the local MAC address and local serial ID, respectively. |
IP address |
IP address of an AP. This field displays N/A for an offline AP. |
MAC address |
MAC address of an AP. This field displays N/A for an offline AP. |
display wlan ap all feature capwap
Use display wlan ap all feature capwap to display configuration status of CAPWAP tunnel features.
Syntax
display wlan ap all feature capwap
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display configuration status of CAPWAP tunnel features.
<Sysname> display wlan ap all feature capwap
AP name Upgrade Encryption Control-address Switch-back
ap1 Disabled Both Enabled Disabled
Table 4 Command output
Field |
Description |
Upgrade |
AP software upgrade: · Enabled. · Disabled. |
Encryption |
CAPWAP tunnel encryption: · Control—Control tunnel encryption is enabled. · Data—Data tunnel encryption is enabled. · Both—Encryption is enabled for both control and data tunnels. · Disabled—Encryption is disabled for both control and data tunnels. |
Control-address |
AC rediscovery: · Enabled. · Disabled. |
Switch-back |
The CAPWAP tunnel switch-back feature for AC hierarchy: · Horizontal. · Vertical. · Disabled. · Both. |
display wlan ap connection-record
Use display wlan ap connection-record to display AP connection records on the AC.
Syntax
display wlan ap { all | name ap-name } connection-record
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
all: Specifies all APs.
name ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Examples
# Display all AP connection records on an AC.
<Sysname> display wlan ap tunnel-down-record
AP name APID Tunnel down at Tunnel down reason
9a48-45ed-0300 123 2017-07-07/15:56:25 Processed join request
in Run state
Table 5 Command output
Field |
Description |
State |
Current state of the AP: · Discovery—AC discovery. · Join—The CAPWAP tunnel is being established. · Offline—Offline. · Run—The CAPWAP tunnel is operating. It indicates that the AP and the AC have established a CAPWAP tunnel successfully. |
Time |
Most recent time when the AP established a CAPWAP tunnel with the AC. |
display wlan ap files
Use display wlan ap files to display information about files and file folders on an AP.
Syntax
display wlan ap name ap-name files
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
name ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Examples
# Display information about files and file folders on AP ap1.
<Sysname> display wlan ap name ap1 files
Directory of flash:
0 13638656 wa4300-system.bin
1 2573312 wa4300-boot.bin
131072 KB total (114208 KB free)
Table 6 Command output
Field |
Description |
0 13638656 xx.xx |
File or file folder information: · 0—Serial number, which is automatically assigned by the system. · 13638656— File size in bytes. A hyphen (-) is displayed if it is a file folder. · xx.xx—Name of the file or file folder. |
Related commands
delete file
download file
display wlan ap gps
Use display wlan ap gps to display Global Positioning System (GPS) information for the specified APs.
Syntax
display wlan ap { all | name ap-name } gps
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
all: Specifies all APs.
name ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Usage guidelines
This command takes effect only on APs that support the GPS module.
Examples
# Display GPS information for AP ap1.
<Sysname> display wlan ap name ap1 gps
AP name : ap1
Serial ID : 219801A17C817200001
Model : WA5630X
Longitude : 117.788887
Latitude : 30.822136
Velocity : 25.445878
Orientation: 8.054548
Elevation : 156.655897
Obtained at: 2017-02-20 15:32:19
Table 7 Command output
Description |
|
Name of the AP. |
|
Serial ID of the AP. |
|
AP model. |
|
Longitude rounded to six decimal places. |
|
Latitude |
Latitude rounded to six decimal places. |
Velocity |
Horizontal velocity rounded to six decimal places. |
Orientation |
Orientation rounded to six decimal places. |
Elevation |
Elevation rounded to six decimal places. |
Obtained at |
Time when the GPS information was obtained. |
display wlan ap group
Use display wlan ap group to display AP groups to which the specified APs belong.
Syntax
display wlan ap { all | name ap-name } group
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
all: Specifies all APs.
name ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Examples
# Display AP groups for all APs.
<Sysname> display wlan ap all group
Total number of APs: 1
Total number of connected APs: 1
Total number of connected manual APs: 1
Total number of connected auto APs: 0
Total number of connected common APs: 1
Total number of connected WTUs: 0
Total number of inside APs: 0
Maximum supported APs: 2048
Remaining APs: 2047
Total AP licenses: 128
Local AP licenses: 128
Server AP licenses: 0
Remaining local AP licenses: 127
Sync AP licenses: 0
AP information
State: I = Idle, J= Join, JA= JoinAck, IL= ImageLoad
C= Config, DC= DataCheck, R= Run M= Master, B= Backup
AP name APID State Model AP group name
ap1 1 R WA4320H default-group
Table 8 Command output
Field |
Description |
Total number of APs |
Total number of fit APs. |
Total number of connected APs |
Total number of connected fit APs. |
Total number of connected manual APs |
Total number of connected manual fit APs. |
Total number of connected auto APs |
Total number of connected auto fit APs. |
Total number of connected common APs |
Total number of connected fit APs. |
Total number of inside APs |
This field is not supported in the current software version. Total number of connected inside APs. Inside APs are manual APs that are automatically created when anchor APs act as ACs. The name and the serial ID of an inside AP are the local MAC address and local serial ID, respectively. |
Maximum supported APs |
Maximum number of fit APs supported by the AC. |
Total AP licenses |
Total number of AP licenses. |
local AP licenses |
Number of AP licenses installed on the AC. |
Server AP licenses |
This field is not supported in the current software version. Number of AP licenses requested from the license server. |
Remaining local AP licenses |
Number of unused AP licenses installed on the AC. |
Sync AP licenses |
This field is not supported in the current software version. Number of synchronized AP licenses. |
APID |
ID of the AP to uniquely identify the AP on the AC. |
State |
Current state of the AP: · I—Idle. · J—Join. · JA—Join acknowledge. · IL—The AP is downloading the version. · C—The AP is downloading initial configurations. · DC—The AP is checking data. · R—The CAPWAP tunnel is operating. It indicates that the AP and the AC have established a CAPWAP tunnel. · R/M—The master CAPWAP tunnel is operating. It indicates that the AP and the master AC have established a CAPWAP tunnel. · R/B—The backup CAPWAP tunnel is operating. It indicates that the AP and the backup AC have established a CAPWAP tunnel. · M—The AP is connected to the master AC. · B—The AP is connected to the backup AC. |
Model |
AP model |
AP group name |
Name of the AP group to which the AP belongs. |
display wlan ap online-time
Use display wlan ap online-time to display the online duration for APs.
Syntax
display wlan ap { all | name ap-name } online-time
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
all: Specifies all APs.
name ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Examples
# Display online duration for all APs.
<Sysname> display wlan ap all online-time
AP name IP address Time
ap1 1.1.1.2 0 days 0 hours 2 minutes 6 seconds
ap2 1.1.1.1 0 days 0 hours 5 minutes 6 seconds
ap3 1.1.1.6 0 days 0 hours 2 minutes 1 seconds
Table 9 Command output
Field |
Description |
IP address |
IP address of an AP. |
Time |
Realtime association duration of an AP since the AP came online. |
display wlan ap reboot-log
Use display wlan ap reboot-log to display reboot logs for an AP.
Syntax
display wlan ap name ap-name reboot-log
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
name ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Usage guidelines
If the AP has suffered a system crash, you can use this command to view detailed information about the crash.
To use this command, make sure the specified AP is in Run state.
Examples
# Display reboot logs for AP ap1.
<Sysname> display wlan ap name ap1 reboot-log
Debugging information is not available on the AC.
Downloading debugging data from AP. Continue? [Y/N]:y
Downloading debugging data. Please wait...
Please enter the same command again to view the log messages.
<Sysname>dis wlan ap name ap1 reboot-log
--------------------- Reboot record 1 ---------------------
Recorded at : 2018-07-20 03:29:43.324529
Occurred at : 2018-07-20 03:29:43.324529
Reason : 0x8
Thread : devd (TID: 50)
Context : thread context
Cpu : 0
Kernel module info : module name (system) module address (0xd145a000)
module name (addon) module address (0xd00d5000)
Last 5 thread switches : WDRVFwdKthread (3:29:43.323999)-->
swapper (3:29:43.324011)-->
WDRVFwdKthread (3:29:43.324467)-->
swapper (3:29:43.324478)-->
devd (3:29:43.324502)-->
…
Related commands
reset wlan ap reboot-log
display wlan ap running-configuration
Use display wlan ap running-configuration to display running configuration for the specified AP or all APs.
Syntax
display wlan ap { all | name ap-name } running-configuration [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
all: Specifies all APs.
name ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
verbose: Displays detailed running configuration.
Examples
# Display detailed running configuration for all APs.
<Sysname> display wlan ap all running-configuration verbose
(i) -- Inherited from AP group
(g) -- Inherited from AP global-configuration
#
wlan ap ap1 model WA4320H id 5
ap group name 1
serial-id 219801A0YG8165E00001
region code 156
echo interval 10 (i)
retransmission count 3 (i)
retransmission interval 5 (i)
statistics interval 50 (i)
fragment-size data 1500 (i)
fragment-size control 1450 (i)
tunnel-preempt disable (g)
firmware-upgrade disable (g)
priority 4 (i)
…
radio 1
radio type 802.11ac (i)
radio disable (i)
channel auto<64> (i)
channel unlock (i)
fragment-threshold 2346 (i)
max-power 20 (i)
power unlock (i)
distance 1 kilometer (i)
ANI Enabled (i)
…
radio 2
radio type 802.11n(2.4GHz) (i)
radio disable (i)
channel auto<11> (i)
channel unlock (i)
fragment-threshold 2346 (i)
max-power 20 (i)
power unlock (i)
distance 1 kilometer (i)
ANI Enabled (i)
…
#
wlan ap ap2 model WA4320H id 6
ap group name 2
serial-id 219801A0YG8165E00002
region code 156
echo interval 10 (i)
retransmission count 3 (i)
retransmission interval 5 (i)
statistics interval 50 (i)
fragment-size data 1500 (i)
fragment-size control 1450 (i)
tunnel-preempt disable (g)
firmware-upgrade disable (g)
priority 4 (i)
…
radio 1
radio type 802.11ac (i)
radio disable (i)
channel auto<60> (i)
channel unlock (i)
fragment-threshold 2346 (i)
max-power 20 (i)
power unlock (i)
distance 1 kilometer (i)
ANI Enabled (i)
…
radio 2
radio type 802.11n(2.4GHz) (i)
radio disable (i)
channel auto<13> (i)
channel unlock (i)
fragment-threshold 2346 (i)
max-power 20 (i)
power unlock (i)
distance 1 kilometer (i)
ANI Enabled (i)
…
display wlan ap statistics association-failure-record
Use display wlan ap statistics association-failure-record to display association failure records for APs.
Syntax
display wlan ap statistics association-failure-record
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display association failure records for APs.
<Sysname> display wlan ap statistics association-failure-record
MAC address AP ID Last failed at Reason
9a48-45ed-0300 12312 07-07/15:56:25 AP authentication failed
Table 10 Command output
Field |
Description |
MAC address |
MAC address of an AP. |
AP ID |
ID of an AP, which uniquely identifies the AP on the AC. |
Last failed at |
Last time an AP associated with the AC. The format is date/hh:mm:ss. |
Reason |
Association failure reason: · Failed to create data check timer. · Memory is not enough. · The AP model doesn't exist. · Lack of AP license. · MAC address conflict. · Failed to add APLB. · AP chose another AC. · Reached AC max capability. · Received join request in Run state. · APLB check failed. · Rejected AP access in HA smooth. · AP authentication failed. · Failed to create auto AP. · The AP information has already existed. · Failed to download AP image file. · Timer for waiting change state event request expired. · Time for waiting image data request or configuration request expired. · Received failure result code in change state event request. · Failed to add tunnel. · AP configuration was not found. · Inconsistent AP IDs. · Failed to send query message. · Open image file timer expired. |
display wlan ap statistics online-record
Use display wlan ap statistics online-record to display online AP quantity records.
Syntax
display wlan ap statistics online-record [ time date time [ count count ] ] [ count count ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
timedate time: Specifies the start time to display online AP quantity records. The date argument represents the date in the YYYY/MM/DD format. The value range for YYYY is 2000 to 2035. The value range for MM is 1 to 12. The value range for DD varies by month. The time argument represents the time in the hh:mm format. The value range for hh is 0 to 23. The value range for mm is 0 to 59. If you do not specify this option, the command displays all statistics about online AP quantity over the past 7 days in descending order of time.
count count: Specifies the number of online AP quantity records to be displayed, in the range of 1 to 256. If you do not specify this option, 10 online AP quantity records are displayed.
Usage guidelines
The online AP quantity records are displayed one by one at intervals of 1 minute. This command supports displaying records generated only over the past 7 days. If a time is specified, this command displays the specified number of online AP quantity records generated after the specified time point.
Examples
# Display 11 online AP quantity records generated after 2017/10/11 10:16.
<Sysname> display wlan ap statistics online-record time 2017/10/11 10:16 count 11
Time Manual APs Auto APs Total Total delta
2017-10-11 10:16:00 20 10 30 -2
2017-10-11 10:17:00 22 10 32 +6
2017-10-11 10:18:00 16 10 26 0
2017-10-11 10:19:00 16 10 26 0
2017-10-11 10:20:00 16 10 26 0
2017-10-11 10:21:00 16 10 26 0
2017-10-11 10:22:00 16 10 26 0
2017-10-11 10:23:00 16 10 26 0
2017-10-11 10:24:00 16 10 26 0
2017-10-11 10:25:00 16 10 26 0
2017-10-11 10:26:00 16 10 26 0
Table 11 Command output
Field |
Description |
Time |
Date and time when the record was generated. |
Manual APs |
Number of online manual APs. |
Auto APs |
Number of online auto APs. |
Total |
Total number of online APs. |
Total delta |
Quantity change in comparison with the last minute. |
display wlan ap statistics tunnel-down-record
Use display wlan ap statistics tunnel-down-record to display CAPWAP tunnel down records.
Syntax
display wlan ap statistics tunnel-down-record
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display CAPWAP tunnel down records.
<Sysname> display wlan ap statistics tunnel-down-record
AP name AP ID Tunnel down at Tunnel down reason
9a48-45ed-0300 123 07-07/15:56:25 Processed join request
in Run state
Table 12 Command output
Field |
Description |
AP name |
Name of an AP. |
AP ID |
ID of an AP, which uniquely identifies the AP on the AC. |
Tunnel down at |
Time when the CAPWAP tunnel between an AP and the AC went down. The format is date/hh:mm:ss. |
Tunnel down reason |
CAPWAP tunnel down reason: · Failed to create data check timer. · Neighbor dead timer expired. · Request wait timer expired. · Data check timer expired. · Failed to process data channel keep-alive message. · Failed to process request. · AP was reset by admin · AP was reset by Web. · Manual AP was deleted. · Failed to come online. · Serial ID changed. · MAC address changed. · Exceeded AC max capability. · Processed join request in Run state. · Unauthenticated AP tunnel down. · Failed to create AP context. · Received failure result code in change state event request. · Failed to retransmit message. · Failed to download image file. · Image file downloaded successfully. · File operation timer expired. · Failed to add tunnel. · Received WTP tunnel down event from AP. · Backup AC closed the backup tunnel. · Master and backup tunnel switchover. · Failed to inherit configuration. · AP authentication failed. · Backup AP upgrade failed. · Board is inactive. · Lack of AP license. · Encryption status mismatch. |
display wlan ap tunnel latency
Use display wlan ap tunnel latency to display tunnel latency information for an AP.
Syntax
display wlan ap name ap-name tunnel latency
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
name ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Usage guidelines
Make sure CAPWAP tunnel latency detection is enabled before you execute this command.
Examples
# Display tunnel latency information for AP ap1.
<Sysname> display wlan ap name ap1 tunnel latency
AP name : ap1
Tunnel Latency : Enabled
Control Link Delay:
Current Delay : 1ms
Maximum Delay : 1ms
Minimum Delay : 1ms
Data Link Delay:
Current Delay : 1ms
Maximum Delay : 1ms
Minimum Delay : 1ms
Table 13 Command output
Field |
Description |
Tunnel Latency |
· Disabled. · Enabled. |
Current Delay |
The most recent delay. |
Related commands
reset wlan tunnel latency ap
tunnel latency-detect
display wlan ap unauthenticated
Use display wlan ap unauthenticated to display information about unauthenticated auto APs.
Syntax
display wlan ap unauthenticated [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
verbose: Displays detailed information about unauthenticated auto APs. If you do not specify this keyword, this command displays brief information about unauthenticated auto APs.
Examples
# Display brief information about unauthenticated auto APs.
<Sysname> display wlan ap unauthenticated
Total number of APs: 1
Total number of connected APs: 1
Total number of connected manual APs: 0
Total number of connected auto APs: 1
Total number of inside APs: 0
Maximum supported APs: 3072
Remaining APs: 3071
Fit APs activated by license: 128
Remaining fit APs: 127
WTUs activated by license: 0
Remaining WTUs: 0
AP information
State : I = Idle, J = Join, JA = JoinAck, IL = ImageLoad
C = Config, DC = DataCheck, R = Run, M = Master, B = Backup
AP name APID State Model Serial ID
6649-99be-0300 6 R/M WA4320H 219801A0CNC138011454
Table 14 Command output
Field |
Description |
Total number of APs |
Total number of fit APs, WTs, and WTUs. |
Total number of connected APs |
Total number of connected fit APs, WTs, and WTUs. |
Total number of connected manual APs |
Total number of connected manual fit APs, WTs, and WTUs. |
Total number of connected auto APs |
Total number of connected auto fit APs, WTs, and WTUs. |
Total number of inside APs |
Total number of inside APs. Inside APs are manual APs that are automatically created when anchor APs act as ACs. The name and the serial ID of an inside AP are the local MAC address and local serial ID, respectively. |
Maximum supported APs |
Maximum number of APs supported by the AC, including fit APs and WTUs. |
APID |
ID of the AP to uniquely identify the AP on the AC. |
State |
Current state of the AP: · I—Idle. · J—Join. · JA—Join acknowledge. · IL—The AP is downloading the software image version. · C—The AP is downloading initial configurations. · DC—The AP is checking data. · R—The CAPWAP tunnel is operating. It indicates that the AP and the AC have established a CAPWAP tunnel. · R/M—The master CAPWAP tunnel is operating. It indicates that the AP and the master AC have established a CAPWAP tunnel. · R/B—The backup CAPWAP tunnel is operating. It indicates that the AP and the backup AC have established a CAPWAP tunnel. · M—The AP is connected to the master AC. · B—The AP is connected to the backup AC. |
Serial ID |
Serial ID of the AP. This field displays Not configured if the serial ID of the AP is not configured. |
# Display detailed information about unauthenticated auto APs.
<Sysname> display wlan ap unauthenticated verbose
Total number of APs: 1
Total number of connected APs: 0
Total number of connected manual APs: 0
Total number of connected auto APs: 1
Total number of inside APs: 0
Maximum supported APs: 3072
Remaining APs: 3071
Fit APs activated by license: 128
Remaining fit APs: 127
WTUs activated by license: 0
Remaining WTUs: 0
AP name : ap1
AP ID : 1
AP group name : default-group
State : Run
Backup Type : Master
Online time : 0 days 1 hours 25 minutes 12 seconds
System up time : 0 days 2 hours 22 minutes 12 seconds
Model : WA4320H
Region code : CN
Region code lock : Disable
Serial ID : 219801A0CNC138011454
MAC address : 0AFB-423B-893C
IP address : 192.168.1.50
UDP port number : 65488
H/W version : Ver.C
S/W version : V700R001B49D001
Boot version : 1.01
Description : wtp1
Priority : 4
Echo interval : 10 seconds
Statistics report interval : 50 seconds
Fragment-size data : 1500
Fragment-size control : 1450
MAC type : Local MAC & Split MAC
Tunnel mode : Local Bridging & 802.3 Frame & Native Frame
Discovery type : Static Configuration
Retransmission count : 3
Retransmission interval : 5 seconds
Firmware upgrade : Enabled
Sent control packets : 1
Received control packets : 1
Echo requests : 147
Lost echo responses : 0
Average echo delay : 3
Last reboot reason : User soft reboot
Latest IP address : 10.1.0.2
Tunnel down reason : Request wait timer expired
Connection count : 1
Backup IPv4 : Not configured
Backup IPv6 : Not configured
Tunnel encryption : Disabled
Data-tunnel encryption : Disabled
LED mode : Normal
Remote configuration : Enabled
Radio 1:
Basic BSSID : 7848-59f6-3940
Admin state : Up
Radio type : 802.11ac
Antenna type : internal
Client dot11ac-only : Disabled
Client dot11n-only : Disabled
Channel band-width : 20/40/80MHz
Secondary channel offset : SCB
Short GI for 20MHz : Supported
Short GI for 40MHz : Supported
Short GI for 80MHz : Supported
Short GI for 160MHz : Not supported
A-MSDU : Enabled
A-MPDU : Enabled
LDPC : Not Supported
STBC : Supported
Operational VHT-MCS Set:
Mandatory : Not configured
Supported : NSS1 0,1,2,3,4,5,6,7,8,9
NSS2 0,1,2,3,4,5,6,7,8,9
Multicast : Not configured
Operational HT MCS Set:
Mandatory : Not configured
Supported : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9,
10, 11, 12, 13, 14, 15
Multicast : Not configured
Channel : 44(auto)
Max power : 20 dBm
Operational rate:
Mandatory : 6, 12, 24 Mbps
Multicast : Auto
Supported : 9, 18, 36, 48, 54 Mbps
Disabled : Not configured
Distance : 1 km
ANI : Enabled
Fragmentation threshold : 2346 bytes
Beacon interval : 100 TU
Protection threshold : 2346 bytes
Long retry threshold : 4
Short retry threshold : 7
Maximum rx duration : 2000 ms
Noise Floor : 5 dBm
Smart antenna : Enabled
Smart antenna policy : Auto
Protection mode : cts-to-self
Continuous-mode : N/A
Radio 2:
Basic BSSID : 7848-59f6-3950
Admin state : Down
Radio type : 802.11b
Antenna type : internal
Client dot11n-only : Disabled
Channel band-width : 20MHz
Secondary channel offset : SCN
Short GI for 20MHz : Supported
Short GI for 40MHz : Supported
A-MSDU : Enabled
A-MPDU : Enabled
LDPC : Not Supported
STBC : Supported
Operational HT MCS Set:
Mandatory : Not configured
Supported : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9,
10, 11, 12, 13, 14, 15
Multicast : Not configured
Channel : 5(auto)
Max power : 20 dBm
Preamble type : Short
Operational rate:
Mandatory : 1, 2, 5.5, 11 Mbps
Multicast : Auto
Supported : 6, 9, 12, 18, 24, 36, 48, 54 Mbps
Disabled : Not configured
Distance : 1 km
ANI : Enabled
Fragmentation threshold : 2346 bytes
Beacon interval : 100 TU
Protection threshold : 2346 bytes
Long retry threshold : 4
Short retry threshold : 7
Maximum rx duration : 2000 ms
Noise Floor : 5 dBm
Smart antenna : Enabled
Smart antenna policy : Auto
Protection mode : cts-to-self
Continuous-mode : N/A
Table 15 Command output
Field |
Description |
Total number of APs |
Total number of fit APs, WTs, and WTUs. |
Total number of connected APs |
Total number of connected fit APs, WTs, and WTUs. |
Total number of connected manual APs |
Total number of connected manual fit APs, WTs, and WTUs. |
Total number of connected auto APs |
Total number of connected auto fit APs, WTs, and WTUs. |
Total number of inside APs |
Total number of inside APs. Inside APs are manual APs that are automatically created when anchor APs act as ACs. The name and the serial ID of an inside AP are the local MAC address and local serial ID, respectively. |
Maximum supported APs |
Maximum number of APs supported by the AC, including fit APs and WTUs. |
AP ID |
ID of the AP to uniquely identify the AP on the AC. |
State |
Current state of the AP: · Idle—Idle. · Join—Join. · JoinAck—Join acknowledge. · Image—The AP is downloading the software version. · Config—The AP is downloading initial configurations. · Data Check—The AP is checking data. · Run—The CAPWAP tunnel is operating. It indicates that the AP and the AC have established a CAPWAP tunnel. · R/M—The master CAPWAP tunnel is operating. It indicates that the AP and the master AC have established a CAPWAP tunnel. · R/B—The backup CAPWAP tunnel is operating. It indicates that the AP and the backup AC have established a CAPWAP tunnel. · M—The AP is connected to the master AC. · B—The AP is connected to the backup AC. |
Backup Type |
CAPWAP tunnel type: · Idle—The AP has not established a CAPWAP tunnel with the AC. · Master—The CAPWAP tunnel established between the AP and the master AC. · Backup—The CAPWAP tunnel established between the AP and the backup AC. |
Region code lock |
· Enabled. · Disabled. |
Serial ID |
Serial ID of the AP. If no serial ID is configured, this field displays Not configured. |
MAC address |
MAC address of the AP. If no MAC address is configured, this field displays Not configured. |
UDP port number |
Port number used by the AP to establish the CAPWAP control tunnel. |
H/W version |
Hardware version of the AP. |
S/W version |
Software version of the AP. |
Description |
Description for the AP. If no description is configured, this field displays Not configured. |
Priority |
AP connection priority for the AC. |
Echo interval |
Interval for the AP to send echo requests to the AC. |
Statistics report interval |
Statistics report interval for the AP to send statistics reports to the AC |
Fragment-size data |
Maximum fragment size for CAPWAP data packets. |
Fragment-size control |
Maximum fragment size for CAPWAP control packets. |
MAC type |
MAC type of the AP-AC connection: · Local MAC—The AP encapsulates frames in 802.3 format before sending them to the AC. · Split MAC—The AP encapsulates frames in 802.11 format before sending them to the AC. · Local & Split MAC—The AP can encapsulate frames in either 802.3 format or 802.11 format before sending them to the AC. |
Tunnel mode |
Supported tunnel mode of the AP: · Local Bridging—The AP supports local bridging and does not forward data to the AC. · 802.3 Frame—The AP encapsulates the frames in 802.3 format to send them to the AC. · Native Frame—The AP encapsulates the frames in 802.11 format to send them to the AC. · Local Bridging & 802.3 Frame—The AP supports the Local Bridging mode and the 802.3 Frame mode. · 802.3 Frame & Native Frame—The AP supports the 802.3 Frame mode and the Native Frame mode. · Local Bridging & Native Frame—The AP supports the Local Bridging mode and the Native Frame mode. |
Discovery type |
Discovery type of the AP: · Static Configuration—The AP uses the manually configured IPv4 or IPv6 address of the AC. · DHCP—The AP gets the IP address of an AC through DHCP. · DNS—The AP gets the IP address of an AC through DNS. · Unknown. |
Retransmission count |
Number of retransmission attempts for an AC request. |
Retransmission interval |
Interval at which AC requests can be retransmitted. |
Firmware upgrade |
AP software upgrade: · Enabled. · Disabled. |
Sent control packets |
Number of sent packets, including Change State Event Response packets after the AC enters Run state. . |
Received control packets |
Number of received packets, including Change State Event Response packets after the AC enters Run state. |
Echo requests |
Number of echo requests sent by the AP in RUN state. |
Lost echo responses |
Number of echo responses not received by the AP in RUN state. |
Average echo delay |
Average echo delay in milliseconds. |
Last reboot reason |
Last reboot reason for the AP: · Power on. · Hard reboot. · Watchdog reboot. · Unknown reboot. · User soft reboot. · Kernel exception soft reboot. · Kernel deadloop soft reboot. · Auto update soft reboot. · Unknown soft reboot. · Memory exhausted. · Other unknown soft reboot. |
Latest IP address |
IP address that was most recently used by the AP. |
Tunnel down reason |
CAPWAP tunnel down reason: · Failed to create timer. · Neighbor dead timer expired. · Request wait timer expired. · Data check timer expired. · Failed to process data channel keep-alive message. · Failed to process request. · AP was reset. · AP was deleted. · Failed to come online. · Serial number changed. · MAC address changed. · Number of APs exceeded the limit. · Processed join request in Run state. · Failed to create AP context. · Received failure result code. · Failed to retransmit message. · Failed to download image file. · Image file downloaded successfully. · File operation timer expired. · Failed to add tunnel. · Received WTP tunnel down event from AP. · Backup AC closed the backup tunnel. · Master and backup tunnel switchover. · Failed to inherit configuration. · AP authentication failed. This field displays N/A if the CAPWAP tunnel did not go down. |
Connection count |
Number of times that the AP connects to the AC. It is cleared in either one of the following cases: · The AC reboots. · The serial ID of the AP changes. The reset wlan ap command does not clear the connection count. |
Backup IPv4 |
IPv4 address of the backup AC. If no backup AC is specified, this field displays Not configured. |
Backup IPv6 |
IPv6 address of the backup AC. If no backup AC is specified, this field displays Not configured. |
Tunnel encryption |
CAPWAP control tunnel encryption: · Enabled. · Disabled. |
Data-tunnel encryption |
CAPWAP data tunnel encryption: · Enabled. · Disabled. |
LED mode |
LED lighting mode: · Quiet—All LEDs are off. · Awake—All LEDs flash once every minute. · Always-on—All LEDs are steady on. · Normal—How LEDs flash in this mode varies by AP model. |
Remote configuration |
Remote configuration assignment: · Enabled. · Disabled. |
Basic BSSID |
MAC address of the radio. This field displays N/A if the AP has not established a CAPWAP tunnel with the AC. |
Admin state |
Radio state: · Up. · Down. |
Radio type |
Wireless mode: · 5 GHz: ¡ 802.11a. ¡ 802.11n(5GHz). ¡ 802.11ac. · 2.4 GHz: ¡ 802.11b. ¡ 802.11g. ¡ 802.11n(2.4GHz). |
Client dot11ac-only |
· Disabled—Allows 802.11a/b/g/n/ac clients to associate with the radio. · Enabled—Allows only 802.11ac clients to associate with the radio. |
Client dot11n-only |
· Disabled—Allows 802.11a/b/g/n/ac clients to associate with the radio. · Enabled—Allows only 802.11n or 802.11ac clients to associate with the radio. |
Channel band-width |
Channel bandwidth: · 20 MHz. · 20 or 40 MHz. · 20/40/80 MHz. |
Secondary channel offset |
Secondary channel information for the 802.11n and 802.11ac radio mode: · SCA (Second Channel Above)—The AP operates in 40 MHz bandwidth mode, and the secondary channel is above the primary channel. · SCB (Second Channel Below)—The AP operates in 40 MHz bandwidth mode, and the secondary channel is below the primary channel. · SCN—The AP does not operate in 40 MHz bandwidth mode. |
Short GI for 20MHz |
Whether the radio supports short GI when it operates in 20 MHz mode. |
Short GI for 40MHz |
Whether the radio supports short GI when it operates in 40 MHz mode. |
Short GI for 80MHz |
Whether the radio supports short GI when it operates in 80 MHz mode. |
Short GI for 160MHz |
Whether the radio supports short GI when it operates in 160 MHz mode. |
A-MSDU |
· Disabled. · Enabled. |
A-MPDU |
· Disabled. · Enabled. |
LDPC |
· Supported. · Not supported. |
STBC |
· Supported. · Not supported. |
Operational VHT MCS Set |
· Supported—Supported VHT MCS set. · Mandatory—Mandatory VHT MCS set. · Multicast—Multicast VHT MCS set. |
Operational HT MCS Set |
· Supported—Supported MCS set. · Mandatory—Mandatory MCS set. · Multicast—Multicast MCS set. |
Channel |
This field displays Number<auto> if the current channel is the optimal channel automatically selected by the AP. This field displays Number if the current channel is manually configured. This field displays Number<avoid radar> if the current channel is automatically selected by the AP to avoid radar signals. |
Max power |
Maximum transmission power of the radio. |
Preamble type |
Preamble type: · Short. · Long. |
Operational rate |
· Mandatory. · Supported. · Multicast. · Disabled. · Not configured. |
Distance |
Maximum distance that the radio signal can reach. |
ANI |
· Enabled. · Disabled. |
Protection threshold |
Frame length threshold required for triggering the protection mechanism. |
Long retry threshold |
Maximum number of retransmission attempts for frames whose length exceeds the RTS threshold. |
Short retry threshold |
Maximum number of retransmission attempts for frames whose length is below the RTS threshold. |
Maximum rx duration |
Maximum buffer duration for frames. |
Smart antenna |
· Enabled. · Disabled. Support for this field depends on the AP model. |
Smart antenna policy |
· Auto. · High availability. · High throughput. Support for this field depends on the AP model. |
Protection mode |
Conflict avoidance mode: · cts-to-self. · rts-cts. |
Continuous mode |
Continuous mode configuration: · Rate. · MCS index. · NSS index. · VHT-MCS index. This field displays N/A if the continuous mode is not configured. |
display wlan ap-distribution
Use display wlan ap-distribution to display AP distribution information.
Syntax
display wlan ap-distribution all
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display distribution information for all APs.
<Sysname> display wlan ap-distribution all
Slot : 1
Total number of APs: 1
AP name : 722a-d561-0301
display wlan ap-distribution ap-name
Use display wlan ap-distribution ap-name to display the attachment location of an AP.
Syntax
display wlan ap-distribution ap-name ap-name
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Examples
# Display the attachment location of AP ap1.
<Sysname> display wlan ap-distribution ap-name ap1
The AP is attached to slot 0.
display wlan ap-group
Use display wlan ap-group to display information about all AP groups or the specified AP group.
Syntax
display wlan ap-group [ brief | name group-name ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
brief: Displays brief information about all AP groups.
name group-name: Displays detailed information about the specified AP group. The group-name argument represents the name of an AP group, a case-insensitive string of 1 to 31 characters.
Usage guidelines
If you do not specify any parameter, this command displays detailed information about all AP groups.
Examples
# Display detailed information about all AP groups.
[Sysname] display wlan ap-group
Total number of AP groups: 2
AP group name : default-group
Description : Not configured
AP model : Not configured
APs : Not configured
AP group name : group1
Description : abcd
AP model : WA4320H
AP grouping rules:
AP name : ap1, ap2
Serial ID : 219801A0YG8165E00001
MAC address : 0AFB-423B-893C
IPv4 address : Not configured
IPv6 address : Not configured
APs : ap1 (AP name)
# Display detailed information about AP group group1.
[Sysname] display wlan ap-group group1
AP group name : group1
Description : Not configured
AP model : WA4320H
AP grouping rules:
AP name : ap1, ap2
Serial ID : 219801A0YG8165E00001
MAC address : 0AFB-423B-893C
IPv4 address : Not configured
IPv6 address : Not configured
APs : ap1 (AP name)
# Display brief information about all AP groups.
<Sysname> display wlan ap-group brief
Total number of AP groups: 4
AP group name Group ID Member APs Online APs
default-group 1 1 0
group1 2 2006 1986
group2 3 10 10
group3 4 4 4
Related commands
wlan ap-group
display wlan ap-model
Use display wlan ap-model to display AP model information.
display wlan ap-model { all | name model-name }
name model-name: Specifies an AP model by its name.
# Display information about AP model WA4320H.
<Sysname> display wlan ap-model name WA4320H
AP model : WA4320H
Alias : WA4320H
Vendor name : H3C
Vendor ID : 25506
License weight : 100
License type : 1
Radio count : 2
Radio 1:
Mode : 802.11a, 802.11an, 802.11ac
Default mode : 802.11ac
BSS count : 16
Radio 2:
Mode : 802.11b, 802.11g, 802.11gn
Default mode : 802.11gn
BSS count : 16
Version Support List :
Hardware Version Ver.A:
Software Version : R2206P02
Default Software Version : R2206P02
Image Name : wa4300h.ipe
Hardware Version Ver.B:
Software Version : R2206P02
Default Software Version : R2206P02
Image Name : wa4300h.ipe
Hardware Version Ver.C:
Software Version : R2206P02
Default Software Version : R2206P02
Image Name : wa4300h.ipe
Hardware Version Ver.D:
Software Version : R2206P02
Default Software Version : R2206P02
Image Name : wa4300h.ipe
Hardware Version Ver.E:
Software Version : R2206P02
Default Software Version : R2206P02
Image Name : wa4300h.ipe
Hardware Version Ver.F:
Software Version : R2206P02
Default Software Version : R2206P02
Image Name : wa4300h.ipe
display wlan license
Use display wlan license to display the number of installed WLAN licenses.
Syntax
display wlan license
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display the number of installed WLAN licenses.
<Sysname> display wlan license
Installed common AP licenses : 64
Installed WTU licenses : 0
Table 17 Command output
Field |
Description |
Installed common AP licenses |
Number of installed common AP licenses. |
Installed WTU licenses |
This field is not supported in the current software version. Number of installed WTU licenses. |
display wlan spm
Use display wlan spm to display information about Smart PoE managers (SPMs) and their associated WAP series APs.
Syntax
display wlan spm { all | name spm-name }
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
all: Specifies all SPMs.
name spm-name: Specifies an SPM by its name, a case-sensitive string of 1 to 64 characters. The sting can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Examples
# Display information about all SPMs and their associated WAP series APs.
<Sysname> display wlan spm all
SPM name : spm1
Model : SPM-X1-10
Serial ID : 219801A0WK9166Q00028
MAC address : 0000-f3ea-0a3e
WAPs : 2
Wireless access points:
---------------------------------------------------------------
WAP name Port Model Serial ID
---------------------------------------------------------------
wap1 1 WAP712 219801A0SS9156G00185
wap2 2 WAP712 219801A0SS9156G00133
Table 18 Command output
Field |
Description |
WAPs |
Number of associated WAPs. |
Port |
Port through which the WAP is associated with the SPM. |
dns domain
Use dns domain to specify a domain name for an AP.
Use undo dns domain to restore the default.
Syntax
dns domain domain-name
undo dns domain
Default
In AP provision view, an AP uses the configuration in AP group provision view.
In AP group provision view, no domain name is specified for an AP.
Views
AP provision view
AP group provision view
Predefined user roles
network-admin
Parameters
domain-name: Specifies a domain name, a case-insensitive string of 1 to 253 characters separated by dots. The string can contain letters, digits, hyphens (-), and underscores (_).
Usage guidelines
The configuration in AP provision view takes effect only on the AP. The configuration in AP group provision view takes effect on all APs in the AP group.
The configuration in AP provision view takes precedence over the configuration in AP group provision view.
Examples
# Set the domain name for AP ap1 to com.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan-ap-ap1] provision
[Sysname-wlan-ap-ap1-prvs] dns domain com
# Set the domain name for APs in AP group group1 to com.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] provision
[Sysname-wlan-ap-group-group-prvs] dns domain com
Related commands
dns server
dns server
Use dns server to specify a DNS server for an AP.
Use undo dns server to delete the DNS server configuration.
Syntax
dns server { ip ipv4-address | ipv6 ipv6-address }
undo dns server { ip | ipv6 }
Default
In AP provision view, an AP uses the configuration in AP group provision view.
In AP group provision view, no DNS server is specified for an AP.
Views
AP provision view
AP group provision view
Predefined user roles
network-admin
Parameters
ip ipv4-address: Specifies a DNS server by its IPv4 address. Make sure you specify a valid IP address. Invalid IP addresses include loopback IP addresses, direct broadcast addresses, Class D IP addresses, Class E IP addresses, IP address 255.255.255.255, and IP addresses in the 0.X.X.X format.
ipv6 ipv6-address: Specifies a DNS server by its IPv6 address.
Usage guidelines
You can specify only one IPv4 address and one IPv6 address in each view.
The configuration in AP provision view takes effect only on the AP. The configuration in AP group provision view takes effect on all APs in the AP group.
The configuration in AP provision view takes precedence over the configuration in AP group provision view.
Examples
# Set the DNS server IP address to 192.168.100.123 for AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan-ap-ap1] provision
[Sysname-wlan-ap-ap1-prvs] dns server ip 192.168.100.123
# Set the DNS server IP address to 192.168.100.123 for APs in AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] provision
[Sysname-wlan-ap-group-group-prvs] dns server ip 192.168.100.123
Related commands
dns domain
download file
Use download file to download an image file to an AP.
Syntax
download file filename
Views
AP view
Predefined user roles
network-admin
Parameters
filename: Specifies an image file by its name, a string of 1 to 255 characters.
Usage guidelines
This feature takes effect only on the master AC after a CAPWAP tunnel is established in WLAN high availability networking. For more information about WLAN high availability, see "Configuring WLAN high availability."
In an AC hierarchy, you must upload the image file to the storage media of the associated local AC before executing this command on the central AC.
Examples
# Download image file main.ipe to AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan–ap-ap1] download file main.ipe
echo-count
Use echo-count to set the maximum number of echo request transmission attempts.
Use undo echo-interval to restore the default.
Syntax
echo-count count
undo echo-count
Default
In AP view, an AP uses the configuration in AP group view.
In AP group view, the maximum number of echo request transmission attempts is 3.
Views
AP view
AP group view
Predefined user roles
network-admin
Parameters
count: Specifies the maximum number of echo request transmission attempts in the range of 3 to 255.
Usage guidelines
An AP sends echo requests to the AC at the specified echo intervals to identify whether the CAPWAP control tunnel is operating correctly. The AC responds by sending echo responses. If the AP does not receive any echo responses before the keepalive timer expires, the AP terminates the connection. If the AC does not receive any echo requests before the keepalive timer expires, the AC terminates the connection. The keepalive timer is the echo interval multiplied by the maximum number of echo request transmission attempts.
The configuration in AP view takes precedence over the configuration in AP group view.
Examples
# Set the maximum number of echo request transmission attempts to 5 for AP ap3.
<Sysname> system-view
[Sysname] wlan ap ap3 model WA4320H
[Sysname-wlan-ap-ap3] echo-count 5
# Set the maximum number of echo request transmission attempts to 5 for APs in AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] echo-count 5
echo-interval
Use echo-interval to set the interval for an AP to send echo requests to the AC.
Use undo echo-interval to restore the default.
Syntax
echo-interval interval
undo echo-interval
Default
In AP view, an AP uses the configuration in AP group view.
In AP group view, the interval for an AP to send echo requests is 10 seconds.
Views
AP view
AP group view
Predefined user roles
network-admin
Parameters
interval: Specifies the interval for sending echo requests, in seconds. The value can be 0 or in the range of 5 to 255.
|
CAUTION: Setting the echo interval to 0 seconds disables an AP from sending echo requests. This setting is for test use only. For correct AC and AP communication, do not set the echo interval to 0 seconds. |
An AP sends echo requests to the AC at the specified echo intervals to identify whether the CAPWAP control tunnel is operating correctly. If the AP does not receive any echo responses from the AC before the keepalive timer expires, the AP terminates the connection. If the AC does not receive any echo requests before the keepalive times expires, the AC terminates the connection. The keepalive timer is the echo interval multiplied by the maximum number of echo request transmission attempts set by using the echo-count count command.
The configuration in AP view takes precedence over the configuration in AP group view.
Examples
# Set the echo interval for AP ap3 to 15 seconds.
<Sysname> system-view
[Sysname] wlan ap ap3 model WA4320H
[Sysname-wlan-ap-ap3] echo-interval 15
# Set the echo interval for APs in AP group group1 to 15 seconds.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] echo-interval 15
firmware-upgrade
Use firmware-upgrade enable to enable the software upgrade feature.
Use firmware-upgrade disable to disable the software upgrade feature.
Use undo firmware-upgrade to restore the default.
Syntax
firmware-upgrade { disable | enable }
undo firmware-upgrade
Default
In AP view, an AP uses the configuration in AP group view. If no software upgrade configuration exists in AP group view, the AP uses the configuration in global configuration view.
In AP group view, an AP uses the configuration in global configuration view.
In global configuration view, the software upgrade feature is enabled.
Views
AP view
AP group view
Global configuration view
Predefined user roles
network-admin
Usage guidelines
This feature enables the AC to examine whether an AP's software version matches the hardware version and software version mappings stored on the AC during CAPWAP tunnel establishment.
· If a match is found, the AC establishes a CAPWAP tunnel with the AP.
· If no match is found, the CAPWAP tunnel establishment proceeds as follows:
a. The AC notifies the AP of software version inconsistency.
b. After receiving the notification, the AP requests the software version from the AC, upgrades the software, and then establishes a CAPWAP tunnel with the AC.
When this feature is disabled, the AC does not examine the software version of an AP and establishes a CAPWAP tunnel with the AP.
The configuration in AP view takes precedence over the configuration in AP group view. The configuration in AP group view takes precedence over the configuration in global configuration view.
Examples
# Enable the software upgrade feature for AP ap3.
<Sysname> system-view
[Sysname] wlan ap ap3 model WA4320H
[Sysname-wlan-ap-ap3] firmware-upgrade enable
# Enable the software upgrade feature for APs in AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] firmware-upgrade enable
# Enable the software upgrade feature globally.
<Sysname> system-view
[Sysname] wlan global-configuration
[Sysname-wlan-global-configuration] firmware-upgrade enable
Related commands
wlan apdb
fragment-size
Use fragment-size to set the maximum fragment size for CAPWAP control or data packets.
Use undo fragment-size to remove the configuration.
Syntax
fragment-size { control control-size | data data-size }
undo fragment-size { control | data }
Default
In AP view, an AP uses the configuration in AP group view.
In AP group view, the maximum fragment size for CAPWAP control packets and data packets is 1450 bytes and 1500 bytes, respectively.
Views
AP view
AP group view
Predefined user roles
network-admin
Parameters
control control-size: Specifies the maximum fragment size for CAPWAP control packets in bytes. The value range for the control-size argument is 1000 to 1450.
data data-size: Specifies the maximum fragment size for CAPWAP data packets in bytes. The value range for the control-size argument is 1000 to 1748.
Usage guidelines
This command prevents packets between AC and AP from being dropped by intermediate devices if the AP connects to the AC across the Internet.
Any maximum fragment size modification takes effect immediately on online APs.
The configuration in AP view takes precedence over the configuration in AP group view.
Examples
# Set the maximum fragment size for CAPWAP data packets to 1500 bytes for AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-ap-ap1] fragment-size data 1500
# Set the maximum fragment size for CAPWAP data packets to 1500 bytes for APs in AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] fragment-size data 1500
gateway
Use gateway to specify a gateway for an AP.
Use undo gateway to delete the gateway configuration.
Syntax
gateway { ip ipv4-address | ipv6 ipv6-address }
undo gateway { ip | ipv6 }
Default
No gateway is specified for an AP.
Views
AP provision view
Predefined user roles
network-admin
Parameters
ip ipv4-address: Specifies a gateway by its IPv4 address. Make sure you specify a valid IP address. Invalid IP addresses include loopback IP addresses, direct broadcast addresses, Class D IP addresses, Class E IP addresses, IP address 255.255.255.255, and IP addresses in the 0.X.X.X format.
ipv6 ipv6-address: Specifies a gateway by its IPv6 address.
Usage guidelines
You can set only one IPv4 address and one IPv6 address.
Examples
# Set the gateway IP address to 192.168.100.1 for AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan-ap-ap1] provision
[Sysname-wlan-ap-ap1-prvs] gateway ip 192.168.100.1
gateway information report
Use gateway information report enable to enable APs to report gateway information to the AC.
Use gateway information report disable to disable APs from reporting gateway information to the AC.
Use undo gateway information report to restore the default.
Syntax
gateway information report { enable | disable }
undo gateway information report
Default
APs do not report gateway information to the AC.
Views
Global configuration view
Predefined user roles
network-admin
Examples
# Enable APs to report gateway information to the AC.
<Sysname> system-view
[Sysname] wlan global-configuration
[Sysname-wlan-global-configuration] gateway information report enable
gigabitethernet
|
NOTE: Support for this command depends on the AP model. |
Use gigabitethernet to enter the GigabitEthernet interface view of an AP.
Syntax
gigabitethernet interface-number
Views
AP view
AP group's AP model view
Predefined user roles
network-admin
Parameters
interface-number: Specifies an interface number. The value range varies by AP model.
Examples
# Enter the interface view of GigabitEthernet 1 from AP view.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA5530
[Sysname-wlan-ap-ap1] gigabitethernet 1
[Sysname-wlan-ap-ap1-gigabitethernet-1]
# Enter the interface view of GigabitEthernet 1 from the AP model view of AP group 1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] ap-model WA5530
[Sysname-wlan-ap-group-group1-ap-model-WA5530] gigabitethernet 1
[Sysname-wlan-ap-group-group1-ap-model-WA5530-gigabitethernet-1]
if-match ip
Use if-match ip to create an AP grouping rule by IPv4 addresses.
Use undo if-match ip to delete AP grouping rules by IPv4 addresses.
Syntax
if-match ip ip-address { mask-length | mask }
undo if-match ip [ ip-address { mask-length | mask } ]
Default
No AP grouping rules by IPv4 addresses exist.
Views
AP group view
Predefined user roles
network-admin
Parameters
ip-address: Specifies an IPv4 address in dotted decimal notation.
mask-length: Specifies the mask length in the range of 1 to 31.
mask: Specifies the mask in dotted decimal notation.
Usage guidelines
You cannot execute this command in the view of the default AP group.
AP grouping rules by IPv4 addresses for an AP group or for different AP groups cannot overlap with each other.
An AP group supports a maximum of 32 AP grouping rules by IPv4 addresses.
The priorities of AP grouping rules by AP names, serial IDs, MAC addresses, and IP addresses are in descending order. If an AP does not match any grouping rules, it is added to the default AP group.
You can create AP grouping rules by both IPv4 addresses and IPv6 addresses for an AP group.
If you do not specify any argument in the undo form of the command, the command deletes all AP grouping rules by IPv4 addresses.
Examples
# Add APs whose IP address belongs to 192.168.0.0/16 to AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-ap-group-group1] if-match ip 192.168.0.0 16
if-match ipv6
Use if-match ipv6 to create an AP grouping rule by IPv6 addresses.
Use undo if-match ipv6 to delete AP grouping rules by IPv6 addresses.
Syntax
if-match ipv6 { ipv6-address prefix-length | ipv6-address/prefix-length }
undo if-match ip [ ipv6-address prefix-length | ipv6-address/prefix-length ]
Default
No AP grouping rules by IPv6 addresses exist.
Views
AP group view
Predefined user roles
network-admin
Parameters
ipv6-address: Specifies an IPv6 address.
prefix-length: Specifies the IPv6 address prefix length in the range of 1 to 128.
Usage guidelines
You cannot execute this command in the view of the default AP group.
AP grouping rules by IPv6 addresses for an AP group or for different AP groups cannot overlap with each other.
An AP group supports a maximum of 32 AP grouping rules by IPv6 addresses.
The priorities of AP grouping rules by AP names, serial IDs, MAC addresses, and IP addresses are in descending order. If an AP does not match any grouping rules, it is added to the default AP group.
You can create AP grouping rules by both IPv4 addresses and IPv6 addresses for an AP group.
If you do not specify any argument in the undo form of the command, the command deletes all AP grouping rules by IPv6 addresses.
Examples
# Add APs whose IPv6 address belongs to 2001:DB0::/28 to AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-ap-group-group1] if-match ipv6 2001:DB8:: 28
ip address
Use ip address to specify an IPv4 address for the management VLAN interface for an AP.
Use undo ip address to restore the default.
Syntax
ip address ip-address { mask | mask-length }
undo ip address
Default
No IPv4 address is specified for the management VLAN interface of an AP.
Views
AP provision view
Predefined user roles
network-admin
Parameters
ip-address: Specifies an IPv4 address in dotted decimal notation.
mask: Specifies the mask in dotted decimal notation.
mask-length: Specifies the mask length in the range of 1 to 31.
Usage guidelines
Make sure you specify a valid IP address. Invalid IP addresses include loopback IP addresses, direct broadcast addresses, Class D IP addresses, Class E IP addresses, IP address 255.255.255.255, and IP addresses in the 0.X.X.X format.
The IP address of the management VLAN interface for an AP must be different from the following IP addresses:
· IP address of the management VLAN interface of another AP.
· AC IP address specified in provision view of any APs.
Examples
# Set the IP address of the management VLAN interface to 10.1.1.1/24 for AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan-ap-ap1] provision
[Sysname-wlan-ap-ap1-prvs] ip address 10.1.1.1 24
ipv6 address
Use ipv6 address to specify an IPv6 address for the management VLAN interface for an AP.
Use undo ipv6 address to restore the default.
Syntax
ipv6 address { ipv6-address prefix-length | ipv6-address/prefix-length }
undo ipv6 address
Default
No IPv6 address is specified for the management VLAN interface of an AP.
Views
AP provision view
Predefined user roles
network-admin
Parameters
ipv6-address: Specifies an IPv6 address.
prefix-length: Specifies the prefix length in the range of 1 to 128.
Usage guidelines
The IP address of the management VLAN interface for an AP must be different from the following IP addresses:
· IP address of the management VLAN interface of another AP.
· AC IP address specified in provision view of any APs.
Examples
# Set the IPv6 address of the management VLAN interface to 2001::1/64 for AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan-ap-ap1] provision
[Sysname-wlan-ap-ap1-prvs] ipv6 address 2001::1/64
keepalive-interval
Use keepalive-interval to set the data tunnel keepalive interval.
Use undo keepalive-interval to restore the default.
Syntax
keepalive-interval interval
undo keepalive-interval
Default
In AP view, an AP uses the configuration in AP group view.
In AP group view, the data tunnel keepalive interval is 10 seconds.
Views
AP view
AP group view
Predefined user roles
network-admin
Parameters
interval: Specifies the interval for an AP to send keepalive packets over the CAPWAP data tunnel. The value range is 1 to 255 seconds.
Examples
# Set the data tunnel keepalive interval for AP ap1 to 15 seconds.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan-ap-ap1] keepalive-interval 15
# Set the data tunnel keepalive interval for APs in AP group 1 to 15 seconds.
<Sysname> system-view
[Sysname] wlan ap-group 1
[Sysname-ap-group-1] keepalive-interval 15
led-mode
Use led-mode to set a LED lighting mode.
Use undo led-mode to restore the default.
Syntax
led-mode { always-on | awake | normal | quiet }
undo led-mode
Default
In AP view, an AP uses the configuration in AP group view.
In AP group view, the LED lighting mode is normal.
Views
AP view
AP group view
Predefined user roles
network-admin
Parameters
always-on: Specifies the always-on mode. Support for this keyword depends on the AP model.
awake: Specifies the awake mode. Support for this keyword depends on the AP model.
normal: Specifies the normal mode. How LEDs flash in this mode varies by AP model.
quiet: Specifies the quiet mode.
Usage guidelines
If you set the LED lighting mode to awake or always-on in AP group view, the setting takes effect only on member APs that support the specified LED lighting mode.
The configuration in AP view takes precedence over the configuration in AP group view.
Examples
# Set the LED lighting mode to normal for AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan-ap-ap1] led-mode normal
# Set the LED lighting mode to awake for APs in AP group ap1.
<Sysname> system-view
[Sysname] wlan ap-group g1
[Sysname-wlan-ap-group-g1] led-mode awake
mac-address (AP group view)
Use mac-address to create an AP grouping rule by MAC addresses.
Use undo mac-address to delete an AP grouping rule by MAC addresses.
Syntax
mac-address mac-address
undo mac-address mac-address
Default
No AP grouping rules by MAC addresses exist.
Views
AP group view
Predefined user roles
network-admin
Parameters
mac-address: Specifies the MAC address of an AP.
Usage guidelines
This command does not identify whether the specified AP exists.
You can configure multiple AP grouping rules by MAC addresses.
The priorities of AP grouping rules by AP names, serial IDs, MAC addresses, and IP addresses are in descending order. If an AP does not match any grouping rules, it is added to the default AP group.
If the created AP grouping rule already exists in another AP group, this command deletes the rule from that AP group.
You cannot execute this command in the view of the default AP group.
Examples
# Create an AP grouping rule by MAC addresses for AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] mac-address 0AC1-F9B2-B1C2
Related commands
wlan ap-group
mac-address (AP view)
Use mac-address to assign a MAC address to an AP.
Use undo mac-address to restore the default.
Syntax
mac-address mac-address
undo mac-address
Default
No MAC address is assigned to an AP.
Views
AP view
Predefined user roles
network-admin
Parameters
mac-address: Specifies the MAC address in H-H-H format.
Usage guidelines
Changing or deleting the MAC address of an AP terminates the CAPWAP tunnel if the AP has established a CAPWAP tunnel with the AC. Then the AP will reestablish a CAPWAP tunnel with the AC.
Examples
# Assign the MAC address 0001-0000-0000 to AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan-ap-ap1] mac-address 0001-0000-0000
map-configuration
Use map-configuration to deploy a configuration file to an AP.
Use undo map-configuration to restore the default.
Syntax
map-configuration filename
undo map-configuration
Default
No configuration file is deployed to an AP.
Views
AP view
AP group's AP model view
Predefined user roles
network-admin
Parameters
filename: Specifies a configuration file by its name, a case-insensitive string of 1 to 63 characters.
Examples
# Deploy configuration file downconfig.txt to AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan-ap-ap1] map-configuration downconfig.txt
# Deploy configuration file downconfig.txt to APs with model WA4320H in AP group apgroup1.
<Sysname> system-view
[Sysname] wlan ap-group apgroup1
[Sysname-wlan-ap-group-apgroup1] ap-model WA4320H
[Sysname-wlan-ap-group-apgroup1-ap-model-WA4320H] map-configuration downconfig.txt
poe port
|
NOTE: Support for this command depends on the AP model. |
Use poe port enable to enable PoE for power interfaces (PIs).
Use poe port disable to disable PoE for PIs.
Use undo poe port to restore the default.
Syntax
poe port port-number1 [ to port-number2 ] { disable | enable }
undo poe port port-number1 [ to port-number2 ]
Default
In AP view, an AP uses the configuration in an AP group's AP model view.
In an AP group's AP model view, PoE is disabled for PIs.
Views
AP view
AP group's AP model view
Predefined user roles
network-admin
Parameters
port-number1: Specifies a PI by its port number. The value range varies by AP model.
port-number1 to port-number2: Specifies a port range. The port-number1 argument represents the start port number, and the port-number2 argument represents the end port number. The end port number cannot be smaller than the start port number. The value range for a port number varies by AP model.
Examples
# Disable PoE for PI 3 of AP ap1 with AP model WA5320X.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA5320X
[Sysname-wlan-ap-ap1] poe port 3 disable
# Disable PoE for PI 3 of all APs with AP model WA5320X in AP group 1.
<Sysname> system-view
[Sysname] wlan ap-group 1
[Sysname-wlan-ap-group-1] ap-model WA5320X
[Sysname-wlan-ap-group-1-ap-model-WA5320X] poe port 3 disable
power-level default
|
NOTE: Support for this command depends on the AP model. |
Use power-level default to set the default input power level for an AP in case the AP cannot obtain its input power level.
Use undo power-level default to restore the default.
Syntax
power-level default { high | low | middle }
undo power-level default
Default
In AP view, an AP uses the configuration in an AP group's AP model view.
In an AP group's AP model view, the default input power level of an AP is middle.
Views
AP view
AP group's AP model view
Predefined user roles
network-admin
Parameters
high: Specifies the high default input power level.
low: Specifies the low default input power level.
middle: Specifies the middle default input power level.
Usage guidelines
Configure this command for an AP in case the AP cannot obtain its input power level at startup.
The power level of an AP can be high, middle, or low. An AP automatically performs power supply mode detection to obtain its input power level at startup. If the AP fails to obtain the input power level, it operates at the low input power level before associating with an AC. After the association, it operates at the configured default input power level.
The following table shows the relationship between the AP's power supply mode and input power level:
Power supply mode |
Input power level |
· Power adapter. · Multiple PoE+ ports. · Combination of PoE and PoE+ ports. |
High |
· Single PoE+ port · Multiple PoE ports |
Middle |
Single PoE port |
Low |
An AP's support for MIMO modes and USB interfaces varies by power level, as shown in Table 19.
Table 19 AP's support for MIMO modes and USB interfaces
Input power level |
MIMO modes |
Whether USB interfaces can be enabled |
High |
1×1, 2×2, 3×3, and 4×4. |
Yes. |
Middle |
1×1, 2×2, 3×3, and 4×4. |
Yes when the MIMO mode is 1×1 or 2×2. |
Low |
1×1. |
No. |
The configuration in AP view takes precedence over the configuration in AP group' AP model view.
Examples
# Set the default input power level to high for AP ap1 in AP view.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA5620i-ACN
[Sysname-wlan-ap-ap1] power-level default high
# Set the default input power level to high in AP model view of AP group g1.
<Sysname> system-view
[Sysname] wlan ap-group g1
[Sysname-wlan-ap-group-g1] ap-model WA5620i-ACN
[Sysname-wlan-ap-group-g1-ap-model-WA5620i-ACN] power-level default high
priority
Use priority to set the AP connection priority for the AC.
Use undo priority to restore the default.
Syntax
priority priority
undo priority
Default
In AP view, an AP uses the configuration in AP group view.
In AP group view, the AP connection priority for the AC is 4.
Views
AP view
AP group view
Predefined user roles
network-admin
Parameters
priority: Specifies the AP connection priority for the AC, in the range of 0 to 7. A larger value represents a higher connection priority.
Usage guidelines
The AP prefers to establish a CAPWAP tunnel with an AC that has higher connection priority.
The AP connection priority only takes effect during AC discovery.
The configuration in AP view takes precedence over the configuration in AP group view.
Examples
# Set the AP connection priority for the AC to 7 for AP ap3.
<Sysname> system-view
[Sysname] wlan ap ap3 model WA4320H
[Sysname-wlan-ap-ap3] priority 7
# Set the AP connection priority for the AC to 7 for AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] priority 7
provision
Use provision to enable AP preprovisioning and enter AP provision view, or enter AP provision view. if AP preprovisioning is already enabled.
Use undo provision to disable AP preprovisioning.
Syntax
provision
undo provision
Default
In AP view, an AP uses the configuration in AP group view.
In AP group view, AP preprovisioning is disabled.
Views
AP view
AP group view
Predefined user roles
network-admin
Usage guidelines
AP preprovisioning allows you to configure network settings for APs on the AC. The AC automatically assigns these settings to the APs.
If you disable AP preprovisioning, network settings configured on the AC will be deleted. However, the operation does not affect the network settings already assigned to the APs.
The configuration in AP view takes precedence over the configuration in AP group view.
Examples
# Enable AP preprovisioning and enter AP provision view of AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan-ap-ap1] provision
[Sysname-wlan-ap-ap1-prvs]
# Enable AP preprovisioning and enter AP provision view of AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] provision
[Sysname-wlan-ap-group-group1-prvs]
provision auto-recovery
Use provision auto-recovery enable to enable auto loading of preprovisioned settings.
Use provision auto-recovery disable to disable auto loading of preprovisioned settings.
Use undo provision auto-recovery to restore the default.
Syntax
provision auto-recovery { disable | enable }
undo provision auto-recovery
Default
In AP view, an AP uses the configuration in AP group view.
In AP group view, auto loading of preprovisioned settings is enabled.
Views
AP view
AP group view
Predefined user roles
network-admin
Usage guidelines
Auto loading of preprovisioned settings ensures successful CAPWAP tunnel establishment between AP and AC. An AP uses the following procedure to discover an AC when you enable this feature:
1. Uses the preprovisioned settings to discover an AC that has the AP's manual or auto AP configuration.
2. Reboots and uses other methods to discover ACs if AC discovery fails.
3. Reboots and uses the preprovisioned settings again to discover ACs if the AP still fails to discover the target AC.
This AC discovery process will be repeated until the AP discovers the target AC to establish a CAPWAP tunnel.
The configuration in AP view takes precedence over the configuration in AP group view.
Examples
# Disable auto loading of preprovisioned settings for AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-ap-ap1] provision auto-recovery disable
# Disable auto loading of preprovisioned settings for APs in AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] provision auto-recovery disable
provision auto-update
Use provision auto-update enable to enable auto assignment of preprovisioned settings.
Use provision auto-update disable to disable auto assignment of preprovisioned settings.
Use undo provision auto-update to restore the default.
Syntax
provision auto-update { disable | enable }
undo provision auto-update
Default
In AP view, an AP uses the configuration in AP group view.
In AP group view, auto assignment of preprovisioned settings is disabled.
Views
AP view
AP group view
Predefined user roles
network-admin
Usage guidelines
This command enables the AC to automatically assign preprovisioned settings to an AP so that the AP can use the preprovisioned settings to come online.
This command applies only to offline APs. To deploy preprovisioned settings to online APs, use the save wlan ap provision command.
The configuration in AP provision view has higher priority than the configuration in AP group provision view.
The configuration in AP view takes precedence over the configuration in AP group view.
Examples
# Enable auto assignment of preprovisioned settings for AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-ap-ap1] provision auto-update enable
# Enable auto assignment of preprovisioned settings for APs in AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] provision auto-update enable
report-interval
Use report-interval to set the interval at which APs in an AP monitor group report statistics to the AC.
Use undo report-interval to restore the default.
Syntax
report-interval interval
undo report-interval
Default
APs in an AP monitor group report statistics to the AC at intervals of 50 seconds.
Views
Monitor group view
Predefined user roles
network-admin
Parameters
interval: Specifies the interval at which APs in an AP monitor group report statistics to the AC, in the range of 10 to 120 seconds.
Examples
# Set the interval to 30 seconds for the APs in an AP monitor group to report statistics to the AC.
<Sysname> system-view
[Sysname] wlan vip-ap-group
[Sysname-wlan-vip-ap-group] report-interval 30
Related commands
ap-name
wlan vip-ap-group
reset wlan ap
Use reset wlan ap to reset all APs or the specified APs.
Syntax
reset wlan ap { all | ap-group group-name | model model-name | name ap-name | native }
Views
User view
Predefined user roles
network-admin
Parameters
all: Specifies all APs connected to the AC.
ap-group group-name: Specifies an AP group by its name, a case-insensitive string of 1 to 31 characters.
model model-name: Specifies an AP model by model name.
name ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
native: Specifies all APs that have established CAPWAP tunnels with the AC.
Usage guidelines
This command terminates the CAPWAP tunnel between an AP and the AC and deletes all connection information about the AP.
Examples
# Reset the AP ap1.
<Sysname> reset wlan ap name ap1
Resetting the APs will terminate the CAPWAP tunnels with the AC. Continue? [Y/N]:
reset wlan ap connection-record
Use reset wlan ap connection-record to clear AP connection records on the AC.
Syntax
reset wlan ap { all | name ap-name } connection-record
Views
User view
Predefined user roles
network-admin
Parameters
all: Specifies all APs.
name ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Examples
# Clear all the AP connection records on the AC.
<Sysname> reset wlan ap all connection-record
reset wlan ap provision
Use reset wlan ap provision to delete configuration file wlan_ap_prvs.xml from all APs or the specified AP.
Syntax
reset wlan ap provision { all | name ap-name }
Views
Any view
Predefined user roles
network-admin
Parameters
all: Specifies all APs.
name ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Usage guidelines
This command takes effect only on APs that have established CAPWAP tunnels with the master AC and are in Run state.
For this command to take effect on an AP, restart the AP.
Examples
# Delete configuration file wlan_ap_prvs.xml from AP ap1.
<Sysname> reset wlan ap provision name ap1
reset wlan ap reboot-log
Use reset wlan ap reboot-log to clear the reboot logs of all APs or the specified AP.
Syntax
reset wlan ap reboot-log { all | name ap-name }
Views
User view
Predefined user roles
network-admin
Parameters
all: Specifies all APs.
name ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Examples
# Clear the reboot logs of AP ap1.
<Sysname> reset wlan ap reboot-log name ap1
Related commands
display wlan ap reboot-log
reset wlan ap unauthenticated
Use reset wlan ap unauthenticated to restart unauthenticated auto APs for reauthentication.
Syntax
reset wlan ap unauthenticated
Views
User view
Predefined user roles
network-admin
Examples
# Restart unauthenticated auto APs.
<Sysname> reset wlan ap unauthenticated
reset wlan tunnel latency ap
Use reset wlan tunnel latency ap to clear tunnel latency information for all APs or the specified AP.
Syntax
reset wlan tunnel latency ap { all | name ap-name }
Views
User view
Predefined user roles
network-admin
Parameters
all: Specifies all APs.
name ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Usage guidelines
This command takes effect only on APs that have established tunnels with the master AC and are in Run state.
Examples
# Clear tunnel latency information for AP ap1.
<Sysname> reset wlan tunnel latency ap name ap1
Related commands
display wlan ap tunnel latency
tunnel latency-detect
retransmit-count
Use retransmit-count to set the maximum number of AC request retransmission attempts.
Use undo retransmit-count to restore the default.
Syntax
retransmit-count value
undo retransmit-count
Default
In AP view, an AP uses the configuration in AP group view.
In AP group view, the maximum number of AC request retransmission attempts is 3.
Views
AP view
AP group view
Predefined user roles
network-admin
Parameters
value: Specifies the maximum number of AC request retransmission attempts, in the range of 2 to 5.
Usage guidelines
The AC sends a request to an AP at the retransmission interval until the maximum number of request retransmission attempts is reached or a response is received.
Requests sent by the AC to an AP include the following types:
· Image Data Request.
· Configuration Update Request.
· Reset Request.
· Data Transfer Request.
· IEEE 802.11 WLAN Configuration Request.
· Station Configuration Request.
The configuration in AP view takes precedence over the configuration in AP group view.
Examples
# Set the maximum number of AC request retransmission attempts to 4 for AP ap3.
<Sysname> system-view
[Sysname] wlan ap ap3 model WA4320H
[Sysname-wlan-ap-ap3] retransmit-count 4
# Set the maximum number of AC request retransmission attempts to 4 for APs in AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] retransmit-count 4
Related commands
retransmit-interval
retransmit-interval
Use retransmit-interval to set the request retransmission interval for the AC to retransmit requests to an AP.
Use undo retransmit-interval to restore the default.
Syntax
retransmit-interval interval
undo retransmit-interval
Default
In AP view, an AP uses the configuration in AP group view.
In AP group view, the request retransmission interval is 5 seconds.
Views
AP view
AP group view
Predefined user roles
network-admin
Parameters
interval: Specifies the request retransmission interval in the range of 3 to 8 seconds.
Usage guidelines
The AC sends a request to an AP at the retransmission interval until the maximum number of request retransmission attempts is reached or a response is received.
Requests sent by the AC to an AP include the following types:
· Image Data Request.
· Configuration Update Request.
· Reset Request.
· Data Transfer Request.
· IEEE 802.11 WLAN Configuration Request.
· Station Configuration Request.
The configuration in AP view takes precedence over the configuration in AP group view.
Examples
# Set the request retransmission interval to 6 seconds for the AC to send requests to AP ap3.
<Sysname> system-view
[Sysname] wlan ap ap3 model WA4320H
[Sysname-wlan-ap-ap3] retransmit-interval 6
# Set the request retransmission interval to 6 seconds for the AC to send requests to APs in AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] retransmit-interval 6
Related commands
retransmit-count
save wlan ap provision
Use save wlan ap provision to deploy the provision configuration to all APs or the specified AP.
Syntax
save wlan ap provision { all | name ap-name }
Views
Any view
Predefined user roles
network-admin
Parameters
all: Specifies all APs.
name ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Usage guidelines
This command saves the added or modified preprovisioned settings to the wlan_ap_prvs.xml configuration file.
This command takes effect only on online APs that have established tunnels with the master AC.
This command has the same effect as the reset wlan ap provision command if no AP preprovisioned settings exist.
Preprovisioned settings configured in provision view take effect immediately when you execute the save wlan ap provision command.
Cancellations of preprovisioned settings in provision view do not take effect when you execute the save wlan ap provision command. For the cancellations to take effect on an AP, restart the AP.
Examples
# Save the configuration in AP provision view to configuration file wlan_ap_prvs.xml on AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan-ap-ap1] provision
[Sysname-wlan-ap-ap1-prvs] ac ip 192.168.0.1
[Sysname-wlan-ap-ap1-prvs] save wlan ap provision name ap1
serial-id (AP group view)
Use serial-id to create an AP grouping rule by serial IDs.
Use undo serial-id to delete an AP grouping rule by serial IDs.
Syntax
serial-id serial-id
undo serial-id serial-id
Default
No AP grouping rules by serial IDs exist.
Views
AP group view
Predefined user roles
network-admin
Parameters
serial-id: Specifies an AP serial ID, a case-insensitive string of 1 to 63 characters.
Usage guidelines
This command does not identify whether the specified AP exists.
You can configure multiple AP grouping rules by serial IDs.
The priorities of AP grouping rules by AP names, serial IDs, MAC addresses, and IP addresses are in descending order. If an AP does not match any grouping rules, it is added to the default AP group.
If the created AP grouping rule already exists in another AP group, this command deletes the rule from that AP group.
You cannot execute this command in the view of the default AP group.
Examples
# Create an AP grouping rule by serial IDs for AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] serial-id 210235A1BSC123000037
Related commands
wlan ap-group
serial-id (AP view)
Use serial-id to specify the serial ID for an AP.
Use undo serial-id to restore the default.
Syntax
serial-id serial-id
undo serial-id
Default
No serial ID is specified for an AP.
Views
AP view
Predefined user roles
network-admin
Parameters
serial-id: Specifies the serial ID for an AP, a case-insensitive string of 1 to 63 characters.
Usage guidelines
Changing or deleting the serial ID of an AP terminates the CAPWAP tunnel if the AP has established a CAPWAP tunnel with an AC. Then the AP will reestablish a CAPWAP tunnel with the AC.
Examples
# Set the serial ID of AP ap1 to 219801A0YG8165E00001.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-ap-ap1] serial-id 219801A0YG8165E00001
snmp-agent trap enable wlan ap
Use snmp-agent trap enable wlan ap to enable SNMP notifications for AP management.
Use undo snmp-agent trap enable wlan ap to disable SNMP notifications for AP management.
Syntax
snmp-agent trap enable wlan ap
undo snmp-agent trap enable wlan ap
Default
SNMP notifications are disabled for AP management.
Views
System view
Predefined user roles
network-admin
Usage guidelines
To report critical AP management events to an NMS, enable SNMP notifications for AP management. For AP management event notifications to be sent correctly, you must also configure SNMP on the device. For more information about SNMP configuration, see Network Management and Monitoring Configuration Guide.
Examples
# Enable SNMP notifications for AP management.
<Sysname> system-view
[Sysname] snmp-agent trap enable wlan ap
snmp-agent trap enable wlan capwap
Use snmp-agent trap enable wlan capwap to enable SNMP notifications for CAPWAP.
Use undo snmp-agent trap enable wlan capwap to disable SNMP notifications for CAPWAP.
Syntax
snmp-agent trap enable wlan capwap
undo snmp-agent trap enable wlan capwap
Default
SNMP notifications are disabled for CAPWAP.
Views
System view
Predefined user roles
network-admin
Usage guidelines
To report critical CAPWAP events to an NMS, enable SNMP notifications for CAPWAP. For CAPWAP event notifications to be sent correctly, you must also configure SNMP on the device. For more information about SNMP configuration, see Network Management and Monitoring Configuration Guide.
Examples
# Enable SNMP notifications for CAPWAP.
<Sysname> system-view
[Sysname] snmp-agent trap enable wlan capwap
statistics-interval
Use statistics-interval to set the statistics report interval for an AP to send statistics reports to the AC.
Use undo statistics-interval to restore the default.
Syntax
statistics-interval interval
undo statistics-interval
Default
In AP view, an AP uses the configuration in AP group view. If no configuration exists in AP group view, the AP uses the configuration in global configuration view.
In AP group view, an AP uses the configuration in global configuration view.
In global configuration view, the statistics report interval is 50 seconds.
Views
AP view
AP group view
Global configuration view
Predefined user roles
network-admin
Parameters
interval: Specifies the statistics report interval in the range of 0 to 240 seconds.
Usage guidelines
Execute this command to change the interval for an AP to report its statistics. You can use these statistics to monitor the operating status of radios on the AP.
To disable an AP from reporting radio statistics to the AC, set the statistics report interval to 0.
The configuration in AP view takes precedence over the configuration in AP group view. The configuration in AP group view takes precedence over the configuration in global configuration view
Examples
# Set the statistics reports interval to 10 seconds for AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan-ap-ap1] statistics-interval 10
# Set the statistics reports interval to 10 seconds for APs in AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] statistics-interval 10
# Set the global statistics reports interval to 10 seconds.
<Sysname> system-view
[Sysname] wlan global-configuration
[Sysname-wlan-global-configuration] statistics-interval 10
statistics-interval fast-report
Use statistics-interval fast-report to set the interval at which an AP fast reports specific statistics to the AC.
Use undo statistics-interval fast-report to restore the default.
Syntax
statistics-interval fast-report fast-report-interval
undo statistics-interval fast-report
Default
In AP view, an AP uses the configuration in AP group view.
In AP group view, the fast report interval is 0 seconds. An AP does not fast report statistics to the AC.
Views
AP view
AP group view
Predefined user roles
network-admin
Parameters
fast-report-interval: Specifies the fast report interval in the range of 0 to 120 seconds.
Usage guidelines
Setting the interval to 0 disables an AP from fast reporting statistics to the AC.
APs can fast report only channel usage statistics to the AC.
Examples
# Set the fast report interval to 10 seconds for AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan-ap-ap1] statistics-interval fast-report 10
# Set the fast report interval to 10 seconds for APs in AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] statistics-interval fast-report 10
Related commands
statistics-interval
tunnel encryption
Use tunnel encryption enable to enable CAPWAP control tunnel encryption.
Use tunnel encryption disable to disable CAPWAP control tunnel encryption.
Use undo tunnel encryption enable to restore the default.
Syntax
tunnel encryption { disable | enable }
undo tunnel encryption enable
Default
In AP view, an AP uses the configuration in AP group view.
In AP group view, CAPWAP control tunnel encryption is disabled.
Views
AP view
AP group view
Predefined user roles
network-admin
Usage guidelines
This feature will cause an AP to reassociate with the AC.
With this feature enabled, an AP performs a DTLS handshake and establishes a CAPWAP tunnel with the AC after receiving a discovery response with the encryption flag from the AC. Then, the AC and the AP encrypt control packets transmitted in the CAPWAP control tunnel after the DTLS handshake.
The configuration in AP view takes precedence over the configuration in AP group view.
Examples
# Enable CAPWAP control tunnel encryption for AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan-ap-ap1] tunnel encryption enable
This operation will restart the AP. Continue? [Y/N]
# Enable CAPWAP control tunnel encryption for APs in AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] tunnel encryption enable
This operation will restart member APs that are not enabled with CAPWAP control tunnel encryption. Continue? [Y/N]
tunnel latency-detect
Use tunnel latency-detect to configure CAPWAP tunnel latency detection.
Syntax
tunnel latency-detect { start | stop }
Default
CAPWAP tunnel latency detection is not started.
Views
AP view
Predefined user roles
network-admin
Parameters
start: Starts CAPWAP tunnel latency detection.
stop: Stops CAPWAP tunnel latency detection.
Usage guidelines
CAPWAP tunnel latency detection enables the AC to detect the transmission latency of CAPWAP control frames or data frames from an AP to the AC and back.
When an AP goes offline, CAPWAP tunnel latency detection automatically stops. To restart CAPWAP tunnel latency detection when the AP comes online again, execute the tunnel latency-detect start command again.
The tunnel latency-detect start command takes effect only on APs that have established CAPWAP tunnels with the master AC and are in Run state.
Examples
# Start CAPWAP tunnel latency detection for AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan-ap-ap1] tunnel latency-detect start
Related commands
display wlan ap tunnel latency
reset wlan tunnel latency ap
usb
|
NOTE: Support for this command depends on the AP model. |
Use usb enable to enable USB interfaces on APs.
Use usb disable to disable USB interfaces on APs.
Use undo usb to restore the default.
Syntax
usb { disable | enable }
undo usb
Default
In AP view, an AP uses the configuration in an AP group's AP model view.
In an AP group's AP model view, USB interfaces are disabled.
Views
AP view
AP group's AP model view
Predefined user roles
network-admin
Usage guidelines
This command takes effect on an AP only when either of the following requirements is met:
· The power level of the AP is high.
· The power level of the AP is middle and the MIMO mode is 1×1 or 2×2.
For information about power levels, see "power-level default." For information about MIMO modes, see radio management in WLAN Configuration Guide.
The configuration in AP view takes precedence over the configuration in AP group' AP model view.
Examples
# Enable USB interfaces in AP view.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA5620i-ACN
[Sysname-wlan-ap-ap1] usb enable
# Enable USB interfaces in AP model view of AP group g1.
<Sysname> system-view
[Sysname] wlan ap-group g1
[Sysname-wlan-ap-group-g1] ap-model WA5620i-ACN
[Sysname-wlan-ap-group-g1-ap-model-WA5620i-ACN] usb enable
Related commands
power-level default
virtual-ap
Use virtual-ap to create a virtual AP.
Use undo virtual-ap to delete a virtual AP.
Syntax
virtual-ap mode { fit ac-address { ip ipv4-address | ipv6
ipv6-address } | hierarchy-fit } service-template-number service-template-number
undo virtual-ap
Default
No virtual APs exist.
Views
AP view
Predefined user roles
network-admin
Parameters
fit: Creates a virtual fit AP.
ac-address: Specifies the IP address of the AC to which the virtual AP connects.
ipv4 ipv4-address: Specifies the IPv4 address of the AC to which the virtual AP connects.
ipv6 ipv6-address: Specifies the IPv6 address of the AC to which the virtual AP connects.
hierarchy-fit: Creates a virtual hierarchy fit AP.
service-template-number service-template-number: Specifies the maximum number of service templates to which the virtual AP can be bound. The value range is 1 to 15.
Usage guidelines
Make sure the physical AP has established a CAPWAP tunnel with the master AC before you execute this command.
Examples
# Create a virtual AP for AP ap1.
<Sysname> system-view
[Sysname] wlan ap ap1
[Sysname-wlan-ap-ap1] virtual-ap mode fit ac-address ip 1.1.1.1 service-template-number 1
wlan ap
Use wlan ap to create a manual AP and enter its view, or enter the view of an existing manual AP.
Use undo wlan ap to delete an AP.
Syntax
wlan ap ap-name [ model model-name ]
undo wlan ap ap-name
Default
No manual APs exist.
Views
System view
Predefined user roles
network-admin
Parameters
ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
model model-name: Specifies the model name of the AP. You must specify the model name when you create an AP.
Usage guidelines
If the specified AP has established a CAPWAP tunnel, the undo wlan ap command also terminates the tunnel.
Examples
# Create an AP named ap1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA4320H
[Sysname-wlan-ap-ap1]
wlan ap-authentication
Use wlan ap-authentication to manually authenticate unauthenticated auto APs.
Syntax
wlan ap-authentication { accept | reject } ap-unauthenticated { all | name ap-name }
Default
Manual authentication is not configured for unauthenticated auto APs.
Views
System view
Predefined user roles
network-admin
Parameters
accept: Enables unauthenticated auto APs to pass authentication and generate ACL permit rules. Authenticated auto APs can provide wireless services.
reject: Rejects unauthenticated auto APs and generates ACL deny rules. If you specify this keyword, the command logs off all online unauthenticated auto APs.
all: Specifies all unauthenticated auto APs.
name ap-name: Specifies an unauthenticated auto AP by its name, a case-sensitive string of 1 to 64 characters.
Usage guidelines
Unauthenticated auto APs can associate with the AC but cannot provide wireless services. You can execute this command to authenticate these APs.
Before you execute this command, perform the following tasks:
· Use the acl wlan ap command to create a WLAN AP ACL.
· Use the wlan ap-authentication acl command to specify the ACL as the ACL for authenticating unauthenticated auto APs.
The generated ACL rules will be added to the specified ACL.
Examples
# Enable unauthenticated auto APs to pass authentication and generate permit rules in ACL 200.
<Sysname> system-view
[Sysname] acl wlan ap 200
[Sysname-acl-ap-200] quit
[Sysname] wlan ap-authentication acl 200
[Sysname] wlan ap-authentication accept ap-unauthenticated all
Related commands
acl wlan ap
permit-unauthenticated
wlan ap-authentication
wlan apdb
Use wlan apdb to configure the mapping between a software version and a hardware version of an AP model.
Use undo wlan apdb to restore the default.
Syntax
wlan apdb model-name hardware-version software-version
undo wlan apdb model-name hardware-version
Default
The software version for a hardware version of an AP model is the software version that is stored in APDB user scripts.
Views
System view
Predefined user roles
network-admin
Parameters
model-name: Specifies an AP model name in the APDB.
hardware-version: Specifies a hardware version in the APDB.
software-version: Specifies an AP software version, a case-insensitive string of 1 to 31 characters.
Usage guidelines
|
CAUTION: To avoid CAPWAP tunnel establishment failure, use this command under the guidance of H3C Support. |
This command is used together with the software upgrade feature for software version consistency check during software upgrade.
Use this command only when the software version you expect for an AP is inconsistent with the software version specified for the AP model stored in the APDB.
Examples
# Configure the mapping between software version E2108 and hardware version Ver.C of AP model WA4320H.
<Sysname> system-view
[Sysname] wlan apdb WA4320H Ver.C E2108
Related commands
firmware-upgrade
wlan apdb file
Use wlan apdb file to load an APDB user script.
Use undo wlan apdb file to delete an APDB user script.
Syntax
wlan apdb file user.apdb
undo wlan apdb file
Default
No APDB user script is loaded.
Views
System view
Predefined user roles
network-admin
Parameters
user.apdb: Specifies an APDB user profile by its name, a case-sensitive string of 1 to 63 characters. apdb is the filename extension.
Usage guidelines
When you load an APDB user script, follow these restrictions and guidelines:
· If you load multiple user scripts on the AC, the most recently loaded user script overwrites the old user scripts.
· Make sure the user script is valid. Invalid scripts can cause loading failure.
· The AP models in the user script must be different from the AP models in the system script.
· If you rename the user script in the file system, reload the user script to prevent AP model configuration in the user script from being lost after an AC reboot.
· If you replace the user script with a new user script in the file system, reload the new user script. If the new user script does not include AP model information saved in the replaced user script, the AP model information will be lost after an AC reboot.
· If you delete a user script in the file system, reload a new user script. If you do not reload a new user script, the AP model configuration in the user script will be lost after an AC reboot.
If an old user script already exists, follow these restrictions and guidelines when you load an APDB user script:
· If a manual AP or an online auto AP whose model is listed in the old user script exists ,you can load a new user script only when you delete the corresponding AP model information on the AC.
· If APs of an AP model listed in the old user script have been added to an AP group, you can load a new user script only when you remove the APs from the AP group.
· If the old user script includes an AP model whose software version was already configured, you can load a new user script only when you use the wlan apdb command to restore the original software version.
Examples
# Load user script user.apdb.
<Sysname> system-view
[Sysname] wlan apdb file user.apdb
Related commands
wlan apdb
wlan ap-image-deploy
Use wlan ap-image-deploy to deploy an image file to all the online APs.
Syntax
wlan ap-image-deploy
Views
System view
Predefined user roles
network-admin
Usage guidelines
This feature enables you to upgrade the image of all the online APs. For the upgrade to take effect, reboot the APs after upgrade.
Before executing this command, you must upload the image file to the storage media of the AC. You can execute the wlan image-load filepath command to specify the storage media.
Examples
# Deploy an image file to all the online APs.
<Sysname> system-view
[Sysname] wlan ap-image-deploy
Related commands
wlan image-load filepath
wlan ap-group
Use wlan ap-group to create an AP group and enter its view, or enter the view of an existing AP group.
Use undo wlan ap-group to delete an AP group.
Syntax
wlan ap-group group-name
undo wlan ap-group group-name
Default
The default AP group default-group exists, and it cannot be deleted.
Views
System view
Predefined user roles
network-admin
Parameters
group-name: Specifies an AP group by its name, a case-insensitive string of 1 to 31 characters.
Examples
# Create an AP group named group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1]
Related commands
display wlan ap-group
wlan ap-version-switch enable
Use wlan ap-version-switch enable to enable version switchover for HP APs.
Use undo wlan ap-version-switch enable to disable version switchover for HP APs.
Syntax
wlan ap-version-switch enable
undo wlan ap-version-switch enable
Views
System view
Default
The version switchover feature is disabled for HP APs.
Predefined user roles
network-admin
Usage guidelines
Use this command to switch HP's AP version to H3C's AP version when an HP AP needs to associate with an H3C AC. An HP AP can initiate a CAPWAP tunnel establishment process with an H3C AC only after the version switchover.
Examples
# Enable version switchover for HP APs.
<Sysname> system-view
[Sysname] wlan ap-version-switch enable
wlan auto-ap enable
Use wlan auto-ap enable to enable the auto AP feature.
Use undo wlan auto-ap enable to disable the auto AP feature.
Syntax
wlan auto-ap enable
undo wlan auto-ap enable
Default
The auto AP feature is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
This command enables an AP to connect to an AC without manual AP configuration. It simplifies configuration when you deploy a large number of APs in a WLAN.
To configure an auto AP, you must use auto-AP persistence to convert the auto AP to a manual AP or configure it through an AP group.
Examples
# Enable the auto AP feature.
<Sysname> system-view
[Sysname] wlan auto-ap enable
wlan auto-ap persistent
Use wlan auto-ap persistent to convert online auto APs to manual APs.
Syntax
wlan auto-ap persistent { all | name auto-ap-name [ new-ap-name ] }
Views
System view
Predefined user roles
network-admin
Parameters
all: Specifies all online auto APs. If you specify this keyword, the command converts all online auto APs to manual APs with AP names unchanged.
name auto-ap-name: Specifies an online auto AP.
new-ap-name: Specifies a new name for the AP, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-). If you do not specify this argument, the converted manual AP uses the name of the auto AP.
Examples
# Convert the auto AP whose MAC address is 0001-ab12-cd36 to manual AP ap2.
<Sysname> system-view
[Sysname] wlan auto-ap persistent name 0001-ab12-cd36 ap2
wlan auto-persistent enable
Use wlan auto-persistent enable to convert auto APs to manual APs after they come online.
Use undo wlan auto-persistent enable to restore the default.
Syntax
wlan auto-persistent enable
undo wlan auto-persistent enable
Default
Auto AP conversion is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
This command takes effect only on auto APs that come online after you execute this command. For auto APs that are already online, use the wlan auto-ap persistent command to convert them to manual APs.
Examples
# Enable auto AP conversion.
<Sysname> system-view
[Sysname] wlan auto-persistent enable
wlan capwap discovery-policy unicast
Use wlan capwap discovery-policy unicast to enable an AC to respond only to unicast discovery requests.
Use undo wlan capwap discovery-policy to disable an AC to respond only to unicast discovery requests.
Syntax
wlan capwap discovery-policy unicast
undo wlan capwap discovery-policy
Default
An AC can respond to unicast, multicast, and broadcast discovery requests.
Views
System view
Predefined user roles
network-admin
Examples
# Enable the AC to respond only to unicast discovery requests.
<Sysname> system-view
[Sysname] wlan capwap discovery-policy unicast
wlan detect-anomaly enable
Use wlan detect-anomaly enable to enable service anomaly detection.
Use undo wlan detect-anomaly enable to disable service anomaly detection.
Syntax
wlan detect-anomaly enable
undo wlan detect-anomaly enable
Default
Service anomaly detection is enabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
This feature takes effect only on the master AC that had more than 50 associated APs in an IRF fabric.
This feature enables an AC to check service status and start a reboot timer (10 minutes) upon detecting that no APs are associated with the AC. When the reboot timer expires, the AC performs either of the following operations:
· Restarts if no AP comes online during the 10 minutes.
· Deletes the timer if a minimum of one AP is online.
If APs come online and then all go offline before the timer expires, the AC restarts the timer upon detecting that the last online AP goes offline.
With this feature disabled, the AC cannot restart automatically if a service exception occurs. As a best practice, do not disable this feature.
Examples
# Enable service anomaly detection.
<Sysname> system-view
[Sysname] wlan detect-anomaly enable
wlan global-configuration
Use wlan global-configuration to enter global configuration view.
Syntax
wlan global-configuration
Views
System view
Predefined user roles
network-admin
Usage guidelines
The configuration priorities for an AP in AP view, AP group view, and global configuration view are in descending order. If no settings are configured in one view, the settings in the view with a lower priority are used. If no settings are configured in any one of the three views, the AP uses the default configuration in the view that has the lowest priority.
Examples
# Enter global configuration view.
<Sysname> system-view
[Sysname] wlan global-configuration
[Sysname-wlan-global-configuration]
wlan image-load filepath
Use wlan image-load filepath to specify the preferred location for the AC to obtain an AP image file for software version assignment.
Use undo wlan image-load filepath to restore the default.
Syntax
wlan image-load filepath { local | ram }
undo wlan image-load filepath
Default
The AC prefers the AP image file stored in the RAM when assigning a software version to APs.
Views
System view
Predefined user roles
network-admin
Parameters
local: Specifies the local folder as the preferred location to obtain an AP image file. If the local folder does not contain an AP image file, the AC obtains the AP image file from the RAM. If the RAM does not contain an AP image file, the AC fails to obtain an AP image file.
ram: Specifies the RAM as the preferred location to obtain an AP image file. If the RAM does not contain an AP image file, the AC obtains the AP image file from the local folder. If the local folder does not contain an AP image file, the AC fails to obtain an AP image file.
Usage guidelines
The AC image file contains AP image files. The AC reads the AP image files into the RAM when it starts.
Specify the local keyword only when the following conditions are met:
· The required AP image file is not contained in the AC's image file.
· The software version an AP uses when it comes online has been specified using the wlan apdb command.
When you specify the local keyword, make sure the AC uses a CF or flash card as the default file system and the AP image file is stored in the root directory of the file system on the AC.
The AC can assign only .ipe AP image files to APs.
Examples
# Specify the local folder as the preferred location to obtain an AP image file for AP software version assignment.
<Sysname> system-view
[Sysname] wlan image-load filepath local
wlan re-group
Use wlan re-group to move an AP grouping rule or a list of AP grouping rules to the specified AP group.
Syntax
wlan re-group { ap ap-name | ap-group source-group-name | mac-address mac-address | serial-id serial-id } group-name
Views
System view
Predefined user roles
network-admin
Parameters
ap ap-name: Specifies an AP grouping rule by AP names.
ap-group source-group-name: Specifies the source AP group. The source AP group cannot be the default AP group.
mac-address mac-address: Specifies an AP grouping rule by MAC addresses.
serial-id serial-id: Specifies an AP grouping rule by serial IDs.
group-name: Specifies the target AP group. The target AP group cannot be the default AP group.
Examples
# Create an AP group named group1, and create AP grouping rules by AP names to add APs ap1, ap2, and ap3 to AP group group1.
<Sysname> system-view
[Sysname] wlan ap-group group1
[Sysname-wlan-ap-group-group1] ap ap1 ap2 ap3
[Sysname-wlan-ap-group-group1] quit
# Create an AP group named group2, and move an AP grouping rule by AP names to AP group group2.
[Sysname] wlan ap-group group2
[Sysname-wlan-ap-group-group2] quit
[Sysname] wlan re-group ap ap1 group2
wlan rename-ap
Use wlan rename-ap to rename a manual AP.
Syntax
wlan rename-ap ap-name new-ap-name
Views
System view
Predefined user roles
network-admin
Parameters
ap-name: Specifies a manual AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
new-ap-name: Specifies a new AP name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-). The new AP name cannot be the same as the old AP name.
Examples
# Change the name of AP ap1 to ap1-office.
<Sysname> system-view
[Sysname] wlan rename-ap ap1 ap1-office
wlan tcp mss
Use wlan tcp mss to set the maximum TCP segment size (TCP MSS) for CAPWAP tunnels.
Use undo wlan tcp mss to restore the default.
Syntax
wlan tcp mss value
undo wlan tcp mss
Default
The TCP MSS is 1460 bytes for CAPWAP tunnels.
Views
System view
Predefined user roles
network-admin
Parameters
value: Specifies the TCP MSS in bytes in the range of 128 to 2048.
Usage guidelines
This command sets the value of the MSS option in SYN packets transmitted over a CAPWAP tunnel.
The MSS option informs the receiver of the largest segment that the sender can accept. Each end announces its MSS during TCP connection establishment. If the size of a TCP segment is smaller than or equal to the MSS of the receiver, TCP sends the TCP segment without fragmentation. If not, TCP fragments the segment based on the receiver's MSS.
Examples
# Set the TCP MSS to 2000 bytes for CAPWAP tunnels.
<Sysname> system-view
[Sysname] wlan tcp mss 2000
wlan vip-ap-group
Use wlan vip-ap-group to create an AP monitor group and enter its view or enter the view of an existing AP monitor group.
Use undo wlan vip-ap-group to delete an AP monitor group.
Syntax
wlan vip-ap-group
undo wlan vip-ap-group
Default
No AP monitor group exists.
Views
System view
Predefined user roles
network-admin
Usage guidelines
APs in an AP monitor group can report client quantity, radio traffic, channel usage, and AP anomalies to the AC.
Examples
# Create an AP monitor group.
<Sysname> system-view
[Sysname] wlan vip-ap-group
[Sysname-wlan-vip-ap-group]
Related commands
ap-name
report-interval