02-WLAN

HomeSupportResource CenterH3C Access Controllers Command References(E5208P03 E5215P01 R5215P01)-6W10202-WLAN
01-AP management commands
Title Size Download
01-AP management commands 322.09 KB

Contents

AP management commands· 1

ac· 1

ap· 2

control-address· 2

control-address enable· 4

delete file· 5

description (AP group view) 5

description (AP view) 6

description (AP's VLAN view) 6

display wlan ap· 7

display wlan ap address· 18

display wlan ap association-failure-record· 19

display wlan ap connection· 20

display wlan ap files· 21

display wlan ap gps· 22

display wlan ap online-time· 23

display wlan ap running-configuration· 23

display wlan ap reboot-log· 25

display wlan ap tunnel-down-record· 26

display wlan ap-distribution· 27

display wlan ap-distribution ap-name· 28

display wlan ap-group· 29

display wlan ap-model 30

display wlan tunnel latency ap name· 32

dns domain· 33

dns server 34

download file· 35

echo-count 35

echo-interval 36

firmware-upgrade· 37

fragment-size· 38

gateway· 39

gigabitethernet 39

hybrid-remote-ap· 40

if-match ip· 41

if-match ipv6· 42

ip address· 42

ipv6 address· 43

keepalive-interval 44

led-mode· 44

mac-address (AP group view) 45

mac-address (AP view) 46

name· 47

poe port 48

port access vlan· 48

port hybrid pvid· 49

port hybrid vlan· 51

port link-type· 52

port trunk permit vlan· 53

port trunk pvid· 54

port-type gigabitethernet 56

power-level default 57

priority· 58

provision· 59

provision auto-recovery· 60

provision auto-update· 61

remote-configuration· 61

reset wlan ap· 62

reset wlan ap provision· 63

reset wlan ap reboot-log· 63

reset wlan tunnel latency ap· 64

retransmit-count 64

retransmit-interval 65

save wlan ap provision· 66

serial-id (AP group view) 67

serial-id (AP view) 68

smartrate-ethernet 69

snmp-agent trap enable wlan ap· 69

snmp-agent trap enable wlan capwap· 70

statistics-interval 70

tunnel latency-detect 71

usb· 72

vlan· 73

wlan ap· 74

wlan apdb· 75

wlan apdb file· 75

wlan ap-group· 76

wlan auto-ap enable· 77

wlan auto-ap persistent 78

wlan auto-persistent enable· 78

wlan capwap discovery-policy unicast 79

wlan global-configuration· 79

wlan image-load filepath· 80

wlan re-group· 81

wlan rename-ap· 81

wlan tcp mss· 82


AP management commands

The WX1800H series, WX2500H series and WX3000H series access controllers do not support the slot keyword or the slot-number argument.

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

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

In AP group provision view, no AC is specified for an AP.

Views

AP provision view

AP group provision view

Predefined user roles

network-admin

Parameters

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

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

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.

When you execute the undo ac { ip [ ip-address ] | ipv6 [ ipv6-address ] } command, if you do not specify the ip-address or the ipv6-address argument, the command deletes all AC IPv4 or IPv6 addresses.

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

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 are configured.

Views

AP group view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

This command does not identify whether the specified AP exists.

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

If an AP grouping rule already exists in an AP group, this command deletes the rule from the 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

control-address

Use control-address to specify the IP address to be carried in the CAPWAP Control IP Address message element.

Use undo control-address to restore the default.

Syntax

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

undo control-address { ip | ipv6 }

Default

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

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

In global configuration view, the IP address inserted in the CAPWAP Control IP Address element is the AC's IP address.

Views

AP view

AP group view

Global configuration view

Predefined user roles

network-admin

Parameters

ip ipv4-address: Specifies an IPv4 address in the CAPWAP Control IPv4 Address message element.

ipv6 ipv6-address: Specifies an IPv6 address in the CAPWAP Control IPv6 Address message element.

Usage guidelines

This command takes effect only when the AC rediscovery feature is enabled.

You can specify a maximum of three IPv4 or IPv6 addresses in the CAPWAP Control IP Address message element.

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

Examples

# Specify 192.168.1.1 as the IPv4 address to be carried in the CAPWAP Control IPv4 Address message element in AP view.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] control-address ip 192.168.1.1

# Specify 192.168.1.1 as the IPv4 address to be carried in the CAPWAP Control IPv4 Address message element in AP group view.

<Sysname> system-view

[Sysname] wlan ap-group 10

[Sysname-ap-group-10] control-address ip 192.168.1.1

# Specify 192.168.1.1 as the IPv4 address to be carried in the CAPWAP Control IPv4 Address message element in global configuration view.

<Sysname> system-view

[Sysname] wlan global-configuration

[Sysname-wlan-global-configuration] control-address ip 192.168.1.1

Related commands

control-address enable

control-address enable

Use control-address enable to enable the AC rediscovery feature.

Use control-address disable to disable the AC rediscovery feature.

Use undo control-address to restore the default.

Syntax

control-address { disable | enable }

undo control-address

Default

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

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

In global configuration view, the AC rediscovery feature is disabled.

Views

AP view

AP group view

Global configuration view

Predefined user roles

network-admin

Usage guidelines

An AC enabled with AC rediscovery adds the CAPWAP Control IP Address message element to the discovery responses sent to APs. Upon receiving such a discovery response, an AP establishes a CAPWAP tunnel with the IP address representing the optimal AC in the CAPWAP Control IP Address message element.

An AC disabled with AC rediscovery does not add the CAPWAP Control IP Address message element in discovery responses sent to APs. APs that receive the discovery responses will send join requests to the source IP address of the discovery responses to establish CAPWAP tunnels with the AC.

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

Examples

# Enable the AC rediscovery feature in AP view.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] control-address enable

# Enable the AC rediscovery feature in AP group view.

<Sysname> system-view

[Sysname] wlan ap-group 10

[Sysname-ap-group-10] control-address enable

# Enable the AC rediscovery feature in global configuration view.

<Sysname> system-view

[Sysname] wlan global-configuration

[Sysname-wlan-global-configuration]control-address enable

Related commands

control-address

delete file

Use delete file to delete a file from an AP.

Syntax

delete file filename

Views

AP view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

This command takes effect only after an AP establishes a CAPWAP tunnel with the master AC.

Examples

# Delete file startup.cfg from AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] delete file startup.cfg

Related commands

·     display wlan ap files

·     download file

description (AP group view)

Use description to set a description for an AP group.

Use undo description to remove the description for an AP group.

Syntax

description text

undo description

Default

No description is set for an AP group.

Views

AP group view

Predefined user roles

network-admin

Parameters

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

Examples

# Set a description for AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

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

Related commands

·     display wlan ap-group

·     wlan ap-group

description (AP view)

Use description to set a description for an AP.

Use undo description to remove the description for an AP.

Syntax

description text

undo description

Default

No description is set for an AP.

Views

AP view

Predefined user roles

network-admin

Parameters

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

Examples

# Set 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

description (AP's VLAN view)

 

NOTE:

Support for this command depends on the AP model.

 

Use description to configure the description of an AP VLAN.

Use undo description to restore the default.

Syntax

description text

undo description

Default

In an AP's VLAN view, a VLAN uses the configuration in an AP group's VLAN view.

In an AP group's VLAN view, the description of a VLAN is VLAN vlan-id. The vlan-id argument specifies the VLAN ID in a four-digit format. If the VLAN ID has less than four digits, leading zeros are added. For example, the default description of VLAN 100 is VLAN 0100.

Views

AP's VLAN view

AP group's VLAN view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

To manage VLANs efficiently, configure descriptions for them based on their functions or connections.

For this command to take effect on an AP, make sure the remote configuration assignment feature is enabled.

Examples

# Configure the description of VLAN 2 as sales-private in the VLAN view of AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] vlan 2

[Sysname-wlan-ap-ap1-vlan2] description sales-private

# Configure the description of VLAN 2 as sales-private in the VLAN view of AP group 1.

<Sysname> system-view

[Sysname] wlan ap-group 1

[Sysname-wlan-ap-group-1] vlan 2

[Sysname-wlan-ap-group-1-vlan2] description sales-private

Related commands

remote-configuration

display wlan ap

Use display wlan ap to display AP information.

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

all: Specifies all APs.

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

verbose: Displays detailed information.

Examples

# Display information about all APs.

<Sysname> display wlan ap all

Total number of APs: 3

Total number of connected APs: 3

Total number of connected manual APs: 3

Total number of connected auto APs: 0

Total number of connected common APs: 2

Total number of connected WTUs: 1

Total number of inside APs: 0

Maximum supported APs: 3072

Remaining APs: 3070

Total AP licenses: 128

Remaining AP licenses: 126.75

 

                                 AP information

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

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

 

AP name                        APID  State Model           Serial ID

ap1                            1     I     WA4320i-ACN     210235A1BSC123000050

ap2                            2     R     WT1020          219801A0SS9156G00072

ap3                            3     R     WTU420H         219801A0SS9156G00169

Table 1 Command output

Field

Description

Total number of APs

Total number of common APs, WTs, and WTUs.

Total number of connected APs

Total number of connected common APs, WTs, and WTUs.

Total number of connected manual APs

Total number of connected manual common APs, WTs, and WTUs.

Total number of connected auto APs

Total number of connected auto common APs, WTs, and WTUs.

Total number of inside APs

Total number of inside APs. Inside APs are manual APs that are automatically created when anchor APs act as ACs. The name and the serial ID of an inside AP are the local MAC address and local serial ID, respectively.

Maximum supported APs

Maximum of number of APs supported by the AC, including fit APs and WTUs.

Total AP licenses

Total number of AP licenses, including the number of common AP licenses and a quarter of the WTU license quantity.

The number of AP licenses used for activating an AP varies by AP type:

·     Common AP—One.

·     WTU—A quarter.

·     WT—None.

APID

ID of the AP to uniquely identify the AP on the AC.

State

Current state of the AP:

·     I—Idle.

·     J—Join.

·     JA—Join acknowledge.

·     IL—The AP is downloading the version.

·     CThe AP is downloading initial configurations.

·     DCThe AP is checking data.

·     R—The AP is operating. It indicates that the AP and the AC have established a CAPWAP tunnel successfully.

·     R/MThe master CAPWAP tunnel is operating. It indicates that the AP and the master AC have established a CAPWAP tunnel successfully.

·     R/BThe backup CAPWAP tunnel is operating. It indicates that the AP and the backup AC have established a CAPWAP tunnel successfully.

·     MThe AP is connected to the master AC.

·     BThe 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

UDP control port number       : 18313

UDP data port number          : N/A

H/W version                   : Ver.C

S/W version                   : R2205P01

Boot version                  : 1.01

USB state                     : N/A

Power Level                   : N/A

PowerInfo                     : N/A

Description                   : wtp1

Priority                      : 4

Echo interval                 : 10 seconds

Statistics report interval    : 50 seconds

Fragment size (data)          : 1500

Fragment size (control)       : 1450

MAC type                      : Local MAC & Split MAC

Tunnel mode                   : Local Bridging & 802.3 Frame & Native Frame

Discovery type                : Static Configuration

Retransmission count          : 3

Retransmission interval       : 5 seconds

Firmware upgrade              : Enabled

Sent control packets          : 1

Received control packets      : 1

Echo requests                 : 147

Lost echo responses           : 0

Average echo delay            : 3

Last reboot reason            : User soft reboot

Latest IP address             : 10.1.0.2

Tunnel down reason            : Request wait timer expired

Connection count              : 1

Backup Ipv4                   : Not configured

Backup Ipv6                   : Not configured

Tunnel encryption             : Disabled

LED mode                      : Normal

Remote configuration          : Enabled

Radio 1:

    Basic BSSID               : 7848-59f6-3940

    Admin state               : Up

    Radio type                : 802.11ac

    Antenna type              : internal

    Client dot11ac-only       : Disabled

    Client dot11n-only        : Disabled

    Channel band-width        : 20/40/80MHz

    Active band-width         : 20/40/80MHz

    Secondary channel offset  : SCB

    Short GI for 20MHz        : Supported

    Short GI for 40MHz        : Supported

    Short GI for 80MHz        : Supported

    Short GI for 160MHz       : Not supported

    A-MSDU                    : Enabled

    A-MPDU                    : Enabled

    LDPC                      : Not Supported

    STBC                      : Supported

    Operational VHT-MCS Set:

        Mandatory             : Not configured

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

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

        Multicast             : Not configured

    Operational HT MCS Set:

        Mandatory             : Not configured

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

                                10, 11, 12, 13, 14, 15

        Multicast             : Not configured

    Channel                   : 44(auto)

    Channel usage(%)          : 15

    Max power                 : 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               : -102 dBm

    Smart antenna             : Enabled

    Smart antenna policy      : Auto

    Protection mode           : rts-cts

    Continuous mode           : N/A

    HT protection mode        : No protection

Radio 2:

    Basic BSSID               : 7848-59f6-3950

    Admin state               : Down

    Radio type                : 802.11b

    Antenna type              : internal

    Client dot11n-only        : Disabled

    Channel band-width        : 20MHz

    Active band-width         : 20MHz

    Secondary channel offset  : SCN

    Short GI for 20MHz        : Supported

    Short GI for 40MHz        : Supported

    A-MSDU                    : Enabled

    A-MPDU                    : Enabled

    LDPC                      : Not Supported

    STBC                      : Supported

    Operational HT MCS Set:

        Mandatory             : Not configured

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

                                10, 11, 12, 13, 14, 15

        Multicast             : Not configured

    Channel                   : 5(auto)

    Channel usage(%)          : 0

    Max power                 : 20 dBm

    Preamble type             : Short

    Operational rate:

        Mandatory             : 1, 2, 5.5, 11 Mbps

        Multicast             : Auto

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

        Disabled              : Not configured

    Distance                  : 1 km

    ANI                       : Enabled

    Fragmentation threshold   : 2346 bytes

    Beacon interval           : 100 TU

    Protection threshold      : 2346 bytes

    Long retry threshold      : 4

    Short retry threshold     : 7

    Maximum rx duration       : 2000 ms

    Noise Floor               : 0 dBm

    Smart antenna             : Enabled

    Smart antenna policy      : Auto

    Protection mode           : rts-cts

    Continuous mode           : N/A

    HT protection mode        : No protection

Table 2 Command output

Field

Description

State

Current state of the AP:

·     Idle—Idle.

·     Join—Join.

·     JoinAck—Join acknowledge.

·     Image—The AP is downloading the version.

·     Config—The AP is downloading initial configurations.

·     Data Check—The AP is checking data.

·     Run—The AP is operating. It indicates that the AP and the AC have established a CAPWAP tunnel successfully.

·     R/M—The master CAPWAP tunnel is operating. It indicates that the AP and the master AC have established a CAPWAP tunnel successfully.

·     R/B—The backup CAPWAP tunnel is operating. It indicates that the AP and the backup AC have established a CAPWAP tunnel successfully.

·     M—The AP is connected to the master AC.

·     B—The AP is connected to the backup AC.

Backup type

CAPWAP tunnel type:

·     Idle—The AP has not established a CAPWAP tunnel with the AC.

·     Master—The CAPWAP tunnel established between the AP and the master AC.

·     Backup—The CAPWAP tunnel established between the AP and the backup AC.

Region code lock

·     Enable.

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

UDP control port number

Port number used by the AP to establish the CAPWAP control tunnel.

UDP data port number

Port number used by the AP to establish the CAPWAP data tunnel.

H/W version

Hardware version of the AP.

S/W version

Software version of the AP.

WT serial ID

Serial ID of the WT that connects to the WTU. This field is displayed only for WTUs.

WT name

Name of the WT that connects to the WTU. This field is displayed only for WTUs.

WT MAC address

MAC address of the WT that connects to the WTU. This field is displayed only for WTUs.

USB state

USB state:

·     Enabled.

·     Disabled.

This field displays N/A if no USB state information is available.

Power Level

Power level:

·     Low.

·     Middle.

·     High.

This field displays N/A if the power level is unknown.

PowerInfo

Power supply information.

PoE status

PoE power supply state for each PI:

·     Enabled.

·     Disabled.

Support for this field depends on the AP model.

Description

Description for the AP. If no description is configured, this field displays Not configured.

Priority

AP connection priority for the AC.

Fragment size (data)

Maximum fragment size for CAPWAP data packets.

Fragment size (control)

Maximum fragment size for CAPWAP control packets.

MAC type

MAC type of the AP-AC connection:

·     Local MAC—The AP encapsulates frames in 802.3 format before sending them to the AC.

·     Split MAC—The AP encapsulates frames in 802.11 format before sending them to the AC.

·     Local & Split MAC—The AP can encapsulate frames in either 802.3 format or 802.11 format before sending them to the AC.

Tunnel mode

Supported tunnel mode of the AP:

·     Local Bridging—The AP supports local bridging and does not forward data to the AC.

·     802.3 Frame—The AP encapsulates the frames in 802.3 format to send them to the AC.

·     Native Frame—The AP encapsulates the frames in 802.11 format to send them to the AC.

·     Local Bridging & 802.3 Frame—The AP supports the Local Bridging mode and the 802.3 Frame mode.

·     802.3 Frame & Native Frame—The AP supports the 802.3 Frame mode and the Native Frame mode.

·     Local Bridging & Native Frame—The AP supports the Local Bridging mode and the Native Frame mode.

Discovery type

Discovery type of the AP:

·     Static Configuration—The AP uses the manually configured IPv4 or IPv6 address of the AC.

·     DHCP—The AP gets the IP address of an AC through DHCP.

·     DNS—The AP gets the IP address of an AC through DNS.

·     Unknown.

Retransmission count

Number of retransmission attempts for an AC request.

Retransmission interval

Interval at which AC requests can be retransmitted.

Firmware upgrade

AP software upgrade:

·     Enabled.

·     Disabled.

Sent control packets

Number of sent packets, including Change State Event Response packets after the AC enters Run state.

Received control packets

Number of received packets, including Change State Event Response packets after the AC enters Run state.

Echo requests

Number of echo requests sent by the AP in Run state.

Lost echo responses

Number of echo responses not received by the AP in Run state.

Average echo delay

Average echo delay in milliseconds.

Last reboot reason

Last reboot reason for the AP:

·     Power on.

·     Hard reboot.

·     Watchdog reboot.

·     Unknown reboot.

·     User soft reboot.

·     Kernel exception soft reboot.

·     Kernel deadloop soft reboot.

·     Auto update soft reboot.

·     Unknown soft reboot.

·     Memory exhausted.

·     Other unknown soft reboot.

Latest IP address

IP address that was most recently used by the AP.

Tunnel down reason

Cause for the CAPWAP tunnel to go down:

·     Failed to create timer.

·     Neighbor dead timer expired.

·     Request wait timer expired.

·     Data check timer expired.

·     Failed to process data channel keep-alive message.

·     Failed to process request.

·     AP was reset.

·     AP was deleted.

·     Failed to come online.

·     Serial number changed.

·     MAC address changed.

·     Number of APs exceeded the limit.

·     Processed join request in Run state.

·     Failed to create AP context.

·     Received failure result code.

·     Failed to retransmit message.

·     Failed to download image file.

·     Image file downloaded successfully.

·     File operation timer expired.

·     Failed to add tunnel.

·     Received WTP tunnel down event from AP.

·     Backup AC closed the backup tunnel.

·     Master and backup tunnel switchover.

·     Failed to inherit configuration.

·     AP authentication failed.

This field displays N/A if the CAPWAP tunnel did not go down.

Connection count

Number of times that the AP connects to the AC. It is cleared in either one of the following cases:

·     The AC reboots.

·     The serial ID of the AP changes.

The reset wlan ap command does not clear the connection count.

Backup Ipv4

IPv4 address of the backup AC. If no backup AC is specified, this field displays Not configured.

Backup Ipv6

IPv6 address of the backup AC. If no backup AC is specified, this field displays Not configured.

Tunnel encryption

·     Enabled.

·     Disabled.

LED mode

LED lighting mode:

·     quiet—All LEDs are off.

·     awake—All LEDs flash once every minute.

·     always-on—All LEDs are steady on.

·     normalHow LEDs flash in this mode varies by AP model.

Remote configuration

Remote configuration assignment:

·     Enabled.

·     Disabled.

Basic BSSID

MAC address of the radio. This field displays N/A if the AP has not established a CAPWAP tunnel with the AC.

Admin state

Radio state:

·     Up.

·     Down.

Radio type

Wireless mode:

·     2.4 GHz.

¡     802.11b.

¡     802.11g.

¡     802.11n(2.4GHz).

·     5 GHz.

¡     802.11a.

¡     802.11n(5GHz).

¡     802.11ac.

Client dot11ac-only

·     Disabled—Allows 802.11a/b/g/n/ac clients to associate with the radio.

·     Enabled—Allows only 802.11ac clients to associate with the radio.

Client dot11n-only

·     Disabled—Allows 802.11a/b/g/n/ac clients to associate with the radio.

·     Enabled—Allows only 802.11n or 802.11ac clients to associate with the radio.

Channel band-width

Channel bandwidth:

·     20 MHz.

·     20 or 40 MHz.

·     20/40/80 MHz.

Active band-width

Running radio bandwidth.

Secondary channel offset

Secondary channel information for the 802.11n and 802.11ac radio modes:

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

·     SCNThe AP does not operate in 40 MHz bandwidth mode.

Short GI for 20MHz

Whether the radio supports short GI when it operates in 20 MHz mode.

Short GI for 40MHz

Whether the radio supports short GI when it operates in 40 MHz mode.

Short GI for 80MHz

Whether the radio supports short GI when it operates in 80 MHz mode.

Short GI for 160MHz

Whether the radio supports short GI when it operates in 160 MHz mode.

A-MSDU

·     Disabled.

·     Enabled.

A-MPDU

·     Disabled.

·     Enabled.

LDPC

·     Supported.

·     Not supported.

STBC

·     Supported.

·     Not supported.

Operational VHT MCS Set

·     Supported—Supported VHT MCS set.

·     Mandatory—Mandatory VHT MCS set.

·     MulticastMulticast VHT MCS set.

Operational HT MCS Set

·     Supported—Supported MCS set.

·     Mandatory—Mandatory MCS set.

·     MulticastMulticast MCS set.

Channel

·     This field displays Number<auto> if the current channel is the optimal channel automatically selected by the AP.

·     This field displays Number if the current channel is manually configured.

·     This field displays Number<avoid radar> if the current channel is automatically selected by the AP to avoid radar signals.

Max power

Maximum transmission power of the radio.

Preamble type

Preamble type:

·     Short.

·     Long.

Operational rate

·     Mandatory.

·     Supported.

·     Multicast.

·     Disabled.

·     Not configured.

Distance

Maximum distance that the radio signal can reach.

ANI

·     Enabled.

·     Disabled.

Protection threshold

Frame length threshold required for triggering the protection mechanism.

Long retry threshold

Maximum number of retransmission attempts for frames whose length exceed the RTS threshold.

Short retry threshold

Maximum number of retransmission attempts for frames whose length is no more than the RTS threshold.

Maximum rx duration

Maximum buffer duration for frames.

Smart antenna

·     Enabled.

·     Disabled.

Smart antenna policy

·     Auto.

·     High availability.

·     High throughput.

Protection mode

Conflict avoidance mode:

·     cts-to-self.

·     rts-cts.

Continuous mode

Continuous mode configuration:

·     Transmission rate.

·     MCS index.

·     NSS index.

·     VHT-MCS index.

This field displays N/A if the continuous mode is not configured.

HT protection mode

802.11n protection mode:

·     No protection.

¡     AP-associated clients and nearby wireless devices are operating in 802.11n mode and AP-associated clients are 802.11n clients with a bandwidth of 40 MHz.

¡     AP-associated clients are 802.11n clients with a bandwidth of 20 MHz.

·     Non-member protection.
In this mode, all AP-associated clients are 802.11n clients but some nearby wireless devices are non-802.11n clients.

·     20 MHz protection.
In this mode, the AP's radio has a bandwidth of 40 MHz. AP-associated clients and nearby wireless devices are operating in 802.11n mode and a minimum of one 802.11n client with a bandwidth of 20 MHz is associated with the AP's radio.

·     Non-HT mixed.
The mode applies when none of the above mentioned modes can apply.

MU-TxBF

·     Enabled.

·     Disabled.

Support for this field depends on the AP model.

SU-TxBF

·     Enabled.

·     Disabled.

Support for this field depends on the AP model.

 

display wlan ap address

Use display wlan ap address to display AP address information.

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

all: Specifies all APs.

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

Examples

# Display address information for all APs.

<Sysname> display wlan ap all address

Total number of APs: 1

Total number of connected APs: 1

Total number of connected manual APs: 1

Total number of connected auto APs: 0

Total number of inside APs: 0

AP name                          IP address                     MAC address

ap1                              1.1.1.5                        000b-6b8f-fc6a

Table 3 Command output

Field

Description

Total number of APs

Total number of common APs, WTs, and WTUs.

Total number of connected APs

Total number of connected common APs, WTs, and WTUs.

Total number of connected manual APs

Total number of connected manual common APs, WTs, and WTUs.

Total number of connected auto APs

Total number of connected auto common APs, WTs, and WTUs.

Total number of inside APs

Total number of connected inside APs. Inside APs are manual APs that are automatically created when anchor APs act as ACs. The name and the serial ID of an inside AP are the local MAC address and local serial ID, respectively.

AP name

Name of an AP.

IP address

IP address of an AP.

This field displays N/A for an offline AP.

MAC address

MAC address of an AP.

This field displays N/A for an offline AP.

 

display wlan ap association-failure-record

Use display wlan ap association-failure-record to display association failure records for APs.

Syntax

display wlan ap association-failure-record

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display association failure records for APs.

<Sysname> display wlan ap association-failure-record

MAC address     AP ID   Last failure at      Reason

9a48-45ed-0300  12312   07-07/15:56:25       AP authentication failed

Table 4 Command output

Field

Description

MAC address

MAC address of an AP.

AP ID

ID of an AP, which uniquely identifies the AP on the AC.

Last failure at

Last time an AP associated with the AC. The format is date/hh:mm:ss.

Reason

Association failure reason:

·     Memory is not enough.

·     The AP model doesn't exist.

·     Lack of AP license.

·     MAC address was used.

·     Failed to add APLB.

·     AP chose another AC.

·     Reached AC max capability.

·     Received join request in Run state.

·     APLB check failed.

·     Rejected AP access in HA smooth.

·     AP authentication failed.

·     Failed to create auto AP.

·     Manual AP online info check failed.

·     Failed to add index.

·     Mismatched AP and AC versions.

·     Wait request timer expired.

·     Received failure result code.

·     Failed to add tunnel.

·     AP configuration was not found.

·     Inconsistent AP IDs.

·     Failed to add AP basic running data.

·     Failed to communicate with the other board.

 

display wlan ap connection

Use display wlan ap connection to display AP connection records on the AC.

Syntax

display wlan ap connection record { all | name ap-name }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

all: Specifies all APs.

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

Examples

# Display all AP connection records on the AC.

<Sysname> display wlan ap connection record all

AP name                         IP address    State     Time

ap1                             2001::3       Run       05-06 09:47:44

ap2                             2001::5       Run       05-06 09:50:38

Table 5 Command output

Field

Description

State

Current state of the AP:

·     Idle—Idle.

·     Run—The CAPWAP tunnel is operating. It indicates that the AP and the AC have established a CAPWAP tunnel successfully.

Time

Most recent time when the AP established a CAPWAP tunnel with the AC.

 

display wlan ap files

Use display wlan ap files to display information about files and file folders on an AP.

Syntax

display wlan ap files name ap-name

Views

Any view

Predefined user roles

network-admin

network-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 (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

Examples

# Display information about files and file folders on AP ap1.

<Sysname> display wlan ap files name ap1

Directory of flash:

   0   13638656  wa4300-system.bin

   1   2573312   wa4300-boot.bin

131072 KB total (114208 KB free)

Table 6 Command output

Field

Description

0   13638656  xx.xx

File or file folder information:

·     0—Serial number, which is automatically assigned by the system.

·     13638656— File size in bytes. A hyphen (-) is displayed if it is a file folder.

·     xx.xx—Name of the file or file folder.

 

Related commands

·     delete file

·     download file

display wlan ap gps

Use display wlan ap gps to display Global Positioning System (GPS) information for the specified APs.

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

all: Specifies all APs.

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

Usage guidelines

This command takes effect only on APs that support the GPS module.

Examples

# Display GPS information for AP ap1.

<Sysname> display wlan ap name ap1 gps

AP name    : ap1

Serial ID  : 219801A17C817200001

Model      : WA5630X

Longitude  : 117.788887

Latitude   : 30.822136

Velocity   : 25.445878

Orientation: 8.054548

Elevation  : 156.655897

Obtained at: 2017-02-20 15:32:19

Table 7 Command output

Field

Description

AP name

Name of the AP.

Serial ID

Serial ID of the AP.

Model

AP model.

Longitude

Longitude rounded to six decimal places.

Latitude

Latitude rounded to six decimal places.

Velocity

Horizontal velocity rounded to six decimal places.

Orientation

Orientation rounded to six decimal places.

Elevation

Elevation rounded to six decimal places.

Obtained at

Time when the GPS information was obtained.

 

display wlan ap online-time

Use display wlan ap online-time to display the online duration for APs.

Syntax

display wlan ap online-time { all | name ap-name }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

all: Specifies all APs.

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

Examples

# Display online duration for all APs.

<Sysname> display wlan ap online-time all

AP name            IP address               Time

ap1                1.1.1.2                  0 days 0 hours 2 minutes 6 seconds

ap2                1.1.1.1                  0 days 0 hours 5 minutes 6 seconds

ap3                1.1.1.6                  0 days 0 hours 2 minutes 1 seconds

Table 8 Command output

Field

Description

IP address

IP address of an AP.

Time

Realtime association duration of an AP since the AP came online.

 

display wlan ap 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

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 (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

verbose: Displays detailed running configuration.

Examples

# Display detailed running configuration for all APs.

<Sysname> display wlan ap 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

  serial-id 210235A1BSC123000050

  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)

display wlan ap reboot-log

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

Syntax

display wlan ap reboot-log name ap-name

Views

Any view

Predefined user roles

network-admin

network-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 (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).

Usage guidelines

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

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

Examples

# Display reboot logs for AP ap1.

<Sysname> display wlan ap 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

display wlan ap tunnel-down-record

Use display wlan ap tunnel-down-record to display CAPWAP tunnel down records.

Syntax

display wlan ap tunnel-down-record

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display CAPWAP tunnel down records.

<Sysname> display wlan ap tunnel-down-record

AP ID   AP name          Tunnel down at        Tunnel down reason

12321   9a48-45ed-0300   2017-07-07/15:56:25   Processed join request in Run state

Table 9 Command output

Field

Description

AP ID

ID of an AP, which uniquely identifies the AP on the AC.

AP name

Name of an AP.

Tunnel down at

Time when the CAPWAP tunnel between an AP and the AC went down. The format is date/hh:mm:ss.

Tunnel down reason

CAPWAP tunnel down reason:

·     Failed to create timer.

·     Neighbor dead timer expired.

·     Request wait timer expired.

·     Data check timer expired.

·     Failed to process keepalive message.

·     Failed to process request.

·     AP was reset by admin.

·     AP was reset by CloudTunnel.

·     AP was reset on Cloud.

·     WT was offline.

·     AP was deleted.

·     Failed to come online.

·     Serial number changed.

·     MAC address changed.

·     Exceeded AC max capability.

·     Processed join request in Run state.

·     Failed to create AP context.

·     Received failure result code.

·     Failed to retransmit message.

·     Failed to download image file.

·     Image file downloaded successfully.

·     File operation timer expired.

·     Failed to add tunnel.

·     Received WTP tunnel down event from AP.

·     Backup AC closed the backup tunnel.

·     Master and backup tunnel switchover.

·     Failed to inherit configuration.

·     AP authentication failed.

·     Backup AP upgrade failed.

·     Board is inactive.

·     WT went offline.

·     Lack of AP license.

 

display wlan ap-distribution

Use display wlan ap-distribution to display distribution information of attached APs for ACs.

Syntax

display wlan ap-distribution { all | slot slot-number }

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

all: Specifies all ACs.

slot slot-number: Specifies an IRF member device by its member ID.

Examples

# Display distribution information for APs attached to the specified slot.

<Sysname> display wlan ap-distribution slot 0

Total number of APs: 1

                                 AP information

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

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

 

AP name                        APID  State Model           Serial ID

722a-d561-0300                 4     R/M   WA4320i-ACN     210235A1BSC123000050

Table 10 Command output

Field

Description

APID

ID of the AP to uniquely identify the AP on the AC.

State

Current state of the AP:

·     I—Idle.

·     J—Join.

·     JA—Join acknowledge.

·     IL—The AP is downloading the software image version.

·     C—The AP is downloading initial configurations.

·     DC—The AP is checking data.

·     R—The CAPWAP tunnel is operating. It indicates that the AP and the AC have established a CAPWAP tunnel successfully.

·     R/M—The master CAPWAP tunnel is operating. It indicates that the AP and the master AC have established a CAPWAP tunnel successfully.

·     R/B—The backup CAPWAP tunnel is operating. It indicates that the AP and the backup AC have established a CAPWAP tunnel successfully.

·     M—The AP is connected to the master AC.

·     B—The AP is connected to the backup AC.

Model

AP model information.

Serial ID

Serial ID of the AP. This field displays Not configured if the serial ID of the AP is not configured.

 

display wlan ap-distribution ap-name

Use display wlan ap-distribution ap-name to display the attachment location of an AP.

Syntax

display wlan ap-distribution ap-name ap-name

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

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

Examples

# Display the attachment location of AP ap1.

<Sysname> display wlan ap-distribution ap-name ap1

The AP is attached to slot 0.

display wlan ap-group

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

Syntax

display wlan ap-group [ brief | name group-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

brief: Displays brief information about all AP groups.

name group-name: Displays detailed information about the specified AP group. The group-name argument represents the name of an AP group, a case-insensitive string of 1 to 31 characters.

Usage guidelines

If you do not specify any parameter, this command displays detailed information about all AP groups.

Examples

# Display detailed information about all AP groups.

[Sysname] display wlan ap-group

Total number of AP groups: 2

AP group name       : default-group

Description         : Not configured

AP model            : Not configured

APs                 : Not configured

 

AP group name       : group1

Description         : abcd

AP model            : WA4320i-ACN

AP grouping rules:

  AP name           : ap1, ap2

  Serial ID         : 219801A0CNC138011454

  MAC address       : 0AFB-423B-893C

  IPv4 address      : Not configured

  IPv6 address      : Not configured

APs                 : ap1 (AP name)

# Display detailed information about AP group group1.

[Sysname] display wlan ap-group group1

AP group name       : group1

Description         : Not configured

AP model            : WA4320i-ACN

AP grouping rules:

  AP name           : ap1, ap2

  Serial ID         : 219801A0CNC138011454

  MAC address       : 0AFB-423B-893C

  IPv4 address      : Not configured

  IPv6 address      : Not configured

APs                 : ap1 (AP name)

# Display brief information about all AP groups.

<Sysname> display wlan ap-group brief

Total number of AP groups: 4

AP group name                  Group ID  Member APs   Online APs

default-group                  1         1            0

group1                         2         2006         1986

group2                         3         10           10

group3                         4         4            4

Related commands

wlan ap-group

display wlan ap-model

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

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-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

License weight  : 100

Radio count     : 2

 Radio 1:

  Mode          : 802.11a, 802.11an, 802.11ac

  Default mode  : 802.11ac

  BSS count     : 16

 Radio 2:

  Mode          : 802.11b, 802.11g, 802.11gn

  Default mode  : 802.11gn

  BSS count     : 16

Version Support List :

 Hardware Version Ver.A:

  Software Version         : R2206P02

  Default Software Version : R2206P02

  Image Name               : wa4300.ipe

 Hardware Version Ver.B:

  Software Version         : R2206P02

  Default Software Version : R2206P02

  Image Name               : wa4300.ipe

 Hardware Version Ver.C:

  Software Version         : R2206P02

  Default Software Version : R2206P02

  Image Name               : wa4300.ipe

 Hardware Version Ver.D:

  Software Version         : R2206P02

  Default Software Version : R2206P02

  Image Name               : wa4300.ipe

 Hardware Version Ver.E:

  Software Version         : R2206P02

  Default Software Version : R2206P02

  Image Name               : wa4300.ipe

Hardware Version Ver.F:

  Software Version         : R2206P02

  Default Software Version : R2206P02

  Image Name               : wa4300.ipe

Table 11 Command output

Field

Description

AP model

AP model name.

Alias

AP model alias.

License weight

Weight of the AP model in using an AP license, in percentage.

Radio count

Number of radios.

Mode

Supported radio types.

Default mode

Default radio type.

BSS count

Maximum number of BSSs that the radio supports.

Software Version

AP' software version used to compare with the software version reported by the AP.

The default value is the AP software version stored in the APDB.

Default Software Version

AP software version stored in the APDB.

Image Name

Name of the AP image file.

 

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

Parameters

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

Usage guidelines

Make sure CAPWAP tunnel latency detection is started 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 12 Command output

Field

Description

Tunnel latency

·     Disabled.

·     Enabled.

Current delay

The most recent delay.

 

Related commands

·     reset wlan tunnel latency ap

·     tunnel latency-detect

dns domain

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

Use undo dns domain to restore the default.

Syntax

dns domain domain-name

undo dns domain

Default

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

In AP group provision view, no domain name is specified for an AP.

Views

AP provision view

AP group provision view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

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

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

Examples

# Set the domain name for AP ap1 to com.

<Sysname> system-view

[Sysname] wlan ap ap1 model 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

dns server

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

Use undo dns server to restore the default.

Syntax

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

undo dns server { ip | ipv6 }

Default

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

In AP group provision view, no DNS server is specified for an AP.

Views

AP provision view

AP group provision view

Predefined user roles

network-admin

Parameters

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

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

Usage guidelines

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

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

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

Examples

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

<Sysname> system-view

[Sysname] wlan ap ap1 model 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

download file

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

Syntax

download file filename

Views

AP view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

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

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

echo-count

Use echo-count to set the maximum number of echo request transmission attempts.

Use undo echo-interval to restore the default.

Syntax

echo-count count

undo echo-count

Default

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

In AP group view, the maximum number of echo request transmission attempts is 3.

 Views

AP view

AP group view

Predefined user roles

network-admin

Parameters

count: Specifies the maximum number of echo request transmission attempts in the range of 3 to 60.

Usage guidelines

An AP sends echo requests to the AC at the specified echo interval to identify whether the CAPWAP control tunnel is operating correctly. The AC responds by sending echo responses. If the AP does not receive any echo responses within the keepalive time, the AP terminates the connection. If the AC does not receive any echo requests within the keepalive time, the AC terminates the connection. The keepalive time is the echo interval multiplied by the maximum number of echo request transmission attempts.

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

Examples

# Set the maximum number of echo request transmission attempts to 5 for AP ap3.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA4320i-ACN

[Sysname-wlan-ap-ap3] echo-count 5

# Set the maximum number of echo request transmission attempts to 5 for APs in AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] echo-count 5

echo-interval

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

Use undo echo-interval to restore the default.

Syntax

echo-interval interval

undo echo-interval

Default

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

In AP group view, the interval for sending echo requests is 10 seconds.

Views

AP view

AP group view

Predefined user roles

network-admin

Parameters

interval: Specifies the interval for sending echo requests, in 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 control 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 the keepalive time. If the AP does not receive any echo responses within the keepalive time, the AP terminates the connection. The keepalive time is the echo interval multiplied by the maximum number of echo request transmission attempts set by using the echo-count count command.

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

Examples

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

<Sysname> system-view

[Sysname] wlan ap ap3 model 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

firmware-upgrade

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

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

Use undo firmware-upgrade to restore the default.

Syntax

firmware-upgrade { disable | enable }

undo firmware-upgrade

Default

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

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

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

Views

AP view

AP group view

Global configuration view

Predefined user roles

network-admin

Parameters

disable: Disables the software upgrade feature.

enable: Enables the software upgrade feature.

Usage guidelines

This feature enables the AC to examine whether an AP's software version matches the hardware version and software version mappings stored on the AC during CAPWAP tunnel establishment.

·     If a match is found, the AC establishes a CAPWAP tunnel with the AP.

·     If no match is found, the CAPWAP tunnel establishment proceeds as follows:

a.     The AC notifies the AP of software version inconsistency.

b.     After receiving the notification, the AP requests the software version from the AC, and then upgrades the software to establish a CAPWAP tunnel with the AC.

When this feature is disabled, the AC does not examine the software version of an AP and directly establishes a CAPWAP tunnel with the AP.

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

Examples

# Enable the software upgrade feature for AP ap3.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA4320i-ACN

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

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

<Sysname> system-view

[Sysname] wlan ap-group group1

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

# Enable the software upgrade feature globally.

<Sysname> system-view

[Sysname] wlan global-configuration

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

Related commands

wlan apdb

fragment-size

Use fragment-size to set the maximum fragment size for CAPWAP control or data packets.

Use undo fragment-size to remove the configuration.

Syntax

fragment-size { control control-size | data data-size }

undo fragment-size { control | data }

Default

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

In AP group view, the maximum fragment size for CAPWAP control packets and data packets is 1450 bytes and 1500 bytes, respectively.

Views

AP view

AP group view

Predefined user roles

network-admin

Parameters

control control-size: Specifies the maximum fragment size for CAPWAP control packets in bytes. The value range for the control-size argument is 1000 to 1450.

data data-size: Specifies the maximum fragment size for CAPWAP data packets in bytes. The value range for the control-size argument is 1000 to 1748.

Usage guidelines

This command prevents intermediate devices from dropping packets between AC and AP if the AP connects to the AC across the Internet.

Any maximum fragment size modification takes effect immediately on online APs.

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

Examples

# Set the maximum fragment size for CAPWAP data packets to 1500 bytes for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-ap-ap1] fragment-size data 1500

# Set the maximum fragment size for CAPWAP data packets to 1500 bytes for APs in AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] fragment-size data 1500

gateway

Use gateway to specify a gateway for an AP.

Use undo gateway to restore the default.

Syntax

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

undo gateway { ip | ipv6 }

Default

No gateway is specified for an AP.

Views

AP provision view

Predefined user roles

network-admin

Parameters

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

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

Usage guidelines

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

Examples

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

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] provision

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

gigabitethernet

 

NOTE:

Support for this command depends on the AP model.

 

Use gigabitethernet to enter the GigabitEthernet interface view of an AP.

Syntax

gigabitethernet interface-number

Views

AP view

AP group's AP model view

Predefined user roles

network-admin

Parameters

interface-number: Specifies an interface number. The value range varies by AP model.

Examples

# Enter the interface view of GigabitEthernet 1 from AP view.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] gigabitethernet 1

[Sysname-wlan-ap-ap1-gigabitethernet-1]

# Enter the interface view of GigabitEthernet 1 from the AP model view of AP group 1.

<Sysname> system-view

[Sysname] wlan ap-group group1

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

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

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

hybrid-remote-ap

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

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

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

Syntax

hybrid-remote-ap { disable | enable }

undo hybrid-remote-ap

Default

In AP view, an 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

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.

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

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

if-match ip

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

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

Syntax

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

undo if-match ip [ ip-address { mask-length | mask } ]

Default

No AP grouping rules by IP addresses are configured.

Views

AP group view

Predefined user roles

network-admin

Parameters

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

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

mask: Specifies the mask in dotted decimal notation.

Usage guidelines

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

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

An AP group supports a maximum of 32 AP grouping rules by IPv4 addresses.

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

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

If you do not specify any argument in the undo form of the command, the command deletes all AP grouping rules by IPv4 addresses.

Examples

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

<Sysname> system-view

[Sysname] wlan ap-group group1

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

if-match ipv6

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

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

Syntax

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

undo if-match ip [ ipv6-address prefix-length | ipv6-address/prefix-length ]

Default

No AP grouping rules by IPv6 addresses are configured.

Views

AP group view

Predefined user roles

network-admin

Parameters

ipv6-address: Specifies an IPv6 address.

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

Usage guidelines

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

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

An AP group supports a maximum of 32 AP grouping rules by IPv6 addresses.

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

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

If you do not specify any argument in the undo form of the command, the command deletes all AP grouping rules by IPv6 addresses.

Examples

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

<Sysname> system-view

[Sysname] wlan ap-group group1

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

ip address

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

Use undo ip address to restore the default.

Syntax

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

undo ip address

Default

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

Views

AP provision view

Predefined user roles

network-admin

Parameters

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

mask: Specifies the mask in dotted decimal notation.

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

Usage guidelines

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

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

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

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

Examples

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

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] provision

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

ipv6 address

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

Use undo ipv6 address to restore the default.

Syntax

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

undo ipv6 address

Default

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

Views

AP provision view

Predefined user roles

network-admin

Parameters

ipv6-address: Specifies an IPv6 address.

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

Usage guidelines

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

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

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

Examples

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

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] provision

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

keepalive-interval

Use keepalive-interval to set the data tunnel keepalive interval.

Use undo keepalive-interval to restore the default.

Syntax

keepalive-interval interval

undo keepalive-interval

Default

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

In AP group view, the data tunnel keepalive interval is 10 seconds.

Views

AP view

AP group view

Predefined user roles

network-admin

Parameters

interval: Specifies the interval for an AP to send keepalive packets through the CAPWAP data tunnel. The value range is 1 to 255 seconds.

Examples

# Set the data tunnel keepalive interval for AP ap1 to 15 seconds.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] keepalive-interval 15

# Set the data tunnel keepalive interval for APs in AP group 1 to 15 seconds.

<Sysname> system-view

[Sysname] wlan ap-group 1

[Sysname-ap-group-1] keepalive-interval 15

led-mode

Use led-mode to set a LED lighting mode.

Use undo led-mode to restore the default.

Syntax

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

undo led-mode

Default

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

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

Views

AP view

AP group view

Predefined user roles

network-admin

Parameters

always-on: Specifies the always-on mode. Support for this keyword depends on the AP model.

awake: Specifies the awake mode. Support for this keyword depends on the AP model.

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

quiet: Specifies the quiet mode.

Usage guidelines

If you set the LED lighting mode to awake or always-on in AP group view, the setting takes effect only on member APs that support the specified LED lighting mode.

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

Examples

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

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

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

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

<Sysname> system-view

[Sysname] wlan ap-group g1

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

mac-address (AP group view)

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

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

Syntax

mac-address mac-address

undo mac-address mac-address

Default

No AP grouping rules by MAC addresses are configured.

Views

AP group view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

This command does not identify whether the specified AP exists.

You can configure multiple AP grouping rules by MAC addresses.

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

If an AP grouping rule already exists in an AP group, this command deletes the rule from the AP group.

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

Examples

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

<Sysname> system-view

[Sysname] wlan ap-group group1

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

Related commands

wlan ap-group

mac-address (AP view)

Use mac-address to specify the MAC address for an AP.

Use undo mac-address to restore the default.

Syntax

mac-address mac-address

undo mac-address

Default

No MAC address is specified for an AP.

Views

AP view

Predefined user roles

network-admin

Parameters

mac-address: Specifies the MAC address for an AP, 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

# Set the MAC address of AP ap1 to 0001-0000-0000.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

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

name

 

NOTE:

Support for this command depends on the AP model.

 

Use name to assign a name to an AP's VLAN.

Use undo name to restore the default.

Syntax

name text

undo name

Default

In an AP's VLAN view, a VLAN uses the configuration in an AP group's VLAN view.

In an AP group's VLAN view, the name of a VLAN is VLAN vlan-id. The vlan-id argument specifies the VLAN ID in a four-digit format. If the VLAN ID has less than four digits, leading zeros are added. For example, the name of VLAN 100 is VLAN 0100.

Views

AP's VLAN view

AP group's VLAN view

Predefined user roles

network-admin

Parameters

text: Specifies a VLAN name, a case-sensitive string of 1 to 32 characters.

Usage guidelines

For this command to take effect on an AP, make sure the remote configuration assignment feature is enabled.

The configuration in AP's VLAN view takes precedence over the configuration in AP group's VLAN view.

Examples

# Assign name test vlan to VLAN 2 of AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] vlan 2

[Sysname-wlan-ap-ap1-vlan2] name test vlan

# Assign name test vlan to VLAN 2 of all APs in AP group 1.

<Sysname> system-view

[Sysname] wlan ap-group 1

[Sysname-wlan-ap-group-1] vlan 2

[Sysname-wlan-ap-group-1-vlan2] name test vlan

Related commands

remote-configuration

poe port

 

NOTE:

Support for this command depends on the AP model.

 

Use poe port enable to enable PoE for power interfaces (PIs).

Use poe port disable to disable PoE for PIs.

Use undo poe port to restore the default.

Syntax

poe port port-number1 [ to port-number2 ] { disable | enable }

undo poe port port-number1 [ to port-number2 ]

Default

In AP view, an AP uses the configuration in AP group's AP model view.

In AP group's AP model view, PoE is disabled for PIs.

Views

AP view

AP group's AP model view

Predefined user roles

network-admin

Parameters

port-number1: Specifies a PI by its port number. The value range varies by device model.

port-number1 to port-number2: Specifies a port range. The port-number1 argument represents the start port number, and the port-number2 argument represents the end port number. The end port number cannot be smaller than the start port number. The value range for a port number varies by device model.

Examples

# Disable PoE for PI 3 of AP ap1 with AP model UAP300.

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-wlan-ap-ap1] poe port 3 disable

# Disable PoE for PI 3 of all APs with AP model UAP300 in AP group 1.

<Sysname> system-view

[Sysname] wlan ap-group 1

[Sysname-wlan-ap-group-1] ap-model UAP300

[Sysname-wlan-ap-group-1-ap-model-UAP300] poe port 3 disable

port access vlan

 

NOTE:

Support for this command depends on the AP model.

 

Use port access vlan to assign an access port on an AP to the specified VLAN.

Use undo port access vlan to restore the default.

Syntax

port access vlan vlan-id

undo port access vlan

Default

In an AP's Layer 2 Ethernet interface view, an access port uses the configuration in an AP group's Layer 2 Ethernet interface view.

In an AP group's Layer 2 Ethernet interface view, all access ports on an AP belong to VLAN 1.

Views

AP's Layer 2 Ethernet interface view

AP group's Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

vlan-id: Specifies a VLAN by its ID in the range of 1 to 4094.

Usage guidelines

Before assigning an access port to a VLAN, make sure the VLAN has been created.

For this command to take effect on an AP, make sure the remote configuration assignment feature is enabled.

The configuration in AP's Layer 2 Ethernet interface view takes precedence over the configuration in AP group's Layer 2 Ethernet interface view.

Examples

# Assign GigabitEthernet 1 to VLAN 3 in the Layer 2 Ethernet interface view of AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] gigabitethernet 1

[Sysname-wlan-ap-ap3-gigabitethernet-1] port access vlan 3

# Assign GigabitEthernet 1 to VLAN 3 in the Layer 2 Ethernet interface view of APs with model WA4320i-ACN in AP group 1.

<Sysname> system-view

[Sysname] wlan ap-group 1

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

[Sysname-wlan-ap-group-1-ap-model-WA4320i-ACN] gigabitethernet 1

[Sysname-wlan-ap-group-1-ap-model-WA4320i-ACN-gigabitethernet-1] port access vlan 3

Related commands

remote-configuration

port hybrid pvid

 

NOTE:

Support for this command depends on the AP model.

 

Use port hybrid pvid to set the PVID of a hybrid port on an AP.

Use undo port hybrid pvid to set the PVID of a hybrid port on an AP to 1.

Syntax

port hybrid pvid vlan vlan-id

undo port hybrid pvid

Default

In an AP's Layer 2 Ethernet interface view, a hybrid port uses the configuration in an AP group's Layer 2 Ethernet interface view.

In an AP group's Layer 2 Ethernet interface view, the PVID of a hybrid port is the ID of the VLAN to which the port belongs when its link type is access.

Views

AP's Layer 2 Ethernet interface view

AP group's Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

vlan-id: Specifies a VLAN by its ID in the range of 1 to 4094.

Usage guidelines

You can use a nonexistent VLAN as the PVID of a hybrid port. When you delete the PVID of a hybrid port by using the undo vlan command, the PVID setting of the port does not change.

For correct packet transmission, set the same PVID for a hybrid port on an AP and the hybrid port on the switch connected to the AP.

To enable a hybrid port to transmit packets from its PVID, you must assign the hybrid port to the PVID by using the port hybrid vlan command.

For this command to take effect on an AP, make sure the remote configuration assignment feature is enabled.

The configuration in AP's Layer 2 Ethernet interface view takes precedence over the configuration in AP group's Layer 2 Ethernet interface view.

Examples

# Configure GigabitEthernet 1 as a hybrid port, and set its PVID to VLAN 100 in Layer 2 Ethernet interface view of AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] gigabitethernet 1

[Sysname-wlan-ap-ap1-gigabitethernet-1] port link-type hybrid

[Sysname-wlan-ap-ap1-gigabitethernet-1] port hybrid pvid vlan 100

# Configure GigabitEthernet 1 as a hybrid port, and set its PVID to VLAN 100 in Layer 2 Ethernet interface view of APs with model WA4320i-ACN in AP group 1.

<Sysname> system-view

[Sysname] wlan ap-group 1

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

[Sysname-wlan-ap-group-1-ap-model-WA4320i-ACN] gigabitethernet 1

[Sysname-wlan-ap-group-1-ap-model-WA4320i-ACN-gigabitethernet-1] port link-type hybrid

[Sysname-wlan-ap-group-1-ap-model-WA4320i-ACN-gigabitethernet-1] port hybrid pvid vlan 100

Related commands

·     port hybrid vlan

·     port link-type

·     remote-configuration

port hybrid vlan

 

NOTE:

Support for this command depends on the AP model.

 

Use port hybrid vlan to assign a hybrid port to the specified VLANs.

Use undo port hybrid vlan to remove a hybrid port from the specified VLANs.

Syntax

port hybrid vlan vlan-id-list { tagged | untagged }

undo port hybrid vlan vlan-id-list

Default

In an AP's Layer 2 Ethernet interface view, a hybrid port uses the configuration in an AP group's Layer 2 Ethernet interface view.

In an AP group's Layer 2 Ethernet interface view, a hybrid port is an untagged member of the VLAN to which the port belongs when its link type is access.

Views

AP's Layer 2 Ethernet interface view

AP group's Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

vlan-id-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN ID or a range of VLAN IDs in the form of vlan-id1 to vlan-id2. The value range for VLAN IDs is 1 to 4094. The value for the vlan-id2 argument cannot be lower than the value for the vlan-id1 argument. The specified VLANs must already exist on the device.

tagged: Configures the port as a tagged member of the specified VLANs. A tagged member of a VLAN sends packets from the VLAN without removing VLAN tags.

untagged: Configures the port as an untagged member of the specified VLANs. An untagged member of a VLAN sends packets from the VLAN after removing VLAN tags.

Usage guidelines

A hybrid port can allow multiple VLANs. If you execute this command multiple times on a hybrid port, the hybrid port allows all the specified VLANs.

For this command to take effect on an AP, make sure the remote configuration assignment feature is enabled.

The configuration in AP's Layer 2 Ethernet interface view takes precedence over the configuration in AP group's Layer 2 Ethernet interface view.

Examples

# In Layer 2 Ethernet interface view of AP ap1, perform the following tasks:

1.     Configure GigabitEthernet 1 as a hybrid port.

2.     Assign it to VLAN 2, VLAN 4, and VLAN 50 through VLAN 100 as a tagged member.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] gigabitethernet 1

[Sysname-wlan-ap-ap1-gigabitethernet-1] port link-type hybrid

[Sysname-wlan-ap-ap1-gigabitethernet-1] port hybrid vlan 2 4 50 to 100 tagged

# In Layer 2 Ethernet interface view of APs with model WA4320i-ACN in AP group 1, perform the following tasks:

1.     Configure GigabitEthernet 1 as a hybrid port.

2.     Assign it to VLAN 2, VLAN 4, and VLAN 50 through VLAN 100 as a tagged member.

<Sysname> system-view

[Sysname] wlan ap-group 1

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

[Sysname-wlan-ap-group-1-ap-model-WA4320i-ACN] gigabitethernet 1

[Sysname-wlan-ap-group-1-ap-model-WA4320i-ACN-gigabitethernet-1] port link-type hybrid

[Sysname-wlan-ap-group-1-ap-model-WA4320i-ACN-gigabitethernet-1] port hybrid vlan 2 4 50 to 100 tagged

Related commands

·     port link-type

·     remote-configuration

port link-type

 

NOTE:

Support for this command depends on the AP model.

 

Use port link-type to set the link type of an Ethernet port on an AP.

Use undo port link-type to restore the default.

Syntax

port link-type { access | hybrid | trunk }

undo port link-type

Default

In an AP's Layer 2 Ethernet interface view, an Ethernet port uses the configuration in an AP group's Layer 2 Ethernet interface view.

In an AP group's Layer 2 Ethernet interface view, each Ethernet port is an access port.

Views

AP's Layer 2 Ethernet interface view

AP group's Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

access: Sets the port link type to access.

hybrid: Sets the port link type to hybrid.

trunk: Sets the port link type to trunk.

Usage guidelines

To change the link type of an Ethernet port from trunk to hybrid or vice versa, first set the link type to access.

For this command to take effect on an AP, make sure the remote configuration assignment feature is enabled.

The configuration in AP's Layer 2 Ethernet interface view takes precedence over the configuration in AP group's Layer 2 Ethernet interface view.

Examples

# Configure GigabitEthernet 1 as a trunk port in Layer 2 Ethernet interface view of AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] gigabitethernet 1

[Sysname-wlan-ap-ap1-gigabitethernet-1] port link-type trunk

# Configure GigabitEthernet 1 as a trunk port in Layer 2 Ethernet interface view of APs with model WA4320i-ACN in AP group 1.

<Sysname> system-view

[Sysname] wlan ap-group 1

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

[Sysname-wlan-ap-group-1-ap-model-WA4320i-ACN] gigabitethernet 1

[Sysname-wlan-ap-group-1-ap-model-WA4320i-ACN-gigabitethernet-1] port link-type trunk

Related commands

remote-configuration

port trunk permit vlan

 

NOTE:

Support for this command depends on the AP model.

 

Use port trunk permit vlan to assign a trunk port to the specified VLANs.

Use undo port trunk permit vlan to remove a trunk port from the specified VLANs.

Syntax

port trunk permit vlan { vlan-id-list | all }

undo port trunk permit vlan { vlan-id-list | all }

Default

In an AP's Layer 2 Ethernet interface view, a trunk port uses the configuration in an AP group's Layer 2 Ethernet interface view.

In an AP group's Layer 2 Ethernet interface view, a trunk port allows only packets from VLAN 1 to pass through.

Views

AP's Layer 2 Ethernet interface view

AP group's Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

vlan-id-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN ID or a range of VLAN IDs in the form of vlan-id1 to vlan-id2. The value range for VLAN IDs is 1 to 4094. The value for the vlan-id2 argument cannot be lower than the value for the vlan-id1 argument.

all: Specifies all VLANs.

Usage guidelines

A trunk port can allow multiple VLANs. If you execute this command multiple times on a trunk port, the trunk port allows all the specified VLANs.

On a trunk port, packets only from the PVID can pass through untagged.

To prevent unauthorized VLAN users from accessing restricted resources through the port, use the port trunk permit vlan all command with caution.

For this command to take effect on an AP, make sure the remote configuration assignment feature is enabled.

The configuration in AP's Layer 2 Ethernet interface view takes precedence over the configuration in AP group's Layer 2 Ethernet interface view.

Examples

# Configure GigabitEthernet 1 as a trunk port, and assign it to VLAN 2, VLAN 4, and VLAN 50 through VLAN 100 in Layer 2 Ethernet interface view of AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] gigabitethernet 1

[Sysname-wlan-ap-ap1-gigabitethernet-1] port link-type trunk

[Sysname-wlan-ap-ap1-gigabitethernet-1] port trunk permit vlan 2 4 50 to 100

# Configure GigabitEthernet 1 as a trunk port, and assign it to VLAN 2, VLAN 4, and VLAN 50 through VLAN 100 in Layer 2 Ethernet interface view of APs with model WA4320i-ACN in AP group 1.

<Sysname> system-view

[Sysname] wlan ap-group 1

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

[Sysname-wlan-ap-group-1-ap-model-WA4320i-ACN] gigabitethernet 1

[Sysname-wlan-ap-group-1-ap-model-WA4320i-ACN-gigabitethernet-1] port link-type trunk

[Sysname-wlan-ap-group-1-ap-model-WA4320i-ACN-gigabitethernet-1] port trunk permit vlan 2 4 50 to 100

Related commands

·     port link-type

·     remote-configuration

port trunk pvid

 

NOTE:

Support for this command depends on the AP model.

 

Use port trunk pvid to set the PVID for a trunk port on an AP.

Use undo port trunk pvid to restore the default.

Syntax

port trunk pvid vlan vlan-id

undo port trunk pvid

Default

In an AP's Layer 2 Ethernet interface view, a trunk port uses the configuration in an AP group's Layer 2 Ethernet interface view.

In an AP group's Layer 2 Ethernet interface view, the PVID of a trunk port is VLAN 1.

Views

AP's Layer 2 Ethernet interface view

AP group's Layer 2 Ethernet interface view

Predefined user roles

network-admin

Parameters

vlan-id: Specifies a VLAN by its ID in the range of 1 to 4094.

Usage guidelines

You can use a nonexistent VLAN as the PVID for a trunk port. When you delete the PVID of a trunk port by using the undo vlan command, the PVID setting of the port does not change.

For correct packet transmission, set the same PVID for a hybrid port on an AP and the hybrid port on the switch connected to the AP.

To enable a trunk port to transmit packets from its PVID, you must assign the trunk port to the PVID by using the port trunk permit vlan command.

For this command to take effect on an AP, make sure the remote configuration assignment feature is enabled.

The configuration in AP's Layer 2 Ethernet interface view takes precedence over the configuration in AP group's Layer 2 Ethernet interface view.

Examples

# In Layer 2 Ethernet interface view of AP ap1, configure GigabitEthernet 1 as a trunk port, set its PVID to VLAN 100, and assign it to VLAN 100.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] gigabitethernet 1

[Sysname-wlan-ap-ap3-gigabitethernet-1] port link-type trunk

[Sysname-wlan-ap-ap3-gigabitethernet-1] port trunk pvid vlan 100

[Sysname-wlan-ap-ap3-gigabitethernet-1] port trunk permit vlan 100

# In an AP group's Layer 2 Ethernet interface view, configure GigabitEthernet 1 as a trunk port, set its PVID to VLAN 100, and assign it to VLAN 100.

<Sysname> system-view

[Sysname] wlan ap-group 1

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

[Sysname-wlan-ap-group-1-ap-model-WA4320i-ACN] gigabitethernet 1

[Sysname-wlan-ap-group-1-ap-model-WA4320i-ACN-gigabitethernet-1] port link-type trunk

[Sysname-wlan-ap-group-1-ap-model-WA4320i-ACN-gigabitethernet-1] port trunk pvid vlan 100

[Sysname-wlan-ap-group-1-ap-model-WA4320i-ACN-gigabitethernet-1] port trunk permit vlan 100

Related commands

·     port link-type

·     port trunk permit vlan

·     remote-configuration

port-type gigabitethernet

 

NOTE:

Support for this command depends on the device model.

 

Use port-type gigabitethernet to set the interface type to GigabitEthernet for an interface that supports interface type switchover.

Use undo port-type to restore the default.

Syntax

port-type gigabitethernet number port-number

undo port-type

Default

In AP view, an AP uses the configuration in AP group's AP model view.

In AP group's AP model view, the default setting varies by AP model. An AP interface that supports interface type switchover can be an IoT interface or a WTU port.

Views

AP view

AP group's AP mode view

Predefined user roles

network-admin

Parameters

port-number: Specifies an AP interface or a list of space-separated AP interfaces by interface number. The value range for the port-number argument varies by device model.

Usage guidelines

This command takes effect only on interfaces that support interface type switchover between GigabitEthernet and IoT or WTU. GigabitEthernet interfaces connect APs to terminal devices such as PC, WTU ports connect APs to WTUs, and IoT interfaces connect APs to IoT modules. Configure the interface type as required.

This command will restore the default interface type settings for interfaces that support interface type switchover but are not specified in this command.

For example, on a UAP 300, interface 3 and interface 4 support interface type switchover between GigabitEthernet and IoT. If you first set the interface type of both interfaces to GigabitEthernet and then set the interface type of interface 4 to GigabitEthernet, interface 3 will become an IoT interface.

The undo port-type command restores the default interface type settings for all interfaces that support interface type switchover.

Examples

# Set the interface type of interface 3 to GigabitEthernet for AP ap1 with AP model UAP300.

<Sysname> system-view

[Sysname] wlan ap ap1 model UAP300

[Sysname-wlan-ap-ap1] port-type gigabitethernet number 3

# Set the interface type of interface 3 to GigabitEthernet for APs with AP model UAP300 in AP group 1.

<Sysname> system-view

[Sysname] wlan ap-group 1

[Sysname-wlan-ap-group-1] ap-model UAP300

[Sysname-wlan-ap-group-1-ap-model-UAP300] port-type gigabitethernet number 3

power-level default

 

NOTE:

Support for this command depends on the AP model.

 

Use power-level default to set the default input power level for an AP in case the AP cannot obtain its input power level.

Use undo power-level default to restore the default.

Syntax

power-level default { high | low | middle }

undo power-level default

Default

In AP view, an AP uses the configuration in AP group's AP model view.

In AP group's AP model view, the default input power level of an AP is middle.

Views

AP view

AP group's AP model view

Predefined user roles

network-admin

Parameters

high: Specifies the high default input power level.

low: Specifies the low default input power level.

middle: Specifies the middle default input power level.

Usage guidelines

Configure this command for an AP in case the AP cannot obtain its input power level at startup.

The power level of an AP can be high, middle, or low. An AP automatically performs power supply mode detection to obtain its input power level at startup. If the AP fails to obtain the input power level, it operates at the low input power level before associating with an AC. After the association, it operates at the configured default input power level.

The following table shows the relationship between the AP's power supply mode and input power level:

 

Power supply mode

Input power level

·     Power adapter.

·     Multiple PoE+ ports.

·     Combination of PoE and PoE+ ports.

High

·     Single PoE+ port

·     Multiple PoE ports

Middle

Single PoE port

Low

 

An AP's support for MIMO modes and USB interfaces varies by power level, as shown in Table 13.

Table 13 AP's support for MIMO modes and USB interfaces

Input power level

MIMO modes

Whether USB interfaces can be enabled

High

1×1, 2×2, 3×3, and 4×4.

Yes.

Middle

1×1, 2×2, 3×3, and 4×4.

Yes when the MIMO mode is 1×1 or 2×2.

Low

1×1.

No.

 

The configuration in AP view takes precedence over the configuration in AP group's AP model view.

Examples

# Set the default input power level to high for AP ap1 in AP view.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA5620i-ACN

[Sysname-wlan-ap-ap1] power-level default high

# Set the default input power level to high in AP model view of AP group g1.

<Sysname> system-view

[Sysname] wlan ap-group g1

[Sysname-wlan-ap-group-g1] ap-model WA5620i-ACN

[Sysname-wlan-ap-group-g1-ap-model-WA5620i-ACN] power-level default high

priority

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

Use undo priority to restore the default.

Syntax

priority priority

undo priority

Default

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

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

Views

AP view

AP group view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

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

The AP connection priority only takes effect during AC discovery.

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

Examples

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

<Sysname> system-view

[Sysname] wlan ap ap3 model 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

provision

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

Use undo provision to disable AP preprovisioning.

Syntax

provision

undo provision

Default

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

In AP group view, AP preprovisioning is disabled.

Views

AP view

AP group view

Predefined user roles

network-admin

Usage guidelines

AP preprovisioning allows you to configure network settings for APs on the AC. The AC automatically assigns these settings to the APs.

If you disable AP preprovisioning, network settings configured on the AC will be deleted. However, the operation does not affect the network settings already assigned to the APs.

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

Examples

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

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] provision

[Sysname-wlan-ap-ap1-prvs]

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

<Sysname> system-view

[Sysname] wlan ap-group group1

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

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

provision auto-recovery

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

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

Use undo provision auto-recovery to restore the default.

Syntax

provision auto-recovery { disable | enable }

undo provision auto-recovery

Default

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

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

Views

AP view

AP group view

Predefined user roles

network-admin

Usage guidelines

Auto loading of preprovisioned settings ensures successful CAPWAP tunnel establishment between AP and AC. An AP uses the following procedure to discover an AC when you enable this feature:

1.     Uses the preprovisioned settings to discover an AC that has the AP's manual or auto AP configuration.

2.     Reboots and uses other methods to discover ACs if AC discovery fails.

3.     Reboots and uses the preprovisioned settings again to discover ACs if the AP still fails to discover the target AC.

This AC discovery process will be repeated until the AP discovers the target AC to establish a CAPWAP tunnel.

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

Examples

# Disable auto loading of preprovisioned settings for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

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

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

<Sysname> system-view

[Sysname] wlan ap-group group1

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

provision auto-update

Use provision auto-update enable to enable auto assignment of preprovisioned settings.

Use provision auto-update disable to disable auto assignment of preprovisioned settings.

Use undo provision auto-update to restore the default.

Syntax

provision auto-update { disable | enable }

undo provision auto-update

Default

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

In AP group view, auto assignment of preprovisioned settings is disabled.

Views

AP view

AP group view

Predefined user roles

network-admin

Usage guidelines

This command enables the AC to automatically assign preprovisioned settings to an AP so that the AP can use the preprovisioned settings to come online.

This command applies only to offline APs. To deploy preprovisioned settings to online APs, use the save wlan ap provision command.

The preprovisioned settings in AP provision view has higher priority than the preprovisioned settings in AP group provision view.

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

Examples

# Enable auto assignment of preprovisioned settings for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-ap-ap1] provision auto-update enable

# Enable auto assignment of preprovisioned settings for APs in AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] provision auto-update enable

remote-configuration

 

NOTE:

Support for this command depends on the AP model.

 

Use remote-configuration enable to enable the remote configuration assignment feature.

Use remote-configuration disable to disable the remote configuration assignment feature.

Use undo remote-configuration to restore the default.

Syntax

remote-configuration { disable | enable }

undo remote-configuration enable

Default

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

In AP group view, remote configuration assignment is disabled.

Views

AP view

AP group view

Predefined user roles

network-admin

Usage guidelines

The AC will assign related VLAN settings to APs only when the remote configuration assignment feature is enabled.

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

Examples

# Enable the remote configuration assignment feature for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

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

# Enable the remote configuration assignment feature for AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

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

reset wlan ap

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

Syntax

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

Views

User view

Predefined user roles

network-admin

Parameters

all: Specifies all APs connected to the AC.

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

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

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

Usage guidelines

This command terminates the CAPWAP tunnel between the 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]:

reset wlan ap provision

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

Syntax

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

Views

Any view

Predefined user roles

network-admin

Parameters

all: Specifies all APs.

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

Usage guidelines

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

For this command to take effect on an AP, restart the AP after execution.

Examples

# Delete the configuration file wlan_ap_prvs.xml of AP ap1.

<Sysname> reset wlan ap provision name ap1

reset wlan ap reboot-log

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

Syntax

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

Views

User view

Predefined user roles

network-admin

Parameters

all: Specifies all APs.

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

Examples

# Clear the reboot logs of AP ap1.

<Sysname> reset wlan ap reboot-log name ap1

Related commands

display wlan ap reboot-log

reset wlan tunnel latency ap

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

Syntax

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

Views

User view

Predefined user roles

network-admin

Parameters

all: Specifies all APs.

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

Usage guidelines

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-detect

retransmit-count

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

Use undo retransmit-count to restore the default.

Syntax

retransmit-count value

undo retransmit-count

Default

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

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

Views

AP view

AP group view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

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

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

·     Image Data Request.

·     Configuration Update Request.

·     Reset Request.

·     Data Transfer Request.

·     IEEE 802.11 WLAN Configuration Request.

·     Station Configuration Request.

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

Examples

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

<Sysname> system-view

[Sysname] wlan ap ap3 model 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

retransmit-interval

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

Use undo retransmit-interval to restore the default.

Syntax

retransmit-interval interval

undo retransmit-interval

Default

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

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

Views

AP view

AP group view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

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

·     Image Data Request.

·     Configuration Update Request.

·     Reset Request.

·     Data Transfer Request.

·     IEEE 802.11 WLAN Configuration Request.

·     Station Configuration Request.

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

Examples

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

<Sysname> system-view

[Sysname] wlan ap ap3 model 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

save wlan ap provision

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

Syntax

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

Views

Any view

Predefined user roles

network-admin

Parameters

all: Specifies all APs.

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

Usage guidelines

This command saves the added or modified preprovisioned settings to the configuration file wlan_ap_prvs.xml.

This command takes effect only on online APs that have established tunnels with the master AC.

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

Preprovisioned settings configured in provision view take effect immediately when you execute the save wlan ap provision command.

Cancellations of preprovisioned settings in provision view do not take effect when you execute the save wlan ap provision command. For the cancellations to take effect on an AP, restart the AP.

Examples

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

<Sysname> system-view

[Sysname] wlan ap ap1 model 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

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 are configured.

Views

AP group view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

This command does not identify whether the specified AP exists.

You can configure multiple AP grouping rules by serial IDs.

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

If an AP grouping rule already exists in an AP group, this command deletes the rule from the AP group.

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

Examples

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

<Sysname> system-view

[Sysname] wlan ap-group group1

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

Related commands

wlan ap-group

serial-id (AP view)

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

Use undo serial-id to restore the default.

Syntax

serial-id serial-id

undo serial-id

Default

No serial ID is specified for an AP.

Views

AP view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

Changing or deleting the serial ID of an AP terminates the CAPWAP tunnel if the AP has established a CAPWAP tunnel with an AC. Then the AP will reestablish a CAPWAP tunnel with an 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

smartrate-ethernet

 

NOTE:

Support for this command depends on the AP model.

 

Use smartrate-ethernet to enter 2.5 GigabitEthernet interface view of an AP.

Syntax

smartrate-ethernet interface-number

Views

AP view

AP group's AP model view

Predefined user roles

network-admin

Parameters

interface-number: Specifies an interface number. The value range varies by AP model.

Examples

# Enter the interface view of Smartrate-Ethernet 1 from AP view.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA5620i-CAN

[Sysname-wlan-ap-ap1] smartrate-ethernet 1

[Sysname-wlan-ap-ap3-smartrate-ethernet-1]

# Enter the interface view of Smartrate-Ethernet 1 from the AP model view of AP group group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

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

[Sysname-wlan-ap-group-group1-ap-model-WA4320i-ACN] smartrate-ethernet 1

[Sysname-wlan-ap-group-group1-ap-model-WA5620i-ACN-smartrate-ethernet-1]

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 restore the default.

Syntax

snmp-agent trap enable wlan ap

undo snmp-agent trap enable wlan ap

Default

SNMP notifications are disabled for AP management.

Views

System view

Predefined user roles

network-admin

Usage guidelines

To report critical AP management events to an NMS, enable SNMP notifications for AP management. For AP management event notifications to be sent correctly, you must also configure SNMP as described in Network Management and Monitoring Configuration Guide.

Examples

# Enable SNMP notifications for AP management.

<Sysname> system-view

[Sysname] snmp-agent trap enable wlan ap

snmp-agent trap enable wlan capwap

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

Use undo snmp-agent trap enable wlan capwap to restore the default.

Syntax

snmp-agent trap enable wlan capwap

undo snmp-agent trap enable wlan capwap

Default

SNMP notifications are disabled for CAPWAP.

Views

System view

Predefined user roles

network-admin

Usage guidelines

To report critical CAPWAP events to an NMS, enable SNMP notifications for CAPWAP For CAPWAP event notifications to be sent correctly, you must also configure SNMP as described in Network Management and Monitoring Configuration Guide.

Examples

# Enable SNMP notifications for CAPWAP.

<Sysname> system-view

[Sysname] snmp-agent trap enable wlan capwap

statistics-interval

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

Use undo statistics-interval to restore the default.

Syntax

statistics-interval interval

undo statistics-interval

Default

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

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

Views

AP view

AP group view

Predefined user roles

network-admin

Parameters

interval: Specifies the statistics report interval in the range of 0 to 240 seconds. To disable statistics report for an AP, set the statistics report interval to 0.

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.

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

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

tunnel latency-detect

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

Syntax

tunnel latency-detect { start | stop }

Default

CAPWAP tunnel latency detection is not started.

Views

AP view

Predefined user roles

network-admin

Parameters

start: Starts CAPWAP tunnel latency detection.

stop: Stops CAPWAP tunnel latency detection.

Usage guidelines

CAPWAP tunnel latency detection enables an 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. When the AP comes online again, you need to execute the tunnel latency-detect start command to start CAPWAP tunnel latency detection.

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

usb

 

NOTE:

Support for this command depends on the AP model.

 

Use usb enable to enable USB interfaces on APs.

Use usb disable to disable USB interfaces on APs.

Use undo usb to restore the default.

Syntax

usb { disable | enable }

undo usb

Default

In AP view, an AP uses the configuration in AP group's AP model view.

In AP group's AP model view, USB interfaces are disabled.

Views

AP view

AP group's AP model view

Predefined user roles

network-admin

Usage guidelines

This command takes effect on an AP only when either of the following requirements is met:

·     The power level of the AP is high.

·     The power level of the AP is middle and the MIMO mode is 1×1 or 2×2.

For information about power levels, see "power-level default." For information about MIMO modes, see radio management in WLAN Configuration Guide.

The configuration in AP view takes precedence over the configuration in AP group's AP model view.

Examples

# Enable USB interfaces in AP view.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA5620i-ACN

[Sysname-wlan-ap-ap1] usb enable

# Enable USB interfaces in AP model view of AP group g1.

<Sysname> system-view

[Sysname] wlan ap-group g1

[Sysname-wlan-ap-group-g1] ap-model WA5620i-ACN

[Sysname-wlan-ap-group-g1-ap-model-WA5620i-ACN] usb enable

Related commands

power-level default

vlan

 

NOTE:

Support for this command depends on the AP model.

 

Use vlan vlan-id to create a VLAN for an AP and enter the VLAN view of the AP, or enter the view of an existing VLAN of an AP.

Use vlan vlan-id1 to vlan-id2 to create VLANs vlan-id1 through vlan-id2 for an AP, except for reserved VLANs.

Use vlan all to create VLANs 1 through 4094 for an AP.

Use undo vlan to delete the specified VLANs of an AP.

Syntax

vlan { vlan-id1 [ to vlan-id2 ] | all }

undo vlan { vlan-id1 [ to vlan-id2 ] | all }

Default

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

In AP group view, VLAN 1 (the default VLAN) exists on an AP.

Views

AP view

AP group view

Predefined user roles

network-admin

Parameters

vlan-id1: Specifies a VLAN ID in the range of 1 to 4094.

vlan-id1 to vlan-id2: Specifies a VLAN range. The vlan-id1 and vlan-id2 arguments specify VLAN IDs. The value range for each of the two arguments is 1 to 4094. The value for the vlan-id2 argument cannot be lower than the value for the vlan-id1 argument.

all: Specifies all VLANs except for reserved VLANs. The keyword is not supported when the maximum number of VLANs that can be created on an AP is less than 4094. Support for this keyword depends on the AP model.

Usage guidelines

You cannot create or delete VLAN 1 (the default VLAN) or reserved VLANs.

For this command to take effect on an AP, make sure the remote configuration assignment feature is enabled.

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

Examples

# Create VLAN 2 for AP ap1 and enter the VLAN view of the VLAN.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA4320i-ACN

[Sysname-wlan-ap-ap1] vlan 2

[Sysname-wlan-ap-ap1-vlan2]

# Create VLAN 2 for AP group group1 and enter the VLAN view of the VLAN.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1] vlan 2

[Sysname-wlan-ap-group-1-vlan2]

Related commands

remote-configuration

wlan ap

Use wlan ap to create an AP and enter AP view.

Use undo wlan ap to delete an AP.

Syntax

wlan ap ap-name [ model model-name ]

undo wlan ap ap-name

Default

No manual AP exists.

Views

System view

Predefined user roles

network-admin

Parameters

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

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 already exists, the wlan ap command enters AP view.

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]

wlan apdb

Use wlan apdb to configure the mapping between a software version and a hardware version of an AP model.

Use undo wlan apdb to restore the default.

Syntax

wlan apdb model-name hardware-version software-version

undo wlan apdb model-name hardware-version

Default

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

Views

System view

Predefined user roles

network-admin

Parameters

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

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

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

Usage guidelines

CAUTION

CAUTION:

To avoid CAPWAP tunnel establishment failure, use this command under the guidance of H3C Support.

 

This command is used together with the software upgrade feature for software version consistency check during software upgrade.

Use this command only when the software version you expect for an AP is inconsistent with the software version specified for the AP model stored in the APDB.

Examples

# Configure the mapping between software version E2108 and hardware version Ver.C of AP model WA4320i-ACN.

<Sysname> system-view

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

Related commands

firmware-upgrade

wlan apdb file

Use wlan apdb file to load an APDB user script.

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

Syntax

wlan apdb file user.apdb

undo wlan apdb file

Default

No APDB user script is loaded.

Views

System view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

When you load an APDB user script, follow these restrictions and guidelines:

·     Make sure the user script is valid. Invalid scripts can cause loading failure.

·     The AP models in the user script must be different from the AP models in the system script.

·     If you load multiple user scripts on the AC, the most recently loaded user script overwrites the old user scripts.

·     If you rename the user script in the file system, reload the user script to prevent AP model configuration in the user script from being lost after an AC reboot.

·     If you replace the user script with a new user script in the file system, reload the new user script. If the new user script does not include AP model information saved in the replaced user script, the AP model information will be lost after an AC reboot.

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

If an old user script already exists, follow these restrictions and guidelines when you load an APDB user script:

·     If a manual AP or an online auto AP whose model is listed in the old user script exists ,you can load a new user script only when you delete the corresponding AP model information on the AC.

·     If APs of an AP model listed in the old user script have been added to an AP group, you can load a new user script only when you remove the APs from the AP group.

·     If the old user script includes an AP model whose software version was already configured, you can load a new user script only when you use the wlan apdb command to restore the original software version.

Examples

# Load user script user.apdb.

<Sysname> system-view

[Sysname] wlan apdb file user.apdb

Related commands

wlan apdb

wlan ap-group

Use wlan ap-group to create an 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

Parameters

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

Usage guidelines

If the specified AP group exists, this command enters the AP group view.

The default AP group cannot be deleted.

Examples

# Create an AP group with name group1.

<Sysname> system-view

[Sysname] wlan ap-group group1

[Sysname-wlan-ap-group-group1]

Related commands

display wlan ap-group

wlan auto-ap enable

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

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

Syntax

wlan auto-ap enable

undo wlan auto-ap enable

Default

The auto AP feature is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

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

To configure an auto AP, you must use auto-AP persistence to convert the auto AP to a manual AP or configure it through an AP group.

Examples

# Enable the auto AP feature.

<Sysname> system-view

[Sysname] wlan auto-ap enable

wlan auto-ap persistent

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

Syntax

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

Views

System view

Predefined user roles

network-admin

Parameters

all: Specifies all online auto APs. If you specify this keyword, the command converts all online auto APs to manual APs with 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 (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-). If you do not specify this argument, the converted manual AP uses the name of the auto AP.

Examples

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

<Sysname> system-view

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

wlan auto-persistent enable

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

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

Syntax

wlan auto-persistent enable

undo wlan auto-persistent enable

Default

Auto AP conversion is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

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

Examples

# Enable auto AP conversion.

<Sysname> system-view

[Sysname] wlan auto-persistent enable

wlan capwap discovery-policy unicast

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

Use undo wlan capwap discovery-policy to restore the default.

Syntax

wlan capwap discovery-policy unicast

undo wlan capwap discovery-policy

Default

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

Views

System view

Predefined user roles

network-admin

Examples

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

<Sysname> system-view

[Sysname] wlan capwap discovery-policy unicast

wlan global-configuration

Use wlan global-configuration to enter global configuration view.

Syntax

wlan global-configuration

Views

System view

Predefined user roles

network-admin

Usage guidelines

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

Examples

# Enter global configuration view.

<Sysname> system-view

[Sysname] wlan global-configuration

[Sysname-wlan-global-configuration]

wlan image-load filepath

Use wlan image-load filepath to specify the preferred location for the AC to obtain an AP image file for software version assignment.

Use undo wlan image-load filepath to restore the default.

Syntax

wlan image-load filepath { local | ram }

undo wlan image-load filepath

Default

The AC prefers the AP image file stored in the RAM when assigning a software version to APs.

Views

System view

Predefined user roles

network-admin

Parameters

local: Specifies the local folder as the preferred location to obtain an AP image file. If no AP image file exists on the local folder, the AC obtains the AP image file from the RAM. If no AP image file exists on the RAM, the AC fails to obtain an AP image file.

ram: Specifies the RAM as the preferred location to obtain an AP image file. If no AP image file exists on the RAM, the AC obtains the AP image file from the local folder. If no AP image file exists on the local folder, the AC fails to obtain an AP image file.

Usage guidelines

The AC image file contains AP image files. The AC reads the AP image files into the RAM when it starts.

Specify the local keyword only when the following conditions are met:

·     The required AP image file is not contained in the AC's image file.

·     The software version an AP uses when it comes online has been specified using the wlan apdb command.

When you specify the local keyword, make sure the AC uses a CF card as the default file system and the AP image file is stored in the root directory of the file system on the AC.

The AC can assign only .ipe AP image files to APs.

Examples

# Specify the local folder as the preferred location to obtain an AP image file for AP software version assignment.

<Sysname> system-view

[Sysname] wlan image-load filepath local

wlan re-group

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

Syntax

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

Views

System view

Predefined user roles

network-admin

Parameters

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

ap-group 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

# Create an AP group named group2, and move an AP grouping rule by AP names to AP group group2.

[Sysname] wlan ap-group group2

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

[Sysname] wlan re-group ap ap1 group2

wlan rename-ap

Use wlan rename-ap to rename a manual AP.

Syntax

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

Views

System view

Predefined user roles

network-admin

Parameters

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

new-ap-name: Specifies a new AP name, a case-insensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), 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

wlan tcp mss

Use wlan tcp mss to set the maximum TCP segment size (MSS) for CAPWAP tunnels.

Use undo wlan tcp mss to restore the default.

Syntax

wlan tcp mss value

undo wlan tcp mss

Default

The TCP MSS is 1460 bytes for CAPWAP tunnels.

Views

System view

Predefined user roles

network-admin

Parameters

value: Specifies the TCP MSS in bytes in the range of 128 to 2048.

Usage guidelines

This command sets the value of the MSS option in SYN packets transmitted over a CAPWAP tunnel.

The MSS option informs the receiver of the largest segment that the sender can accept. Each end announces its MSS during TCP connection establishment. If the size of a TCP segment is smaller than or equal to the MSS of the receiver, TCP sends the TCP segment without fragmentation. If not, TCP fragments the segment based on the receiver's MSS.

Examples

# Set the TCP MSS to 2000 bytes for CAPWAP tunnels.

<Sysname> system-view

[Sysname] wlan tcp mss 2000