AP management commands -- ac

Use ac to specify an AC for an AP.

Use undo ac to delete the specified AC information.

Syntax

ac { host-name hostname | ip ipv4-address | ipv6 ipv6-address }

undo ac { host-name | ip [ ipv4-address ] | ipv6 [ ipv6-address ] }

Default

No AC is specified for an AP.

Views

AP provision view

AP group provision view

Predefined user roles

network-admin

mdc-admin

Parameters

host-name host-name: Specifies an AC by its host name, a case-insensitive string of 1 to 253 characters. The string can contain letters, digits, hyphens (-), underscores (_), and dots (.).

ip ipv4-address: Specifies an AC by its IPv4 address.

ipv6 ipv6-address: Specifies an AC by its IPv6 address.

Usage guidelines

You can configure a maximum of three AC IPv4 addresses, three AC IPv6 addresses, and only one host name. If you configure multiple host names, the most recent configuration takes effect.

The configuration in AP provision view takes effect only on the AP. The configuration in AP group provision view takes effect on all APs in the AP group.

The configuration in AP provision view takes precedence over the configuration in AP group provision view.

The undo form of the command deletes all AC IPv4 or IPv6 addresses if you do not specify the ipv4-address or the ipv6-address argument.

Examples

# Specify the AC whose IP address is 192.168.100.11 for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] provision

[Sysname-wlan-ap-ap1-prvs] ac ip 192.168.100.11

# Specify the AC whose IP address is 192.168.100.11 for APs in AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] provision

[Sysname-wlan-ap-group-group1-prvs] ac ip 192.168.100.11

AP management commands -- ap

Use ap to create an AP grouping rule by AP names.

Use undo ap to delete an AP grouping rule by AP names.

Syntax

ap ap-name-list

undo ap ap-name-list

Default

No AP grouping rules by AP names exist.

Views

AP group view

Predefined user roles

network-admin

mdc-admin

Parameters

ap-name-list: Specifies a maximum of 10 space-separated AP names. An AP name is a case-insensitive string of 1 to 64 characters that can contain letters, digits, underscores (_), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

Usage guidelines

This command does not identify whether the specified AP exists.

The priorities of AP grouping rules by AP names, serial IDs, MAC addresses, and IP addresses are in descending order. If an AP does not match any grouping rules, it is added to the default AP group.

If the created AP grouping rule already exists in another AP group, this command deletes the rule from that AP group.

You cannot execute this command in the view of the default AP group.

Examples

# Create an AP grouping rule by AP names to add APs ap1, ap2, and ap3 to AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] ap ap1 ap2 ap3

Related commands

wlan ap-group

AP management commands -- ap-model

Use ap-model to create an AP model and enter its view, or enter the view of an existing AP model.

Use undo ap-model to remove an AP model and its configuration.

Syntax

ap-model ap-model

undo ap-model ap-model

Default

No AP models exist.

Views

AP group view

Predefined user roles

network-admin

mdc-admin

Parameters

ap-model: Specifies an AP model name.

Examples

# Create an AP model named WA4320i-ACN and enter its view.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] ap-model WA4320i-ACN

[Sysname-wlan-ap-group-group1-apmodel-WA4320i-ACN]

AP management commands -- description (AP group view)

Use description to configure a description for an AP group.

Use undo description to restore the default.

Syntax

description text

undo description

Default

An AP group does not have a description.

Views

AP group view

Predefined user roles

network-admin

mdc-admin

Parameters

text: Specifies a description, a case-sensitive string of 1 to 64 characters.

Examples

# Configure a description for AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-ap-group-group1] description L3-office

Related commands

display wlan ap-group

wlan ap-group

AP management commands -- description (AP view)

Use description to configure a description for an AP.

Use undo description to restore the default.

Syntax

description text

undo description

Default

An AP does not have a description.

Views

AP view

Predefined user roles

network-admin

mdc-admin

Parameters

text: Specifies a description, a case-sensitive string of 1 to 64 characters.

Examples

# Configure a description for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-ap-ap1] description L3-office

Related commands

display wlan ap

AP management commands -- display wlan ap

Use display wlan ap to display information about all APs or the specified AP.

Syntax

display wlan ap { all | name ap-name } [ radio | verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

all: Specifies all APs.

name ap-name: Specifies an AP by its name, a case-insensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

radio: Displays radio information.

verbose: Displays detailed information.

Examples

# Display information about all APs.

<Sysname> display wlan ap all

Total number of APs: 1

Total number of connected APs: 1

Total number of connected configured APs: 1

Total number of connected auto APs: 0

Total number of connected anchor APs: 0

Total number of connected anchor APs: 0

Maximum supported APs: 3072

Remaining APs: 3071

Fit APs activated by license: 128

Remaining fit APs: 127

WTUs activated by license: 0

Remaining WTUs: 0

AP information

State : I = Idle, J = Join, JA = JoinAck, IL = ImageLoad

C = Config, DC = DataCheck, R = Run M = Master, B = Backup

AP name AP ID State Model Serial ID

--------------------------------------------------------------------------------

ap1 1 I WA4320i-ACN 210235A1BSC123000050

Table 1 Command output

Field | Description
Total number of APs | Total number of fit APs, WTs, and WTUs.
Total number of connected APs | Total number of connected fit APs, WTs, and WTUs.
Total number of connected configured APs | Total number of connected manual fit APs, WTs, and WTUs.
Total number of connected auto APs | Total number of connected auto fit APs, WTs, and WTUs.
Maximum supported APs | Maximum of number of APs supported by the AC, including fit APs, WTs, and WTUs.
AP ID | ID of the AP to uniquely identify the AP on the AC.
State | Current state of the AP: · I—Idle. · J—Join. · JA—Join acknowledge. · IL—The AP is downloading the version. · C—The AP is downloading initial configurations. · DC—The AP is checking data. · R—The CAPWAP tunnel is operating. It indicates that the AP and the AC have established a CAPWAP tunnel. · R/M—The master CAPWAP tunnel is operating. It indicates that the AP and the master AC have established a CAPWAP tunnel. · R/B—The backup CAPWAP tunnel is operating. It indicates that the AP and the backup AC have established a CAPWAP tunnel. · M—The AP is connected to the master AC. · B—The AP is connected to the backup AC.
Serial ID | Serial ID of the AP. This field displays Not configured if the serial ID of the AP is not configured.

# Display detailed information about AP ap1.

<Sysname> display wlan ap name ap1 verbose

AP name : ap1

AP ID : 1

AP group name : default-group

State : Run

Backup Type : Master

Online time : 0 days 1 hours 25 minutes 12 seconds

System up time : 0 days 2 hours 22 minutes 12 seconds

Model : WA4320i-ACN

Region code : CN

Region code lock : Disable

Serial ID : 219801A0CNC138011454

MAC address : 0AFB-423B-893C

IP address : 192.168.1.50

H/W version : Ver.C

S/W version : V700R001B49D001

Boot version : 1.01

Description : wtp1

Priority : 4

Echo interval : 10 seconds

Statistics report interval : 50 seconds

Jumbo frame value : Disabled

MAC type : Local MAC & Split MAC

Tunnel mode : Local Bridging & 802.3 Frame & Native Frame

Discovery type : Static Configuration

Retransmission count : 3

Retransmission interval : 5 seconds

Firmware upgrade : Enabled

Sent control packets : 1

Received control packets : 1

Connection count : 1

Backup Ipv4 : Not configured

Backup Ipv6 : Not configured

Tunnel encryption : Disabled

LED mode : Normal

Radio 1:

Basic BSSID : 7848-59f6-3940

Admin state : Up

Radio type : 802.11ac

Antenna type : internal

Client dot11ac-only : Disabled

Client dot11n-only : Disabled

Channel band-width : 20/40/80MHz

Secondary channel offset : SCB

Short GI for 20MHz : Supported

Short GI for 40MHz : Supported

Short GI for 80MHz : Supported

Short GI for 160MHz : Not supported

A-MSDU : Enabled

A-MPDU : Enabled

LDPC : Not Supported

STBC : Supported

Operational VHT-MCS Set:

Mandatory : Not configured

Supported : NSS1 0,1,2,3,4,5,6,7,8,9

NSS2 0,1,2,3,4,5,6,7,8,9

Multicast : Not configured

Operational HT MCS Set:

Mandatory : Not configured

Supported : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9,

10, 11, 12, 13, 14, 15

Multicast : Not configured

Channel : 44(auto)

Max power : 20 dBm

Operational rate:

Mandatory : 6, 12, 24 Mbps

Multicast : Auto

Supported : 9, 18, 36, 48, 54 Mbps

Disabled : Not configured

Distance : 1 km

ANI : Enabled

Fragmentation threshold : 2346 bytes

Beacon interval : 100 TU

Protection threshold : 2346 bytes

Long retry threshold : 4

Short retry threshold : 7

Maximum rx duration : 2000 ms

Noise Floor : 5 dBm

Smart antenna : Enabled

Smart antenna policy : Auto

Radio 2:

Basic BSSID : 7848-59f6-3950

Admin state : Down

Radio type : 802.11b

Antenna type : internal

Client dot11n-only : Disabled

Channel band-width : 20MHz

Secondary channel offset : SCN

Short GI for 20MHz : Supported

Short GI for 40MHz : Supported

A-MSDU : Enabled

A-MPDU : Enabled

LDPC : Not Supported

STBC : Supported

Operational HT MCS Set:

Mandatory : Not configured

Supported : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9,

10, 11, 12, 13, 14, 15

Multicast : Not configured

Channel : 5(auto)

Max power : 20 dBm

Preamble type : Short

Operational rate:

Mandatory : 1, 2, 5.5, 11 Mbps

Multicast : Auto

Supported : 6, 9, 12, 18, 24, 36, 48, 54 Mbps

Disabled : Not configured

Distance : 1 km

ANI : Enabled

Fragmentation threshold : 2346 bytes

Beacon interval : 100 TU

Protection threshold : 2346 bytes

Long retry threshold : 4

Short retry threshold : 7

Maximum rx duration : 2000 ms

Noise Floor : 5 dBm

Smart antenna : Enabled

Smart antenna policy : Auto

Table 2 Command output

Field | Description
State | Current state of the AP: · Idle—Idle. · Join—Join. · JoinAck—Join acknowledge. · Image—The AP is downloading the version. · Config—The AP is downloading initial configurations. · Data Check—The AP is checking data. · Run—The CAPWAP tunnel is operating. It indicates that the AP and the AC have established a CAPWAP tunnel. · R/M—The master CAPWAP tunnel is operating. It indicates that the AP and the master AC have established a CAPWAP tunnel. · R/B—The backup CAPWAP tunnel is operating. It indicates that the AP and the backup AC have established a CAPWAP tunnel. · M—The AP is connected to the master AC. · B—The AP is connected to the backup AC.
Backup Type | CAPWAP tunnel type: · Idle—The AP has not established a CAPWAP tunnel with the AC. · Master—A CAPWAP tunnel has been established between the AP and the master AC. · Backup—A CAPWAP tunnel has been established between the AP and the backup AC.
Region code lock | Region code lock: Enable or Disable.
Serial ID | Serial ID of the AP. If no serial ID is configured, this field displays Not configured.
MAC address | MAC address of the AP. If no MAC address is configured, this field displays Not configured.
H/W version | Hardware version of the AP.
S/W version | Software version of the AP.
Description | Description for the AP. If no description is configured, this field displays Not configured.
Priority | AP connection priority for the AC.
Jumbo frame value | Maximum length of jumbo frames. If no jumbo frame length is configured, this field displays Disabled.
MAC type | MAC type of the AP-AC connection: · Local MAC—The AP encapsulates frames in 802.3 format before sending them to the AC. · Split MAC—The AP encapsulates frames in 802.11 format before sending them to the AC. · Local & Split MAC—The AP can encapsulate frames in either 802.3 format or 802.11 format before sending them to the AC.
Tunnel mode | Supported tunnel mode of the AP: · Local Bridging—The AP supports local bridging and does not forward data to the AC. · 802.3 Frame—The AP encapsulates the frames in 802.3 format to send to the AC. · Native Frame—The AP encapsulates the frames in 802.11 format to send to the AC. · Local Bridging & 802.3 Frame—The AP supports the Local Bridging mode and the 802.3 Frame mode. · 802.3 Frame & Native Frame—The AP supports the 802.3 Frame mode and the Native Frame mode. · Local Bridging & Native Frame—The AP supports the Local Bridging mode and the Native Frame mode.
Discovery type | Discovery type of the AP: · Static Configuration—The AP uses the configured static IPv4 or IPv6 address of the AC. · DHCP—The AP gets the IP address of an AC through DHCP. · DNS—The AP gets the IP address of an AC through DNS. · Unknown.
Retransmission count | Number of retransmission attempts for an AC request.
Retransmission interval | Interval at which AC requests can be retransmitted.
Firmware upgrade | AP firmware upgrade: Enabled or Disabled.
Sent control packets | Number of sent packets after the AC enters Run state. The Change State Event Response packets are included.
Received control packets | Number of received packets after the AC enters Run state. The Change State Event Response packets are included.
Connection count | Number of times that the AP connects to the AC. It is cleared in either one of the following cases: · The AC reboots. · The serial ID of the AP changes. The reset wlan ap command does not clear the connection count.
Backup Ipv4 | IPv4 address of the backup AC. If no backup AC is specified, this field displays Not configured.
Backup Ipv6 | IPv6 address of the backup AC. If no backup AC is specified, this field displays Not configured.
Tunnel encryption | Tunnel encryption: Enabled or Disabled.
LED mode | LED lighting mode: · quiet—All LEDs are off. · awake—All LEDs flash once every minute. · always-on—All LEDs are steady on. · normal—How LEDs flash in this mode varies by AP model.
Basic BSSID | MAC address of the radio. This field displays N/A if the AP does not establish a CAPWAP tunnel with the AC.
Admin state | Radio state: Up or Down.
Radio type | Wireless mode: · 5 GHz: ?span style='font:7.0pt "Times New Roman"'> 802.11a. ?span style='font:7.0pt "Times New Roman"'> 802.11n(5GHz). ?span style='font:7.0pt "Times New Roman"'> 802.11ac. · 2.4 GHz: ?span style='font:7.0pt "Times New Roman"'> 802.11b. ?span style='font:7.0pt "Times New Roman"'> 802.11g. ?span style='font:7.0pt "Times New Roman"'> 802.11n(2.4GHz).
Client dot11ac-only | Client dot11ac-only: · Disabled—Allows 802.11a/b/g/n/ac clients to associate with the radio. · Enabled—Allows only 802.11ac clients to associate with the radio.
Client dot11n-only | Client dot11n-only: · Disabled—Allows 802.11a/b/g/n/ac clients to associate with the radio. · Enabled—Allows only 802.11n or 802.11ac clients to associate with the radio.
Channel band-width | Channel bandwidth: 20 MHz, 20 or 40 MHz, or 20/40/80 MHz.
Secondary channel offset | Secondary channel information for the 802.11n and 802.11ac radio mode: · SCA (Second Channel Above)—The AP operates in 40 MHz bandwidth mode, and the secondary channel is above the primary channel. · SCB (Second Channel Below)—The AP operates in 40 MHz bandwidth mode, and the secondary channel is below the primary channel. · SCN—The AP does not operate in 40 MHz bandwidth mode.
Short GI for 20MHz | Whether the radio supports short GI when it operates in 20 MHz mode.
Short GI for 40MHz | Whether the radio supports short GI when it operates in 40 MHz mode.
Short GI for 80MHz | Whether the radio supports short GI when it operates in 80 MHz mode.
Short GI for 160MHz | Whether the radio supports short GI when it operates in 160 MHz mode.
A-MSDU | A-MSDU: Disabled or Enabled.
A-MPDU | A-MPDU: Disabled or Enabled.
LDPC | LDPC: Supported or Not supported.
STBC | STBC: Supported or Not supported.
Operational VHT MCS Set | Operational VHT MCS Set: · Supported—Supported VHT MCS set. · Mandatory—Mandatory VHT MCS set. · Multicast—Multicast VHT MCS set.
Operational HT MCS Set | Operational HT MCS Set: · Supported—Supported MCS set. · Mandatory—Mandatory MCS set. · Multicast—Multicast MCS set.
Channel | This field displays Number<auto> if the current channel is the optimal channel automatically selected by the AP. This field displays Number if the current channel is manually configured. This field displays Number<avoid radar> if the current channel is automatically selected by the AP to avoid radar signals.
Max power | Maximum transmission power of the radio.
Preamble type | Preamble type: Short or Long.
Operational rate | Preamble type: Mandatory, Supported, Multicast, Disabled, or Not configured.
Distance | Maximum distance that the radio signal can reach.
ANI | ANI: Enabled or Disabled.
Protection threshold | Frame length threshold required for triggering the protection mechanism.
Long retry threshold | Maximum number of retransmission attempts for frames whose length exceeds the RTS threshold.
Short retry threshold | Maximum number of retransmission attempts for frames whose length is below the RTS threshold.
Maximum rx duration | Maximum buffer duration for frames.
Smart antenna | Smart antenna: Enabled or Disabled.
Smart antenna policy | Smart antenna policy: Auto, High availability, or High throughput.

# Display radio information for all APs.

<Sysname> display wlan ap all radio

Total number of APs: 1

Total number of connected APs: 1

Total number of connected configured Aps: 1

Total number of connected auto APs: 600

Total number of connected anchor APs: 599

Maximum AP capacity: 0

Remaining AP capacity: 0

AP name Radio ID Channel Tx power Ant gain EIRP

(dBm) (dBi) (dBm)

ap1 1 64(auto) 20 10 30

ap1 2 6(auto) 20 10 30

# Display radio information for AP ap1.

<Sysname> display wlan ap name ap1 radio

AP name Radio ID Channel Tx power Ant gain EIRP

(dBm) (dBi) (dBm)

ap1 1 64(auto) 20 10 30

ap1 2 6(auto) 20 10 30

Table 3 Command output

Field | Description
Channel | Channel where the radio is operating.
Tx power (dBm) | Transmission power of the radio. By default, it is the maximum power.
Ant gain (dBi) | Antenna gain.
EIRP (dBm) | Effective Isotropic Radiated Power.

AP management commands -- display wlan ap reboot-log

Use display wlan ap reboot-log to display reboot logs for an AP.

Syntax

display wlan ap reboot-log name ap-name

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

name ap-name: Specifies an AP by its name, a case-insensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

Usage guidelines

If the AP has suffered a system crash, you can use this command to view detailed information about the crash.

To use this command, make sure the specified AP is in Run state.

Examples

# Display reboot logs for AP ap1.

<Sysname> display wlan ap reboot-log name ap1

Debugging information is not available on the AC.

Downloading debugging data from AP. Continue? [Y/N]:y

Downloading debugging data. Please wait...

Please enter the same command again to view the log messages.

Related commands

reset wlan ap reboot-log

AP management commands -- display wlan ap running-configuration

Use display wlan ap running-configuration to display running configuration for the specified AP or all APs.

Syntax

display wlan ap running-configuration { all | ap-name ap-name } [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

all: Specifies all APs.

ap-name ap-name: Specifies an AP by its name, a case-insensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

verbose: Displays detailed running configuration.

Examples

# Display detailed running configuration for all APs.

<Sysname> display wlan ap running-configuration all verbose

(i) -- Inherited from AP group

(g) -- Inherited from AP gloabl-configuration

#

wlan ap ap1 model WA4320i-ACN id 5

ap group name 1

serialid

region code 156

echo interval 10 (i)

retransmission count 3 (i)

retransmission interval 5 (i)

statistics interval 50 (i)

jumbo frame 1500 (i)

firmware update 1

priority 4 (i)

…

radio 1

radio type 802.11ac (i)

radio disable (i)

channel auto<64> (i)

channel unlock (i)

max-power 20 (i)

power unlock (i)

distance 1 kilometer (i)

ANI Enabled (i)

…

radio 2

radio type 802.11n(2.4GHz) (i)

radio disable (i)

channel auto<11> (i)

channel unlock (i)

max-power 20 (i)

power unlock (i)

distance 1 kilometer (i)

ANI Enabled (i)

…

#

wlan ap ap2 model WA4320i-ACN id 6

ap group name 2

serialid

region code 156

echo interval 10 (i)

retransmission count 3 (i)

retransmission interval 5 (i)

statistics interval 50 (i)

jumbo frame 1500 (i)

firmware update 1

priority 4 (i)

…

radio 1

radio type 802.11ac (i)

radio disable (i)

channel auto<60> (i)

channel unlock (i)

max-power 20 (i)

power unlock (i)

distance 1 kilometer (i)

ANI Enabled (i)

…

radio 2

radio type 802.11n(2.4GHz) (i)

radio disable (i)

channel auto<13> (i)

channel unlock (i)

max-power 20 (i)

power unlock (i)

distance 1 kilometer (i)

ANI Enabled (i)

…

AP management commands -- display wlan ap-group

Use display wlan ap-group to display information about all AP groups or the specified AP group.

Syntax

display wlan ap-group [ group-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

ap-group group-name: Specifies an AP group by its name, a case-insensitive string of 1 to 31 characters. If you do not specify this option, the command displays information about all AP groups.

Examples

# Display information about all AP groups.

<Sysname> display wlan ap-group

AP group name : default-group

Description : Not configured

AP model : Not configured

APs : Not configured

AP group name : group1

Description : abcd

AP model : WA4320i-ACN

AP grouping rules:

AP name : ap1, ap2

Serial ID : 123456789, 2345678

MAC address : 0012-2233-4455, 1112-3344-5566

IPv4 address : Not configured

IPv6 address : Not configured

APs : ap1 (AP name)

# Display information about AP group group1.

<Sysname> display wlan ap-group group1

AP group name : group1

Description : Not configured

AP model : WA4320i-ACN

AP grouping rules:

AP name : ap1, ap2

Serial ID : 123456789, 2345678

MAC address : 0012-2233-4455, 1112-3344-5566

IPv4 address : Not configured

IPv6 address : Not configured

APs : ap1 (AP name)

Related commands

wlan ap-group

AP management commands -- display wlan ap-model

Use display wlan ap-model to display AP model information.

Syntax

display wlan ap-model { all | name model-name }

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

all: Specifies all AP models.

name model-name: Specifies an AP model by its name.

Examples

# Display information about AP model WA4320i-ACN.

<Sysname> display wlan ap-model name WA4320i-ACN

AP model : WA4320i-ACN

Alias : WA4320i-ACN

Vendor name : H3C

Vendor ID : 25506

Radio count : 2

Radio 1:

Mode : 802.11a, 802.11an

Default mode : 802.11an

BSS count : 16

Radio 2:

Mode : 802.11b, 802.11g, 802.11gn

Default mode : 802.11gn

BSS count : 16

Table 4 Command output

Field | Description
AP model | AP model name.
Alias | AP model alias.
Mode | Supported radio types.
Default mode | Default radio type.
BSS count | Maximum number of BSSs that the radio supports.

AP management commands -- display wlan tunnel latency ap name

Use display wlan tunnel latency ap name to display tunnel latency information for an AP.

Syntax

display wlan tunnel latency ap name ap-name

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

ap-name: Specifies an AP by its name, a case-insensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

Usage guidelines

Make sure CAPWAP tunnel latency detection is enabled before you execute this command.

Examples

# Display tunnel latency information for AP ap1.

<Sysname> display wlan tunnel latency ap name ap1

AP name : ap1

Tunnel latency : Enabled

Control link delay:

Current delay : 1ms

Maximum delay : 1ms

Minimum delay : 1ms

Data link delay:

Current delay : 1ms

Maximum delay : 1ms

Minimum delay : 1ms

Table 5 Command output

Field | Description
Tunnel latency | Tunnel latency detection: Disabled or Enabled.
Current delay | The most recent delay.

Related commands

reset wlan tunnel latency ap

tunnel latency enable

AP management commands -- dns domain

Use dns domain to specify a domain name for an AP.

Use undo dns domain to restore the default.

Syntax

dns domain domain-name

undo dns domain

Default

No domain name is specified for an AP.

Views

AP provision view

AP group provision view

Predefined user roles

network-admin

mdc-admin

Parameters

domain-name: Specifies a domain name, a case-insensitive string of 1 to 253 characters separated by dots. The string can contain letters, digits, hyphens (-), and underscores (_).

Usage guidelines

The configuration in AP provision view takes effect only on the AP. The configuration in AP group provision view takes effect on all APs in the AP group.

The configuration in AP provision view takes precedence over the configuration in AP group provision view.

Examples

# Set the domain name for AP ap1 to com.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] provision

[Sysname-wlan-ap-ap1-prvs] dns domain com

# Set the domain name for APs in AP group group1 to com.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] provision

[Sysname-wlan-ap-group-group-prvs] dns domain com

Related commands

dns server

AP management commands -- dns server

Use dns server to specify a DNS server for an AP.

Use undo dns server to delete the DNS server configuration.

Syntax

dns server { ip ipv4-address | ipv6 ipv6-address }

undo dns server { ip | ipv6 }

Default

No DNS server is specified for an AP.

Views

AP provision view

AP group provision view

Predefined user roles

network-admin

mdc-admin

Parameters

ip ipv4-address: Specifies a DNS server by its IPv4 address. Make sure you specify a valid IP address. Invalid IP addresses include loopback IP addresses, direct broadcast addresses, Class D IP addresses, Class E IP addresses, IP address 255.255.255.255, and IP addresses in the 0.X.X.X format.

ipv6 ipv6-address: Specifies a DNS server by its IPv6 address.

Usage guidelines

You can specify only one IPv4 address and one IPv6 address in each view.

The configuration in AP provision view takes effect only on the AP. The configuration in AP group provision view takes effect on all APs in the AP group.

The configuration in AP provision view takes precedence over the configuration in AP group provision view.

Examples

# Set the DNS server IP address to 192.168.100.123 for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] provision

[Sysname-wlan-ap-ap1-prvs] dns server ip 192.168.100.123

# Set the DNS server IP address to 192.168.100.123 for APs in AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] provision

[Sysname-wlan-ap-group-group-prvs] dns server ip 192.168.100.123

Related commands

dns domain

AP management commands -- download file

Use download file to download an image file to an AP.

Syntax

download file filename

Views

AP view

Predefined user roles

network-admin

mdc-admin

Parameters

filename: Specifies an image file by its name, a string of 1 to 255 characters.

Usage guidelines

This feature takes effect only on the master AC after a CAPWAP tunnel is established in WLAN high availability networking. For more information about WLAN high availability, see "Configuring WLAN high availability."

Examples

# Download image file main.ipe to AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan–ap-ap1] download file main.ipe

AP management commands -- echo-interval

Use echo-interval to set the interval for an AP to send echo requests to the AC.

Use undo echo-interval to restore the default.

Syntax

echo-interval interval

undo echo-interval

Default

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

In AP group view, the interval for an AP to send echo requests is 10 seconds.

Views

AP view

AP group view

Predefined user roles

network-admin

mdc-admin

Parameters

interval: Specifies the interval for sending echo requests, in the range of 5 to 80 seconds.

Usage guidelines

An AP sends echo requests to the AC at the specified echo interval to identify whether the CAPWAP tunnel is operating correctly. The AC responds by sending echo responses. The AC terminates the connection if it does not receive any echo requests within 120 seconds. If the AP does not receive any echo responses within 3 seconds after it sends an echo request, the AP sends the request again. If the AP does not receive any echo responses after three retransmission attempts, the AP terminates the connection.

Examples

# Set the echo interval for AP ap3 to 15 seconds.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA4320i-ACN

[Sysname-wlan-ap-ap3] echo-interval 15

# Set the echo interval for APs in AP group group1 to 15 seconds.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] echo-interval 15

AP management commands -- firmware-upgrade

Use firmware-upgrade enable to enable the firmware upgrade feature.

Use firmware-upgrade disable to disable the firmware upgrade feature.

Use undo firmware-upgrade to restore the default.

Syntax

firmware-upgrade { disable | enable }

undo firmware-upgrade

Default

In AP view, the AP uses the configuration in AP group view. If no firmware upgrade configuration exists in AP group view, the AP uses the configuration in global configuration view.

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

In global configuration view, the firmware upgrade feature is enabled.

Views

AP view

AP group view

Global configuration view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

This feature enables an AP to upgrade its firmware if it uses a different software version from the software version stored in the APDB during CAPWAP tunnel establishment. When this feature is disabled, the AC does not examine the firmware version of an AP and establishes a CAPWAP tunnel with the AP.

Examples

# Enable the firmware upgrade feature for AP ap3.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA4320i-ACN

[Sysname-wlan-ap-ap3] firmware-upgrade enable

# Enable the firmware upgrade feature for APs in AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] firmware-upgrade enable

# Enable the firmware upgrade feature globally.

<Sysname> system-view

[Sysname] wlan global-configuration

[Sysname-wlan-global-configuration] firmware-upgrade enable

AP management commands -- gateway

Use gateway to specify a gateway for an AP.

Use undo gateway to delete the gateway configuration.

Syntax

gateway { ip ipv4-address | ipv6 ipv6-address }

undo gateway { ip | ipv6 }

Default

No gateway is specified for an AP.

Views

AP provision view

Predefined user roles

network-admin

mdc-admin

Parameters

ip ipv4-address: Specifies a gateway by its IPv4 address. Make sure you specify a valid IP address. Invalid IP addresses include loopback IP addresses, direct broadcast addresses, Class D IP addresses, Class E IP addresses, IP address 255.255.255.255, and IP addresses in the 0.X.X.X format.

ipv6 ipv6-address: Specifies a gateway by its IPv6 address.

Usage guidelines

You can set only one IPv4 address and one IPv6 address.

Examples

# Set the gateway IP address to 192.168.100.1 for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] provision

[Sysname-wlan-ap-ap1-prvs] gateway ip 192.168.100.1

AP management commands -- hybrid-remote-ap

Use hybrid-remote-ap enable to enable remote AP.

Use hybrid-remote-ap disable to disable remote AP.

Use undo hybrid-remote-ap to restore the default.

Syntax

hybrid-remote-ap { disable | enable }

undo hybrid-remote-ap

Default

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

In AP group view, remote AP is disabled.

Views

AP view

AP group view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

By default, an AP stops providing services after the tunnel between the AP and the associated AC is disconnected. This command enables the AP to act as a remote AP to still provide services.

This command takes effect only on an AP that operates in local forwarding mode.

Examples

# Enable remote AP for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] hybrid-remote-ap enable

# Enable remote AP for APs in AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] hybrid-remote-ap enable

AP management commands -- if-match ip

Use if-match ip to create an AP grouping rule by IPv4 addresses.

Use undo if-match ip to delete AP grouping rules by IPv4 addresses.

Syntax

if-match ip ip-address { mask-length | mask }

undo if-match ip

Default

No AP grouping rules by IPv4 addresses exist.

Views

AP group view

Predefined user roles

network-admin

mdc-admin

Parameters

ip-address: Specifies an IPv4 address in dotted decimal notation.

mask-length: Specifies the mask length in the range of 1 to 31.

mask: Specifies the mask in dotted decimal notation.

Usage guidelines

You cannot execute this command in the view of the default AP group.

AP grouping rules by IPv4 addresses for different AP groups cannot overlap with each other.

The priorities of AP grouping rules by AP names, serial IDs, MAC addresses, and IP addresses are in descending order. If an AP does not match any grouping rules, it is added to the default AP group.

You can create AP grouping rules by both IPv4 addresses and IPv6 addresses for an AP group.

Examples

# Add APs whose IP address belongs to 192.168.0.0/16 to AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-ap-group-group1] if-match ip 192.168.0.0 16

AP management commands -- if-match ipv6

Use if-match ipv6 to create an AP grouping rule by IPv6 addresses.

Use undo if-match ipv6 to delete AP grouping rules by IPv6 addresses.

Syntax

if-match ipv6 { ipv6-address prefix-length | ipv6-address/prefix-length }

undo if-match ip

Default

No AP grouping rules by IPv6 addresses exist.

Views

AP group view

Predefined user roles

network-admin

mdc-admin

Parameters

ipv6-address: Specifies an IPv6 address.

prefix-length: Specifies the IPv6 address prefix length in the range of 1 to 127.

Usage guidelines

You cannot execute this command in the view of the default AP group.

AP grouping rules by IPv6 addresses for different AP groups cannot overlap with each other.

The priorities of AP grouping rules by AP names, serial IDs, MAC addresses, and IP addresses are in descending order. If an AP does not match any grouping rules, it is added to the default AP group.

You can create AP grouping rules by both IPv4 addresses and IPv6 addresses for an AP group.

Examples

# Add APs whose IPv6 address belongs to 2001:DB0::/28 to AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-ap-group-group1] if-match ipv6 2001:DB8:: 28

AP management commands -- ip address

Use ip address to specify an IPv4 address for the management VLAN interface for an AP.

Use undo ip address to restore the default.

Syntax

ip address ip-address { mask | mask-length }

undo ip address

Default

No IPv4 address is specified for the management VLAN interface of an AP.

Views

AP provision view

Predefined user roles

network-admin

mdc-admin

Parameters

ip-address: Specifies an IPv4 address in dotted decimal notation.

mask: Specifies the mask in dotted decimal notation.

mask-length: Specifies the mask length in the range of 1 to 31.

Usage guidelines

Make sure you specify a valid IP address. Invalid IP addresses include loopback IP addresses, direct broadcast addresses, Class D IP addresses, Class E IP addresses, IP address 255.255.255.255, and IP addresses in the 0.X.X.X format.

The IP address of the management VLAN interface for an AP must be different from the following IP addresses:

· IP address of the management VLAN interface of another AP.

· AC IP address specified in provision view of any APs.

Examples

# Set the IP address of the management VLAN interface to 10.1.1.1/24 for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] provision

[Sysname-wlan-ap-ap1-prvs] ip address 10.1.1.1 24

AP management commands -- ipv6 address

Use ipv6 address to specify an IPv6 address for the management VLAN interface for an AP.

Use undo ipv6 address to restore the default.

Syntax

ipv6 address { ipv6-address prefix-length | ipv6-address/prefix-length }

undo ipv6 address

Default

No IPv6 address is specified for the management VLAN interface of an AP.

Views

AP provision view

Predefined user roles

network-admin

mdc-admin

Parameters

ipv6-address: Specifies an IPv6 address.

prefix-length: Specifies the prefix length in the range of 1 to 128.

Usage guidelines

The IP address of the management VLAN interface for an AP must be different from the following IP addresses:

· IP address of the management VLAN interface of another AP.

· AC IP address specified in provision view of any APs.

Examples

# Set the IPv6 address of the management VLAN interface to 2001::1/64 for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] provision

[Sysname-wlan-ap-ap1-prvs] ipv6 address 2001::1/64

AP management commands -- jumboframe

Use jumboframe to set the maximum jumbo frame size.

Use undo jumboframe to restore the default.

Syntax

jumboframe size

undo jumboframe

Default

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

In AP group view, the maximum jumbo frame size is 1500 bytes.

Views

AP view

AP group view

Predefined user roles

network-admin

mdc-admin

Parameters

size: Specifies the maximum jumbo frame size in the range of 1500 to 1748 bytes.

Usage guidelines

An AP fragments received jumbo frames based on the configured maximum jumbo frame size before transmitting them.

Example

# Set the maximum jumbo frame size to 1500 bytes for the AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-ap-ap1] jumboframe 1500

# Set the maximum jumbo frame size to 1500 bytes for the AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] jumboframe 1500

AP management commands -- led-mode

Use led-mode to set a LED lighting mode.

Use undo led-mode to restore the default.

Syntax

led-mode { always-on | awake | normal | quiet }

undo led-mode

Default

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

In AP group view, the LED lighting mode is normal.

Views

AP view

AP group view

Predefined user roles

network-admin

mdc-admin

Parameters

always-on: Specifies the always-on mode.

awake: Specifies the awake mode.

normal: Specifies the normal mode. How LEDs flash in this mode varies by AP model.

quiet: Specifies the quiet mode.

Examples

# Set the LED lighting mode to normal for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2620i-AGN

[Sysname-wlan-ap-ap1] led-mode normal

# Set the LED lighting mode to awake for APs in AP group ap1.

<Sysname> system-view

[Sysname] wlan ap-group g1

[Sysname-wlan-ap-group-g1] led-mode awake

AP management commands -- mac-address (AP group view)

Use mac-address to create an AP grouping rule by MAC addresses.

Use undo mac-address to delete an AP grouping rule by MAC addresses.

Syntax

mac-address mac-address

undo mac-address mac-address

Default

No AP grouping rules by MAC addresses exist.

Views

AP group view

Predefined user roles

network-admin

mdc-admin

Parameters

mac-address: Specifies the MAC address of an AP.

Usage guidelines

This command does not identify whether the specified AP exists.

You can configure multiple AP grouping rules by MAC addresses.

The priorities of AP grouping rules by AP names, serial IDs, MAC addresses, and IP addresses are in descending order. If an AP does not match any grouping rules, it is added to the default AP group.

If the created AP grouping rule already exists in another AP group, this command deletes the rule from that AP group.

You cannot execute this command in the view of the default AP group.

Examples

# Create an AP grouping rule by MAC addresses for AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] mac-address 0AC1-F9B2-B1C2

Related commands

wlan ap-group

AP management commands -- mac-address (AP view)

Use mac-address to assign a MAC address to an AP.

Use undo mac-address to restore the default.

Syntax

mac-address mac-address

undo mac-address

Default

No MAC address is assigned to an AP.

Views

AP view

Predefined user roles

network-admin

mdc-admin

Parameters

mac-address: Specifies the MAC address in H-H-H format.

Usage guidelines

Changing or deleting the MAC address of an AP terminates the CAPWAP tunnel if the AP has established a CAPWAP tunnel with the AC. Then the AP will reestablish a CAPWAP tunnel with the AC.

Examples

# Assign the MAC address 0001-0000-0000 to AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] mac-address 0001-0000-0000

AP management commands -- priority

Use priority to set the AP connection priority for the AC.

Use undo priority to restore the default.

Syntax

priority priority

undo priority

Default

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

In AP group view, the AP connection priority for the AC is 4.

Views

AP view

AP group view

Predefined user roles

network-admin

mdc-admin

Parameters

priority: Specifies the AP connection priority for the AC, in the range of 0 to 7. A larger value represents a higher connection priority.

Usage guidelines

The AP prefers to establish a CAPWAP tunnel with an AC that has higher connection priority.

The AP connection priority only takes effect during AC discovery.

Examples

# Set the AP connection priority for the AC to 7 for AP ap3.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA4320i-ACN

[Sysname-wlan-ap-ap3] priority 7

# Set the AP connection priority for the AC to 7 for AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] priority 7

AP management commands -- provision

Use provision to enable AP preprovisioning and enter AP provision view, or enter AP provision view if AP preprovisioning is already enabled.

Use undo provision to disable AP preprovisioning.

Syntax

provision

undo provision

Default

AP preprovisioning is disabled.

Views

AP view

AP group view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

AP preprovisioning allows you to configure network settings for fit APs on an AC. The AC automatically assigns these settings to the fit APs in run state through CAPWAP tunnels in a batch.

Disabling AP preprovisioning deletes the network settings on the AC, but the operation does not affect the settings already assigned to fit APs.

Examples

# Enable AP preprovisioning and enter AP provision view of AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] provision

[Sysname-wlan-ap-ap1-prvs]

# Enable AP preprovisioning and enter AP provision view of AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] provision

[Sysname-wlan-ap-group-group1-prvs]

AP management commands -- provision auto-recover

Use provision auto-recover enable to enable auto loading of preprovisioned settings.

Use provision auto-recover disable to disable auto loading of preprovisioned settings.

Use undo provision auto-recover to restore the default.

Syntax

provision auto-recover { disable | enable }

undo provision auto-recover

Default

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

In AP group view, auto loading of preprovisioned settings is enabled.

Views

AP view

AP group view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

Auto loading of preprovisioned settings ensures CAPWAP tunnel establishment between AP and AC when errors occur. Either of the following events occurs when this feature is enabled for an AP:

· The AP reboots and establishes a CAPWAP tunnel with the AC as a manual AP or an auto AP if the AP starts by using preprovisioned settings that have errors.

· The AP reboots and then uses the preprovisioned settings to start if the AP starts as a manual AP and the manual AP configuration has errors. For the AP to successfully establish a CAPWAP tunnel with the AC, you must correct the manual AP settings or enable the auto AP feature.

Examples

# Disable auto loading of preprovisioned settings for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-ap-ap1] provision auto-recover disable

# Disable auto loading of preprovisioned settings for APs in AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] provision auto-recover disable

AP management commands -- reset wlan ap

Use reset wlan ap to reset all APs or the specified AP.

Syntax

reset wlan ap { all | name ap-name | ap-group group-name }

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

all: Specifies all APs connected to the AC.

name ap-name: Specifies an AP by its name, a case-insensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

ap-group group-name: Specifies an AP group by its name, a case-insensitive string of 1 to 31 characters.

Usage guidelines

This command terminates the CAPWAP tunnel between an AP and the AC and deletes all connection information about the AP.

Examples

# Reset AP ap1.

<Sysname> reset wlan ap name ap1

Reset the AP that has established or is to establish a primary tunnel with the AC. Continue? [Y/N]:

AP management commands -- reset wlan ap provision

Use reset wlan ap provision to delete configuration file wlan_ap_prvs.xml from all APs or the specified AP.

Syntax

reset wlan ap provision { all | name ap-name }

Views

Any view

Predefined user roles

network-admin

mdc-admin

Parameters

all: Specifies all APs.

name ap-name: Specifies an AP by its name, a case-insensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

Usage guidelines

This command takes effect only on APs that have established CAPWAP tunnels with the master AC and are in Run state.

Examples

# Delete configuration file wlan_ap_prvs.xml from AP ap1.

<Sysname> reset wlan ap provision name ap1

AP management commands -- reset wlan ap reboot-log

Use reset wlan ap reboot-log to clear the reboot logs of all APs or the specified AP.

Syntax

reset wlan ap reboot-log { all | name ap-name }

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

all: Specifies all APs.

name ap-name: Specifies an AP by its name, a case-insensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

Examples

# Clear the reboot logs of AP ap1.

<Sysname> reset wlan ap reboot-log name ap1

Related commands

display wlan ap reboot-log

AP management commands -- reset wlan tunnel latency ap

Use reset wlan tunnel latency ap to clear tunnel latency information for all APs or the specified AP.

Syntax

reset wlan tunnel latency ap { all | name ap-name }

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

all: Specifies all APs.

name ap-name: Specifies an AP by its name, a case-insensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

Usage guidelines

This command takes effect only on APs that have established tunnels with the master AC and are in Run state.

Examples

# Clear tunnel latency information for AP ap1.

<Sysname> reset wlan tunnel latency ap name ap1

Related commands

display wlan tunnel latency ap name

tunnel latency enable

AP management commands -- retransmit-count

Use retransmit-count to set the maximum number of AC request retransmission attempts.

Use undo retransmit-count to restore the default.

Syntax

retransmit-count value

undo retransmit-count

Default

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

In AP group view, the maximum number of AC request retransmission attempts is 3.

Views

AP view

AP group view

Predefined user roles

network-admin

mdc-admin

Parameters

value: Specifies the maximum number of AC request retransmission attempts, in the range of 2 to 5.

Usage guidelines

The AC sends a request to an AP at the retransmission interval until the maximum number of request retransmission attempts is reached or a response is received.

Requests sent by the AC to an AP include the following types:

· Image Data Request.

· Configuration Update Request.

· Reset Request.

· Data Transfer Request.

· IEEE 802.11 WLAN Configuration Request.

· Station Configuration Request.

Examples

# Set the maximum number of AC request retransmission attempts to 4 for AP ap3.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA4320i-ACN

[Sysname-wlan-ap-ap3] retransmit-count 4

# Set the maximum number of AC request retransmission attempts to 4 for APs in AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] retransmit-count 4

Related commands

retransmit-interval

AP management commands -- retransmit-interval

Use retransmit-interval to set the request retransmission interval for the AC to retransmit requests to an AP.

Use undo retransmit-interval to restore the default.

Syntax

retransmit-interval interval

undo retransmit-interval

Default

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

In AP group view, the request retransmission interval is 5 seconds.

Views

AP view

AP group view

Predefined user roles

network-admin

mdc-admin

Parameters

interval: Specifies the request retransmission interval in the range of 3 to 8 seconds.

Usage guidelines

The AC sends a request to an AP at the retransmission interval until the maximum number of request retransmission attempts is reached or a response is received.

Requests sent by the AC to an AP include the following types:

· Image Data Request.

· Configuration Update Request.

· Reset Request.

· Data Transfer Request.

· IEEE 802.11 WLAN Configuration Request.

· Station Configuration Request.

Examples

# Set the request retransmission interval to 6 seconds for the AC to send requests to AP ap3.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA4320i-ACN

[Sysname-wlan-ap-ap3] retransmit-interval 6

# Set the request retransmission interval to 6 seconds for the AC to send requests to APs in AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] retransmit-interval 6

Related commands

retransmit-count

AP management commands -- save wlan ap provision

Use save wlan ap provision to deploy the preprovisioned settings to all APs or the specified AP.

Syntax

save wlan ap provision { all | name ap-name }

Views

Any view

Predefined user roles

network-admin

mdc-admin

Parameters

all: Specifies all APs.

name ap-name: Specifies an AP by its name, a case-insensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

Usage guidelines

This command saves the added or modified preprovisioned settings to configuration file wlan_ap_prvs.xml, and takes effect immediately.

This command takes effect only on APs that have established tunnels with the master AC and are in Run state.

This command has the same effect as the reset wlan ap provision command if no AP preprovisioned settings exist.

Examples

# Save the configuration in AP provision view to configuration file wlan_ap_prvs.xml on AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] provision

[Sysname-wlan-ap-ap1-prvs] ac ip 192.168.0.1

[Sysname-wlan-ap-ap1-prvs] save wlan ap provision name ap1

AP management commands -- serial-id (AP group view)

Use serial-id to create an AP grouping rule by serial IDs.

Use undo serial-id to delete an AP grouping rule by serial IDs.

Syntax

serial-id serial-id

undo serial-id serial-id

Default

No AP grouping rules by serial IDs exist.

Views

AP group view

Predefined user roles

network-admin

mdc-admin

Parameters

serial-id: Specifies an AP serial ID, a case-insensitive string of 1 to 63 characters.

Usage guidelines

This command does not identify whether the specified AP exists.

You can configure multiple AP grouping rules by serial IDs.

The priorities of AP grouping rules by AP names, serial IDs, MAC addresses, and IP addresses are in descending order. If an AP does not match any grouping rules, it is added to the default AP group.

If the created AP grouping rule already exists in another AP group, this command deletes the rule from that AP group.

You cannot execute this command in the view of the default AP group.

Examples

# Create an AP grouping rule by serial IDs for AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] serial-id 210235A1BSC123000037

Related commands

wlan ap-group

AP management commands -- serial-id (AP view)

Use serial-id to specify the serial ID for an AP.

Use undo serial-id to restore the default.

Syntax

serial-id serial-id

undo serial-id

Default

No serial ID is specified for an AP.

Views

AP view

Predefined user roles

network-admin

mdc-admin

Parameters

serial-id: Specifies the serial ID for an AP, a case-insensitive string of 1 to 63 characters.

Usage guidelines

Changing or deleting the serial ID of an AP terminates the CAPWAP tunnel if the AP has established a CAPWAP tunnel with an AC. Then the AP will reestablish a CAPWAP tunnel with the AC.

Examples

# Set the serial ID of AP ap1 to 210235A1BSC123000050.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-ap-ap1] serial-id 210235A1BSC123000050

AP management commands -- snmp-agent trap enable wlan ap

Use snmp-agent trap enable wlan ap to enable SNMP notifications for AP management.

Use undo snmp-agent trap enable wlan ap to disable SNMP notifications for AP management.

Syntax

snmp-agent trap enable wlan ap

undo snmp-agent trap enable wlan ap

Default

SNMP notifications are disabled for AP management.

Views

System view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

To report critical AP management events to an NMS, enable SNMP notifications for AP management. For AP management event notifications to be sent correctly, you must also configure SNMP on the device. For more information about SNMP configuration, see the network management and monitoring configuration guide for the device.

Examples

# Enable SNMP notifications for AP management.

<Sysname> system-view

[Sysname] snmp-agent trap enable wlan ap

AP management commands -- snmp-agent trap enable wlan capwap

Use snmp-agent trap enable wlan capwap to enable SNMP notifications for CAPWAP.

Use undo snmp-agent trap enable wlan capwap to disable SNMP notifications for CAPWAP.

Syntax

snmp-agent trap enable wlan capwap

undo snmp-agent trap enable wlan capwap

Default

SNMP notifications are disabled for CAPWAP.

Views

System view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

To report critical CAPWAP events to an NMS, enable SNMP notifications for CAPWAP. For CAPWAP event notifications to be sent correctly, you must also configure SNMP on the device. For more information about SNMP configuration, see the network management and monitoring configuration guide for the device.

Examples

# Enable SNMP notifications for CAPWAP.

<Sysname> system-view

[Sysname] snmp-agent trap enable wlan capwap

AP management commands -- statistics-interval

Use statistics-interval to set the statistics report interval for an AP to send statistics reports to the AC.

Use undo statistics-interval to restore the default.

Syntax

statistics-interval interval

undo statistics-interval

Default

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

In AP group view, the statistics report interval is 50 seconds.

Views

AP view

AP group view

Predefined user roles

network-admin

mdc-admin

Parameters

interval: Specifies the statistics report interval in the range of 2 to 120 seconds.

Usage guidelines

Execute this command to change the interval for an AP to report its statistics. You can use these statistics to monitor the operating status of radios on the AP.

Examples

# Set the statistics reports interval to 10 seconds for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] statistics-interval 10

# Set the statistics reports interval to 10 seconds for APs in AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] statistics-interval 10

AP management commands -- tunnel encryption

Use tunnel encryption enable to enable CAPWAP tunnel encryption.

Use tunnel encryption disable to disable CAPWAP tunnel encryption.

Use undo tunnel encryption enable to restore the default.

Syntax

tunnel encryption { disable | enable }

undo tunnel encryption enable

Default

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

In AP group view, CAPWAP tunnel encryption is disabled.

Views

AP view

AP group view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

The tunnel encryption enable command enables the AC and the AP to use the Datagram Transport Layer Security (DTLS) protocol to encrypt control packets transmitted in a CAPWAP tunnel.

Examples

# Enable CAPWAP tunnel encryption for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] tunnel encryption enable

# Enable CAPWAP tunnel encryption for APs in AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] tunnel encryption enable

Related commands

wlan back-up mode

AP management commands -- tunnel latency-detect

Use tunnel latency-detect to configure CAPWAP tunnel latency detection.

Syntax

tunnel latency-detect { start | stop }

Default

CAPWAP tunnel latency detection is not started.

Views

AP view

Predefined user roles

network-admin

mdc-admin

Parameters

start: Starts CAPWAP tunnel latency detection.

stop: Stops CAPWAP tunnel latency detection.

Usage guidelines

CAPWAP tunnel latency detection enables the AC to detect the transmission latency of CAPWAP control frames or data frames from an AP to the AC and back.

When an AP goes offline, CAPWAP tunnel latency detection automatically stops. To restart CAPWAP tunnel latency detection when the AP comes online again, execute the tunnel latency-detect start command again.

The tunnel latency-detect start command takes effect only on APs that have established CAPWAP tunnels with the master AC and are in Run state.

Examples

# Start CAPWAP tunnel latency detection for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] tunnel latency-detect start

Related commands

display wlan tunnel latency ap name

reset wlan tunnel latency ap

AP management commands -- virtual-ap

Use virtual-ap to create a virtual AP.

Use undo virtual-ap to delete a virtual AP.

Syntax

virtual-ap virtual-ap-id mode { fat | fit ac-address { ipv4-address | ipv6-address } } service-template-number service-template-number

undo virtual-ap virtual-ap-id

Default

No virtual APs exist.

Views

AP view

Predefined user roles

network-admin

mdc-admin

Parameters

virtual-ap-id: Specifies an AP ID. The value range for this argument is 1 to 15.

fat: Creates a virtual fat AP.

fit: Creates a virtual fit AP.

ac-address: Specifies the IP address of the AC to which the virtual AP connects.

ipv4-address: Specifies the IPv4 address of the AC to which the virtual AP connects.

ipv6-address: Specifies the IPv6 address of the AC to which the virtual AP connects.

service-template-number: Specifies the maximum number of service templates to which the virtual AP can

be bound. The value range is 1 to 15.

Usage guidelines

Make sure the physical AP has established a CAPWAP tunnel with the master AC before you execute this command.

Examples

# Create a virtual AP for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1

[Sysname-wlan-ap-ap1] virtual-ap 1 mode fit ac-address ip 1.1.1.1 service-template-number 1

AP management commands -- wlan ap

Use wlan ap to create a manual AP and enter its view, or enter the view of an existing manual AP.

Use undo wlan ap to delete an AP.

Syntax

wlan ap ap-name [ model model-name ]

undo wlan ap ap-name

Default

No manual APs exist.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

ap-name: Specifies an AP by its name, a case-insensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

model model-name: Specifies the model name of the AP. You must specify the model name when you create an AP.

Usage guidelines

If the specified AP has established a CAPWAP tunnel, the undo wlan ap command also terminates the tunnel.

Examples

# Create AP ap1 with model WA4320i-ACN.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1]

AP management commands -- wlan apdb

Use wlan apdb to specify a software version for a hardware version of an AP model in the APDB.

Use undo wlan apdb to restore the default.

Syntax

wlan apdb model-name hardware-version software-version

undo wlan apdb model-name hardware-version

Default

The software version for a hardware version of an AP model is the software version that is stored in APDB user scripts.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

model-name: Specifies an AP model name in the APDB.

hardware-version: Specifies a hardware version in the APDB.

software-version: Specifies an AP software version, a case-insensitive string of 1 to 31 characters.

Usage guidelines

The APDB stores hardware version and software version mappings for AP models. You can use this command to re-specify a software version for a hardware version of an AP model for firmware upgrade. The firmware upgrade feature will upgrade the software to the software version specified by this command when the AP comes online. For information about firmware upgrade, see WLAN Configuration Guide.

Examples

# Specify software version E2108 for hardware version Ver.C of AP model WA4320i-ACN in the APDB.

<Sysname> system-view

[Sysname] wlan apdb WA4320i-ACN Ver.C E2108

Related commands

firmware-upgrade

AP management commands -- wlan apdb file

Use wlan apdb file to load an APDB user script.

Use undo wlan apdb file to delete an APDB user script.

Syntax

wlan apdb file user.apdb

undo wlan apdb file

Default

No APDB user script is loaded.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

user.apdb: Specifies an APDB user profile by its name, a case-sensitive string of 1 to 63 characters. apdb is the filename extension.

Usage guidelines

This command adds the AP model information in the user script to the APDB.

If you execute this command multiple times, the most recent configuration takes effect.

To load a new user script in the following conditions, perform either of the following tasks depending on the condition:

· Delete the corresponding AP model information on the AC when a manual AP or an online auto AP whose model is listed in the old user script exists.

· Remove an AP whose model is listed in the old user script from an AP group if the AP has been added to the AP group.

· Use the wlan apdb command to restore the original software version if the old user script includes an AP model whose software version was already configured.

If you modify or delete a user script in the file system, the AP model configuration in the user script will be lost after an AC reboot.

Examples

# Load user script user.apdb.

<Sysname> system-view

[Sysname] wlan apdb file user.apdb

AP management commands -- wlan ap-group

Use wlan ap-group to create an AP group and enter its view, or enter the view of an existing AP group.

Use undo wlan ap-group to delete an AP group.

Syntax

wlan ap-group group-name

undo wlan ap-group group-name

Default

The default AP group default-group exists.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies an AP group by its name, a case-insensitive string of 1 to 31 characters.

Usage guidelines

The default AP group cannot be deleted.

Examples

# Create an AP group named group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1]

Related commands

display wlan ap-group

AP management commands -- wlan auto-ap

Use wlan auto-ap enable to enable the auto AP feature.

Use undo wlan auto-ap enable to disable the auto AP feature.

Syntax

wlan auto-ap enable

undo wlan auto-ap enable

Default

The auto AP feature is disabled.

Views

System view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

This command enables an AP to connect to an AC without manual AP configuration. It simplifies configuration when you deploy a large number of APs in a WLAN.

To configure an auto AP, you must use auto-AP persistence to convert the auto AP to a manual AP or configure it in the view of the AP group to which it belongs.

Examples

# Enable the auto AP feature.

<Sysname> system-view

[Sysname] wlan auto-ap enable

AP management commands -- wlan auto-ap persistent

Use wlan auto-ap persistent to convert online auto APs to manual APs.

Syntax

wlan auto-ap persistent { all | name auto-ap-name [ new-ap-name ] }

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

all: Specifies all online auto APs. If you specify this keyword, the command converts all online auto APs to manual APs with their names unchanged.

auto-ap-name: Specifies an online auto AP.

new-ap-name: Specifies a new name for the AP, a case-insensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-). If you do not specify this argument, the converted manual AP uses the name of the auto AP.

Examples

# Convert the auto AP with MAC address 0001-ab12-cd36 to manual AP ap2.

<Sysname> system-view

[Sysname] wlan auto-ap persistent name 0001-ab12-cd36 ap2

AP management commands -- wlan auto-persistent

Use wlan auto-persistent enable to convert auto APs to manual APs after they come online.

Use undo wlan auto-persistent enable to restore the default.

Syntax

wlan auto-persistent enable

undo wlan auto-persistent enable

Default

Auto AP conversion is disabled.

Views

System view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

This command takes effect only on auto APs that come online after you execute this command. For auto APs that are already online, use the wlan auto-ap persistent command to convert them to manual APs.

Examples

# Enable auto AP conversion.

<Sysname> system-view

[Sysname] wlan auto-persistent enable

AP management commands -- wlan capwap discovery-policy unicast

Use wlan capwap discovery-policy unicast to enable an AC to respond only to unicast discovery requests.

Use undo wlan capwap discovery-policy to disable an AC to respond only to unicast discovery requests.

Syntax

wlan capwap discovery-policy unicast

undo wlan capwap discovery-policy

Default

An AC can respond to unicast, multicast, and broadcast discovery requests.

Views

System view

Predefined user roles

network-admin

mdc-admin

Examples

# Enable the AC to respond only to unicast discovery requests.

<Sysname> system-view

[Sysname] wlan capwap discovery-policy unicast

AP management commands -- wlan global-configuration

Use wlan global-configuration to enter global configuration view.

Syntax

wlan global-configuration

Views

System view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

The configuration priorities for an AP in AP view, AP group view, and global configuration view are in descending order. If no settings are configured in one view, the settings in the view with a lower priority are used. If no settings are configured in any one of the three views, the AP uses the default configuration in the view that has the lowest priority.

Examples

# Enter global configuration view.

<Sysname> system-view

[Sysname] wlan global-configuration

[Sysname-wlan-global-configuration]

AP management commands -- wlan re-group

Use wlan re-group to move an AP grouping rule or a list of AP grouping rules to the specified AP group.

Syntax

wlan re-group { ap ap-name | ap-list list-name | ap-group old-group-name | mac-address mac-address | serial-id serial-id } group-name

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

ap ap-name: Specifies an AP grouping rule by AP names.

ap-list list-name: Specifies an AP list.

ap-group old-group-name: Specifies the source AP group. The source AP group cannot be the default AP group.

mac-address mac-address: Specifies an AP grouping rule by MAC addresses.

serial-id serial-id: Specifies an AP grouping rule by serial IDs.

group-name: Specifies the target AP group. The target AP group cannot be the default AP group.

Examples

# Create AP group group1, and create AP grouping rules by AP names to add APs ap1, ap2, and ap3 to AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] ap ap1 ap2 ap3

[Sysname-wlan-ap-group-group1] quit

# Move an AP grouping rule by AP names to AP group group2.

[Sysname] wlan re-group ap ap1 group2

AP management commands -- wlan rename-ap

Use wlan rename-ap to rename a manual AP.

Syntax

wlan rename-ap ap-name new-ap-name

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

ap-name: Specifies a manual AP by its name, a case-insensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

new-ap-name: Specifies a new AP name, a case-insensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

Examples

# Change the name of AP ap1 to ap1-office.

<Sysname> system-view

[Sysname] wlan rename-ap ap1 ap1-office