02-WLAN Command Reference

HomeSupportReference GuidesCommand ReferencesH3C WX Series Access Controllers Command References(R3308 R2308)-6W10702-WLAN Command Reference
02-WLAN Service Commands
Title Size Download
02-WLAN Service Commands 463.43 KB

Contents

WLAN configuration commands 1

WLAN global service control commands 1

wlan enable· 1

802.11 MAC configuration commands 1

a-mpdu enable· 1

a-msdu enable· 2

ani enable· 3

antenna type· 3

beacon ssid-hide· 4

beacon-interval 4

bind wlan-ess 5

broadcast-probe reply· 6

channel 6

channel band-width· 7

channel lock· 8

client dot11n-only· 9

client forwarding-mode local 9

client idle-timeout 10

client keep-alive· 11

client max-count (radio policy view) 11

client max-count (service template view) 12

country-code· 12

display wlan client 13

display wlan country-code· 17

display wlan radio-policy· 18

display wlan service-template· 22

display wlan statistics ap connect-history· 23

display wlan statistics client 24

display wlan statistics radio· 26

display wlan statistics service-template· 30

distance· 32

dtim·· 33

fast-association enable· 33

fragment-threshold· 34

long-retry threshold· 34

max-power 35

max-rx-duration· 36

nas-id· 36

nas-port-id· 37

power lock· 37

preamble· 38

protection-mode· 39

radio· 39

radio type· 40

radio-policy· 41

reset wlan client 41

reset wlan statistics 42

rts-threshold· 42

service-template (radio view) 43

service-template (service template view) 44

short-gi enable· 44

short-retry threshold· 45

shut-all-led enable· 46

ssid· 46

trap enable· 47

wlan country-code· 47

wlan link-test 50

wlan radio· 51

wlan radio-policy· 52

wlan radio-policy auto-create· 53

wlan service-template· 53

AC-AP tunnel configuration commands 54

ac· 54

ap-name· 55

backup-ac· 56

cir 56

cpu-usage threshold· 57

data-tunnel encryption enable· 57

description· 58

display wlan ap· 59

display wlan ap address 66

display wlan ap radio· 67

display wlan ap reboot-log· 68

display wlan ap-model 69

dns domain· 71

dns server 71

echo-interval 72

gateway· 73

hybrid-remote-ap enable· 73

ip address 74

ipv6 address 75

jumboframe enable· 75

map-configuration· 76

memory-usage threshold· 77

priority level 77

provision· 78

reset wlan ap· 78

reset wlan ap provision· 79

reset wlan ap reboot-log· 79

save wlan ap provision· 80

serial-id· 80

tunnel encryption ipsec pre-shared-key· 81

vlan pvid· 82

vlan tagged· 82

vlan untagged· 83

wlan ap· 84

wlan apdb· 84

wlan ap-execute· 85

wlan ap-provision ac· 85

wlan ap-provision dns domain· 86

wlan ap-provision dns server 87

wlan auto-ap enable· 87

wlan auto-ap persistent 88

wlan backup-ac· 89

wlan lwapp discovery-policy· 89

User isolation commands 90

display user-isolation statistics 90

reset user-isolation statistics 91

user-isolation enable· 91

user-isolation permit broadcast 92

user-isolation vlan enable· 92

user-isolation vlan permit-mac· 93

AP group configuration commands 94

ap· 94

description· 94

display wlan ap-group· 95

wlan ap-group· 96

wlan permit-ap-group· 96

SSID-based access control configuration commands 97

wlan permit-ssid· 97

Uplink detection commands 98

wlan uplink track· 98

AC hot backup configuration commands 98

display hot-backup state· 98

hot-backup enable· 99

hot-backup hellointerval 100

hot-backup vlan· 101

wlan backup-ac switch-delay· 101

 


WLAN global service control commands

wlan enable

Syntax

wlan enable

undo wlan enable

View

System view

Default level

2: System level

Parameters

None

Description

Use wlan enable to enable WLAN service.

Use undo wlan enable to disable WLAN service.

By default, WLAN service is enabled.

 

 

NOTE:

All WLAN services are available if and only if WLAN service is enabled.

 

Examples

# Enable WLAN service if it is disabled.

<Sysname> system-view

[Sysname] wlan enable

802.11 MAC configuration commands

a-mpdu enable

Syntax

a-mpdu enable

undo a-mpdu enable

View

Radio view

Default level

2: System level

Parameters

None

Description

Use a-mpdu enable to enable the A-MPDU function for the radio.

Use undo a-mpdu enable to disable the A-MPDU function for the radio.

By default, the A-MPDU function is enabled.

This command is only effective on 802.11n radios.

If you change the radio type of an 802.11n radio, the default setting for this function of the new radio type is restored.

Examples

# Disable the A-MPDU function.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA2620-AGN

[Sysname-wlan-ap-ap3] radio 1 type dot11an

[Sysname-wlan-ap-ap3-radio-1] undo a-mpdu enable

a-msdu enable

Syntax

a-msdu enable

undo a-msdu enable

View

Radio view

Default level

2: System level

Parameters

None

Description

Use a-msdu enable to enable the A-MSDU function for the radio.

Use undo a-msdu enable to disable the A-MSDU function for the radio.

By default, the A-MSDU function is enabled.

This command is only effective on 802.11n radios. If you change the radio type of an 802.11n radio, the default setting for this function of the new radio type is restored.

The device only receives but does not send A-MSDU frames.

Examples

# Disable the A-MSDU function.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA2620-AGN

[Sysname-wlan-ap-ap3] radio 1 type dot11an

[sysname-wlan-ap-ap3-radio-1] undo a-msdu enable

ani enable

Syntax

ani enable

undo ani enable

View

Radio view

Default level

2: System level

Parameters

None

Description

Use ani enable to enable the Adaptive Noise Immunity (ANI) function.

Use undo ani enable to disable the ANI function.

By default, ANI is enabled.

After the ANI function is enabled, the device automatically adjusts the noise immunity level according to the surrounding signal environment to eliminate RF interference.

Examples

# Disable ANI.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2100

[Sysname-wlan-ap-ap1] radio 1

[Sysname-wlan-ap-ap1-radio-1] undo ani enable

antenna type

Syntax

antenna type type

undo antenna type

View

Radio view

Default level

2: System level

Parameters

type: Specifies the antenna type.

Description

Use antenna type to specify the antenna type.

Use undo antenna type to restore the default.

The default setting of the command depends on the device model.

Examples

# Specify the antenna type.

<Sysname> system-view

[Sysname] wlan ap ap1 model wa2620e-agn

[Sysname-wlan-ap-ap1] radio 1

[Sysname-wlan-ap-ap1-radio-1] antenna type C5060

beacon ssid-hide

Syntax

beacon ssid-hide

undo beacon ssid-hide

View

Service template view

Default level

2: System level

Parameters

None

Description

Use beacon ssid-hide to configure hiding the Service Set Identifier (SSID) in beacon frames.

Use undo beacon ssid-hide to restore the default.

By default, the SSID is not hidden in beacon frames.

If the SSID in beacon frames is hidden, the SSID must be configured for the clients to associate with the AP.

Hiding the SSID in beacon frames does little good to wireless security. Allowing the advertising of the SSID in beacon frames enables a client to discover an AP more easily.

Examples

# Hide the SSID in beacon frames.

<Sysname> system-view

[Sysname] wlan service-template 1 clear

[Sysname-wlan-st-1] beacon ssid-hide

beacon-interval

Syntax

beacon-interval interval

undo beacon-interval

View

Radio policy view

Default level

2: System level

Parameters

interval: Specifies the interval for sending beacon frames. The value is in the range of 32 to 8191 time units (TUs).

Description

Use beacon-interval to set the interval for sending beacon frames. Beacon frames are transmitted at a regular interval to allow mobile clients to join the network.

Use undo beacon-interval to restore the default beacon interval.

By default, the beacon interval is 100 TUs.

Examples

# Specify the beacon interval as 1000 TUs.

<Sysname> system-view

[Sysname] wlan radio-policy radio1

[Sysname-wlan-rp-radio1] beacon-interval 1000

bind wlan-ess

Syntax

bind wlan-ess interface-index

undo bind wlan-ess

View

Service template view

Default level

2: System level

Parameters

interface-index: Specifies the index of the WLAN-ESS interface. The value range varies with AC models. For more information about AC models, see About the WX Series Access Controllers Command References.

Description

Use bind wlan-ess to bind the specified WLAN-ESS interface to the service template.

Use undo bind wlan-ess to unbind the WLAN-ESS interface to the service template.

By default, no WLAN-ESS interface is bound to the service template.

Examples

# Bind interface WLAN-ESS 1 to service template 1.

<Sysname> system-view

[Sysname] interface WLAN-ESS 1

[Sysname-WLAN-ESS1] quit

[Sysname] wlan service-template 1 clear

[Sysname-wlan-st-1] bind wlan-ess 1

broadcast-probe reply

Syntax

broadcast-probe reply

undo broadcast-probe reply

View

AP template view

Default level

2: System level

Parameters

None

Description

Use broadcast-probe reply to enable the AP to respond to the probe requests that carry no SSID.

Use undo broadcast-probe reply to configure the AP to respond only to probe requests that carry an SSID.

By default, an AP responds to probe requests that carry no SSID.

Examples

# Enable AP3 to respond to probe requests that carry no SSID.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA2100

[Sysname-wlan-ap-ap3] broadcast-probe reply

channel

Syntax

channel { channel-number | auto }

undo channel

View

Radio view

Default level

2: System level

Parameters

channel-number: Specifies a channel. The working channels depend on the country code and radio mode.

auto: Specifies that the channel is automatically selected by the device according to the actual environment during system initialization.

Description

Use channel to specify a channel for the radio. Different radios support different channels. Channels may differ for each country.

Use undo channel to restore the default.

By default, auto mode is set.

The channel channel-number, if specified, is always used, and you do not need to configure the channel lock command. If you configure the channel lock command first, and then the channel channel-number command, the earlier configuration is overwritten.

Before configuring DFS, be sure that the AC adopts the auto mode. Otherwise, DFS does not work. For more information about DFS, see WLAN Configuration Guide.

Related commands: channel lock, dot11a calibrate-channel, and dot11bg calibrate-channel.

Examples

# Specify channel 6 for radio 1 of AP3.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA2100

[Sysname-wlan-ap-ap3] radio 1 type dot11b

[Sysname-wlan-ap-ap3-radio-1] channel 6

channel band-width

Syntax

channel band-width { 20 | 40 }

undo channel band-width

View

Radio view

Default level

2: System level

Parameters

20: Specifies the channel bandwidth of the 802.11n radio as 20 MHz.

40: Specifies the channel bandwidth of the 802.11n radio as 40 MHz.

Description

Use channel band-width to specify the channel bandwidth of the 802.11n radio.

Use undo channel band-width to restore the default.

By default, the channel bandwidth of the 802.11an radio is 40 MHz, and that of the 802.11gn radio is 20 MHz.

This command is only effective on 802.11n radios.

If you change the radio type of an 802.11n radio, the default setting for this function of the new radio type is restored.

If the channel bandwidth of the radio is set to 40 MHz, a 40 MHz channel is used as the working channel. If no 40 MHz channel is available, only a 20 MHz channel can be used.

Examples

# Configure the channel bandwidth of the radio as 20 MHz.

<Sysname> system-view

[Sysname]wlan ap ap3 model WA2620-AGN

[Sysname-wlan-ap-ap3] radio 1 type dot11an

[Sysname-wlan-ap-ap3-radio-1] channel band-width 20

channel lock

Syntax

channel lock

undo channel lock

View

Radio view

Default level

2: System level

Parameters

None

Description

Use channel lock to lock the current channel.

Use undo channel lock to unlock the current channel.

By default, the current channel is not locked.

The channel clock command takes effect only when the radio adopts the auto mode (configured with the channel auto command).

If you configure the channel lock command and then enable the radio by using the radio enable command, the radio automatically selects an optimal channel, and then locks the channel.

When the AC detects any radar signals on its channel, it immediately selects another channel even if the channel lock command is configured, and locks the new channel.

If you configure the channel lock command first, and then enable dynamic frequency selection (DFS), DFS does not work because the channel is locked. Therefore, before enabling DFS, make sure the current channel is not locked. If you enable DFS and then configure the channel lock command, the last selected channel is locked. For more information about DFS, see the WLAN Configuration Guide.

Related commands: channel, dot11a calibrate-channel, and dot11bg calibrate-channel.

Examples

# Lock the current channel.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA2100

[Sysname-wlan-ap-ap3] radio 1 type dot11g

[Sysname-wlan-ap-ap3-radio-1] channel lock

client dot11n-only

Syntax

client dot11n-only

undo client dot11n-only

View

Radio view

Default level

2: System level

Parameters

None

Description

Use client dot11n-only to allow only 802.11n clients to access.

Use undo client dot11n-only to restore the default.

By default, an 802.11an radio permits both 802.11a and 802.11an clients to access, and an 802.11gn radio permits both 802.11b/g and 802.11gn clients to access.

An 802.11n radio supports both 2.4GHz and 5GHz bands and can allow 802.11a/b/g stations to access, providing good compatibility.

The client dot11n-only command prohibits non-802.11n clients from access. Therefore, if you want to provide access for all 802.11a/b/g clients, disable this command.

Related commands: dot11n mandatory maximum-mcs.

Examples

# Configure the radio to allow only 802.11n clients to access.

<Sysname> system-view

[Sysname]wlan ap ap3 model WA2620-AGN

[Sysname-wlan-ap-ap3] radio 1 type dot11an

[Sysname-wlan-ap-ap3-radio-1] client dot11n-only

client forwarding-mode local

Syntax

client forwarding-mode local [ vlan vlan-id-list ]

undo client forwarding-mode local

View

Service template view

Parameters

vlan vlan-id-list: VLANs used for local forwarding. This argument is expressed in the format of vlan-id-list = { vlan-id1 [ to vlan-id2 ] }& <1-10>, where vlan-id is in the range of 1 to 4094 and &<1-10> indicates that you can specify up to 10 VLAN IDs or VLAN ID ranges. If this parameter is not specified, local forwarding is enabled on all the VLANs.

Description

Use client forwarding-mode local to enable AP local forwarding in the service template.

Use undo client forwarding-mode local to disable AP local forwarding in the service template.

By default, remote forwarding is enabled in the service template.

After the service template is bound with an AP:

·     If local forwarding is enabled in the service template, the AP forwards data frames from associated clients.

·     If remote forwarding is enabled, the AC forwards data frames from associated clients.

Local forwarding greatly reduces the load of the AC by enabling APs to forward client traffic, especially in a WLAN servicing many clients.

Examples

# Enable local forwarding in service template 1.

<Sysname> system-view

[Sysname] wlan service-template 1 clear

[Sysname-wlan-st-1] client forwarding-mode local

client idle-timeout

Syntax

client idle-timeout interval

undo client idle-timeout

View

AP template view

Default level

2: System level

Parameters

interval: Specifies the time for which the link between AP and client ( power-save or awake ) can be idle. The value is in the range of 60 to 86400 seconds.

Description

Use client idle-timeout to specify the client idle timeout interval. If a client is idle for more than the specified interval, or, if the AP does not receive any data from the client within a specified interval, the client is removed from the network.

Use undo client idle-timeout to restore the default.

By default, the client idle timeout interval is 3600 seconds.

Examples

# Specify the client idle timeout as 600 seconds.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA2100

[Sysname-wlan-ap-ap3] client idle-timeout 600

client keep-alive

Syntax

client keep-alive interval

undo client keep-alive

View

AP template view

Default level

2: System level

Parameters

interval: Interval between keep-alive requests. The value is in the range of 3 to 1800 seconds.

Description

Use client keep-alive to specify the client keep-alive interval.

Use undo client keep-alive to disable the client keep-alive functionality.

The client keep-alive mechanism is used to detect clients segregated from the system due to various reasons such as power failure or crash, and disconnect them from AP.

By default, the client keep-alive functionality is disabled.

Examples

# Specify the client keep-alive interval as 60 seconds.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA2100

[Sysname-wlan-ap-ap3] client keep-alive 60

client max-count (radio policy view)

Syntax

client max-count max-number

undo client max-count

View

Radio policy view

Default level

2: System level

Parameters

max-number: Maximum number of allowed clients, in the range of 1 to 124.

Description

Use client max-count to specify the maximum number of allowed clients for the radio policy.

Use undo client max-count to restore the default.

The default maximum number is 64.

Examples

# Specify that radio policy radio1 can accommodate at most 10 clients.

<Sysname> system-view

[Sysname] wlan radio-policy radio1

[Sysname-wlan-rp-radio1] client max-count 10

client max-count (service template view)

Syntax

client max-count max-number

undo client max-count

View

Service template view

Default level

2: System level

Parameters

max-number: Maximum number of clients associated to an SSID, in the range of 1 to 64.

Description

Use client max-count to specify the maximum number of clients associated to an SSID on a radio.

Use undo client max-count to restore the default.

By default, up to 64 clients can be associated to an SSID on a radio.

When the number of clients associated to an SSID on a radio reaches the maximum number, the SSID is automatically hidden.

Examples

# Specify the maximum number of clients associated to the SSID service on a radio as 10.

<Sysname> system-view

[Sysname] wlan service-template 1 clear

[Sysname-wlan-st-1] ssid service

[Sysname-wlan-st-1] client max-count 10

country-code

Syntax

country-code code

undo country code

View

AP template view

Default level

2: System level

Parameters

code: Country code. For information about country codes, see Table 11.

Description

Use country-code to specify the country code of the AP.

Use undo country-code to remove the configuration.

By default, no country code is configured for the AP, and the AP uses the global country code.

An AP configured with a country code uses its own country code.

Related commands: wlan country-code, display wlan country-code.

Examples

# Specify the country code for the AP as US.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2620-AGN

[Sysname-wlan-ap-ap1] country-code us

display wlan client

Syntax

display wlan client [ ap ap-name [ radio radio-number ] | mac-address mac-address | service-template service-template-number ] [ verbose ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

ap ap-name: Displays the information of clients which are connected to the specified AP.

radio radio-number: Displays the information of clients attached to the specified radio. The radio number value is 1.

mac-address mac-address: Specifies the MAC address of a client.

service-template service-template-number: Displays client information based on the specified service template. The service template number is in the range of 1 to 1024.

verbose: Displays detailed client information.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display wlan client to display WLAN client information. The information is displayed in the order of client MAC address.

Examples

# Display information about all clients.

<Sysname> display wlan client

Total Number of Clients           : 3

                               Client Information

 SSID: office

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

 MAC Address   User Name            APID/RID        IP Address              VLAN

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

000f-e265-6400 –NA-                  1/1              1.1.1.1                1

000f-e265-6401 user                 1024/1          3.0.0.3                  3

000f-e265-6402 mac@office.com       103 /1          FE:11:12:03::11:25:13    1

Table 1 Command output

Field

Description

SSID

SSID with which the client is associated.

MAC address

MAC address of the client.

User Name

Username of the client:

·     The field displays -NA- if the client adopts plaintext authentication or ciphertext authentication with no username.

·     The field is irrelevant to the portal authentication method. If the client uses the portal authentication method, the field does not display the portal username of the client.

APID/RID

ID of the AP or radio that the client is associated with.

IP Address

IP address of the client.

VLAN

VLAN to which the client belongs.

 

# Display detailed information about all clients.

<Sysname> display wlan client verbose

 Total Number of Clients           : 1

                              Client Information

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

 MAC Address                       : 001e-58f6-01bf

 User Name                         : -NA-

 AID                               : 1

 AP Name                           : 2

Radio Id                           : 2

 SSID                              : office

 BSSID                             : 0026-3e08-1150

 Port                              : WLAN-DBSS0:3

 VLAN                              : 1

 State                             : Running

 Power Save Mode                   : Active

 Wireless Mode                     : 11gn

 Channel Band-width                : 20MHz

 SM Power Save Enable              : Disabled

 Short GI for 20MHz                : Not Supported

 Short GI for 40MHz                : Supported

 Support MCS Set                   : 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15

 BLOCK ACK-TID 0                   : IN

 QoS Mode                          : WMM

 Listen Interval (Beacon Interval) : 10

 RSSI                              : 62

 Rx/Tx Rate                        : 130/11

 Client Type                       : PRE-RSNA

 Authentication Method             : Open System

 AKM Method                        : None

 4-Way Handshake State             : -NA-

 Group Key State                   : -NA-

 Encryption Cipher                 : Clear

 Roam Status                       : Normal

 Roam Count                        : 0

 Up Time (hh:mm:ss)                : 00:01:13

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

Table 2 Command output

Field

Description

MAC address

MAC address of the client.

User Name

Username of the client:

·     The field displays -NA- if the client adopts plaintext authentication or ciphertext authentication with no username.

·     The field is irrelevant to the portal authentication method. If the client uses the portal authentication method, the field does not display the portal username of the client.

AID

Association ID of the client.

AP Name

Name of the associated access point.

Radio ID

ID of the radio associated with the client.

SSID

SSID of the client.

BSSID

ID of the BSS.

Port

WLAN-DBSS interface associated with the client.

VLAN

VLAN to which the client belongs.

State

State of the client such as running.

Backup indicates a backup client.

Power Save Mode

Client's power save mode such as active or sleep.

Wireless Mode

Wireless mode such as 802.11a, 802.11b, 802.11g, 802.11gn, 802.11an.

Channel Band-width

Channel bandwidth, 20 MHz or 40 MHz.

SM Power Save Enable

SM Power Save enables a client to have one antenna in the active state, and others in sleep state to save power.

·     EnabledSM Power Save is enabled.

·     DisabledSM Power Save is disabled.

Short GI for 20MHz

Whether the client supports short GI when its channel bandwidth is 20 MHz.

Short GI for 40MHz

Whether the client supports short GI when its channel bandwidth is 40 MHz.

Support MCS Set

MCS supported by the client.

BLOCK ACK-TID 0

BLOCK ACK is negotiated based on traffic identifier (TID) 0:

·     OUTOutbound direction.

·     INInbound direction.

·     BOTHBoth outbound and inbound directions.

BLOCK ACK-TID 3

BLOCK ACK is negotiated based on TID 3:

·     OUTOutbound direction.

·     INInbound direction.

·     BOTHBoth outbound and inbound directions.

QoS Mode

WMM indicates that the WMM function is supported; None indicates that the WMM function is not supported.

WMM information negotiation is carried out between an AP and a client that both support WMM.

Listen Interval

Number of times the client has woken up to listen to beacon frames.

RSSI

Received signal strength indication. This value indicates the client signal strength detected by the AP.

Rx/Tx Rate

Represents the receiving and sending rates of the frames such as data, management, and control frames. For the AC + fit AP architecture, there is delay because Rx Rate is transmitted from AP to AC periodically depending on the statistics interval.

Client Type

Client type such as WPA2(RSN), WPA, or Pre-RSNA.

Authentication Method

Authentication method such as open system or shared key.

AKM Method

AKM suite used such as Dot1X or PSK.

4-Way Handshake State

Displays either of the 4-way handshake states:

·     IDLEDisplayed in initial state.

·     PTKSTARTDisplayed when the 4–way handshake is initialized.

·     PTKNEGOTIATINGDisplayed after sending valid message 3.

·     PTKINITDONEDisplayed when the 4-way handshake is successful.

Group Key State

Displays the group key state such as:

·     IDLEDisplayed in initial state.

·     REKEYNEGOTIATEDisplayed after the AC sends the initial message to the client.

·     REKEYESTABLISHEDDisplayed when re-keying is successful.

Encryption Cipher

Encryption cipher such as clear or crypto.

Roam Status

Displays the roam status such as Normal or Fast Roaming.

Roam Count

Roaming count of the client, including intra-AC roaming and inter-AC roaming.

·     For intra-AC roaming, this field is reset after the client is de-associated with the AP connected to the AC.

·     For inter-AC roaming, this field is reset after the client leaves the mobility group to which the AC belongs.

Up Time

Time for which the client has been associated with the AP.

 

display wlan country-code

Syntax

display wlan country-code ap { name ap-name | all } [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

name ap-name: Specifies the name of the AP, a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.

all: Displays the country code information of all APs.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display wlan country-code to display the country code information of a specified AP or all APs.

Related commands: country-code.

Examples

# Display the country code information of all APs.

<Sysname> display wlan country-code ap all

                            Country Code

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

 AP                                         Country Code

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

 ap1                                        CN China

 ap2                                        US United States

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

display wlan radio-policy

Syntax

display wlan radio-policy [ radio-policy-name ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

radio-policy-name: Name of a radio policy, a case-insensitive string of 1 to 15 characters which can contain letters, digits and underscores, with spaces excluded.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display wlan radio-policy to display information about a radio policy or all radio policies. The information displayed is in the order of radio-policy name.

Examples

# Display the configuration information for radio policy rp.

<Sysname> display wlan radio-policy rp

                             Radio Policy Parameters

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

 Radio Policy Name               : rp

 Fragmentation Threshold (Bytes) : 2346

 Beacon Interval (TU)            : 100

 RTS Threshold (Bytes)           : 2346

 DTIM Period (Beacon Interval)   : 1

 Long Retry Threshold            : 4

 Short Retry Threshold           : 7

 Maximum Rx Duration (ms)        : 2000

 Maximum clients per Radio       : 64

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

 QoS Mode                        : WMM

 Admission Control Policy        : Users

 Threshold users count           : 20

 CAC-Free's AC Request Policy    : Response Success

 CAC Unauthed Frame Policy       : Downgrade

 CAC Medium Time Limitation(us)  : 100000

 CAC AC-VO's Max Delay(us)       : 50000

 CAC AC-VI's Max Delay(us)       : 300000

 SVP packet mapped AC number     : Disabled

 Radio's WMM Parameters:

                          AC-BK    AC-BE    AC-VI    AC-VO

       ECWmin                 4        4        3        2

       ECWmax                10        6        4        3

       AIFSN                  7        3        1        1

       TXOPLimit              0        0       94       47

       AckPolicy         Normal   Normal   Normal   Normal

 Client's WMM Parameters:

                          AC-BK    AC-BE    AC-VI    AC-VO

       ECWmin                 4        4        3        2

       ECWmax                10       10        4        3

       AIFSN                  7        3        2        2

       TXOPLimit              0        0       94       47

       CAC              Disable  Disable  Disable  Disable

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

# Display the configuration information for all radio policies.

<Sysname> display wlan radio-policy

                             Radio Policy Parameters

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

 Radio Policy Name               : default_rp

 Fragmentation Threshold (Bytes) : 2346

 Beacon Interval (TU)            : 100

 RTS Threshold (Bytes)           : 2346

 DTIM Period (Beacon Interval)   : 1

 Long Retry Threshold            : 4

 Short Retry Threshold           : 7

 Maximum Rx Duration (ms)        : 2000

 Maximum clients per Radio       : 64

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

 QoS Mode                        : WMM

 Admission Control Policy        : Users

 Threshold users count           : 20

 CAC-Free's AC Request Policy    : Response Success

 CAC Unauthed Frame Policy       : Downgrade

 CAC Medium Time Limitation(us)  : 100000

 CAC AC-VO's Max Delay(us)       : 50000

 CAC AC-VI's Max Delay(us)       : 300000

 SVP packet mapped AC number     : Disabled

 Radio's WMM Parameters:

                          AC-BK    AC-BE    AC-VI    AC-VO

       ECWmin                 4        4        3        2

       ECWmax                10        6        4        3

       AIFSN                  7        3        1        1

       TXOPLimit              0        0       94       47

       AckPolicy         Normal   Normal   Normal   Normal

 Client's WMM Parameters:

                          AC-BK    AC-BE    AC-VI    AC-VO

       ECWmin                 4        4        3        2

       ECWmax                10       10        4        3

       AIFSN                  7        3        2        2

       TXOPLimit              0        0       94       47

       CAC              Disable  Disable  Disable  Disable

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

                             Radio Policy Parameters

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

 Radio Policy Name               : radio1

 Fragmentation Threshold (Bytes) : 2346

 Beacon Interval (TU)            : 100

 RTS Threshold (Bytes)           : 2346

 DTIM Period (Beacon Interval)   : 1

 Long Retry Threshold            : 4

 Short Retry Threshold           : 7

 Maximum Rx Duration (ms)        : 2000

 Maximum clients per Radio       : 64

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

 QoS Mode                        : WMM

 Admission Control Policy        : Channelutilization

 Threshold utilization (%)       : 70

 CAC-Free's AC Request Policy    : Response Success

 CAC Unauthed Frame Policy       : Downgrade

 CAC Medium Time Limitation(us)  : 100000

 CAC AC-VO's Max Delay(us)       : 50000

 CAC AC-VI's Max Delay(us)       : 300000

 SVP packet mapped AC number     : Disabled

 Radio's WMM Parameters:

                          AC-BK    AC-BE    AC-VI    AC-VO

       ECWmin                 4        4        3        2

       ECWmax                10        6        4        3

       AIFSN                  7        3        1        1

       TXOPLimit              0        0       94       47

       AckPolicy         Normal   Normal   Normal   Normal

 Client's WMM Parameters:

                          AC-BK    AC-BE    AC-VI    AC-VO

       ECWmin                 4        4        3        2

       ECWmax                10       10        4        3

       AIFSN                  7        3        2        2

       TXOPLimit              0        0       94       47

       CAC              Disable  Disable  Disable  Disable

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

Table 3 Command output

Field

Description

Radio Policy Name

Radio policy name.

Fragmentation Threshold

Fragmentation threshold. If the length of a packet exceeds the threshold, the packet is fragmented before being transmitted.

Beacon Interval

Interval for sending beacon frames.

RTS Threshold

RTS threshold. If the length of a packet received on an AP exceeds the specified RTS threshold, the AP enables the RTS/CTS mechanism.

DTIM Period

DTIM period in units of beacon intervals.

Delivery traffic indication messages (DTIMs) are used to tell whether the buffered multicast packets can be transmitted.

Long Retry Threshold

Maximum number of retransmission attempts allowed for a frame greater than the RTS threshold.

Short Retry Threshold

Maximum number of retransmission attempts allowed for a frame shorter than the RTS threshold.

Maximum Rx Duration

Maximum time that a received packet can stay in the buffer.

Maximum clients per Radio

Maximum number of clients allowed per radio.

QoS Mode

WMM indicates that the WMM function is supported; None indicates that the WMM function is not supported.

Admission Control Policy

Admission control policy.

Threshold users count

Threshold when the users-based admission policy is applied.

Threshold users utilization (%)

Threshold when channel utilization-based admission policy is applied.

CAC-Free's AC Request Policy

Response policy adopted for CAC-incapable ACs.

CAC Unauthed Frame Policy

Policy of processing frames unauthorized by CAC.

CAC Medium Time Limitation(us)

Maximum medium time allowed by the CAC policy (in microseconds).

CAC AC-VO's Max Delay(us)

Maximum voice traffic delay allowed by the CAC policy (in microseconds).

CAC AC-VI's Max Delay(us)

Maximum video traffic delay allowed by the CAC policy (in microseconds).

SVP packet mapped AC number

Number of the AC to which SVP packets are mapped.

ECWmin

ECWmin value (Exponent form of CWmin)

ECWmin and ECWmax determine the average backoff slots, which increase as the two values increase. For the detailed description of EDCA parameters, see WLAN Configuration Guide.

ECWmax

ECWmax value (Exponent form of CWmax).

AIFSN

AIFSN value.

TXOPLimit

TXOPLimit value.

AckPolicy

ACK policy adopted by an AC.

CAC

Indicates whether an AC is controlled by CAC: Disabled indicates that the AC is not controlled by CAC, Enabled indicates that the AC is controlled by CAC.

 

display wlan service-template

Syntax

display wlan service-template [ service-template-number ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

service-template-number: Displays information about the specified service template. The value is in the range of 1 to 1024. If no service template is specified, all service templates are displayed.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display wlan service-template to display WLAN service template information.

Examples

# Display the configuration information for service template 1.

<Sysname> display wlan service-template 1

                          Service Template Parameters

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

 Service Template Number      : 1

 SSID                         : sharedkey

 Binding Interface            : WLAN-ESS1

 Service Template Type        : Crypto

 Security IE                  : Not Configured

 Authentication Method        : Shared Key

 SSID-hide                    : Disable

 Cipher Suite                 : WEP40

 WEP Key Index  1             : WEP40

 WEP Key Mode                 : ASCII

 WEP Key                      : -_'PV5%9O`CQ=^Q`MAF4<1!!

 WEP Key Index                : 1

 TKIP Countermeasure Time(s)  : 60

 PTK Life Time(s)             : 43200

 GTK Rekey                    : Enable

 GTK Rekey Method             : Time-based

 GTK Rekey Time(s)            : 86400

 Bridge Mode                  : Remote Forwarding

 Service Template Status      : Enable

 Maximum clients per BSS      : 64

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

Table 4 Command output

Field

Description

Service Template Number

Current service template number.

SSID

Service set identifier with which the client associates.

Binding Interface

Name of the interface bound with the service template.

Service Template Type

Service template type crypto or clear.

Security IE

Security IE such as WPA and WPA2(RSN).

Authentication Algorithm

Type of authentication used.

SSID-hide

Enabled or disabled.

Forwarding Mode

Forwarding mode, local or remote.

Cipher Suite

Cipher suite such as AES-CCMP, TKIP, WEP40, WEP104 or WEP128.

WEP Key Index

Key index to encrypt or decrypt frames.

WEP Key Mode

WEP key format.

·     HEXHexadecimal string.

·     ASCIIASCII character string.

TKIP Countermeasure Time(s)

Counter measure time for MIC failure in seconds.

PTK Life Time(s)

PTK lifetime in seconds.

GTK Rekey

GTK rekey configured.

GTK Rekey Method

GTK rekey method configured such as packet based or time based.

GTK Rekey Time

Time for GTK rekey in seconds.

Bridge Mode

Forwarding mode:

·     Local forwardingAPs forward client data.

·     Remote forwardingThe AC forwards client data.

Service Template Status

Status such as enabled or disabled.

Maximum clients per BSS

Maximum number of associated clients per BSS.

 

display wlan statistics ap connect-history

Syntax

display wlan statistics ap { all | name ap-name } connect-history [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all: Displays the connection statistics of all APs.

name ap-name: Specifies the name of the AP, a case-insensitive string of 1 to 32 characters.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display wlan statistics ap connect-history to display AP connection statistics.

Examples

# Display the connection statistics of AP1.

<sysname> display wlan statistics ap name ap1 connect-history

                            Connection History   

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

 AP Name                    : ap1

Associations               : 120

 Reassociations              :16

 Failures                   : 3

 Rejections                 : 23

 Exceptional Deassociations : 2

 Current Associations       : 51

Table 5 Command output

Field

Description

AP name

AP name

Associations

Total number of associations

Reassociations

Total number of reassociations

Failures

Total number of failed associations

Rejections

Total number of associations rejected

Exceptional Deassociations

Total number of exceptional associations

Current Associations

Number of current associations

 

display wlan statistics client

Syntax

display wlan statistics client { all | mac-address mac-address } [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

client: Displays client statistics.

all: Displays the statistics of all clients.

mac-address mac-address: Displays the statistics of the client with the specified MAC address.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display wlan statistics client to display client statistics.

Examples

# Display the statistics of all the clients.

<Sysname> display wlan statistics client all

                                Client Statistics

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

 AP Name                           : ap1

 Radio Id                          : 1

 SSID                              : office-1

 BSSID                             : 000f-e2ff-7700

 MAC Address                       : 0014-6c8a-43ff

 RSSI                              : 31

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

 Transmitted Frames:

 Back Ground (Frames/Bytes)        : 0/0

 Best Effort (Frames/Bytes)        : 9/1230

 Video (Frames/Bytes)              : 0/0

 Voice (Frames/Bytes)              : 2/76

 Received Frames:

 Back Ground (Frames/Bytes)        : 0/0

 Best Effort (Frames/Bytes)        : 18/2437

 Video (Frames/Bytes)              : 0/0

 Voice (Frames/Bytes)              : 7/468

 Discarded Frames:

 Back Ground (Frames/Bytes)        : 0/0

 Best Effort (Frames/Bytes)        : 0/0

 Video (Frames/Bytes)              : 0/0

 Voice (Frames/Bytes)              : 5/389

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

Table 6 Command output

Field

Description

AP Name

Access Point name

Radio Id

Radio ID

SSID

SSID to which the client is associated

BSSID

ID of the BSS

MAC Address

MAC address of the client

RSSI

Received Signal Strength Indicator. It indicates the client signal strength detected by the AP.

Transmitted Frames

Transmitted Frames

Back Ground

Statistics of background traffic

Best Effort

Statistics of best effort traffic

Video

Statistics of video traffic

Voice

Statistics of voice traffic

Received Frames

Received frames

Discarded Frames

Discarded frames

 

 

NOTE:

Statistics for background, best effort, video, and voice traffic are only for QoS-capable clients. For QoS-incapable clients, only best effort traffic statistics are available (including SVP packets) and may be inconsistent with the real physical output queues because the priority-queue statistics can only identify priorities carried in Dot11E and WMM packets. Otherwise, statistics of received packets cannot be collected.

 

display wlan statistics radio

Syntax

display wlan statistics radio [ ap ap-name ] [ load ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

radio: Displays radio statistics.

ap ap-name: Displays the radio statistics of an AP. The AP name is a case-insensitive string of 1 to 32 characters that can contain letters, digits, underscores (_), square brackets ([ ]), slashes (/), and hyphens (-), but not spaces. If the ap ap-name option is not specified, the radio statistics of all APs are displayed.

load: Displays the load information.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display wlan statistics radio to display radio statistics.

Use display wlan statistics radio load to display radio load information.

Examples

# Display the radio statistics of AP 1.

<Sysname> display wlan statistics radio ap1

Radio Statistics

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

 AP Name: ap1                                   Radio Id: 1

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

 Transmitted Frames Statistics:

   Total Frames (Frames/Bytes)               : 0/0

   Unicast Frames (Frames/Bytes)             : 0/0

   Broadcast/Multicast Frames (Frames/Bytes) : 0/0

   Discarded Frames                : 0          Failed RTS         : 0

   Retry Count                     : 0          Successful RTS     : 0

   Multiple Retry Count            : 0          Failed ACK         : 0

   Authentication Frames           : 0          Association Frames : 0

   Packet Count Statistics Based on Size:

     128 >= size                   : 0

     128 < size <= 512             : 0

     512 < size <= 1024            : 0

     1024 < size                   : 0

   Packet Count Statistics Based on Rate:

         6 Mbps                    : 0                   9 Mbps    : 0

        12 Mbps                    : 0                  18 Mbps    : 0

        24 Mbps                    : 0                  36 Mbps    : 0

        48 Mbps                    : 0                  54 Mbps    : 0

   Packet Count Statistics Based on MCS Rate:

       6.5 Mbps                    : 0                  13 Mbps    : 0

      13.5 Mbps                    : 0                  15 Mbps    : 0

      19.5 Mbps                    : 0                  26 Mbps    : 0

        27 Mbps                    : 0                  30 Mbps    : 0

        39 Mbps                    : 0                40.5 Mbps    : 0

        45 Mbps                    : 0                  52 Mbps    : 0

        54 Mbps                    : 0                58.5 Mbps    : 0

        60 Mbps                    : 0                  65 Mbps    : 0

        78 Mbps                    : 0                  81 Mbps    : 0

        90 Mbps                    : 0                 104 Mbps    : 0

       108 Mbps                    : 0                 117 Mbps    : 0

       120 Mbps                    : 0               121.5 Mbps    : 0

       130 Mbps                    : 0                 135 Mbps    : 0

       150 Mbps                    : 0                 162 Mbps    : 0

       180 Mbps                    : 0                 216 Mbps    : 0

       240 Mbps                    : 0                 243 Mbps    : 0

       270 Mbps                    : 0                 300 Mbps    : 0

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

 Received Frames Statistics:

   Total Frames (Frames/Bytes)               : 0/0

   Unicast Frames (Frames/Bytes)             : 0/0

   Broadcast/Multicast Frames (Frames/Bytes) : 0/0

   Fragmented Frames               : 0          Duplicate Frames   : 0

   FCS Failures                    : 0          Decryption Errors  : 0

   Authentication Frames           : 0          Association Frames : 0

   Packet Count Statistics Based on Size:

     128 >= size                   : 0

     128 < size <= 512             : 0

     512 < size <= 1024            : 0

     1024 < size                   : 0

   Packet Count Statistics Based on Rate:

         6 Mbps                    : 0                   9 Mbps    : 0

        12 Mbps                    : 0                  18 Mbps    : 0

        24 Mbps                    : 0                  36 Mbps    : 0

        48 Mbps                    : 0                  54 Mbps    : 0

   Packet Count Statistics Based on MCS Rate:

       6.5 Mbps                    : 0                  13 Mbps    : 0

      13.5 Mbps                    : 0                  15 Mbps    : 0

      19.5 Mbps                    : 0                  26 Mbps    : 0

        27 Mbps                    : 0                  30 Mbps    : 0

        39 Mbps                    : 0                40.5 Mbps    : 0

        45 Mbps                    : 0                  52 Mbps    : 0

        54 Mbps                    : 0                58.5 Mbps    : 0

        60 Mbps                    : 0                  65 Mbps    : 0

        78 Mbps                    : 0                  81 Mbps    : 0

        90 Mbps                    : 0                 104 Mbps    : 0

       108 Mbps                    : 0                 117 Mbps    : 0

       120 Mbps                    : 0               121.5 Mbps    : 0

       130 Mbps                    : 0                 135 Mbps    : 0

       150 Mbps                    : 0                 162 Mbps    : 0

       180 Mbps                    : 0                 216 Mbps    : 0

       240 Mbps                    : 0                 243 Mbps    : 0

       270 Mbps                    : 0                 300 Mbps    : 0

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

Table 7 Command output

Field

Description

AP name

Access Point name

Radio ID

Radio ID

Transmitted Frames Statistics

Total Frames

Number of frames transmitted, including probe responses and beacon frames

Unicast Frames

Number of unicast frames transmitted, excluding probe responses

Broadcast/Multicast Frames

Number of broadcast or multicast frames transmitted

Others (Frames/Bytes)

Number of other frames transmitted

Discard Frames

Number of frames discarded.

Failed RTS

Number of RTS failed during transmission

Retry Count

Number of transmission retries

Successful RTS

Number of RTS transmitted successfully

Multiple Retry Count

Number of transmission retries

Failed Ack

Number of transmitted frames for which no acknowledgement is received

Authentication Frames

Number of authentication response frames transmitted

Association Frames

Number of association response frames transmitted

Packet Count Statistics Based on Size

Packet statistics classified by packet size

Packet Count Statistics Based on Rate

Packet statistics classified by rate

Packet Count Statistics Based on 802.11n Rate

Packet statistics classified by 802.11n rate. The field is not displayed if the device does not support 802.11n.

Received Frames Statistics

Total Frames

Number of fragmented frames received

Unicast Frames

Number of unicast frames received

Broadcast/Multicast Frames

Number of broadcast or multicast frames received

Fragmented Frames

Number of fragmented frames received

Duplicate Frames

Number of duplicate frames received

FCS Failures

Number of frames dropped due to FCS failure

Decryption Errors

Number of frames dropped due to decryption error

Authentication Frames

Number of authentication request frames received

Association Frames

Number of association request frames received

 

# Display the radio load information of all APs.

<sysname> display wlan statistics radio load

                            Radio Load   

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

 AP Name                                Radio       Client Number

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

 ap1                                    1           0

 ap1                                    2           11

 ap2                                    1           20

 ap_chinanet_1                          1           5

 ap_chinanet_2                          2           35

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

Table 8 Command output

Field

Description

AP name

Access Point name

Radio ID

Radio ID

Client Number

Number of associated clients

 

display wlan statistics service-template

Syntax

display wlan statistics service-template service-template-number [ connect-history ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

service-template-number: Service template number, in the range of 1 to 1024.

connection-history: Displays the connection history.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display wlan statistics service-template to display service template statistics.

Use display wlan statistics service-template service-template-number connect-history to display the connection statistics for all APs bound to the service template.

Examples

# Display the statistics of service template office.

<sysname> display wlan statistics service-template office

                        Service Template Statistics

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

Service Template           : office

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

AP Name                    : ap1                                              

 Radio                      : 1                                                

 Receive                    :                                                  

    Frame Count             : 1713                                             

    Frame Bytes             : 487061                                           

    Data Frame Count        : 1683                                             

    Data Frame Bytes        : 485761                                           

    Associate Frame Count   : 2                                                 

 Send                       :                                                  

    Frame Count             : 62113                                             

    Frame Bytes             : 25142076                                         

    Data Frame Count        : 55978                                            

    Data Frame Bytes        : 22626600                                          

Associate Frame Count   : 2                                                

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

Table 9 Command output

Field

Description

Service Template

Service template number

AP Name

AP name

Receive

Receive statistics:

·     Frame Count—Number of frames received

·     Frame Bytes—Number of bytes received

·     Data Frame Count—Number of data frames received

·     Data Frame Bytes—Number of data bytes received

·     Associate Frame Count—Number of association requests received

Send

Send statistics:

·     Frame Count—Number of frames sent

·     Frame Bytes—Number of bytes sent

·     Data Frame Count—Number of data frames sent

·     Data Frame Bytes—Number of data bytes sent

·     Associate Frame Count—Number of association requests sent

 

# Display the connection history of service template office.

<sysname> display wlan statistics service-template office connect-history

                            Connect History   

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

 Service Template           : office

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

 AP Name                    : ap1

 Radio                      : 1

 Associations               : 132

 Failures                   : 3

 Reassociations             : 30

 Rejections                 : 12

 Exceptional Deassociations : 2

 Current Associations       : 57

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

 AP Name                    : ap1

 Radio                      : 2

 Associations               : 1004

 Failures                   : 35

 Reassociations             : 59

 Rejections                 : 4

 Exceptional Deassociations : 22

 Current Associations       : 300

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

Table 10 Command output

Field

Description

Service Template

Service template number

AP name

AP name

Radio

Radio number

Associations

Total number of associations

Failures

Total number of failed associations

Reassociations

Total number of reassociations

Rejections

Total number of associations rejected

Exceptional Deassociations

Total number of exceptional associations

Current Associations

Number of current associations

 

distance

Syntax

distance distance

undo distance

View

Radio view

Default level

2: System level

Parameters

distance: Specifies the maximum distance that the radio can cover, in the range of 1 to 40 km (0.62 to 24.86 miles).

Description

Use distance to configure the maximum distance that the radio can cover.

Use undo distance to restore the default.

By default, the radio can cover 1 km (0.62 miles) at most.

Examples

# Configure the maximum distance that the radio can cover as 5 km (3.11 miles).

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2100

[Sysname-wlan-ap-ap1] radio 1

[Sysname-wlan-ap-ap1-radio-1] distance 5

dtim

Syntax

dtim counter

undo dtim

View

Radio policy view

Default level

2: System level

Parameters

counter: Number of beacon intervals between delivery traffic indication message (DTIM) transmissions. The value is in the range of 1 to 31.

Description

Use dtim to set the number of beacon intervals an AP waits before it sends buffered multicast and broadcast frames. The AP sends buffered broadcast/multicast frames when the DTIM counter reaches the configured value.

Use undo dtim to restore the default.

By default, the DTIM counter is 1.

Examples

# Set the DTIM counter to 10.

<Sysname> system-view

[Sysname] wlan radio-policy rp

[Sysname-wlan-rp-rp] dtim 10

fast-association enable

Syntax

fast-association enable

undo fast-association enable

View

Service template view

Default level

2: System level

Parameters

None

Description

Use fast-association enable to enable fast association.

Use undo fast-association enable to disable fast association.

By default, fast association is disabled.

When fast association is enabled, the AP does not perform band navigation and load balancing calculations for clients bound to the SSID.

Examples

# Enable fast association.

<Sysname> system-view

[Sysname] wlan service-template 1

[Sysname-wlan-st-1] fast-association enable

fragment-threshold

Syntax

fragment-threshold size

undo fragment-threshold

View

Radio policy view

Default level

2: System level

Parameters

size: Maximum frame length without fragmentation. The value is in the range of 256 to 2346 bytes and must be an even number.

Description

Use fragment-threshold to specify the maximum length of frames that can be transmitted without fragmentation. When the length of a frame exceeds the specified fragment threshold value, it is fragmented.

Use undo fragment-threshold to restore the default value.

By default, the fragment threshold is 2346 bytes. Frames that exceed 2346 bytes are fragmented.

Examples

# Specify the fragment threshold as 2048 bytes.

<Sysname> system-view

[Sysname] wlan radio-policy rp

[Sysname-wlan-rp-rp] fragment-threshold 2048

long-retry threshold

Syntax

long-retry threshold count

undo long-retry threshold

View

Radio policy view

Default level

2: System level

Parameters

count: Number of retransmission attempts for frames larger than the RTS threshold, in the range of 1 to 15.

Description

Use long-retry threshold to set the number of retransmission attempts for frames larger than the RTS threshold.

Use undo long-retry threshold to restore the default.

By default, the long retry threshold is 4.

Examples

# Specify the long-retry threshold as 10.

<Sysname> system-view

[Sysname] wlan radio-policy rp

[Sysname-wlan-rp-rp] long-retry threshold 10

max-power

Syntax

max-power radio-power

undo max-power

View

Radio view

Default level

2: System level

Parameters

radio-power: Maximum radio transmission power, which varies with country codes and radio types. The value depends on the device model.

Description

Use max-power to configure the maximum transmission power on the radio.

Use undo max-power to restore the default.

By default, the maximum radio power varies with country codes, channels, AP models, radio types and antenna types. If 802.11n is adopted, the maximum radio power also depends on the bandwidth mode.

Related commands: wlan country-code and radio type.

Examples

# Specify the max transmission power of radio 1 as 5.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA2100

[Sysname-wlan-ap-ap3] radio 1 type dot11b

[Sysname-wlan-ap-ap3-radio-1] max-power 5

max-rx-duration

Syntax

max-rx-duration interval

undo max-rx-duration

View

Radio policy view

Default level

2: System level

Parameters

interval: Maximum interval for which a frame received by an AP can stay in the buffer memory. The value is in the range of 500 to 250000 milliseconds.

Description

Use max-rx-duration to specify the maximum interval for the AP to hold a received frame.

Use undo max-rx-duration to restore the default.

By default, the max-rx-duration is 2000 milliseconds.

Examples

# Set the max-rx-duration as 5000 milliseconds.

<Sysname> system-view

[Sysname] wlan radio-policy radio1

[Sysname-wlan-rp-radio1] max-rx-duration 5000

nas-id

Syntax

nas-id text

undo nas-id

View

AP template view

Default level

2: System level

Parameters

text: Sets the network access server (NAS)-ID for an AP. It is a case-sensitive string of 1 to 20 characters.

Description

Use nas-id to set the NAS-ID for an AP.

Use undo nas-id to remove the NAS-ID.

By default, no NAS-ID is configured for an AP.

Examples

# Set the NAS-ID for AP 1 to 0002053110000460.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2100

[Sysname-ap-ap1] nas-id 0002053110000460

nas-port-id

Syntax

nas-port-id text

undo nas-port-id

View

AP template view

Default level

2: System level

Parameters

text: Sets the NAS-PORT-ID for an AP. It is a case-sensitive string of 1 to 63 characters.

Description

Use nas-port-id to set the NAS-PORT-ID for an AP.

Use undo nas-port-id to remove the NAS-PORT-ID.

By default, no NAS-PORT-ID is configured for an AP.

Examples

# Set the NAS-PORT-ID for AP 1 to abcd1234.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2100

[Sysname-ap-ap1] nas-port-id abcd1234

power lock

Syntax

power lock

undo power lock

View

Radio view

Default level

2: System level

Parameters

None

Description

Use power lock to lock the current power, and set the current power as the maximum power.

Use undo power lock to unlock the current power, and restore the maximum power set by the max-power command.

By default, the current power is not locked.

If you configure the power lock command first, and then enable power selection, Transmit power control (TPC) does not work because the power is locked. Therefore, before enabling TPC, be sure that the current power is not locked. If you enable TPC, and then configure the power lock command, the last selected power is locked. For more information about TPC, see WLAN Configuration Guide.

Related commands: max-power, dot11a calibrate-power, and dot11bg calibrate-power.

Examples

# Lock the current power.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA2100

[Sysname-wlan-ap-ap3] radio 1 type dot11g

[Sysname-wlan-ap-ap3-radio-1] power lock

preamble

Syntax

preamble { long | short }

undo preamble

View

Radio view

Default level

2: System level

Parameters

long: Indicates that only frames with long preamble can be transmitted.

short: Indicates that frames with either short preamble or long preamble can be transmitted.

Description

Use preamble to specify the preamble type.

Use undo preamble to restore the default.

Preamble is a pattern of bits at the beginning of a frame so that the receiver can sync up and be ready for the real data. There are two different kinds of preambles, short and long.

By default, the short preamble is supported.

 

 

NOTE:

802.11a and 802.11an do not support this configuration.

 

Examples

# Configure the AP to support long preamble.

<Sysname> system-view

[Sysname] wlan ap ap2 model WA2100

[Sysname-wlan-ap-ap2] radio 1 type dot11b

[Sysname-wlan-ap-ap2-radio-1] preamble long

protection-mode

Syntax

protection-mode { cts-to-self | rts-cts }

undo protection-mode

View

Radio policy view

Default level

2: System level

Parameters

cts-to-self: Specifies the Clear to Send (CTS)-to-Self collision avoidance mechanism.

rts-cts: Specifies the Request to Send (RTS)/CTS collision avoidance mechanism.

Description

Use protection-mode to specify a collision avoidance mechanism. When the size of a data frame sent by the AP exceeds the specified threshold, the specified collision avoidance mechanism is used.

Use undo protection-mode to restore the default.

By default, the collision avoidance mechanism is RTS/CTS.

 

 

NOTE:

For more information about CTS-to-Self and RTS/CTS, see WLAN Configuration Guide.

 

Examples

# Configure the collision avoidance mechanism as CTS-to-Self.

<Sysname> system-view

[Sysname] wlan radio-policy test

[Sysname-wlan-rp-test] protection-mode cts-to-self

radio

Syntax

radio { disable | enable }

undo radio

View

Radio view

Default level

2: System level

Parameters

disable: Disables the radio.

enable: Enables the radio.

Description

Use radio to enable or disable the radio.

Use undo radio to remove the configuration.

By default, all radios are disabled.

Examples

# Enable radio 1 of the AP.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA2100

[Sysname-wlan-ap-ap3] radio 1 type dot11b

[Sysname-wlan-ap-ap3-radio-1] radio enable

radio type

Syntax

radio radio-number [ type { dot11a | dot11an | dot11b | dot11g | dot11gn } ]

View

AP template view

Default level

2: System level

Parameters

radio-number: Radio number. The radio number value is 1 or 2. The actual value range is based on the AP model.

dot11a: Indicates the wireless radio type is 802.11a.

dot11an: Indicates the wireless radio type is 802.11an (5GHz).

dot11b: Indicates the wireless radio type is 802.11b.

dot11g: Indicates the wireless radio type is 802.11g.

dot11gn: Indicates the wireless radio type is 802.11gn (2.4GHz).

Description

Use radio type to specify the radio type to be used by a radio, and enter radio view.

The default setting varies depending on the AP model.

Examples

# Specify the radio type as 802.11g for radio 1.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA2100

[Sysname-wlan-ap-ap3] radio 1 type dot11g

# Specify the radio type as 802.11an for radio 1.

<sysname> system-view

[sysname] wlan ap ap1 model WA2620-AGN

[sysname-wlan-ap-ap1] radio 1 type dot11an

radio-policy

Syntax

radio-policy radio-policy-name

undo radio-policy

View

Radio view

Default level

2: System level

Parameters

radio-policy-name: Name of the radio policy, a case-insensitive string of 1 to 15 characters that can contain letters, digits and underscores but not spaces.

Description

Use radio-policy to map a radio policy to a radio.

Use undo radio-policy to remove the mapping.

By default, the default_rp radio policy is mapped to a radio. The default_rp radio policy contains all the default parameters.

The radio policy to be bound must have been created with the wlan radio-policy command.

Related commands: display wlan radio-policy and wlan radio-policy.

Examples

# Map radio policy radiorp to radio 1.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA2100

[Sysname-wlan-ap-ap3] radio 1 type dot11b

[Sysname-wlan-ap-ap3-radio-1] radio-policy radiorp

reset wlan client

Syntax

reset wlan client { all | mac-address mac-address }

View

User view

Default level

2: System level

Parameters

all: Terminates connections of all clients to the AP.

mac address mac-address: Specifies the MAC address of the client whose connection to the AP is to be terminated.

Description

Use reset wlan client to terminate connections of a client or all clients to the AP. When this command is used, the AP sends a de-authentication frame to the client and the client is removed from the WLAN service.

Examples

# Terminate the connection of the client with MAC address 000f-e2cc-8501 to the AP.

<Sysname> reset wlan client mac-address 000f-e2cc-8501

reset wlan statistics

Syntax

reset wlan statistics { client { all |  mac-address mac-address } | radio [ ap-name ] }

View

User view

Default level

2: System level

Parameters

all: Clears the statistics of all clients.

mac-address mac-address: Clears the statistics of the client.

ap-name: Clears the radio statistics of an AP. The AP name is a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.

Description

Use reset wlan statistics to clear statistics of the specified AP or client, or all clients.

Examples

# Clear the radio statistics of AP1.

<Sysname> reset wlan statistics radio ap1

rts-threshold

Syntax

rts-threshold size

undo rts-threshold

View

Radio policy view

Default level

2: System level

Parameters

size: Length of frames for which the request to send (RTS) mechanism is used. The value is in the range of 0 to 2346 bytes.

Description

Use rts-threshold to specify the RTS threshold length. If a frame is larger than this value, the RTS mechanism is used.

Use undo rts-threshold to restore the default.

By default, the RTS threshold is 2346 bytes.

RTS is used to avoid data collisions in a WLAN.

A small value causes RTS packets to be sent more often, consuming more of the available bandwidth. However, the more often RTS packets are sent, the quicker the system can recover from interference or collisions.

Examples

# Specify the RTS threshold as 2046 bytes.

<Sysname> system-view

[Sysname] wlan radio-policy rp

[Sysname-wlan-rp-rp] rts-threshold 2046

service-template (radio view)

Syntax

service-template service-template-number [ vlan-id vlan-id1 [ vlan-id2 ] ] [ nas-port-id nas-port-id | nas-id nas-id ] [ ssid-hide ]

undo service-template service-template-number

View

Radio view

Default level

2: System level

Parameters

service-template-number: Number of a service template in the range of 1 to 1024.

vlan-id vlan-id1 vlan-id2: Sets the ID of a VLAN to be bound, in the range of 1 to 1024. You can select two VLANs for QinQ application.

nas-port-id nas-port-id: Sets the ID of the NAS port to be bound. The ID is a case-insensitive string of 1 to 63 characters, without spaces.

nas-id nas-id: Sets the ID of the NAS to be bound. The ID is a case-insensitive string of 1 to 20 characters, without spaces.

ssid-hide: Sets to hide the SSID in beacon frames for the service bound to the AP. If you do not specify this keyword, whether the SSID is hidden or not depends on the beacon ssid-hide command.

Description

Use service-template to map a service template to the current radio.

Use undo service-template to remove the mapping.

By default, no service template is mapped to a radio.

You can map multiple service templates to a radio.

Examples

# Map service template 1 to radio 1.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA2100

[Sysname-wlan-ap-ap3] radio 1

[Sysname-wlan-ap-ap3-radio-1] service-template 1

service-template (service template view)

Syntax

service-template { disable | enable }

undo service-template enable

View

Service template view

Default level

2: System level

Parameters

disable: Disables the service template.

enable: Enables the service template.

Description

Use service-template enable to enable the service template.

Use service-template disable or undo service-template enable to disable the service template.

By default, the service template is disabled.

Examples

# Enable service template 1.

<Sysname> system-view

[Sysname] wlan service-template 1 clear

[Sysname-wlan-st-1] ssid clear

[Sysname-wlan-st-1] bind wlan-ess 1

[Sysname-wlan-st-1] authentication-method open-system

[Sysname-wlan-st-1] service-template enable

short-gi enable

Syntax

short-gi enable

undo short-gi enable

View

Radio view

Default level

2: System level

Parameters

None

Description

Use short-gi enable to enable the short GI function.

Use undo short-gi enable to disable the short GI function.

By default, the short GI function is enabled.

This command is only effective on 802.11n radios.

If you change the radio type of an 802.11n radio, the default setting for this function of the new radio type is restored.

Delays may occur during receiving radio signals due to factors like multi-path reception. Therefore, a subsequently sent frame may interfere with a previously sent frame. The GI function is used to avoid such interference.

The GI interval in 802.11a/g is 800 us. The short GI function can be configured for 802.11n. This can shorten the GI interval to 400 ns, which increases the data speed by 10 percent.

Examples

# Disable the short GI function.

<sysname> system-view

[sysname] wlan ap ap3 model WA2620-AGN

[sysname-wlan-ap-ap3] radio 1 type dot11an

[sysname-wlan-ap-ap3-radio-1] undo short-gi enable

short-retry threshold

Syntax

short-retry threshold count

undo short-retry threshold

View

Radio policy view

Default level

2: System level

Parameters

count: Number of times the AP can send a short unicast frame (less than the RTS threshold) if no acknowledgment is received for it. The value is in the range of 1 to 15.

Description

Use short-retry threshold to specify the maximum number of attempts to transmit a frame less than the RTS threshold.

Use undo short-retry threshold to restore the default.

By default, the short retry threshold is 7.

Examples

# Specify the short retry threshold as 10.

<Sysname> system-view

[Sysname] wlan radio-policy rp

[Sysname-wlan-rp-rp] short-retry threshold 10

shut-all-led enable

Syntax

shut-all-led enable

undo shut-all-led enable

View

AP template view

Default level

2: System level

Parameters

None

Description

Use shut-all-led enable to shut down all LEDs on all the online APs of the current AP template.

Use undo shut-all-led enable to restore the default.

By default, all LEDs on all the online APs of the current AP template light based on AP status.

Examples

# Shut down all LEDs on all the online APs of AP template ap5.

<Sysname>system-view

[Sysname]wlan ap ap5 model WA2620-AGN

[Sysname-wlan-ap-ap5]shut-all-led enable

ssid

Syntax

ssid ssid-name

undo ssid

View

Service template view

Default level

2: System level

Parameters

ssid-name: Name of the service set identifier, a case-sensitive string of 1 to 32 characters that can contain letters, digits, underlines, and spaces.

Description

Use ssid to set the SSID for the current service template.

Use undo ssid to remove the SSID.

By default, no SSID is set for the service template.

An SSID must be as unique as possible. For security, the company name must not be contained in the SSID. Meanwhile, it is not recommended to use a long random string as the SSID, because a long random string only adds payload to the header field, without any improvement to wireless security.

Examples

# Set the SSID as firstfloor for service template 1.

<Sysname> system-view

[Sysname] wlan service-template 1 clear

[Sysname-wlan-st-1] ssid firstfloor

trap enable

Syntax

trap enable

undo trap enable

View

AP template view

Default level

2: System level

Parameters

None

Description

Use trap enable to enable traps for the AP.

Use undo trap enable to disable traps for the AP.

By default, traps are disabled.

Examples

# Enable traps for the AP.

<AC>system-view

[AC]wlan ap ap2 model WA2610-AGN id 2 

[AC-wlan-ap-ap2] trap enable

[AC-wlan-ap-ap2]device-detection enable  

[AC-wlan-ap-ap2] 

#Nov 19 14:10:30:003 2009 H3C WMAC/4/AP WorkMode Changed: Work mode of AP change

d:1.3.6.1.4.1.2011.10.2.75.2.3.0.1<h3cDot11APMtWorkModeChgTrap> Serial ID:210235

A35XB09B000008 WorkMode: 3   

wlan country-code

Syntax

wlan country-code code

undo wlan country-code

View

System view

Default level

2: System level

Parameters

code: Specifies a global country code. See Table 11.

Table 11 Country code information

Country

Code

Country

Code

Andorra

AD

Korea, Republic of Korea

KR

United Arab Emirates

AE

Kenya

KE

Albania

AL

Kuwait

KW

Armenia

AM

Kazakhstan

KZ

Australia

AU

Lebanon

LB

Argentina

AR

Liechtenstein

LI

Australia

AT

Sri Lanka

LK

Azerbaijan

AZ

Lithuania

LT

Bosnia and Herzegovina

BA

Luxembourg

LU

Belgium

BE

Latvia

LV

Bulgaria

BG

Libyan

LY

Bahrain

BH

Morocco

MA

Brunei Darussalam

BN

Monaco

MC

Bolivia

BO

Moldova

MD

Brazil

BR

Macedonia

MK

Bahamas

BS

Macau

MO

Belarus

BY

Martinique

MQ

Belize

BZ

Malta

MT

Canada

CA

Mauritius

MU

Switzerland

CH

Mexico

MX

Cote d'ivoire

CI

Malay Archipelago

MY

Chile

CL

Namibia

NA

China

CN

Nigeria

NG

Colombia

CO

Nicaragua

NI

Costarica

CR

Netherlands

NL

Serbia

RS

Norway

NO

Cyprus

CY

New Zealand

NZ

Czech Republic

CZ

Oman

OM

Germany

DE

Panama

PA

Denmark

DK

Peru

PE

Dominica

DO

Poland

PL

Algeria

DZ

Philippines

PH

Ecuador

EC

Pakistan

PK

Estonia

EE

Puerto Rico

PR

Egypt

EG

Portugal

PT

Spain

ES

Paraguay

PY

Faroe Islands

FO

Qatar

QA

Finland

FI

Romania

RO

France

FR

Russian Federation

RU

Britain

GB

Saudi Arabia

SA

Georgia

GE

Sweden

SE

Gibraltar

GI

Singapore

SG

Greenland

GL

Slovenia

SI

Guadeloupe

GP

Slovak

SK

Greece

GR

San Marino

SM

Guatemala

GT

Salvador

SV

Guyana

GY

Syrian

SY

Honduras

HN

Thailand

TH

Hong Kong

HK

Tunisia

TN

Croatia

HR

Turkey

TR

Hungary

HU

Trinidad and Tobago

TT

Iceland

IS

, Province of China

TW

India

IN

Ukraine

UA

Indonesia

ID

United States of America

US

Ireland

IE

Uruguay

UY

Israel

IL

Uzbekistan

UZ

Iraq

IQ

The Vatican City State

VA

Italy

IT

Venezuela

VE

Iran

IR

Virgin Islands

VI

Jamaica

JM

Vietnam

VN

Jordan

JO

Yemen

YE

Japan

JP

South Africa

ZA

Democratic People's Republic of Korea

KP

Zimbabwe

ZW

 

Description

Use wlan country-code to specify the global country code.

Use undo wlan country-code to restore the default.

By default, the global country code is CN.

 

 

NOTE:

·     The country code determines characteristics such as the power level, total number of channels. You must set the correct country code or area code for a WLAN device (AC or AP).

·     If an AP is configured with a country code in AP template view or has a fixed country code, changing the global country code does not affect the country code of the AP.

 

Related commands: country-code.

Examples

# Specify the country code as US.

<Sysname> system-view

[Sysname] wlan country-code us

wlan link-test

Syntax

wlan link-test mac-address

View

User view

Default level

1: Monitor level

Parameters

mac-address: MAC address of a client. Only clients that have been associated with the AP can be RFPinged.

Description

Use wlan link-test to RFPing a client.

Examples

# Perform an RFPing operation to the client with the MAC address 000f-e201-0101.

<Sysname> wlan link-test 000f-e201-0101

Testing link to 000f-e201-0101, press CTRL_C to break......

                                Link Status

 RTT: Round trip time

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

 MAC Address: 000f-e201-0101

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

 No.    Rate(Mbps)  TxCnt   RxCnt   RSSI    Retries     RTT(ms)

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

 0      1           5       2       62      0           0

 1      2           5       5       10      0           0

 2      5.5         5       5       10      0           1

 3      6           5       5       10      0           0

 4      9           5       5       11      0           0

 5      11          5       5       11      0           0

 6      12          5       5       10      0           0

 7      18          5       5       10      0           0

 8      24          5       5       11      0           0

 9      36          5       5       11      0           0

 10     48          5       5       10      0           0

 11     54          5       5       11      0           0

Table 12 RFPing operation results

Field

Description

No./MCS

·     The No. field is displayed for an RFPing operation to a non 802.11n client, indicating the rate index of the client.

·     The MCS field is displayed for an RFPing operation to an 802.11n client, indicating the MCS value of the client.

Rate(Mbps)

Rate for the radio interface to send ping packets

TxCnt

Number of ping packets sent by the radio interface

RxCnt

Number of ping packets received by the radio interface from the client

RSSI

Received signal strength indicator (RSSI),

Retries

Number of retries when the radio interface failed to send ping packets

RTT(ms)

Round-trip time (RTT) from the time when the radio interface send a ping packet to the time when it receives a response from the client

 

wlan radio

Syntax

wlan radio { disable | enable } { all | dot11a | dot11an | dot11b | dot11g | dot11gn | radio-policy radio-policy-name }

View

System view

Default level

2: System level

Parameters

disable: Disables WLAN radios.

enable: Enables WLAN radios.

all: Enables or disables all the WLAN radios.

dot11a: Enables or disables 802.11a WLAN radios.

dot11an: Enables or disables 802.11an WLAN radios.

dot11b: Enables or disables 802.11b WLAN radios.

dot11g: Enables or disables 802.11g WLAN radios.

dot11gn: Enables or disables 802.11gn WLAN radios.

radio-policy radio-policy-name: Specifies a radio policy, a case-insensitive string of 1 to 15 characters that can contain letters, digits and underscores but not spaces.

Description

Use wlan radio enable to enable WLAN radios.

Use wlan radio disable to disable WLAN radios.

By default, no wlan radio is enabled.

Examples

# Enable all the radios.

<Sysname> system-view

[Sysname] wlan radio enable all

# Enable 802.11g radios.

<Sysname> system-view

[Sysname] wlan radio enable dot11g

wlan radio-policy

Syntax

wlan radio-policy radio-policy-name

undo wlan radio-policy radio-policy-name

View

System view

Default level

2: System level

Parameters

radio-policy-name: Name of a radio policy, a case-insensitive string of 1 to 15 characters that can contain letters, digits and underlines but not spaces.

Description

Use wlan radio-policy to create a radio policy, or enter radio policy view, or both. A radio policy is a set of radio attributes. If the radio policy is mapped to a radio, the radio will have all the attributes configured in the radio policy.

A WLAN radio policy includes the following attributes:

·     Radio policy name

·     Fragmentation threshold (Bytes)

·     Beacon interval (TU)

·     RTS threshold (Bytes)

·     DTIM period (Beacon Intervals)

·     Long retry threshold

·     Short retry threshold

·     Maximum Rx duration (ms)

·     Maximum Tx duration (ms)

·     The maximum duration that the frames received by the AP can be kept in the buffer (ms)

Use undo wlan radio-policy to delete the radio policy, and all related configurations.

If the radio-policy is mapped with a radio, it cannot be directly deleted before it is un-mapped.

By default, the default radio policy default_rp is mapped with a WLAN radio.

Examples

# Create a radio policy named radio1.

<Sysname> system-view

[Sysname] wlan radio-policy radio1

[Sysname-wlan-rp-radio1]

wlan radio-policy auto-create

Syntax

wlan radio-policy auto-create

undo wlan radio-policy auto-create

View

System view

Default level

2: System level

Description

Use wlan radio-policy auto-create to enable automatic creation of radio policies.

Use undo wlan radio-policy auto-create to disable automatic creation of radio policies.

By default, automatic creation of radio policies is disabled.

Examples

# Enable automatic creation of radio policies.

<Sysname> system-view

[Sysname] wlan radio-policy auto-create

# Disable automatic creation of radio policies.

<Sysname> system-view

[Sysname] undo wlan radio-policy auto-create

wlan service-template

Syntax

wlan service-template service-template-number { clear | crypto }

undo wlan service-template service-template-number

View

System view

Default level

2: System level

Parameters

service-template-number: Number of the service template, in the range of 1 to 1024.

clear: Sets the current service template type to clear, which means data is sent in clear text after the template is mapped to an AP.

crypto: Sets the current service template type to crypto, which means data is sent in cipher text after the template is mapped to an AP.

Description

Use wlan service-template to create a service template and enter service template view. If the service template exists, then you can directly enter service template view.

Use undo wlan service-template to delete the service template. If the specified service template is mapped to a radio, it cannot be directly deleted before it is un-mapped.

No service template is configured by default.

You cannot change an existing service template to another type. To do so, you must delete the service template, and configure a new service template with the new type.

Examples

# Create service template 1.

<Sysname> system-view

[Sysname] wlan service-template 1 crypto

AC-AP tunnel configuration commands

ac

Syntax

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

undo ac { host-name | ip { ip-address | all } | ipv6 { ipv6-address | all } }

View

AP configuration view

Default level

2: System level

Parameters

host-name host-name: Specifies the host name of an AC, a case-insensitive string of 1 to 255 characters. The string can contain letters, digits, "-", "_" and ".", and must contain at least one letter.

ip ip-address: Specifies the IPv4 address of an AC.

ipv6 ipv6-address: Specifies the IPv6 address of an AC.

all: Removes the IPv4/IPv6 addresses of all ACs.

Description

Use ac to specify an AC so that the AP can discover the AC.

Use undo ac to remove the AC configuration.

By default, no AC is specified for the AP.

You can specify at most three ACs' IP addresses, three ACs' IPv6 addresses, and an AC's host name for the AP.

The wlan ap-provision ac command takes effect for all APs, and the ac command in AP configuration view takes effect for the specified AP. If you configure both commands, the configuration in AP configuration view takes effect for the AP.

Related commands: wlan ap-provision ac.

Examples

# Specify the AC 192.168.100.11 so that AP 1 can discover the AC.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2100

[Sysname-wlan-ap-ap1] provision

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

ap-name

Syntax

ap-name name

undo ap-name

View

AP template view

Default level

2: System level

Parameters

name: AP name, a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces..

Description

Use ap-name to specify the name for the AP.

Use undo ap-name to clear the name of the AP.

By default, no AP name is specified.

Examples

# Set the name for an AP as admin.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2100

[Sysname-ap-ap1] ap-name admin

backup-ac

Syntax

backup-ac { ip ipv4-address | ipv6 ipv6-address }

undo backup-ac { ip | ipv6 }

View

AP template view

View

System view

Default level

2: System level

Parameters

ipv4-address: Specifies an IPv4 address for a backup AC.

Ipv6-address: Specifies an IPv6 address for a backup AC.

Description

Use backup-ac to specify an IPv4/IPv6 backup AC.

Use undo backup-ac to remove the IPv4/IPv6 backup ACs.

By default, the global backup AC, if specified, is used by the AP.

The backup AC configured in AP template view takes precedence over that configured in system view.

Examples

# Specify the backup AC at 192.168.1.2 for AP 1.

<Sysname> system-view

[Sysname] wlan backup-ac ip 192.168.1.1

[Sysname] wlan ap ap1 model WA2100

[Sysname-wlan-ap-ap1] backup-ac ip 192.168.1.2

cir

Syntax

cir committed-information-rate [ cbs committed-burst-size ]

undo cir

View

AP template view

Default level

2: System level

Parameters

cir committed-information-rate: Committed information rate in kbps, in the range of 40 to 1000000.

cbs committed-burst-size: Committed burst size in bytes, in the range of 2500 to 62500000. By default, the CBS is the number of bytes transmitted in 500 ms at the rate of CIR.

Description

Use cir to set the CIR for packets sent from AC to AP.

Use undo cir to restore the default.

By default, no CIR is set for an AP.

For more information about CIR, see ACL and QoS Command Reference.

Examples

# Set the CIR to 60 kbps, and CBS to 3000 bytes for the AP.

<Sysname> system-view

[Sysname] wlan ap ap_001 model wa2100

[Sysname-wlan-ap-ap_001] cir 60 cbs 3000

cpu-usage threshold

Syntax

cpu-usage threshold integer

View

AP template view

Default level

3: Manage level

Parameters

integer: An integer in the range of 0 to 100.

Description

Use cpu-usage threshold to set the CPU usage threshold of the AP. If the CPU usage of the AP exceeds the threshold, the AP generates an alarm.

By default, the default CPU usage threshold of the AP is 90.

Examples

# Set the CPU usage threshold of AP 3 to 95.

[Sysname] wlan ap ap3 model WA2100

[Sysname-wlan-ap-ap3] cpu-usage threshold 95

data-tunnel encryption enable

Syntax

data-tunnel encryption enable

undo data-tunnel encryption enable

View

AP configuration view

Default level

2: System level

Parameters

None

Description

Use data-tunnel encryption enable to configure the AP to use IPsec to encrypt the data tunnel.

Use undo data-tunnel encryption enable to remove the configuration.

By default, the AP does not encrypt the data tunnel.

Related commands: tunnel encryption ipsec pre-shared-key.

Examples

# Configure the AP to use IPsec to encrypt the data tunnel.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2620-AGN

[Sysname-wlan-ap-ap1] provision

[Sysname-wlan-ap-ap1-prvs] tunnel encryption ipsec pre-shared-key simple 12345

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

description

Syntax

description text

undo description

View

AP template view

Default level

2: System level

Parameters

text: Description for the AP, a string of 1 to 64 characters. A description string can be entered in uppercase as well as lower case and can have special characters and spaces, but spaces at the beginning and end of the description string are discarded if given.

Description

Use description to set a description for an AP.

Use undo description to clear the description of an AP.

By default, no description is set for an AP.

Examples

# Set a description for an AP.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2100

[Sysname-ap-ap1] description L3-office

display wlan ap

Syntax

display wlan ap { all | name ap-name } [ verbose ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all: Displays the information of all the APs.

name ap-name: Displays information about the AP. An AP name is a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.

verbose: Displays the detailed information.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

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

Examples

# Display the configuration information of AP1.

<Sysname> display wlan ap name ap1

                                  AP Profile

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

        C = Config, R = Run,  KU = KeyUpdate, KC = KeyCfm

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

 AP Name                               State  Model           Serial-ID

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

 ap                                    R/M   WA2620-AGN       210235A35V0088000005

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

Table 13 Command output

Field

Description

State

Current state of the AP:

·     IdleIdle

·     JJoin

·     JAJoin acknowledge

·     ILThe AP is downloading the version.

·     CConfiguration exchange. This state is an instantaneous state. It indicates that the AC is delivering configuration file to the fit AP, and the fit AP is collecting radio information through the radio interface and reporting to the AC.

·     RThe AP is operating. It indicates that the AP has associated with the AC. This field also indicates the active/standby state of the AC. Run/M indicates the AC is an active AC, and Run/B indicates the AC is a standby AC.

·     KUKey update

·     KCKey update confirm

 

# Display the detailed configuration information of AP1.

<Sysname> display wlan ap name ap1 verbose

                         AP Profile: ap1

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

 APID                          : 1

 AP System Name                : Not Configured

 Map Configuration             : Not Configured

 State                         : Run

 Up Time(hh:mm:ss)             : 00:01:04

 

 Model                         : WA2620-AGN

 Serial-ID                     : 210235A35V0088000005

 IP Address                    : 192.168.100.99

 

 H/W Version                   : Ver.A

 S/W Version                   : V100R001B96D001

 Boot-Rom Version              : 1.20

 Description                   : Not Configured

                                                                                 

 Connection Type               : Master

 Peer AC MAC Address           : -NA-

 Priority Level                : 4

 Echo Interval(s)              : 10

 Statistics report Interval(s) : 50

 

 Cir(Kbps)                     : -NA-

 Cbs(Bytes)                    : -NA-

 Jumboframe Threshold          : Disable

 

 Transmitted control packets   : 372

 Received control packets      : 372

 Transmitted data packets      : 104

 Received data packets         : 370

  

 Configuration Failure Count   : 0

 Last Failure Reason           :

 

 Last Reboot Reason            : Tunnel Initiated

  

 Latest IP Address             : 192.168.100.99

 Tunnel Down Reason            : Neighbor Dead Timer Expire

 Connection Count              : 3

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

 AP Mode                       : Split

 AP operation mode             : Normal

 Portal Service                : Disable

 Device Detection              : Disable

 Maximum Number of Radios      : 2

 Current Number of Radios      : 2

 Client Keep-alive Interval    : Disable

 Client Idle Interval(s)       : 3600

 Broadcast-probe Reply Status  : Enable

 Radio 1:

   Basic BSSID                 : 000f-e233-9000

   Current BSS Count           : 1

   Running Clients Count       : 0

   Wireless Mode               : 11an

   Client Dot11n-only          : Disabled

   Channel Band-width          : 20/40MHz

   Secondary Channel Offset    : SCA

   HT Protection Mode          : no protection

   Short GI for 20MHz          : Not supported

   Short GI for 40MHz          : Supported

   Mandatory MCS Set           :

   Support MCS Set             : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

   A-MSDU                      : Enabled

   A-MPDU                      : Enabled

   Configured Channel          : auto<149>

   Configured Power (dBm)      : 24

   Interference (%)            : -NA-

   Channel Load (%)            : -NA-

   Utilization (%)             : -NA-

   Co-channel Neighbor Count   : -NA-

   Channel Health              : -NA-

   Radio Policy                : 257

   Service Template            : 1

   SSID                      : office

   Port                      : WLAN-DBSS0:6

   Mesh Policy                 : default_mp_plcy

   ANI Support                 : Enable

   Admin State                 : UP

   Physical State              : UP

   Operational Rates (Mbps): 

     6                         : mandatory

     9                         : supported

     12                        : mandatory

     18                        : supported

     24                        : mandatory

     36                        : supported

     48                        : supported

     54                        : supported

   Radar detected Channels     : None

   Antenna Type                : TLB-5000-2HW 2dBi Omni Antenna

   Resource Using Ratio (%)    : 0

   Noise Floor (dBm)           : 0

 Radio 2:

   Basic BSSID                 : 000f-e233-9010

   Current BSS Count           : 1

   Running Clients Count       : 1

   Wireless Mode               : 11gn

   Client Dot11n-only          : Disabled

   Channel Band-width          : 20MHz

   Secondary Channel Offset    : SCN

   HT Protection Mode          : no protection

   Short GI for 20MHz          : Not supported

   Short GI for 40MHz          : Not supported

   Mandatory MCS Set           : 

   Support MCS Set             : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

   A-MSDU                      : Enabled

   A-MPDU                      : Enabled

   Configured Channel          : auto<11>

   Configured Power (dBm)      : 19

   Interference (%)            : -NA-

   Channel Load (%)            : -NA-

   Utilization (%)             : -NA-

   Co-channel Neighbor Count   : -NA-

   Channel Health              : -NA-

   Preamble Type               : short

   Radio Policy                : 258

   Service Template            : 1

     SSID                      : office

     Port                      : WLAN-DBSS0:7

   Mesh Policy                 : default_mp_plcy

   ANI Support                 : Enable

   11g Protection              : Disable

   Admin State                 : UP

   Physical State              : UP

   Operational Rates (Mbps):

     1                         : mandatory

     2                         : mandatory

     5.5                       : mandatory

     6                         : supported

     9                         : supported

     11                        : mandatory

     12                        : supported

     18                        : supported

     24                        : supported

     36                        : supported

     48                        : supported

     54                        : supported

   Radar detected Channels     : None

   Antenna Type                : TLB-2400-2HW 2dBi Omni Antenna

   Resource Using Ratio (%)    : 0

   Noise Floor (dBm)           : 0

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

Table 14 Command output

Field

Description

AP System Name

Access point name

Map Configuration

Configuration file mapped to the AP

State

Current state of the AP:

·     ImageDownloadThe AP is downloading the version. If the ImageDownload state persists, check the following: 1) The version of the fit AP saved on the AC matches with the version that the AC requires; 2) The space of the flash is enough.

·     IdleThe AP is idle. If the Idle state persists, check the following: 1) If the fields of Latest IP Address and Tunnel Down Reason are displayed as -NA-, it indicates that the AP has never connected to the AC successfully. You must check the network cable, power supply of the fit AP, and the AP serial number if the serial number was manually input. 2) If the fields of Latest IP Address and Tunnel Down Reason are displayed as other contents, it indicates that the AP has connected to the AC successfully. See the output of the Tunnel Down Reason field for the detailed reason.

·     RunThe AP is operating. It indicates that the AP has connected to the AC successfully.

·     ConfigThe AC is delivering configuration file to the fit AP, and the fit AP is collecting radio information through the radio interface and reporting to the AC. This state is an instantaneous state.

Up Time

Time duration for which the AP has been connected to the AC. NA indicates no AP is connected to the AC.

Model

AP Model name

Serial-ID

Serial ID of the AP

IP Address

IP address of the AP

H/W Version

Hardware version of the AP

S/W Version

Software version of the AP

Boot-Rom version

Boot ROM version of the AP.

Description

Description of the AP

Connection Type

AP connection type: "Master" or "Backup"

Peer AC MAC Address

Peer AC MAC address when dual-AC mode is adopted

Priority Level

AP connection priority

Echo Interval

Interval for sending echo requests in seconds

Statistics report Interval

Interval for sending statistics information messages

Configuration Failure Count

Count of configuration request message failures

Last Failure Reason

Last configuration request failure reason

Last Reboot Reason

Last reboot reason of the AP:

·     NormalThe AP was powered off.

·     CrashThe AP crashed, and the information is needed for analysis.

·     Tunnel InitiatedThe reset wlan ap command is executed on the AC (the Tunnel Down Reason is displayed as Reset AP).

·     Tunnel Link FailureThe fit AP rebooted abnormally because an error occurred when the AP was establishing a connection with the AC.

Latest IP Address

IP address of the last AP

Tunnel Down Reason

The CAPWAP tunnel between the AC and the AP is down when one of the following occurs:

·     Neighbor Dead Timer ExpireThe AC does not receive an Echo request from the AP within three times the handshake interval.

·     Response Timer ExpireThe AC sends a control packet to the AP but does not receive any response within the specified waiting time.

·     Reset APThe AP is rebooted by the execution of a command on the AC.

·     AP Config ChangeThe corresponding configurations are modified on the AC.

·     No ReasonOther reasons.

Connection Count

Connection count between the AP and AC. This field is reset in one of the following situations:

·     The AC is rebooted.

·     You re-configure an AP template after deleting the old one.

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

AP Mode

Mode supported by the AP. Currently only the split MAC mode is supported.

AP operation mode

Operation mode of AP. Currently Normal and Monitor modes are supported.

Device Detection

Whether device detection is enabled or not.

Maximum Number of Radios

Maximum number of radios supported by the AP.

Current Number of Radios

Number of radios in use on the AP.

Client Keep-alive Interval

Interval to detect clients segregated from the system due to various reasons such as power failure or crash, and disconnect them from the AP

Client Idle Interval(s)

If the client is idle for more than the specified interval, or, if the AP does not receive any data from the client within the specified interval, the client is removed from the network.

Broadcast-probe Reply Status

Whether the AP is enabled to respond to broadcast probe requests or not.

Basic BSSID

MAC address of the radio

Current BSS Count

Number of BSSs present in the radio

Running Clients Count

Number of running clients. If wireless mode is 11g, it displays the count of 11b stations and count of 11g stations

Wireless Mode

Wireless mode such as 802.11a, 802.11b, 802.11g, 802.11gn, 802.11an

Client Dot11n-only

·     EnabledOnly 802.11n clients can be associated with the AP.

·     Disabled802.11a/b/g/n clients can be associated with the AP.

Secondary channel offset

Secondary channel information for 802.11n radio mode:

·     SCA (Second Channel Above)The AP operates in 40 MHz bandwidth mode, and the secondary channel is above the primary channel.

·     SCB (Second Channel Below)The AP operates in 40 MHz bandwidth mode, and the secondary channel is above the primary channel.

·     SCNThe AP operates in 20 MHz bandwidth mode.

HT protection mode

802.11n protection modes:

·     no protection mode(0)The clients associated with the AP, and the wireless devices within the coverage of the AP operate in 802.11n mode, and all the clients associated with the AP operate in either 40 MHz or 20 MHz mode.

·     Non-member mode(1)The clients associated with the AP operate in 802.11n mode, but non-802.11n wireless devices exist within the coverage of the AP,

·     20 MHz mode(2)The radio mode of the AP is 40 MHz. The clients associated with the AP and the wireless devices within the coverage of the AP operate in 802.11n mode, and at least one 802.11n client operating in 20 MHz mode is associated with the radio of the AP.

·     Non-HT mix mode(3)All situations except the above three.

Short GI for 20MHz

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

Short GI for 40MHz

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

Mandatory MCS Set

Mandatory MCS set for the AP

Supported MCS Set

Supported MCS set for the AP

Configured Channel

Operating channel:

·     If the channel is manually configured, the configured channel number is displayed.

·     If the channel is automatically selected, auto(channel) is displayed, where channel is the optimal channel automatically selected by the AC.

Configured Power (dBm)

Transmission power on the radio.

Interference

Interference observed on the operating channel in percentage

Channel Load

Load observed on the operating channel in percentage

Utilization

Utilization rate of the operating channel in percentage

Co-channel Neighbor Count

Number of neighbors found on the operating channel

Channel Health

Health of the channel  such as good or bad based on the configured thresholds

Preamble Type

Type of preamble the AP can support such as short or long

Radio-Policy

Radio policy

SSID

SSID with which the client associates

Port

WLAN-DBSS interface associated with the service template

Admin State

Administrative state of the radio

Physical State

Physical state of the radio

Radar detected Channels

Channels on which radar signals are detected

 

display wlan ap address

Syntax

display wlan ap { all | name ap-name } address [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all: Displays the address information of all APs.

name ap-name: Displays the address information of the AP. An AP name is a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.

address: Displays the address information of the specified AP.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

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

Examples

# Display the address information for all APs.

<Sysname> display wlan ap all address

 Total Number of APs configured           : 3

 Total Number of configured APs connected : 3

 Total Number of auto APs connected       : 0

                                  AP Address

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

 AP Name                          IP Address                     MAC Address

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

 ap1                              1.1.1.5                    ... 000b-6b8f-fc6a

 ap2                              2001::1                    ... 000f-e000-0052

 ap3                              2.2.2.2                    ... 000f-e200-0000

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

Table 15 Command output

Field

Description

Total Number of APs configured

All APs configured through the AP template

Total Number of configured APs connected

All online APs that are configured on the AC

Total Number of auto APs connected

All online APs that are automatically connected to the AC

IP Address

IP address of the AP. If the AP is not online, the field displays -NA-.

MAC Address

MAC address of the AP. If the AP is not online, the field displays -NA-.

 

display wlan ap radio

Syntax

display wlan ap { all | name ap-name } radio [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all: Displays the radio information of all APs.

name ap-name: Displays the radio information of the specified AP. An AP name is a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.

radio: Displays the radio information of the AP.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

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

Examples

# Display the radio information for all APs.

Sysname> display wlan ap all radio

 Total Number of APs configured           : 3

 Total Number of configured APs connected : 3

 Total Number of auto APs connected       : 0

                                  AP Radio

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

 AP Name                          Radio ID        Channel        Tx Power (dBm)

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

 ap1                              2               1              20

 ap2                              2               6              19

 ap3                              2               11             20

Table 16 Command output

Field

Description

Total Number of APs configured

All APs configured through the AP template

Total Number of configured APs connected

All online APs that are configured on the AC

Total Number of auto APs connected

All online APs that are automatically connected to the AC

AP Name

AP name

Radio ID

ID of the radio associated with the client

Channel

Working channel of the radio

Tx Power (dBm)

Maximum transmission rate of the radio

 

display wlan ap reboot-log

Syntax

display wlan ap reboot-log name ap-name [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

name ap-name: Displays the reboot log information of the AP. An AP name is a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display wlan ap reboot-log to display the reboot log information of the AP. This command is useful to see crash details if any crash occurred on the AP. The AP specified in the command must be in the running state.

Examples

# Display the reboot log information of an AP named ap1.

<Sysname> display wlan ap reboot-log name ap1

.Debug information is not available on AC

 Do you wish to start debug data downloading from AP [Y/N]:y

 Downloading debug data. Please wait...

 Please enter the same command again to view details

<Sysname> display wlan ap reboot-log name ap1

display wlan ap-model

Syntax

display wlan ap-model { all | name ap-name } [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

2: System level

Parameters

all: Displays all model information.

name ap-name: Displays the model information of the AP. An AP name is a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display wlan ap-model to display the model information of a specified AP or all the APs.

The display wlan ap-model all command can be used to view all the AP model information in the order of AP model alias.

Examples

# Display information about model WA2100.

<Sysname> display wlan ap-model name WA2100

         AP Model : WA2100

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

 Alias       : WA2100

 Vendor Name : H3C

 Vendor ID   : -NA-

 Radio Count : 1

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

 Radio1 :

  Mode         : 802.11a/b/g

  Default Mode : 802.11g

  BSS Count    : 16

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

 Version Support List :

  Hardware Version Ver.A :

   Software Version : V100R001B96D001

   Image Name       : WA2100.bin

 

  Hardware Version Ver.B :

   Software Version : V100R001B96D001

   Image Name       : WA2100.bin

 

  Hardware Version Ver.C :

   Software Version : V100R001B96D001

   Image Name       : WA2100.bin

 

  Hardware Version Ver.D :

   Software Version : V100R001B96D001

   Image Name       : WA2100.bin

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

Table 17 Command output

Field

Description

Alias

Alias of the AP model

Vendor Name

Vendor name of the AP model

Vendor ID

Vendor ID of the AP model

Radio Count

Total number of radios for the AP model

Mode

Supported radio modes such as 802.11a and 802.11b.

Default Mode

Default radio mode

BSS Count

Maximum number of BSSs supported

Hardware Version

Hardware Version of the AP model

Boot Version

Boot Version of the AP model

Software Version

Software Version of the AP model

Image Name

AP image file name which is a complete file name.

 

dns domain

Syntax

dns domain domain-name

undo dns domain

View

AP provision view

Default Level

2: System level

Parameters

domain-name: Specifies a domain name for the DNS server. It is a case-insensitive string of 1 to 238 characters separated by dots and can contain letters, digits, hyphens, and underlines.

Description

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

Use undo dns domain to remove the configuration.

By default, no domain name is specified for the AP.

You can specify at most one domain name for the AP.

The wlan ap-provision dns domain command takes effect on all APs, and the dns domain command in AP provision view takes effect on the specified AP. If you configure both commands, the configuration in AP provision view applies to the specified AP.

Related commands: wlan ap-provision dns domain.

Examples

# Specify the domain name for AP 1 as com.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2100

[Sysname-wlan-ap-ap1] provision

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

dns server

Syntax

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

undo dns server { ip | ipv6 }

View

AP provision view

Default Level

2: System level

Parameters

ip ip-address: Specifies the IPv4 address of the DNS server.

ipv6 ip-address: Specifies the IPv6 address of the DNS server.

Description

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

Use undo dns server to remove the DNS server for the AP.

By default, no DNS server is specified for the AP.

You can specify at most one IPv4 DNS server and one IPv6 DNS server.

The wlan ap-provision dns server command takes effect on all APs, and the dns server command in AP provision view takes effect on the specified AP. If you configure both commands, the configuration in AP provision view applies to the specified AP.

Related commands: wlan ap-provision dns server.

Examples

# Specify the IPv4 address of the DNS server as 192.168.100.123.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2100

[Sysname-wlan-ap-ap1] provision

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

echo-interval

Syntax

echo-interval interval

undo echo-interval

View

AP template view

Default level

2: System level

Parameters

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

Description

Use echo-interval to set the interval for sending echo requests.

Use undo echo-interval to restore the default.

There is a keep-live mechanism between AP and AC, which is used to confirm whether the control channel is working or not. To keep the control channel alive, an AP periodically sends echo requests to an AC. The AC responds to echo requests by sending echo responses.

By default, the echo interval is 10 seconds.

Examples

# Set an echo interval of 15 seconds for AP3.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA2100

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

gateway

Syntax

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

undo gateway { ip | ipv6 | all }

View

AP configuration view

Default level

2: System level

Parameters

ip ip-address: Specifies the IPv4 address of the gateway.

ipv6 ipv6-address: Specifies the IPv6 address of the gateway.

all: Removes all IP addresses of gateways.

Description

Use gateway to specify a gateway for the AP.

Use undo gateway to remove gateway configuration.

By default, no gateway is specified for the AP.

You can specify an IPv4 gateway and an IPv6 gateway for the AP at most.

Examples

# Specify the gateway 192.168.100.1 for AP 1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2100

[Sysname-wlan-ap-ap1] provision

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

hybrid-remote-ap enable

Syntax

hybrid-remote-ap enable

undo hybrid-remote-ap enable

View

AP template view

Default level

3: Management level

Parameters

None

Description

Use hybrid-remote-ap enable to enable hybrid mode for the AP. When the connection between an AP in hybrid mode and the AC is terminated, the AP automatically enables local forwarding mode (disregarding whether local forwarding is configured on the AC) to forward packets for associated clients, but it does not accept new association requests from clients. When the AP re-establishes a CAPWAP connection with the AC, the AP automatically switches back to centralized forwarding mode, and logs out all clients associated with it.

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

By default, hybrid mode is disabled.

 

 

NOTE:

·     Before you enable hybrid mode for an AP, H3C recommends that you disable online user handshake function if 802.1X authentication is used.

·     Do not use the remote AP function together with the WLAN mesh function.

 

Examples

# Enable hybrid mode for AP 1.

<Sysname> system-view

[Sysname] wlan ap ap1 model wa2100

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

ip address

Syntax

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

undo ip address

View

AP configuration view

Default level

2: System level

Parameters

ip-address: IP address of the management VLAN interface of the AP, in dotted decimal notation.

mask: Subnet mask in dotted decimal notation.

mask-length: Subnet mask length, the number of consecutive ones in the mask. It is in the range of 0 to 32.

Description

Use ip address to configure the IP address of the management VLAN interface of the AP.

Use undo ip address to remove the IP address of the management VLAN interface of the AP.

By default, no IP address is specified for the management VLAN interface of an AP.

The management VLAN of the AP must be VLAN 1.

Examples

# Configure the IP address of the management VLAN interface of AP 1 as 192.168.100.100/24.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2100

[Sysname-wlan-ap-ap1] provision

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

ipv6 address

Syntax

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

undo ipv6 address

View

AP configuration view

Default level

2: System level

Parameters

ipv6-address: IPv6 address of the management VLAN interface of the AP.

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

Description

Use ipv6 address to configure the IPv6 address of the management VLAN interface of the AP.

Use undo ipv6 address to remove the IPv6 address of the management VLAN interface of the AP.

By default, no IPv6 address is specified for the management VLAN interface of the AP.

The management VLAN of the AP must be VLAN 1.

Examples

# Configure the IPv6 address of the management VLAN interface of AP 1 as 2001::1/64.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2100

[Sysname-wlan-ap-ap1] provision

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

jumboframe enable

Syntax

jumboframe enable value

undo jumboframe enable

View

AP template view

Default level

2: System level

Parameters

value: Maximum size of jumbo frames, in the range of 1500 to 1748 bytes.

Description

Use jumboframe enable to set the maximum size of jumbo frames.

Use undo jumboframe enable to restore the default.

By default, the jumbo frame support is disabled.

Examples

# Set the maximum jumbo frame size to 1500 bytes.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2100

[Sysname-ap-ap1] jumboframe enable 1500

map-configuration

Syntax

map-configuration filename

undo map-configuration

View

AP template view

Parameters

filename: Name of the build run configuration file in the flash. Using command "dir" in user view, you can know the list of files in the flash. A file name consists of 1 to 32 characters.

Description

Use map-configuration to map a configuration file to the AP.

Use undo map-configuration to remove the mapping.

By default, no file is mapped to the AP.

 

 

NOTE:

The commands in the configuration file specified with the map-configuration command must be in their complete form.

 

Examples

# Map file filename1 to the AP.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2100

[Sysname-wlan-ap-ap1] map-configuration filename1.txt

memory-usage threshold

Syntax

memory-usage threshold integer

View

AP template view

Default level

3: Manage level

Parameters

integer: An integer in the range of 0 to 100.

Description

Use memory-usage threshold to set the memory usage threshold of the AP. If the memory usage of the AP exceeds the threshold, the AP generates an alarm.

By default, the default memory usage threshold of the AP is 90.

Examples

# Set the memory usage threshold of AP 3 to 30.

[Sysname] wlan ap ap3 model WA2100

[Sysname-wlan-ap-ap3]memory-usage threshold 30

priority level

Syntax

priority level priority

undo priority level

View

AP template view

Parameters

priority: AP connection priority, in the range of 0 to 7. The higher the value, the higher the priority.

Description

Use priority level to configure the connection priority for the AP.

Use undo priority level to restore the default.

If the connection priority is 7, the AC is considered as the primary AC for the AP.

By default, the connection priority of an AP is 4.

Examples

# Configure the connection priority for ap3.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA2100

[Sysname-wlan-ap-ap3] priority level 1

provision

Syntax

provision

undo provision

View

AP template view

Default level

2: System level

Parameters

None

Description

Use provision to create and enter AP configuration view.

Use undo provision to remove the AP configuration view and all configurations in the view.

By default, no AP configuration view is created.

After you create the AP configuration view, the device automatically adds the vlan untagged 1 command.

Examples

# Create and enter the configuration view for AP 1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2100

[Sysname-wlan-ap-ap1] provision

[Sysname-wlan-ap-ap1-prvs]

reset wlan ap

Syntax

reset wlan ap { all | name ap-name }

View

User view

Default level

1: Monitor level

Parameters

all: Resets all the APs connected to the current AC.

name ap-name: Resets the specified AP. An AP name is a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.

Description

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

Examples

# Reset an AP named ap1.

<Sysname> reset wlan ap name ap1

reset wlan ap provision

Syntax

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

View

Any view

Default level

2: System level

Parameters

all: Specifies all APs.

name ap-name: Specifies an AP by its name, a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.

Description

Use reset wlan ap provision to remove the wlan_ap_cfg.wcfg file of the specified AP or all APs.

This command takes effect only on APs in the Run state.

Examples

# AP 1 has been connected to the AC. Remove the wlan_ap_cfg.wcfg file of AP 1.

<Sysname> reset wlan ap provision name ap1

reset wlan ap reboot-log

Syntax

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

View

User view

Default level

1: Monitor level

Parameters

all: Clears the reboot log information for all APs.

name ap-name: Clears the reboot log information for the AP. An AP name is a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.

Description

Use reset wlan ap reboot-log to clear the AP reboot log information of all APs or a specific AP.

Examples

# Clear the AP reboot log information of an AP named ap1.

<Sysname> reset wlan ap reboot-log name ap1

save wlan ap provision

Syntax

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

View

Any view

Default level

2: System level

Parameters

all: Specifies all APs.

name ap-name: Specifies an AP by its name, a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.

Description

Use save wlan ap provision to save the configuration in AP configuration view to the wlan_ap_cfg.wcfg file of the specified AP or all APs.

·     This command takes effect only on APs in the Run state. It does not take effect on APs that establish a CAPWAP connection with the AC after you execute the save wlan ap-provision command.

·     After you execute the save wlan ap-provision command, you must restart the specified AP to validate the configuration.

·     After restart, the AP executes the configuration file, the wlan_ap_cfg.wcfg file, and the configuration file specified by the map-configuration command in turn. Make sure the wlan_ap_cfg.wcfg file and the configuration file specified by the map-configuration command are correct because wrong configurations may make the three configuration files overwrite or conflict with one another.

 

CAUTION

CAUTION:

After you execute the save wlan ap provision command on the AC, the configuration is saved to the wlan_ap_cfg.wcfg file of the specified AP. When the wlan_ap_cfg.wcfg file takes effect, the AP can only be managed by the AC specified by the ac or wlan ap-provision ac command. Make sure the correct AC is specified' otherwise, the AP cannot be managed by the specified AC, and you have to log in to the AP to modify its configuration.

 

Related commands: map-configuration, reset wlan ap provision, and reset wlan ap.

Examples

# AP 1 has established a CAPWAP connection with the AC. Save the configuration in AP configuration view to the wlan_ap_cfg.wcfg file of AP 1.

<Sysname> save wlan ap provision name ap1

serial-id

Syntax

serial-id { text | auto }

undo serial-id

View

AP template view

Default level

2: System level

Parameters

text: Serial ID of an AP. It is a case-sensitive string of 1 to 32 characters that can contain special characters except question marks. All input letters are changed to uppercase letters by the system.

auto: Enables auto serial ID configuration for a generic auto AP template.

Description

Use serial-id to set a serial ID for an AP. The serial ID is the unique identity of the AP. If the AP has connected to the AC, changing or deleting its serial ID will render the AP tunnel down. The AP needs to discover the AC to connect again.

Use undo serial-id to restore the default.

By default, no serial ID is configured for an AP.

Examples

# Set the serial ID as 210235A29G007C000020 for AP 1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2100

[Sysname-wlan-ap-ap1] serial-id 210235A29G007C000020

tunnel encryption ipsec pre-shared-key

Syntax

tunnel encryption ipsec pre-shared-key { cipher | simple } key

undo tunnel encryption ipsec pre-shared-key

View

AP configuration view

Default level

2: System level

Parameters

cipher: Specifies a ciphertext key.

simple: Specifies a plaintext key.

key: Encryption key. It is a case-sensitive string of 1 to 128 characters for a plaintext key, or a case-sensitive string of 1 to 201 characters for a ciphertext key.

Description

Use tunnel encryption ipsec pre-shared-key to configure the AP to use IPsec to encrypt the control tunnel.

Use undo tunnel encryption ipsec pre-shared-key to remove the configuration.

By default, the AP does not encrypt the control tunnel.

This command only enables the AP to encrypt the control tunnel. To enable the AP to encrypt the data tunnel, use the data-tunnel encryption enable command. The undo tunnel encryption ipsec pre-shared-key command removes the configuration for both data tunnel encryption and control tunnel encryption.

Related commands: data-tunnel encryption enable.

Examples

# Configure the AP to use plaintext key 12345 to encrypt the control tunnel.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2620-AGN

[Sysname-wlan-ap-ap1] provision

[Sysname-wlan-ap-ap1-prvs] tunnel encryption ipsec pre-shared-key simple 12345

vlan pvid

Syntax

vlan pvid vlan-id

undo vlan pvid

View

AP configuration view

Default level

2: System level

Parameters

vlan-id: Default VLAN ID of the Ethernet interface on the AP. It is in the range of 1 to 4094.

Description

Use vlan pvid to configure the default VLAN ID of the Ethernet interface on the AP.

Use undo vlan pvid to restore the default.

By default, the default VLAN ID of the Ethernet interface on an AP is 1.

Examples

# Configure the default VLAN ID of the Ethernet interface on AP 1 as 5.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2100

[Sysname-wlan-ap-ap1] provision

[Sysname-wlan-ap-ap1-prvs] vlan pvid 5

vlan tagged

Syntax

vlan tagged vlan-id-list

undo vlan tagged vlan-id-list

View

AP configuration view

Default level

2: System level

Parameters

vlan-id-list: Specifies a list of VLANs whose packets are sent tagged on the Ethernet interface of the AP. It is in the format of vlan-id-list = { vlan-id1 [ to vlan-id2 ] }& <1-10>, where vlan-id is in the range of 1 to 4094 and &<1-10> indicates that you can specify up to 10 VLAN IDs.

Description

Use vlan tagged to configure a list of VLANs whose packets are sent tagged on the Ethernet interface of the AP.

Use undo vlan tagged to remove the configuration.

By default, no packets are sent tagged on the Ethernet interface on the AP.

Examples

# Configure packets in VLAN 6 are sent tagged on the Ethernet interface on AP 1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2100

[Sysname-wlan-ap-ap1] provision

[Sysname-wlan-ap-ap1-prvs] vlan tagged 6

vlan untagged

Syntax

vlan untagged vlan-id-list

undo vlan untagged vlan-id-list

View

AP configuration view

Default level

2: System level

Parameters

vlan-id-list: Specifies a list of VLANs whose packets are sent untagged on the Ethernet interface of the AP. It is in the format of vlan-id-list = { vlan-id1 [ to vlan-id2 ] }& <1-10>, where vlan-id is in the range of 1 to 4094 and &<1-10> indicates that you can specify up to 10 VLAN IDs.

Description

Use vlan untagged to configure a list of VLANs whose packets are sent untagged on the Ethernet interface of the specified AP.

Use undo vlan tagged to remove the configuration.

By default, no packets are sent untagged on the Ethernet interface on the AP.

Examples

# Configure packets in VLAN 7 are sent untagged on the Ethernet interface of AP 1.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2100

[Sysname-wlan-ap-ap1] provision

[Sysname-wlan-ap-ap1-prvs] vlan untagged 7

wlan ap

Syntax

wlan ap ap-name model model-name [ id ap-id ]

undo wlan ap ap-name

View

System view

Default level

2: System level

Parameters

ap-name: Name of the AP, a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.

model model-name: Specifies the model number of the AP.

id ap-id: ID of the AP, which ranges from 1 to the maximum number of APs supported. If this parameter is not configured, the AC automatically assigns an ID to the AP.

Description

Use wlan ap to create a new AP template and enter AP template view. If the AP template exists, using the command enters its view.

Use undo wlan ap to remove a specific AP template. If the AP is connected to the AC, the undo wlan ap command will disconnect the AP from the AC.

Examples

# Create an AP template named ap1 and its model is WA2100.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2100

wlan apdb

Syntax

wlan apdb model-name hardware-version software-version

undo wlan apdb model-name hardware-version

View

System view

Default level

2: System level

Parameters

model-name: AP model name.

hardware-version: Fit AP hardware version name.

software-version: Fit AP software version name.

Description

Use wlan apdb to designate the software version of a given AP model with a given hardware version.

Use undo wlan apdb to restore the default.

By default, the software versions of a fit AP and AC must be consistent.

Examples

# Designate the software version of a given AP model with a given hardware version.

<Sysname> system-view

[Sysname] wlan apdb wa2100 Ver.C V100R001B96D001

wlan ap-execute

Syntax

wlan ap-execute ap-name conversion-to-fatap

View

System view

Default level

3: Manage level

Parameters

ap-name: Name of the AP, which is a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.

conversion-to-fatap: Changes the fit AP to a fat AP.

Description

Use wlan ap-execute to convert a fit AP to a fat AP.

 

CAUTION

CAUTION:

Download the fat AP's software to the AC before configuring the command. Otherwise, the AC cannot change the fit AP to a fat AP.

 

Examples

#.Convert AP ap1_003 to a fat AP.

<Sysname> system-view

[Sysname] wlan ap-execute ap1_003 conversion-to-fatap

wlan ap-provision ac

Syntax

wlan ap-provision ac { host-name host-name | ip ip-address | ipv6 ipv6-address }

undo wlan ap-provision ac { host-name | ip { ip-address | all } | ipv6 { ipv6-address | all } }

View

System view

Default level

2: System level

Parameters

host-name host-name: Specifies the host name of a global AC. It is a case-insensitive string of 1 to 255 characters that can contain letters, digits, "-", "_" or ".", and must contain at least one letter.

ip ip-address: Specifies the IPv4 address of a global AC.

ipv6 ipv6-address: Specifies the IPv6 address of a global AC.

all: Removes the IPv4/IPv6 addresses of all global ACs.

Description

Use wlan ap-provision ac to specify a global AC so that all APs can discover the AC.

Use undo wlan ap-provision ac to remove the configuration.

By default, no global AC is specified.

The wlan ap-provision ac command takes effect on all APs, and the ac command in AP configuration view takes effect on the specified AP. If you configure both commands, the configuration in AP configuration view is preferred by the specified AP.

You can specify at most three ACs' IP addresses, three ACs' IPv6 addresses, and an AC's host name for all APs.

Related commands: ac.

Examples

# Specify the global AC 192.168.100.11 so that all APs can discover the AC.

<Sysname> system-view

[Sysname] wlan ap-provision ac ip 192.168.100.11

wlan ap-provision dns domain

Syntax

wlan ap-provision dns domain domain-name

undo wlan ap-provision dns domain

View

System view

Default Level

2: System level

Parameters

domain-name: Specifies a domain name. It is a case-insensitive string of 1 to 238 characters separated by dots. It can contain letters, digits, hyphens, and underlines.

Description

Use wlan ap-provision dns domain to specify a global domain name.

Use undo wlan ap-provision dns domain to remove the configuration.

By default, no global domain name is specified.

You can specify at most one global domain name.

The wlan ap-provision dns domain command takes effect on all APs, and the dns domain command in AP provision view takes effect on the specified AP. If you configure both commands, the configuration in AP provision view applies to the specified AP.

Related commands: dns domain.

Examples

# Specify the global domain name as com.

<Sysname> system-view

[Sysname] wlan ap-provision dns domain com

wlan ap-provision dns server

Syntax

wlan ap-provision dns server { ip ip-address | ipv6 ipv6-address }

undo wlan ap-provision dns server { ip | ipv6 }

View

System view

Default Level

2: System level

Parameters

ip ip-address: Specifies the IPv4 address of a global DNS server.

ipv6 ip-address: Specifies the IPv6 address of a global DNS server.

Description

Use wlan ap-provision dns server to specify a global DNS server.

Use undo wlan ap-provision dns server to remove the configuration.

By default, no global DNS server is specified.

You can specify at most one global IPv4 DNS server and one global IPv6 DNS server.

The wlan ap-provision dns server command takes effect on all APs, and the dns server command in AP provision view takes effect on the specified AP. If you configure both commands, the configuration in AP provision view applies to the specified AP.

Related commands: dns server.

Examples

# Specify the IPv4 address of the global DNS server as 192.168.100.124.

<Sysname> system-view

[Sysname] wlan ap-provision dns server ip 192.168.100.124

wlan auto-ap enable

Syntax

wlan auto-ap enable

undo wlan auto-ap enable

View

System view

Default level

2: System level

Parameters

None

Description

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

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

By default, the auto AP function is disabled.

The auto AP feature allows an AP to automatically connect to an AC. When you deploy a wireless network with many APs, the auto AP function avoids configuration of many AP serial IDs, simplifying configuration.

Related commands: serial-id and wlan auto-ap persistent.

Examples

# Enable the auto AP function

<Sysname> system-view

[Sysname] wlan auto-ap enable

wlan auto-ap persistent

Syntax

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

View

System view

Default level

2: System level

Parameters

all: All connected auto APs.

name auto-ap-name: Name of a connected auto AP.

new-ap-name: New name of the AP. It is a case-insensitive string of 1 to 32 characters that can contain letters, digits, underlines, square brackets, slashes, and hyphens, but not spaces.

Description

Use wlan auto-ap persistent name auto-ap-name new-ap-name to convert a specified auto AP to a configured AP with a specified new name.

Use wlan auto-ap persistent name auto-ap-name to convert a specified auto AP to a configured AP with the existing auto AP name.

Use wlan auto-ap persistent all to convert all connected auto APs to configured APs with existing auto AP names.

Examples

# Convert a connected auto AP to a configured AP with a new name.

<Sysname> system-view

[Sysname] wlan auto-ap persistent name auto_apm1_001 ap2

# Convert a connected auto AP to a configured AP that uses the existing auto AP name.

<Sysname> system-view

[Sysname] wlan auto-ap persistent name auto_apm1_001

# Convert all connected auto APs to configured APs that use existing auto AP names.

<Sysname> system-view

[Sysname] wlan auto-ap persistent all

wlan backup-ac

Syntax

wlan backup-ac { ip ipv4-address | ipv6 ipv6-address }

undo wlan backup-ac { ip | ipv6 }

View

System view

Parameters

ip ipv4-address: Specifies the IPv4 address of the backup AC.

ipv6 ipv6-address: Specifies the IPv6 address of the backup AC.

Description

Use wlan backup-ac to specify the backup AC.

Use undo wlan backup-ac to remove the configuration.

By default, no backup AC address exists.

Examples

# Configure a backup AC.

<Sysname> system-view

[Sysname] wlan backup-ac ip 192.168.1.1

wlan lwapp discovery-policy

Syntax

wlan lwapp discovery-policy unicast

undo wlan lwapp discovery-policy

View

System view

Default level

2: System level

Parameters

unicast: Configures the AC to accept only unicast discovery requests from an AP.

Description

Use wlan lwapp discovery-policy to set the discovery policy type used in the discovery process. If you configure the discovery policy as unicast, broadcast discovery packets are discarded.

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

By default, the LWAPP discovery policy is broadcast.

Examples

# Set the LWAPP discovery policy type as unicast.

<Sysname> system-view

[Sysname] wlan lwapp discovery-policy unicast

User isolation commands

display user-isolation statistics

Syntax

display user-isolation statistics [ vlan vlan-id ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

vlan-id: Displays the user isolation statistics of the specified VLAN. The VLAN ID is in the range of 1 to 4094.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display user-isolation statistics to display the user isolation statistics of the specified VLAN or all VLANs. If no VLAN is specified, the user isolation statistics of all VLANs are displayed.

Examples

# Display the user isolation statistics of VLAN 3.

<Sysname> display user-isolation statistics vlan 3

                  User-Isolation Table

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

  VLAN      Status       Drops           Permit-MAC

  4         Enabled      0

  6         Disabled     0               0023-89a2-3d4d

 ---- Number of enabled/disabled VLANs: 1/1  ----      

Table 18 Command output

Field

Description

VLAN

ID of the VLAN where user isolation is enabled

Status

Enabled or disabled

Drops

Number of dropped packets in the VLAN

Permit-MAC

Permitted MAC address list of the VLAN

 

reset user-isolation statistics

Syntax

reset user-isolation statistics [ vlan vlan-id ]

View

User View

Default level

1: Monitor level

Parameters

vlan vlan-id: ID of a VLAN, in the range of 1 to 4094.

Description

Use reset user-isolation statistics to clear the user isolation statistics of the specified VLAN or all VLANs. If no VLAN is specified, the user isolation statistics of all VLANs are cleared.

Examples

# Clear the user isolation statistics of VLAN 1.

<Sysname> reset user-isolation statistics vlan 1

user-isolation enable

Syntax

user-isolation enable

undo user-isolation enable

View

Service template view

Default Level

2: System level

Parameters

None

Description

Use user-isolation enable to enable SSID-based user isolation for the service template.

Use undo user-isolation enable to restore the default.

By default, SSID-based user isolation is disabled.

Examples

# Enable SSID-based user isolation for service template 1.

<Sysname> system-view

[Sysname] wlan service-template 1 clear

[Sysname-wlan-st-1] user-isolation enable

user-isolation permit broadcast

Syntax

user-isolation permit broadcast

undo user-isolation permit broadcast

View

System view

Default level

2: System level

Parameters

None

Description

Use user-isolation permit broadcast to permit broadcasts and multicasts from wired users to wireless users.

Use undo user-isolation permit broadcast to isolate broadcasts and multicasts from wired users to wireless users.

By default, broadcasts and multicasts from wired users to wireless users are permitted, and broadcasts and multicasts from wireless users to wireless users are isolated.

Examples

# Isolate broadcasts and multicasts from wired users to wireless users.

<Sysname> system-view

[Sysname] user-isolation permit broadcast

user-isolation vlan enable

Syntax

user-isolation vlan vlan-list enable

undo user-isolation vlan vlan-list enable

View

System view

Default level

2: System level

Parameters

vlan-list: VLAN list. This argument is expressed in the format of vlan-list = { vlan-id [ to vlan-id ] }&<1-10>, where vlan-id is in the range of 1 to 4094 and &<1-10> indicates that you can specify up to 10 VLAN IDs or VLAN ID ranges.

Description

Use user-isolation vlan enable to enable user isolation on the specified VLAN(s).

Use undo user-isolation vlan enable to disable user isolation on the specified VLAN(s).

By default, user isolation is disabled in a VLAN.

Examples

# Enable user isolation on VLAN 1.

<Sysname> system-view

[Sysname] user-isolation vlan 1 enable

user-isolation vlan permit-mac

Syntax

user-isolation vlan vlan-list permit-mac mac-list

undo user-isolation vlan vlan-list permit-mac { mac-list |all }

View

System view

Default level

2: System level

Parameters

vlan-list: Enables user isolation for the specified VLAN(s). This argument is expressed in the format of vlan-list = { vlan-id [ to vlan-id ] }&<1-10>, where vlan-id is in the range of 1 to 4094 and &<1-10> indicates that you can specify up to 10 VLAN IDs or VLAN ID ranges.

mac-list: List of permitted MAC addresses. You can configure up to 16 permitted MAC addresses. Broadcast MAC addresses or multicast MAC addresses cannot be included.

all: Deletes all the permitted MAC addresses of the specified VLAN(s).

Description

Use user-isolation vlan permit-mac to add permitted MAC addresses in the specified VLAN(s).

Use undo user-isolation vlan permit-mac to delete the specified or all permitted MAC addresses in the specified VLAN(s).

By default, no permitted MAC addresses are specified.

Examples

# Configure permitted MAC addresses 00bb-ccdd-eeff and 0022-3344-5566 in VLAN 1.

<Sysname> system-view

[Sysname] user-isolation vlan 1 permit-mac 00bb-ccdd-eeff 0022-3344-5566

AP group configuration commands

ap

Syntax

ap template-name-list

undo ap template-name-list

View

AP group view

Default level

2: System level

Parameters

template-name-list: A list of AP templates. Up to 10 AP templates can be included in the list. An AP template name is a case-insensitive string of 1 to 32 characters that can contain letters, digits, and underlines.

Description

Use ap to add specified APs into the AP group.

Use undo ap to delete specified APs from the AP group. If no AP is specified, the command removes all APs from the AP group.

By default, no AP is added into the AP group.

The command does not check whether the specified APs exist. Using the ap command repeatedly can add multiple APs in the AP group until the maximum number is reached. On a device, one AP can be included in multiple AP groups.

Examples

# Add AP 10 and AP 101 into AP group 10.

<System> system-view

[System] wlan ap-group 10

[System-ap-group10] ap ap10 ap101

description

Syntax

description string

undo description

View

AP group view

Default level

2: System level

Parameters

string: A string of 1 to 15 characters that can include letters [a-z,A-Z] and underscores.

Description

Use description to configure a description for the AP group.

Use undo description to delete the description for the AP group.

No description is configured for the AP group by default.

A newly configured description overwrites the previous description (if any).

Examples

# Configure a description of marketing for AP group 10.

<System> system-view

[System] wlan ap-group 10

[System-ap-group10] description marketing

display wlan ap-group

Syntax

display wlan ap-group [ group-id ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

group-id: ID of an AP group. The value range varies depending on the device model. For related information, see About the WX Series Access Controllers Command References.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display wlan ap-group to display AP group information. If no AP group is specified, the command displays information about all AP groups.

Examples

# Display information about AP group 10.

<Sysname> display wlan ap-group 10

                        AP Group Information

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

AP-Group  ID        :10

Description         :market

Access AP Lists     :ap1,                ap2,

                     ap3,                ap4,

                     ap5,                ap6

Table 19 Command output

Field

Description

AP-Group ID

AP group ID

Description

Description of the AP group

Access AP Lists

Permitted APs

 

wlan ap-group

Syntax

wlan ap-group group-id

undo wlan ap-group [ group-id ]

View

System view

Default level

2: System level

Parameters

group-id: ID of the AP group. The value range varies depending on the device model. For related information, see About the WX Series Access Controllers Command References.

Description

Use wlan ap-group to create an AP group and enter AP group view. If the specified AP group has been created, using the command enters AP group view only.

Use undo wlan ap-group to remove a specified AP group, or all AP groups if no AP group is specified.

Examples

# Create AP group 10.

<Sysname> system-view

[Sysname] wlan ap-group 10

[Sysname-ap-group10]

wlan permit-ap-group

Syntax

wlan permit-ap-group group-id

undo wlan permit-ap-group [ group-id ]

View

User profile view

Default level

2: System level

Parameters

group-id: ID of an AP group. The value range varies depending on the device model. For related information, see About the WX Series Access Controllers Command References.

Description

Use wlan permit-ap-group to apply a specified AP group in the user profile, which can have multiple AP groups applied.

Use undo wlan permit-ap-group to remove a specified AP group from the user profile or all AP groups from the user profile if no AP group is specified.

By default, no AP group is applied in the user profile.

Examples

# Apply AP group 10 in user profile management.

<Sysname> system-view

[Sysname] user-profile management

[Sysname-user-profile-management] wlan permit-ap-group 10

SSID-based access control configuration commands

wlan permit-ssid

Syntax

wlan permit-ssid ssid-name

undo wlan permit-ssid [ ssid-name ]

View

User profile view

Default level

2: System level

Parameters

ssid-name: Name of a permitted SSID, a case-sensitive string of 1 to 32 characters that can contain letters, digits, underscores, and spaces. The maximum number of permitted SSIDs in a user profile varies depending on the device model. For related information, see About the WX Series Access Controllers Command References.

Description

Use wlan permit-ssid to specify a permitted SSID for a user profile.

Use undo wlan permit-ssid to remove a permitted SSID or all permitted SSIDs.

By default, no permitted SSID is specified for a user profile, and a client can access any available SSID.

Examples

# Specify permitted SSID VIPguest for user profile management.

<System> system-view

[System] user-profile management

[System-user-profile-management] wlan permit-ssid VIPguest

Uplink detection commands

wlan uplink track

Syntax

wlan uplink track track-entry-number

undo wlan uplink track

View

System view

Default level

2: System level

Parameters

track track-entry-number: Number of the track entry to be detected, in the range of 1 to 1024.

Description

Use wlan uplink track to specify a track entry for uplink detection.

Use undo wlan uplink track to remove the configuration.

By default, no track entry is specified for uplink detection.

Examples

# Specify a track entry for uplink detection.

<Sysname> system

[Sysname] wlan uplink track 1

AC hot backup configuration commands

display hot-backup state

Syntax

display hot-backup state [ | { begin | exclude | include } regular-expression ]

View

System view

Default level

2: System level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display hot-backup state to display the AC hot backup state. Support for this command depends on your AC model. For related information, see About the WX Series Access Controllers Command References.

Examples

# Display the AC hot backup state.

<Sysname> system-view

[Sysname]display hot-backup state

********************************************************

Vlan ID                : 21

Domain ID           : 1

Link State            : Connect

Peer Board MAC : 000f-e212-ff02

Peer Board State : Normal

Table 20 Command output

Field

Description

Vlan ID

ID of the VLAN to which the ports are assigned

Domain ID

Domain to which the AC belongs

Link State

AC link state:

·     Close—Not connected.

·     Init—Being connection.

·     Connect—Connected.

Peer Board MAC

MAC address of the peer AC

Peer Board State

Status of the peer AC:

·     Normal

·     Abnormal

·     Unknown

 

hot-backup enable

Syntax

hot-backup enable [ domain domain-id ] *

undo hot-backup enable

View

System view

Default level

2: System level

Parameters

domain domain-id: Domain ID of the AC. It is in the range of 1 to 16 and defaults to 1.

Description

Use hot-backup enable to enable the AC hot backup function.

Use undo hot-backup enable to disable the AC hot backup function.

You can manually configure the domain to which the AC belongs.

By default, the AC hot backup function is disabled.

 

 

NOTE:

·     Executing the hot-backup command repeatedly on an AC enabled with hot backup does not take effect.

·     Executing the undo hot-backup command repeatedly on an AC disabled with hot backup does not take effect.

·     Support for the hot-backup command depends on the device model. For related information, see About the WX Series Access Controllers Command References.

 

Examples

# Enable the AC hot backup function.

<Sysname> system-view

[Sysname]hot-backup enable

hot-backup enable successfully.

hot-backup hellointerval

Syntax

hot-backup hellointerval hellointerval

View

System view

Default level

2: System level

Parameters

hellointerval: Sets the interval for sending heartbeat messages, in milliseconds. The default value is 2000 milliseconds. The value range depends on your AC model. For related information, see About the WX Series Access Controllers Command References.

Description

Use hot-backup hellointerval to set the interval for sending heartbeat messages. If the master AC or backup AC does not receive any heartbeat packets from the peer within three heartbeat intervals, it considers the peer device disconnected.

Support for this command depends on your AC model. For related information, see About the WX Series Access Controllers Command References.

Examples

# Set the heartbeat interval to 100 milliseconds.

<Sysname> system-view

[Sysname]hot-backup hellointerval 100

hot-backup vlan

Syntax

hot-backup vlan vlan-id

View

System view

Default level

2: System level

Parameters

vlan vlan-id: Sets the ID of the VLAN to which the port connected to another AC belongs. A vlan-id is in the range of 1 to 4094.

Description

Use hot-backup vlan to set the ID of the VLAN to which the port connected to another AC belongs. Support for this command depends on your AC model. For related information, see About the WX Series Access Controllers Command References.

By default, the port connected to the other AC belongs to VLAN 1.

Examples

# Set the ID of the VLAN to which the port connected to another AC belongs to 5.

<Sysname> system-view

[Sysname]hot-backup vlan 5

wlan backup-ac switch-delay

Syntax

wlan backup-ac switch-delay time

undo wlan backup-ac switch-delay

View

System view

Default level

2: System level

Parameters

time: Sets the delay for an AP to switch from a master AC to a backup AC. The value is in the range of 0 to 600 seconds.

Description

Use wlan backup-ac switch-delay to set the delay for an AP to switch from a master AC to a backup AC.

Use undo wlan backup-ac switch-delay to remove the configuration.

By default, the delay for an AP to switch from a master AC to a backup AC is 5 seconds.

Examples

# Set the delay for an AP to switch from a master AC to a backup AC to 10 seconds.

<Sysname> system-view

[Sysname] wlan backup-ac switch-delay 10

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Intelligent Storage
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
  • Technical Blogs
All Support
  • Become A Partner
  • Partner Policy & Program
  • Global Learning
  • Partner Sales Resources
  • Partner Business Management
  • Service Business
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网