Table of Contents

Related Documents

09-AC hierarchy commands

Title	Size	Download
09-AC hierarchy commands	160.05 KB

AC hierarchy commands

The WBC series access controllers and access controller modules do not support parameters or commands that are available only in IRF mode.

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.

Field

Description

Current AC role

AC role:

· Common.

· Central AC.

· Local AC.

· Unknown.

‌

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.

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: · Roaming in progress. · Inter-AC slow roaming. · Inter-AC fast roaming. · Intra-AC slow roaming. · Intra-AC fast 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 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 7 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.

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

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 8 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.

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 9 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 10 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.

To avoid configuration loss on the local AC, execute the save command on the local AC before configuring firmware upgrade.

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

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

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 ([), right 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

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

switch-back (on central ACs)

Use switch-back enable to enable automatic switch-back after a local-central AC switchover.

Use switch-back disable to disable automatic switch-back after a local-central AC switchover.

Use undo switch-back to restore the default.

Syntax

switch-back { disable | enable }

undo switch-back

Default

In AP view, an AP uses the configuration in AP group view.

In AP group view, automatic switch-back after a local-central AC switchover is disabled.

Views

AP view

AP group view

Predefined user roles

network-admin

Usage guidelines

Only central ACs support this command.

In an AC hierarchy network, after a local AC fails, its associated APs come online from the central AC to ensure service continuity. These APs remain associated with the central AC even if the local AC recovers, which increases the central AC's workload and affects its performance. You can manually switch these APs back to the local AC, but this operation is time consuming and might affect network operation.

To resolve this issue, enable automatic switch-back on the central AC to allow specific APs to automatically switch back to their recovered local ACs.

Examples

# Enable automatic switch-back after a local-central AC switchover for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA6320

[Sysname-wlan-ap-ap1] switch-back enable

# Enable automatic switch-back after a local-central AC switchover for APs in AP group 10.

<Sysname> system-view

[Sysname] wlan ap-group 10

[Sysname-ap-group-10] switch-back enable

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 ] }

The following compatibility matrixes show the support of hardware platforms for this command:

Hardware series	Model	Product code	Local AC role compatibility	Central AC role compatibility
WBC series	WBC580 G2	EWP-WBC580-G2-GL	No	Yes

‌

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 managing APs in AP and WT Management 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]

Related commands

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

The following compatibility matrixes show the support of hardware platforms for this command:

Hardware series	Model	Product code	Local AC role compatibility	Central AC role compatibility
WBC series	WBC580 G2	EWP-WBC580-G2-GL	No	Yes

‌

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

The following compatibility matrixes show the support of hardware platforms for this command:

Hardware series	Model	Product code	Local AC role compatibility	Central AC role compatibility
WBC series	WBC580 G2	EWP-WBC580-G2-GL	No	Yes

‌

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

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

12-WLAN Advanced Features Command Reference

location (AP group view)

wlan local-ac capwap source-vlan

wlan location

Cloud & AI

InterConnect

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Resources

Partner Business Management

Company Information

News & Events

Contact Us