02-WLAN Command Reference

HomeSupportReference GuidesCommand ReferencesH3C Access Controllers Command References(E3703P61 R2509P61 R3709P61 R2609P61 R3509P61)-6W10202-WLAN Command Reference
02-WLAN Access Commands
Title Size Download
02-WLAN Access Commands 492.22 KB

Contents

WLAN access configuration commands· 1

WLAN global service control commands· 1

wlan enable· 1

802.11 MAC configuration commands· 1

a-mpdu enable· 1

a-mpdu { 11ac | 11n | all } { rx | tx } packet-number 2

a-mpdu { 11ac | 11n } packet-length-exponent 3

a-msdu enable· 3

ani enable· 4

antenna type· 4

authentication-mode· 5

beacon country-code-ie· 6

beacon ssid-hide· 6

beacon-interval 7

beacon-measurement enable· 7

beacon-measurement interval 8

beacon-measurement type· 8

bind wlan-ess· 9

broadcast-probe reply· 10

channel 10

channel band-width· 11

channel lock· 12

classifier acl 13

client 14

client cache aging-time· 15

client forwarding-mode local 15

client forwarding-mode policy-based· 16

client remote-forwarding format 17

client idle-timeout 17

client keep-alive· 18

client max-count (radio policy view) 19

client max-count (service template view) 19

display wlan client 20

display wlan client beacon-report 24

display wlan client bridge· 25

display wlan country-code· 30

display wlan forwarding-policy· 31

display wlan radio-policy· 32

display wlan service-template· 36

display wlan statistics ap connect-history· 38

display wlan statistics client 40

display wlan statistics radio· 41

display wlan statistics service-template· 50

distance· 52

dtim·· 53

fast-association enable· 53

fragment-threshold· 54

green-energy-management enable· 54

ldpc enable· 55

long-retry threshold· 55

max-power 56

max-rx-duration· 56

mimo· 57

nas-id· 58

nas-port-id· 58

power lock· 59

preamble· 60

protection-mode· 60

radio· 61

radio type· 61

radio-policy· 62

reset wlan client 63

reset wlan statistics· 63

rts-threshold· 64

service-template (radio view) 64

service-template (service template view) 65

short-gi enable· 66

short-retry threshold· 67

shut-all-led enable· 67

snmp-agent trap enable wlan· 68

smart-antenna· 68

smart-antenna policy· 69

ssid· 70

stbc enable· 70

trap enable· 71

unknown-client 72

wlan client learn-ipaddr enable· 72

wlan country-code· 73

wlan forwarding-policy· 75

wlan link-test 75

wlan radio· 77

wlan radio-policy· 78

wlan radio-policy auto-create snmp· 79

wlan service-template· 79

wlan statistics ap-interval 80

wlan statistics ap-threshold· 80

wlan trap ap-number threshold· 81

AC-AP tunnel configuration commands· 82

ap-name· 82

client dhcp-server centralized· 82

cir 83

country-code· 83

description· 84

display wlan ap· 85

display wlan ap address· 93

display wlan ap connection record· 94

display wlan ap radio· 95

display wlan ap reboot-log· 96

display wlan ap-mac-address· 97

display wlan ap-model 97

echo-interval 99

firmware-update· 99

hybrid-remote-ap enable· 100

jumboframe enable· 101

map-configuration· 102

reset wlan ap· 103

reset wlan ap connection record· 103

reset wlan ap reboot-log· 103

serial-id· 104

statistics-interval 104

tunnel key-update disable· 105

tunnel uplink-retransmit-insensitive enable· 106

wlan ap· 106

wlan ap-authentication· 107

wlan ap-authentication acl 108

wlan ap-authentication domain· 108

wlan ap-authentication enable· 109

wlan ap-authentication import 110

wlan ap-authentication method· 110

wlan ap-authentication permit-unauthenticated· 111

wlan ap-concurrency-limit 111

wlan ap-firmware-update· 112

wlan apdb· 112

wlan ap-execute· 113

wlan ap-mac-address· 113

wlan auto-ap enable· 114

wlan auto-ap persistent 115

wlan auto-persistent enable· 115

wlan lwapp discovery-policy· 116

wlan management-interface· 116

wlan rename-ap· 117

AP group configuration commands· 117

ap· 117

ap-group· 118

description· 119

display wlan ap-group· 119

dot11a radio enable· 121

dot11a radio-policy· 121

dot11a service-template· 122

dot11bg radio enable· 123

dot11bg radio-policy· 123

dot11bg service-template· 124

if-match ip· 125

if-match ipv6· 126

reset wlan ap ap-group· 127

wlan ap-group· 127

wlan permit-ap-group· 128

SSID-based access control configuration commands· 129

wlan permit-ssid· 129

 


WLAN access configuration commands

WLAN global service control commands

wlan enable

Use wlan enable to enable WLAN service.

Use undo wlan enable to disable WLAN service.

Syntax

wlan enable

undo wlan enable

Default

WLAN service is enabled.

Views

System view

Default command level

2: System level

Usage guidelines

Enable WLAN before you can use the WLAN services.

Examples

# Enable WLAN service.

<Sysname> system-view

[Sysname] wlan enable

802.11 MAC configuration commands

a-mpdu enable

Use a-mpdu enable to enable the Aggregated MAC Protocol Data Unit (A-MPDU) function for the radio.

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

Syntax

a-mpdu enable

undo a-mpdu enable

Default

The A-MPDU function is enabled.

Views

Radio view

Default command level

2: System level

Usage guidelines

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-mpdu { 11ac | 11n | all } { rx | tx } packet-number

Use a-mpdu { 11ac | 11n | all } { rx | tx } packet-number to set the maximum number of MPDUs that can be aggregated into an A-MPDU.

Use undo a-mpdu { 11ac | 11n | all } { rx | tx } packet-number to restore the default.

Syntax

a-mpdu { 11ac | 11n | all } { rx | tx } packet-number number

undo a-mpdu { 11ac | 11n | all } { rx | tx } packet-number

Default

The default value varies by device model.

Views

Service template view

Default command level

2: System level

Parameters

11ac: Specifies 802.11ac clients.

11n: Specifies 802.11n clients.

all: Specifies all types of clients.

rx: Specifies A-MPDUs sent to the AP from clients.

tx: Specifies A-MPDUs sent to clients from the AP.

number: Specifies the maximum number of MPDUs in the range of 0 to 64.

Examples

# Set the maximum number of MPDUs that can be aggregated into an A-MPDU from 802.11n clients to 50.

<Sysname> system-view

[Sysname] wlan service-template 1

[Sysname-wlan-st-1] a-mpdu 11n rx packet-number 50

a-mpdu { 11ac | 11n } packet-length-exponent

Use a-mpdu { 11ac | 11n } packet-length-exponent to set the maximum length for an A-MPDU.

Use undo a-mpdu { 11ac | 11n } packet-length-exponent to restore the default.

Syntax

a-mpdu { 11ac | 11n } packet-length-exponent exponent

undo a-mpdu { 11ac | 11n } packet-length-exponent

Default

The default value varies by device model.

Views

Service template view

Default command level

2: System level

Parameters

11ac: Specifies 802.11ac clients.

11n: Specifies 802.11n clients.

exponent: Specifies the index for the maximum length of an A-MPDU. The value for 802.11n clients is in the range of 13 to 16, and the value for 802.11ac clients is in the range of 13 to 20.

Usage guidelines

The maximum length for an A-MPDU is equal to 2^exponent-1 bytes.

Examples

# Set the maximum length for an A-MPDU to 2^18-1 bytes for 802.11ac clients.

<Sysname> system-view

[Sysname] wlan service-template 1

[Sysname-wlan-st-1] a-mpdu 11ac packet-length-exponent 18

a-msdu enable

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.

Syntax

a-msdu enable

undo a-msdu enable

Default

The A-MSDU function is enabled.

Views

Radio view

Default command level

2: System level

Usage guidelines

This command is only effective on 802.11n radios. If you change the radio type of an 802.11n radio, the default setting for the A-MSDU 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 dot11gn

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

ani enable

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

Use undo ani enable to disable the ANI function.

Syntax

ani enable

undo ani enable

Default

ANI is enabled.

Views

Radio view

Default command level

2: System level

Usage guidelines

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 WA3628i-AGN

[Sysname-wlan-ap-ap1] radio 1

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

antenna type

Use antenna type to set the antenna type.

Use undo antenna type to restore the default.

Syntax

antenna type type

undo antenna type

Default

The default setting for the command varies by device model.

Views

Radio view

Default command level

2: System level

Parameters

type: Specifies the antenna type.

Examples

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

authentication-mode

Use authentication-mode to set the authentication mode.

Use undo authentication-mode to restore the default.

Syntax

authentication-mode { backup | local }

undo authentication-mode

Default

The AC performs central authentication on clients.

Views

Service template view

Default command level

2: System level

Parameters

backup: Specifies the backup authentication mode.

local: Specifies the local authentication mode.

Examples

# Enable local authentication.

<Sysname> system-view

[Sysname] wlan service-template 1 clear

[Sysname-wlan-st-1] authentication-mode local

Related commands

·     hybrid-remote-ap enable

·     map-configuration

beacon country-code-ie

Use beacon country-code-ie to configure whether beacon frames carry the country code and specify the operating environment.

Use undo beacon country-code-ie to restore the default.

Syntax

beacon country-code-ie { disable | enable { any | indoor | outdoor } }

undo beacon country-code-ie

Default

Beacon frames carry the country code and the operating environment is indoor.

Views

Service template view

Default command level

2: System level

Parameters

any: Specifies any operating environment.

indoor: Specifies the indoor environment.

outdoor: Specifies the outdoor environment.

Examples

# Configure beacon frames to carry the country code and specify the operating environment as outdoor.

<Sysname> system-view

[Sysname] wlan service-template 1 clear

[Sysname-wlan-st-1] beacon country-code-ie enable outdoor

beacon ssid-hide

Use beacon ssid-hide to disable the advertising of the Service Set Identifier (SSID) in beacon frames.

Use undo beacon ssid-hide to restore the default.

Syntax

beacon ssid-hide

undo beacon ssid-hide

Default

The SSID is advertised in beacon frames.

Views

Service template view

Default command level

2: System level

Usage guidelines

Allowing the advertising of the SSID in beacon frames enables clients to discover an AP more easily.

Disabling the advertising of the SSID in beacon frames does not improve wireless security.

If the advertising of the SSID in beacon frames is disabled, an SSID must be configured for the clients to associate with the AP.

Examples

# Disable the advertising of the SSID in beacon frames.

<Sysname> system-view

[Sysname] wlan service-template 1 clear

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

beacon-interval

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.

Syntax

beacon-interval interval

undo beacon-interval

Default

The beacon interval is 100 TUs.

Views

Radio policy view

Default command 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).

Examples

# Set the beacon interval to 1000 TUs.

<Sysname> system-view

[Sysname] wlan radio-policy radio1

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

beacon-measurement enable

Use beacon-measurement enable to enable the beacon measurement function. The AP sends beacon measurement requests to clients supporting the 802.11k protocol.

Use undo beacon-measurement enable to disable the beacon measurement function.

Syntax

beacon-measurement enable

undo beacon-measurement enable

Default

The beacon measurement function is disabled.

Views

Service template view

Default command level

2: System level

Examples

# Enable the beacon measurement function.

<Sysname> system-view

[Sysname] wlan service-template 1 clear

[Sysname-wlan-st-1] beacon-measurement enable

beacon-measurement interval

Use beacon-measurement interval to set the interval at which the AP sends beacon measurement requests to clients.

Use undo beacon-measurement interval to restore the default.

Syntax

beacon-measurement interval interval

undo beacon-measurement interval

Default

The interval is 60 seconds.

Views

Service template view

Default command level

2: System level

Parameters

interval: Specifies the interval at which the AP sends beacon measurement requests to clients, in the range of 10 to 200 seconds.

Examples

# Set the interval at which the AP sends beacon measurement requests to clients to 60 seconds.

<Sysname> system-view

[Sysname] wlan service-template 1 clear

[Sysname-wlan-st-1] beacon-measurement interval 60

beacon-measurement type

Use beacon-measurement type to set the beacon measurement mode.

Use undo beacon-measurement type to restore the default.

Syntax

beacon-measurement type { active | beacon-table | passive }

undo beacon-measurement type

Default

The beacon-table mode is adopted.

Views

Service template view

Default command level

2: System level

Parameters

active: Enables the active beacon measurement mode. In this mode, the AP sends a beacon measurement request to a client. Upon receiving the request, the client broadcasts probe requests on all supported channels, sets a measurement duration timer, and, at the end of the measurement duration, compiles all received beacons and probe responses into a measurement report.

beacon-table: Enables the beacon-table beacon measurement mode. In this mode, the AP sends a beacon measurement request to a client. Upon receiving the request, the client measures beacons and returns a report to the AP. The report contains all beacon information stored on the client.. The client does not perform any additional measurements.

passive: Enables the passive beacon measurement mode. In this mode, the AP sends a beacon measurement request to a client. Upon receiving the request, the client sets a measurement duration timer, and, at the end of the measurement duration, compiles all received beacons and probe responses into a measurement report.

Examples

# Set the beacon measurement mode to active.

<Sysname> system-view

[Sysname] wlan service-template 1 clear

[Sysname-wlan-st-1] beacon-measurement type active

bind wlan-ess

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.

Syntax

bind wlan-ess interface-index

undo bind wlan-ess

Default

No WLAN-ESS interface is bound to the service template.

Views

Service template view

Default command level

2: System level

Parameters

interface-index: Specifies the index of the WLAN-ESS interface. The value range varies by device model. For more information, see About the H3C Access Controllers Command References.

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

Use broadcast-probe reply to enable the AP to respond to the probe requests that do not carry an SSID.

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

Syntax

broadcast-probe reply

undo broadcast-probe reply

Default

An AP responds to probe requests that do not carry an SSID.

Views

AP template view, AP group view

Default command level

2: System level

Usage guidelines

Support for this command depends on the device model. For more information, see About the H3C Access Controllers Command references.

Executed in AP template view, the command applies to the specified AP.

Executed in AP group view, the command applies to all APs in the AP group.

Examples

# Enable AP 3 to respond to probe requests that carry no SSID.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA3628i-AGN

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

# Enable all APs in AP group office to respond to probe requests that carry no SSID.

<Sysname> system-view

[Sysname] wlan ap-group office

[Sysname-ap-group-office] broadcast-probe reply

channel

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

Use undo channel to restore the default.

Syntax

channel { channel-number | auto }

undo channel

Default

Auto mode is set.

Views

Radio view

Default command level

2: System level

Parameters

channel-number: Specifies a channel.

auto: Configures the channel to be automatically selected by the device according to the actual environment during system initialization.

Usage guidelines

The working channels depend on the country code and radio mode. The channel list varies by device model.

If specified, the channel channel-number is always used, and you do not need to configure the channel lock command. If the channel lock command is configured prior to configuring channel channel-number, the channel lock configuration is overwritten.

For DFS to work, make sure the AC adopts the auto mode before configuring DFS. For more information about DFS, see WLAN Configuration Guide.

Examples

# Specify the channel for radio 1 of AP 3 as 6.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA3628i-AGN

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

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

Related commands

·     channel lock

·     dot11a calibrate-channel

·     dot11bg calibrate-channel

channel band-width

Use channel band-width to set the channel bandwidth for the 802.11n radio.

Use undo channel band-width to restore the default.

Syntax

channel band-width { 20 | 40 [ auto-switch ] | 80 }

undo channel band-width

Default

The channel bandwidths of the 802.11a/n radio, the 802.11g/n radio and the 802.11ac/n radio are 40 MHz, 20 MHz, and 80 MHz, respectively.

Views

Radio view

Default command 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.

auto-switch: Enables automatic channel bandwidth switch for 2.4 GHz radios.

80: Specifies the channel bandwidth for the 802.11ac radio as 80 MHz. This keyword is available only in radio view of devices supporting 802.11ac.

Usage guidelines

When the channel bandwidth of the 802.11gn radio is 40 MHz, the automatic bandwidth switch function is disabled. To enable the function, use channel band-width 40 auto-switch command.

The channel band-width { 20 | 40 [ auto-switch ] } command only applies to 802.11n radios. The channel band-width 80 command only applies to 802.11ac radios.

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

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. For more information, see IEEE 802.11n-2009.

If the channel bandwidth of the radio is set to 80 MHz and a corresponding center frequency is found, an 80 MHz channel is used as the working channel. If no center frequency is available, a 40 MHz channel might be used. If no 40 MHz channel is available, only a 20 MHz channel can be used. For more information, see IEEE P802.11acTM/D5.0.

Examples

# Set the channel bandwidth of the radio to 40 MHz, and enable the bandwidth auto-switch function.

<sysname> system-view

[sysname] wlan ap ap3 model WA4620i-ACN

[sysname-wlan-ap-ap3] radio 2 type dot11gn

[sysname-wlan-ap-ap3-radio-2] channel band-width 40 auto-switch

channel lock

Use channel lock to lock the current channel.

Use undo channel lock to unlock the current channel.

Syntax

channel lock

undo channel lock

Default

The current channel is not locked.

Views

Radio view

Default command level

2: System level

Usage guidelines

The channel clock command takes effect only when the radio adopts the auto mode (which is 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 and then locks another channel, even if the channel lock command is configured.

If you configure the channel lock command first, and then enable DFS, DFS does not work because the channel is locked. Before enabling DFS, make sure the current channel is not locked.

When you enable DFS and then configure the channel lock command, the most recently selected channel is locked. For more information about DFS, see WLAN Configuration Guide.

Examples

# Lock the current channel.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA3628i-AGN

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

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

Related commands

·     channel

·     dot11a calibrate-channel and dot11bg calibrate-channel

classifier acl

Use classifier acl to configure forwarding rules to classify packets matching an ACL and forward them according to the corresponding forwarding policy.

Use undo classifier acl to remove the existing forwarding rules.

Syntax

classifier acl { acl-number | ipv6 acl6-number } behavior { local | remote }

undo classifier acl { acl-number | ipv6 acl6-number }

Default

No forwarding rule is configured.

Views

Forwarding policy view

Default command level

2: System level

Parameters

acl-number: Specifies an IPv4 ACL number in the range of 2000 to 4999.

ipv6 acl6-number: Specifies an IPv6 ACL number in the range of 2000 to 3999.

local: Specifies the local forwarding mode.

remote: Specifies the centralized forwarding mode.

Usage guidelines

A forwarding policy can be configured with 100 rules at most.

Before you can apply a forwarding policy, create a forwarding policy and specify forwarding rules. The AC sorts ACL rules in ascending order of rule ID. A rule with a lower ID is matched before a rule with a higher ID. If a match is found, the AC forwards the packet according to this rule. If no match is found, or no rule is configured, the AC adopts the centralized forwarding mode by default.

The AC ignores the permit and deny statements when matching ACL rules, and only uses them for packet classification.

Examples

# Configure a forwarding rule to forward packets matching ACL 2000 locally.

<Sysname> system-view

[Sysname] wlan forwarding-policy branch

[sysname-wlan-fp-branch] classifier acl 2000 behavior local

client

Use client to allow 802.11n or 802.11ac clients access.

Use undo client to restore the default.

Syntax

client { dot11n-only | dot11ac-only }

undo client { dot11n-only | dot11ac-only }

Default

An 802.11an or 802.11ac radio permits 802.11a, 802.11an, and 802.11ac clients access. An 802.11gn radio permits both 802.11b/g and 802.11gn client access.

Views

Radio view

Default command level

2: System level

Parameters

dot11n-only: Permits 802.11n or 802.11ac clients.

dot11ac-only: Permits only 802.11ac clients.

Usage guidelines

The client dot11n-only command permits only 802.11n or 802.11ac clients' access. To provide access for all 802.11a/b/g clients, disable this command.

The client dot11ac-only command prohibits non-802.11ac clients' access. To provide access for all 802.11a/n clients, disable this command.

Examples

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

<Sysname> system-view

[Sysname]wlan ap ap3 model WA2610E-AGN

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

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

# Configure the radio to allow only 802.11ac clients to access the WLAN.

<Sysname>system-view

[Sysname]wlan ap ap4 model WA4620i-ACN

[Sysname-wlan-ap-ap4]radio 1 type dot11ac

[Sysname-wlan-ap-ap4-radio-1]client dot11ac-only

Related commands

dot11n mandatory maximum-mcs

client cache aging-time

Use client cache aging-time to set the client cache aging time.

Use undo client cache aging-time to restore the default.

Syntax

client cache aging-time aging-time

undo client cache aging-time

Default

The client cache aging time is 180 seconds.

Views

Service template view

Default command level

2: System level

Parameters

aging-time: Specifies the client cache aging time in the range of 0 to 1800 seconds. A value of 0 means the client cache information is cleared when a client goes offline.

Usage guidelines

The client cache saves information such as the PMK list and access VLAN for clients. If a client roams to another AP before the cache aging time expires, the client can inherit the cache information. If a client does not come online before the cache aging time expires, its cache information is cleared.

Examples

# Set the client cache aging time to 30 seconds.

<Sysname>system-view

[Sysname]wlan service-template 1 clear

[Sysname-wlan-st-1] client cache aging-time 30

client forwarding-mode local

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

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

Syntax

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

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

Default

The AP transparently transmits data frames to the AC, and the AC forwards the data frames.

Views

Service template view

Default command level

2: System level

Parameters

local: Specifies the local forwarding mode, in which the AP is responsible for forwarding 802.11 packets from the clients.

vlan vlan-id-list: Specifies 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 option is not specified when you execute the client forwarding-mode local command, local forwarding is enabled on all the VLANs. If this option is not configured when you execute the undo client forwarding-mode local command, local forwarding is disabled on all the VLANs.

Usage guidelines

If local forwarding is enabled in the service template, the AP 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

# Configure local forwarding in service template 1.

<Sysname> system-view

[Sysname] wlan service-template 1 clear

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

client forwarding-mode policy-based

Use client forwarding-mode policy-based to enable policy-based forwarding in the service template.

Use undo client forwarding-mode policy-based to remove the forwarding policy and disable policy-based forwarding.

Syntax

client forwarding-mode policy-based [ policy-name ]

undo client forwarding-mode policy-based

Default

The centralized forwarding mode is adopted, in which the AC performs data forwarding.

Views

Service template view

Default command level

2: System level

Parameters

policy-name: Specifies a forwarding policy by its name, a case-insensitive string of 1 to 31 characters.

Examples

# Configure forwarding policy branch in the service template.

<Sysname> system-view

[Sysname] wlan service-template 1 clear

[Sysname-wlan-st-1] client forwarding-mode policy-based branch

client remote-forwarding format

Use client remote-forwarding format to set the encapsulation mode for data frames.

Use undo client remote-forwarding format to restore the default.

Syntax

client remote-forwarding format { dot3 | dot11 }

undo client remote-forwarding format

Default

Data frames are encapsulated in 802.11 format and forwarded by the AC.

Views

Service template view

Default command level

2: System level

Parameters

dot3: Configures the data frames to be encapsulated in 802.3 format and forwarded by the AC.

dot11: Configures the data frames to be encapsulated in 802.11 format and forwarded by the AC.

Usage guidelines

This command only applies to a CAPWAP tunnel. For an LWAPP tunnel, data frames can only be encapsulated in 802.11 format.

Examples

# Configure data frames to be encapsulated in 802.3 format and forwarded by the AC.

<Sysname> system-view

[Sysname] wlan service-template 1 clear

[Sysname-wlan-st-1] client remote-forwarding format dot3

client idle-timeout

Use client idle-timeout to set the maximum idle time for a connection between a client and the AP. A connection that remains idle for the specified period of time is removed.

Use undo client idle-timeout to restore the default.

Syntax

client idle-timeout interval

undo client idle-timeout

Default

The client idle timeout interval is 3600 seconds.

Views

AP template view, AP group view

Default command level

2: System level

Parameters

interval: Specifies the time for which the link between AP and the client can be idle. The value is in the range of 60 to 86400 seconds.

Usage guidelines

Support for this command depends on the device model. For more information, see About the H3C Access Controllers Command References.

Executed in AP template view, the command applies to the specified AP.

Executed in AP group view, the command applies to all APs in the AP group.

Examples

# Set the client idle timeout to 600 seconds.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA3628i-AGN

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

# Set the client idle timeout for all APs in AP group office to 600 seconds.

<Sysname> system-view

[Sysname] wlan ap-group office

[Sysname-ap-group-office] client idle-timeout 600

client keep-alive

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

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

Syntax

client keep-alive interval

undo client keep-alive

Default

The client keep-alive function is disabled.

Views

AP template view, AP group view

Default command level

2: System level

Parameters

interval: Keep-alive interval of clients in the range of 3 to 1800 seconds.

Usage guidelines

Support for this command depends on the device model. For more information, see About the H3C Access Controllers Command References.

The client keep-alive mechanism is used to detect and disconnect clients that are segregated from the system for reasons such as power failure or crash. If the AP does not receive any response from the client within the keep-alive interval, the AP notifies the AC to delete the client information. H3C recommends that you enable the client keep-alive mechanism to save AC memory.

Executed in AP template view, the command applies to a specified AP.

Executed in AP group view, the command applies to all APs in the AP group.

Examples

# Set the client keep-alive interval to 60 seconds.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA3628i-AGN

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

# Set the keep-alive interval for all APs in AP group office to 60 seconds.

<Sysname> system-view

[Sysname] wlan ap-group office

[Sysname-ap-group-office] client keep-alive 60

client max-count (radio policy view)

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

Use undo client max-count to restore the default.

Syntax

client max-count max-number

undo client max-count

Default

The maximum number of clients associated with an SSID on a radio is 64.

Views

Radio policy view

Default command level

2: System level

Parameters

max-number: Maximum number of allowed clients in a BSS. The value is in the range of 1 to 124.

Examples

# Set the maximum number of clients associated with an SSID to 10 for radio policy radio1.

<Sysname> system-view

[Sysname] wlan radio-policy radio1

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

client max-count (service template view)

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

Use undo client max-count to restore the default.

Syntax

client max-count max-number

undo client max-count

Default

A maximum of 64 clients can be associated with an SSID on a radio.

Views

Service template view

Default command level

2: System level

Parameters

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

Usage guidelines

When the maximum number is reached, the SSID is automatically hidden.

Examples

# Set the maximum number of clients associated with the SSID service on a radio to 10.

<Sysname> system-view

[Sysname] wlan service-template 1 clear

[Sysname-wlan-st-1] ssid service

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

display wlan client

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

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 ]

Views

Any view

Default command level

1: Monitor level

Parameters

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

radio radio-number: Displays information about clients that are 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 value range for this argument varies by device model. For more information, see the command matrixes in About the H3C Access Controllers Command References.

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, which is a case sensitive string of 1 to 256 characters.

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 [email protected]       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 is displayed as -NA- if the client adopts plain-text authentication or cipher-text authentication with no username.

·     The field is not used by 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 with which the client is associated.

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-

 IP Address                        : 192.168.1.48 

 AID                               : 1

 AP Name                           : 2

 Radio Id                          : 2

 Service Template Number           : 1

 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

 LDPC                              : Not Supported

 STBC Tx Capability                : Supported

 STBC Rx Capability                : 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

 Authentication Mode               : Central

 AKM Method                        : None

 Key Derivation                    : -NA-

 4-Way Handshake State             : -NA-

 Group Key State                   : -NA-

 Encryption Cipher                 : Clear

 PMF Status                        : -NA-

 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 is displayed as -NA- if the client adopts plain-text authentication or cipher-text 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.

IP Address

IP address 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:

·     Running—The client is connected to the AC through the primary link.

·     Running (Backup)—The client is connected to the AC through the backup link.

Power Save Mode

Client's power save mode, active or sleep.

Wireless Mode

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

Channel Band-width

Channel bandwidth, 20 MHz, 40 MHz, or 80 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.

LDPC

·     Not Supported

·     Supported

STBC Tx Capability

·     Not Supported

·     Supported

The AP and a client negotiate the STBC transmission capability. The negotiation can succeed only when both the AP and client have STBC transmission capability.

STBC Rx Capability

·     Not Supported

·     Supported

The AP and a client negotiate the STBC receive capability. The negotiation can succeed only when both the AP and client have STBC receive capability.

Support MCS Set

MCS supported by the client.

BLOCK ACK-TID

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

·     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 sending and receiving 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 periodically from AP to AC depending on the statistics interval.

Client Type

Client type such as RSN, WPA, or Pre-RSN.

Authentication Method

Authentication method such as open system or shared key.

Authentication Mode

Authentication mode:

·     CentralCentral authentication. The AC authenticates clients.

·     LocalLocal authentication. The AP authenticates clients.

AKM Method

AKM suite used such as Dot1X or PSK.

Key Derivation

Key derivation type:

·     SHA1—Uses the HMAC-SHA1 hash algorithm.

·     SHA256—Uses the HMAC-SHA256 hash algorithm.

·     -NA-—No key derivation algorithm is involved for the authentication type.

4-Way Handshake State

Display 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

Display the group key state:

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

PMF Status

Management frame protection state:

·     Active

·     Inactive

·     -NA-—No PMF is involved for the authentication type.

Roam Status

Display the roam status:

·     Normal.

·     Roaming in progress.

·     Intra-AC roam association.

·     Inter-AC roam association.

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 client beacon-report

Use display wlan client beacon-report to display beacon reports received from clients.

Syntax

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

Views

Any view

Default command level

1: Monitor level

Parameters

mac-address mac-address: Specifies the MAC address of a client. If the mac-address mac-address option is not specified, beacon reports from all clients 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, which is a case-sensitive string of 1 to 256 characters.

Examples

# Display beacon reports received from a specific client.

<Sysname>  display wlan client mac-address 000f-e265-6400 beacon-report

Report Information

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

MAC Address              : 000f-e265-6400

Total Number of Reports  : 4

-------------------------------------------------------------------------------------Channel         BSSID       Regulatory Class  Antenna ID      SSID

1           0026-3e08-1150        12             1            eagle

1           0026-3e08-1151        12             1            eagle

6           0026-3e08-1152        12             1            eagle

6           0026-3e08-1153        12             1            eagle

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

Table 3 Command output

Field

Description

MAC address

MAC address of the client.

Total Number of Reports

Total number of received beacon reports.

Channel

Channel number.

BSSID

ID of the BSS.

Regulatory Class

Regulatory class with the value of 12 or 5. For more information, see the 802.11k protocol.

Antenna ID

ID of the antenna.

SSID

SSID with which the client is associated.

 

display wlan client bridge

Use display wlan client bridge to display information about clients.

Syntax

display wlan client bridge [ ap ap-name [ radio radio-number ] ] [ verbose ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

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

radio radio-number: Specifies a radio by its number.

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, which is a case-sensitive string of 1 to 256 characters.

Usage guidelines

For convenience, clients mentioned in this command refer to bridges working as clients to associate with the AP.

This command can only display information about H3C wireless bridges.

Examples

# Display information about all clients.

<Sysname> display wlan client bridge

 Total Number of Clients           : 1

                               Client Information

 SSID: dragon

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

MAC Address    User Name            APID/RID IP Address                     VLAN

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

5866-baf2-d7cd -NA-                 2   /2   192.168.1.48                   1

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

Table 4 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 is displayed as -NA- if the client adopts plain-text authentication or cipher-text authentication with no username.

·     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 with which the client is associated.

IP Address

IP address of the client.

VLAN

VLAN to which the client belongs.

 

# Display detailed information about all clients.

<Sysname> display wlan client bridge verbose

Total Number of Clients           : 1

                              Client Information

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

 MAC Address                       : 5866-baf2-d7cd

 User Name                         : -NA-

 IP Address                        : 192.168.1.48

 AID                               : 1

 AP Name                           : floor11

 Radio Id                          : 2

 Service Template Number           : 1

 SSID                              : dragon

 BSSID                             : 5866-ba21-2770

 Port                              : WLAN-DBSS1:0

 VLAN                              : 1

 State                             : Running

 Power Save Mode                   : Active

 Wireless Mode                     : 11gn

 Channel Band-width                : 20MHz

 SM Power Save Enable              : Disabled

 Short GI for 20MHz                : Supported

 Short GI for 40MHz                : Not Supported

 STBC TX capability                : Supported

 STBC RX capability                : Supported

 Support MCS Set                   : 0,1,2,3,4,5,6,7

 BLOCK ACK-TID 0                   : IN

 QoS Mode                          : WMM

 Listen Interval (Beacon Interval) : 1

 RSSI                              : 80

 Rx/Tx Rate                        : 52/0

 Client Type                       : PRE-RSNA

 Authentication Method             : Open System

 Authentication Mode               : Central

 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:13:56

 Serial Number                     : 219801A0BHM125002207

 Device Information                : WB524

 Software Version                  : WB524V100R004

 Associated AP RSSI                : -NA-

 Associated AP SNR                 : -NA-

 Tx Power (dBm)                    : -NA-

 Rx Packets                        : 0

 Rx Bytes                          : 0

 Tx Packets                        : 0

 Tx Bytes                          : 0

 Tx Dropped Packets                : 0

 Command Execution Result          : -NA-

Table 5 Command output

Field

Description

MAC address

MAC address of the client.

User Name

Username of the client:

·     The field is displayed as -NA- if the client adopts plain-text authentication or cipher-text authentication with no username.

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

IP Address

IP address of the client.

AID

Association ID of the client.

AP Name

Name of the associated AP.

Radio Id

ID of the radio associated with the client.

Service Template Number

Serial number of the service template.

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:

·     Running—The client is connected to the AC through the primary link.

·     Running (Backup)—The client is connected to the AC through the backup link.

Power Save Mode

Client's power save mode, active or sleep.

Wireless Mode

Wireless mode such as 802.11a, 802.11b, 802.11g, 802.11gn, and 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.

·     Enabled.

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

STBC Tx Capability

·     Not Supported

·     Supported

The AP and a client negotiate the STBC transmission capability. The negotiation can succeed only when both the AP and client have STBC transmission capability.

STBC Rx Capability

·     Not Supported

·     Supported

The AP and a client negotiate the STBC receive capability. The negotiation can succeed only when both the AP and client have STBC receive capability.

Support MCS Set

MCS supported by the client.

BLOCK ACK-TID

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

·     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 (Beacon 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

The sending and receiving rates of the frames such as data, management, and control frames. For the AC + fit AP architecture, there is delay because Rx rate information is transmitted periodically from AP to AC.

Client Type

Client type such as RSN, WPA, or Pre-RSN.

Authentication Method

Authentication method such as open system or shared key.

Authentication Mode

Authentication mode:

·     CentralCentral authentication. The AC authenticates clients.

·     LocalLocal authentication. The AP authenticates clients.

AKM Method

AKM suite used such as Dot1X or PSK.

4-Way Handshake State

Display either of the 4-way handshake states:

·     IDLEDisplayed in initializing state.

·     PTKSTARTDisplayed when the 4–way handshake initialization is completed.

·     PTKNEGOTIATINGDisplayed after valid message 3 is sent.

·     PTKINITDONEDisplayed when the 4-way handshake is successful.

Group Key State

Display the group key state:

·     IDLEDisplayed in initializing state.

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

·     REKEYESTABLISHEDDisplayed when re-keying is successful.

Encryption Cipher

Encryption mode such as clear or crypto.

Roam Status

Display the roam status:

·     Normal

·     Roaming in progress

·     Intra-AC roam association

·     Inter-AC roam association

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.

Serial Number

Serial number of the client.

Device Information

Device model of the client.

Software Version

Software version of the client.

Associated AP RSSI

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

Associated AP SNR

The associated AP's SNR detected by the client.

Tx Power (dBm)

Transmission rate of the client radio.

Rx Packets

Total number of packets received by the client.

Rx Bytes

Total number of bytes received by the client.

Tx Packets

Total number of packets sent by the client.

Tx Bytes

Total number of bytes sent by the client.

Tx Dropped Packets

Total number of dropped packets by the client.

Command Execution Result

Command execution result reported by the client.

The field is displayed as -NA- if the device did not receive any command execution results reported by the client. For more information about the output, see the wireless bridge manual.

 

display wlan country-code

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

Syntax

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

Views

Any view

Default command level

1: Monitor level

Parameters

name ap-name: Specifies an AP by its name, a string of 1 to 64 characters that can contain case-insensitive letters and digits, and special characters such as underscore(_), left bracket ([), right bracket (]), slash (/), hyphen (-), and 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, which is a case sensitive string of 1 to 256 characters.

Examples

# Display the country code information about all APs.

<Sysname> display wlan country-code ap all

                            Country Code

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

 AP                                         Country Code

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

 ap1                                        CN CHINA

 ap2                                        CN CHINA

 ap3                                        US UNITED STATES

Related commands

country-code

display wlan forwarding-policy

Use display wlan forwarding-policy to display information about the specified forwarding policy or all forwarding policies.

Syntax

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

Views

Any view

Default command level

1: Monitor level

Parameters

forwarding-policy-name: Specifies a forwarding policy by its name, a case-sensitive string of 1 to 31 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.

Examples

# Display information about the configured forwarding policies.

<Sysname> display wlan forwarding-policy                                                

                           Forwarding Policy Parameters                        

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

 Forwarding Policy Name: fwd1                                          

 Classifier ACL 2000: Local                                            

 Classifier ACL 2004: Local                                            

 Classifier ACL IPv6 2001: Remote                                       

 Classifier ACL IPv6 2002: Remote                                      

                                                                               

                           Forwarding Policy Parameters                        

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

 Forwarding Policy Name: fwd2                                           

 Classifier ACL 4021: Local                                            

 Classifier ACL IPv6 2000: Remote                                      

 Classifier ACL IPv6 3024: Remote 

Table 6 Command output

Field

Description

Forwarding Policy Name

Name of the current forwarding policy.

Classifier ACL Number

Forwarding mode of IPv4 packets:

·     LocalThe AP performs data forwarding.

·     RemoteThe AC performs data forwarding.

Classifier ACL IPv6 Number

Forwarding mode of IPv6 packets:

·     LocalThe AP performs data forwarding.

·     RemoteThe AC performs data forwarding.

 

display wlan radio-policy

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

Syntax

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

Views

Any view

Default command level

1: Monitor level

Parameters

radio-policy-name: Specifies a radio policy by its name, a case-insensitive string of 1 to 15 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, which is a case sensitive string of 1 to 256 characters.

Examples

# Display the configuration information about 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

 Protection-mode                 : cts-to-self

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

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

 Protection-mode                 : cts-to-self

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

 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

 Protection-mode                 : cts-to-self  

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

 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 7 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 it is 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 or CTS-to-Self mechanism.

DTIM Period

DTIM period in units of beacon intervals.

DTIMs are used to determine if 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 that can be connected to the radio.

Protection-mode

Methods to avoid radio collision:

·     CTS-to-Self.

·     RTS/CTS.

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

Use display wlan service-template to display WLAN service template information. If no service template is specified, all service templates are displayed.

Syntax

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

Views

Any view

Default command level

1: Monitor level

Parameters

service-template-number: Number of a service template. The value range for this argument varies by device model. For more information, see the command matrixes in About the H3C 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.

Examples

# Display the configuration information for service template 1.

<Sysname> display wlan service-template 1

                          Service Template Parameters

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

 Service Template Number      : 1

 SSID                         : sharedkey

 Description                  : Not Configured

 Binding Interface            : WLAN-ESS1

 Service Template Type        : Crypto

 Security IE                  : Not Configured

 Authentication Method        : Shared Key

 Authentication Mode          : Central

 Beacon-measurement           : Enable

 Beacon-measurement Interval  : 30

 Beacon-measurement Type      : Passive

 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

 Forwarding Method            : Policy-based forwarding

 Packet Format                : Dot3

 PMF Status                   : Disable

 Service Template Status      : Enable

 Maximum clients per BSS      : 64

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

Table 8 Command output

Field

Description

Service Template Number

Current service template number.

SSID

SSID that is associated with the client.

Description

Description for the service template. Not Configured means no description is configured for the service template.

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 Method

Authentication method:

·     Open system.

·     Shared key.

Authentication Mode

Authentication mode:

·     CentralCentral authentication. The AC authenticates clients.

·     LocalLocal authentication. The AP authenticates clients.

·     BackupBackup authentication.

Beacon-measurement

Enable—The beacon measurement function is enabled.

Beacon-measurement Interval

Interval at which the AP sends beacon requests to clients. The value is in seconds.

Beacon-measurement Type

Beacon measurement mode:

·     Passive

·     Active

·     Beacon-table

SSID-hide

Enabled or disabled.

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(s)

Time for GTK rekey in seconds.

Forwarding Method

Forwarding mode:

·     Local forwarding—The AC adopts the local forwarding mode.

·     Remote forwarding—The AC adopts the centralized forwarding mode.

·     Policy-based forwarding—Based on the forwarding policy that matches the packet, the AC chooses the centralized forwarding mode or the local forwarding mode.

Packet Format

Packet format:

·     Dot11—802.11 format.

·     Dot3—802.3 format.

PMF Status

Management frame protection status:

·     Disable.

·     OptionalPMF is enabled. All clients can be associated with the AP.

·     MandatoryPMF is enabled. Only clients supporting PMF can be associated with the AP.

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

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

Syntax

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

Views

Any view

Default command level

1: Monitor level

Parameters

all: Displays the connection statistics for all APs.

name ap-name: Specifies an AP by its name, a case-insensitive string of 1 to 64 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.

verbose: Displays detailed information.

Examples

# Display the connection statistics for AP 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

# Display detailed connection statistics for AP ap1.

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

                            Connection History

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

 AP Name : ap1

 Time           Auth      Assoc    Reassoc     Deauth   Disassoc

 12:07:08          0          0          0          0          0

 12:06:58          0          0          0          0          0

 12:06:48          1          1          0          0          0

 12:06:38          0          0          0          0          0

 12:06:28          0          0          0          0          0

 12:06:18          0          0          0          1          0

 12:06:08          0          0          0          0          0

 12:05:58          0          0          0          0          0

 12:05:48          1          1          0          0          0

 12:05:38          0          0          0          0          0

 Total             11         10         5          1          0

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

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

Time

Statistics collection interval.

Auth

Total number of authentication packets.

Assoc

Total number of association packets.

Reassoc

Total number of reassociation packets.

Deauth

Total number of deauthentication packets.

Disassoc

Total number of disassociation packets.

Total

Total number of management packets.

 

display wlan statistics client

Use display wlan statistics client to display client statistics.

Syntax

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

Views

Any view

Default command 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.

Examples

# Display the statistics of all clients.

<Sysname> display wlan statistics client all

                                Client Statistics

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

 AP Name                           : ap1

 Radio Id                          : 1

 SSID                              : office

 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 10 Command output

Field

Description

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.

 

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

Use display wlan statistics radio to display radio statistics.

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

Syntax

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

Views

Any view

Default command level

1: Monitor level

Parameters

radio: Displays radio statistics.

ap ap-name: Specifies an AP by its name, a case-insensitive string of 1 to 64 characters. 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.

Examples

# Display the radio statistics for AP ap1.

                                 Radio Statistics                               

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

 AP Name: ap1                                   Radio Id: 1                     

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

Transmitted Frames Statistics:

   Total Frames Count                        : 836532                           

   Total Frames Bytes                        : 214040681                        

   Unicast Frames Count                      : 4                                

   Unicast Frames Bytes                      : 900                              

   Broadcast/Multicast Frames Count          : 836528                           

   Broadcast/Multicast Frames Bytes          : 214039781                        

   Other Frames Count                        : 0                                

   Other Frames Bytes                        : 0                                

                             

   Discarded Frames Count                    : 0                                

   Failed RTS Frames Count                   : 0                                 

   Retry Frames Count                        : 6                                

   Successful RTS Frames Count               : 0                                

   Multiple Retry Frames Count               : 3                                

   Failed ACK Frames Count                   : 1555                             

   Authentication Frames Count               : 1                                

   Association Frames Count                  : 1                                

                              

   Packet Statistics Based on Size:                                             

     Smaller than or equal to 128            : 747                              

     Between 128 and 512 (inclusive)         : 85983                             

     Between 512 and 1024 (inclusive)        : 0                                

     Larger than 1024                        : 0                                

                             

   Packet Statistics Based on Rate:                                              

         6 Mbps                    : 0                   9 Mbps    : 0          

        12 Mbps                    : 0                  18 Mbps    : 0          

        24 Mbps                    : 880                36 Mbps    : 0          

        48 Mbps                    : 0                  54 Mbps    : 0          

                             

   Packet Statistics Based on 802.11n Rate:                                     

       6.5 Mbps                    : 0                 7.2 Mbps    : 0          

        13 Mbps                    : 0                13.5 Mbps    : 0          

      14.4 Mbps                    : 0                  15 Mbps    : 0          

      19.5 Mbps                    : 0                21.7 Mbps    : 0          

        26 Mbps                    : 0                  27 Mbps    : 0          

      28.9 Mbps                    : 0                29.3 Mbps    : 0          

        30 Mbps                    : 0                32.5 Mbps    : 0          

        39 Mbps                    : 0                40.5 Mbps    : 0          

      43.3 Mbps                    : 0                  45 Mbps    : 0          

        52 Mbps                    : 0                  54 Mbps    : 0          

      57.8 Mbps                    : 0                58.5 Mbps    : 0          

        60 Mbps                    : 0                  65 Mbps    : 0          

      72.2 Mbps                    : 0                  78 Mbps    : 1          

        81 Mbps                    : 0                86.7 Mbps    : 0          

      87.8 Mbps                    : 0                  90 Mbps    : 0          

      97.5 Mbps                    : 0                 104 Mbps    : 3          

       108 Mbps                    : 0               115.6 Mbps    : 0          

       117 Mbps                    : 0                 120 Mbps    : 0          

     121.5 Mbps                    : 0                 130 Mbps    : 0          

       135 Mbps                    : 0               144.4 Mbps    : 0          

       150 Mbps                    : 0                 156 Mbps    : 0          

       162 Mbps                    : 0               173.3 Mbps    : 0          

     175.5 Mbps                    : 0                 180 Mbps    : 0          

       195 Mbps                    : 0                 200 Mbps    : 0          

       216 Mbps                    : 0               216.7 Mbps    : 0           

       234 Mbps                    : 0                 240 Mbps    : 0          

       243 Mbps                    : 0                 260 Mbps    : 0          

     263.3 Mbps                    : 0                 270 Mbps    : 0          

     288.9 Mbps                    : 0               292.5 Mbps    : 0          

       300 Mbps                    : 0                 324 Mbps    : 0          

       325 Mbps                    : 0                 351 Mbps    : 0          

       360 Mbps                    : 0               364.5 Mbps    : 0          

       390 Mbps                    : 0                 400 Mbps    : 0          

       405 Mbps                    : 0               433.3 Mbps    : 0          

       450 Mbps                    : 0                 468 Mbps    : 0          

       486 Mbps                    : 0                 520 Mbps    : 0          

     526.5 Mbps                    : 0                 540 Mbps    : 0          

       585 Mbps                    : 0                 600 Mbps    : 0          

       650 Mbps                    : 0                 702 Mbps    : 0          

       780 Mbps                    : 0               866.7 Mbps    : 0          

     877.5 Mbps                    : 0                 975 Mbps    : 0          

      1053 Mbps                    : 0                1170 Mbps    : 0          

      1300 Mbps                    : 0                                          

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

 Received Frames Statistics: 

   Total Frames Count                   : 420815                                

   Total Frames Bytes                   : 24112652                              

   Unicast Frames Count                 : 585                                   

   Unicast Frames Bytes                 : 15357                                 

   Broadcast/Multicast Frames Count     : 420230                                

   Broadcast/Multicast Frames Bytes     : 24097295                              

   Fragmented Frames                    : 0                                     

   Duplicate Frames                     : 0                                     

   FCS Failures                         : 474471639                             

   Decryption Errors                    : 0                                     

   Authentication Frames                : 1                                     

   Association Frames                   : 1                                      

                             

   Packet Statistics Based on Size:                                             

     Smaller than or equal to 128            : 420759                           

     Between 128 and 512 (inclusive)         : 54                               

     Between 512 and 1024 (inclusive)        : 0                                

     Larger than 1024                        : 0                                

                              

   Packet Statistics Based on Rate:                                             

         6 Mbps                    : 420115              9 Mbps    : 0          

        12 Mbps                    : 0                  18 Mbps    : 0           

        24 Mbps                    : 0                  36 Mbps    : 1          

        48 Mbps                    : 0                  54 Mbps    : 2          

                             

   Packet Statistics Based on 802.11n Rate:                                      

       6.5 Mbps                    : 0                 7.2 Mbps    : 0          

        13 Mbps                    : 0                13.5 Mbps    : 0          

      14.4 Mbps                    : 0                  15 Mbps    : 0          

      19.5 Mbps                    : 0                21.7 Mbps    : 0          

        26 Mbps                    : 0                  27 Mbps    : 0          

      28.9 Mbps                    : 0                29.3 Mbps    : 0          

        30 Mbps                    : 0                32.5 Mbps    : 0          

        39 Mbps                    : 0                40.5 Mbps    : 0          

      43.3 Mbps                    : 0                  45 Mbps    : 0           

        52 Mbps                    : 1                  54 Mbps    : 2          

      57.8 Mbps                    : 0                58.5 Mbps    : 17         

        60 Mbps                    : 0                  65 Mbps    : 10         

      72.2 Mbps                    : 0                  78 Mbps    : 48         

        81 Mbps                    : 0                86.7 Mbps    : 70         

      87.8 Mbps                    : 0                  90 Mbps    : 0          

      97.5 Mbps                    : 0                 104 Mbps    : 87         

       108 Mbps                    : 0               115.6 Mbps    : 170        

       117 Mbps                    : 130               120 Mbps    : 0          

     121.5 Mbps                    : 0                 130 Mbps    : 140        

       135 Mbps                    : 0               144.4 Mbps    : 22         

       150 Mbps                    : 0                 156 Mbps    : 0          

       162 Mbps                    : 0               173.3 Mbps    : 0          

     175.5 Mbps                    : 0                 180 Mbps    : 0          

       195 Mbps                    : 0                 200 Mbps    : 0          

       216 Mbps                    : 0               216.7 Mbps    : 0          

       234 Mbps                    : 0                 240 Mbps    : 0          

       243 Mbps                    : 0                 260 Mbps    : 0          

     263.3 Mbps                    : 0                 270 Mbps    : 0          

     288.9 Mbps                    : 0               292.5 Mbps    : 0          

       300 Mbps                    : 0                 324 Mbps    : 0          

       325 Mbps                    : 0                 351 Mbps    : 0          

       360 Mbps                    : 0               364.5 Mbps    : 0          

       390 Mbps                    : 0                 400 Mbps    : 0          

       405 Mbps                    : 0               433.3 Mbps    : 0          

       450 Mbps                    : 0                 468 Mbps    : 0          

       486 Mbps                    : 0                 520 Mbps    : 0          

     526.5 Mbps                    : 0                 540 Mbps    : 0          

       585 Mbps                    : 0                 600 Mbps    : 0          

       650 Mbps                    : 0                 702 Mbps    : 0          

       780 Mbps                    : 0               866.7 Mbps    : 0           

     877.5 Mbps                    : 0                 975 Mbps    : 0          

      1053 Mbps                    : 0                1170 Mbps    : 0          

      1300 Mbps                    : 0                                          

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

                             

                                 Radio Statistics                               

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

 AP Name: ap1                                   Radio Id: 2                     

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

Transmitted Frames Statistics:

   Total Frames Count                        : 13134                            

   Total Frames Bytes                        : 3259997                          

   Unicast Frames Count                      : 11                                

   Unicast Frames Bytes                      : 3518                             

   Broadcast/Multicast Frames Count          : 13123                            

   Broadcast/Multicast Frames Bytes          : 3256479                          

   Other Frames Count                        : 0                                

   Other Frames Bytes                        : 0                                

                             

   Discarded Frames Count                    : 0                                 

   Failed RTS Frames Count                   : 0                                

   Retry Frames Count                        : 58                               

   Successful RTS Frames Count               : 0                                 

   Multiple Retry Frames Count               : 11                               

   Failed ACK Frames Count                   : 7541                             

   Authentication Frames Count               : 14                                

   Association Frames Count                  : 8                                

                             

   Packet Statistics Based on Size:                                             

     Smaller than or equal to 128            : 1020                              

     Between 128 and 512 (inclusive)         : 11386                            

     Between 512 and 1024 (inclusive)        : 0                                

     Larger than 1024                        : 0                                 

                             

   Packet Statistics Based on Rate:                                             

         1 Mbps                    : 0                   2 Mbps    : 0          

       5.5 Mbps                    : 0                   6 Mbps    : 0          

         9 Mbps                    : 0                  11 Mbps    : 1121       

        12 Mbps                    : 0                  18 Mbps    : 0          

        24 Mbps                    : 0                  36 Mbps    : 0          

        48 Mbps                    : 0                  54 Mbps    : 0          

                             

   Packet Statistics Based on 802.11n Rate:                                      

       6.5 Mbps                    : 3                 7.2 Mbps    : 0          

        13 Mbps                    : 1                13.5 Mbps    : 0          

      14.4 Mbps                    : 0                  15 Mbps    : 0          

      19.5 Mbps                    : 4                21.7 Mbps    : 0          

        26 Mbps                    : 0                  27 Mbps    : 0          

      28.9 Mbps                    : 0                29.3 Mbps    : 0          

        30 Mbps                    : 0                32.5 Mbps    : 0          

        39 Mbps                    : 1                40.5 Mbps    : 0          

      43.3 Mbps                    : 0                  45 Mbps    : 0          

        52 Mbps                    : 0                  54 Mbps    : 0          

      57.8 Mbps                    : 0                58.5 Mbps    : 0          

        60 Mbps                    : 0                  65 Mbps    : 0          

      72.2 Mbps                    : 0                  78 Mbps    : 0          

        81 Mbps                    : 0                86.7 Mbps    : 0          

      87.8 Mbps                    : 0                  90 Mbps    : 0          

      97.5 Mbps                    : 0                 104 Mbps    : 1          

       108 Mbps                    : 0               115.6 Mbps    : 0          

       117 Mbps                    : 1                 120 Mbps    : 0          

     121.5 Mbps                    : 0                 130 Mbps    : 0          

       135 Mbps                    : 0               144.4 Mbps    : 0          

       150 Mbps                    : 0                 156 Mbps    : 0          

       162 Mbps                    : 0               173.3 Mbps    : 0          

     175.5 Mbps                    : 0                 180 Mbps    : 0          

       195 Mbps                    : 0                 200 Mbps    : 0          

       216 Mbps                    : 0               216.7 Mbps    : 0          

       234 Mbps                    : 0                 240 Mbps    : 0          

       243 Mbps                    : 0                 260 Mbps    : 0          

     263.3 Mbps                    : 0                 270 Mbps    : 0          

     288.9 Mbps                    : 0               292.5 Mbps    : 0          

       300 Mbps                    : 0                 324 Mbps    : 0          

       325 Mbps                    : 0                 351 Mbps    : 0          

       360 Mbps                    : 0               364.5 Mbps    : 0          

       390 Mbps                    : 0                 400 Mbps    : 0          

       405 Mbps                    : 0               433.3 Mbps    : 0          

       450 Mbps                    : 0                 468 Mbps    : 0          

       486 Mbps                    : 0                 520 Mbps    : 0          

     526.5 Mbps                    : 0                 540 Mbps    : 0          

       585 Mbps                    : 0                 600 Mbps    : 0          

       650 Mbps                    : 0                 702 Mbps    : 0          

       780 Mbps                    : 0               866.7 Mbps    : 0          

     877.5 Mbps                    : 0                 975 Mbps    : 0          

      1053 Mbps                    : 0                1170 Mbps    : 0          

      1300 Mbps                    : 0                                           

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

 Received Frames Statistics: 

   Total Frames Count                   : 32156                                 

   Total Frames Bytes                   : 3076192                               

   Unicast Frames Count                 : 1613                                  

   Unicast Frames Bytes                 : 102957                                

   Broadcast/Multicast Frames Count     : 30543                                 

   Broadcast/Multicast Frames Bytes     : 2973235                               

   Fragmented Frames                    : 0                                     

   Duplicate Frames                     : 2                                     

   FCS Failures                         : 9978084                               

   Decryption Errors                    : 0                                     

   Authentication Frames                : 14                                    

   Association Frames                   : 8                                     

                             

   Packet Statistics Based on Size:                                             

     Smaller than or equal to 128            : 25327                            

     Between 128 and 512 (inclusive)         : 6097                             

     Between 512 and 1024 (inclusive)        : 0                                

     Larger than 1024                        : 0                                

                             

   Packet Statistics Based on Rate:                                             

         1 Mbps                    : 28718               2 Mbps    : 1895       

       5.5 Mbps                    : 284                 6 Mbps    : 29         

         9 Mbps                    : 12                 11 Mbps    : 0          

        12 Mbps                    : 10                 18 Mbps    : 24          

        24 Mbps                    : 11                 36 Mbps    : 5          

        48 Mbps                    : 4                  54 Mbps    : 0          

                             

   Packet Statistics Based on 802.11n Rate:                                      

       6.5 Mbps                    : 45                7.2 Mbps    : 0          

        13 Mbps                    : 53               13.5 Mbps    : 0          

      14.4 Mbps                    : 0                  15 Mbps    : 0          

      19.5 Mbps                    : 120              21.7 Mbps    : 0          

        26 Mbps                    : 136                27 Mbps    : 0          

      28.9 Mbps                    : 0                29.3 Mbps    : 0          

        30 Mbps                    : 0                32.5 Mbps    : 0          

        39 Mbps                    : 59               40.5 Mbps    : 0          

      43.3 Mbps                    : 0                  45 Mbps    : 0          

        52 Mbps                    : 17                 54 Mbps    : 0          

      57.8 Mbps                    : 0                58.5 Mbps    : 20         

        60 Mbps                    : 0                  65 Mbps    : 4          

      72.2 Mbps                    : 0                  78 Mbps    : 0          

        81 Mbps                    : 0                86.7 Mbps    : 0          

      87.8 Mbps                    : 0                  90 Mbps    : 0          

      97.5 Mbps                    : 0                 104 Mbps    : 0          

       108 Mbps                    : 0               115.6 Mbps    : 0          

       117 Mbps                    : 0                 120 Mbps    : 0          

     121.5 Mbps                    : 0                 130 Mbps    : 0          

       135 Mbps                    : 0               144.4 Mbps    : 0          

       150 Mbps                    : 0                 156 Mbps    : 0          

       162 Mbps                    : 0               173.3 Mbps    : 0          

     175.5 Mbps                    : 0                 180 Mbps    : 0          

       195 Mbps                    : 0                 200 Mbps    : 0          

       216 Mbps                    : 0               216.7 Mbps    : 0          

       234 Mbps                    : 0                 240 Mbps    : 0          

       243 Mbps                    : 0                 260 Mbps    : 0          

     263.3 Mbps                    : 0                 270 Mbps    : 0          

     288.9 Mbps                    : 0               292.5 Mbps    : 0          

       300 Mbps                    : 0                 324 Mbps    : 0           

       325 Mbps                    : 0                 351 Mbps    : 0          

       360 Mbps                    : 0               364.5 Mbps    : 0          

       390 Mbps                    : 0                 400 Mbps    : 0          

       405 Mbps                    : 0               433.3 Mbps    : 0          

       450 Mbps                    : 0                 468 Mbps    : 0          

       486 Mbps                    : 0                 520 Mbps    : 0          

     526.5 Mbps                    : 0                 540 Mbps    : 0          

       585 Mbps                    : 0                 600 Mbps    : 0          

       650 Mbps                    : 0                 702 Mbps    : 0          

       780 Mbps                    : 0               866.7 Mbps    : 0          

     877.5 Mbps                    : 0                 975 Mbps    : 0          

      1053 Mbps                    : 0                1170 Mbps    : 0          

      1300 Mbps                    : 0                                          

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

Table 11 Command output

Field

Description

Transmitted Frames Statistics

Total Frames Count

Number of transmitted frames, including probe responses and beacon frames.

Total Frames Bytes

Number of transmitted bytes, including probe responses and beacon frames.

Unicast Frames Count

Number of transmitted unicast frames, excluding probe responses.

Unicast Frames Bytes

Number of transmitted bytes of unicast frames, excluding probe responses.

Broadcast/Multicast Frames Count

Number of transmitted broadcast or multicast frames.

Broadcast/Multicast Frames Bytes

Number of transmitted bytes of broadcast or multicast frames.

Others Frames Count

Number of other transmitted frames.

Other Frames Bytes

Number of transmitted bytes of other frames.

Discard Frames Count

Number of discarded frames.

Failed RTS Frames Count

Number of RTS frames failed to be transmitted.

Retry Count

Number of transmission retries.

Successful RTS Frames Count

Number of successfully transmitted RTS frames.

Multiple Retry Frames Count

Number of transmission retries.

Failed Ack Frames Count

Number of transmitted frames for which no acknowledgement is received.

Authentication Frames Count

Number of transmitted authentication response frames.

Association Frames Count

Number of transmitted association response frames.

Packet Statistics Based on Size

Packet statistics classified by packet size.

Packet Statistics Based on Rate

Packet statistics classified by rate.

Packet 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 Count

Number of received fragmented frames.

Total Frames Bytes

Number of bytes of received fragmented frames.

Unicast Frames Count

Number of received unicast frames.

Unicast Frames Bytes

Number of received bytes of unicast frames.

Broadcast/Multicast Frames Count

Number of received broadcast or multicast frames.

Broadcast/Multicast Frames Bytes

Number of received bytes of broadcast or multicast frames.

Fragmented Frames

Number of received fragmented frames.

Duplicate Frames

Number of received duplicate frames.

FCS Failures

Number of dropped frames due to FCS failure.

Decryption Errors

Number of dropped frames due to decryption error.

Authentication Frames

Number of received authentication request frames.

Association Frames

Number of received association request frames.

 

# Display the radio load information about 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 12 Command output

Field

Description

AP name

Access Point name.

Radio ID

Radio ID.

Client Number

Number of associated clients.

 

display wlan statistics service-template

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.

Syntax

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

Views

Any view

Default command level

1: Monitor level

Parameters

service-template-number: Specifies a service template number. The value range for this argument varies by device model. For more information, see the command matrixes in About the H3C Access Controllers Command References.

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.

Examples

# Display the statistics of service template 1.

<Sysname> display wlan statistics service-template 1

                        Service Template Statistics

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

Service Template           : 1

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

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 13 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 1.

<Sysname> display wlan statistics service-template 1 connect-history

                            Connect History

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

 Service Template           : 1

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

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

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

Use undo distance to restore the default.

Syntax

distance distance

undo distance

Default

The radio covers a maximum of 1 km (0.62 miles).

Views

Radio view

Default command 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).

Examples

# Set the maximum distance that the radio can cover to 5 km (3.11 miles).

<Sysname> system-view

[Sysname] wlan ap ap1 model WA3628i-AGN

[Sysname-wlan-ap-ap1] radio 1

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

dtim

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.

Syntax

dtim counter

undo dtim

Default

The DTIM is 1.

Views

Radio policy view

Default command level

2: System level

Parameters

counter: Number of beacon intervals between DTIM transmissions. The value is in the range of 1 to 31.

Examples

# Set the DTIM counter to 10.

<Sysname> system-view

[Sysname] wlan radio-policy rp

[Sysname-wlan-rp-rp] dtim 10

fast-association enable

Use fast-association enable to enable fast association.

Use undo fast-association enable to disable fast association.

Syntax

fast-association enable

undo fast-association enable

Default

Fast association is disabled.

Views

Service template view

Default command level

2: System level

Usage guidelines

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

Use fragment-threshold to set the maximum length of frames that can be transmitted without fragmentation. A packet that exceeds the specified fragment threshold is fragmented.

Use undo fragment-threshold to restore the default value.

Syntax

fragment-threshold size

undo fragment-threshold

Default

The fragment threshold is 2346 bytes. Frames that exceed 2346 bytes are fragmented.

Views

Radio policy view

Default command 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.

Examples

# Set the fragment threshold to 2048 bytes.

<Sysname> system-view

[Sysname] wlan radio-policy rp

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

green-energy-management enable

Use green-energy-management enable to enable the energy saving function. When this function is enabled, a radio transmits and receives 1 spatial stream at a time to save power if no clients are associated with the radio.

Use undo green-energy-management enable to disable the energy saving function.

Syntax

green-energy-management enable

undo green-energy-management enable

Default

The energy saving function is disabled.

Views

Radio view

Default command level

2: System level

Usage guidelines

This function is only available to APs supporting 802.11n and at least two spatial streams.

Examples

# Enable the energy saving function.

<Sysname> system-view

[Sysname] wlan ap ap1

[Sysname-wlan-ap-ap1] radio 1

[Sysname-wlan-ap-ap1-radio-1] green-energy-management enable

ldpc enable

Use ldpc enable to enable the low density parity check codes (LDPC) function.

Use undo ldpc enable to disable the LDPC function.

Syntax

ldpc enable

undo ldpc enable

Default

The LDPC function is disabled.

Views

Radio view

Default command level

2: System level

Usage guidelines

To enable clients that do not support LDPC (Xbox, for example) to communicate with the AP, disable LDPC.

Examples

# Enable the LDPC function.

<Sysname> system-view

[Sysname] wlan ap ap2 model WA2620-AGN

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

[Sysname-wlan-ap-ap2-radio-1] ldpc enable

long-retry threshold

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.

Syntax

long-retry threshold count

undo long-retry threshold

Default

The long retry threshold is 4.

Views

Radio policy view

Default command level

2: System level

Parameters

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

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

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

Use undo max-power to restore the default.

Syntax

max-power radio-power

undo max-power

Default

The maximum radio power varies by 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.

Views

Radio view

Default command level

2: System level

Parameters

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

Examples

# Set the max transmission power of radio 1 to 5.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA3628i-AGN

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

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

max-rx-duration

Use max-rx-duration to set the interval for the AP to hold a received frame. An AP holds received packets in its buffer memory.

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

Syntax

max-rx-duration interval

undo max-rx-duration

Default

The max-rx-duration is 2000 milliseconds.

Views

Radio policy view

Default command level

2: System level

Parameters

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

Examples

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

<Sysname> system-view

[Sysname] wlan radio-policy radio1

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

mimo

Use mimo to set the MIMO mode for a radio.

Use undo mimo to restore the default.

Syntax

mimo { 1x1 | 2x2 | 3x3 }

undo mimo

Default

No MIMO mode is set for a radio.

Views

Radio view

Default command level

2: System level

Parameters

1x1: Enables the radio to transmit and receive 1 spatial stream at a time.

2x2: Enables the radio to transmit and receive 2 spatial streams at a time.

3x3: Enables the radio to transmit and receive 3 spatial streams at a time.

Usage guidelines

This function is available only to APs supporting 802.11n and a minimum of two spatial streams.

Examples

# Set the MIMO mode for radio 1 to 2×2.

<Sysname> system-view

[Sysname] wlan ap ap1

[Sysname-wlan-ap-ap1] radio 1

[Sysname-wlan-ap-ap1-radio-1] mimo 2x2

nas-id

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

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

Syntax

nas-id nas-id

undo nas-id

Default

No NAS-ID is configured for an AP.

Views

AP template view

Default command level

2: System level

Parameters

nas-id: Sets the network access server (NAS) ID for an AP, a case-sensitive string of 1 to 63 characters.

Examples

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

<Sysname> system-view

[Sysname] wlan ap ap1 model WA3628i-AGN

[Sysname-wlan-ap-ap1] nas-id 0002053110000460

nas-port-id

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

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

Syntax

nas-port-id text

undo nas-port-id

Default

No NAS-PORT-ID is configured for an AP.

Views

AP template view

Default command level

2: System level

Parameters

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

Examples

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

<Sysname> system-view

[Sysname] wlan ap ap1 model WA3628i-AGN

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

power lock

Use power lock to lock the current power and set the power selected by DFS to be the maximum power after power selection.

Use undo power lock to unlock the current power and restore the default for the max-power command.

Syntax

power lock

undo power lock

Default

The current power is not locked.

Views

Radio view

Default command level

2: System level

Usage guidelines

After you configure the power lock command, the device automatically sets the maximum power as the power after power selection. The AP can use the power after power selection after the AC is rebooted.

If the working channel changes after you lock the power and the locked power is greater than the maximum power supported by the new channel, the device automatically changes the power to the maximum power supported by the new channel.

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

Examples

# Lock the current power, and set the power selected by DFS as the maximum power.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA3628i-AGN

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

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

Related commands

·     dot11a calibrate-power

·     dot11bg calibrate-power

preamble

Use preamble to set the type of preamble that an AP can support.

Use undo preamble to restore the default.

Syntax

preamble { long | short }

undo preamble

Default

The short preamble is supported.

Views

Radio view

Default command level

2: System level

Parameters

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

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

Usage guidelines

Preamble is a pattern of bits at the beginning of a frame so that the receiver can synchronize and be ready for receiving the data. There are short and long preambles.

802.11a and 802.11an does not support this configuration.

Examples

# Configure the AP to support long preamble.

<Sysname> system-view

[Sysname] wlan ap ap2 model WA3628i-AGN

[Sysname-wlan-ap-ap2] radio 2 type dot11gn

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

protection-mode

Use protection-mode to set the collision avoidance mechanism.

Use undo protection-mode to restore the default.

Syntax

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

undo protection-mode

Default

The collision avoidance mechanism is CTS-to-Self.

Views

Radio policy view

Default command 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.

Usage guidelines

Compared with RTS/CTS, CTS-to-Self reduces the number of control frames. However, data collisions still occur when some clients are hidden and cannot receive the CTS frames sent by the AP. The RTS/CTS mechanism can solve the data collision problem in a larger coverage than RTS/CTS.

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

Examples

# Set the collision avoidance mechanism to RTS/CTS.

<Sysname> system-view

[Sysname] wlan radio-policy test

[Sysname-wlan-rp-test] protection-mode rts-cts

radio

Use radio enable to enable the specified radio of an AP.

Use radio disable to disable the specified radio of an AP.

Syntax

radio { disable | enable }

Default

All radios are disabled.

Views

Radio view

Default command level

2: System level

Parameters

disable: Disables the radio.

enable: Enables the radio.

Examples

# Enable radio 1 of the AP.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA3628i-AGN

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

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

radio type

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

Syntax

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

Default

The default varies by device model. WLAN allows you to customize the default radio type for APs.

Views

AP template view

Default command level

2: System level

Parameters

radio-number: Specifies a radio by its number, which takes the value of 1 or 2. The actual value range is based on the AP model.

dot 11a: Specifies the 802.11a radio type.

dot11ac: Specifies the 802.11ac (5 GHz) radio type.

dot11an: Specifies the 802.11a/n (5 GHz) radio type.

dot 11b: Specifies the 802.11b radio type.

dot 11g: Specifies the 802.11g radio type.

dot11gn: Specifies the 802.11g/n (2.4 GHz) radio type.

Examples

# Set the radio type to 802.11a/n for radio 1.

<sysname> system-view

[sysname] wlan ap ap1 model WA2620-AGN

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

radio-policy

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

Use undo radio-policy to remove the mapping.

Syntax

radio-policy radio-policy-name

undo radio-policy

Default

All radios use the default radio policy default_rp.

Views

Radio view

Default command level

2: System level

Parameters

radio-policy-name: Specifies a radio policy by its name, a case-insensitive string of 1 to 15 characters.

Usage guidelines

The radio policy to be bound must be created using the wlan radio-policy command.

Examples

# Map radio policy radiorp to radio 1.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA3628i-AGN

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

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

Related commands

·     display wlan radio-policy

·     wlan radio-policy

reset wlan client

Use reset wlan client to disconnect a client or all clients from an 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.

Syntax

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

Views

User view

Default command level

2: System level

Parameters

all: Disconnects all clients.

mac address mac-address: Disconnects the client specified by the MAC address.

Examples

# Disconnect the client with MAC address 000f-e2cc-8501.

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

reset wlan statistics

Use reset wlan statistics to clear AP, client, or radio statistics.

Syntax

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

Views

User view

Default command level

2: System level

Parameters

ap all: Specifies all APs.

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

client all: Specifies all clients.

mac-address mac-address: Specifies a client by its MAC address.

ap-name: Clears the radio statistics of the specified AP. The AP name is a case-insensitive string of 1 to 32 characters.

Examples

# Clear the radio statistics for AP ap1.

<Sysname> reset wlan statistics radio ap1

rts-threshold

Use rts-threshold to set the request to send (RTS) threshold length. If a frame is larger than this value, the RTS mechanism is used.

Use undo rts-threshold to restore the default.

Syntax

rts-threshold size

undo rts-threshold

Default

The RTS threshold is 2346 bytes.

Views

Radio policy view

Default command level

2: System level

Parameters

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

Usage guidelines

Request to Send (RTS) is used to avoid data sending collisions in a WLAN. You need to set a rational value.

A small value causes RTS packets to be sent more often, which consumes more of the available bandwidth. However, the system can recover more quickly from interference or collisions when RTS packets are sent more frequently.

Examples

# Set the RTS threshold to 2046 bytes.

<Sysname> system-view

[Sysname] wlan radio-policy rp

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

service-template (radio view)

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

Use undo service-template to remove the mapping of a service template on a radio.

Syntax

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

undo service-template service-template-number

Default

No service template is mapped to a radio.

Views

Radio view

Default command level

2: System level

Parameters

service-template-number: Number of a service template. The value range for this argument varies by device model. For more information, see the command matrixes in About the H3C Access Controllers Command References.

vlan-id vlan-id1: Specifies a VLAN by its ID, in the range of 1 to 4094. If you do not specify this option, the VLAN of the WLAN-ESS interface is used by default.

vlan-pool vlan-pool-name: Specifies a VLAN pool by its name, a case-insensitive string of 1 to 32 characters.

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

nas-id nas-id: Sets the ID of the NAS to be bound, a case-sensitive string of 1 to 63 characters.

ssid-hide: Disables the advertising of the Service Set Identifier. If the SSID is hidden, the value of the TLV field in Beacon frames or Probe requests is 0. By default, the SSID is not hidden.

Usage guidelines

You can map multiple service templates to one radio.

After you bind a VLAN pool to a service template, configure the mac-vlan enable command on the WLAN-ESS interface bound to the service template and make sure the link type of the WLAN-ESS interface is hybrid.

Examples

# Map service template 1 to radio 1.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA3628i-AGN

[Sysname-wlan-ap-ap3] radio 1

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

service-template (service template view)

Use service-template to map a service template to a WLAN-BSS interface on the current WLAN-Radio interface.

Use undo service-template to remove the mapping.

Syntax

service-template { disable | enable }

Default

The service template is disabled.

Views

Service template view

Default command level

2: System level

Parameters

disable: Disables the service template.

enable: Enables the service template.

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

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

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

Syntax

short-gi enable

undo short-gi enable

Default

The short GI function is enabled.

Views

Radio view

Default command level

2: System level

Usage guidelines

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 might occur during transmission of radio signals due to factors such as multi-path reception. Therefore, a subsequently sent frame might interfere with a previously sent frame. The GI function is used to avoid this type of 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 WA2610E-AGN

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

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

short-retry threshold

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

Use undo short-retry threshold to restore the default.

Syntax

short-retry threshold count

undo short-retry threshold

Default

The short retry threshold is 7.

Views

Radio policy view

Default command 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.

Examples

# Set the short retry threshold to 10.

<Sysname> system-view

[Sysname] wlan radio-policy rp

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

shut-all-led enable

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

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

Syntax

shut-all-led enable

undo shut-all-led enable

Default

All LEDs on all the online APs of the current AP template light based on AP status.

Views

AP template view

Default command level

2: System level

Examples

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

<Sysname>system-view

[Sysname]wlan ap ap5 model WA2620-AGN

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

snmp-agent trap enable wlan

Use snmp-agent trap enable wlan to enable the AC to send SNMP traps to the NMS when the number of concurrent online APs reaches or drops below the upper limit.

Use undo snmp-agent trap enable wlan to disable the function.

Syntax

snmp-agent trap enable wlan { above-ap-number | below-ap-number }

undo snmp-agent trap enable wlan { above-ap-number | below-ap-number }

Default

The AC sends SNMP traps to the NMS when the number of concurrent online APs reaches or drops below the upper limit.

Views

System view

Default command level

2: System level

Parameters

above-ap-number: Enables the AC to send SNMP traps to the NMS when the number of online APs reaches the upper limit.

below-ap-number: Enables the AC to send SNMP traps to the NMS when the number of online APs drops below the upper limit.

Usage guidelines

The number of supported APs varies by the AC model.

For example, an AC supports a maximum of 128 concurrent online APs, and you set the trap threshold percentage to 50:

·     If you specify the above-ap-number keyword, the AC sends SNMP traps to the NMS when the 64th AP comes online.

·     If you specify the below-ap-number keyword, the AC sends SNMP traps to the NMS when the 64th AP goes offline.

Examples

# Enable the AC to send SNMP traps to the NMS when the maximum number of concurrent online APs reaches the upper limit.

<Sysname> system-view

[Sysname] snmp-agent trap enable wlan above-ap-number

Related commands

wlan trap ap-number threshold

smart-antenna

Use smart-antenna enable to enable the smart antenna.

Use undo smart-antenna enable to disable the smart antenna.

Syntax

smart-antenna enable

undo smart-antenna enable

Default

The smart antenna is enabled.

Views

Radio view

Default command level

2: System level

Usage guidelines

The smart antenna is available only if you have configured an internal antenna for the radio by using the antenna type command.

Examples

# Enable the smart antenna.

<Sysname> system-view

[Sysname] wlan ap ap2 model WA3620i-AGN

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

[Sysname-wlan-ap-ap2-radio-1] smart-antenna enable

Related commands

·     antenna type

·     smart-antenna policy

smart-antenna policy

Use smart-antenna policy to configure a smart antenna policy.

Use undo smart-antenna policy to restore the default.

Syntax

smart-antenna policy { auto | high-reliability | high-throughput }

undo smart-antenna policy

Default

The smart antenna policy is auto-sensing.

Views

Radio view

Default command level

2: System level

Parameters

auto: Specifies the autosensing policy. When this keyword is specified, the high reliability policy is used for voice and video packets, and the high throughput policy is used for other packets.

high-reliability: Adopts the high reliability policy.

high-throughput: Adopts the high throughput policy.

Usage guidelines

The command takes effect only if you have enabled the smart antenna.

Examples

# Configure the smart antenna to adopt the high reliability policy.

<Sysname> system-view

[Sysname] wlan ap ap2 model WA3620i-AGN

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

[Sysname-wlan-ap-ap2-radio-1] smart-antenna policy high-reliability

Related commands

smart-antenna enable

ssid

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

Use undo ssid to remove the SSID.

Syntax

ssid ssid-name

undo ssid

Default

The default SSID varies by device model. For more information, see About the H3C Access Controllers Command References.

Views

Service template view

Default command level

2: System level

Parameters

ssid-name: Specifies a service set identifier (SSID) by its name, a string of 1 to 32 characters that can contain case-sensitive letters, digits, underscore (_), and spaces.

Usage guidelines

Set an unique SSID. For security purposes, do not include the company name in the SSID. Do not use a long random string as the SSID because this adds payload to the header field.

Examples

# Set the SSID to firstfloor for service template 1.

<Sysname> system-view

[Sysname] wlan service-template 1 clear

[Sysname-wlan-st-1] ssid firstfloor

stbc enable

Use stbc enable to enable Space-timed Block Coding (STBC).

Use undo stbc enable to disable STBC.

Syntax

stbc enable

undo stbc enable

Default

STBC is enabled.

Views

Radio view

Default command level

2: System level

Usage guidelines

Enabling STBC improves the SNR of the receiver and data transmission reliability.

STBC can be used for wireless access and mesh links. When you enable STBC on a mesh link, H3C recommends that you enable STBC on both the sender and receiver to get best performance.

STBC takes effect only when the number of antennas on an AP is greater than the number of spatial streams corresponding to the rates used by the radio. For example, if the MCS is 8 and the corresponding spatial stream number is 2, STBC takes effect only when the AP has at least three antennas.

Examples

# Enable STBC.

<Sysname> system-view

[Sysname] wlan ap ap2 model WA3620i-AGN

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

[Sysname-wlan-ap-ap2-radio-1] stbc enable

trap enable

Use trap enable to enable the AP to send traps.

Use undo trap enable to disable the AP from sending traps.

Syntax

trap enable

undo trap enable

Default

The AP is enabled with trap sending.

Views

AP template view

Default command level

2: System level

Examples

# Enable the AP to send traps.

<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

unknown-client

Use unknown-client to configure how the AP treats packets from unknown clients.

Use undo unknown-client to restore the default.

Syntax

unknown-client { deauthenticate | drop }

undo unknown-client

Default

The AP sends a deauthentication packet when receiving packets from an unknown client.

Views

Service template view

Default command level

2: System level

Parameters

deauthenticate: Configures the AP to send a deauthentication packet when receiving packets from an unknown client.

drop: Configures the AP to drop the packets sent by an unknown client.

Examples

# Configure the AP to drop packets from unknown clients.

<Sysname>system-view

[Sysname]wlan service-template 1

[Sysname-wlan-st-1] unknown-client drop

wlan client learn-ipaddr enable

Use wlan client learn-ipaddr enable to enable IP address snooping for wireless clients.

Use undo wlan client learn-ipaddr enable to disable IP address snooping for wireless clients.

Syntax

wlan client learn-ipaddr enable

undo wlan client learn-ipaddr enable

Default

The IP address snooping function is disabled.

Views

System view

Default command level

2: System level

Examples

# Enable IP address snooping for wireless clients.

<Sysname> system-view

[Sysname] wlan client learn-ipaddr enable

wlan country-code

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

Use undo wlan country-code to restore the default.

Syntax

wlan country-code code

undo wlan country-code

Default

The global country code value is CN.

Views

System view

Default command level

2: System level

Parameters

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

Table 15 Country code information

Country

Code

Country

Code

ANDORRA

AD

KUWAIT

KW

ARE

AE

KAZAKHSTAN

KZ

ARGENTINA

AR

LIECHTENSTEIN

LI

AUSTRIA

AT

SRI LANKA

LK

AUSTRALIA

AU

LITHUANIA

LT

AZERBAIJAN

AZ

LUXEMBOURG

LU

BOSNIA AND HERZEGOVINA

BA

LATVIA

LV

BELGIUM

BE

MOROCCO

MA

BULGARIA

BG

MONACO

MC

BAHRAIN 

BH

MOLDOVA

MD

BOLIVIA

BO

MACEDONIA

MK

BRAZIL

BR

MARTINIQUE

MQ

BAHAMAS

BS

MALTA

MT

BELARUS

BY

MEXICO

MX

BELIZE

BZ

MALAYSIA

MY

CANADA 

CA

NETHERLANDS

NL

SWITZERLAND

CH

NORWAY

NO

CHILE 

CL

NEW ZEALAND

NZ

CHINA  

CN

OMAN

OM

COLOMBIA 

CO

PANAMA

PA

CYPRUS

CY

PERU

PE

CZECH REPUBLIC

CZ

PHILIPPINES

PH

GERMANY

DE

PAKISTAN

PK

DENMARK

DK

POLAND

PL

DOMINICAN REPUBLIC

DO

PUERTO RICO

PR

ESTONIA   

EE

PORTUGAL

PT

EGYPT

EG

PARAGUAY

PY

SPAIN 

ES

QATAR

QA

FINLAND

FI

ROMANIA

RO

FRANCE

FR

SERBIA

RS

UNITED KINGDOM 

GB

RUSSIAN FEDERATION

RU

GIBRALTAR

GI

SAUDI ARABIA

SA

GREENLAND

GL

SWEDEN

SE

GUADELOUPE

GP

SINGAPORE

SG

GREECE 

GR

SLOVENIA

SI

GUATEMALA 

GT

SLOVAKIA

SK

GUYANA  

GY

SAN MARINO

SM

HONGKONG 

HK

THAILAND

TH

CROATIA

HR

TURKEY

TR

HUNGARY 

HU

TAIWAN,PROVINCE OF CHINA

TW

INDONESIA

ID

UKRAINE

UA

IRELAND

IE

UNITED STATES

US

ISRAEL 

IL

URUGUAY

UY

INDIA

IN

UZBEKISTAN

UZ

ICELAND

IS

HOLY SEE

VA

ITALY

IT

VENEZUELA

VE

JORDAN

JO

VIET NAM

VN

JAPAN

JP

SOUTH AFRICA

ZA

KOREA

KR

 

 

 

Usage guidelines

The country code determines characteristics such as the power level and the 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.

Examples

# Set the global country code to US.

<Sysname> system-view

[Sysname] wlan country-code us

Related commands

country-code

wlan forwarding-policy

Use wlan forwarding-policy to create a forwarding policy and enter forwarding policy view.

Use undo wlan forwarding-policy to remove the specified forwarding policy.

Syntax

wlan forwarding-policy forwarding-policy-name

undo wlan forwarding-policy policy-name

Default

No forwarding policy exists.

Views

System view

Default command level

2: System level

Parameters

forwarding-policy-name: Specifies a forwarding policy by its name, a case-insensitive string of 1 to 31 characters.

Usage guidelines

You can create a maximum of 1000 forwarding policies at most.

Examples

# Create a forwarding policy named branch and enter forwarding policy view.

<Sysname> system-view

[Sysname] wlan forwarding-policy branch

[sysname-wlan-fp-branch]

wlan link-test

Use wlan link-test to RFPing a client.

Syntax

wlan link-test mac-address

Views

User view

Default command level

1: Monitor level

Parameters

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

Examples

# Perform an RFPing operation on 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

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

 VHT-MCS Rate(Mbps)  TxCnt   RxCnt   RSSI    Retries     RTT(ms)

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

 NSS = 1

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

 0      29.3        5       5       68      0           3

 1      58.5        5       5       69      0           0

 2      97.5        5       4       70      2           0

 3      117         5       4       71      2           0

 4      175.5       5       5       70      0           0

 5      234         5       5       69      0           0

 6      263.3       5       5       69      0           0

 7      292.5       5       5       69      0           0

 8      351         5       5       69      0           0

 9      390         5       5       69      0           0

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

 NSS = 2  

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

 0      58.5        5       5       69      0           0

 1      117         5       4       70      2           0

 2      175.5       5       5       70      0           0

 3      234         5       5       70      0           0

 4      351         5       5       69      0           0

 5      520         5       4       70      2           0

 6      526.5       5       4       69      2           0

 7      585         5       5       69      0           0

 8      702         5       5       70      0           0

 9      780         5       5       69      0           0

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

 NSS = 3  

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

 0      87.8        5       5       70      0           0

 1      175.5       5       5       70      0           0

 2      263.3       5       5       70      0           0

 3      351         5       5       70      0           0

 4      526.5       5       4       69      2           0

 5      702         5       4       69      6           0

 6      NA          5       0       0       0           0

 7      975         5       0       0       10          0

 8      1170        5       0       0       10          0

 9      1300        5       0       0       10          0

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

Table 16 RFPing operation results

Field

Description

VHT-MCS/No./MCS

·     The VHT-MCS field is displayed for an RFPing operation to an 802.11ac client, indicating the VHT-MCS index of the client.

·     The No. field is displayed for an RFPing operation to a non 802.11ac and 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)

RTT from the time the radio interface sends a ping packet to the time it receives a response from the client.

NSS

The NSS field is displayed for an RFPing operation to an 802.11ac client, indicating the number of spatial streams that the client supports.

 

wlan radio

Use wlan radio enable to enable WLAN radios.

Use wlan radio disable to disable WLAN radios.

Syntax

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

Default

No WLAN radio is enabled.

Views

System view

Default command 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.

dot11ac: Enables or disables 802.11ac 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 by its name, a case-insensitive string of 1 to 15 characters.

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

Use wlan radio-policy to create a radio policy, enter radio policy view, or both.

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

Syntax

wlan radio-policy radio-policy-name

undo wlan radio-policy radio-policy-name

Default

The default radio policy default_rp exists.

Views

System view

Default command level

2: System level

Parameters

radio-policy-name: Specifies a radio policy by its name, a case-insensitive string of 1 to 15 characters.

Usage guidelines

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.

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

Examples

# Create a radio policy named radio1.

<Sysname> system-view

[Sysname] wlan radio-policy radio1

[Sysname-wlan-rp-radio1]

Related commands

·     display wlan radio-policy

·     radio-policy

wlan radio-policy auto-create snmp

Use wlan radio-policy auto-create snmp to enable automatic creation of radio policies by the SNMP set operation.

Use undo wlan radio-policy auto-create snmp to disable automatic creation of radio policies by the SNMP set operation.

Syntax

wlan radio-policy auto-create snmp

undo wlan radio-policy auto-create snmp

Default

Automatic creation of radio policies by the SNMP operation is disabled.

Views

System view

Default command level

2: System level

Usage guidelines

This command is only available to AP templates created through SNMP, but not available to AP templates created in the Web interface or at the CLI.

Examples

# Enable automatic creation of radio policies by the SNMP set operation.

<Sysname> system-view

[Sysname] wlan radio-policy auto-create snmp

wlan service-template

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

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

Syntax

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

undo wlan service-template service-template-number

Views

System view

Default command level

2: System level

Parameters

service-template-number: Number of the service template. The value range for this argument varies by device model. For more information, see the command matrixes in About the H3C Access Controllers Command References.

clear: Sets the current service template type to clear. Data will be sent in clear text after the template is mapped to an AP.

crypto: Sets the current service template type to crypto. Data will be sent in cipher text after the template is mapped to an AP.

Usage guidelines

You cannot change an existing service template to another type. To do so, delete the existing 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

[Sysname-wlan-st-1]

wlan statistics ap-interval

Use wlan statistics ap-interval to set the management packet statistics collection interval.

Use undo wlan statistics ap-interval to restore the default.

Syntax

wlan statistics ap-interval ap-interval

undo wlan statistics ap-interval

Default

The interval is 60 seconds.

Views

System view

Default command level

2: System level

Parameters

ap-interval: Specifies the interval in the range of 1 to 3600 seconds.

Examples

# Set the management packet statistics collection interval to 10 seconds.

<Sysname> system-view

[Sysname] wlan statistics ap-interval 10

wlan statistics ap-threshold

Use wlan statistics ap-threshold to set the management packet alarm threshold.

Use undo wlan statistics ap-threshold to restore the default.

Syntax

wlan statistics ap-threshold ap-threshold

undo wlan statistics ap-threshold

Default

The management packet alarm threshold is 1000.

Views

System view

Default command level

2: System level

Parameters

ap-threshold: Specifies the alarm threshold in the range of 1 to 4294967295.

Usage guidelines

An AP generates an alarm when the number of its received management packets reaches the threshold.

Examples

# Set the management packet alarm threshold to 3000.

<Sysname> system-view

[Sysname] wlan statistics ap-threshold 3000

wlan trap ap-number threshold

Use wlan trap ap-number threshold to set the trap threshold percentage for sending SNMP traps.

Use undo wlan trap ap-number threshold to restore the default.

Syntax

wlan trap ap-number threshold value

undo wlan trap ap-number threshold

Default

The threshold percentage for sending SNMP traps is 100.

Views

System view

Default command level

2: System level

Parameters

value: Specifies the trap threshold percentage for sending SNMP traps, in the range of 30 to 100.

Usage guidelines

The number of supported APs varies by the AC model.

For example, an AC supports a maximum of 128 concurrent online APs. If you set the trap threshold percentage to 50, the upper limit of concurrent online APs is 64.

Examples

# Set the trap threshold percentage for sending SNMP traps to 60.

<Sysname> system-view

[Sysname] wlan trap ap-number threshold 60

Related commands

snmp-agent trap enable wlan

AC-AP tunnel configuration commands

ap-name

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

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

Syntax

ap-name name

undo ap-name

Default

No AP name is specified.

Views

AP template view

Default command level

2: System level

Parameters

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

Examples

# Set the name for AP ap1 to admin.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA3628i-AGN

[Sysname-wlan-ap-ap1] ap-name admin

client dhcp-server centralized

Use client dhcp-server centralized to enable centralized forwarding for client DHCP packets.

Use undo client dhcp-server to restore the default.

Syntax

client dhcp-server centralized

undo client dhcp-server

Default

The forwarding mode for client DHCP packets is the same as data packets.

Views

Service template view

Default command level

2: System level

Parameters

centralized: Specifies centralized forwarding. In centralized forwarding mode, the AC forwards all DHCP packets from clients.

Examples

# Enable centralized forwarding for client DHCP packets.

<Sysname> system-view

[Sysname] wlan service-template 1 clear

[Sysname-wlan-st-1] client dhcp-server centralized

cir

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

Use undo cir to restore the default.

Syntax

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

undo cir

Default

The CBS is the number of bytes transmitted in 500 ms at the rate of CIR.

Default

No CIR is set for an AP.

Views

AP template view

Default command 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.

Usage guidelines

For more information about CIR, see ACL and QoS Configuration Guide.

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

Related commands

car (ACL and QoS Command Reference)

country-code

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

Use undo country-code to remove the configuration.

Syntax

country-code code

undo country code

Default

The country or region code varies by the AP model. If no country or region code is configured for the AP, the AP uses the global country code.

Views

AP template view, AP group view

Default command level

2: System level

Parameters

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

Usage guidelines

Support for this command depends on the device model. For more information, see About the H3C Access Controllers Command References.

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

Executed in AP template view, the command applies to a specified AP.

Executed in AP group view, the command applies to all APs in the AP group. If an AP in the group does not support the configured country code, the AP uses the global country code.

Examples

# Set the country code for the AP to us.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2220X-AG

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

# Set the country code for the APs in AP group office to us.

<Sysname> system-view

[Sysname] wlan ap-group office

[Sysname-ap-group-office] country-code us

Related commands

·     wlan country-code

·     display wlan country-code

description

Use description to set a description for the AP group.

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

Syntax

description text

undo description

Default

No description is set for an AP.

Views

AP template view

Default command level

2: System level

Parameters

text: Description for the AP, a case-sensitive string of 1 to 64 characters.

Examples

# Set a description for the AP.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA3628i-AGN

[Sysname-wlan-ap-ap1] description L3-office

display wlan ap

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

Syntax

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

Views

Any view

Default command level

1: Monitor level

Parameters

all: Specifies all APs.

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

unauthenticated: Specifies all unauthenticated auto APs.

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.

Examples

# Display information about all APs.

<Sysname> display wlan ap all

Total Number of APs configured            : 2

 Total Number of configured APs connected : 1

 Total Number of auto APs connected       : 0

                                  AP Profiles

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

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

         M = Master, B = Backup                                                

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

 AP Name                          State Model              Serial-ID

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

 ap1                              R/M   WA2620E-AGN        036286A054000033

 ap3                              I     WA2220X-AGE        Not Configured

# Display information about all unauthenticated auto APs.

<Sysname> display wlan ap unauthenticated

 Total Number of APs configured           : 1

 Total Number of configured APs connected : 0

 Total Number of auto APs connected       : 2

                                  AP Profiles

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

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

         M = Master, B = Backup                                                

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

 AP Name                          State Model              Serial-ID

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

 000f-e2fe-0100                   R/M   WA2220E-AG         210235A35V0088000005

 000f-e26a-5200                   R/M   WA2220E-AG         210235A35V0088000029

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

Table 17 Command output

Field

Description

Total Number of APs configured

Total number of configured APs.

Total Number of configured APs connected

Total number of configured APs that have connected to the AC.

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 about AP 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                         : WA2620i-AGN

 Serial-ID                     : 219801A0CNC131000550

 AC IP Address                 : 192.168.100.100

 AP IP Address                 : 192.168.100.99

 

 H/W Version                   : Ver.A

 S/W Version                   : V100R005B09D014

 Boot-Rom Version              : 2.07

 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-Group Name                 : default_group   

 FIPS Mode                     : Disable

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

 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    : SCN

   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

   Green Energy Management     : Disabled                                       

   MIMO                        : Default                                       

   STBC                        : Enabled                                       

   LDPC                        : Disabled

   Configured Channel          : auto

   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                : Internal Antenna

   Resource Using Ratio (%)    : 0

   Noise Floor (dBm)           : 0

   Channelbusy  (%)            : 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

   Green Energy Management     : Disabled                                      

   MIMO                        : Default                                       

   STBC                        : Enabled                                        

   LDPC                        : Disabled

   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                : Internal Antenna

   Resource Using Ratio (%)    : 0

   Noise Floor (dBm)           : 0

   Channelbusy  (%)            : 0

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

Table 18 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:

¡     The version of the fit AP saved on the AC matches with the version that the AC requires.

¡     The space of the flash is enough.

·     IdleThe AP is idle. If the Idle state persists, check the following:

¡     If the fields of Latest IP Address and Tunnel Down Reason are displayed as -NA-, the AP has never connected to the AC successfully. Check the network cable, power supply of the fit AP, and the AP serial number (if the serial number was entered manually).

¡     If the Latest IP Address and Tunnel Down Reason fields are displayed as other contents, the AP has successfully connected to the AC. See the output from the Tunnel Down Reason field for the detailed reason.

·     RunThe AP is operating. The AP has connected to the AC successfully.

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

Up Time

Time duration 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.

AC IP Address

IP address of the AC.

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 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 AC-AP tunnel 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 reconfigure an AP template after deleting the old one.

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

AP-Group Name

Name of the group to which the AP belongs.

FIPS Mode

·     Enable.

·     Disable.

·     -NA-This field displays -NA- if the AP is offline.

AP Mode

Mode supported by the AP. Only the split MAC mode is supported.

AP operation mode

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

Device Detection

Whether or not device detection is enabled.

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 for 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 or not the AP is enabled to respond to broadcast probe requests.

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 the wireless mode is 11g, this field 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 three situations above.

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.

A-MSDU

·     Enabled.

·     Disabled.

A-MPDU

·     Enabled.

·     Disabled.

Green Energy Management

·     Enabled.

·     Disabled.

MIMO

·     Default—No MIMO mode is configured for the radio.

·     1x1—The radio can transmit and receive only one space stream at a time.

·     2x2—The radio can transmit and receive two space streams at a time.

·     3x3—The radio can transmit and receive three space streams at a time.

STBC

·     Enabled.

·     Disabled.

LDPC

·     Enabled.

·     Disabled.

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.

For an 802.11n 40 MHz radio, the channel displayed is the primary channel.

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.

Port

WLAN-DBSS interface associated with the service template.

Admin State

Administrative state of the radio.

Physical State

Physical state of the radio.

Operational Rates (Mbps)

Radio rates.

Radar detected Channels

Channels on which radar signals are detected.

Channelbusy

Channel usage.

 

display wlan ap address

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

Syntax

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

Views

Any view

Default Level

1: Monitor level

Parameters

all: Specifies all APs.

name ap-name: Specifies an AP by its name. It is a case-insensitive string of 1 to 64 characters.

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.

Examples

# Display the address information about 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 19 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 connection record

Use display wlan ap connection record to display connection records for APs.

Syntax

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

Views

Any view

Default command level

2: System level

Parameters

all: Specifies all APs.

mac-address mac-address: Specifies a 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.

Examples

# Display connection records for all APs.

<Sysname> display wlan ap connection record all

MAC address          Serial ID                       State         Time               

000f-e200-3000       210235A29G007C000020            Run           2012-10-05 13:42:46

000f-e200-1000       210235A29G007C000021            Join          2012-10-05 13:46:05

Table 20 Command output

Field

Description

MAC address

MAC address of the AP.

Serial ID

Serial number of the AP.

State

The connection status of the AP:

·     Discovery—The AC has only received discovery requests from the AP.

·     Join—The AP failed to build a tunnel with the AC.

·     Run—The AP has been connected with the AC and is in Run state.

·     Offline—The AP was connected with the AC and is now offline.

Time

The meaning of this field varies by the connection status of the AP:

·     Discovery—Last time the AC received a discovery request.

·     Join—Last time the AC received a Join packet.

·     Run—Time when the AP entered the Run state.

·     Offline—Time when the AP went offline.

 

Related commands

reset wlan ap connection record

display wlan ap radio

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

Syntax

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

Views

Any view

Default Level

1: Monitor level

Parameters

all: Specifies all APs.

name ap-name: Specifies an AP by its name. It is a case-insensitive string of 1 to 64 characters.

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.

Examples

# Display the radio information about 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 21 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

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 should be in the running state.

Syntax

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

Views

Any view

Default command 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 64 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.

Examples

# Display the reboot log information about 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-mac-address

Use display wlan ap-mac-address to display AC and AP binding relations.

Syntax

display wlan ap-mac-address [ mac-address ]

Views

Any view

Default command level

1: Monitor level

Parameters

mac-address: Specifies an AP by its MAC address.

Examples

# Display all AC and AP binding relations.

<Sysname> display wlan ap-mac-address

 AP MAC-Address                          AC IP-Address

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

0008-0001-0000                           192.168.0.1

0002-0001-0000                           192.168.0.2

# Display the AC bound to the AP with MAC address 0008-0001-0000.

<Sysname> display wlan ap-mac-address 0008-0001-0000

 AP MAC-Address                          AC IP-Address

0008-0001-0000                           192.168.0.1

display wlan ap-model

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

Syntax

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

Views

Any view

Default command 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 64 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.

Usage guidelines

You can use the display wlan ap-model all command 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 WA3628i-AGN                                

             AP Model : WA3628i-AGN                                            

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

 Vendor Name : H3C                                                             

 Vendor ID   : -NA-                                                            

 Radio Count : 2                                                                

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

 Radio1 :                                                                      

  Mode         : 802.11a/n                                                     

  Default Mode : 802.11n                                                       

  BSS Count    : 16                                                            

                                                                               

 Radio2 :                                                                       

  Mode         : 802.11b/g/n                                                   

  Default Mode : 802.11n                                                       

  BSS Count    : 16                                                             

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

 Version Support List :                                                        

  Hardware Version Ver.A :                                                      

   Software Version : V100R001B09D005                                          

   Image Name       : WA3600_fit.bin                                           

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

Table 22 Command output

Field

Description

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.

 

echo-interval

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

Use undo echo-interval to restore the default.

Syntax

echo-interval interval

undo echo-interval

Default

The echo interval is 10 seconds.

Views

AP template view, AP group view

Default command level

2: System level

Parameters

interval: Interval for an AP to send echo requests to the AC, in the range of 5 to 255 seconds.

Usage guidelines

Support for this command depends on the device model. For more information, see About the H3C Access Controllers Command References.

Typically, an AP periodically sends echo requests to an AC. The AC responds to echo requests by sending echo responses. If the AC does not receive any echo request three times the keep-alive interval, the AC/AP terminates the connection. If the AP does not receive any echo response three times the keep-alive interval, the AP terminates the connection.

Executed in AP template view, the command applies to the specified AP.

Executed in AP group view, the command applies to all APs in the AP group.

Examples

# Set the interval for AP 3 to send echo requests to the AC to 15 seconds.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA3628i-AGN

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

# Set the interval for all APs in AP group office to send echo requests to the AC to 15 seconds.

<Sysname> system-view

[Sysname] wlan ap-group office

[Sysname-ap-group-office] echo-interval 15

firmware-update

Use firmware-update to enable or disable the AP version upgrade function.

Use undo firmware-update to restore the default.

Syntax

firmware-update { disable | enable }

undo firmware-update

Default

The AP version upgrade function is enabled.

Views

AP template view, AP group view

Default command level

2: System level

Parameters

disable: Disables the AP version upgrade function.

enable: Enables the AP version upgrade function.

Usage guidelines

If you execute the firmware-update command or the undo firmware-update command in AP template view, the configuration only takes effect on the specified AP.

If you execute the firmware-update command or the undo firmware-update command in AP group view, the configuration takes effect on all APs in the group.

Examples

# Enable the AP version upgrade function in AP template view.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2620E-AGN

[Sysname-wlan-ap-ap1] firmware-update enable

# Enable the AP version upgrade function for AP group office.

<Sysname> system-view

[Sysname] wlan ap-group office

[Sysname-ap-group-office] firmware-update enable

hybrid-remote-ap enable

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

Use undo hybrid-remote-ap enable to disable the remote AP function.

Syntax

hybrid-remote-ap enable

undo hybrid-remote-ap enable

Default

The remote AP function is disabled.

Views

AP template view, AP group view

Default command level

3: Management level

Usage guidelines

Support for this command depends on the device model. For more information, see About the H3C Access Controllers Command References.

When remote AP is enabled, the following conditions exist:

·     In local and backup authentication modes, an AP automatically enables local forwarding mode (no matter whether local forwarding is configured on the AC) to forward packets for associated clients. If permits new clients.

·     In centralized authentication mode, an AP automatically enables local forwarding mode (no matter 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 connection with the AC, the AP automatically switches back to its original forwarding mode, and logs out all clients associated with it.

The remote AP function cannot be used simultaneously with the mesh function.

Disable the 802.1X handshake function for the service template that uses 802.1X authentication when the remote AP function is enabled.

Executed in AP template view, the command applies to the specified AP.

Executed in AP group view, the command applies to all APs in the AP group.

Examples

# Enable the remote AP function for AP ap1.

<Sysname> system-view

[Sysname] wlan ap ap1 model wa2100

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

# Enable the remote AP function for all APs in AP group office.

<Sysname> system-view

[Sysname] wlan ap-group office

[Sysname-ap-group-office] hybrid-remote-ap enable

jumboframe enable

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

Use undo jumboframe enable to restore the default.

Syntax

jumboframe enable value

undo jumboframe enable

Default

The jumbo frame support is disabled.

Views

AP template view

Default command level

2: System level

Parameters

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

Examples

# Set the maximum jumbo frame length to 1500 bytes.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA3628i-AGN

[Sysname-wlan-ap-ap1] jumboframe enable 1500

map-configuration

Use map-configuration to download a configuration file to an AP.

Use undo map-configuration to remove the configuration.

Syntax

map-configuration filename

undo map-configuration

Default

No configuration file is specified.

Views

AP template view, AP group view

Parameters

filename: Specifies a configuration file by name, a string of 1 to 32 characters. The configuration file must exist in the flash. Use the dir command in user view to view the list of files in the device.

Usage guidelines

Support for this command depends on the device model. For more information, see About the H3C Access Controllers Command References.

The downloaded configuration file takes effect when the tunnel operates in Run state. The AP uses the configuration in the configuration file but does not save it.

Executed in AP template view, the command applies to the specified AP.

Executed in AP group view, the command applies to all APs in the AP group.

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

You must configure an AP by using the configuration file downloaded from the AC in some cases. For example, when you configure a user profile in local forwarding mode, you must write the user profile, QoS policy, and ACL commands into the configuration file and download the file to the AP.

Examples

# Download file filename1 to the AP.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA3628i-AGN

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

# Download file filename1 to the all APs in AP group office.

<Sysname> system-view

[Sysname] wlan ap-group office

[Sysname-ap-group-office] map-configuration filename1.txt

reset wlan ap

Use reset wlan ap to reset APs.

Syntax

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

Views

User view

Default command level

1: Monitor level

Parameters

all: Specifies all APs connected to the current AC.

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

unauthenticated: Specifies all unauthenticated auto APs.

Examples

# Reset an AP named ap1.

<Sysname> reset wlan ap name ap1

reset wlan ap connection record

Use reset wlan ap connection record to clear the connection records of APs.

Syntax

reset wlan ap connection record { all | mac-address mac-address }

Views

User view

Default command level

2: System level

Parameters

all: Specifies all APs.

mac-address mac-address: Specifies a MAC addresses.

Examples

# Clear the connection records for all APs.

<Sysname> reset wlan ap connection record all

Related commands

display wlan ap connection record

reset wlan ap reboot-log

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

Syntax

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

Views

User view

Default command 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 64 characters.

Examples

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

<Sysname> reset wlan ap reboot-log name ap1

serial-id

Use serial-id to enable auto AP serial ID configuration. The serial ID is the unique identity of the AP. If the AP has connected to the AC, changing or deleting its serial ID brings the AP tunnel down. The AP must discover the AC to connect again.

Use undo serial-id to restore the default.

Syntax

serial-id { text | auto }

undo serial-id

Default

Auto AP serial ID configuration is disabled.

Views

AP template view

Default command level

2: System level

Parameters

text: Serial ID of an AP that is bound to its AP management entity. It is a case-sensitive string of 1 to 32 characters that can contain special characters except question mark (?). The system changes all entered letters to upper case.

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

Examples

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

<Sysname> system-view

[Sysname] wlan ap ap1 model WA3628i-AGN

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

statistics-interval

Use statistics-interval to set the interval for an AP to send statistics reports (including radio decryption error report and radio statistics).

Use undo statistics-interval to restore the default.

Syntax

statistics-interval interval

undo statistics-interval

Default

The interval for an AP to send statistics reports is 50 seconds.

Views

AP template view, AP group view

Default command level

2: System level

Parameters

interval: Interval for an AP to send statistics reports. The value is in the range of 2 to 120 seconds.

Usage guidelines

Support for this command depends on the device model. For more information, see About the H3C Access Controllers Command References.

Executed in AP template view, the command applies to the specified AP.

Executed in AP group view, the command applies to all APs in the AP group.

Examples

# Set the interval for an AP to send statistics reports to 100 seconds.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA2620E-AGN

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

# Set the interval for all APs in AP group office to send statistics reports to 100 seconds.

<Sysname> system-view

[Sysname] wlan ap-group office

[Sysname-ap-group-office] statistics-interval 100

tunnel key-update disable

Use tunnel key-update disable to disable the echo mechanism between AP and AC.

Use undo tunnel key-update disable to restore the default.

Syntax

tunnel key-update disable

undo tunnel key-update disable

Default

The echo mechanism between AP and AC is enabled.

Views

AP template view, AP group view

Default command level

2: System level

Usage guidelines

An AP and its associated AC use echo requests and responses to examine whether the AC-AP tunnel is operating correctly.

Examples

# Disable the echo mechanism between AP and AC for AP ap3.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA3628i-AGN

[Sysname-wlan-ap-ap3] tunnel key-update disable

# Disable the echo mechanism between AP and AC for APs in AP group office.

<Sysname> system-view

[Sysname] wlan ap-group office

[Sysname-ap-group-office] tunnel key-update disable

tunnel uplink-retransmit-insensitive enable

Use tunnel uplink-retransmit-insensitive enable to configure an AP to not terminate the AP-AC tunnel upon uplink retransmission failures.

Use undo tunnel uplink-retransmit-insensitive enable to restore the default.

Syntax

tunnel uplink-retransmit-insensitive enable

undo tunnel uplink-retransmit-insensitive enable

Default

An AP terminates the AP-AC tunnel when uplink retransmission fails.

Views

AP template view, AP group view

Default command level

2: System level

Examples

# Configure AP ap3 to not terminate the AP-AC tunnel upon uplink retransmission failures.

<Sysname> system-view

[Sysname] wlan ap ap3 model WA3628i-AGN

[Sysname-wlan-ap-ap3]tunnel uplink-retransmit-insensitive enable

# Configure APs in AP group office to not terminate the AP-AC tunnel upon uplink retransmission failures.

<Sysname> system-view

[Sysname] wlan ap-group office

[Sysname-ap-group-office] tunnel uplink-retransmit-insensitive enable

wlan ap

Use wlan ap to create a new AP template and enter AP template view. If the AP template exists, this 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 disconnects the AP from the AC.

Syntax

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

undo wlan ap ap-name

Views

System view

Default command level

2: System level

Parameters

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

model model-name: Specifies the model number of the AP. This argument must be provided when you create an AP template.

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.

Examples

# Create an AP template named ap1 and its model is WA3628i-AGN.

<Sysname> system-view

[Sysname] wlan ap ap1 model WA3628i-AGN

[Sysname-wlan-ap-ap1]

wlan ap-authentication

Use wlan ap-authentication to enable one or all unauthenticated auto APs to pass authentication and provide services and generate ACL rules.

Syntax

wlan ap-authentication { accept | reject } ap unauthenticated { all | name ap-name }

Views

System view

Default command level

2: System level

Parameters

accept: Changes the state of auto APs from "unauthenticated" to "authenticated" and adds the MAC address or serial ID of the AP to generate a permit ACL rule.

reject: Disables an unauthenticated auto AP from connecting to the AC and adds the MAC address of serial ID of the AP to the specified ACL to generate a deny rule.

all: Specifies all unauthenticated auto APs.

name ap-name: Specifies the name of an unauthenticated auto AP, a case-insensitive string of 1 to 64 characters.

Usage guidelines

Before you execute this command, use the wlan ap-authentication acl command to specify an ACL. The generated ACL rules will be added to the specified ACL.

Examples

# Enable all unauthenticated auto APs to pass authentication and provide services and generate ACL rules in ACL 200.

<Sysname> system-view

[Sysname] acl number 200

[Sysname-acl-ap-200] quit

[Sysname] wlan ap-authentication acl 200

[Sysname] wlan ap-authentication accept ap unauthenticated all

Related commands

·     wlan ap-authentication

·     wlan ap-authentication method

wlan ap-authentication acl

Use wlan ap-authentication acl to enable authentication on auto APs by using a specified ACL.

Use undo wlan ap-authentication acl to remove the configuration.

Syntax

wlan ap-authentication acl acl-number

undo wlan ap-authentication acl

Default

No ACL is specified for authenticating auto APs.

Views

System view

Default command level

2: System level

Parameters

acl-number: ACL number, in the range of 200 to 299.

Usage guidelines

Before you execute this command, use the acl number command to create a WLAN-AP ACL and configure ACL rules.

If you do not configure any ACL rules, the authentication result is "unauthenticated AP".

For more information about ACL configuration, see ACL and QoS Configuration Guide.

Examples

# Configure a permit rule in ACL 200 to allow the auto AP with the serial ID 210235A42QB095000766 to connect to the AC.

<Sysname> system-view

[Sysname] acl number 200

[Sysname-acl-ap-200] rule permit serial-id 210235A42QB095000766

[Sysname-acl-ap-200] quit

[Sysname] wlan ap-authentication acl 200

wlan ap-authentication domain

Use wlan ap-authentication domain to set the authentication domain for auto AP authentication.

Use undo wlan ap-authentication domain to remove the authentication domain for auto AP authentication.

Syntax

wlan ap-authentication domain domain-name

undo wlan ap-authentication domain

Default

No authentication domain is specified for authenticating auto APs.

Views

System view

Default command level

2: System level

Parameters

domain-name: Specifies the name of the authentication domain for auto AP authentication. It is a case-insensitive string of 1 to 24 characters.

Usage guidelines

You must configure the authentication domain for auto AP authentication when remote authentication is adopted.

Examples

# Set the authentication domain for auto AP authentication to office.

<Sysname> system-view

[Sysname] wlan ap-authentication domain office

wlan ap-authentication enable

Use wlan ap-authentication enable to enable auto AP authentication.

Use undo wlan ap-authentication enable to disable auto AP authentication.

Syntax

wlan ap-authentication enable

undo wlan ap-authentication enable

Default

Auto APs are not authenticated.

Views

System view

Default command level

2: System level

Usage guidelines

Auto AP authentication only takes effect for auto APs and does not take effect for configured APs and APs that come online by serial ID.

Auto AP authentication does not take effect for online auto APs.

Examples

# Enable auto AP authentication.

<Sysname> system-view

[Sysname] wlan ap-authentication enable

wlan ap-authentication import

Use wlan ap-authentication import to use ACL rules generated using the specified file to authenticate auto APs.

Syntax

wlan ap-authentication import file-name

Views

System view

Default command level

2: System level

Parameters

file-name: Specifies the name of the auto AP authentication file. It is case-insensitive string of 1 to 32 characters and must have the extension .txt.

Usage guidelines

In the file, the MAC addresses must be in the format of HH-HH-HH-HH-HH-HH, separated by commas. The serial IDs must be in the format of serial-id1, serial-id2, serial-id3, separated by commas.

Before you execute this command, use the wlan ap-authentication acl command to specify an ACL. ACL rules generated will be added to the ACL.

When generating ACL rules based on packets, the system starts from the step size 0, and automatically assigns one smallest number larger than the largest existing number to the new rule. For example, if the largest existing number is 28, and the step size is 5, the new number automatically assigned by the system is 30.

The value range for an WLAN-AP ACL rule is 0 to 65534. If the automatically assigned number is larger than 65534, an error message appears and the operation fails.

Examples

# Use ACL rules generated using the file office to authenticate auto APs.

<Sysname> system-view

[Sysname] acl number 200

[Sysname-acl-ap-200] quit

[Sysname] wlan ap-authentication acl 200

[Sysname] wlan ap-authentication import office

Related commands

·     wlan ap-authentication acl

·     wlan ap-authentication method

wlan ap-authentication method

Use wlan ap-authentication method to set the auto AP authentication method.

Use undo wlan ap-authentication method to restore the default.

Syntax

wlan ap-authentication method { mac-address | serial-id }

undo wlan ap-authentication method

Default

MAC address authentication is adopted.

Views

System view

Default command level

2: System level

Parameters

mac-address: Specifies the MAC address authentication method.

serial-id: Specifies the serial ID authentication method.

Examples

# Authenticate auto APs by serial ID.

<Sysname> system-view

[Sysname] wlan ap-authentication method serial-id

wlan ap-authentication permit-unauthenticated

Use wlan ap-authentication permit-unauthenticated to enable unauthenticated auto APs to connect to the AC. These unauthenticated auto APs cannot provide WLAN services (radio interfaces are disabled).

Use undo wlan ap-authentication permit-unauthenticated to disable unauthenticated auto APs from connecting to the AC.

Syntax

wlan ap-authentication permit-unauthenticated

undo wlan ap-authentication permit-unauthenticated

Default

Unauthenticated auto APs can connect to the AC but cannot provide WLAN services.

Views

System view

Default command level

2: System level

Examples

# Disable unauthenticated auto APs from connecting to the AC.

<Sysname> system-view

[Sysname] undo wlan ap-authentication permit-unauthenticated

wlan ap-concurrency-limit

Use wlan ap-concurrency-limit to set the maximum number of concurrent join requests that an AC can process.

Use undo wlan ap-concurrency-limit to restore the default.

Syntax

wlan ap-concurrency-limit number

undo wlan ap-concurrency-limit

Default

The maximum number of concurrent join requests that an AC can process is 32.

Views

System view

Default command level

2: System level

Parameters

number: Specifies the number of concurrent join requests. The range is 1 to the maximum number of supported APs. The maximum number of supported APs of an AC varies by device model. For more information, see About the H3C Access Controllers Configuration Guides.

Examples

# Set the maximum number of concurrent join requests that an AC can process to 35.

<Sysname> system-view

[Sysname] wlan ap-concurrency-limit 35

wlan ap-firmware-update

Use wlan ap-firmware-update to enable or disable the AP version upgrade function.

Syntax

wlan ap-firmware-update { disable | enable }

Default

AP version upgrade is enabled in system view.

Views

System view

Default command level

2: System level

Parameters

disable: Disables the AP version upgrade function.

enable: Enables the AP version upgrade function.

Examples

# Disable the AP version upgrade function.

<Sysname> system-view

[Sysname] wlan ap-firmware-update disable

wlan apdb

Use wlan apdb to enable the AC to accept APs with the specified software version.

Use undo wlan apdb to restore the default.

Syntax

wlan apdb model-name hardware-version software-version

undo wlan apdb model-name hardware-version

Default

An AP must use the same software version as the AC to establish an AP-AC tunnel.

Views

System view

Default command level

2: System level

Parameters

model-name: AP model name.

hardware-version: Fit AP hardware version name. If you set this argument to Ver.A, the AC ignores hardware versions of APs with the specified software version.

software-version: Fit AP software version name.

Examples

# Enable the AC to accept APs with software version Ver.C V100R001B40D001.

<Sysname> system-view

[Sysname] wlan apdb wa2100 Ver.C V100R001B40D001

wlan ap-execute

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

Syntax

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

Views

System view

Default command level

3: Manage level

Parameters

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

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

Usage guidelines

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-mac-address

Use wlan ap-mac-address to bind an AC to an AP.

Use undo wlan ap-mac-address to unbind an AC from an AP or remove all AC-AP binding relations.

Syntax

wlan ap-mac-address mac-address bas-ac-ip ip-address

undo wlan ap-mac-address { mac-address bas-ac-ip ip-address | all }

Default

No AC is bound to an AP.

Views

System view

Default command level

2: System level

Parameters

mac-address: Specifies the MAC address of an AP in the format of H-H-H.

bas-ac-ip ip-address: Specifies the IP address of an AC in dotted decimal notation.

all: Specifies all AC-AP binding relations.

Usage guidelines

If this feature is configured, an AC that receives the association requests from the specified AP redirects the requests to the bound AC.

Examples

# Bind the AC with IP address 192.168.0.1 to the AP with MAC address 3822-d6c1-55fb.

<Sysname> system-view

[Sysname] wlan ap-mac-address 3822-d6c1-55fb bas-ac-ip 192.168.0.1

wlan auto-ap enable

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

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

Syntax

wlan auto-ap enable

undo wlan auto-ap enable

Default

The auto AP function is disabled.

Views

System view

Default command level

2: System level

Examples

# Enable the auto AP function

<Sysname> system-view

[Sysname] wlan auto-ap enable

Related commands

serial-id

wlan auto-ap persistent

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

Syntax

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

Views

System view

Default command level

2: System level

Parameters

all: All connected auto APs.

name auto-ap-name: Specifies the name of a connected auto AP.

new-ap-name: Specifies the new name of the AP. It is a case-insensitive string of 1 to 64 characters. If you do not specify this argument, the AP with the name auto-ap-name is converted to a configured AP, with its name unchanged.

Examples

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

<Sysname> system-view

[Sysname] wlan auto-ap persistent name ap1_001 ap2

wlan auto-persistent enable

Use wlan auto-persistent enable to enable auto AP conversion.

Use undo wlan auto-persistent enable to disable auto AP conversion.

Syntax

wlan auto-persistent enable

undo wlan auto-persistent enable

Default

The auto AP conversion function is disabled.

Views

System view

Default command level

2: System level

Usage guidelines

This command takes effect only on auto APs that come online after this command is issued. For those online APs, you can only use the wlan auto-ap persistent command to convert them to configured APs.

Examples

# Enable auto AP conversion.

<Sysname> system-view

[Sysname] wlan auto-persistent enable

wlan lwapp discovery-policy

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.

Syntax

wlan lwapp discovery-policy unicast

undo wlan lwapp discovery-policy

Default

The LWAPP discovery policy is broadcast.

Views

System view

Default command level

2: System level

Parameters

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

Examples

# Set the LWAPP discovery policy type as unicast.

<Sysname> system-view

[Sysname] wlan lwapp discovery-policy unicast

wlan management-interface

Use wlan management-interface to specify a backup VLAN interface for AC association.

Use undo management-interface to restore the default.

Syntax

wlan management-interface interface-type interface-number

undo wlan management-interface

Default

No backup VLAN interface is specified for AC association and an AP uses VLAN-interface 1 to associate with the AC.

Views

System view

Default command level

2: System level

Parameters

interface-type interface-number: Specifies the interface type and interface number.

Examples

# Specify the backup VLAN interface for AC association as VLAN-interface 10.

<Sysname> system-view

[Sysname] wlan management-interface vlan-interface 10

wlan rename-ap

Use wlan rename-ap to rename an AP.

Syntax

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

Views

System view

Default command level

2: System level

Parameters

ap-name: Specifies the name of an AP, a case-insensitive string of 1 to 64 characters. It cannot be the name of an auto AP.

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

Examples

# Rename AP ap1 as ap1-office.

<Sysname> system-view

[Sysname] wlan rename-ap ap1 ap1-office

AP group configuration commands

Support for AP group configuration commands depends on the device model. For more information, see About the H3C Access Controllers Command References.

ap

Use ap to add specified APs into the AP group.

Use undo ap to delete specified APs from the AP group.

Syntax

ap template-name-list

undo ap [ template-name-list ]

Default

No APs exist in an AP group created by the wlan ap-group command.

Views

AP group view

Default command 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 64 characters that can contain letters, digits, and underlines.

Usage guidelines

If you do not provide the AP name when you delete an AP from an AP group, all APs in the group are deleted.

The device does not check whether the specified AP exists when you execute the command.

One AP can only be added to one AP group. If you execute the command multiple times, the most recent configuration overwrites the previous one.

If you use this command to add an AP that has been added to an AP group, the AP clears all its configuration except its serial number and restarts. After the AP is added to the new AP group, the AP uses the configuration of this new AP group.

All auto APs and configured APs are in the same AP group by default. Before you convert an auto AP to a configured AP, do not add it to another AP group.

Using the ap command repeatedly can add multiple APs in the AP group until the maximum number is reached, and a nonexistent AP can also be added. On a device, one AP can be included in multiple AP groups.

The maximum number of supported AP groups varies by device model.

Examples

# Add AP ap10 and AP ap11 to AP group office.

<System> system-view

[System] wlan ap-group office

[System-ap-group-office] ap ap10 ap11

ap-group

Use ap to add specified APs into the AP group.

Use undo ap to delete specified APs from the AP group.

Syntax

ap-group group-name

undo ap-group

Default

All APs are in the default AP group default_group.

Views

AP template view

Default command level

2: System level

Parameters

group-name: Specifies an AP group by its name, a case-insensitive string of 1 to 64 characters. An AP group name cannot be a, al, or all.

Usage guidelines

Support for this command depends on the device model. For more information, see About the H3C Access Controllers Command References.

A newly configured AP is added to the default AP group default_group, and uses the configuration of the default AP group.

One AP can only be added to one AP group.

If you have added an AP to an AP group, when you use this command to add the AP to another AP group, the AP clears its configuration except the serial number and restarts. After the AP is added to the new AP group, the AP uses the configuration of the new AP group.

All auto APs and configured APs are in the same AP group by default. Before you convert an auto AP to a configured AP, do not add it to another AP group.

Examples

# Add AP ap1 to AP group office.

<System> system-view

[Sysname] wlan ap ap1 model wa2100

[Sysname-wlan-ap-ap1] ap-group office

description

Use description to set a description for an AP group.

Use undo description to clear the description of an AP group.

Syntax

description text

undo description

Default

No description is configured for an AP group.

Views

AP group view

Default command level

2: System level

Parameters

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

Usage guidelines

Support for this command depends on the device model. For more information, see About the H3C Access Controllers Command References.

Examples

# Set the description for AP group 10 to marketing.

<System> system-view

[System] wlan ap-group 10

[System-ap-group10] description marketing

display wlan ap-group

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

Syntax

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

Views

Any view

Default command level

1: Monitor level

Parameters

group-name: Specifies the name of an AP group. If you do not specify an AP group ID, the command displays information about all AP groups.

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

Usage guidelines

Support for this command depends on the device model. For more information, see About the H3C Access Controllers Command References.

Examples

# Display information about all AP groups.

<Sysname> display wlan ap-group

                      AP Group Information                                   

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

AP-Group Name         :group1                                                         

Description           :room10                                                      

If-Match IP           :192.168.0.0/16

If-Match IPv6         :2152:56::10/124

Created AP List       :ap1                                                       

Not Created AP List   :1                                                         

                       2                                                         

                                                                               

AP-Group  Name        :default_group                                             

Description           :default                                                      

Created AP List       :None                                                      

Not Created AP List   :None

Table 23 Command output

Field

Description

AP-Group Name

AP group name.

Description

Description of the AP group.

If-Match IP

IPv4 address match criteria.

If-Match IPv6

IPv6 address match criteria.

Created AP List

APs that have been created. In other words, an AP template has been created with the wlan ap command.

Not Created AP List

APs that have not been created. In other words, No AP template is created with the wlan ap command.

 

dot11a radio enable

Use dot11a radio enable to enable the 5 GHz radios of APs in an AP group.

Use undo dot11a radio enable to disable the 5 GHz radios of APs in an AP group.

Syntax

dot11a radio enable

undo dot11a radio enable

Default

The 5 GHz radios of an AP group are disabled.

Views

AP group view

Default command level

2: System level

Usage guidelines

Support for this command depends on the device model. For more information, see About the H3C Access Controllers Command References.

APs in an AP group examine the configurations when executing the command. The command cannot be executed if some configuration conflicts exist, for example, uplink detection is enabled but the uplink is not reachable.

Examples

# Enable the 5 GHz radios of APs in AP group office.

<Sysname> system-view

[Sysname] wlan ap-group office

[Sysname-ap-group-office] dot11a radio enable

dot11a radio-policy

Use dot11a radio enable to map a radio policy to the 5 GHz radios of APs in an AP group.

Use undo dot11a radio enable to restore the default.

Syntax

dot11a radio-policy radio-policy-name

undo dot11a radio-policy

Default

The radios of all APs in an AP group use the default radio policy default_rp.

Views

AP group view

Default command level

2: System level

Parameters

radio-policy-name: Radio policy name, which is a case-insensitive string of 1 to 15 characters.

Usage guidelines

Support for this command depends on the device model. For more information, see About the H3C Access Controllers Command References.

Before you map a radio policy, use the wlan radio-policy command to create the radio policy.

APs in an AP group examine the configurations when executing the command. The command cannot be executed if some configuration conflicts exist, for example, the dot11a radio of an AP has been enabled.

Examples

# Map radio policy rp1 to the 5 GHz radios of APs in AP group office.

<Sysname> system-view

[Sysname] wlan ap-group office

[Sysname-ap-group-office] dot11a radio-policy rp1

Related commands

·     display wlan radio-policy

·     wlan radio-policy

dot11a service-template

Use dot11a service-template to map a service template to the 5 GHz radios of APs in an AP group.

Use undo dot11a service-template to remove the mapping of a service template to the 5 GHz radios of APs in an AP group.

Syntax

dot11a service-template service-template-number [ vlan-id vlan-id | vlan-pool vlan-pool-name ]

undo dot11a service-template service-template-number

Default

No service template is configured for an AP group.

Views

AP group view

Default command level

2: System level

Parameters

service-template-number: Specifies the number of a service template. The value range for this argument varies by device model. For more information, see the command matrixes in About the H3C Access Controllers Command References.

vlan-id vlan-id: Specifies a VLAN by its ID, in the range of 1 to 4094. If you do not specify this option, the VLAN of the WLAN-ESS interface is used by default.

vlan-pool vlan-pool-name: Specifies a VLAN pool by its name, a case-insensitive string of 1 to 16 characters.

Usage guidelines

Support for this command depends on the device model. For more information, see About the H3C Access Controllers Command References.

The service template configured with the dot11a service-template command does not conflict with the service template configured with the service-template command, but the sum of service templates configured through these two commands cannot exceed the maximum number of service templates that can be configured for the radio.

Examples

# Map service template 1 to the 5 GHz radios of AP in AP group office.

<Sysname> system-view

[Sysname] wlan ap-group office

[Sysname-ap-group-office] dot11a service-template 1

dot11bg radio enable

Use dot11bg radio enable to enable the 2.4 GHz radios of APs in an AP group.

Use undo dot11bg radio enable to disable the 2.4 GHz radios of APs in an AP group.

Syntax

dot11bg radio enable

undo dot11bg radio enable

Default

The 2.4 GHz radios of an AP group are disabled.

Views

AP group view

Default command level

2: System level

Usage guidelines

Support for this command depends on the device model. For more information, see About the H3C Access Controllers Command References.

APs in an AP group examine the configurations when executing the command. The command cannot be executed if configuration conflicts exist, for example, uplink detection is enabled but the uplink is not reachable.

Examples

# Enable the 2.4 GHz radios of APs in AP group office.

<Sysname> system-view

[Sysname] wlan ap-group office

[Sysname-ap-group-office] dot11bg radio enable

dot11bg radio-policy

Use dot11bg radio enable to map a radio policy to the 2.4 GHz radios of APs in an AP group.

Use undo dot11bg radio enable to restore the default.

Syntax

dot11bg radio-policy radio-policy-name

undo dot11bg radio-policy

Default

The radios of all APs in an AP group use the default radio policy default_rp.

Views

AP group view

Default command level

2: System level

Parameters

radio-policy-name: Specifies a radio policy by its name, a case-insensitive string of 1 to 15 characters.

Usage guidelines

Support for this command depends on the device model. For more information, see About the H3C Access Controllers Command References.

Before you map a radio policy, use the wlan radio-policy command to create the radio policy.

APs in an AP group examine the configurations when executing the command. The command cannot be executed if some configuration conflicts exist, for example, the dot11bg radio of an AP has been enabled.

Examples

# Map radio policy rp1 to the 2.4 GHz radios of APs in AP group office.

<Sysname> system-view

[Sysname] wlan ap-group office

[Sysname-ap-group-office] dot11bg radio-policy rp1

Related commands

·     display wlan radio-policy

·     wlan radio-policy

dot11bg service-template

Use dot11bg service-template to map a service template to the 2.4 GHz radios of APs in an AP group.

Use undo dot11bg service-template to remove the mapping of a service template to the 2.4 GHz radios of APs in an AP group.

Syntax

dot11bg service-template service-template-number [ vlan-id vlan-id | vlan-pool vlan-pool-name ]

undo dot11bg service-template service-template-number

Default

No service template is configured for an AP group.

Views

AP group view

Default command level

2: System level

Parameters

service-template-number: Specifies a service template by its number. The value range for this argument varies by device model. For more information, see the command matrixes in About the H3C Access Controllers Command References.

vlan-id vlan-id: Specifies a VLAN by its ID, in the range of 1 to 4094. If you do not specify this option, the VLAN of the WLAN-ESS interface is used by default.

vlan-pool vlan-pool-name: Specifies a VLAN pool by its name, a case-insensitive string of 1 to 16 characters.

Usage guidelines

Support for this command depends on the device model. For more information, see About the H3C Access Controllers Command References.

The service template configured with the dot11a service-template command does not conflict with the service template configured with the service-template command, but the sum of service templates configured through these two commands cannot exceed the maximum number of service templates that can be configured for the radio.

Examples

# Map service template 1 to the 2.4 GHz radios of AP in AP group office.

<Sysname> system-view

[Sysname] wlan ap-group office

[Sysname-ap-group-office] dot11bg service-template 1

if-match ip

Use if-match ip to configure an IPv4 address match criterion for an AP group.

Use undo if-match ip to remove the configuration.

Syntax

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

undo if-match ip

Default

No IPv4 address match criteria are configured.

Views

AP group view

Default command level

2: System level

Parameters

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

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

mask: Specifies the subnet mask in dotted decimal notation.

Usage guidelines

Use this command to manage APs by matching IP addresses.

Follow these guidelines when you configure IP address match criteria for an AP group:

·     You cannot configure IPv4 address match criteria in default group view.

·     The IPv4 address match criteria of different AP groups cannot overlap or include each other.

·     You can configure both IPv4 address match criteria and IPv6 address match criteria for one AP group at the same time.

·     An AP coming online by matching IP address does not support VRRP even if it goes offline and then comes online again. To enable the AP to support VRRP, manually add it to another AP group where the members are not in the same subnet as the AP.

·     An AP (configured or auto) that has been manually added to an AP group is always in the group even if its IP address matches the subnet of another AP group.

·     For an auto AP that is already in the default group default_group, if its IP address matches the subnet of a non-default AP group, the AC adds it to this AP group.

Examples

# Configure an IPv4 address match criterion to add APs in 192.168.0.0/16 into AP group office.

<System> system-view

[System] wlan ap-group office

[System-ap-group-office] if-match ip 192.168.0.0 16

Related commands

if-match ipv6

if-match ipv6

Use if-match ipv6 to configure an IPv6 address match criterion for an AP group.

Use undo if-match ipv6 to remove the configuration.

Syntax

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

undo if-match ipv6

Default

No IPv6 addresses match criteria are configured.

Views

AP group view

Default command level

2: System level

Parameters

ipv6-address: Specifies an IPv6 address.

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

Usage guidelines

Use this command to manage APs by matching IP addresses.

Follow these guidelines when you configure IP address match criteria for an AP group:

·     You cannot configure IPv6 address match criteria in default group view.

·     The IPv6 address match criteria of different AP groups cannot overlap or include each other.

·     You can configure both IPv4 address match criteria and IPv6 address match criteria for one AP group at the same time.

·     An AP coming online by matching IP address does not support VRRP even if it goes offline and then comes online again. To enable the AP to support VRRP, manually add it to another AP group where the members are not in the same subnet as the AP.

·     An AP (configured or auto) that has been manually added to an AP group is always in the group even if its IP address matches the subnet of another AP group.

·     For an auto AP that is already in the default group default_group, if its IP address matches the subnet of a non-default AP group, the AC adds it to this AP group.

Examples

# Configure an IPv6 address match criterion to add APs in 2001:DB0::/28 into AP group office.

<System> system-view

[System] wlan ap-group office

[System-ap-group-office] if-match ipv6 2001:DB8:: 28

Related commands

if-match ip

reset wlan ap ap-group

Use reset wlan ap ap-group to reset all APs in a specific AP group.

Syntax

reset wlan ap ap-group group-name

Views

User view

Default command level

2: System level

Parameters

group-name: Specifies an AP group by its name, a case-insensitive string of 1 to 32 characters. The name cannot be "a", "al", and "all".

Examples

# Reset all APs in AP group office.

<Sysname> reset wlan ap ap-group office

wlan ap-group

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

Use undo wlan ap-group to remove a specified AP group or to remove all AP groups if no AP group is specified.

Syntax

wlan ap-group group-name

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

Default

An AP group named default_group exists. The default group cannot be deleted. All APs are in this group.

Views

System view

Default command level

2: System level

Parameters

group-name: Specifies a name for the AP group, a case-insensitive string of 1 to 32 characters. The name cannot be a, al, or all.

all: Specifies all AP groups.

Usage guidelines

Support for this command depends on the device model. For more information, see About the H3C Access Controllers Command References.

The maximum number of AP groups varies by device model. For more information, see About the H3C Access Controllers Configuration Guide.

Examples

# Create AP group office.

<Sysname> system-view

[Sysname] wlan ap-group office

[Sysname-ap-group-office]

wlan permit-ap-group

Use wlan permit-ap-group to apply an AP group to a user profile, which can have multiple AP groups applied.

Use undo wlan permit-ap-group to remove an AP group from the user profile or all AP groups from the user profile if no AP group is specified.

Syntax

wlan permit-ap-group group-name

undo wlan permit-ap-group [ group-name ]

Default

An AP group is not applied to the user profile.

Views

User profile view

Default command level

2: System level

Parameters

group-name: Specifies an AP group by its name, a case-insensitive string of 1 to 32 characters. The name cannot be a, al, or all.

Usage guidelines

Support for this command depends on the device model. For more information, see About the H3C Access Controllers Command References.

Examples

# Apply AP group office to user profile management.

<Sysname> system-view

[Sysname] user-profile management

[Sysname-user-profile-management] wlan permit-ap-group office

SSID-based access control configuration commands

wlan permit-ssid

Use wlan permit-ssid to set a permitted SSID for a user profile.

Use undo wlan permit-ssid to remove a permitted SSID or all permitted SSIDs.

Syntax

wlan permit-ssid ssid-name

undo wlan permit-ssid [ ssid-name ]

Default

No permitted SSID is specified for a user profile, which means that users can access the WLAN through any SSID.

Views

User profile view

Default command level

2: System level

Parameters

ssid-name: Specifies the name of a permitted SSID. It is a string of 1 to 32 characters that can contain case-sensitive letters, digits, underscore (_), and spaces. The maximum number of permitted SSIDs in a user profile varies by device model. For more information, see About the H3C Access Controllers Configuration Guides.

Examples

# Set a permitted SSID for user profile management.

<Sysname> system-view

[Sysname] user-profile management

[Sysname-user-profile-management] wlan permit-ssid VIPguest

  • 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
新华三官网