No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

Command Reference

S7700 and S9700 V200R011C10

This document describes all the configuration commands of the device, including the command function, syntax, parameters, views, default level, usage guidelines, examples, and related commands.
Rate and give feedback:
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
WLAN Service Configuration Commands

WLAN Service Configuration Commands

Command Support

Only the X series interface cards of S7700 and S9700 support WLAN-AC commands.

ac sysnetid

Function

The ac sysnetid command configures an NE name for an AC.

The undo ac sysnetid command deletes the NE name of an AC.

By default, no NE name is configured for an AC.

Format

ac sysnetid ac-sysnetid

undo ac sysnetid

Parameters

Parameter

Description

Value

ac-sysnetid

Specifies the NE name of an AC.

The value is a string of 1 to 32 case-sensitive characters. The value beginning and ending with double double quotation marks (" ") can contain spaces. The value can contain digits, letters, and special characters such as the asterisk (*) and number sign (#).

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The administrator can run the ac sysnetid command to configure a unique NE name for an AC. This facilitates AC management.

Configuration Impact

If you run the ac sysnetid command multiple times, only the latest configuration takes effect.

Example

# Set the NE name of an AC to ABC123.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ac sysnetid ABC123

access-user syslog-restrain enable

Function

The access-user syslog-restrain enable command enables system log suppression.

The undo access-user syslog-restrain enable command disables system log suppression.

By default, system log suppression is enabled.

Format

access-user syslog-restrain enable

undo access-user syslog-restrain enable

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

After a STA passes authentication or successfully associates with the AP, the AP sends system logs to the NMS server. A system log contains MAC addresses of the STA, AC, and AP, AP and AC name and current time, and authentication result.

If a STA fails to associate with an AP or fails authentication, the STA attempts to go online continuously. The AP sends a large number of duplicate logs to the AC in a short period, which wastes resources and deteriorates system performance. To prevent this problem, enable system log suppression.

Example

# Enable system log suppression.

<HUAWEI> system-view
[HUAWEI] access-user syslog-restrain enable

access-user syslog-restrain period

Function

The access-user syslog-restrain period command sets the period of system log suppression.

The undo access-user syslog-restrain period command restores the default period of system log suppression.

By default, the period of system log suppression is 300s.

Format

access-user syslog-restrain period period

undo access-user syslog-restrain period

Parameters

Parameter

Description

Value

period

Specifies the period of system log suppression.

The value is an integer that ranges from 60 to 604800, in seconds.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

When a STA is authenticated or successfully associates with an AP, the AP sends system logs to the NMS server. A system log contains MAC addresses of the STA, AP, and AC, AP name and current time, AC name and current time, and authentication result.

A STA retries continuously after it fails to associate with an AP or pass the authentication. When this occurs, the AC sends a large number of logs in a short time. This results in a high statistics failure rate and degrades the NMS performance. The system log suppression function reduces impact of such logs on the NMS. After the period of system log suppression is set, the AC will send only one system log to the NMS server during the suppression period, reducing the load on the server.

Example

# Set the period of system log suppression to 600s.

<HUAWEI> system-view
[HUAWEI] access-user syslog-restrain period 600

ac-list (AP view)

Function

The ac-list command configures an AC IPv4 address list for APs.

The undo ac-list command restores the AC IPv4 address list to the default value.

By default, no AC IPv4 address list is configured.

Format

ac-list ipv4-address &<1-4>

undo ac-list

Parameters

Parameter Description Value
ipv4-address Specifies the IPv4 address of an AC.

The value is in dotted decimal notation.

Views

AP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run this command to configure an AC IPv4 address list for APs. After this list is configured, the APs can unicast a Discovery Request packet to discover an AC when they go online using IPv4 addresses.

Precautions

After the configuration is delivered, restart the APs to make the configuration take effect.

Example

# Set the AC's IPv4 address to 192.168.10.1 in the AP provisioning view.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ap-id 0
[HUAWEI-wlan-ap-0] ac-list 192.168.10.1
Warning: The incorrect configuration will cause the AP to go out of management. This operation will deliver parameter setting and ma
y cause reboot of AP(s). Continue?[Y/N]:y

ac-list(AP provisioning view)

Function

The ac-list command configures an AC IPv4 address list for APs.

The undo ac-list command restores the AC IPv4 address list to the default value.

By default, no AC IPv4 address list is configured.

Format

ac-list ipv4-address &<1-4>

undo ac-list

Parameters

Parameter Description Value
ipv4-address Specifies the IPv4 address of an AC.

The value is in dotted decimal notation.

Views

AP provisioning view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run this command to configure an AC IPv4 address list for APs. After this list is configured, the APs can unicast a Discovery Request packet to discover an AC when they go online using IPv4 addresses.

Follow-up Procedure

Run the commit command to deliver configuration to APs and restart the APs to make the configuration take effect.

Example

# Set the AC's IPv4 address to 192.168.10.1 in AP provisioning view.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] provision-ap
[HUAWEI-wlan-provision-ap] ac-list 192.168.10.1

active-dull-client enable

Function

The active-dull-client enable command enables the function of preventing terminals from entering energy-saving mode.

The undo active-dull-client enable command disables the function.

By default, the function of preventing terminals from entering energy-saving mode is disabled.

Format

active-dull-client enable

undo active-dull-client enable

Parameters

None

Views

SSID profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Due to individual reasons, some terminals may not run services normally when entering energy-saving mode. You can run the active-dull-client enable command to enable the function of preventing terminals from entering energy-saving mode. After that, an AP frequently sends null data frames to these terminals to prevent them from entering energy-saving mode, ensuring normal services.

Precautions

After the function is enabled, the terminals consume more power and extra bandwidth. If no terminal enters an abnormal energy-saving state, you are advised to disable the function.

Example

# Enable the function of preventing terminals from entering energy-saving mode.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ssid-profile name ssid1
[HUAWEI-wlan-ssid-prof-ssid1] active-dull-client enable
Related Topics

address-mode (AP view)

Function

The address-mode command sets the mode in which an AP obtains an IP address.

The undo address-mode command restores the default mode in which an AP obtains an IP address.

By default, the mode in which an AP obtains an IP address is not configured.

Format

address-mode { dhcp | static }

undo address-mode

Parameters

Parameter Description Value
dhcp Indicates that an IP address is obtained in DHCP mode. The AP functions as a DHCP client and is assigned an IP address by the DHCP server. -
static Indicates that a static IP address is obtained. The AP must be configured with a static IP address. -

Views

AP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the address-mode command to configure an AP to obtain an IP address in DHCP, static, or SLAAC mode.

Precautions

After the configuration is delivered, restart the APs to make the configuration take effect.

Example

# Configure an AP to obtain an IP address in DHCP mode.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ap-id 0
[HUAWEI-wlan-ap-0] address-mode dhcp
Warning: The incorrect configuration will cause the AP to go out of management. This operation will deliver parameter setting and ma
y cause reboot of AP(s). Continue?[Y/N]:y

address-mode (AP provisioning view)

Function

The address-mode command sets the mode in which an AP obtains an IP address.

The undo address-mode command restores the default mode in which an AP obtains an IP address.

By default, the mode in which an AP obtains an IP address is not configured.

Format

address-mode { dhcp | static }

undo address-mode

Parameters

Parameter Description Value
dhcp Indicates that an IP address is obtained in DHCP mode. The AP functions as a DHCP client and is assigned an IP address by the DHCP server. -
static Indicates that a static IP address is obtained. The AP must be configured with a static IP address. -

Views

AP provisioning view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the address-mode command to configure an AP to obtain an IP address in DHCP, static mode.

Follow-up Procedure

Run the commit command to deliver configuration to APs and restart the APs to make the configuration take effect.

Example

# Configure an AP to obtain an IP address in DHCP mode.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] provision-ap
[HUAWEI-wlan-provision-ap] address-mode dhcp

agile-antenna-polarization

Function

The agile-antenna-polarization enable command enables self-adaptive polarization for agile antennas.

The undo agile-antenna-polarization enable command disables self-adaptive polarization for agile antennas.

By default, self-adaptive polarization is disabled for agile antennas.
NOTE:
Only the AP8130DN and AP8130DN-W support this function.

Format

agile-antenna-polarization enable

undo agile-antenna-polarization enable

Parameters

None

Views

2G radio profile view, 5G radio profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Self-adaptive polarization for agile antennas can reduce interference between transmit signals of antennas, and increase the transmit power of antennas and the demodulation SNR of STAs. When an AP8130DN or AP8130DN-W is deployed to provide wireless coverage, you can enable this function when the following types of STA exist:
  • STA with one transmit antenna and one receive antenna in 1x1 mode
  • STA with two transmit antennas and two receive antennas in 2x2 mode
After this function is enabled, the AP uses two mutually orthogonal antennas to communicate with STAs but not a third antenna.

Prerequisites

Dual-polarized antennas have been connected to radio ports A and B on the same frequency band.

Example

# Enable self-adaptive polarization for agile antennas in a 2G radio profile.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] radio-2g-profile name default
[HUAWEI-wlan-radio-2g-prof-default] agile-antenna-polarization enable

alarm-restriction disable

Function

The alarm-restriction disable command disables alarm suppression for an AP.

The undo alarm-restriction disable command enables alarm suppression for an AP.

By default, alarm suppression is enabled for an AP.

Format

alarm-restriction disable

undo alarm-restriction disable

Parameters

None

Views

AP system profile view

Default Level

2: Configuration level

Usage Guidelines

If a STA cannot go online due to security type mismatch, UAC, or access user upper limit exceeding, the STA will automatically re-connect to the AP. During this period, the AP sends a large number of STA association failure alarms to the AC, which degrades the system performance.

To solve this problem, enable alarm suppression for the AP. The AP then does not report alarms repeatedly in the alarm suppression period, preventing alarm storms.

Example

# Disable alarm suppression for an AP.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-system-profile name ap-system1
[HUAWEI-wlan-ap-system-prof-ap-system1] alarm-restriction disable

alarm-restriction period

Function

The alarm-restriction period command configures the period of alarm suppression on an AP.

The undo alarm-restriction period command restores the default period of alarm suppression for an AP.

The default alarm suppression period is 60 seconds on an AP.

Format

alarm-restriction period period

undo alarm-restriction period

Parameters

Parameter Description Value

period

Specifies the period of alarm suppression for an AP. The value is an integer that ranges from 10 to 300, in seconds.

Views

AP system profile view

Default Level

2: Configuration level

Usage Guidelines

You can run the ap alarm-restriction period command to configure the period of alarm suppression for an AP. The AP reports an alarm only one time in the specified period if the alarm is repeatedly generated.

Example

# Set the period of alarm suppression to 200 seconds for an AP.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ap-system-profile name ap-system1
[HUAWEI-wlan-ap-system-prof-ap-system1] alarm-restriction period 200

antenna-gain

Function

(AP group radio view) The antenna-gain command configures the antenna gain for all specified radios in an AP group.

(AP group radio view) The undo antenna-gain command restores the default antenna gain for all specified radios in an AP group.

(AP radio view) The antenna-gain command configures the antenna gain for an AP radio.

(AP radio view) The undo antenna-gain command cancels the configuration of the antenna gain on an AP radio. The antenna gain on the AP radio is then determined by that configured in the AP group radio view.

By default, no antenna gain is configured for AP radios.

The antenna gain of AP radios depends on AP types and working channels of AP radios. You can run the display ap-type { id type-id | type ap-type } command to check default antenna gains of radios of different AP types.

Format

antenna-gain antenna-gain

undo antenna-gain

Parameters

Parameter

Description

Value

antenna-gain

Specifies the antenna gain.

The value is an integer that ranges from 0 to 30, in dB.

Views

AP radio view, AP group radio view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The antenna gain is the ratio of the power density produced by an antenna to the power density that should be obtained at the same point if the power accepted by the antenna were radiated equally. It can measure the capability for an antenna to receive and send signals in a specified direction, which is one of the most important parameters to select a BTS antenna. In the same condition, if the antenna gain is high, the wave travels far.

Precautions

  • The antenna gain of an AP radio configured using the command must be consistent with the gain of the antenna connected to the AP.

  • The antenna gain of an AP radio configured using the command takes effect only for external antennas. When an AP uses an external antenna, configure the antenna gain for the AP radio to be consistent with the gain of the external antenna connected to the AP.

  • The maximum antenna gain should comply with laws and regulations of the corresponding country. For details, see the Country Code & Channel Compliance Table. You can obtain this table at Huawei technical support website.

  • The configuration in the AP radio view has a higher priority than that in the AP group radio view.

  • When the antenna gain of an AP is not an integer, the AC rounds the value off and delivers the integer antenna gain. For example, if the 5G antenna gain of an AP2010DN is 2.5 dB, the 5G antenna gain of 3 dB is displayed on the AC.

Example

# Set the antenna gain to 4 for radio 0 of AP 1.
<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-id 1
[HUAWEI-wlan-ap-1] radio 0
[HUAWEI-wlan-radio-1/0] antenna-gain 4

ap auth-mode

Function

The ap auth-mode command configures the AP authentication mode.

The undo ap auth-mode command restores the default AP authentication mode.

The default AP authentication mode is MAC address authentication.

Format

ap auth-mode { mac-auth | no-auth | sn-auth }

undo ap auth-mode

Parameters

Parameter

Description

Value

mac-auth

Indicates the MAC address authentication mode.

-

no-auth

Indicates the non-authentication mode.

-

sn-auth

Indicates the SN authentication mode.

-

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

After the ap auth-mode command is executed, the AC authenticates the AP using the configured mode.

NOTE:

The non-authentication mode brings security risks. You are advised to set the authentication mode to MAC address authentication or SN authentication, which is more secure.

Example

# Change the AP authentication mode to MAC address authentication.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ap auth-mode mac-auth

ap blacklist

Function

The ap blacklist command adds an AP to an AP blacklist.

The undo ap blacklist command deletes an AP from an AP blacklist.

By default, no AP is in an AP blacklist.

Format

ap blacklist mac ap-mac1 [ to ap-mac2 ]

undo ap blacklist mac ap-mac1 [ to ap-mac2 ]

Parameters

Parameter

Description

Value

mac ap-mac1

Specifies the AP MAC address.

The value is in H-H-H format. An H is a hexadecimal number of 4 digits.

to ap-mac2

Specifies the end MAC address. This parameter is used when you want to add multiple MAC addresses to the blacklist. The value must be larger than ap-mac1. ap-mac1 and ap-mac2 identify a range.

The maximum number of MAC addresses that can be added to the blacklist in batches is 128.

The value is in H-H-H format. An H is a hexadecimal number of 4 digits.

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the AP's MAC address is in the blacklist, the AP cannot go online. If the MAC address of an online AP is in the blacklist, the AP is forced to log out.

Precautions

The AP blacklist and whitelist can be configured at the same time. However, the MAC address of an AP cannot be added to the AP blacklist and whitelist at the same time.

If AP whitelist and blacklist are all configured, check whether an AP is on the blacklist first.

Example

# Add the AP with the MAC address of 0025-9e07-8280 to the AP blacklist.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ap blacklist mac 0025-9e07-8280

# Add MAC addresses from 0025-9e07-8270 to 0025-9e07-8276 to the AP blacklist.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ap blacklist mac 0025-9e07-8270 to 0025-9e07-8276

ap data-collection enable

Function

The ap data-collection enable command enables an AC to buffer AP data.

The undo ap data-collection enable command restores the default settings.

By default, an AC is disabled from buffering AP data.

Format

ap data-collection enable

undo ap data-collection enable

Parameters

None

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

The AC needs to query performance statistics (such as AP and radio performance statistics, and STA association information on APs) from APs. The ap data-collection enable command can enable an AC to periodically query data on APs and buffer obtained data. Upon next data query, the AC can directly search for data in the buffer but does not need to wait for APs to return data. This greatly reduces timeout for querying AP-related statistics.

If there are a large number of APs and users on the AC, this function may occupy many memory resources and affect performance. Therefore, you are advised to disable this function when statistics query is not required.

After the undo ap data-collection enable command is executed, the AC stops periodically obtaining data from APs. Historical data in the buffer is not updated. To query latest statistics, enable this function again.

Example

# Enable an AC to buffer AP data.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap data-collection enable

ap data-collection interval

Function

The ap data-collection interval command sets the data buffer duration.

The undo ap data-collection interval command restores the default data buffer duration.

By default, an AC buffers AP data for 5 minutes.

Format

ap data-collection interval interval

undo ap data-collection interval

Parameters

Parameter

Description

Value

interval

Specifies the buffer duration.

The value is an integer that ranges from 5 to 60, in minutes.

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

You can run the ap data-collection interval command to set the buffer duration.

Example

# Enable an AC to buffer AP data and set the buffer duration.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap data-collection enable
[HUAWEI-wlan-view] ap data-collection interval 57

ap lldp enable

Function

The ap lldp enable command enables LLDP in the WLAN view.

The undo ap lldp enable command disables LLDP in the WLAN view.

By default, LLDP is enabled in the WLAN view.

Format

ap lldp enable

undo ap lldp enable

Parameters

None

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The Link Layer Discovery Protocol (LLDP) is a Layer 2 discovery protocol defined in the IEEE 802.1ab standard. Using LLDP, the AC or NMS can obtain Layer 2 information about the connected APs, including APs' interfaces and connections with other devices. Additionally, the AC or NMS can obtain details about network topology and interface changes. To view the Layer 2 link status between APs, and between APs and switch or analyze the network topology, enable WLAN LLDP.

Precautions

WLAN LLDP can be enabled in the system view and the AP wired port link profile view.

  • An AP can send and receive LLDP packets only after LLDP is enabled in both the WLAN view and the AP wired port link profile view.
  • After LLDP is disabled in the WLAN view, the commands for enabling and disabling LLDP on the AP wired port link profile view do not take effect.

Example

# Enable LLDP in the WLAN view.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap lldp enable

ap manufacturer-config

Function

The ap manufacturer-config command restores the factory settings of APs.

Format

ap manufacturer-config { ap-name ap-name | ap-mac ap-mac | ap-id ap-id }

Parameters

Parameter

Description

Value

ap-name ap-name

Specifies the name of the AP, factory settings of which need to be restored.

The AP name must already exist.

ap-mac ap-mac

Specifies the MAC address of the AP, factory settings of which need to be restored.

The AP's MAC address must already exist.

ap-id ap-id

Specifies the ID of the AP, factory settings of which need to be restored.

The AP ID must already exist.

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

When a configuration error occurs on the AP, you can run this command to clear AP configurations.

After restoring factory settings, the AP is reset and configurations are restored to factory settings.

Example

# Restore the factory settings of AP N1-2.
<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap manufacturer-config ap-name N1-2
Warning: Reset AP to the manufacturing default configuration, continue?[Y/N]:y

ap modify

Function

The ap modify command changes the MAC address of an AP.

Format

ap modify ap-id mac ap-mac

Parameters

Parameter

Description

Value

ap-id

Specifies the ID of the AP to be replaced.

The AP ID must exist.

mac ap-mac

Specifies the MAC address of a new AP.

The value is in H-H-H format. An H is a hexadecimal number of 4 digits.

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When AP hardware needs to be replaced, you can change the MAC address of the AP to that of a new AP to prevent repetitive data configurations. After the change, the new AP goes online using the ID of the original AP, and all data configurations of the original AP take effect on the new AP.

By default, you can run the display ap { all | ap-group ap-group } command to check the MAC address of an AP.

Precautions

Replacing an AP enables the new AP to go online on the AC but will interrupt services of the original AP.

Example

# Replace the AP with the ID 0 with the AP with the MAC address 0002-1110-0120.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ap modify 0 mac 0002-1110-0120 
Warning: Modify AP will influence the service that has published in AP, Whether to continue? [Y/N]y
Related Topics

ap update ftp-server

Function

The ap update ftp-server command configures basic FTP information, including the FTP server IP address, FTP server user name and password.

The undo ap update ftp-server command restores default FTP settings.

By default, no FTP server IP address is configured, the FTP server user name is anonymous, the FTP server password is anonymous@huawei.com.

Format

ap update ftp-server ip-address server-ip-address ftp-username ftp-username ftp-password cipher ftp-password

undo ap update ftp-server

Parameters

Parameter

Description

Value

ip-address server-ip-address

Specifies an IPv4 address for the FTP server.

The value is in dotted decimal notation.

ftp-username ftp-username

Specifies the FTP server user name.

The value is a string of 1 to 31 characters. The value cannot contain question marks (?) and cannot start or end with double quotation marks (" ") or spaces.

ftp-password

Specifies the password for logging in to the FTP server.

-

cipher

Specifies the password in cipher text.

-

ftp-password

Specifies the FTP server password.

The value is a string of characters without question marks (?). It cannot start or end with double quotation marks (" ") or spaces. ftp-password contains 188 characters in cipher text, such as %^%#A<g;&zQR7P3TF+,[MxQ1X%4[2~Gb]Vp#(e<y:~)/%^%#. ftp-password also can be a string of 1 to 128 characters in plain text, such as huawei123.

Views

WLAN view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

  • The FTP configuration is used when the automatic upgrade and online upgrade modes are FTP. In the automatic upgrade or online upgrade, the AC sends basic FTP information to the AP, and the AP requests the FTP server for upgrade based on FTP information.
  • After running the ap update ftp-server command, you can perform the following operations:
    1. Run the ap update mode command to set the upgrade mode to ftp-mode.
    2. Run the ap update multi-load command to upgrade APs in batches.

Precautions

  • It is recommended that you use an external FTP server to upgrade APs. If the AC functions as the FTP server, a maximum of five APs can be upgraded simultaneously.

  • The FTP server user name cannot contain the double quotation marks ("). Ensure that the FTP server user name and unencrypted password configured on the AC do not contain the preceding characters. Otherwise, FTP upgrade fails.

Example

# Configure the FTP server IP address, FTP server user name and password.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap update ftp-server ip-address 192.168.1.100 ftp-username admin ftp-password cipher wlanadmin

ap update ftp-server max-connect-number

Function

The ap update ftp-server command configures the maximum number of APs that can be upgraded simultaneously in FTP mode.

The undo ap update ftp-server command restores the default maximum number of APs that can be upgraded simultaneously in FTP mode.

By default, a maximum of 50 APs can be upgraded simultaneously in FTP mode.

Format

ap update ftp-server max-connect-number max-connect-number

undo ap update ftp-server max-connect-number

Parameters

Parameter

Description

Value

max-connect-number

Specifies the maximum number of APs that can be upgraded simultaneously.

The value is an integer that ranges from 1 to 64.

Views

WLAN view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

When APs are upgraded in FTP mode, you can configure the value of max-connect-number to change the maximum number of APs that can be upgraded simultaneously.
  • If the number of APs to be upgraded is equal to or smaller than max-connect-number, all APs can be upgraded simultaneously.

  • If the number of APs to be upgraded is larger than max-connect-number, only the specified number of APs can be upgraded simultaneously. After the specified number of APs are upgraded, the remaining APs are upgraded automatically until all APs are upgraded. The number of APs that are upgraded at a time cannot exceed the value of max-connect-number.

Precautions

An external FTP server can be used, which is recommended. The AC can also function as the FTP server.
  • When an external FTP server is used, the maximum number of APs that can be upgraded simultaneously is the configured max-connect-number.
  • If an AC is used as the FTP server, a maximum of five APs can be upgraded simultaneously even if the specified number is larger than five.

    When the AC functions as the FTP server, run the ap update ftp-server max-connect-number max-connect-number command to set the maximum number of APs that can be upgraded simultaneously. The value of max-connect-number is an integer ranging from 1 to 5. During the upgrade, a maximum of 1 to 5 APs can be upgraded at a time until all APs are upgraded.

    If the configured number of APs to be upgraded simultaneously is larger than five, an error message will be displayed after the first five APs are upgraded. The remaining APs cannot be automatically upgraded. You have to repeat the command until all APs are upgraded.

Example

# Set the maximum number of APs that can be upgraded simultaneously in FTP mode to 10.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap update ftp-server max-connect-number 10

ap update load

Function

The ap update load command upgrades a specified AP.

The undo ap update load command cancels AP upgrade.

Format

ap update load { ap-name ap-name | ap-mac ap-mac | ap-id ap-id } update-filename update-file-name

undo ap update load { ap-name ap-name | ap-mac ap-mac | ap-id ap-id }

Parameters

Parameter

Description

Value

ap-name ap-name

Specifies the name of the AP to be upgraded.

The AP name must already exist.

ap-mac ap-mac

Specifies the MAC address of the AP to be upgraded.

The AP's MAC address must already exist.

ap-id ap-id

Specifies the ID of the AP to be upgraded.

The AP ID must already exist.

update-filename update-file-name

Specifies the AP upgrade file.

The upgrade file name must already exist.

Views

WLAN view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

When APs are upgraded in batches based on AP types, if the new version fails, the version rollback takes a long period. Therefore, you can update a single AP to check whether faults occur on the version, ensuring successful upgrades in batches.

Prerequisites

When the AC mode is used, the AP upgrade file has been uploaded to the AC. If the FTP or SFTP mode is used, the AP upgrade file has been uploaded to the FTP server or SFTP server.

The AP is in normal or vmiss state.

Follow-up Procedure

Run the ap update reset { ap-name ap-name | ap-mac ap-mac | ap-id ap-id } command to restart the AP to make the upgrade take effect.

Precautions

The undo ap update load { ap-name ap-name | ap-mac ap-mac | ap-id ap-id } command cancels AP upgrade. However, if the AP system software has been written to the flash memory during the upgrade, the command does not take effect. You can run the display ap update status { ap-name ap-name | ap-id ap-id } command to check AP upgrade progress.

Example

# Upgrade the AP N1-2 using the upgrade file fitap6x10xn_v200r007c10.bin.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap update load ap-name N1-2 update-filename fitap6x10xn_v200r007c10.bin
Info: The current upgrade mode is AC mode, which may affect performance and take a long time. The FTP or SFTP upgrade mode is recomm
ended. Continue? [Y/N]:y

ap update mode

Function

The ap update mode command configures the AP upgrade mode.

The undo ap update mode command restores the default AP upgrade mode.

The default upgrade mode is ac-mode.

Format

ap update mode { ftp-mode | ac-mode | sftp-mode }

undo ap update mode

Parameters

Parameter

Description

Value

ac-mode

Indicates the AP upgrade mode in which APs download upgrade versions from the AC.

-

ftp-mode

Indicates the FTP mode. The AC delivers the FTP configuration to APs using the ap update ftp-server command, and APs download the upgrade version file from the FTP server.

-

sftp-mode

Indicates the SFTP mode. The AC delivers the SFTP configuration to APs using the ap update sftp-server command, and APs download the upgrade version file from the SFTP server.

-

Views

WLAN view

Default Level

3: Management level

Usage Guidelines

  • The AC, FTP or SFTP upgrade mode must be preset on the AP for automatic upgrade and online upgrade.
  • Run the ap update multi-load command to upgrade the AP.

Example

# Set the AP upgrade mode to sftp-mode.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap update mode sftp-mode

ap update multi-load

Function

The ap update multi-load command upgrades APs of the same type in batches.

The undo ap update multi-load command cancels batch upgrade of APs with the same type.

Format

ap update multi-load ap-type type-id [ ap-group group-name | { ap-name ap-name | ap-id ap-id } &<1-10> ]

ap update multi-load ap-group group-name [ { ap-name ap-name } &<1-10> | { ap-id ap-id } &<1-10> ]

undo ap update multi-load ap-type type-id [ ap-group group-name | { ap-name ap-name | ap-id ap-id } &<1-10> ]

undo ap update multi-load ap-group group-name [ { ap-name ap-name } &<1-10> | { ap-id ap-id } &<1-10> ]

Parameters

Parameter

Description

Value

ap-type type-id

Specifies the AP type ID.

The value is an integer that ranges from 0 to 255.

ap-group group-name

Specifies an AP group.

The AP group must exist.

ap-name ap-name

Specifies an AP name.

The AP name must exist.

ap-id ap-id

Specifies an AP ID.

The AP ID must exist.

Views

WLAN view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

You can run the ap update multi-load ap-type type-id [ ap-group group-name | { ap-name ap-name | ap-id ap-id } &<1-10> ] command to upgrade APs of the same type in batches in the online upgrade mode.
  • If ap-group group-name is specified, only APs of the same type and in the specified AP group are upgraded.
  • If ap-name ap-name or ap-id ap-id is specified, only APs of the specified type and with the specified AP name or AP ID are upgraded
  • If none of the ap-group group-name, ap-name ap-name, and ap-id ap-id parameters are specified, all APs of the specified type are upgraded.
  • If the type of APs specified by ap-group group-name, ap-name ap-name, or ap-id ap-id is different from ap-type type-id, the APs cannot be upgraded.
You can run the ap update multi-load ap-group group-name [ { ap-name ap-name } &<1-10> | { ap-id ap-id } &<1-10> ] command to batch upgrade APs in the specified AP group online.
  • If ap-name ap-name or ap-id ap-id is specified, only APs with the specified name or ID in the specified AP group are upgraded.

  • If neither ap-name ap-name nor ap-id ap-id is specified, all APs in the specified AP group are upgraded.

  • If APs specified by ap-name ap-name and ap-id ap-id are in different AP groups, the APs cannot be upgraded.

Prerequisites

AP upgrade files have been configured in batches using the ap update update-filename command.

Follow-up Procedure

Run the ap update multi-reset command to reset APs in batches to make AP upgrade take effect.

Precautions

The undo ap update multi-load ap-type type-id command cancels batch upgrade of APs with the same type. However, if the AP system software has been written to the flash memory during the upgrade, the command does not take effect. You can run the display ap update status all command to check AP upgrade progress.

Example

# Upgrade APs with type-id 19 in batches online.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap update multi-load ap-type 19
Info: The current upgrade mode is AC mode, which may affect performance and take a long time. The FTP or SFTP upgrade mode is recomm
ended. Continue? [Y/N]:y
# Upgrade all APs in AP group ap-group1 in batches online.
<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap update multi-load ap-group ap-group1
Info: The current upgrade mode is AC mode, which may affect performance and take a long time. The FTP or SFTP upgrade mode is recomm
ended. Continue? [Y/N]:y

ap update multi-reset

Function

The ap update multi-reset command resets APs in batches.

Format

ap update multi-reset ap-type type-id [ ap-group group-name | { ap-name ap-name | ap-id ap-id } &<1-10> ]

ap update multi-reset ap-group group-name [ { ap-name ap-name } &<1-10> | { ap-id ap-id } &<1-10> ]

Parameters

Parameter

Description

Value

ap-type type-id

Resets APs of the specified type ID.

The AP type ID must exist.

ap-group group-name

Resets APs in the specified AP group.

The AP group must exist.

ap-name ap-name

Resets APs with the specified AP name.

The AP name must exist.

ap-id ap-id

Resets APs with the specified AP ID.

The AP ID must exist.

Views

WLAN view

Default Level

3: Management level

Usage Guidelines

This command resets APs in batches and can be used only after APs are upgraded in batches.

ap update multi-reset ap-type type-id [ ap-group group-name | { ap-name ap-name | ap-id ap-id } &<1-10> ] command to batch reset APs of the specified type online.
  • If ap-group group-name is specified, only APs of the specified type and in the specified AP group are reset.
  • If ap-name ap-name or ap-id ap-id is specified, only APs of the specified type and with the specified AP name or ID are reset.
  • If none of the ap-group group-name, ap-name ap-name, or ap-id ap-id parameters are specified, all APs of the specified type are reset.
  • If the type of APs specified by ap-group group-name, ap-name ap-name, or ap-id ap-id is different from ap-type type-id, the APs cannot be reset.
You can run the ap update multi-reset ap-group group-name [ { ap-name ap-name } &<1-10> | { ap-id ap-id } &<1-10> ] command to batch reset APs in the specified AP group online.
  • If ap-name ap-name or ap-id ap-id is specified, only APs with the specified name or ID in the specified AP group are reset.

  • If neither ap-name ap-name nor ap-id ap-id is specified, all APs in the specified AP group are ureset.

  • If APs specified by ap-name ap-name and ap-id ap-id are in different AP groups, the APs cannot be reset.

Example

# Reset APs with type-id 19 in batches.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap update multi-reset ap-type 19

ap update reset

Function

The ap update reset command restarts a specified AP.

Format

ap update reset { ap-name ap-name | ap-mac ap-mac | ap-id ap-id }

Parameters

Parameter

Description

Value

ap-name ap-name

Specifies the name of the AP to be restarted.

The AP name must already exist.

ap-mac ap-mac

Specifies the MAC address of the AP to be restarted.

The AP's MAC address must already exist.

ap-id ap-id

Specifies the ID of the AP to be restarted.

The AP ID must already exist.

Views

WLAN view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

After a single AP has been upgraded, run the ap update reset command to restart the AP and make the AP upgrade take effect.

Prerequisites

The AP is in normal or vmiss state.

The specified AP has been upgraded using the ap update load { ap-name ap-name | ap-mac ap-mac | ap-id ap-id } update-filename update-file-name command.

Example

# Restart AP N1-2 after the upgrade.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap update load ap-name N1-2 update-filename huawei.bin
[HUAWEI-wlan-view] ap update reset ap-name N1-2
Related Topics

ap update sftp-server

Function

The ap update sftp-server command configures basic sftp information, including the sftp server IP address, sftp server user name and password.

The undo ap update sftp-server command restores default sftp settings.

By default, no SFTP server IP address is configured, the SFTP server user name is anonymous, the SFTP server password is anonymous@huawei.com.

Format

ap update sftp-server ip-address server-ip-address sftp-username sftp-username sftp-password cipher sftp-password

undo ap update sftp-server

Parameters

Parameter

Description

Value

ip-address server-ip-address

Specifies an IPv4 address for the sftp server.

The value is in dotted decimal notation.

sftp-username sftp-username

Specifies the sftp server user name.

The value is a string of 1 to 31 characters. The value cannot contain question marks (?) and cannot start or end with double quotation marks (" ") or spaces.

sftp-password

Specifies the password for logging in to the sftp server.

-

cipher

Specifies the password in cipher text.

-

sftp-password

Specifies the sftp server password.

The value is a string of characters without question marks (?). It cannot start or end with double quotation marks (" ") or spaces. sftp-password can be up to 188 characters in cipher text, such as %^%#A<g;&zQR7P3TF+,[MxQ1X%4[2~Gb]Vp#(e<y:~)/%^%#. sftp-password also can be a string of 1 to 128 characters in plain text, such as huawei123.

Views

WLAN view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

  • The sftp configuration is used when the automatic upgrade and online upgrade modes are sftp. In the automatic upgrade or online upgrade, the AC sends basic sftp information to the AP, and the AP requests the sftp server for upgrade based on sftp information.
  • After running the ap update sftp-server command, you can perform the following operations:
    1. Run the ap update mode command to set the upgrade mode to sftp-mode.
    2. Run the ap update multi-load command to upgrade APs in batches.

Precautions

  • It is recommended that you use an external sftp server to upgrade APs. If the AC functions as the sftp server, a maximum of five APs can be upgraded simultaneously.

  • APs do not support the following characters:". Ensure that the sftp server user name and unencrypted password configured on the AC do not contain the preceding characters. Otherwise, sftp upgrade fails.

Example

# Configure the sftp server IP address, sftp server user name and password.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap update sftp-server ip-address 192.168.1.100 sftp-username admin sftp-password cipher wlanadmin

ap update sftp-server max-connect-number

Function

The ap update sftp-server command configures the maximum number of APs that can be upgraded simultaneously in SFTP mode.

The undo ap update sftp-server command restores the default maximum number of APs that can be upgraded simultaneously in SFTP mode.

By default, a maximum of 50 APs can be upgraded simultaneously in SFTP mode.

Format

ap update sftp-server max-connect-number max-connect-number

undo ap update sftp-server max-connect-number

Parameters

Parameter

Description

Value

max-connect-number

Specifies the maximum number of APs that can be upgraded simultaneously.

The value is an integer that ranges from 1 to 64.

Views

WLAN view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

When APs are upgraded in sftp mode, you can configure the value of max-connect-number to change the maximum number of APs that can be upgraded simultaneously.
  • If the number of APs to be upgraded is equal to or smaller than max-connect-number, all APs can be upgraded simultaneously.

  • If the number of APs to be upgraded is larger than max-connect-number, only the specified number of APs can be upgraded simultaneously. After the specified number of APs are upgraded, the remaining APs are upgraded automatically until all APs are upgraded. The number of APs that are upgraded at a time cannot exceed the value of max-connect-number.

Precautions

An external sftp server can be used, which is recommended. The AC can also function as the sftp server.
  • When an external sftp server is used, the maximum number of APs that can be upgraded simultaneously is the configured max-connect-number.
  • If an AC is used as the SFTP server, a maximum of five APs can be upgraded simultaneously even if the specified number is larger than five.

    When the AC functions as the SFTP server, run the ap update sftp-server max-connect-number max-connect-number command to set the maximum number of APs that can be upgraded simultaneously. The value of max-connect-number is an integer ranging from 1 to 5. During the upgrade, a maximum of 1 to 5 APs can be upgraded at a time until all APs are upgraded.

    If max-connect-number is set larger than 5, an error message will be displayed after the first five APs are upgraded. The remaining APs cannot be automatically upgraded. You have to repeat the command until all APs are upgraded.

Example

# Set the maximum number of APs that can be upgraded simultaneously in SFTP mode to 10.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap update sftp-server max-connect-number 10

ap update update-filename

Function

The ap update update-filename command configures the upgrade file name for APs of a specified type.

The undo ap update update-filename command deletes the upgrade file name for APs of a specified type.

Format

ap update update-filename filename ap-type type-id [ ap-group ap-group-name ]

undo ap update update-filename ap-type type-id [ ap-group ap-group-name ]

Parameters

Parameter

Description

Value

ap-type type-id

Specifies the AP type ID.

The value is an integer that ranges from 0 to 255.

filename

Specifies the AP upgrade file name.

The value is a string of 1 to 255 case-sensitive characters. Ensure that the file name is the same as the actual upgrade file name and has the extension .bin.

ap-group ap-group-name

Specifies an AP group.

The AP group must already exist.

Views

WLAN view

Default Level

3: Management level

Usage Guidelines

If you specify ap-group ap-group-name, the command configures the upgrade file name only for APs of the specified type and in the specified group.

Run the ap update multi-load ap-type command to upgrade APs of the same type in batches.

Example

# Set the upgrade file name for APs with the type ID 19 to fitap6x10xn_v200r007c10.bin.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap update update-filename fitap6x10xn_v200r007c10.bin ap-type 19
Warning: If an AP is performing the automatic upgrade, the AP will be upgraded to the latest version. Continue?[Y/N]:y
Warning: If AP update mode is AC-mode, update-file's default path is flash:/. Continue?[Y/N]:y
Related Topics

ap update schedule-task

Function

The ap update schedule-task command configures a scheduled AP upgrade task.

The undo ap update schedule-task command deletes a scheduled AP upgrade task.

By default, no scheduled AP upgrade task is configured.

Format

ap update schedule-task task-id task-id start-time start-time start-date stop-time stop-time stop-date ap-type type-id [ ap-group group-name | { { ap-name ap-name } &<1-10> } | { { ap-id ap-id } &<1-10> } ]

ap update schedule-task task-id task-id start-time start-time start-date stop-time stop-time stop-date ap-group group-name

undo ap update schedule-task { all | task-id task-id }

Parameters

Parameter

Description

Value

task-id task-id

Specifies the ID of a scheduled AP upgrade task.

The value is an integer that ranges from 0 to 31.

start-time start-time

Specifies the start time of the scheduled AP upgrade task.

The value is in HH:MM format, ranging from 00:00 to 23:59.

start-date

Specifies the start date of the scheduled AP upgrade task.

The value is in YYYY/MM/DD format, ranging from 2000-01-01 to 2050-12-31.

stop-time stop-time

Specifies the end time of the scheduled AP upgrade task.

The value is in HH:MM format, ranging from 00:00 to 23:59.

stop-date

Specifies the end date of the scheduled AP upgrade task.

The value is in YYYY/MM/DD format, ranging from 2000-01-01 to 2050-12-31.

stop-time stop-date must be later than start-time start-date.

ap-type type-id

Specifies an AP type ID.

The value is an integer.

To view all AP types, run the display ap-type all command.

ap-group group-name

Specifies an AP group name.

The AP group must exist.

ap-name ap-name

Specifies an AP name.

The AP name must exist.

ap-id ap-id

Specifies an AP ID.

The AP ID must exist.

Views

WLAN view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

You can configure a scheduled AP upgrade task to upgrade APs in a specified time period, such as off-peak hours.

If you specify ap-group group-name in the command, the configured task will upgrade only APs in the specified AP group. Similarly, if you specify ap-type type-id, ap-name ap-name, or ap-id ap-id, the configured task will upgrade only the specified APs.

The scheduled task configuration will not be automatically deleted after a scheduled upgrade task is completed. To delete the task, run the undo ap update schedule-task { all | task-id task-id } command.

Prerequisites

The AP upgrade file has been specified using the ap update update-filename command. To check the status of scheduled AP upgrade tasks, run the display ap update schedule-task command.

Configuration Impact

  • For scheduled AP upgrade tasks with the same start time, the task with a smaller task-id task-id is executed preferentially.

  • During the scheduled AP upgrade, if the time for task B is reached before task A is completed, task B waits until task A is completed. Subsequent scheduled AP upgrade tasks wait in sequence until the previous task is completed.

  • When the time specified by stop-time stop-time stop-date is reached, ongoing upgrade tasks continue until the upgrade is completed and those tasks waiting in queues stop.

  • After APs in a scheduled upgrade task are all upgraded, the APs automatically restart. The APs that fail the upgrade do not restart.

  • After a scheduled AP upgrade task is configured, if the AP group or all APs are deleted, the task fails to be executed, which is not recorded as upgrade failure information.

  • If an AP is performing the automatic upgrade when you configure a scheduled AP upgrade task, the upgrade continues until the upgrade is completed. APs that have not started the automatic upgrade will not execute the automatic upgrade.

Example

# Configure APs with ap-type as 54 to perform the scheduled upgrade from 01:00 to 04:00 on May 20, 2016.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap update schedule-task task-id 1 start-time 1:00 2016/5/20 stop-time 4:00 2016/5/20 ap-type 54

ap username

Function

The ap username command sets the user name and password for AP login.

The undo ap username command restores the default user name and password for AP login.

By default, the user name is admin and password is admin@huawei.com.

Format

ap username username password cipher

undo ap username

Parameters

Parameter

Description

Value

username

Specifies the user name for AP login.

The value is a string of 4-31 characters. It can contain letters, underlines, and digits. The character string must start with letters.

password

Specifies the password for AP login.

-

cipher

Indicates the cipher text password.

The password can be entered in plain or cipher text:
  • In plain text, the password is a string of 8 to 128 case-sensitive characters. It must contain at least one uppercase letter, one lowercase letter, and one digit except the question mark (?).
  • In cipher text, the password is a string of 48 to 188 characters. It must contain at least one uppercase letter, one lowercase letter, and one digit.

Views

WLAN view

Default Level

3: Management level

Usage Guidelines

Unauthorized users may use the default user name and password to log in to APs, causing security risk to APs. You can use the ap username command to change the user name and password to improve security for APs.
NOTE:

It is recommended that you change the user name and password in a timely manner to ensure device security.

The password cannot be the same as the user name or the mirror user name.

Example

# Set the user name to huawei and password to Zz123456.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ap username huawei password cipher
Enter the password (plain-text password of 8-32 characters or cipher-text passwo
rd of 48 or 68 characters):                                                     
Confirm password: 

ap whitelist

Function

The ap whitelist command adds an AP to an AP whitelist.

The undo ap whitelist command deletes an AP from an AP whitelist.

By default, no AP is in an AP whitelist.

Format

ap whitelist { mac ap-mac1 [ to ap-mac2 ] | sn ap-sn1 [ to ap-sn2 ] }

undo ap whitelist { mac ap-mac1 [ to ap-mac2 ] | sn ap-sn1 [ to ap-sn2 ] }

Parameters

Parameter

Description

Value

mac ap-mac1

Specifies the AP MAC address.

The value is in H-H-H format. An H is a hexadecimal number of four digits.

to ap-mac2

Specifies the end MAC address. This parameter is used when you want to add multiple MAC addresses to the whitelist. The value must be larger than ap-mac1. ap-mac1 and ap-mac2 identify a range.

The maximum number of MAC addresses that can be added to the whitelist in batches is 4096.

The value is in H-H-H format. An H is a hexadecimal number of four digits.

sn ap-sn1

Specifies the SN of an AP.

The value is a string of 1 to 31 characters.

to ap-sn2

Specifies the end SN. This parameter is used when you want to add multiple SNs to the whitelist. It must be larger than ap-sn1. ap-sn1 and ap-sn2 identify a range.

The maximum number of MAC addresses that can be added to the whitelist in batches is 4096.

The value is a string of 1 to 31 characters.

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

  • When the AP authentication mode is set to MAC address authentication using the ap auth-mode command, if the MAC address of an online AP exists in the whitelist, the AP is automatically added to the AC. If the MAC address of an online AP does not exist in the whitelist or the AP is not added offline, the AP cannot be automatically added to the AC. You need to run the ap-confirm command to confirm the AP.

  • When the AP authentication mode is set to SN authentication using the ap auth-mode command, if the SN of an online AP exists in the whitelist, the AP is automatically added to the AC. If the SN of an online AP does not exist in the whitelist or the AP is not added offline, the AP cannot be automatically added to the AC. You need to run the ap-confirm command to confirm the AP.

Prerequisites

The AP authentication mode has been set to MAC address or SN authentication using the ap auth-mode command.

Precautions

When adding multiple SNs to the whitelist, ensure that the start SN length and the end SN length are the same.

Example

# Add AP MAC address 0025-9e07-8280 to the whitelist.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap whitelist mac 0025-9e07-8280

# Add the MAC addresses from 0025-9e07-8270 to 0025-9e07-8290 to the AP whitelist.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap whitelist mac 0025-9e07-8270 to 0025-9e07-8290

# Add SN 08PE56430071 to the AP whitelist.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap whitelist sn 08PE56430071

# Add SNs from 08PE56430076 to 08PE56430081 to the AP whitelist.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap whitelist sn 08PE56430076 to 08PE56430081

ap-confirm

Function

The ap-confirm command confirms unauthenticated APs and allows them to go online.

Format

ap-confirm { all | mac ap-mac | sn ap-sn }

Parameters

Parameter

Description

Value

all

Confirms all APs.

-

mac ap-mac

Confirms the AP with the specified MAC address.

The value is in H-H-H format. An H is a hexadecimal number of four digits.

sn ap-sn

Confirms the AP with the specified SN.

The value is a string of 1 to 31 characters.

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

After viewing unauthenticated APs using the display ap unauthorized record command, you can run the ap-confirm command to confirm these unauthenticated APs if you want to connect them to the AC. After confirmation, the APs are allowed to go online, added to the default region, and bound to the default AP profile.

Example

# Confirm the AP with MAC 0025-9e07-8270.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-confirm mac 0025-9e07-8270

# Confirm all APs.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-confirm all

ap-group

Function

The ap-group command creates an AP group and displays the AP group view, or displays the view of an existing AP group.

The undo ap-group command deletes an AP group.

By default, the system provides the AP group default.

Format

ap-group name group-name

undo ap-group { name group-name | all }

Parameters

Parameter

Description

Value

name group-name

Specifies the name of an AP group.

The value is a string of 1 to 35 characters. It does not contain question marks (?), marks (/), or spaces, and cannot start or end with double quotation marks (" ").

all

Deletes all AP groups.

-

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you need to perform the same configuration on multiple APs, add the APs to an AP group and perform the configuration in the AP group. The configuration takes effect on all APs of the group. This prevents repetitive configuration.

Follow-up Procedure

Run the ap-group (AP view) or ap-regroup command to add APs to an AP group.

Precautions

  • If the configuration of an AP in the AP view is different from that in the AP group view, the configuration in the AP view is preferentially used.

  • The device supports a maximum of 256 AP groups.

  • The AP group that has APs cannot be deleted. The AP group default cannot be deleted either.

  • By default, an AP group has the following profiles bound: AP system profile default, 2G radio profile default, 5G radio profile default, regulatory domain profile default, WIDS profile default, and AP wired port profile default.

Example

# Create the AP group group1 and display the AP group view.
<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-group name group1
[HUAWEI-wlan-ap-group-group1] 

ap-group (AP provisioning view)

Function

The ap-group command configures an AP group.

The undo ap-group command restores the default AP group.

By default, no AP group is configured.

Format

ap-group ap-group

undo ap-group

Parameters

Parameter Description Value
ap-group Specifies the group that an AP joins. The AP group must exist.

Views

AP provisioning view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the group that an AP joins is changed, and the change is delivered to the AP, the AP automatically restarts and joins the new group.

Follow-up Procedure

Run the commit command to deliver configuration to APs and restart the APs to make the configuration take effect.

Example

# Change the group that the AP joins to group ap-new-group.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] provision-ap
[HUAWEI-wlan-provision-ap] ap-group ap-new-group

ap-group (AP view)

Function

The ap-group command configures an AP group.

The undo ap-group command restores the default AP group.

By default, no AP group is configured.

Format

ap-group ap-group

undo ap-group

Parameters

Parameter Description Value
ap-group Specifies an AP group. The AP group must exist.

Views

AP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you need to perform the same configuration on multiple APs, add the APs to an AP group and perform the configuration in the AP group. The configuration takes effect on all APs of the group. This prevents you from configuring each AP one by one.

Each AP must be added to an AP group. If no AP group is configured for an AP, the AP automatically joins the AP group default.

Example

# Configure the AP group ap-new-group for an AP.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ap-id 0
[HUAWEI-wlan-ap-0] ap-group ap-new-group
Warning: This operation may cause AP reset. If the country code changes, it will clear channel, power and antenna gain configuration
s of the radio, Whether to continue? [Y/N]:y 

ap-id

Function

The ap-id command adds an AP offline or displays the AP view.

By default, no AP is added offline.

Format

ap-id ap-id [ [ type-id type-id | ap-type ap-type ] { ap-mac ap-mac | ap-sn ap-sn | ap-mac ap-mac ap-sn ap-sn } ]

Parameters

Parameter

Description

Value

ap-id

Specifies the AP ID.

The value is an integer. The value range varies according to devices:
  • S7703 and S9703: 0 to 511
  • S7706 and S7712 (The main control unit is not SRUH/SRUE.): 0 to 1023
  • S7706 and S7712 (The main control unit is SRUH/SRUE.): 0 to 4095
  • S9706 and S9712: 0 to 2047

type-id type-id

Specifies the AP type ID.

The value is an integer that ranges from 0 to 255.

ap-type ap-type

Specifies the AP type.

The value is a string of 1 to 31 characters.

ap-mac ap-mac

Specifies the MAC address of an AP.

The value is in H-H-H format. An H is a hexadecimal number of 4 digits.

ap-sn ap-sn

Specifies the serial number (SN) of an AP.

The value is a string of 1 to 31 characters, and can only contain letters and digits.

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After an AP is successfully added to an AC, you can configure parameters for the AP offline. When the AP goes online, it uses the configured parameters.

You can run the undo ap command to delete an AP.

Precautions

To add an AP, you must enter the MAC address, SN, or MAC address+SN. In MAC address authentication mode, enter the MAC address of the AP. In SN authentication mode, enter the SN of the AP.

To enter the AP view, you only need to enter the AP ID.

Example

# Create an AP with ID 11, type ID 19, and MAC address 0025-9e07-8270.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-id 11 type-id 19 ap-mac 0025-9e07-8270
Related Topics

ap-mac

Function

The ap-mac command adds an AP offline or displays the AP view.

By default, no AP is added offline.

Format

ap-mac ap-mac [ type-id type-id | ap-type ap-type ] [ ap-id ap-id ] [ ap-sn ap-sn ]

Parameters

Parameter

Description

Value

ap-mac

Specifies the MAC address of an AP.

The value is in H-H-H format. An H is a hexadecimal number of 4 digits.

type-id type-id

Specifies the AP type ID.

The value is an integer that ranges from 0 to 255.

ap-type ap-type

Specifies the AP type.

The value is a string of 1 to 31 characters.

ap-id ap-id

Specifies the AP ID.

The value is an integer. The value range varies according to devices:
  • S7703 and S9703: 0 to 511
  • S7706 and S7712 (The main control unit is not SRUH/SRUE.): 0 to 1023
  • S7706 and S7712 (The main control unit is SRUH/SRUE.): 0 to 4095
  • S9706 and S9712: 0 to 2047

ap-sn ap-sn

Specifies the sequence number (SN) of an AP.

The value is a string of 1 to 31 characters, and can only contain letters and digits.

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After an AP is successfully added to an AC, you can configure parameters for the AP offline. When the AP goes online, it uses the configured parameters.

Precautions

When adding an AP, you need to enter the MAC address of the AP. If the AP authentication mode is SN authentication, you also need to enter the SN of the AP.

To enter the AP view, you only need to enter the MAC address of the AP. If the entered MAC address does not exist, the system adds a new AP and displays the AP view.

The ap-mac ap-mac [ type-id type-id | ap-type ap-type ] [ ap-id ap-id ] [ ap-sn ap-sn ] and ap-id ap-id [ [ type-id type-id | ap-type ap-type ] { ap-mac ap-mac | ap-sn ap-sn | ap-mac ap-mac ap-sn ap-sn } ] commands have the same function. You can use either one according to the actual situation.

Example

# Add the AP with the MAC address 0025-9e07-8260.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-mac 0025-9e07-8260
Related Topics

ap-mode

Function

The ap-mode command sets the working mode of an AP.

The undo ap-mode command restores the default working mode of an AP.

By default, an AP works in Fit mode.

Format

ap-mode { fat | cloud }

undo ap-mode

Parameters

Parameter Description Value
fat Specifies the Fat mode. -
cloud Specifies the cloud mode. -

Views

AP provisioning view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The working mode of an AP is configured on the AC and delivers to the AP. After a restart, the AP will switch the working mode accordingly.

Prerequisites

  • The AP has gone online on the AC in Fit mode.
  • Corresponding system files have been uploaded to the AC, FTP server, or SFTP server.

Follow-up Procedure

Run the commit command to commit the configuration.

Configuration Impact

After the working mode of the AP is switched to Fat or cloud, the AP will be out of control by the AC.

Only the AP1050DN-S, AP2050DN, AP2050DN-E, AP4050DN-E, AP4050DN-HD, AP4050DN, AP4050DN-S, AP4051DN, AP4151DN, AP8050DN, AP8050DN-S, AP8150DN, AP4051TN, AP6052DN, AP7052DN, AP7152DN, AP7052DE, AP8050TN-HD, AP8082DN, AP8182DN, AP6050DN, AP6150DN, AP7050DN-E, AP7050DE, AP8030DN, AP8130DN, AD9430DN-12, and AD9430DN-24 support this command. The AP4030TN and AD9431DN-24X can be switched only to the Fat mode.

Example

# Set the working mode of an AP to Fat.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] provision-ap
[HUAWEI-wlan-provision-ap] ap-mode fat
Warning: When the configuration is committed, the AP mode will be switched if supported and the AP will be out of control by the AC.Continue?[Y/N]: y

ap-name

Function

The ap-name command displays the AP view.

Format

ap-name ap-name

Parameters

Parameter

Description

Value

ap-name

Specifies the AP name.

The AP name must exist.

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

After entering the AP view, you can perform personalized configuration on an AP.

Example

# Display the view of the AP named area_1.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-name area_1
[HUAWEI-wlan-ap-2] 
Related Topics

ap-name (AP provisioning view)

Function

The ap-name command sets the name of an AP.

The undo ap-name command restores the default name of an AP.

By default, no AP name is configured.

Format

ap-name ap-new-name

undo ap-name

Parameters

Parameter Description Value
ap-new-name Specifies an AP name.

The value is a string of 1 to 31 case-sensitive characters. It does not contain question marks (?) or spaces, and cannot start or end with double quotation marks (" ").

Views

AP provisioning view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After the name of an AP is changed, and the change is delivered to the AP, the AP automatically restarts and goes online using the new name.

Precautions

The new AP name cannot be the same as the existing AP name.

If the AP name is not configured, the default name of an AP is the AP's MAC address after the AP goes online.

Follow-up Procedure

Run the commit command to deliver configuration to APs and restart the APs to make the configuration take effect.

Example

# Change the AP name to AP-N1-2.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] provision-ap
[HUAWEI-wlan-provision-ap] ap-name AP-N1-2

ap-name (AP view)

Function

The ap-name command configures an AP name.

The undo ap-name command restores the default AP name.

By default, no AP name is configured for an AP.

Format

ap-name ap-name

undo ap-name

Parameters

Parameter Description Value
ap-name Specifies an AP name.

The value is a string of 1 to 31 case-sensitive characters. It does not contain question marks (?) or spaces, and cannot start or end with double quotation marks (" ").

Views

AP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To facilitate AP maintenance, management, and differentiation, you can name the AP according to actual situations.

Precautions

The new AP name cannot be the same as the existing AP name.

If a new AP name is the same as an existing AP name, the new AP is restarted after its name is changed.

If the AP name is not configured, the default name of an AP is the AP's MAC address after the AP goes online.

Example

# Change the AP name to AP-N1-2.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ap-id 0
[HUAWEI-wlan-ap-0] ap-name AP-N1-2

ap-ping

Function

The ap-ping command uses a specified AP to ping a network device and displays the returned result.

Format

ap-ping { ap-name ap-name | ap-id ap-id } [ -c count | -s packetsize | -m time | -t timeout ] * host

Parameters

Parameter

Description

Value

ap-name ap-name

Specifies the name of an AP used to ping other network devices.

The AP name must already exist.

ap-id ap-id

Specifies the ID of an AP used to ping other network devices.

The AP ID must already exist.

-c count

Specifies the number of ICMP Echo Request packets to be sent.

The value is an integer that ranges from 1 to 10. The default value is 4.

-s packetsize

Specifies the length of an Echo Request packet excluding the IP header and ICMP header.

The value is an integer that ranges from 20 to 8100, in bytes. The default value is 56 bytes.

-m time

Specifies the time to wait before sending the next ICMP Request packet.

The value is an integer that ranges from 1 to 5000, in milliseconds. The default value is 2000 ms.

-t timeout

Specifies the timeout period for an ICMP Echo Response packet.

The value is an integer that ranges from 0 to 10000, in milliseconds. The default value is 2000 ms.

host

Specifies the domain name or IP address of the destination host.

The value is a string of 1 to 20 characters.

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

  • You can run this command to check the connectivity between an AP and network device by pinging a network device from an AP.
  • The prerequisite is that the AP is online and has been configured with an IP address.

Precautions

  • This command may cost much time because the parameters such as waiting time affects the command running.
  • Only one AP can perform the ping operation at a time.

Example

# Use the AP N1-2 to perform a ping operation.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ap-ping ap-name N1-2 10.1.1.1
Warning: This operation maybe takes several minutes, continue?[Y/N]:y       
[HUAWEI-wlan-view]                       
  AP ping result                                                                
    Success count        : 4                                                    
    Failure count        : 0                                                    
    Average response time: 1 ms                                                 
    Minimum response time: 1 ms                                                 
    Maximum response time: 1 ms

ap-regroup

Function

The ap-regroup command changes the group that an AP joins.

Format

ap-regroup { ap-name ap-name | ap-id ap-id } new-group new-group-name

Parameters

Parameter

Description

Value

ap-name ap-name

Specifies an AP name.

The AP name must exist.

ap-id ap-id

Specifies an AP ID.

The AP ID must exist.

The value is a string of 1 to 255 characters. When multiple APs are selected, use commas (,) to separate AP IDs or use hyphens (-) to indicate continuous AP IDs. For example, 5,8,10-13,20 indicates the list of APs with IDs 5, 8, 10, 11, 12, 13, and 20.

new-group new-group-name

Specifies the name of the new group to which the AP is added.

The AP group must exist.

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the current AP group is not applicable to an AP or the AP is added to an incorrect group, you can run this command to delete the AP from the current AP group and add the AP to a new AP group.

Prerequisites

The AP group has been created using the ap-group command.

Configuration Impact

Changing the group of an AP will restart the AP and interrupt services. Exercise caution when you run the command.

Example

# Change the group that an AP joins to the AP group group1.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-group name group1
[HUAWEI-wlan-ap-group-group1] quit
[HUAWEI-wlan-view] ap-regroup ap-name 1047-80b1-56a0 new-group group1
Warning: This operation may cause AP reset. If the country code changes, it will clear channel, power and antenna gain configuration
s of the radio, Whether to continue? [Y/N]:y 
Related Topics

ap-rename

Function

The ap-rename command changes the name of an AP.

Format

ap-rename { ap-name name | ap-mac ap-mac-address | ap-id ap-id } new-name ap-new-name

Parameters

Parameter

Description

Value

ap-name name

Specifies the old name of an AP.

The AP name must exist.

ap-mac ap-mac-address

Specifies the MAC address of an AP.

The AP's MAC address must exist.

ap-id ap-id

Specifies the ID of an AP.

The AP ID must exist.

new-name ap-new-name

Specifies the new name of an AP.

The value is a string of 1 to 31 case-sensitive characters. It does not contain question marks (?) or spaces, and cannot start or end with double quotation marks (" ").

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

If the name of an AP conflicts with that of another or an AP requires a more proper name, you can run this command to change the name of the AP.

If a new AP name is the same as an existing AP name, the new AP is restarted after its name is changed.

Example

# Change the AP name from N1-2 to N2-2.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-rename ap-name N1-2 new-name N2-2
Related Topics

ap-reset

Function

The ap-reset command resets an AP.

Format

ap-reset { all | ap-name ap-name | ap-mac ap-mac | ap-id ap-id | ap-group ap-group | ap-type { type type-name | type-id type-id } }

Parameters

Parameter

Description

Value

all

Resets all APs.

-

ap-name ap-name

Resets the AP with the specified AP name.

The AP name must exist.

ap-mac ap-mac

Resets the AP with the specified MAC address.

The AP's MAC address must exist.

ap-id ap-id

Resets the AP with the specified AP ID.

The AP ID must exist.

The value is a string of 1 to 255 characters. When multiple APs are selected, use commas (,) or hyphens (-) to separate AP IDs. For example, 5,8,10-13,20 indicates the list of APs with IDs 5, 8, 10, 11, 12, 13, and 20.

ap-group ap-group

Resets APs in the specified AP group.

The AP group must exist.

ap-type

Resets APs of the specified AP type.

-

type type-name

Resets APs of the specified type name.

The AP type name must exist.

type-id type-id

Resets APs of the specified type ID.

The AP type ID must exist.

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After in-service upgrade of APs is complete, you can run the ap-reset command to reset the APs. After the command is run, the APs restart with the upgraded software version. You can also use the command to restart APs for other reasons.

Prerequisites

An AP exists on the AC.

Example

# Reset the AP N1-2.
<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ap-reset ap-name N1-2
Warning: Reset AP(s), continue?[Y/N]:y

ap-reset work-group

Function

The ap-reset work-group command restarts APs in a WLAN work group.

Format

ap-reset work-group { groupId | all | default }

Parameters

Parameter Description Value
groupId Restarts APs in a specified WLAN work group. The value is an integer ranging from 1 to 4.
all Restarts APs in all WLAN work groups. -
default Restarts APs in the default WLAN work group. -

Views

WLAN view

Default Level

3: Management level

Usage Guidelines

The ap-reset work-group command restarts APs in a WLAN work group. New APs can still go online during the restart.

To clear APs in a WLAN work group, run the state block command to set the WLAN work group in block state and then run the ap-reset work-group command.

Example

# Restart APs in WLAN work group 1.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ap-reset work-group 1
Warning: Reset AP(s). Continue? [Y/N]:y
Related Topics

ap-system-profile (WLAN view)

Function

The ap-system-profile command creates an AP system profile and displays the AP system profile view, or displays the view of an existing AP system profile.

The undo ap-system-profile command deletes an AP system profile.

By default, the system provides the AP system profile default.

Format

ap-system-profile name profile-name

undo ap-system-profile { name profile-name | all }

Parameters

Parameter

Description

Value

name profile-name

Specifies the name of an AP system profile.

The value is a string of 1 to 35 case-insensitive characters. It does not contain question marks (?) or spaces, and cannot start or end with double quotation marks (" ").

all

Deletes all AP system profiles.

-

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To manage and maintain multiple APs in a centralized manner, add the APs in an AP group, configure parameters in an AP system profile, and apply the AP system profile to the AP group.

To manage and maintain an AP independently, configure parameters in an AP system profile and apply the AP system profile to the AP specific profile.

Follow-up Procedure

Run the ap-system-profile (AP group view and AP view) command to bind the AP system profile to an AP or AP group so that the AP system profile can take effect.

Precautions

  • The AP system profile default cannot be deleted.

  • The AP system profile referenced by an AP or AP group cannot be deleted. To delete the AP system profile, unbind it from the AP or AP group first.

Example

# Create the AP system profile ap-system1 and display the AP system profile view.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-system-profile name ap-system1 
[HUAWEI-wlan-ap-system-prof-ap-system1] 

ap-system-profile (AP group view and AP view)

Function

The ap-system-profile command binds an AP system profile to an AP or AP group.

The undo ap-system-profile command unbinds an AP system profile from an AP or AP group.

By default, the AP system profile default is bound to an AP group, but no AP system profile is bound to an AP.

Format

ap-system-profile profile-name

undo ap-system-profile

Parameters

Parameter

Description

Value

profile-name

Specifies the name of an AP system profile.

The AP system profile must exist.

Views

AP group view, AP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After you create an AP system profile using the ap-system-profile (WLAN view) command, bind it to an AP or AP group so that the AP system profile can take effect.

Precautions

After an AP system profile is bound to an AP or AP group, parameter settings in the AP system profile apply to all APs using the profile.

Example

# Create the AP system profile ap-system1 and bind it to AP group group1.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-system-profile name ap-system1
[HUAWEI-wlan-ap-system-prof-ap-system1] quit
[HUAWEI-wlan-view] ap-group name group1
[HUAWEI-wlan-ap-group-group1] ap-system-profile ap-system1

assignment

Function

The assignment command configures the VLAN assignment algorithm in a VLAN pool.

The undo assignment command restores the default VLAN assignment algorithm in a VLAN pool.

By default, the VLAN assignment algorithm is hash in a VLAN pool.

Format

assignment { even | hash }

undo assignment

Parameters

Parameter Description Value
even

Sets the VLAN assignment algorithm to even.

-

hash

Sets the VLAN assignment algorithm to hash.

-

Views

VLAN pool view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

  • When the VLAN assignment algorithm is set to even, service VLANs are assigned to STAs from the VLAN pool based on the order in which STAs go online. Address pools mapping the service VLANs evenly assign IP addresses to STAs. If a STA goes online many times, it obtains different IP addresses.

  • When the VLAN assignment algorithm is set to hash, VLANs are assigned to STAs from the VLAN pool based on the harsh result of their MAC addresses. As long as the VLANs in the VLAN pool do not change, the STAs obtain fixed service VLANs. A STA is preferentially assigned the same IP address when going online at different times.

Precautions

For the even VLAN assignment algorithm, the aging time of IP addresses is set large on the DHCP server. A STA is assigned different IP addresses when going one at different times. As a result, a STA may occupy many IP addresses, which wastes IP addresses. Additionally, frequent IP address changes may lower user experience.

Configuration Impact

The VLAN assignment algorithm configuration affects only newly connected STAs, but not those that have been connected to the network.

Example

# Set the VLAN assignment algorithm to even in a VLAN pool.

<HUAWEI> system-view
[HUAWEI] vlan pool pool1
[HUAWEI-vlan-pool-pool1] assignment even

association-timeout

Function

The association-timeout command configures an association aging time for STAs.

The undo association-timeout command restores the default association aging time.

By default, the association aging time is 5 minutes.

Format

association-timeout association-timeout

undo association-timeout

Parameters

Parameter

Description

Value

association-timeout

Specifies the association aging time of STAs.

The value is an integer that ranges from 1 to 30, in minutes.

Views

SSID profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The administrator can run the association-timeout command to set the association aging time for STAs. If the AP receives no data packet from a STA in a specified time, the STA goes offline after the association aging time expires.

Precautions

Changing the association aging time of a STA may interrupt the STA services.

Example

# Set the association aging time of STAs to 15 minutes in the SSID profile ssid1.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ssid-profile name ssid1
[HUAWEI-wlan-ssid-prof-ssid1] association-timeout 15
Warning: This action may cause service interruption. Continue?[Y/N]y
Related Topics

auto-off service

Function

The auto-off service command enables the scheduled VAP auto-off function and sets the time range within which the VAP is disabled.

The undo auto-off service command disables the scheduled VAP auto-off function.

By default, the scheduled VAP auto-off function is disabled.

Format

auto-off service start-time start-time end-time end-time

undo auto-off service

Parameters

Parameter

Description

Value

start-time start-time

Specifies the time when a VAP starts to be disabled.

The time is in hh:mm:ss format. hh indicates the hour that is an integer ranging from 0 to 23. mm indicates the minute that is an integer ranging from 0 to 59. ss indicates the second that is an integer ranging from 0 to 59.

end-time end-time

Specifies the time when a VAP stops being disabled.

The time is in hh:mm:ss format. hh indicates the hour that is an integer ranging from 0 to 23. mm indicates the minute that is an integer ranging from 0 to 59. ss indicates the second that is an integer ranging from 0 to 59.

Views

VAP profile view, 2G radio profile view, 5G radio profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When an enterprise does not want employees to access the internal WLAN from 01:00 to 05:00, the administrator can run the auto-off service command to enable the scheduled VAP auto-off function.

Precautions

  • After the service mode of a VAP is enabled using the undo service-mode disable command, you can run the auto-off service command to configure the scheduled VAP auto-off function. In the scheduled time, the VAP is disabled and cannot be enabled using the undo service-mode disable command. To enable the VAP, run the undo auto-off service command.

  • The scheduled VAP auto-off function takes effect in the scheduled time only after the undo service-mode disable command is executed. If the service mode of a VAP is disabled using the service-mode disable command, the VAP auto-off function does not take effect.

  • The scheduled VAP auto-off function enabled in a VAP profile view takes effect only on the APs using the VAP profile, and the scheduled VAP auto-off function enabled in a radio profile view takes effect only on the APs using the radio profile.

Example

# Configure the scheduled VAP auto-off function in the VAP profile vap1, and configure the VAP to be disabled from 1:00:00 to 7:00:00.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] vap-profile name vap1
[HUAWEI-wlan-vap-prof-vap1] auto-off service start-time 1:00:00 end-time 7:00:00

beacon-2g-rate

Function

The beacon-2g-rate command sets the transmit rate of 2.4 GHz Beacon frames.

The undo beacon-2g-rate command restores the default transmit rate of 2.4 GHz Beacon frames.

By default, the transmit rate of 2.4 GHz Beacon frames is 1 Mbit/s.

Format

beacon-2g-rate beacon-2g-rate

undo beacon-2g-rate

Parameters

Parameter Description Value
beacon-2g-rate Specifies the transmit rate of Beacon frames.
Enumerated type:
  • 1: 1 Mbit/s
  • 2: 2 Mbit/s
  • 5.5: 5.5 Mbit/s
  • 6: 6 Mbit/s
  • 9: 9 Mbit/s
  • 11: 11 Mbit/s
  • 12: 12 Mbit/s
  • 18: 18 Mbit/s
  • 24: 24 Mbit/s
  • 36: 36 Mbit/s
  • 48: 48 Mbit/s
  • 54: 54 Mbit/s

Views

SSID profile view, WDS profile view, Mesh profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In high-density wireless scenarios, too many Beacon frames occupy a large number of wireless resources. To reduce wireless resource occupation of Beacon frames and improve channel usage efficiency, you can run the beacon-2g-rate command to set a large transmit rate for 2.4 GHz Beacon frames.

Precautions

Modifying the transmit rate of Beacon frames will affect the association experience of STAs. Exercise caution when running the command.

The 802.11b protocol supports only 1 Mbit/s, 2 Mbit/s, 5.5 Mbit/s, and 11 Mbit/s. If you set the transmit rate of Beacon frames to a rate not supported by the 802.11b protocol, STAs supporting only 802.11b cannot connect to the wireless network.

If you run the radio-type dot11b command in the 2G radio profile view to set the radio type to dot11b, and the 2G radio profile is applied to an AP, beacon-2g-rate that takes effect on the 2 GHz radio of the AP is fixed as 1 Mbps, and beacon-2g-rate configured in the SSID profile view does not take effect on the AP.

Example

# Set the transmit rate of 2.4 GHz Beacon frames to 18 Mbit/s in the SSID profile ssid1.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ssid-profile name ssid1
[HUAWEI-wlan-ssid-prof-ssid1] beacon-2g-rate 18

beacon-5g-rate

Function

The beacon-5g-rate command sets the transmit rate of 5 GHz Beacon frames.

The undo beacon-5g-rate command restores the default transmit rate of 5 GHz Beacon frames.

By default, the transmit rate of 5 GHz Beacon frames is 6 Mbit/s.

Format

beacon-5g-rate beacon-5g-rate

undo beacon-5g-rate

Parameters

Parameter Description Value
beacon-5g-rate Specifies the transmit rate of Beacon frames.
Enumerated type:
  • 6: 6 Mbit/s
  • 9: 9 Mbit/s
  • 12: 12 Mbit/s
  • 18: 18 Mbit/s
  • 24: 24 Mbit/s
  • 36: 36 Mbit/s
  • 48: 48 Mbit/s
  • 54: 54 Mbit/s

Views

SSID profile view, WDS profile view, Mesh profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In high-density wireless scenarios, too many Beacon frames occupy a large number of wireless resources. To reduce wireless resource occupation of Beacon frames and improve channel usage efficiency, you can run the beacon-5g-rate command to set a large transmit rate for 5 GHz Beacon frames.

Precautions

Modifying the transmit rate of Beacon frames will affect the association experience of STAs. Exercise caution when running the command.

Example

# Set the transmit rate of 5 GHz Beacon frames to 18 Mbit/s in the SSID profile ssid1.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ssid-profile name ssid1
[HUAWEI-wlan-ssid-prof-ssid1] beacon-5g-rate 18
Related Topics

beacon-interval

Function

The beacon-interval command sets the interval for sending Beacon frames.

The undo beacon-interval restores the default interval for sending Beacon frames.

By default, the interval for sending Beacon frames is 100 TUs.

Format

beacon-interval beacon-interval

undo beacon-interval

Parameters

Parameter

Description

Value

beacon-interval

Specifies the interval for sending Beacon frames.

The value is an integer that ranges from 60 TUs to 1000 TUs.TU is a time unit equal to 1024 microseconds.

Views

2G radio profile view, 5G radio profile view

Default Level

2: Configuration level

Usage Guidelines

An AP broadcasts Beacon frames at intervals to notify STAs of an existing 802.11 network. After receiving a Beacon frame, a STA can modify parameters used to connect to the 802.11 network.

A long interval for sending Beacon frames lengthens the dormancy time of STAs, while a short interval for sending Beacon frames increases air interface costs. Therefore, you are advised to set the interval for sending Beacon frames for an AP based on the VAP quantity. The following intervals for sending Beacon frames are recommended for APs with different VAP quantities on a single radio (except the AP7030DE and AP9330DN):
  • No more than 4 VAPs: about 100 TUs
  • 5 to 8 VAPs: about 200 TUs
  • 9 to 12 VAPs: about 300 TUs
  • 13 to 16 VAPs: about 400 TUs

Example

# Set the interval for sending Beacon frames to 200 TUs in the 2G radio profile default.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] radio-2g-profile name default
[HUAWEI-wlan-radio-2g-prof-default] beacon-interval 200 

beamforming enable

Function

The beamforming enable command enables Beamforming.

The undo beamforming enable command disables Beamforming.

By default, Beamforming is disabled.

Format

beamforming enable

undo beamforming enable

Parameters

None

Views

2G radio profile view, 5G radio profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Beamforming is a signal processing technique that controls signal transmission direction, and transmission and reception of radio signals. The transmit end uses weight to transmit signals. The signals are transmitted to the destination as narrow beams. Beamforming increases the signal-to-noise ratio (SNR) for the destination device.

Precautions

If nodes on the WDS or Mesh network are fixed and distant from each other, enable Beamforming to increase WDS or Mesh link SNR. Mobile nodes may cause low link SNR in WDS or Mesh scenarios. To prevent this problem, disable Beamforming. Among Beamforming-capable APs, the AP2x10xN series, AP7x30xE series, and AP9330DN APs do not support WDS and Mesh.

The smart antenna function cannot take effect if MU-MIMO has been configured.

Table 11-1 describes the support of Huawei APs for beamforming.

Table 11-1  Support of APs for Beamforming
AP Model Explicit 802.11ac Beamforming Explicit 802.11n Beamforming Implicit Beamforming
2.4 GHz 5 GHz
AP3010DN, AP5010SN, AP5010DN, AP6010SN, AP6010DN, AP6310SN, AP6510DN, AP6610DN, AP7110SN, AP7110DN, and AP2010DN N Y Y N
AP5030DN, AP5130DN, AP2030DN, AP3030DN, AP4030DN, AP4130DN, AP9131DN, AP9132DN, AD9430DN-12 (with R240D), AD9430DN-24 (with R230D and R240D), AD9431DN-24X (with R230D and R240D), and AP4030TN N Y

For AP4030TN, only the radio 0 supports this feature.

N N
AP8030DN, AP8130DN, AP1050DN-S, and AP8130DN-W N N N N
AD9430DN-12 (with R250D), AD9430DN-24 (with R250D, R450D and R250D-E), AD9431DN-24X (with R250D, R450D and R250D-E), AP2050DN, AP2050DN-E, AP4050DN-E, AP4050DN-HD, AP4051TN , AP4050DN, AP4050DN-S, AP4051DN, AP4151DN, AP8050DN, AP8150DN, AP8050DN-S, AP6052DN, AP7052DN, AP7152DN, AP7052DE, AP8050TN-HD, AP8082DN, AP8182DN, AP6050DN, AP6150DN, AP7050DN-E, and AP7050DE Y N N Y
AP7030DE and AP9330DN N N N Y

Example

# Enable Beamforming.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] radio-2g-profile name default
[HUAWEI-wlan-radio-2g-prof-default] beamforming enable

capwap dtls psk

Function

The capwap dtls psk command configures a pre-shared key used for DTLS encryption.

The undo capwap dtls psk command restores the default pre-shared key used for DTLS encryption.

By default, the pre-shared key used for DTLS encryption is huawei_seccwp.

Format

capwap dtls psk psk-value

undo capwap dtls psk

Parameters

Parameter

Description

Value

psk-value

Specifies the pre-shared key used for DTLS encryption.

The value is string of characters. The pre-shared key contains 48 or 68 characters in cipher text, for example, %^%#u(Oz:BL,QKYZw%-JWC*P8aGC,="C&M'OI*Gmt.V(%^%#, or contains 6 to 32 characters in plain text, for example, a1234567. The password must contain at least two types of the following: uppercase letters, lowercase letters, digits, and special characters except the question mark (?) and space.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

During CAPWAP tunnel establishment, an AP establishes a DTLS session with an AC. If DTLS encryption has been enabled for CAPWAP control, sent management packets will be encrypted using DTLS. When a pre-shared key is used for DTLS encryption, you can use the capwap dtls psk command to change the pre-shared key.
NOTE:
It is recommended that you change the pre-shared key in a timely manner to ensure device security.

Follow-up Procedure

Run the capwap dtls control-link encrypt command to enable CAPWAP control tunnel encapsulation using DTLS.

Precautions

After the capwap dtls psk command configuration is complete, the new pre-shared key will be automatically synchronized to the online APs that are working properly, but the previous pre-shared key still takes effect. The new pre-shared key takes effect after these APs go online again.

Example

# Configure the pre-shared key for DTLS encryption as huawei123.

<HUAWEI> system-view
[HUAWEI] capwap dtls psk huawei123

capwap dtls psk-mandatory-match enable

Function

The capwap dtls psk-mandatory-match enable command enables an AP to establish a Datacom Transport Layer Security (DTLS) session with an AC using the default pre-shared key.

The undo capwap dtls psk-mandatory-match enable command disables an AP to establish a Datacom Transport Layer Security (DTLS) session with an AC using the default pre-shared key.

By default, an AP is disabled to establish a DTLS session with an AC using the default pre-shared key.

Format

capwap dtls psk-mandatory-match enable

undo capwap dtls psk-mandatory-match enable

Parameters

None.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

When a new AP is added to the WLAN or the passwords of the AP and AC are different (for example, the password of the AC is changed but the AP is not online), you can enable the AP to perform DTLS sessions with the AC using the default pre-shared key. After three DTLS session failures, the AP notifies the AC of DTLS sessions using the default pre-shared key. In this way, a CAPWAP tunnel is established between the AP and the AC.

Example

# Enable the AP to establish a DTLS session with the AC using the default pre-shared key.

<HUAWEI> system-view
[HUAWEI] capwap dtls psk-mandatory-match enable

capwap echo

Function

The capwap echo command sets the CAPWAP heartbeat detection interval and the number of CAPWAP heartbeat detections.

The undo capwap echo command restores the default CAPWAP heartbeat detection interval and the number of CAPWAP heartbeat detections.

By default, the CAPWAP heartbeat detection interval is 25s and the number of CAPWAP heartbeat detections is 6.

By default, If dual-link backup is enabled, the CAPWAP heartbeat detection interval is 25s and the number of CAPWAP heartbeat detections is 3.

Format

capwap echo { interval interval-value | times times-value } *

undo capwap echo { interval | times }

Parameters

Parameter

Description

Value

interval interval-value

Specifies the CAPWAP heartbeat detection interval, the interval at which two detection packets are sent.

The value is an integer ranging from 20 to 300, in seconds.

times times-value

Specifies the number of CAPWAP heartbeat detections. If no response is received after the specified number of times, the link is considered disconnected.

The value is an integer ranging from 3 to 120.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

As defined by CAPWAP, an AP and an AC send handshake packets periodically to maintain the data channel and management channel. If the AP does not receive packets from the AC within the heartbeat detection interval, it considers that the link between them is disconnected. Then the AP resets and releases its IP address, and reestablishes a link. If the AC does not receive packets from the AP within the heartbeat detection interval, it disconnects the link between the AC and the AP and reports an error message to the AP.

Precautions

If dual-link backup is enabled, the CAPWAP heartbeat detection interval is 25s and the number of CAPWAP heartbeat detections is 3. When the Wireless Distribution System (WDS) is required in dual-link backup configuration, the WDS link may be unstable and users may not access the network. You need to run this command to set the interval for CAPWAP heartbeat detection to 25 seconds and the number of CAPWAP heartbeat detections to 6.

After the CAPWAP heartbeat detection interval and the number of CAPWAP heartbeat detections are configured, the interval and the number of times for sending Echo packets are configured.

Radio traffic statistics packets are sent and received together with Echo packets.

If you set the CAPWAP heartbeat detection interval and the number of CAPWAP heartbeat detections smaller than the default values, the CAPWAP link reliability is degraded. Exercise caution when you set the values. The default values are recommended.

Example

# Set the CAPWAP heartbeat detection interval to 30s and the number of CAPWAP heartbeat detections to 3.

<HUAWEI> system-view
[HUAWEI] capwap echo interval 30 times 3

capwap echo-timeout trace logging

Function

The capwap echo-timeout trace logging command enables the Echo packet process trace and diagnosis log record functions upon AP Echo packet timeout.

The undo capwap echo-timeout trace logging command disables the Echo packet process trace and diagnosis log record functions upon AP Echo packet timeout.

By default, the Echo packet process trace and diagnosis log record functions are enabled upon AP Echo packet timeout.

Format

capwap echo-timeout trace logging

undo capwap echo-timeout trace logging

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

After you run the capwap echo-timeout trace logging command, the Echo packet process is traced and diagnosis logs are recorded upon AP Echo packet timeout.

Example

# Enable the Echo packet process trace and diagnosis log record functions upon AP Echo packet timeout.

<HUAWEI> system-view
[HUAWEI] capwap echo-timeout trace logging

capwap message-integrity psk

Function

The capwap message-integrity psk command configures a pre-shared key (PSK) for checking integrity of CAPWAP packets.

The undo capwap message-integrity psk command restores the default PSK for checking integrity of CAPWAP packets.

The default PSK for checking integrity of CAPWAP packets is huawei_seccwp.

Format

capwap message-integrity psk psk-value

undo capwap message-integrity psk

Parameters

Parameter

Description

Value

psk-value

Specifies the PSK for checking integrity of CAPWAP packets.

The value can be a string of 48 or 68 characters in cipher text (for example, %^%#u(Oz:BL,QKYZw%-JWC*P8aGC,="C&M'OI*Gmt.V(%^%#) or a string of 6 to 32 characters in plain text (for example, a1234567). The key must contain at least two of the following: uppercase letters, lowercase letters, digits, and special characters except the question mark (?) and space.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

CAPWAP packets are transmitted between the AC and APs. To prevent the packets from being forged or tampered with and prevent malformed packet attacks, you can configure integrity check of of CAPWAP packets. When a PSK is used to check integrity of CAPWAP packets, you can run this command on the AC to configure a PSK.

NOTE:
It is recommended that you change the pre-shared key in a timely manner to ensure device security.

Follow-up Procedure

Run the undo capwap message-integrity check disable command to enable integrity check of CAPWAP packets.

Configuration Impact

After this configuration is complete, all online APs on the AC go offline.

Example

# Set the PSK for checking integrity of CAPWAP packets to z0020011@11.

<HUAWEI> system-view
[HUAWEI] capwap message-integrity psk z0020011@11
Warning: In a backup scenario, the PSK and status of CAPWAP message integrity check must be the same between the master and backup e
nds. This operation may cause devices using CAPWAP connections to reset or go offline. Continue? [Y/N]:y

capwap message-integrity check disable

Function

The capwap message-integrity check disable command disables integrity check of CAPWAP packets.

The undo capwap message-integrity check disable command enables integrity check of CAPWAP packets.

By default, integrity check of CAPWAP packets is enabled.

Format

capwap message-integrity check disable

undo capwap message-integrity check disable

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

CAPWAP packets are transmitted between the AC and APs. To prevent the packets from being forged or tampered with and prevent malformed packet attacks, you can configure integrity check of of CAPWAP packets.

Configuration Impact

After this configuration is modified, all online APs on the AC go offline.

Example

# Enable integrity check of CAPWAP packets.

<HUAWEI> system-view
[HUAWEI] capwap message-integrity check disable
Warning: In a backup scenario, the PSK and status of CAPWAP message integrity check must be the same between the master and backup e
nds. This operation may cause devices using CAPWAP connections to reset or go offline. Continue? [Y/N]:y

capwap sensitive-info psk

Function

The capwap sensitive-info psk command modifies the pre-shared key (PSK) used for sensitive information encryption.

The undo capwap sensitive-info psk command restores the default PSK used for sensitive information encryption.

The default PSK used for sensitive information encryption is WLAN-KEYSTRING-AES256.

Format

capwap sensitive-info psk psk-value

undo capwap sensitive-info psk

Parameters

Parameter

Description

Value

psk-value

Specifies the PSK used for sensitive information encryption.

The value can be a string of 48 or 68 characters in cipher text (for example, %^%#u(Oz:BL,QKYZw%-JWC*P8aGC,="C&M'OI*Gmt.V(%^%#) or a string of 6 to 32 characters in plain text (for example, a1234567). The key must contain at least two of the following: uppercase letters, lowercase letters, digits, and special characters except the question mark (?) and space.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Sensitive information transmitted between the AC and APs is encrypted, such as the FTP user name/password, AP login user name/password, and service configuration-related keys. You can use the capwap sensitive-info psk command to modify the PSK used for sensitive information encryption.

NOTE:

To ensure STA security, you are advised to modify the PSK value.

After the configuration is complete, all online APs will go offline from the AC and go online again.

Precautions

In hot backup (HSB) and dual-link cold backup scenarios, the PSKs configured on the active and standby ACs must be the same. Otherwise, APs cannot set up CAPWAP tunnels with the standby AC.

The pre-shared key for encrypting sensitive information cannot be modified when an AP is being upgraded on the

Example

# Modify the PSK for encrypting sensitive information to z0020011@11.

<HUAWEI> system-view
[HUAWEI] capwap sensitive-info psk z0020011@11
Warning: This operation may cause devices using CAPWAP connections to go offline. Continue? [Y/N]:y

capwap source interface

Function

The capwap source interface command configures the source interface that the AC uses to establish a CAPWAP tunnel with an access device.

The undo capwap source interface command restores the source interface that the AC uses to establish a CAPWAP tunnel with an access device to the default setting.

By default, no source interface is configured for the AC to establish a CAPWAP tunnel with the access device.

Format

capwap source interface { loopback loopback-number | vlanif vlan-id }

undo capwap source interface { loopback loopback-number | vlanif vlan-id }

Parameters

Parameter

Description

Value

loopback loopback-number

Configures a loopback interface as the source interface.

The value is an integer that ranges from 0 to 1023.

vlanif vlan-id

Configures a VLANIF interface as the source interface.

The value is an integer that ranges from 1 to 4094.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

An AC uses the IP address of the specified interface as the source IP address. All access devices connected to the AC can learn this IP address and use the IP address to communicate with the AC.

Prerequisites

An IP address has been assigned to the specified loopback or VLANIF interface.

Precautions

A maximum of eight AC source interfaces can be configured.

If the SVF function is enabled, only one source interface can be configured.

Configure multiple source interfaces. When the source interfaces are added to different VPN instances, the IP addresses of these interfaces cannot be the same.

When multiple CAPWAP source interfaces are configured, ensure that the management VLAN for APs is within the VLAN range mapping the source interfaces. Otherwise, APs cannot go online.

Changing configuration of the CAPWAP source interface will clear statistics of the CAPWAP packets in CPU attack defense.

Example

# Configure a loopback interface as the source interface.

<HUAWEI> system-view
[HUAWEI] interface loopback 20
[HUAWEI-LoopBack20] ip address 192.168.10.1 24
[HUAWEI-LoopBack20] quit
[HUAWEI] capwap source interface loopback 20

channel

Function

(AP group radio view) The channel command configures the working bandwidth and channel for all specified radios in an AP group.

(AP group radio view) The undo channel command restores the default working bandwidth and channel for all specified radios in an AP group.

(AP radio view) The channel command configures the working bandwidth and channel for an AP radio.

(AP radio view) The undo channel command cancels the configuration of the working bandwidth and channel on an AP radio. The working bandwidth and channel on the AP radio are then determined by those configured in the AP group radio view.

By default, the working bandwidth of a radio is 20 MHz, and no working channel is configured for a radio.

You can run the display ap config-info command to check the channel in use on a radio.

Format

channel { 20mhz | 40mhz-minus | 40mhz-plus | 80mhz | 160mhz } channel

channel 80+80mhz channel1 channel2

undo channel

Parameters

Parameter

Description

Value

20mhz

Sets the working bandwidth of a radio to 20 MHz.

-

40mhz-minus

Sets the working bandwidth of a radio to 40 MHz Minus.

-

40mhz-plus

Sets the working bandwidth of a radio to 40 MHz Plus.

-

80mhz

Sets the working bandwidth of a radio to 80 MHz.

-

160mhz

Sets the working bandwidth of a radio to 160 MHz.

-

80+80mhz

Sets the working bandwidth of a radio to 80+80 MHz.

-

channel/channel1/channel2

Specifies the working channel for a radio. The channel is selected based on the country code and radio mode.

The parameter is an enumeration value. The value range is determined according to the country code and radio mode.

Views

AP radio view, AP group radio view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Different radios use different channels. Channels for radios also vary in different countries and regions. Select channels based on the actual situations.

Precautions

The configured channel parameters must match the radio frequency band. For details about mappings between channel parameters and frequency bands, see Country Codes & Channels Compliance. You can obtain this table at Huawei technical support website.

The channels you configure must be supported by the terminals; otherwise, the terminals cannot discover wireless signals. For example, when the country code is set to China, 5 GHz channels 36, 40, 44, 48, 52, 56, 60, and 64 can be configured. However, most terminals do not support these channels currently. If these channels are configured, the terminals cannot discover wireless signals. In this case, you can configure 5 GHz channels 149, 153, 157, 161, and 165, which are supported by the terminals.

If an AP detects radar signals on a channel, the channel cannot be configured as the radio channel of the AP in 30 minutes. However, the channel can be configured as the radio channel of other APs not detecting radar signals on it.

The configuration in the AP radio view has a higher priority than that in the AP group radio view.

If an AP works in dual-5G mode, the channels of the two 5G radios must be separated by at least one channel.

For example, a country supports 40 MHz 5G channels 36, 44, 52, and 60. When deploying 5G radio channels, if one radio is deployed on channel 36, it is recommended that the other radio be deployed on channel 52 or 60. Channel 44 is not recommended in this case.

NOTE:
  • The 80 MHz, 160 MHz, and 80+80 MHz working bandwidths are only supported in the 5G radio view.

  • Currently, only the 5 GHz radio of the AP6050DN, AP6150DN, AP7050DE, and 7050DN-E supports 160 MHz, and 80+80 MHz. Only the 5 GHz radio of the AD9430DN-24 (including the mapping RUs), AD9430DN-12 (including the mapping RUs), AD9431DN-24X (including the mapping RUs), AP7030DE, AP9330DN, AP2030DN, AP4051TN, AP6052DN, AP7052DN, AP7152DN, AP7052DE, AP8050TN-HD, AP8082DN, AP8182DN, AP3010DN-V2 (supporting 802.11ac after being upgraded from a version earlier than V200R008C10SPC300 to V200R008C10SPC300 or a later version), AP4030TN, AP4050DN-E, AP4050DN-HD, AP6050DN, AP6150DN, AP7050DN-E, AP7050DE, AP4050DN, AP4050DN-S, AP4051DN, AP4151DN, AP8050DN, AP8050DN-S, AP8150DN, AP1050DN-S, AP2050DN, AP2050DN-E, AP8130DN-W, AP5030DN, AP5130DN, AP8030DN, AP8130DN, AP4030DN, AP4130DN, AP9131DN, and AP9132DN supports 80 MHz.

Example

# Set the working bandwidth to 20 MHz and channel to 6 for radio 0 of AP 1.
<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-id 1
[HUAWEI-wlan-ap-1] radio 0
[HUAWEI-wlan-radio-1/0] channel 20mhz 6

channel-load-mode indoor

Function

The channel-load-mode indoor command sets the AP channel mode to indoor mode.

The undo channel-load-mode indoor command restores the AP channel mode to outdoor mode.

The default channel mode of an AP is outdoor mode.

Format

channel-load-mode indoor

undo channel-load-mode indoor

Parameters

None

Views

Regulatory domain profile view

Default Level

2: Configuration level

Usage Guidelines

In scenarios where indoor and outdoor boundaries are unclear, such as subway and train platforms, it is recommended that outdoor APs be deployed. When a large volume of data is transmitted, outdoor APs in outdoor channel mode have no sufficient channels to meet data transmission requirements. In this case, you can run the channel-load-mode indoor command to set the channel mode of the APs to indoor mode, so that data can be transmitted on more channels.

Precautions

The AP is automatically reset after this command is executed, so exercise caution when using this command.

These commands are supported by only the AP8030DN, AP8130DN, AP8050DN, AP8050DN-S, AP8150DN, AP8130DN-W, AP8050TN-HD, AP8082DN, and AP8182DN.

Example

# Set the AP channel mode to indoor mode.
<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan] regulatory-domain-profile name default
[HUAWEI-wlan-regulate-domain-default] channel-load-mode indoor
Warning: Modifying the channel set mode may delete channels of AP radios in this
 domain and restart the AP. Continue?[Y/N]:y

channel-switch announcement disable

Function

The channel-switch announcement disable command disables an AP from sending an announcement when the channel is switched.

The undo channel-switch announcement disable command enables an AP to send an announcement when the channel is switched.

By default, an AP sends an announcement when the channel is switched.

Format

channel-switch announcement disable

undo channel-switch announcement disable

Parameters

None

Views

2G radio profile view, 5G radio profile view

Default Level

2: Configuration level

Usage Guidelines

When the AP works on a Depth First Select (DFS) channel, a radar detection is performed. The AP automatically switches to another channel because the DFS channel frequency may interfere with the radar frequency.

After the undo channel-switch announcement disable command is run, if the AP channel switches, the AP sends an Action frame to instruct STAs to switch channels after multiple Beacon intervals. The AP also switches the channel after the same intervals. The AP and STAs switch channels at the same time to prevent STA reassociations and ensure rapid service recovery.

NOTE:

The channel switching announcement function must be supported by both the AP and STA.

Example

# Disable the AP from sending an announcement after the channel is switched.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] radio-2g-profile name default
[HUAWEI-wlan-radio-2g-prof-default] channel-switch announcement disable

channel-switch mode

Function

The channel-switch mode command configures an announcement mode for channel switching.

The undo channel-switch mode command restores the default announcement mode for channel switching.

By default, data transmission from STAs continues on the current channel when the channel is switched.

Format

channel-switch mode { stop-transmitting | continue-transmitting }

undo channel-switch mode

Parameters

Parameter

Description

Value

stop-transmitting

Stops data transmission from STAs on the current channel during channel switching.

-

continue-transmitting

Continues data transmission from STAs on the current channel during channel switching.

-

Views

2G radio profile view, 5G radio profile view

Default Level

2: Configuration level

Usage Guidelines

During channel switching, STA communication is interrupted. The administrator can stop an associated STA sending data on the current channel until channel switching is complete. Alternatively, data transmission from STAs can be continued on the current channel before channel switching is complete.

Example

# Stop data transmission from STAs on the current channel during channel switching.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] radio-2g-profile name default
[HUAWEI-wlan-radio-2g-prof-default] channel-switch mode stop-transmitting

clear configuration this

Function

The clear configuration this command clears all configurations in the AP provisioning view.

Format

clear configuration this

Parameters

None

Views

AP provisioning view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

To configure new AP provisioning parameters, run the clear configuration this command in the AP provisioning view to clear existing configurations.

Configuration Impact

Configurations in the AP provisioning view cannot be restored after they are cleared. Therefore, exercise caution when running the clear configuration this command.

Example

# Clear all configurations in the AP provisioning view.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] provision-ap
[HUAWEI-wlan-provision-ap] clear configuration this

commit (AP provisioning view)

Function

The commit command commits configuration to an AP, a group of APs or all the on-line APs.

Format

commit { ap-name ap-name | ap-mac ap-mac-address | ap-id ap-id | ap-group ap-group-name | all }

Parameters

Parameter

Description

Value

ap-name ap-name

Commits configuration to the AP with the specified AP name.

The AP name must already exist.

ap-mac ap-mac-address

Commits configuration to the AP with the specified MAC address.

The AP's MAC address must already exist.

ap-id ap-id

Commits configuration to the AP with the specified AP ID.

The AP ID must already exist.

ap-group ap-group-name

Commits configuration to the AP in the specified AP group.

The AP group must already exist.

Views

AP provisioning view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can configure AP provisioning parameters on the AC, such as the AP's management VLAN, static IP address, gateway, and AC list. After the configuration is complete, run the commit command, and the configuration will be delivered to the AP.

Prerequisites

APs have gone online on the AC.

Precautions

  • After the configuration is committed, the AP receives the configuration and compares the configuration with its local configuration.
    • If they are consistent, the AP does not process the received configuration.
    • If they are different, the AP saves the committed configuration and automatically restarts, and the received configuration takes effect.
  • If the name or static IP address of an AP is specified in the AP provisioning view, the configuration is delivered only to the AP by specifying the AP name or MAC address, but cannot be delivered to APs in the specified AP group.

  • If you commit configurations to a large number of APs simultaneously, some of the APs may fail to receive the configurations. In this case, you are advised to commit the configurations again.

Example

# Commit configuration to the AP with the MAC address 0023-0024-0080.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] provision-ap
[HUAWEI-wlan-provision-ap] commit ap-mac 0023-0024-0080
Warning: The incorrect configuration will cause the AP to go out of management. This operation will deliver parameter setting and ma
y cause reboot of AP(s). Continue?[Y/N]:y

console disable

Function

The console disable command disables a user from logging in to the AP through a console interface.

The undo console disable command enables a user from logging in to the AP through a console interface.

By default, a user can log in to the AP through a console interface.

Format

console disable

undo console disable

Parameters

None

Views

AP system profile view

Default Level

2: Configuration level

Usage Guidelines

When a user cannot telnet or stelnet to the AP, the user can log in to the AP through a console interface to manage and configure the AP.

After the console disable command is run, unauthorized users cannot log in to the AP through the console interface to perform operations.

Example

# Disable a user to log in to the AP through a console interface.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-system-profile name ap-system1
[HUAWEI-wlan-ap-system-prof-ap-system1] console disable

coordinate

Function

The coordinate command sets the latitude and longitude of an AP.

The undo coordinate command restores the latitude and longitude of an AP to empty.

By default, no latitude or longitude is configured for an AP.

Format

coordinate longitude { e | w } longitude-value latitude { s | n } latitude-value

undo coordinate

Parameters

Parameter Description Value
longitude e longitude-value

Specifies the east longitude value of an AP.

The value supports two formats: degrees, minutes, and seconds (DMS) and decimal degrees (DD).
  • The DMS format is XXX-XX-XX. XXX ranges from 0 to 180, and XX ranges from 0 to 59.
  • The DD format is XXX.XXXXXXXXX. XXX ranges from 0 to 180, and XXXXXXXXX is a decimal supporting a maximum of 9 digits.
longitude w longitude-value

Specifies the west longitude value of an AP.

The value supports two formats: DMS and DD.
  • The DMS format is XXX-XX-XX. XXX ranges from 0 to 180, and XX ranges from 0 to 59.
  • The DD format is XXX.XXXXXXXXX. XXX ranges from 0 to 180, and XXXXXXXXX is a decimal supporting a maximum of 9 digits.
latitude s latitude-value

Specifies the south longitude value of an AP.

The value supports two formats: DMS and DD.
  • The DMS format is XX-XX-XX. The first XX ranges from 0 to 90, and the other XXs range from 0 to 59.
  • The DD format is XX.XXXXXXXXX. XX ranges from 0 to 90, and XXXXXXXXX is a decimal supporting a maximum of 9 digits.
latitude n latitude-value

Specifies the north longitude value of an AP.

The value supports two formats: DMS and DD.
  • The DMS format is XX-XX-XX. The first XX ranges from 0 to 90, and the other XXs range from 0 to 59.
  • The DD format is XX.XXXXXXXXX. XX ranges from 0 to 90, and XXXXXXXXX is a decimal supporting a maximum of 9 digits.

Views

AP view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run this command to set the longitude and latitude of an AP for easily locating it.

Example

# Set the longitude and latitude of an AP to 114.3435°E and 14.3435°S, respectively.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] ap-id 0
[HUAWEI-wlan-ap-0] coordinate longitude e 114.3435 latitude s 14.3435
Related Topics

copy-from

Function

The copy-from command copies data to the current profile from a profile of the same type.

Format

copy-from profile-name

Parameters

Parameter

Description

Value

profile-name

Specifies the name of the profile from which data is copied.

The profile name must already exist.

Views

All WLAN profile views

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the copy-from command to copy data to the current profile from a profile of the same type. This simplifies profile configuration and improves configuration efficiency.
  • To create a profile that has the same configuration as an existing profile, enter the view of the profile to be created and run the copy-from command to copy data from the existing profile.
  • To create a profile that has most configurations the same as an existing profile, enter the view of the profile to be created, run the copy-from command to copy data from the existing profile, and modify the different configurations.

Precautions

If the current profile is referenced by another profile, you cannot run the command to copy data to the current profile.

Example

# Create the VAP profile huawei and copy data from the profile sample.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] vap-profile name huawei
[HUAWEI-wlan-vap-prof-huawei] copy-from sample

country-code

Function

The country-code command configures a country code.

The undo country-code command restores the default country code.

By default, the country code CN is configured.

Format

country-code country-code

undo country-code

Parameters

Parameter

Description

Value

country-code

Specifies a country code.

The value is a string of characters in enumerated type. For specific values, see Table 11-2.

Views

Regulatory domain profile view

Default Level

2: Configuration level

Usage Guidelines

Table 11-2  Country codes supported by ACs

Country Code

Country/Region

AE

United Arab Emirates

AM

Armenia

AR

Argentina

AT

Austria

AU

Australia

AZ

Azerbaijan

BE

Belgium

BG

Bulgaria

BH

Bahrain

BN

Brunei Darussalam

BO

Bolivia

BR

Brazil

BY

Belarus

BZ

Belize

CA

Canada

CH

Switzerland

CL

Chile

CN

China (default)

CO

Colombia

CR

Costa Rica

CY

Cyprus

CZ

Czech Republic

DE

Germany

DK

Denmark

DO

Dominican Republic

EC

Ecuador

EE

Estonia

EG

Egypt

ES

Spain

FI

Finland

FR

France

GB

United Kingdom

GE

Georgia

GR

Greece

GT

Guatemala

HK

Hong Kong, Special Administrative Region of China

HN

Honduras

HR

Croatia

HU

Hungary

ID

Indonesia

IE

Ireland

IL

Israel

IN

India

IQ

Iraq

IR

Iran

IS

Iceland

IT

Italy

JO

Jordan

JP

Japan

KP

Democratic People's Republic of Korea

KR

Republic of Korea

KW

Kuwait

KZ

Kazakhstan

LB

Lebanon

LI

Liechtenstein

LK

Sri Lanka

LT

Lithuania

LU

Luxembourg

LV

Latvia

MA

Morocco

MC

Monaco

MK

Macedonia

MO

Macau, Special Administrative Region of China

MT

Malta

MX

Mexico

MY

Malaysia

NG

Nigeria

NL

Netherlands

NO

Norway

NZ

New Zealand

OM

Oman

PA

Panama

PE

Peru

PH

Philippines

PK

Pakistan

PL

Poland

PR

Puerto Rico

PT

Portugal

QA

Qatar

RO

Romania

RS

SERBIA

RU

Russia

SA

Saudi Arabia

SE

Sweden

SG

Singapore

SI

Slovenia

SK

Slovakia

SV

El Salvador

SY

Syria

TH

Thailand

TN

Tunisia

TR

Turkey

TT

Trinidad & Tobago

TW

Taiwan, Province of China

UA

Ukraine

US

United States

UY

Uruguay

UZ

Uzbekistan

VE

Venezuela

VN

Vietnam

YE

Yemen

ZA

South Africa

ZW

Zimbabwe

Usage Scenario

When an AC controls APs in different countries or regions, different country codes can be configured based on the regulatory domain profile to meet different radio requirements in different countries or regions, such as power requirements and channel requirements.

Configuration Impact

Modifying the country code in a regulatory domain profile will restart APs using the profile.

Example

# Set the country code to US in the regulatory domain profile region1.
<HUAWEI> system-view                  
[HUAWEI] wlan                            
[HUAWEI-wlan-view] regulatory-domain-profile name region1           
[HUAWEI-wlan-regulate-domain-region1] country-code us        
Warning: Modifying the country code will clear channel, power and antenna gain configurations of the radio and reset the AP. Continu
e?[Y/N]:y

coverage distance

Function

(AP group radio view) The coverage distance command configures the radio coverage distance parameter for all specified radios in an AP group.

(AP group radio view) The undo coverage distance command restores the default radio coverage distance parameter for all specified radios in an AP group.

(AP radio view) The coverage distance command configures the radio coverage distance parameter for an AP radio.

(AP radio view) The undo coverage distance command cancels the configuration of the radio coverage distance parameter on an AP radio. The radio coverage distance parameter on the AP radio is then determined by that configured in the AP group radio view.

By default, the radio coverage distance parameter is 3 (unit: 100 m) for all radios.

Format

coverage distance distance

undo coverage distance

Parameters

Parameter

Description

Value

distance

Specifies the radio coverage distance parameter.

Each distance parameter corresponds to a group of slottime, acktimeout, and ctstimeout values. You can configure the distance parameter based on the AP distance. APs adjust the values of slottime, acktimeout, and ctstimeout values based on the distance parameter.

The value is an integer that ranges from 1 to 400, in 100 meters.

Views

AP radio view, AP group radio view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In actual application scenarios, two APs may be connected over dozens of meters to dozens of kilometers. Due to different AP distances, the time to wait for ACK packets from the peer AP varies. A proper acktimeout value can improve data transmission efficiency between APs.

You can configure the radio coverage distance parameter based on distances between APs and the APs automatically adjust the values of slottime, acktimeout, and ctstimeout based on the configured distance parameter to improve data transmission efficiency.

Precautions

The configuration in the AP radio view has a higher priority than that in the AP group radio view.

Example

# Set the radio coverage distance parameter to 2 for radio 0 of AP 1.
<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-id 1
[HUAWEI-wlan-ap-1] radio 0
[HUAWEI-wlan-radio-1/0] coverage distance 2

cpu-usage threshold

Function

The cpu-usage threshold command configures a CPU usage alarm threshold for APs.

The undo cpu-usage threshold command restores the default CPU usage alarm threshold.

By default, the CPU usage alarm threshold of APs is 90.

Format

cpu-usage threshold threshold

undo cpu-usage threshold

Parameters

Parameter

Description

Value

threshold

Specifies the CPU usage alarm threshold of APs.

The value is an integer that ranges from 50 to 100.

Views

AP system profile view

Default Level

2: Configuration level

Usage Guidelines

You can run the cpu-usage threshold command to configure the CPU usage alarm threshold in the AP system profile view. The configuration is delivered to all APs using the profile.
  • When the CPU usage of an AP exceeds the alarm threshold, the AP sends an alarm message to the AC, and the AC displays the alarm information.
  • When the CPU usage of an AP falls below the alarm threshold, the AP sends a clear alarm message to the AC, and the AC displays the clear alarm information.

Example

# Set the CPU usage alarm threshold to 60.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-system-profile name ap-system1
[HUAWEI-wlan-ap-system-prof-ap-system1] cpu-usage threshold 60

dai enable (AP wired port profile view)

Function

The dai enable command enables dynamic ARP inspection (DAI) on an AP's wired interface.

The undo dai enable command disables DAI on an AP's wired interface.

By default, DAI is disabled on an AP's wired interface.

Format

dai enable

undo dai enable

Parameters

None

Views

AP wired port profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can enable DAI using this command to prevent Man in The Middle (MITM) attacks and theft on authorized user information. When a device receives an ARP packet, it compares the source IP address, source MAC address, interface number, and VLAN ID of the ARP packet with DHCP snooping binding entries. If the ARP packet matches a binding entry, the device allows the packet to pass through. If the ARP packet does not match any binding entry, the device discards the packet.

Prerequisites

Terminal address learning has been enabled on the AP's wired interface using the learn-client-address ipv4 enable command.

Follow-up Procedure

Bind the AP wired port profile to an AP group or AP.

Precautions

This command takes effect only on ARP packets transmitted on an AP's wired interface.

The AP wired interfaces added to an Eth-trunk interface do not support this function.

Example

# Enable DAI on an AP's wired interface.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] wired-port-profile name wire1
[HUAWEI-wlan-wired-port-wire1] dai enable

deny-broadcast-probe enable

Function

The deny-broadcast-probe enable command configures an AP not to respond to broadcast Probe Request frames.

The undo deny-broadcast-probe enable command configures an AP to respond to broadcast Probe Request frames.

By default, an AP responds to broadcast Probe Request frames.

Format

deny-broadcast-probe enable

undo deny-broadcast-probe enable

Parameters

None

Views

SSID profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In high-density wireless scenarios, too many Probe Response frames occupy a large number of wireless resources. To reduce wireless resource occupation of the frames and improve channel usage efficiency, you can run the deny-broadcast-probe enable command to configure an AP not to respond to broadcast Probe Request frames.

Precautions

Configuring an AP not to respond to broadcast Probe Request frames may reduce channel scan efficiency of some STAs.

Example

# Configure an AP not to respond to broadcast Probe Request frames.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ssid-profile name ssid1
[HUAWEI-wlan-ssid-prof-ssid1] deny-broadcast-probe enable
Related Topics

description (AP wired port profile view)

Function

The description command configures the description of an AP wired port.

The undo description command restores the default description of an AP wired port.

By default, the port has no description.

Format

description description

undo description

Parameters

Parameter

Description

Value

description

Specifies the AP interface description.

The value is a string of 1 to 242 case-sensitive characters with spaces.

Views

AP wired port profile view

Default Level

2: Configuration level

Usage Guidelines

To manage AP interfaces conveniently, run this command to set AP interface descriptions. The description of an AP interface helps you identify the AP interface and know its functions.

Example

# Change the description of the AP's wired interface to poe-power.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] wired-port-profile name wired-port1
[HUAWEI-wlan-wired-port-wired-port1] description poe-power

dhcp option82 insert enable

Function

The dhcp option82 insert enable command enables the function of adding the Option 82 field to DHCP packets sent by STAs.

The undo dhcp option82 insert enable command disables the function of adding the Option 82 field to DHCP packets sent by STAs.

By default, the function of adding the Option 82 field to DHCP packets sent by STAs is disabled.

Format

dhcp option82 insert enable

undo dhcp option82 insert enable

Parameters

None

Views

VAP profile view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After going online, a STA obtains the IP address through DHCP. When the DHCP Request packet from the STA reaches an AP, the AP adds the Option 82 field to the packet and sends the packet to the DHCP server. The Option 82 field contains the MAC address or SSID of the associated AP. Therefore, the DHCP server knows the AP on which the STA goes online.

Prerequisites

Before enabling the function of adding the Option 82 field to DHCP packets sent by STAs, run the undo learn-client-address disable command to enable the STA IP address learning. By default, STA IP address learning is enabled.

Example

# Enable the function of adding the Option 82 field to DHCP packets sent by STAs.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] vap-profile name vap1
[HUAWEI-wlan-vap-prof-vap1] dhcp option82 insert enable

dhcp option82 format (vap profile view)

Function

The dhcp option82 format command configures the format of the Option 82 field in DHCP packets sent by STAs.

The undo dhcp option82 format command restores the default format of the Option 82 field in DHCP packets sent by STAs.

By default, the format of the Option 82 field inserted in DHCP packets sent by STAs is ap-mac.

Format

dhcp option82 { circuit-id | remote-id } format { ap-mac [ mac-format { normal | compact | hex } ] | ap-mac-ssid [ mac-format { normal | compact } ] | user-defined text | ap-name | ap-name-ssid }

undo dhcp option82 { circuit-id | remote-id } format

Parameters

Parameter Description Value
circuit-id Specifies the circuit-ID (CID) in the Option 82 field. -
remote-id Specifies the remote-ID (RID) in the Option 82 field. -
ap-mac Indicates that Option 82 contains the AP's MAC address. -
ap-mac-ssid Indicates that Option 82 contains the AP's MAC address and SSID. -
mac-format Specifies the format of the AP's MAC address in Option 82. -
normal Sets the MAC address format to xx-xx-xx-xx-xx-xx. -
compact Sets the MAC address format to xxxx-xxxx-xxxx. -
hex Sets the MAC address format to XXXXXXXXXXXX in hexadecimal notation. -
user-defined text Sets the format of Option 82 to the user-defined format. The value is a string of 1 to 255 characters.
ap-name Specifies the AP name in the Option 82 field. -
ap-name-ssid Specifies the AP name and SSID in the Option 82 field. -

Views

VAP profile view

Default Level

2: Configuration level

Usage Guidelines

After an AP is enabled to insert the Option 82 field in DHCP packets sent from a STA, you can run the dhcp option82 format command to configure the format of the Option 82 field.

You can use the following keywords to define the Option 82 field.
  • ap-mac: MAC address of the AP. After DHCP packets from a STA reach an AP, the AP inserts its MAC address into the Option 82 field of the DHCP packets.
  • ap-mac-ssid: MAC address and SSID of the AP. After DHCP packets from a STA reach an AP, the AP inserts its MAC address and SSID associated with the STA into the Option 82 field of the DHCP packets.
  • ap-name: AP name. After DHCP packets from a STA reach an AP, the AP inserts its name into the Option 82 field of the DHCP packets.
  • ap-name-ssid: AP name and SSID. After DHCP packets from a STA reach an AP, the AP inserts its name and associated SSID into the Option 82 field of the DHCP packets.

If mac-format is not specified in the dhcp option82 { circuit-id | remote-id } format { ap-mac | ap-mac-ssid } command, the AP MAC address in the Option 82 field is XXXXXXXXXXXX in ASCII format.

The total length of the circuit-id and remote-id options in the Option 82 field cannot exceed 255 bytes. Otherwise, some Option 82 information may be lost. Note that a Chinese character may occupy 2 or 3 bytes.

Example

# Set the format of remote-id in Option 82 carried in DHCP packets sent by STAs to ap-mac-ssid.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] vap-profile name vap1
[HUAWEI-wlan-vap-prof-vap1] dhcp option82 remote-id format ap-mac-ssid

display ac global configuration

Function

The display ac global configuration command displays AC global configuration.

Format

display ac global configuration

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to view AC global information.

Example

# Display AC global configuration.

<HUAWEI> display ac global configuration
--------------------------------------------------------------------------------
AC sysnetid                        : AC
--------------------------------------------------------------------------------
Table 11-3  Description of the display ac global configuration command output
Item Description

AC sysnetid

NE name of an AC.

To configure the NE name for an AC, run the ac sysnetid command.

Related Topics

display ap

Function

The display ap command displays AP information.

Format

display ap { all | ap-group ap-group }

display ap [ ap-group ap-group ] by-ssid ssid

display ap by-state state [ ap-group ap-group ]

Parameters

Parameter

Description

Value

all

Displays information about all APs.

-

ap-group ap-group

Specifies the group to which an AP belongs.

The AP group must exist.

by-ssid ssid

Specifies an SSID.

The value must be an existing SSID.

by-state state

Specifies the status of the AP.

Enumerated type.

  • commit-failed: Displays information about APs in configuration commitment failed state.
  • committing: Displays information about APs in configuration committing state.
  • config: Displays information about APs in configuration initialization state.
  • config-failed: Displays information about APs in initialization failed state.
  • download: Displays information about APs in system software downloading state.
  • fault: Displays information about APs that failed to go online.
  • idle: Displays information about APs in initialization state before the first link is established.
  • name-conflicted: Displays information about APs having duplicate names.
  • normal: Displays information about APs in normal state.
  • standby: Displays information about APs in standby AC state.
  • ver-mismatch: Displays information about APs with versions that do not match the AC version.
  • countrycode-mismatch: Displays information about APs with country codes that do not match the AC's country code.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To view information about APs, run this command.

Example

# Display information about all APs.
<HUAWEI> display ap all
Total AP information:
nor  : normal          [2]
Extra information:
P  : insufficient power supply
----------------------------------------------------------------------------------------------------
ID   MAC            Name   Group     IP              Type            State STA Uptime      ExtraInfo
----------------------------------------------------------------------------------------------------
0    dcd2-fcf6-76a0 area_1 ap-group1 192.168.120.254 AP6010DN-AGN    nor   0   4H:49M:11S  P
1    60de-4474-9640 area_2 ap-group1 192.168.120.253 AP5010DN-AGN    nor   0   6H:3M:40S   -
----------------------------------------------------------------------------------------------------
Total: 2
# Display information about APs bound to SSID hw-wlan.
<HUAWEI> display ap by-ssid hw-wlan
Total AP information:
nor  : normal          [2]
Extra information:
P  : insufficient power supply
----------------------------------------------------------------------------------------------------
ID   MAC            Name   Group     IP              Type            State STA Uptime      ExtraInfo
----------------------------------------------------------------------------------------------------
0    dcd2-fcf6-76a0 area_1 ap-group1 192.168.120.254 AP6010DN-AGN    nor   0   4H:49M:11S  P
1    60de-4474-9640 area_2 ap-group1 192.168.120.253 AP5010DN-AGN    nor   0   6H:3M:40S   -
----------------------------------------------------------------------------------------------------
Total: 2
# Display information about APs in normal state.
<HUAWEI> display ap by-state normal
Total AP information:
nor  : normal          [2]
Extra information:
P  : insufficient power supply
--------------------------------------------------------------------------------------------------------------
ID   MAC            Name   Group     IP              Type            State           STA Uptime      ExtraInfo
--------------------------------------------------------------------------------------------------------------
0    dcd2-fcf6-76a0 area_1 ap-group1 192.168.120.254 AP6010DN-AGN    normal          0   4H:50M:55S  P
1    60de-4474-9640 area_2 ap-group1 192.168.120.253 AP5010DN-AGN    normal          0   6H:5M:24S   -
--------------------------------------------------------------------------------------------------------------
Total: 2
Table 11-4  Description of the display ap command output
Item Description
ID AP ID.
MAC MAC address of an AP.
Name AP name.
Group AP group.
IP AP IP address.
Type AP type.
State

AP state. For details, see Table 11-5.

STA Number of STAs connected to an AP.
Uptime Online duration of an AP.
ExtraInfo Extra information. The value P indicates that the power supply to an AP is insufficient.
Table 11-5  AP state list

AP State

Description

Possible Cause

Handling Suggestion

commit-failed

WLAN service configurations fail to be delivered to an AP after the AP goes online on an AC.

After the AP goes online on the AC, WLAN service configurations are performed for the AP. If the link between the AP and AC is disconnected or the peer end has no response, the AP enters the commit-failed state.

Check the network connection.

committing

WLAN service configurations are being delivered to an AP after the AP goes online on an AC.

After the AP goes online on the AC, WLAN service configurations are being delivered to the AP.

This is a normal state, and no action is required.

config

WLAN service configurations are being delivered to an AP when the AP is going online on an AC.

After the AP establishes a link with the AC, WLAN service configurations are delivered to the AP. During this process, the AP is in config state.

This is a normal state, and no action is required.

config-failed

WLAN service configurations fail to be delivered to an AP when the AP is going online on an AC.

After the AP establishes a link with the AC, WLAN service configurations are delivered to the AP. If the configuration delivery fails due to various reasons (such as link disconnection), the AP enters the config-failed state.

Check the network connection.

download

An AP is in upgrade state.

When the AP is performing an upgrade, it enters the download state.

When the AP upgrade is complete, check the AP state.

fault

An AP fails to go online.

The AP fails to go online, which is usually caused by the following:
  • The AP fails to obtain an IP address or obtains an incorrect IP address.
  • The network between the AP and AC is faulty.
  • The AP fails to be authenticated.
  • The number of APs on an AC has reached the maximum value.
  • The AP is faulty.

Handle the AP online failure. For details, see AP Online Failure in the Troubleshooting Insights.

idle

It is the initialization state of an AP before it establishes a link with the AC for the first time.

The AP has not established a CAPWAP link with the AC, the MAC address and SN of the AP that is added offline are different from the actual ones, or license resources are insufficient.

Perform the following operations.

Check whether the AP is connected to the network. If the AP connection is normal, go to next step.

Check the MAC address and SN of the AP that is added offline are different from the actual MAC address and SN of the AP. If not, perform the following operations:
  1. Run the display ap all command to obtain AP information.
  2. Run the undo ap { ap-name ap-name | ap-id ap-id | ap-mac ap-mac | ap-group group-name | all } command to delete the AP.
  3. Run the

    ap-id ap-id [ [ type-id type-id | ap-type ap-type ] { ap-mac ap-mac | ap-sn ap-sn | ap-mac ap-mac ap-sn ap-sn } ]

    or ap-mac ap-mac [ type-id type-id | ap-type ap-type ] [ ap-id ap-id ] [ ap-sn ap-sn ] command to add correct AP information.

If the fault persists, expand the license capacity. Note that RUs managed by the AC do not occupy license resources of the AC.

name-conflicted

The name of an AP conflicts with that of an existing AP.

The name of an AP conflicts with the name of another AP that has been online on the same AC.

Run the ap-rename ap-id ap-id new-name ap-new-name command to change the AP name.

normal

An AP is working properly.

An AP successfully goes online on an AC.

This is a normal state, and no action is required.

standby

The AP is in normal state on the standby AC.

In the HSB, dual-link cold backup, or N+1 backup scenario, if the link between the active and standby ACs is established properly, the AP is in standby state on the standby AC and in normal state on the active AC.

This is a normal state, and no action is required.

ver-mismatch

The version of an AP does not match that of an AC on which the AP is to go online.

The versions of the AP and the AC mismatch.

Log in to Huawei technical support website and download the release notes. Based on the version mapping, upgrade the AP or AC to the matching version.

countryCode-mismatch

The country code of an AP does not match that of the AC on which the AP is about to go online.

The current version of the AP does not support the country code configured on the AC.

The AP does not support the country code. Upgrade the AP or change the country code configured on the AC.

unauthed

The AP is not authenticated.

The AP fails to be authenticated.

Run the ap-confirm command to confirm unauthenticated APs and allow them to go online.

Related Topics

display ap around-ssid-list

Function

The display ap around-ssid-list command displays SSIDs of neighbors of a specified AP.

Format

display ap around-ssid-list { ap-name ap-name | ap-id ap-id }

Parameters

Parameter

Description

Value

ap-name ap-name

Specifies an AP name.

The AP name must exist.

ap-id ap-id

Specifies an AP ID.

The AP ID must exist.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to view SSIDs of neighbors of a specified AP. Neighbors of an AP include authorized and unauthorized neighbors. Authorized neighbors are other APs managed by the same AC. APs that are managed by other ACs are unauthorized neighbors.

Example

# Display SSIDs of neighbors of AP huawei.
<HUAWEI> display ap around-ssid-list ap-name huawei
In control AP(2.4G):
---------------------------------------------------
SSID
---------------------------------------------------
test1
---------------------------------------------------
Total: 1
Uncontrol AP(2.4G):
---------------------------------------------------
SSID
---------------------------------------------------
test2
---------------------------------------------------
Total: 1
In control AP(5G):
---------------------------------------------------
SSID
---------------------------------------------------
test3
---------------------------------------------------
Total: 1
Uncontrol AP(5G):
---------------------------------------------------
SSID
---------------------------------------------------
test4
---------------------------------------------------
Total: 1
Table 11-6  Description of the display ap around-ssid-list command output
Item Description

In control AP

SSIDs of authorized neighbors.

Uncontrol AP

SSIDs of unauthorized neighbors.

display ap asyn-message err-info

Function

The display ap asyn-message err-info command displays records about AP restart failures.

Format

display ap asyn-message err-info { all | ap-name ap-name | ap-id ap-id }

Parameters

Parameter

Description

Value

all

Displays records about restart failures of all APs.

-

ap-name ap-name

Displays records about restart failures of the AP with a specified name.

The AP name must exist.

ap-id ap-id

Displays records about restart failures of the AP with a specified ID.

The AP ID must exist.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

When you use commands on the AC to restart an AP manually, during an upgrade, or to restore its factory settings, the restart message delivered by the AC may get lost due to transmission failures. Therefore, APs are not restarted. If an AP does not receive the restart message, the AP is still connected to the AC, which makes the AC incorrectly consider that the AP is restarted successfully. This command displays records about AP restart failures, helping you check whether the AP is restarted successfully. If the AP restart fails, restart the AP.

Example

# Display records about restart failures of all APs.

<HUAWEI> display ap asyn-message err-info all
------------------------------------------------------------------------------  
AP Name MAC            Time                    Reason                           
------------------------------------------------------------------------------  
hw1     dcd2-fcf4-6600 2015-1-19 14:41:59      update
hw2     dcd2-fcf4-8800 2015-1-19 14:45:56      clear config
------------------------------------------------------------------------------  
Total: 2 
Table 11-7  Description of the display ap asyn-message err-info command output

Item

Description

AP Name

Name of an AP.

MAC

MAC address of an AP.

Time

Time when AP restart fails.

Reason

Type of AP restart failures.
  • update: The AP fails to be restarted during an upgrade.
  • clear config: The AP fails to be restarted when restoring factory settings.
  • other: The AP fails to be restarted manually.

display ap blacklist

Function

The display ap blacklist command displays the AP blacklist.

Format

display ap blacklist

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

This command displays APs in the blacklist. These APs are not allowed to go online on the AC. If an AP is online on the AC but is in the blacklist, the AP is forced to log out.

Example

# Display the AP blacklist.

<HUAWEI> display ap blacklist
--------------------------------------------------------------------------------
ID     MAC                                                                      
--------------------------------------------------------------------------------
0      0001-0002-0001
--------------------------------------------------------------------------------
Total: 1 
Table 11-8  Description of the display ap blacklist command output

Item

Description

ID

ID of the MAC address in the AP blacklist. The ID is generated automatically when the MAC address is specified.

MAC

MAC addresses of the APs that are not allowed to connect to the AC.

To add MAC addresses to the AP blacklist, run the ap blacklist command.

Related Topics

display ap config-info

Function

The display ap config-info command displays AP configuration.

Format

display ap config-info { ap-name ap-name | ap-id ap-id }

Parameters

Parameter

Description

Value

ap-name ap-name

Displays configuration of the AP with a specified name.

The AP name must exist.

ap-id ap-id

Displays configuration of the AP with a specified ID.

The AP ID must exist.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display ap config-info command to view AP configuration information, including the basic configuration, radio configuration, VAP configuration, and profile configuration.

Example

# Display the configuration of AP huawei.

<HUAWEI> display ap config-info ap-name huawei
--------------------------------------------------------------------------------
AP MAC                          : dcd2-fcf6-76a0
AP SN                           : 210235419610D2000097
AP type                         : AP6010DN-AGN
AP name                         : huawei
AP group                        : default
Country code                    : CN
--------------------------------------------------------------------------------
Radio 0 configurations:
 Radio enable                   : yes
 Work mode                      : normal
 WDS  mode                      : -
 Mesh mode                      : -
 Radio band                     : 2.4G
 Radio type                     : bgn
 Config channel/bandwidth       : -/20M
 Actual channel/bandwidth       : 1/20M
 Config EIRP                    : 127
 Actual EIRP                    : 27
 Maximum EIRP                   : 27

 VAP configurations:
  WLAN ID 1:
   SSID                         : HUAWEI-WLAN
   Forward mode                 : direct-forward
   Authen mode                  : Open
   Encrypt mode                 : -
   Service vlan                 : 100
--------------------------------------------------------------------------------
Radio 1 configurations:
 Radio enable                   : yes
 Work mode                      : normal
 WDS  mode                      : -
 Mesh mode                      : -
 Radio band                     : 5G
 Radio type                     : an
 Config channel/bandwidth       : -/20M
 Actual channel/bandwidth       : 157/20M
 Config EIRP                    : 127
 Actual EIRP                    : 28
 Maximum EIRP                   : 28

 VAP configurations:
  WLAN ID 1:
   SSID                         : HUAWEI-WLAN
   Forward mode                 : direct-forward
   Authen mode                  : Open
   Encrypt mode                 : -
   Service vlan                 : pool a
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
AP system profile          : default
Regulatory domain profile  : default
WIDS profile               : default
BLE profile                :
UUID                       :
AP wired port profile
 Interface FE0             : default
 Interface FE1             : default
 Interface FE2             : default
 Interface FE3             : default
 Interface GE0             : default
 Interface GE1             : default
 Interface GE2             : default
 Interface GE3             : default
 Interface GE4             : default
 Interface GE5             : default
 Interface GE6             : default
 Interface GE7             : default
 Interface GE8             : default
 Interface GE9             : default
 Interface GE10            : default
 Interface GE11            : default
 Interface GE12            : default
 Interface GE13            : default
 Interface GE14            : default
 Interface GE15            : default
 Interface GE16            : default
 Interface GE17            : default
 Interface GE18            : default
 Interface GE19            : default
 Interface GE20            : default
 Interface GE21            : default
 Interface GE22            : default
 Interface GE23            : default
 Interface GE24            : default
 Interface GE25            : default
 Interface GE26            : default
 Interface GE27            : default
 Interface MultiGE0       : default
 Interface XGE0            : default
 Interface XGE1            : default
 Interface XGE2            : default
 Interface XGE3            : default
 Interface Eth-trunk0      : default
Radio 0
 Radio 2.4G profile        : default
 Radio 5G profile          : 
 VAP profile
  WLAN  1                  : default(VLAN 100)
 Mesh profile              :
 WDS profile               :
 Mesh whitelist profile    :
 WDS whitelist profile     :
 Location profile          :
 Radio switch              : enable
 Channel                   : -
 Channel bandwidth         : 20mhz
 EIRP(dBm)                 : 127
 Antenna gain(dB)          : -
 Coverage distance(100 m)  : 3
 Work mode                 : normal
 Radio frequency           : 2.4G
 Spectrum analysis         : disable
 WIDS device detect        : disable
 WIDS attack detect        : -
 WIDS contain switch       : disable
Radio 1
 Radio 2.4G profile       : 
 Radio 5G profile          : default
 VAP profile
  WLAN  1                  : default(VLAN pool a)
 Mesh profile              :
 WDS profile               :
 Mesh whitelist profile    :
 WDS whitelist profile     :
 Location profile          :
 Radio switch              : enable
 Channel                   : -
 Channel bandwidth         : 20mhz
 EIRP(dBm)                 : 127
 Antenna gain(dB)          : -
 Coverage distance(100 m)  : 3
 Work mode                 : normal
 Radio frequency           : 5G
 Spectrum analysis         : disable
 WIDS device detect        : disable
 WIDS attack detect        : -
 WIDS contain switch       : disable
Card 1:
 Serial profile            : preset-enjoyor-toeap
 Wired port profile        :
 Iot profile               :
 UDP Port                  : -
 TCP Port                  : - 
Card 2
 Serial profile            : preset-enjoyor-toeap
 Wired port profile        :
 Iot profile               :
 UDP Port                  : -
 TCP Port                  : - 
Card 3
 Serial profile            : preset-enjoyor-toeap
 Wired port profile        :
 Iot profile               :
 UDP Port                  : 
 TCP Port                  : - 
Card usb
 Serial profile            :
 Iot profile               :
 UDP Port                  : -
 TCP Port                  : -
---------------------------------------------------------------------------------
Table 11-9  Description of the display ap config-info command output

Item

Description

AP MAC

MAC address of an AP.

AP SN

SN of an AP.

AP type

AP type.

AP name

AP name.

To configure the parameter, run the ap-name (AP view) or ap-rename command.

AP group

AP group.

To configure the parameter, run the ap-group (AP view) or ap-regroup command.

Country code

Country code.

To configure the parameter, run the country-code command.

Radio 0 configurations/Radio 1 configurations

Radio configuration.

Radio enable

Radio status.

To configure the parameter, run the radio disable command.

Work mode

Working mode of a radio.

To configure the parameter, run the work-mode command.

WDS mode

WDS mode.

To configure the parameter, run the wds-mode command.

Mesh mode

Mesh role of a radio.

To configure the parameter, run the mesh-role command.

Radio band

Frequency band of a radio.

To configure the parameter, run the frequency command.

Radio type

Protocol type of a radio.

Config channel/bandwidth

Configured AP channel and bandwidth.

To configure the parameter, run the channel command.

Actual channel/bandwidth

Actual AP channel and bandwidth.

Config EIRP

Transmit power of a radio configured in the radio profile.

To configure the parameter, run the eirp command.

Actual EIRP

Actual transmit power of a radio.

Maximum EIRP

Maximum transmit power of a radio.

VAP configurations

VAP configuration. VAP configuration is displayed only after a VAP profile is referenced by the AP.

WLAN ID 1

WLAN ID of a VAP.

To configure the parameter, run the vap-profile command.

SSID

SSID name.

To configure the parameter, run the ssid command.

Forward mode

Forwarding mode.

To configure the parameter, run the forward-mode command.

Authen mode

Authentication mode.

Encrypt mode

Encryption mode.

Service vlan

Effective service VLAN.

AP system profile

Name of the referenced AP system profile.

To configure the parameter, run the ap-system-profile (AP group view and AP view) command.

Regulatory domain profile

Name of the referenced regulatory domain profile.

To configure the parameter, run the regulatory-domain-profile command.

WIDS profile

Name of the referenced WIDS profile.

To configure the parameter, run the wids-profile (AP group view and AP view) command.

BLE profile

Name of the referenced BLE profile.

UUID UUID of a BLE broadcast frame sent by the AP's built-in Bluetooth module.

To configure the parameter, run the broadcasting-content (AP group view and AP view) command.

AP wired port profile

Name of the referenced AP wired port profile.

To configure the parameter, run the wired-port-profile (AP group view and view) command.

Interface interface-name

Interface name and number.

Radio 0/Radio 1

Radio frequency.

Radio 2.4G profile

Name of the referenced 2G radio profile.

To configure the parameter, run the radio-2g-profile command.

Radio 5G profile

Name of the referenced 5G radio profile.

To configure the parameter, run the radio-5g-profile command.

VAP profile

Name of the referenced VAP profile.The displayed format is "VAP ID:VAP profile name (service VLAN defined when binding to the VAP profile, single VLAN, or VLAN pool)."

To configure the parameter, run the vap-profile command.

Mesh profile

Name of the referenced Mesh profile.

To configure the parameter, run the mesh-profile radio command.

WDS profile

Name of the referenced WDS profile.

To configure the parameter, run the wds-profile radio command.

Mesh whitelist profile Mesh whitelist profile referenced by an AP group.

To configure the parameter, run the mesh-whitelist-profile (AP group radio view or AP radio view) command.

WDS whitelist profile WDS whitelist profile referenced by an AP group.

To configure the parameter, run the wds-whitelist-profile (AP group radio view or AP radio view) command.

Location profile

Name of the referenced location profile.

To configure the parameter, run the location-profile command.

Radio switch

Radio status.

To configure the parameter, run the radio disable command.

Channel

Working channel of a radio.

To configure the parameter, run the channel command.

Channel bandwidth

Working bandwidth of a radio.

To configure the parameter, run the channel command.

EIRP(dBm)

Transmit power of a radio, in dBm.

To configure the parameter, run the eirp command.

Antenna gain(dB)

Antenna gain of a radio, in dB.

To configure the parameter, run the antenna-gain command.

Coverage distance(100 m)

Radio coverage distance parameter, in 100 m.

To configure the parameter, run the coverage distance command.

Work mode

Working mode of an AP.

To configure the parameter, run the work-mode command.

Radio frequency

Working frequency band of a radio.

To configure the parameter, run the frequency command.

Spectrum analysis

Whether spectrum analysis is enabled.

To configure the parameter, run the spectrum-analysis enable command.

WIDS device detect

Whether wireless device detection is enabled.

To configure the parameter, run the wids device detect enable command.

WIDS attack detect

Whether attack detection is enabled.

To configure the parameter, run the wids attack detect enable command.

WIDS contain switch

Whether rogue device containment is enabled.

To configure the parameter, run the wids contain enable command.

Card 1/Card 2/Card 3/Card usb IoT card.
Serial profile Bound serial profile.

To configure the parameter, run the serial-profile (IoT card interface view) command.

Iot profile Bound IoT profile.

To configure the parameter, run the iot-profile (IoT card interface view) command.

UDP Port UDP port.
Wired port profile Bound AP wired port profile.

To configure the parameter, run the wired-port-profile (IoT card interface view) command.

TCP Port TCP port.

display ap configurable channel

Function

The display ap configurable channel command displays the configurable channels supported by a specified AP.

Format

display ap configurable channel { ap-name ap-name | ap-id ap-id } [ radio-id radio-id ]

Parameters

Parameter

Description

Value

ap-name ap-name

Displays configurable channels supported by the AP with the specified name.

The AP name must exist.
ap-id ap-id

Displays configurable channels supported by the AP with the specified ID.

The AP ID must exist.
radio-id radio-id

Displays configurable channels supported by the specified radio.

The radio ID must exist.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Different countries or regions use different wireless channels and powers. Setting country and area codes can specify channels that can be used on WLANs of different countries. The display ap configurable channel command displays the configurable channels supported by a specified AP.

Example

# Display configurable channels supported by AP huawei.

<HUAWEI> display ap configurable channel ap-name huawei
2.4G 20M : 1,2,3,4,5,6,7,8,9,10,11,12,13.
2.4G 40M+: 1,2,3,4,5,6,7,8,9.
2.4G 40M-: 5,6,7,8,9,10,11,12,13.
5G   20M : 36,40,44,48,52,56,60,64,100,104,108,112,116,120,124,128,132,136,140,149,153,157,161,165.
5G   40M+: 36,44,52,60,100,108,116,124,132,149,157.
5G   40M-: 40,48,56,64,104,112,120,128,136,153,161.
5G   80M : 36,40,44,48,52,56,60,64,100,104,108,112,116,120,124,128,149,153,157,161.
5G  160M : 36,40,44,48,52,56,60,64,100,104,108,112,116,120,124,128.
5G 80+80M: 36+106, 36+122, 36+155, 40+106, 40+122, 40+155, 44+106, 44+122, 
           44+155, 48+106, 48+122, 48+155, 52+106, 52+122, 52+155, 56+106, 
           56+122, 56+155, 60+106, 60+122, 60+155, 64+106, 64+122, 64+155, 
           100+42, 100+58, 100+155, 104+42, 104+58, 104+155, 108+42, 108+58, 
           108+155, 112+42, 112+58, 112+155, 116+42, 116+58, 116+155, 120+42, 
           120+58, 120+155, 124+42, 124+58, 124+155, 128+42, 128+58, 128+155, 
           149+42, 149+58, 149+106, 149+122, 153+42, 153+58, 153+106, 153+122, 
           157+42, 157+58, 157+106, 157+122, 161+42, 161+58, 161+106, 161+122.
Table 11-10  Description of the display ap configurable channel command output

Item

Description

2.4G 20M

Configurable 20 MHz channels supported by the AP on the 2.4 GHz frequency band.

2.4G 40M+

Configurable 40 MHz Plus channels supported by the AP on the 2.4 GHz frequency band.

2.4G 40M-

Configurable 40 MHz Minus channels supported by the AP on the 2.4 GHz frequency band.

5G 20M

Configurable 20 MHz channels supported by the AP on the 5 GHz frequency band.

5G 40M+

Configurable 40 MHz Plus channels supported by the AP on the 5 GHz frequency band.

5G 40M-

Configurable 40 MHz Minus channels supported by the AP on the 5 GHz frequency band.

5G 80M

Configurable 80 MHz channels supported by the AP on the 5 GHz frequency band.

5G 160M

Configurable 160 MHz channels supported by the AP on the 5 GHz frequency band.

5G 80+80M

Configurable 80+80 MHz channels supported by the AP on the 5 GHz frequency band.

display ap coordinate

Function

The display ap coordinate command displays information about longitudes and latitudes of APs.

Format

display ap coordinate { all | ap-group ap-group-name }

Parameters

Parameter

Description

Value

all

Displays information about longitudes and latitudes of all APs.

-

ap-group ap-group-name

Displays information about longitudes and latitudes of APs in the specified AP group.

The AP group must exist.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to view longitudes and latitudes of APs.

Example

# Display information about longitudes and latitudes of all APs.

<HUAWEI> display ap coordinate all
---------------------------------------------------------------------------------------------------------
ID   Name             Group      Longitude            Latitude
---------------------------------------------------------------------------------------------------------
0    00d5-ada8-1c00   default    30.1111111°E        40.2222222°N 
1    244c-075f-ec20   default    110°59′59"W         77°25′53″N
2    644c-075f-ec20   default    -                    -
--------------------------------------------------------------------------------------------------------
Total: 3
Table 11-11  Description of the display ap coordinate all command output

Item

Description

ID

AP ID.

Name

AP name.

Group

AP group.

Longitude

Longitude of an AP. Its display varies depending on the format:
  • Example: 114°3′14″E in the format of degree/minute/second
  • Example: 114.3435°E in the format of decimal degree
  • Hyphen (-) if it is not configured

Latitude

Latitude of an AP.
  • Example: 114°3′14″S in the format of degree/minute/second
  • Example: 114.3435°S in the format of decimal degree
  • Hyphen (-) if it is not configured
Related Topics

display ap elabel

Function

The display ap-elabel command displays electronic label information about a specified AP.

Format

display ap elabel { ap-name ap-name | ap-id ap-id | all }

Parameters

Parameter

Description

Value

ap-name ap-name

Displays electronic label information about the AP with the specified name.

The AP name must exist.

ap-id ap-id

Displays electronic label information about the AP with the specified ID.

The AP ID must exist.

all

Displays electronic label information of all APs.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to view electronic label information about an AP. An electronic label is also called permanent configuration data or information and is written in the storage device during AP testing or commissioning. An electronic label includes the AP name, serial number, manufacture date and manufacturer information.

Example

# Display electronic label information about AP huawei.

<HUAWEI> display ap elabel ap-name huawei
/$[ArchivesInfo Version]
/$ArchivesInfoVersion=3.0


[Board Properties]
BoardType=AP6310SN-GN-CN
BarCode=210235449210CB000011
Item=02354492
Description=AP6310SN-GN Bundle(11n,Distributed AP Indoor,Single Frequency,AC/DC
adapter(CN))
Manufactured=2012-11-27
VendorName=Huawei
IssueNumber=00
CLEICode=
BOM=
Table 11-12  Description of the display ap elabel command output
Item Description
ArchivesInfo Version Electronic label version.
BoardType AP type.
BarCode Bar code of an AP.
Item BOM code of an AP.
Description English description of an AP.
Manufactured Production date of an AP.
VendorName Vendor name.
IssueNumber Issue number of an AP.
CLEICode CLEI code of an AP.
BOM Sales BOM code of an AP.

# Display electronic label information of all APs.

<HUAWEI> display ap elabel all
Info: This operation may take a few seconds. Please wait for a moment.done.
Total AP elabel information:
------------------------------------------------------------------------------
ID   MAC            Name     Type         SN                   Item
------------------------------------------------------------------------------
1    dcd2-fc04-b500 L1_001   AP7110DN-AGN 210235555310CC000094 -
2    dcd2-fc9d-0bb0 1        AP7110SN-GN  210235568010D1000032 -
------------------------------------------------------------------------------
Total: 2  
Table 11-13  display ap elabel all command output
Item Description
ID AP ID.
MAC MAC address of an AP.
Name AP name.
Type AP type.
SN SN of an AP.
Item BOM code of an AP.

display ap global configuration

Function

The display ap global configuration command displays AP global configuration.

Format

display ap global configuration

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to view AP global information.

Example

# Display AP global configuration.

<HUAWEI> display ap global configuration
--------------------------------------------------------------------------------
AP auth-mode                       : MAC-auth
AP LLDP switch                     : disable
AP username/password               : -/******
AP data collection                 : disable
AP data collection interval(minute): 5
--------------------------------------------------------------------------------
Table 11-14  Description of the display ap global configuration command output
Item Description

AP auth-mode

AP authentication mode.

To configure the parameter, run the ap auth-mode command.

AP LLDP switch

Whether LLDP is enabled on an AP.

To configure the parameter, run the ap lldp enable command.

AP username/password

User name and password for AP login.

To configure the parameter, run the ap username command.

AP data collection

Whether data buffering is enabled on an AP.

To configure the parameter, run the ap data-collection enable command.

AP data collection interval(minute)

AP data buffering duration.

To configure the parameter, run the ap data-collection interval command.

display ap lldp neighbor

Function

The display ap lldp neighbor command displays LLDP neighbor information on a specified AP.

Format

display ap lldp neighbor { { ap-name ap-name | ap-id ap-id } [ interface interface-type interface-number ] | brief }

Parameters

Parameter

Description

Value

ap-name ap-name

Displays LLDP neighbor information of the AP with a specified name.

The AP name must exist.

ap-id ap-id

Displays LLDP neighbor information of the AP with a specified ID.

The AP ID must exist.

interface interface-type interface-number

Displays LLDP neighbor information on a specified AP interface.
  • interface-type specifies the interface type.
  • interface-number specifies the interface number.

-

brief

Displays brief LLDP neighbor information of APs.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to view LLDP neighbor information on a specified AP, including the number of LLDP neighbors, device ID, interface ID, system name system description, and management address of each neighbor. The LLDP neighbor information is reported by an AP to the connected AC.

If no parameter is specified, LLDP neighbor information about all AP interfaces is displayed.

Example

# Display LLDP neighbor information on all APs.

<HUAWEI> display ap lldp neighbor brief
--------------------------------------------------------------------------------------
Hostname  Neighbor device  Management address  Local intf  Neighbor intf          TTL
--------------------------------------------------------------------------------------
huawei    Quidway         10.10.10.3          GE0         GigabitEthernet0/0/16  119
--------------------------------------------------------------------------------------
Total: 1
Table 11-15  Description of the display ap lldp neighbor command output
Item Description

Hostname

AP name.

Neighbor device

System name of an AP neighbor.

Management address

Management address of an AP neighbor.

Local intf

Local interface of the AP.

Neighbor intf

Interface of an AP neighbor.

TTL

Time to live (TTL) of the AP neighbor information stored on the local AP.

# Display LLDP neighbor information about GE0 of AP huawei.

<HUAWEI> display ap lldp neighbor ap-name huawei interface gigabitethernet 0
--------------------------------------------------------------------------------
AP 1 Port 0 has 1 neighbor(s):

Basic port information                                                          
--------------------------------------------------------------------------------
Neighbor index               : 1
Host Name                    : huawei
Chassis ID type              : macAddress
Chassis ID                   : 5489-9876-b7d7
Port ID type                 : interfaceName
Port ID                      : GigabitEthernet0/0/2
Time to live                 : 120s
Port description             : GigabitEthernet0/0/2
System name                  : Quidway
System description           : S7712
                      Huawei Versatile Routing Platform Software
                      VRP (R) software,Version 5.110 (S7712 V200R011C10)
                      Copyright (C) 2007 Huawei Technologies Co., Ltd.
System capabilities supported: wlanAccessPoint telephone
System capabilities enabled  : wlanAccessPoint telephone
Management address type      : IPv4
Management address           : 10.10.10.5
                                                                                
DOT3 port information                                                           
--------------------------------------------------------------------------------
Power port class                            : Unknown                           
PSE power supported                         : No                                
PSE power enabled                           : No                                
PSE pairs control ability                   : No                                
Power pairs                                 : Unknown                           
Port power classification                   : Unknown                           
Power type                                  : Type 2 PSE                        
Power source                                : Reserved                          
Power priority                              : High                              
PD requested power value                    : 479.5(w)                          
PSE allocated power value                   : 281.6(w)                          
PD requested power value Mode A             : 0.0(w)                            
PD requested power value Mode B             : 2335.4(w)                         
PSE allocated power value Alternative A     : 1055.8(w)                         
PSE allocated power value Alternative B     : 1488.9(w)                         
Power Class                                 : Unknown                           
PSE power pairsx                            : Alternative A                     
Power typex                                 : Type unknown                      
PD 4PID                                     : No                                
PD Load                                     : Single-signature                  
PSE maximum available power                 : 421.6(w)                          
PSE Autoclass support                       : Yes                               
Autoclass completed                         : Idle                              
Autoclass request                           : Completed                         
Power down                                  : No                                
                                                                                
Legacy port information                                                         
--------------------------------------------------------------------------------
4-pair PoE Supported                        : Yes                               
Spare pair Detection/Classification required: Yes                               
PD Spare Pair Desired State                 : Disable                           
PSE Spare Pair Operational State            : Enable                            
--------------------------------------------------------------------------------
Table 11-16  Description of the display ap lldp neighbor ap-name ap-name interface interface-type interface-number command output
Item Description

Neighbor index

Index of a neighbor.

Host Name

AP name

Chassis ID type

ID subtype of a neighbor device.
  • chassisComponent: chassis alias
  • interfaceAlias: interface alias
  • portComponent: interface or backplane alias
  • macAddress: MAC address
  • networkAddress: network address
  • interfaceName: name of the interface
  • local: name of the local device

Chassis ID

ID of the neighbor device.
  • A MAC address is displayed when the neighbor device ID subtype is macAddress.
  • An IP address is displayed when the neighbor device ID subtype is networkAddress.
  • A character string is displayed when the neighbor device ID subtype is neither macAddress nor networkAddress.

Port ID type

ID subtype of the neighbor interface.
  • interfaceAlias: interface alias
  • portComponent: interface or backplane alias
  • macAddress: MAC address
  • networkAddress: network address
  • interfaceName: name of the interface
  • agentCircuitID: loopback interface ID of the DHCP relay
  • local: name of the local device

Port ID

ID of the neighbor interface.
  • A MAC address is displayed when the neighbor interface ID subtype is macAddress.
  • An IP address is displayed when the neighbor interface ID subtype is networkAddress.
  • A character string is displayed when the neighbor interface ID subtype is neither macAddress nor networkAddress.

Time to live

Time to live (TTL) of the AP neighbor information stored on the local AP.

Port description

Description of the neighbor interface.

System name

System name.

System description

System description of the neighbor.

System capabilities supported

Capabilities of the neighbor device.
  • other: other capabilities
  • repeater: repeater
  • bridge: bridge device
  • wlanAccessPoint: wireless access point
  • router: router
  • telephone: wireless device
  • docsisCableDevice: management station
  • stationOnly: base station

System capabilities enabled

Capabilities enabled on the neighbor device.
  • other: other capabilities
  • repeater: repeater
  • bridge: bridge device
  • wlanAccessPoint: wireless access point
  • router: router
  • telephone: wireless device
  • docsisCableDevice: management station
  • stationOnly: base station

Management address type

Management address type of the neighbor.

Management address

Management address of the neighbor.

Power port class
PoE type:
  • PSE: power-sourcing equipment.
  • PD: powered device.
  • Unknown: unknown device.
PSE power supported
Whether the PSE power is supported.
  • Yes: PSE power is supported.
  • No: PSE power is not supported.
PSE power enabled
Whether the PSE power is enabled.
  • Yes: enabled.
  • No: disabled.
PSE pairs control ability
Whether the PSE control is supported.
  • Yes: PSE control is supported.
  • No: PSE control is not supported.
Power pairs
PoE remote power supply mode.
  • Signal: power supply mode of signal lines.
  • Spare: power supply mode of spare signal lines.
  • Unknown: an unknown remote power supply mode.
Port power classification
PD power control level on the interface:
  • Class0: indicates level 1.
  • Class1: indicates level 2.
  • Class2: indicates level 3.
  • Class3: indicates level 4.
  • Class4: indicates level 5.
  • Unknown: indicates an unknown control level.
Power type

PoE device type:

Power source

Power supply source.

Type of the PSE: Primary power source, Backup source, Reserved, and Unknown

Type of the PD: PSE, Reserved, PSE and local, and Unknown

Power priority
Power priority:
  • Critical: the highest priority.
  • High: the second highest priority.
  • Low: the lowest priority.
  • Unknown: unknown priority.
PD requested power value

Power requested by the PD.

PSE allocated power value

Power allocated by the PSE.

PD requested power value Mode A

Power requested by the PD in mode A.

PD requested power value Mode B

Power requested by the PD in mode B.

PSE allocated power value Alternative A

Power allocated by the PSE for a PD in Mode A.

PSE allocated power value Alternative B

Power allocated by the PSE for a PD in Mode B.

Power Class

Power class requested by the PD or allocated by the PSE.

PSE power pairsx

Mode in which the PSE supplies power to a PD.

Power typex

Working type of the device.

PD 4PID
Whether the PD supports all power receive types.
  • No: The PD does not support all power receive modes.
  • Yes: The PD supports all power receive types.
PD Load
Whether isolation between modes A and B is required for the PD.
  • No: Isolation between modes A and B is not required for the PD.
  • Yes: Isolation between modes A and B is required for the PD.
PSE maximum available power

Maximum output power of the PSE.

PSE Autoclass support
Whether the PSE supports Autoclass.
  • No: The PSE does not support Autoclass.
  • Yes: The PSE supports Autoclass.
Autoclass completed

Whether Autoclass is completed.

Autoclass request

Whether Autoclass is required for the PD.

Power down

Whether the PD requires power supply from the PSE.

4-pair PoE Supported

Whether the interface supports UPoE.

Spare pair Detection/Classification required

Whether the standby device supports the requirement for detection and classification.

PD Spare Pair Desired State

Requirement state of the standby PD.

PSE Spare Pair Operational State

Operation state of the standby PSE.

Related Topics

display ap neighbor

Function

The display ap neighbor command displays information about neighbors of a radio, including authorized and unauthorized neighbors.

Format

display ap neighbor { ap-name ap-name | ap-id ap-id } [ radio radio ]

Parameters

Parameter

Description

Value

ap-name ap-name

Specifies an AP name.

The AP name must exist.

ap-id ap-id

Specifies an AP ID.

The AP ID must exist.

radio radio

Specifies radio ID of an AP.

The value is an integer that ranges from 0 to 2.

Only the AP4030TN, AP4051TN, and AP8050TN-HD supports three radios.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Use Scenario

APs' neighbor information reflects the APs' locations and neighbor relationships, helping you plan the network.

If a neighboring AP is an authorized one, the system displays the power of signals received from the neighboring AP as well as the path loss.

If a neighboring AP is an unauthorized one, the system displays only the power of signals received from the neighboring AP.

Prerequisites

The radio calibration function has been enabled using the calibrate enable { auto | manual | schedule time } command.

Precautions

In auto radio calibration mode, APs continuously report and update neighboring information so that the AC can query the latest AP neighbor information. In manual or scheduled radio calibration mode, APs report neighbor information within the calibration period. Neighbor information ages out after 1 hour and can be queried only before aging.

Example

# Display neighbor information of AP huawei.

<HUAWEI> display ap neighbor ap-name huawei
Radio: Radio ID of AP 
In control AP: 
------------------------------------------------------------------------------ 
Radio AP ID AP name         Channel  Received RSSI(dbm)  Path loss(db) 
------------------------------------------------------------------------------ 
0     0     e468-a352-7990  1        -38                 56 
------------------------------------------------------------------------------ 
Total: 1 

Uncontrol AP:
------------------------------------------------------------------------------
Radio  BSSID          Channel  RSSI(dBm)  SSID
------------------------------------------------------------------------------
0      0020-1306-0680 1        -79        b
1      cc53-b5ee-3d00 5        -60        test
------------------------------------------------------------------------------
Total: 2
Table 11-17  Description of the display ap neighbor command output

Item

Description

In control AP

Authorized neighboring AP.

Uncontrol AP

Unauthorized neighboring AP.

Radio

Neighboring AP detected on an AP radio.

AP ID

ID of a neighboring AP.

AP name

Name of a neighboring AP.

Channel

Channel that the authorized neighboring AP uses.

NOTE:

The device displays only information about neighboring APs detected on the current channel.

Received RSSI(dbm)

Strength of signals received from neighboring APs.

Path loss(db)

Path loss.

BSSID

Basic service set identifier (BSSID) of an unauthorized neighbor.

Channel

Channel that the unauthorized neighboring AP uses.

RSSI(dBm)

Power of signals received from the neighboring AP, in dBm.

SSID

Service set identifier (SSID) of an unauthorized neighbor.

display ap offline-record

Function

The display ap offline-record command displays AP offline records.

Format

display ap offline-record { all | mac mac-address }

Parameters

Parameter

Description

Value

all

Displays offline records of all APs.

-

mac mac-address

Displays offline records of the AP with the specified MAC address.

The AP's MAC address must exist.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

This command displays AP offline records, helping the maintenance personnel manage and maintain the APs.

After the number of AP offline records reaches the maximum that can be stored, new records overwrite existing ones.

Example

# Display all AP offline records.

<HUAWEI> display ap offline-record all
------------------------------------------------------------------------------  
MAC               Last offline time      Reason                                 
------------------------------------------------------------------------------  
0023-0024-0080    2015-01-31/16:21:50    The AP name is modified.             
60de-4476-e360    2015-01-31/14:02:35    An AP is deleted.      
------------------------------------------------------------------------------  
Total records: 2   
Table 11-18  Description of the display ap offline-record command output

Item

Description

MAC

AP's MAC address.

Last offline time

Last offline time of an AP.

Reason

AP offline reason.For description of offline reasons and handling suggestions, see Table 11-19.

For troubleshooting methods, see An AP Goes offline Unexpectedly.

Table 11-19  Possible reasons and suggestions for APs to go offline

Reason Why an AP Goes Offline

Suggestion

The AC country code is modified.

The AP goes offline due to normal configuration changes, and no action is required.

The AP is replaced.

The AP goes offline due to normal configuration changes, and no action is required.

Reboot by ap update reset command.

The AP resets to load the new version file after the upgrade, and no action is required.

A command is delivered to reboot an AP.

The AC delivers a reboot command to the AP, and no action is required.

An AP is deleted.

The AP is deleted on the AC, and no action is required.

The license expires: License resources for the AC to manage APs are insufficient.

Apply for a new license.

Huawei's Electronic Software Delivery Platform (ESDP) is accessible from the Internet and Huawei intranet.

The AP is added to the blacklist.

Check whether the AP needs to be added to the blacklist.

A CAPWAP tunnel is faulty (due to inconsistent link IDs).

No action is required. The AP will automatically attempt to recover the link.

The DTLS configuration of the CAPWAP tunnel changes.

The AP goes offline due to normal configuration changes, and no action is required.

The AP's factory settings are restored.

The AP goes offline due to normal configuration changes, and no action is required.

The radio type is inconsistent between the AC and AP.

Run the display ap config-info command to verify the AP radio configuration.

Heartbeat packet transmission for the CAPWAP data tunnel between the AC and AP times out.

Check the intermediate network between the AP and AC.

Heartbeat packet transmission for the CAPWAP control tunnel between the AC and AP times out.

Check the intermediate network between the AP and AC.

The dual-link networking configuration is modified.

The configuration change causes the AP to automatically reboot, and no action is required.

The AP name is modified.

The AP goes offline due to normal configuration changes, and no action is required.

The AP group name is modified.

The AP goes offline due to normal configuration changes, and no action is required.

The management VLAN is modified.

The AP goes offline due to normal configuration changes, and no action is required.

AP provisioning parameters are set.

The AP goes offline due to normal configuration changes, and no action is required.

The CAPWAP source IP address is deleted.

The AP goes offline due to normal configuration changes, and no action is required.

The central AP goes offline.

Check the reason why the central AP goes offline.

The central AP proactively reboots RUs.

The AP goes offline due to normal configuration changes, and no action is required.

The AP is powered off and restarts.

Check the AP power supply.

An internal error (KP) occurs.

Contact technical support personnel.

An internal error (VOS signal error) occurs.

Contact technical support personnel.

An internal error (forwarding error monitored by MFPI) occurs.

Contact technical support personnel.

An internal error (PKO error monitored by MSC) occurs.

Contact technical support personnel.

An internal error (reset due to timer expiration) occurs.

Contact technical support personnel.

An internal error (reset of the write CPLD register) occurs.

Contact technical support personnel.

The reset button is pressed to reset the AP.

Check whether the AP is reset manually.

The AP restarts due to a CANBUS reset.

Contact technical support personnel.

The AP restarts due to AP interference: APs are located closely, generating interference.

Contact technical support personnel.

The AP restarts due to a chip exception.

Contact technical support personnel.

The CAPWAP sensitive-info PSK is modified.

The configuration change causes the AP to automatically reboot, and no action is required.

The CAPWAP integrity-check PSK is modified.

The configuration change causes the AP to automatically reboot, and no action is required.

The country code is inconsistent on the AC and AP.

Check the country code configuration on the AC and AP.

The AP is forcibly disconnected: in specific scenarios, for example, when the CAPWAP tunnel capacity is reached.

No action is required.

CAPWAP link down for DTLS smooth: DTLS requires APs to go online again during an HA or VRRP switchover.

No action is required.

The wideband status change.

The AP goes offline due to normal configuration changes, and no action is required.

An internal error (MSC error monitored by MFPI) occurs.

Contact technical support personnel.

An internal error (MSU error monitored by MFPI) occurs.

Contact technical support personnel.

An internal error (KAP error monitored by MFPI) occurs.

Contact technical support personnel.

An internal error (TX DMA stop) occurs.

Contact technical support personnel.

An internal error (other reason) occurs.

Contact technical support personnel.

Reboot for AP Channel-load-mode change.

No action is required.

Reset for the data link DTLS configuration change.

The configuration change causes the AP to automatically reboot, and no action is required.

Reset for the AC list configuration change.

The configuration change causes the AP to automatically reboot, and no action is required.

Reset for the change of the IP address obtaining mode.

The configuration change causes the AP to automatically reboot, and no action is required.

Reset for the IP address configuration change.

The configuration change causes the AP to automatically reboot, and no action is required.

Reset for a configuration delivery failure.

Check network connectivity. If no problem is found, contact technical support personnel.

display ap online-fail-record

Function

The display ap online-fail-record command displays AP online failure records.

Format

display ap online-fail-record { all | mac mac-address }

Parameters

Parameter

Description

Value

all

Displays online failure records of all APs.

-

mac mac-address

Displays online failure records of the AP with the specified MAC address.

The AP's MAC address must exist.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

If an AP fails to go online on the AC, you can run this command to check the failure reason, which helps locate the fault.

After the number of AP online failure records reaches the maximum that can be stored, new records overwrite existing ones.

Example

# Display online failure records about the AP with the MAC address 1047-80b1-56a0.

<HUAWEI> display ap online-fail-record mac 1047-80b1-56a0
------------------------------------------------------------------------------
MAC             Last fail time       Reason
------------------------------------------------------------------------------
1047-80b1-56a0  2015-01-20/15:48:06  The AP is added to the AP blacklist.
------------------------------------------------------------------------------
Total records: 1  
Table 11-20  Description of the display ap online-fail-record command output

Item

Description

MAC

MAC address of the AP that fails to go online.

Last fail time

Time of the AP online failure.

Reason

Reason for the AP online failure. For description of AP online failure reasons and handling suggestions, see Table 11-21.

For troubleshooting methods, see AP Online Failure.

Table 11-21  Possible causes and suggestions for APs' failures to go online

Reason Why an AP Fails to Go Online

Suggestion

Insufficient license resources.

Expand the license capacity. Note that RUs do not occupy license resources of the AC.

Huawei's Electronic Software Delivery Platform (ESDP) is accessible from the Internet and Huawei intranet.

The AP is not in the SN whitelist.

Run the ap whitelist sn ap-sn1 [ to ap-sn2 ] command to add the AP to the whitelist or run the ap-confirm command to enable the AP to pass authentication.

The AP is not in the MAC whitelist.

Run the ap whitelist mac ap-mac1 [ to ap-mac2 ] command to add the AP to the whitelist or run the ap-confirm command to enable the AP to pass authentication.

The AP is added to the AP blacklist.

Check whether the AP needs to be added to the blacklist. To delete the AP from the blacklist, run the undo ap blacklist command.

The MAC address and SN of the AP do not match.

Check whether the MAC address and SN of the AP match.

DTLS negotiation for CAPWAP tunnel setup fails.

Check whether the PSK used for DTLS encryption is correctly configured.

CAPWAP tunnel negotiation fails.

Check whether the network connectivity is normal. If yes, contact technical support personnel.

APs cannot go online during data backup.

Wait until backup is complete.

The upgrade fails.

Run the display ap update configuration command to check whether the AP's upgrade file is correct. If so, rectify the fault by referring to FIT AP Upgrade Fails.

The CAPWAP tunnel fails to be established.

Check whether the network connectivity is normal. If yes, contact technical support personnel.

The configuration fails to be delivered.

The device attempts to deliver the configuration again. If the failure persists, contact technical support personnel.

The versions of the AP and AC do not match.

Log in to http://support.huawei.com/enterprise and download the release notes. Based on the version mapping, upgrade the AP or AC to the matching version.

The AC does not support the AP type.

Replace the AP with that supported by the AC or replace the AC with one that supports this AP type.

The AP name conflicts.

Run the ap-rename command to rename the AP.

The number of central APs reaches the upper limit.

Check whether the number of central APs reaches the maximum value.

The number of common APs reaches the upper limit.

Check whether the number of common APs reaches the maximum value.

The central AP is not in normal state.

Run the display ap command to check the central AP status and take measures accordingly.

The CAPWAP sensitive-info PSK is different on the two ends of the CAPWAP tunnel.

Ensure that the PSK for encrypting CAPWAP sensitive information is the same on the AP and AC. Alternatively, enable the AP to set up a DTLS session with the AC using the default PSK.

The CAPWAP integrity-check PSK is different on the two ends of the CAPWAP tunnel.

Ensure that the PSK for checking CAPWAP packet integrity is the same on the AP and AC. Alternatively, enable the AP to set up a DTLS session with the AC using the default PSK.

The configured and reported AP types are different.

Ensure that the configured AP type is the same as the reported one.

display ap optical-info

Function

The display ap optical-info command displays optical module information.

Format

display ap optical-info { ap-name ap-name | ap-id ap-id }

Parameters

Parameter

Description

Value

ap-name ap-name

Displays optical module information of the AP with a specified name.

The AP name must exist.

ap-id ap-id

Displays optical module information of the AP with a specified ID.

The AP ID must exist.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

You can run this command to view optical module information, including the optical module type, transmit optical power, and receive optical power.

Prerequisites

The AP has been online. You can run the display ap command to check the AP status.

The AP supports optical modules. You can run the display ap-type command to view the AP model.
NOTE:

Currently, optical module information query is supported only by the AP6610DN-AGN, AP6610DN-AGN-US, AP9131DN, AP9132DN, AP8050TN-HD, AP8082DN, AP8182DN, AP8130DN-W, AP8030DN, AP8050DN, AP8050DN-S, AP8150DN, and AP8130DN.

Precautions

If an electrical module is inserted into an optical interface, diagnostic information is not supported.

Example

# Display optical module information of AP huawei.

<HUAWEI> display ap optical-info ap-name huawei
-------------------------------------------------------------------------------
Interface name:XGE0/0/0
-------------------------------------------------------------------------------
Common information:
  Transceiver Type                    :1000_BASE_LX_SFP
  Connector Type                      :LC
  Wavelength(nm)                      :1310
  Transfer Distance(m)                :10000(9um)
  Copper Link Length(m)               :0
  Digital Diagnostic Monitoring       :NO
  Vendor Name                         :FINISAR CORP.
  Vendor Part Number                  :FTLF1318P2BTL-HW
  Vendor IEEE Company ID              :36965
  Vendor Revision Level               :A
  Nominal Bit Rate(MBits/sec)         :1200
--------------------------------------------------------------------------------
Manufacture information:
  Manu. Serial Number                 :PMK2K62
  Manufacturing Date                  :2012-05-09
  Vendor Name                         :FINISAR CORP.
--------------------------------------------------------------------------------
Diagnostic information:
  Temperature(degree C)               :49
  Temp High Threshold(degree C)       :90
  Temp Low Threshold(degree C)        :-45
  Voltage(0.1mV)                      :33161
  Volt High Threshold(0.1mV)          :37000
  Volt Low Threshold(0.1mV)           :29000
  Bias Current(mA)                    :19
  Bias High Threshold(mA)             :25430
  Bias Low Threshold(mA)              :1929
  RX Power(0.1uw)                     :0
  RX Power High Threshold(0.1uw)      :5012
  RX Power Low Threshold(0.1uw)       :126
  TX Power(0.1uw)                     :2886
  TX Power High Threshold(0.1uw)      :6310
  TX Power Low Threshold(0.1uw)       :708
--------------------------------------------------------------------------------
Interface name:XGE0/0/1
--------------------------------------------------------------------------------
Common information:
  Transceiver Type                    :OC3_LONG_REACH_SFP
  Connector Type                      :LC
  Wavelength(nm)                      :1310
  Transfer Distance(m)                :40000(9um)
  Copper Link Length(m)               :0
  Digital Diagnostic Monitoring       :YES
  Vendor Name                         :NEOPHOTONING
  Vendor Part Number                  :PT7320-31-2W
  Vendor IEEE Company ID              :0
  Vendor Revision Level               :1.0
  Nominal Bit Rate(MBits/sec)         :100
--------------------------------------------------------------------------------
Manufacture information:
  Manu. Serial Number                 :A1008036407
  Manufacturing Date                  :2008-10-09
  Vendor Name                         :NEOPHOTONING
--------------------------------------------------------------------------------
Diagnostic information:
  Temperature(degree C)               :47
  Temp High Threshold(degree C)       :100
  Temp Low Threshold(degree C)        :-10
  Voltage(0.1mV)                      :32808
  Volt High Threshold(0.1mV)          :34461
  Volt Low Threshold(0.1mV)           :30523
  Bias Current(mA)                    :9
  Bias High Threshold(mA)             :24
  Bias Low Threshold(mA)              :0
  RX Power(0.1uw)                     :0
  RX Power High Threshold(0.1uw)      :50477
  RX Power Low Threshold(0.1uw)       :152
  TX Power(0.1uw)                     :5291
  TX Power High Threshold(0.1uw)      :3320
  TX Power Low Threshold(0.1uw)       :834
--------------------------------------------------------------------------------
Interface name:XGE0/0/2
--------------------------------------------------------------------------------
Common information:
  Transceiver Type                    :1000_BASE_LX_SFP
  Connector Type                      :LC
  Wavelength(nm)                      :1310
  Transfer Distance(m)                :10000(9um)
  Copper Link Length(m)               :0
  Digital Diagnostic Monitoring       :YES
  Vendor Name                         :Hisense
  Vendor Part Number                  :LTD1302-BC+1
  Vendor IEEE Company ID              :0
  Vendor Revision Level               :V1.0
  Nominal Bit Rate(MBits/sec)         :1300
--------------------------------------------------------------------------------
Manufacture information:
  Manu. Serial Number                 :J2220000170
  Manufacturing Date                  :2012-09-20
  Vendor Name                         :Hisense
--------------------------------------------------------------------------------
Diagnostic information:
  Temperature(degree C)               :37
  Temp High Threshold(degree C)       :78
  Temp Low Threshold(degree C)        :-5
  Voltage(0.1mV)                      :32776
  Volt High Threshold(0.1mV)          :35650
  Volt Low Threshold(0.1mV)           :29000
  Bias Current(mA)                    :9
  Bias High Threshold(mA)             :70
  Bias Low Threshold(mA)              :0
  RX Power(0.1uw)                     :4267
  RX Power High Threshold(0.1uw)      :5012
  RX Power Low Threshold(0.1uw)       :79
  TX Power(0.1uw)                     :2304
  TX Power High Threshold(0.1uw)      :10000
  TX Power Low Threshold(0.1uw)       :631
--------------------------------------------------------------------------------
Interface name:XGE0/0/3
--------------------------------------------------------------------------------
Common information:
  Transceiver Type                    :1000_BASE_LX_SFP
  Connector Type                      :LC
  Wavelength(nm)                      :1310
  Transfer Distance(m)                :10000(9um)
  Copper Link Length(m)               :0
  Digital Diagnostic Monitoring       :YES
  Vendor Name                         :FINISAR CORP.
  Vendor Part Number                  :FTLF1318P2BTL-HW
  Vendor IEEE Company ID              :36965
  Vendor Revision Level               :A
  Nominal Bit Rate(MBits/sec)         :1200
--------------------------------------------------------------------------------
Manufacture information:
  Manu. Serial Number                 :PLTOL92
  Manufacturing Date                  :2012-05-09
  Vendor Name                         :FINISAR CORP.
--------------------------------------------------------------------------------
Diagnostic information:
  Temperature(degree C)               :38
  Temp High Threshold(degree C)       :90
  Temp Low Threshold(degree C)        :-45
  Voltage(0.1mV)                      :33061
  Volt High Threshold(0.1mV)          :37000
  Volt Low Threshold(0.1mV)           :29000
  Bias Current(mA)                    :19
  Bias High Threshold(mA)             :52
  Bias Low Threshold(mA)              :4
  RX Power(0.1uw)                     :1
  RX Power High Threshold(0.1uw)      :5012
  RX Power Low Threshold(0.1uw)       :126
  TX Power(0.1uw)                     :3219
  TX Power High Threshold(0.1uw)      :6310
  TX Power Low Threshold(0.1uw)       :708
--------------------------------------------------------------------------------
Table 11-22  Description of the display ap optical-info command output
Item Description

Interface name

Name of the optical module.

Transceiver Type

Type of the optical module.

Connector Type

Interface type.

Wavelength(nm)

Optical wavelength, in nm.

Transfer Distance(m)

Transmission distance, in meters.

Copper Link Length(m)

Length of the copper cable, in meters.

Digital Diagnostic Monitoring

Whether diagnostic information about the optical module is monitored.

Vendor Name

Name of the vendor.

Vendor Part Number

Product code provided by the vendor.

Vendor IEEE Company ID

Version number provided by the vendor.

Vendor Revision Level

Product serial number provided by the vendor.

Nominal Bit Rate(MBits/sec)

Bit rate of the optical module, in Mbit/s.

Manu. Serial Number

Vendor sequence number of the optical module.

Manufacturing Date

Manufacturing date of the optical module.

Temperature(degree C)

Current temperature of the optical module, in °C.

Temp High Threshold(degree C)

The upper threshold for the temperature of the optical module, in °C.

Temp Low Threshold(degree C)

The lower threshold for the temperature of the optical module, in °C.

Voltage(0.1mV)

Current voltage of the optical module, in 0.1mV.

Volt High Threshold(0.1mV)

The upper threshold for the voltage of the optical module, in 0.1mV.

Volt Low Threshold(0.1mV)

The lower threshold for the voltage of the optical module, in 0.1mV.

Bias Current(mA)

Bias current of the optical module, in mA.

Bias High Threshold(mA)

Upper threshold for the bias current of the optical module, in mA.

Bias Low Threshold(mA)

Lower threshold for the bias current of the optical module, in mA.

RX Power(0.1uw)

Receive power of the optical module, in 0.1uw.

RX Power High Threshold(0.1uw)

Upper receive power threshold for the optical module, in 0.1uw.

RX Power Low Threshold(0.1uw)

Lower receive power threshold for the optical module, in 0.1uw.

TX Power(0.1uw)

Transmit power of the optical module, in 0.1uw.

TX Power High Threshold(0.1uw)

Upper transmit power threshold for the optical module, in 0.1uw.

TX Power Low Threshold(0.1uw)

Lower transmit power threshold for the optical module, in 0.1uw.

display ap performance statistics

Function

The display ap performance statistics command displays performance statistics about an AP.

Format

display ap performance statistics { ap-name ap-name | ap-id ap-id }

Parameters

Parameter

Description

Value

ap-name ap-name

Displays performance statistics about the AP with a specified name.

The AP name must exist.

ap-id ap-id

Displays performance statistics about the AP with a specified ID.

The AP ID must exist.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display ap performance statistics command to view AP performance statistics to monitor AP performance.

Example

# Display performance statistics about AP huawei.

<HUAWEI> display ap performance statistics ap-name huawei
--------------------------------------------------------------------------------
Memory usage(%)                 : 58
Memory average usage(%)         : 58
CPU usage(%)                    : 4
CPU average usage(%)            : 4
Available space size(KB)        : 1192
Temperature(degree C)           : 54
Online user number              : 0
Upstream traffic(wireless)(KB)  : 23 KB           
Wireless port drop frames(RX)   : 0            
Wireless port drop frames(TX)   : 0          
Wireless port total bytes(RX)   : 0
Wireless port total bytes(TX)   : 0
Wireless port unicast frames(RX): 0
GigabitEthernet port 0
  port drop frames(RX)          : 0
  port drop frames(TX)          : 0
  port total Bytes(RX)          : 0
  port total Bytes(TX)          : 0
  port unknown frames(RX)       : 0
  port error frames(TX)         : 0
  port updown counts            : 0
  port output rate(Kbps)        : 0
  port input rate(Kbps)         : 1
GigabitEthernet port 1
  port drop frames(RX)          : 0
  port drop frames(TX)          : 0
  port total Bytes(RX)          : 61210
  port total Bytes(TX)          : 38218
  port unknown frames(RX)       : 0
  port error frames(TX)         : 0
  port updown counts            : 0
  port output rate(Kbps)        : 0
  port input rate(Kbps)         : 1
--------------------------------------------------------------------------------
Table 11-23  Description of the display ap performance statistics command output
Item Description

Memory usage(%)

Memory usage (%).

Memory average usage(%)

Average memory usage (%).

CPU usage(%)

CPU usage (%).

CPU average usage(%)

Average CPU usage (%).

Available space size(KB)

Available space, in KB.

Temperature(degree C)

AP's internal temperature (°C).
NOTE:
The temperature is displayed as "-" for APs that do not support the temperature check.

Online user number

Number of online users.

Upstream traffic(wireless)(KB)

Traffic volume on the wireless upstream interface in a specified period, in KB.

Wireless port drop frames(RX)

Number of discarded data frames received by the wireless interface.

Wireless port drop frames(TX)

Number of discarded data frames sent by the wireless interface.

Wireless port total bytes(RX)

Total number of bytes received by the wireless interface.

Wireless port total bytes(TX)

Total number of bytes sent by the wireless interface.

Wireless port unicast frames(RX)

Number of unicast data frames received by the wireless interface.

GigabitEthernet port x

ID of the wired-side interface.

port drop frames(RX)

Number of discarded data frames received by the wired interface.

port drop frames(TX)

Number of discarded data frames sent by the wired interface.

port total Bytes(RX)

Number of bytes received by the wired interface.

port total Bytes(TX)

Number of bytes sent by the wired-side interface.

port unknown frames(RX)

Number of unknown protocol packets received by the wired interface.

port error frames(TX)

Number of error data frames sent by the wired interface.

port updown counts

Number of times the wired interface alternates between Up and Down.

port output rate(Kbps) Wired-side sending rate (kbps).
port input rate(Kbps) Wired-side receiving rate (kbps).

display ap provision

Function

The display ap provision command displays the configurations for an AP to go online.

Format

display ap provision ap-id ap-id

Parameters

Parameter Description Value
ap-id ap-id

Specifies an AP ID.

The AP ID must exist.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

After you set parameters for an AP to go online in the AP view, you can run this command to view the detailed configuration.

Example

# Display configurations in the AP provisioning view.

<HUAWEI> display ap provision ap-id 2
-------------------------------------------------------------------------------- 
AP name               : 70d9-313c-3120 
AP group              : default 
AP address mode       : static 
IPv4 address          : - 
IPv4 mask address     : - 
IPv4 gateway address  : - 
IPv4 AC list          : - 
-------------------------------------------------------------------------------- 
Table 11-24  Description of the display provision-ap parameter-list command output

Item

Description

AP name

AP name.

To configure this parameter, run the ap-name (AP view) command.

AP group

AP group to which an AP belongs.

To configure this parameter, run the ap-group (AP view) command.

AP address mode

Mode in which an AP obtains an IP address.

To configure this parameter, run the address-mode (AP view) command.

IPv4 address

Static IPv4 address of an AP.

To configure this parameter, run the ip-address (AP view) command.

IPv4 mask address

Static IPv4 mask of an AP.

To configure this parameter, run the ip-address (AP view) command.

IPv4 gateway address

IPv4 gateway address of an AP.

To configure this parameter, run the ip-address (AP view) command.

IPv4 AC list

AC IPv4 address list for APs.

To configure this parameter, run the ac-list (AP view) command.

display ap port

Function

The display ap port command displays the AP port status and traffic information.

Format

display ap port { all | ap-name ap-name | ap-id ap-id | ap-mac ap-mac }

Parameters

Parameter

Description

Value

all

Displays port status and traffic information of all APs.

-

ap-name ap-name

Displays port status and traffic information of the AP with a specified name.

The AP name must exist.

ap-id ap-id

Displays port status and traffic information of the AP with a specified ID.

The AP ID must exist.

ap-mac ap-mac

Displays port status and traffic information of the AP with a specified MAC address.

The AP's MAC address must exist.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display ap port command to check port status and traffic information of online APs, which facilitates AP port maintenance and management.

Example

# Display port status and traffic information of all APs.

<HUAWEI> display ap port all
Info: Waiting for AP response.
-----------------------------------------------------------------------------------------------------------------------------------
AP-ID Port       State Speed Duplex TX-Packets       Tx-ErrorPackets  TX-Rate(Kbps) RX-Packets       RX-DropPackets   RX-Rate(Kbps)
-----------------------------------------------------------------------------------------------------------------------------------
0     GE0        up    1000  full   9178             0                0             12857            0                1
-----------------------------------------------------------------------------------------------------------------------------------
Printed: 1
Table 11-25  Description of the display ap port command output
Parameter Description

AP-ID

AP ID.

Port

AP port.

State

Status of the AP port.
  • down: The AP port is Down.
  • up: The AP port is Up.
  • *down: The interface is shut down.

Speed

Speed of the AP port, in Mbit/s.

Duplex

Duplex mode of the AP port, which includes the half-duplex and full-duplex modes.

TX-Packets

Number of data frames sent by the AP port.

Tx-ErrorPackets

Number of error data frames sent by the AP port.

TX-Rate(Kbps)

Uplink rate of the AP port.

RX-Packets

Number of data frames received by the AP port.

RX-DropPackets

Number of discarded data frames that are received by the AP port.

RX-Rate(Kbps)

Downlink rate of the AP port.

display ap power-workmode

Function

The display ap power-workmode command displays the current power mode of APs.

Format

display ap power-workmode { all | ap-name ap-name | ap-id ap-id | ap-mac ap-mac | ap-group ap-group }

Parameters

Parameter

Description

Value

all

Displays the current power mode of all APs.

-

ap-name ap-name

Displays the current power mode of the AP with a specified name.

The AP name must exist.

ap-id ap-id

Displays the current power mode of the AP with a specified ID.

The AP ID must exist.

ap-mac ap-mac

Displays the current power mode of the AP with a specified MAC address.

The AP's MAC address must exist.

ap-group ap-group

Displays the current power mode of APs in a specified AP group.

The AP group must exist.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

When an AP is supplied with DC or PoE power, the AP may work in low-power mode if the power fails to meet requirements. You can run this command to view the current power mode of the AP and verify that the current power mode can enable the AP to work with all functions.

Example

# Display the current power mode of all APs.

<HUAWEI> display ap power-workmode all
-----------------------------------------------------------------------------------------------------------------------------------
ID     MAC              Name    Group     Power-workmode     Decided by
-----------------------------------------------------------------------------------------------------------------------------------
0     dcd2-fcf6-76a0    ap_1    default   AT(FULL)           LLDP 
1     60de-4474-9640    ap_2    default   AF(RESTRICTED)     AP capability
-----------------------------------------------------------------------------------------------------------------------------------
Total: 2
Table 11-26  Description of the display ap power-workmode command output
Item Description

ID

AP ID.

MAC

AP MAC address.

Name

AP name.

Group

AP group to which an AP belongs.

Power-workmode

Current power mode of an AP.
  • The power mode of an AP can be AF, AT, or BT, which represents 802.3af, 802.3at, or 802.3bt, respectively.
  • The working mode of an AP can be FULL or RESTRICTED, which indicates that functions of the AP are unrestricted and partially restricted, respectively.

Decided by

The current power mode of an AP is determined by:
  • LLDP: LLDP negotiation result
  • Hardware detect: hardware detection result
  • AP capability: its own highest capability

display ap resource

Function

The display ap resource command displays the number of CAPWAP tunnel resources used by APs on a card.

Format

display ap resource slot slot-id

Parameters

Parameter

Description

Value

slot slot-id

Specifies the slot ID of a card.

The value must be set according to the device configuration.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to check the number of CAPWAP tunnel resources used by APs on a card.
  • When APs access a device through physical ports of an X series card, you can run this command to check the number of CAPWAP tunnel resources used by APs on this card.
  • When APs access a switch through a Trunk (the Trunk contains only X series cards), you can run this command to check the number of CAPWAP tunnel resources used by APs on any card in this Trunk.
  • When APs access a switch through a WLAN work group, you can run this command to check the number of CAPWAP tunnel resources used by APs on the master or slave card. The number of CAPWAP tunnel resources used by APs on a non-X series card cannot be checked using this command.

Example

# Display the number of CAPWAP tunnel resources used by APs on the X series card in slot 1.

<HUAWEI> display ap resource slot 1
Slot  1
-------------------------------------------------------------------------
Number Used :0
Number Free : 4096
Number Total: 4096
Table 11-27  Description of the display ap resource slot slot-id command output

Item

Description

Number Used

Number of CAPWAP tunnel resources used by APs.

Number Free

Number of available CAPWAP tunnel resources.

Number Total

Number of CAPWAP tunnel resources on a card.

display ap run-info

Function

The display ap run-info command displays running status of an AP.

Format

display ap run-info { ap-name ap-name | ap-id ap-id }

Parameters

Parameter

Description

Value

ap-name ap-name

Displays running status of the AP with a specified name.

The AP name must exist.

ap-id ap-id

Displays running status of the AP with a specified ID.

The AP ID must exist.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

This command displays AP running status. You can run this command to monitor an AP in real time.

Prerequisites

The AP works properly.

Example

# Display running status of AP huawei.
<HUAWEI> display ap run-info ap-name huawei  
--------------------------------------------------------------------------------
AP type                       : AP7030DE
Country code                  : CN
Software version              : V200R007C10
Hardware version              : Ver.A
BIOS version                  : 271
BOM version                   : 001
Memory size(MB)               : 256
Flash size(MB)                : 64
Manufacture                   : Huawei Technologies Co., Ltd.
Software vendor               : Huawei Technologies Co., Ltd.
Online time(ddd:hh:mm:ss)     : 6H:56M:26S
Run time(ddd:hh:mm:ss)        : 6H:59M:51S
IP address                    : 192.168.109.252
IP mask                       : 255.255.255.0
Gateway                       : 192.168.109.1
DNS server                    : 0.0.0.0
GigabitEthernet port 0
  Port speed(Mbps)            : 1000
  Port speed mode             : auto
  Port duplex                 : full
  Port duplex mode            : auto
  Port state                  : down
  STP down recovery time(ddd:hh:mm:ss)        : - 
GigabitEthernet port 1
  Port speed(Mbps)            : 1000
  Port speed mode             : auto
  Port duplex                 : full
  Port duplex mode            : auto
  Port state                  : up
  STP down recovery time(ddd:hh:mm:ss)        : - 
Card status               : slot 1: -, slot 2: -, slot 3: - 
--------------------------------------------------------------------------------
Table 11-28  Description of the display ap run-info command output

Item

Description

AP type

AP type.

Country code

Country code.

Software version

Software version of an AP.

Hardware version

Hardware version of an AP.

BIOS version

BIOS version of an AP.

BOM version

BOM version of an AP.

Memory size(MB)

Memory size of an AP, in MB.

Flash size(MB)

Flash memory size of an AP, in MB.

Manufacture

Manufacturer of an AP.

Software vendor

AP software manufacturer.

Online time(ddd:hh:mm:ss)

AP online duration.

Run time(ddd:hh:mm:ss)

Running duration of an AP.

IP address

AP IPv4 address.

IP mask

Mask of an AP.

Gateway

Gateway IP address of an AP.

DNS server

IP address of the DNS server.

XGigabitEthernet port number

ID of the AP's XGigabitEthernet port.

Only AD9431DN-24X series APs have XGigabitEthernet ports.

MultiGE port number

ID of the AP's MultiGE port.

Only AP7050DN-E, AP6052DN, AP7052DN, AP7152DN, AP7052DE, AP8082DN, and AP8182DN series APs have MultiGE ports.

GigabitEthernet port number

ID of the AP's Ethernet interface.

Port speed(Mbps)

Rate on the upstream Ethernet interface, in Mbit/s.

Port speed mode

Rate mode of the upstream Ethernet interface, including automatic and non-automatic negotiation modes.

Port duplex

Duplex type of the upstream Ethernet interface, including full duplex and half duplex.

Port duplex mode

Duplex mode of the upstream Ethernet interface, including automatic and non-automatic negotiation modes.

Port state

AP interface status.

  • down: indicates that the interface is disabled.
  • up: indicates that the interface is enabled.
  • *down: indicates that the interface is shut down.

STP down recovery time(ddd:hh:mm:ss)

Remaining recovery time of the STP.

Card status

IoT card status.

  • -: indicates that the IoT card is not in position.
  • present: indicates that the IoT card is in position.

display ap sta-signal strength

Function

The display ap sta-signal strength command displays the average signal strength of STAs connected to an AP.

Format

display ap sta-signal strength { ap-name ap-name | ap-id ap-id } [ radio radio-id ]

Parameters

Parameter

Description

Value

ap-name ap-name

Displays the average signal strength of STAs connected to the AP with a specified name.

The AP name must exist.

ap-id ap-id

Displays the average signal strength of STAs connected to the AP with a specified ID.

The AP ID must exist.

radio radio-id

Displays the average signal strength of STAs connected to a specified AP radio.

The value is an integer that ranges from 0 to 2.

Only the AP4030TN, AP4051TN, and AP8050TN-HD supports three radios.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to view the average signal strength of STAs connected to an AP.

Example

# Display the average signal strength of STAs connected to AP huawei.

<HUAWEI> display ap sta-signal strength ap-name huawei
Station signal strength(): 0
Table 11-29  Description of the display ap sta-signal strength command output
Item Description

Station signal strength()

Average signal strength of STAs.

display ap statistics

Function

The display ap statistics command displays statistics on the types of APs added to an AC.

Format

display ap statistics

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Various types of APs can be added to an AC. You can run this command to view types of APs added to an AC and the number of APs of various types.

Example

# Display statistics about AP types.

<HUAWEI> display ap statistics
--------------------------------------------------------------------------------
Type                     Number
--------------------------------------------------------------------------------
AP6010DN-AGN             1
AP6510DN-AGN             1
AP5010DN-AGN             1
--------------------------------------------------------------------------------
Table 11-30  Description of the display ap statistics command output

Item

Description

Type

AP type.

Number

Number of APs of a type.

display ap traffic statistics wireless