- Table of Contents
-
- 02-WLAN Command Reference
- 00-Preface
- 01-WLAN Interface Commands
- 02-WLAN Access Commands
- 03-WLAN Security Commands
- 04-IACTP Tunnel and WLAN Roaming Commands
- 05-WLAN RRM Commands
- 06-WLAN IDS Commands
- 07-WLAN QoS Commands
- 08-WLAN Mesh Link Commands
- 09-Advanced WLAN Commands
- 10-WLAN High Availability Commands
- 11-WLAN IPS Commands
- 12-WLAN Optimization Commands
- Related Documents
-
Title | Size | Download |
---|---|---|
02-WLAN Access Commands | 492.22 KB |
WLAN access configuration commands
WLAN global service control commands
802.11 MAC configuration commands
a-mpdu { 11ac | 11n | all } { rx | tx } packet-number
a-mpdu { 11ac | 11n } packet-length-exponent
client forwarding-mode policy-based
client remote-forwarding format
client max-count (radio policy view)
client max-count (service template view)
display wlan client beacon-report
display wlan forwarding-policy
display wlan statistics ap connect-history
display wlan statistics client
display wlan statistics service-template
green-energy-management enable
service-template (service template view)
wlan client learn-ipaddr enable
wlan radio-policy auto-create snmp
AC-AP tunnel configuration commands
client dhcp-server centralized
display wlan ap connection record
reset wlan ap connection record
tunnel uplink-retransmit-insensitive enable
wlan ap-authentication permit-unauthenticated
AP group configuration commands
SSID-based access control configuration commands
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
----------------------------------------------------------------------
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. · Enabled—SM Power Save is enabled. · Disabled—SM 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): · OUT—Outbound direction. · IN—Inbound direction. · BOTH—Both 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: · Central—Central authentication. The AC authenticates clients. · Local—Local 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: · IDLE—Displayed in initial state. · PTKSTART—Displayed when the 4–way handshake is initialized. · PTKNEGOTIATING—Displayed after sending valid message 3. · PTKINITDONE—Displayed when the 4-way handshake is successful. |
Group Key State |
Display the group key state: · IDLE—Displayed in initial state. · REKEYNEGOTIATE—Displayed after the AC sends the initial message to the client. · REKEYESTABLISHED—Displayed 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): · OUT—Outbound direction. · IN—Inbound direction. · BOTH—Both 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: · Central—Central authentication. The AC authenticates clients. · Local—Local 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: · IDLE—Displayed in initializing state. · PTKSTART—Displayed when the 4–way handshake initialization is completed. · PTKNEGOTIATING—Displayed after valid message 3 is sent. · PTKINITDONE—Displayed when the 4-way handshake is successful. |
Group Key State |
Display the group key state: · IDLE—Displayed in initializing state. · REKEYNEGOTIATE—Displayed after the AC sends the initial message to the client. · REKEYESTABLISHED—Displayed 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: · Local—The AP performs data forwarding. · Remote—The AC performs data forwarding. |
Classifier ACL IPv6 Number |
Forwarding mode of IPv6 packets: · Local—The AP performs data forwarding. · Remote—The 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
--------------------------------------------------------------------------
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: · Central—Central authentication. The AC authenticates clients. · Local—Local authentication. The AP authenticates clients. · Backup—Backup 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: · HEX—Hexadecimal string. · ASCII—ASCII 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. · Optional—PMF is enabled. All clients can be associated with the AP. · Mandatory—PMF 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: · Idle—Idle. · J—Join. · JA—Join acknowledge. · IL—The AP is downloading the version. · C—Configuration 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. · R—The 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. · KU—Key update. · KC—Key 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: · ImageDownload—The 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. · Idle—The 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. · Run—The AP is operating. The AP has connected to the AC successfully. · Config—The 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: · Normal—The AP was powered off. · Crash—The AP crashed and the information is needed for analysis. · Tunnel Initiated—The reset wlan ap command is executed on the AC (the Tunnel Down Reason is displayed as Reset AP). · Tunnel Link Failure—The 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 Expire—The AC does not receive an Echo request from the AP within three times the handshake interval. · Response Timer Expire—The AC sends a control packet to the AP but does not receive any response within the specified waiting time. · Reset AP—The AP is rebooted by the execution of a command on the AC. · AP Config Change—The corresponding configurations are modified on the AC. · No Reason—Other 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 |
· Enabled—Only 802.11n clients can be associated with the AP. · Disabled—802.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. · SCN—The 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