12-WLAN Advanced Features Command Reference

HomeSupportResource CenterH3C Access Controllers Command References(R5426P02)-6W10412-WLAN Advanced Features Command Reference
08-AC hierarchy commands
Title Size Download
08-AC hierarchy commands 166.13 KB

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

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]

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

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