- Table of Contents
-
- 12-WLAN Advanced Features Command Reference
- 00-Preface
- 01-Bonjour gateway commands
- 02-Hotspot 2.0 commands
- 03-WLAN mesh commands
- 04-Wireless location commands
- 05-WLAN process maintenance commands
- 06-WLAN fast forwarding commands
- 07-WLAN optimization commands
- 08-AC hierarchy commands
- 09-WSA commands
- 10-WLAN probe commands
- 11-WLAN forwarding commands
- Related Documents
-
Title | Size | Download |
---|---|---|
08-AC hierarchy commands | 166.13 KB |
Contents
display wlan local-ac (on central ACs)
display wlan local-ac (on local ACs)
display wlan local-ac connection-record
display wlan local-ac online-time
location (RRM holddown group view)
location (service template view)
wlan local-ac capwap source-vlan
AC hierarchy commands
The following compatibility matrixes show the support of hardware platforms for AC hierarchy:
Hardware series |
Model |
Product code |
Local AC role |
Central AC role |
WX1800H series |
WX1804H |
EWP-WX1804H-PWR-CN |
Yes |
No |
WX2500H series |
WX2508H-PWR-LTE WX2510H WX2510H-F WX2540H WX2540H-F WX2560H |
EWP-WX2508H-PWR-LTE EWP-WX2510H-PWR EWP-WX2510H-F-PWR EWP-WX2540H EWP-WX2540H-F EWP-WX2560H |
Yes |
No |
WX3000H series |
WX3010H WX3010H-X WX3010H-L WX3024H WX3024H-L WX3024H-F |
EWP-WX3010H EWP-WX3010H-X-PWR EWP-WX3010H-L-PWR EWP-WX3024H EWP-WX3024H-L-PWR EWP-WX3024H-F |
Yes |
No |
WX3500H series |
WX3508H WX3510H WX3520H WX3520H-F WX3540H |
EWP-WX3508H EWP-WX3510H EWP-WX3520H EWP-WX3520H-F EWP-WX3540H |
Yes |
Yes |
WX5500E series |
WX5510E WX5540E |
EWP-WX5510E EWP-WX5540E |
Yes |
Yes |
WX5500H series |
WX5540H WX5560H WX5580H |
EWP-WX5540H EWP-WX5560H EWP-WX5580H |
Yes |
Yes |
Access controller modules |
LSUM1WCME0 EWPXM1WCME0 LSQM1WCMX20 LSUM1WCMX20RT LSQM1WCMX40 LSUM1WCMX40RT EWPXM2WCMD0F EWPXM1MAC0F |
LSUM1WCME0 EWPXM1WCME0 LSQM1WCMX20 LSUM1WCMX20RT LSQM1WCMX40 LSUM1WCMX40RT EWPXM2WCMD0F EWPXM1MAC0F |
No |
Yes |
Hardware series |
Model |
Product code |
Local AC role |
Central AC role |
WX1800H series |
WX1804H WX1810H WX1820H WX1840H |
EWP-WX1804H-PWR EWP-WX1810H-PWR EWP-WX1820H EWP-WX1840H-GL |
No |
No |
WX3800H series |
WX3820H WX3840H |
EWP-WX3820H-GL EWP-WX3840H-GL |
No |
No |
WX5800H series |
WX5860H |
EWP-WX5860H-GL |
No |
No |
backup-ac
Use backup-ac to specify a backup central AC.
Use undo backup-ac to remove the backup central AC configuration.
Syntax
backup-ac { ip ipv4-address | ipv6 ipv6-address }
undo backup-ac { ip | ipv6 }
Default
No backup central AC is specified.
Views
Local AC view
Predefined user roles
network-admin
Parameters
ip ip-address: Specifies the IPv4 address of a backup central AC.
ipv6 ipv6-address: Specifies the IPv6 address of a backup central AC.
Usage guidelines
Only central ACs support this command.
You can specify only one IPv4 address and one IPv6 address.
Executing the undo command also terminates the backup CAPWAP tunnels between the backup central AC and local ACs.
Examples
# Specify a backup central AC for local AC bac.
<Sysname> system-view
[Sysname] wlan local-ac name bac
[Sysname-wlan-local-ac-bac] backup-ac ip 192.168.1.1
delete file
Use delete file to delete a file from a local AC.
Syntax
delete file filename
Views
Local AC view
Predefined user roles
network-admin
Parameters
filename: Specifies a file by its file name, a string of 1 to 255 characters.
Usage guidelines
Only central ACs support this command.
This command takes effect only on the master central AC that has established a CAPWAP tunnel with the local AC.
Examples
# Delete file startup.cfg from local AC abc.
<Sysname> system-view
[Sysname] wlan local-ac name abc
[Sysname-wlan-local-ac-abc] delete file startup.cfg
Related commands
display wlan local-ac files
download file
display wlan ac-role
Use display wlan ac-role to display the current AC role.
Syntax
display wlan ac-role
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
Only central ACs support this command.
Examples
# Display the current AC role.
<Sysname> display wlan ac-role
Current AC role: Central AC
Table 1 Command output
Field |
Description |
Current AC role |
AC role: · Common. · Central AC. · Local AC. · Unknown. |
display wlan client
Use display wlan client to display client information.
Syntax
display wlan client distributed-sys [ verbose ]
In IRF mode:
display wlan client distributed-sys [ slot slot-number ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
distributed-sys: Specifies the AC hierarchical network.
distributed-sys: Specifies the IRF network. (In IRF mode.)
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays client information on the master device. (In IRF mode.)
verbose: Displays detailed client information. If you do not specify this keyword, the command displays brief client information.
Examples
# (In IRF mode.) Display brief information about clients on IRF member device 1.
<Sysname> display wlan client distributed-sys slot 1
Total number of clients: 3
MAC address Username AP name RID IPv4 address VLAN
000f-e265-6400 N/A ap1 1 1.1.1.1 100
000f-e265-6401 user ap2 1 3.0.0.3 200
84db-ac14-dd08 N/A ap1 1 5.5.5.3 1
Table 2 Command output
Field |
Description |
MAC address |
Client MAC address. |
Username |
Client username: · The field displays the client username if the client uses 802.1X or MAC authentication. · The field displays N/A if the client does not use 802.1X or MAC authentication. NOTE: If the client uses portal authentication, this field does not display the portal username of the client. |
AP name |
Name of the AP that the client is associated with. |
RID |
ID of the radio that the client is associated with. |
IPv4 address |
IPv4 address of the client. |
VLAN ID |
ID of the VLAN to which the client belongs. |
# (In IRF mode.) Display detailed information about clients on IRF member device 1.
<Sysname> display wlan client distributed-sys slot 1 verbose
Total number of clients: 1
MAC address : 000f-e265-6400
IPv4 address : 10.1.1.114
IPv6 address : 2001::1234:5678:0102:0304
Username : N/A
AID : 1
AP ID : 1
AP name : ap1
Radio ID : 1
SSID : office
BSSID : 0026-3e08-1150
VLAN ID : 3
Sleep count : 3
Wireless mode : 802.11ac
Channel bandwidth : 80MHz
SM power save : Enabled
SM power save mode : Dynamic
Short GI for 20MHz : Supported
Short GI for 40MHz : Supported
Short GI for 80MHz : Supported
Short GI for 160/80+80MHz : Not supported
STBC RX capability : Not supported
STBC TX capability : Not supported
LDPC RX capability : Not supported
SU beamformee capability : Not supported
MU beamformee capability : Not supported
Beamformee STS capability : N/A
Block Ack : TID 0 In
Supported VHT-MCS set : NSS1 0, 1, 2, 3, 4, 5, 6, 7, 8
NSS2 0, 1, 2, 3, 4, 5, 6, 7, 8
Supported HT MCS set : 0, 1, 2, 3, 4, 5, 6, 7,
8, 9, 10, 11, 12, 13, 14,
15, 16, 17, 18, 19, 20,
21, 22, 23
Supported rates : 6, 9, 12, 18, 24, 36,
48, 54 Mbps
QoS mode : WMM
Listen interval : 10
RSSI : 62
Rx/Tx rate : 130/195 Mbps
Authentication method : Open system
Security mode : PRE-RSNA
AKM mode : Not configured
Cipher suite : N/A
User authentication mode : Bypass
Authorization ACL ID : 3001(Not effective)
Authorization user profile : N/A
Roam status : N/A
Key derivation : SHA1
PMF status : Enabled
Forward policy name : Not configured
Online time : 0days 0hours 1minutes 13seconds
FT status : Inactive
Table 3 Command output
Field |
Description |
MAC address |
Client MAC address. |
IPv4 address |
Client IPv4 address. |
IPv6 address |
Client IPv6 address. |
Username |
Client username: · The field displays the client username if the client uses 802.1X or MAC authentication. · The field displays N/A if the client does not use 802.1X or MAC authentication. NOTE: If the client uses portal authentication, this field does not display the portal username of the client. |
AID |
Association ID. |
AP ID |
ID of the AP that the client is associated with. |
AP name |
Name of the AP that the client is associated with. |
Radio ID |
ID of the radio that the client is associated with. |
SSID |
SSID with which the client is associated. |
VLAN ID |
ID of the VLAN to which the client belongs. |
Sleep count |
Client sleep times. |
Wireless mode |
Wireless mode: · 802.11a. · 802.11b. · 802.11g. · 802.11gn. · 802.11an. · 802.11ac. |
Channel bandwidth |
Channel bandwidth: · 20 MHz. · 40 MHz. · 80 MHz. · 160 MHz. |
SM Power Save |
SM Power Save status: · Enabled—Only one antenna of the client operates in active state, and others operate in sleep state to save power. · Disabled. |
SM power save mode |
Power saving mode: · Dynamic. · Static. |
Short GI for 20MHz |
Whether the client supports short GI when its channel bandwidth is 20 MHz: · Supported. · Not supported. |
Short GI for 40MHz |
Whether the client supports short GI when its channel bandwidth is 40 MHz: · Supported. · Not supported. |
Short GI for 80MHz |
Whether the client supports short GI when its channel bandwidth is 80 MHz: · Supported. · Not supported. |
Short GI for 160/80+80MHz |
Whether the client supports short GI when its channel bandwidth is 160 MHz or 80 + 80 MHz: · Supported. · Not supported. |
STBC Rx Capability |
Client STBC receive capability; · Not Supported. · Supported. |
STBC Tx Capability |
Client STBC transmission capability: · Not Supported. · Supported. |
LDPC Rx capability |
Client LDPC receive capability; · Not Supported. · Supported. |
SU beamformee capability |
Client SU beamformee capability: · Not Supported. · Supported. This field is supported only by 802.11ac radios. |
MU beamformee capability |
Client MU beamformee capability: · Not Supported. · Supported. This field is supported only by 802.11ac radios. |
Beamformee STS capability |
Client beamformee STS capability. This field displays N/A if the feature is not supported. |
Block Ack |
Negotiation result of Block ACK with TID: · TID 0 In—Sends Block ACK for inbound traffic. · TID 0 Out—Sends Block ACK for outbound traffic. · TID 0 Both—Sends Block ACK for both inbound and outbound traffic. · N/A—Does not send Block ACK for both inbound and outbound traffic. |
Supported VHT-MCS set |
VHT-MCS supported by the client. |
Supported HT MCS set |
HT-MCS supported by the client. |
QoS mode |
QoS mode: · N/A—WMM is not supported. · WMM—WMM is supported. WMM information is negotiated between an AP and a client that both support WMM. |
Listen interval |
Interval at which the client wakes up to listen for beacon frames. It is counted by beacon interval. |
RSSI |
Received signal strength indication. This value indicates the client signal strength detected by the AP. |
Rx/Tx rate |
Sending and receiving rates of data, management, and control frames. |
Authentication method |
Authentication method: · Open system. · Shared key. |
Security mode |
Security mode: · RSN—Beacons and probe responses carry RSN IE. · WPA—Beacons and probe responses carry WPA IE. · PRE-RSNA—Beacons and probe responses do not carry RSN IE or WPA IE. |
AKM mode |
AKM mode: · 802.1X. · PSK. · Not configured. |
Cipher suite |
Cipher suite: · N/A. · WEP40. · WEP104. · WEP128. · CCMP. · TKIP. |
User authentication mode |
User authentication mode: · Bypass—No client authentication. · MAC. · 802.1X. · OUI. |
Authorization ACL ID |
Authorized ACL number: · This field displays the ACL number if the authorization ACL takes effect. · This field displays ACL number(Not effective) if the authorization ACL does not take effect. · This field displays N/A if the authentication server is configured without any authorization ACL. |
Authorization user profile |
Name of the authorization user profile: · This field displays the authorized user profile name if the authorization user profile takes effect. · This field displays authorized user profile name + Not effective if the authorization user profile does not take effect. · This field displays N/A if the authentication server is configured without any authorization user profile. |
Roam status |
Roam status: · Inter-AC roaming. · Intra-AC roaming. · This field displays N/A if the client stays in one BSS after coming online. |
Key derivation |
Key derivation type: · SHA1—Uses the HMAC-SHA1 hash algorithm. · SHA256—Uses the HMAC-SHA256 hash algorithm. · N/A—No key derivation algorithm is involved for the authentication type. |
PMF status |
PMF status: · Enabled—Management frame protection is enabled. · Disabled—Management frame protection is disabled. · N/A—Management frame protection is not involved. |
Forward policy name |
WLAN forwarding policy name: · Not configured. · Policy-name. |
Online time |
Client online duration. |
FT status |
Fast BSS transition (FT): · Active—FT is enabled. · Inactive—FT is disabled. |
display wlan local-ac (on central ACs)
Use display wlan local-ac to display information about local ACs managed by the central AC.
Syntax
display wlan local-ac { all | name local-ac-name } [ address | verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
all: Specifies all local ACs.
name local-ac-name: Specifies a local AC by its name, a case-sensitive string of 1 to 64 characters. It can contain letters, digits, underscores (_), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
address: Displays local AC address information.
verbose: Displays detailed local AC information. If you do not specify this keyword, the command displays brief local AC information.
Examples
# Display brief information about all local ACs managed by the central AC.
<Sysname> display wlan local-ac all
Total number of local ACs: 2
Total number of connected local ACs: 2
Local AC Information
State : I = Idle, J = Join, JA = JoinAck, IL = ImageLoad
C = Config, DC = DataCheck, R/M = Run, M = Master, B = Backup
AC name ACID State Model Serial ID
lac1 1 I WX5510E 210235A1BSC123000050
lac2 2 R/M WX5510E 210456B9CEN238400040
Table 4 Command output
Field |
Description |
ACID |
ID of the local AC. It is assigned automatically by the central AC to uniquely identify a local AC on the central AC. |
State |
Local AC state: · I—Idle. · J—Join. · JA—Join acknowledge. · IL—The local AC is downloading a version. · C—The local AC is downloading initial configuration. · DC—The local AC is checking data. · R—The local AC is operating. It indicates that the local AC and the central AC have established a CAPWAP tunnel successfully. · M—Master tunnel. · B—Backup tunnel. |
Serial ID |
Serial ID of the local AC. This field displays Not configured if it is not configured. |
# Display detailed information about local AC bac managed by the central AC.
<Sysname> display wlan local-ac name bac verbose
Local AC name : bac
Local AC ID : 1
State : Run
Online time : 0 days 0 hours 0 minutes 24 seconds
System up time : 0 days 0 hours 5 minutes 24 seconds
Model : WX5510E
Serial ID : 332135A0N701
MAC address : 00EF-003C-0001
IP address : 1.2.3.3
UDP port number : 60225
H/W version : Ver.A
S/W version : A7164
Boot version : 2.17
Description : Not configured
Priority : 4
Echo interval : 10 seconds
Fragment size (data) : 65535
Fragment size (control) : 1450
Discovery type : Static Configuration
Retransmission count : 3
Retransmission interval : 3 seconds
Firmware upgrade : Enabled
Sent control packets : 66
Received control packets : 66
Last reboot reason : User reboot
Latest IP address : 1.2.3.3
Tunnel down reason : N/A
Connected AP count : 2
Tunnel encryption : Enabled
Tunnel-data encryption : Disabled
Table 5 Command output
Field |
Description |
Local AC ID |
ID of the local AC. It is assigned automatically by the central AC to uniquely identify a local AC on the central AC. |
State |
Local AC state: · Idle—Idle. · Join—Join. · JoinAck—Join acknowledge. · Image Download—The local AC is downloading a version. · Config—The local AC is downloading initial configuration. · Data Check—The local AC is checking data. · Run—The local AC is operating. It indicates that the local AC and the central AC have established a CAPWAP tunnel successfully. |
Online time |
Online duration of the local AC. |
System up time |
Time since the local AC started up. |
Serial ID |
Serial ID of the local AC. This field displays Not configured if it is not configured. |
MAC address |
MAC address of the local AC. This field displays Not configured if it is not configured. |
UDP port number |
Port number used by the local AC to establish the CAPWAP control tunnel. |
H/W version |
Hardware version of the local AC. |
S/W version |
Software version of the local AC. |
Boot version |
Boot version of the local AC. |
Description |
Description for the local AC. This field displays Not configured if it is not configured. |
Priority |
Local AC's connection priority configured on the central AC. |
Fragment size (data) |
Maximum fragment size for CAPWAP data packets. |
Fragment size (control) |
Maximum fragment size for CAPWAP control packets. |
Discovery type |
Central AC discovery method: · Static Configuration—The local AC uses a static IP address to discover the central AC. · Unknown. |
Firmware upgrade |
Local AC firmware upgrade: · Enabled. · Disabled. |
Sent control packets |
Control packets, including Change State Event Response, sent by the local AC in Run state. |
Received control packets |
Control packets, including Change State Event Response, received by the local AC in Run state. |
Last reboot reason |
Last local AC reboot reason: · 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 the local AC most recently used. |
Tunnel down reason |
Reason why the CAPWAP tunnel is shut down: · N/A. · 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. · Failed to come online. · Serial number changed. · MAC address changed. · Number of APs exceeded the limit. · Processed join request in Run state. · 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. · Failed to inherit configuration. |
Tunnel encryption |
Tunnel encryption: · Enabled. · Disabled. |
Tunnel-data encryption |
Data tunnel encryption: · Enabled. · Disabled. |
# Display address information about all local ACs managed by the central AC.
<Sysname> display wlan local-ac all address
Total number of local ACs: 2
Total number of connected local ACs: 2
AC name IP address MAC address
lac1 1.1.1.5 000b-6b8f-fc6a
lac2 1.1.1.6 000b-6b8f-fc7b
Table 6 Command output
Field |
Description |
IP address |
Local AC IP address. |
MAC address |
Local AC MAC address. |
display wlan local-ac (on local ACs)
Use display wlan local-ac to display local AC information on the local AC.
Syntax
display wlan local-ac
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
If you specify a central AC and enable the local AC feature, this command displays both local AC and central AC information.
Examples
# Display local AC information on the local AC.
<Sysname> display wlan local-ac
Local AC information:
Model : WA4320i-ACN
Serial ID : 219801A0CNC125002329
MAC address : 00EF-003C-0001
Local AC address : 1.1.1.55
H/W version : Ver.A
S/W version : c5419
Boot version : 1.01
Static central AC IPv4 address : 1.1.1.5
Static central AC IPv6 address : 10::1
Master central AC information:
Central AC address : 1.1.1.5
State : Run
Sent control packets : 100
Received control packets : 100
Standby central AC information:
Central AC address : 1.1.1.6
State : Run
Sent control packets : 100
Received control packets : 100
Table 7 Command output
Field |
Description |
Local AC address |
IP address of the local AC. This field displays N/A if the local AC has not established a tunnel with a central AC. |
H/W version |
Hardware version of the local AC. |
S/W version |
Software version of the local AC. |
Boot version |
BootWare version of the local AC. |
Static central AC IPv4 address |
Static IPv4 address of the central AC. This field displays Not configured if it is not configured. |
Static central AC IPv6 address |
Static IPv6 address of the central AC. This field displays Not configured if it is not configured. |
State |
Tunnel state: · Idle. · Sulking—The local AC fails to discover the central AC. · Discovery—The local AC is discovering the central AC. · Join—The local AC sends a join request to the central AC to establish the tunnel. · Image Download—The local AC is downloading a version from the central AC. · Config—The local AC is downloading initial configuration from the central AC. · Data Check—The local AC is checking data. · Run—The tunnel has been established successfully. · N/A—The local AC cannot come online for specific reasons such as local AC feature disabled. |
Sent control packets |
Number of control packets sent by the central AC in Run state. |
Received control packets |
Number of control packets received by the central in Run state. |
display wlan local-ac connection-record
Use display wlan local-ac connection-record to display local AC connection records on the central AC.
Syntax
display wlan local-ac { all | name local-ac-name } connection-record
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
all: Specifies all local ACs.
name local-ac-name: Specifies a local AC 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
Only central ACs support this command.
Examples
# Display connection records of all local ACs on the central AC.
<Sysname> display wlan local-ac all connection-record
Local AC Information
State : D = Discovery, J = Join, O = Offline, R = Run
AC name IP address State State changed at
bac 192.168.100.27 R 01-06 09:06:40
Table 8 Command output
Field |
Description |
State |
Local AC state: · D—The local AC discovered the central AC. · J—The management tunnel has been established. · O—The local AC has been disconnected from the central AC. · R—The local AC is operating. It indicates that the local AC and the central AC have established a CAPWAP tunnel successfully. |
State changed at |
Time at which the local AC entered the current state. |
display wlan local-ac files
Use display wlan local-ac files to display information about files and file folders on a local AC.
Syntax
display wlan local-ac name local-ac-name files
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
name local-ac-name: Specifies a local AC 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
Only central ACs support this command.
Examples
# Display information about files and file folders on local AC abc.
<Sysname> display wlan local-ac name abc files
Directory of flash:
0 13638656 system.bin
1 2573312 boot.bin
131072 KB total (114208 KB free)
Table 9 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. |
display wlan local-ac model
Use display wlan local-ac model to display local AC model information on the central AC.
Syntax
display wlan local-ac model { all | name model-name }
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
all: Specifies all local AC models.
name model-name: Specifies a local AC model by the model name.
Usage guidelines
Only central ACs support this command.
Examples
# Display information about local AC model WX5540E.
<Sysname> display wlan local-ac model name WX3540H
Local AC model : WX3540H
Alias : WX3540H
Vendor name : H3C
Vendor ID : 25506
Version Support List:
Hardware Version Ver.A:
Software Version : C5419
Default Software Version : C5419
Image Name : wx3540h.ipe
Hardware Version Ver.B:
Software Version : C5419
Default Software Version : C5419
Image Name : wx3540h.ipe
Hardware Version Ver.C:
Software Version : C5419
Default Software Version : C5419
Image Name : wx3540h.ipe
Hardware Version Ver.D:
Software Version : C5419
Default Software Version : C5419
Image Name : wx3540h.ipe
Hardware Version Ver.E:
Software Version : C5419
Table 10 Command output
Field |
Description |
Alias |
Alias of the local AC model. |
Version Support List |
Supported version list. |
Software Version |
Local AC' software version used to compare with the software version reported by the local AC. The default value is the local AC's software version stored in the APDB. |
Default Software Version |
Local AC's software version stored in the APDB. |
Image Name |
Name of the local AC's image file. |
display wlan local-ac online-time
Use display wlan local-ac online-time to display the online duration of an online local AC on the central AC.
Syntax
display wlan local-ac { all | name local-ac-name } online-time
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
all: Specifies all online local ACs.
name local-ac-name: Specifies an online local AC 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
Only central ACs support this command.
Examples
# Display the online duration of all online local ACs on the central AC.
<Sysname> display wlan local-ac all online-time
AC name IP address Time
bac1 1.1.1.10 1 days 2 hours 13 minutes 39 seconds
bac2 100:100:100::12 0 days 3 hours 10 minutes 20 seconds
Table 11 Command output
Field |
Description |
AC name |
Name of the local AC. |
IP address |
IP address of the local AC. |
Time |
Online duration of the local AC. |
download file
Use download file to download an image file to a local AC.
Syntax
download file filename
Views
Local AC view
Predefined user roles
network-admin
Parameters
filename: Specifies an image file by its name, a string of 1 to 255 characters.
Usage guidelines
Only central ACs support this command.
This feature takes effect only on the master central AC that has established a CAPWAP tunnel with the local AC.
Examples
# Download image file main.ipe to local AC abc.
<Sysname> system-view
[Sysname] wlan local-ac name abc
[Sysname-wlan–local-ac-abc] download file main.ipe
echo-interval
Use echo-interval to set the interval for a local AC to send echo requests to the central AC.
Use undo echo-interval to restore the default.
Syntax
echo-interval interval
undo echo-interval
Default
The interval for a local AC to send echo requests is 10 seconds.
Views
Local AC view
Predefined user roles
network-admin
Parameters
interval: Specifies the interval for sending echo requests. The value can be 0 or in the range of 5 to 255.
Usage guidelines
CAUTION: Setting the echo interval to 0 seconds disables a local AC from sending echo requests. This setting is for test use only. For correct local AC and central AC communication, do not set the echo interval to 0 seconds. |
Only central ACs support this command.
A local AC sends echo requests to the central AC at the specified echo intervals to identify whether the CAPWAP tunnel is operating correctly. If the local AC does not receive any echo responses from the AC before the keepalive timer expires, the local AC terminates the connection. If the central AC does not receive any echo requests before the keepalive timer expires, the central AC terminates the connection.
The keepalive time is the echo interval multiplied by three, the maximum number of echo request transmission attempts.
Examples
# Set the echo interval for local AC lac to 15 seconds.
<Sysname> system-view
[Sysname] wlan local-ac name lac model WX3540H
[Sysname-wlan-local-ac-lac] echo-interval 15
firmware-upgrade
Use firmware-upgrade enable to enable firmware upgrade for a local AC.
Use firmware-upgrade disable to disable firmware upgrade for a local AC.
Use undo firmware-upgrade to restore the default.
Syntax
firmware-upgrade { disable | enable }
undo firmware-upgrade
Default
Firmware upgrade is enabled.
Views
Local AC view
Predefined user roles
network-admin
Usage guidelines
Only central ACs support this command.
This feature enables the central AC to examine the software version of a local AC while establishing a CAPWAP tunnel with the local AC. The local AC upgrades its firmware if it uses a different software version from the version stored in the APDB and then establishes a CAPWAP tunnel with the central AC. When this feature is disabled, the central AC does not examine the software version of the local AC and directly establishes a CAPWAP tunnel with the local AC.
Examples
# Enable firmware upgrade for local AC lac.
<Sysname> system-view
[Sysname] wlan local-ac name lac model WX3540H
[Sysname-wlan-local-ac-lac] firmware-upgrade enable
location (AP group view)
Use location to assign a location identifier to an AP group.
Use undo location to restore the default.
Syntax
location location-name
undo location
Default
The default location identifier default-location is assigned to an AP group.
Views
AP group view
Predefined user roles
network-admin
Parameters
location-name: Specifies a location identifier, a case-insensitive string of 1 to 31 characters. It can contain letters, digits, underscores (_), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Usage guidelines
After you assign a location identifier to an AP group, the AP group will be assigned to that location.
An administrator can view and manage only an AP group whose location identifier is accessible to his user role when he logs in to the central AC from the CLI and the Web interface.
Examples
# Assign location identifier area1 to AP group g1.
<Sysname> system-view
[Sysname] wlan ap-group g1
[Sysname-wlan-ap-group-g1] location area1
Related commands
wlan location
location (RRM holddown group view)
Use location to assign a location identifier to an RRM holddown group.
Use undo location to restore the default.
Syntax
location location-name
undo location
Default
The default location identifier default-location is assigned to an RRM holddown group.
Views
RRM holddown group view
Predefined user roles
network-admin
Parameters
location-name: Specifies a location identifier, a case-insensitive string of 1 to 31 characters. It can contain letters, digits, underscores (_), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Usage guidelines
After you assign a location identifier to an RRM holddown group, the RRM holddown group will be assigned to that location.
An administrator can view and manage only an RRM holddown group whose location identifier is accessible to his or her user role when the administrator logs in to the central AC from the CLI and the Web interface.
Examples
# Assign location identifier area1 to RRM holddown group 1.
<Sysname> system-view
[Sysname] wlan rrm-calibration-group 1
[Sysname-wlan-rrm-calibration-group-1] location area1
Related commands
wlan location
location (service template view)
Use location to assign a location identifier to a service template.
Use undo location to restore the default.
Syntax
location location-name
undo location
Default
The default location identifier default-location is assigned to a service template.
Views
Service template view
Predefined user roles
network-admin
Parameters
location-name: Specifies a location identifier, a case-insensitive string of 1 to 31 characters. It can contain letters, digits, underscores (_), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Usage guidelines
After you assign a location identifier to a service template, the service template will be assigned to that location.
An administrator can view and manage only a service template whose location identifier is accessible to his user role when he logs in to the central AC from the CLI and the Web interface.
Examples
# Assign location identifier area1 to service template 1.
<Sysname> system-view
[Sysname] wlan service-template service1
[Sysname-wlan-st-service1] location area1
Related commands
wlan location
priority
Use priority to set the priority for tunnel establishment to a local AC.
Use undo priority to restore the default.
Syntax
priority priority
undo priority
Default
The priority for tunnel establishment to a local AC is 4.
Views
Local AC view
Predefined user roles
network-admin
Parameters
priority: Specifies the tunnel establishment priority in the range of 0 to 7. A greater value represents a higher connection priority.
Usage guidelines
Only central ACs support this command.
A local AC prefers to establish a CAPWAP tunnel with a central AC that has higher priority.
The configuration takes effect only before tunnel establishment between the central AC and a local AC.
Examples
# Set the priority to 7 for tunnel establishment to a local AC.
<Sysname> system-view
[Sysname] wlan local-ac name lac model WX5510E
[Sysname-wlan-local-ac-lac] priority 7
Related commands
retransmit-interval
reset wlan local-ac
Use reset wlan local-ac to reboot the specified local AC or all local ACs.
Syntax
reset wlan local-ac { all | name ac-name }
Views
User view
Predefined user roles
network-admin
Parameters
all: Specifies all local ACs.
name ac-name: Specifies the name of a local AC, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), righ brackets (]), forward slashes (/), and hyphens (-).
Usage guidelines
Only central ACs support this command.
Rebooting a local AC logs off all the online APs associated with the local AC. If the central AC has other connected local ACs, the offline APs will come online again from these local ACs.
Examples
# Reboot local AC local-ac1.
<Sysname> reset wlan local-ac name local-ac1
Related commands
wlan local-ac name
retransmit-count
Use retransmit-count to set the maximum number of the central AC's request retransmission attempts.
Use undo retransmit-count to restore the default.
Syntax
retransmit-count value
undo retransmit-count
Default
The maximum number of the central AC's request retransmission attempts is 3.
Views
Local AC view
Predefined user roles
network-admin
Parameters
value: Specifies the maximum number of the central AC's request retransmission attempts, in the range of 2 to 5.
Usage guidelines
Only central ACs support this command.
The central AC sends a request to a local AC at the retransmission interval until the maximum number of request retransmission attempts is reached or a response is received.
Examples
# Set the maximum number of central AC request retransmission attempts to 4 for local AC lac.
<Sysname> system-view
[Sysname] wlan local-ac name lac model WX3540H
[Sysname-wlan-local-ac-lac] retransmit-count 4
Related commands
retransmit-interval
retransmit-interval
Use retransmit-interval to set the request retransmission interval for the central AC to retransmit requests to a local AC.
Use undo retransmit-interval to restore the default.
Syntax
retransmit-interval interval
undo retransmit-interval
Default
The request retransmission interval is 5 seconds.
Views
Local AC view
Predefined user roles
network-admin
Parameters
interval: Specifies the request retransmission interval in the range of 3 to 8 seconds.
Usage guidelines
Only central ACs support this command.
The central AC sends a request to a local AC at the retransmission interval until the maximum number of request retransmission attempts is reached or a response is received.
Examples
# Set the request retransmission interval to 6 seconds for the central AC to send requests to local AC lac.
<Sysname> system-view
[Sysname] wlan local-ac name lac model WX3540H
[Sysname-wlan-local-ac-lac] retransmit-interval 6
Related commands
retransmit-count
roam central-ac-auth enable
Use roam central-ac-auth enable to enable client roaming when the central AC acts as the authenticator.
Use undo roam central-ac-auth enable to disable client roaming when the central AC acts as the authenticator.
Syntax
roam central-ac-auth enable
undo roam central-ac-auth enable
Default
Client roaming is enabled when the central AC acts as the authenticator.
Views
Service template view
Predefined user roles
network-admin
Usage guidelines
Only central ACs support this command.
In AC hierarchy network, clients cannot perform inter- or intra-local AC roaming when the central AC acts as the authenticator because roaming entries are generated only on the central AC. Perform this task to enable local ACs to generate roaming entries when the central AC is specified as the authenticator and enable clients to perform roaming.
When the central AC acts as the authenticator, RSN + 802.1X clients cannot perform fast roaming even if this feature is enabled.
Make sure the service template is disabled before you execute this command.
Examples
# Enable client roaming when the central AC acts as the authenticator.
<Sysname> system-view
[Sysname] wlan service-template service1
[Sysname-wlan-st-service1] roam central-ac-auth enable
serial-id
Use serial-id to specify the serial ID for a local AC on the central AC.
Use undo serial-id to restore the default.
Syntax
serial-id serial-id
undo serial-id
Default
No serial ID is specified for a local AC.
Views
Local AC view
Predefined user roles
network-admin
Parameters
serial-id: Specifies a serial ID that can uniquely identify a local AC, a case-insensitive string of 1 to 63 characters.
Usage guidelines
Only central ACs support this command.
Changing or deleting the serial ID of a local AC terminates the CAPWAP tunnel if the local AC has established a CAPWAP tunnel with the central AC. The local AC must reestablish a CAPWAP tunnel with the central AC.
Examples
# Specify the serial ID of local AC lac as 210235A1BSC123000050.
<Sysname> system-view
[Sysname] wlan local-ac name lac model WX3540H
[Sysname-local-ac-lac] serial-id 210235A1BSC123000050
Related commands
wlan local-ac
wlan central-ac
Use wlan central-ac to specify a central AC for a local AC.
Use undo wlan central-ac to delete an IP address of a central AC.
Syntax
wlan central-ac { ip ipv4-address | ipv6 ipv6-address }
undo wlan central-ac { ip [ ipv4-address ] | ipv6 [ ipv6-address ] }
Default
No central AC is specified for a local AC.
Views
System view
Predefined user roles
network-admin
Parameters
ip ipv4-address: Specifies an IPv4 address of a central AC.
ipv6 ipv6-address: Specifies an IPv6 address of a central AC.
Usage guidelines
Only local ACs support this command.
You can specify a maximum of three IPv4 addresses and three IPv6 addresses.
If you do not specify any keywords when executing the undo command, the command deletes all IP addresses.
Examples
# Specify the central AC with IP address 192.168.100.11 for the local AC.
<Sysname> system-view
[Sysname] wlan central-ac ip 192.168.100.11
wlan local-ac
Use wlan local-ac to create a local AC and enter its view, or enter the view of an existing local AC.
Use undo wlan local-ac to delete a local AC.
Syntax
wlan local-ac name local-ac-name [ model model-name ]
undo wlan local-ac name local-ac-name
Default
No local AC exists.
Views
System view
Predefined user roles
network-admin
Parameters
name local-ac-name: Specifies the local AC name, a case-sensitive string of 1 to 64 characters.
model model-name: Specifies the local AC model. You must specify this option when you create a local AC.
Usage guidelines
Only common ACs and central ACs support this command.
Common ACs that cannot act as central ACs do not support this command.
If you execute this command on a common AC, the command creates a local AC and changes the role of the common AC to central.
Deleting the last local AC on a central AC changes the role of the central AC to common.
For the central AC to send the IP address of the local AC that has the lowest workload to an AP, enable AC rediscovery. For more information about AC rediscovery, see WLAN Configuration Guide.
Examples
# Create local AC lac and enter its view.
<Sysname> system-view
[Sysname] wlan local-ac name lac model WX3540H
[Sysname-wlan-local-ac-lac]
control-address enable
serial-id
wlan local-ac capwap source-vlan
Use wlan local-ac capwap source-vlan to specify a VLAN that the local AC uses to establish a tunnel with the central AC.
Use undo wlan local-ac capwap source-vlan to restore the default.
Syntax
wlan local-ac capwap source-vlan vlan-id
undo wlan local-ac capwap source-vlan
Default
A local AC uses VLAN 1 to establish a tunnel with the central AC.
Views
System view
Predefined user roles
network-admin
Parameters
vlan-id: Specifies a VLAN ID in the range of 1 to 4094.
Usage guidelines
Only local ACs support this command.
Examples
# Configure the local AC to use VLAN 2 to establish a tunnel with the central AC.
<Sysname> system-view
[Sysname] wlan local-ac capwap source-vlan 2
wlan local-ac enable
Use wlan local-ac enable to enable the local AC feature.
Use undo wlan local-ac enable to disable the local AC feature.
Syntax
wlan local-ac enable
undo wlan local-ac enable
Default
The local AC feature is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
Only common ACs and local ACs support this command.
Common ACs that cannot act as central ACs do not support this command.
After you enable the local AC feature on the AC and specify a central AC, the AC acts as a local AC to establish a CAPWAP tunnel with the central AC.
The undo command terminates the CAPWAP tunnel between the local AC and the central AC.
Examples
# Enable the local AC feature.
<Sysname> system-view
[Sysname] wlan local-ac enable
wlan location
Use wlan location to create a location identifier.
Use undo wlan location to delete a location identifier.
Syntax
wlan location location-name
undo wlan location location-name
Default
The default location identifier default-location exists.
Views
System view
Predefined user roles
network-admin
Parameters
location-name: Specifies a location identifier, a case-insensitive string of 1 to 31 characters. It can contain letters, digits, underscores (_), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Usage guidelines
The default location identifier is accessible to all user roles and cannot be deleted.
You can create a maximum of 512 location identifiers.
Examples
# Create location identifier area1.
<Sysname> system-view
[Sysname] wlan location area1
wlan tunnel-preempt
Use wlan tunnel-preempt enable to enable master CAPWAP tunnel preemption.
Use wlan tunnel-preempt disable to disable master CAPWAP tunnel preemption.
Use undo wlan tunnel-preempt to restore the default.
Syntax
wlan tunnel-preempt { disable | enable }
undo wlan tunnel-preempt
Default
Master CAPWAP tunnel preemption is disabled.
Views
Local AC view
Predefined user roles
network-admin
Usage guidelines
Only central ACs support this command.
By default, the backup central AC becomes the master central AC and takes over services only when the master central AC fails. This feature enables the backup central AC to become the master central AC as long as the backup AC has a higher priority.
Examples
# Enable master CAPWAP tunnel preemption for local AC bac.
<Sysname> system-view
[Sysname] wlan local-ac name bac
[Sysname-wlan-local-ac-bac] wlan tunnel-preempt enable