WLAN Service Configuration Commands
- Command Support
- ac sysnetid
- access-user syslog-restrain enable
- access-user syslog-restrain period
- ac-list (AP view)
- ac-list(AP provisioning view)
- active-dull-client enable
- address-mode (AP view)
- address-mode (AP provisioning view)
- advertise-ap-name enable
- agile-antenna-polarization
- alarm-restriction disable
- alarm-restriction period
- antenna-gain
- ap auth-mode
- ap blacklist
- ap data-collection enable
- ap data-collection interval
- ap lldp enable
- ap manufacturer-config
- ap modify
- ap update ftp-server
- ap update ftp-server max-connect-number
- ap update load
- ap update mode
- ap update multi-load
- ap update multi-reset
- ap update reset
- ap update sftp-server
- ap update sftp-server max-connect-number
- ap update update-filename
- ap update schedule-task
- ap username
- ap whitelist
- ap-confirm
- ap-group
- ap-group (AP provisioning view)
- ap-group (AP view)
- ap-id
- ap-mac
- ap-mode
- ap-name
- ap-name (AP provisioning view)
- ap-name (AP view)
- ap-ping
- ap-regroup
- ap-rename
- ap-reset
- ap-reset work-group
- ap-system-profile (WLAN view)
- ap-system-profile (AP group view and AP view)
- assignment
- association-timeout
- auto-off service
- beacon-2g-rate
- beacon-5g-rate
- beacon-interval
- beamforming enable
- capwap control-link-priority
- capwap dtls control-link encrypt
- capwap dtls psk
- capwap dtls psk-mandatory-match enable
- capwap echo
- capwap echo-timeout trace logging
- capwap message-integrity psk
- capwap message-integrity check disable
- capwap sensitive-info psk
- capwap source interface
- channel
- channel-load-mode indoor
- channel-switch announcement disable
- channel-switch mode
- clear configuration this
- commit (AP provisioning view)
- console disable
- coordinate
- copy-from
- country-code
- coverage distance
- cpu-usage threshold
- crc-alarm enable
- dai enable (AP wired port profile view)
- deny-broadcast-probe enable
- description (AP wired port profile view)
- dhcp option82 insert enable
- dhcp option82 format (vap profile view)
- display ac global configuration
- display ap
- display ap around-ssid-list
- display ap asyn-message err-info
- display ap blacklist
- display ap config-info
- display ap configurable channel
- display ap coordinate
- display ap elabel
- display ap global configuration
- display ap lldp neighbor
- display ap neighbor
- display ap offline-record
- display ap online-fail-record
- display ap optical-info
- display ap performance statistics
- display ap provision
- display ap port
- display ap power-workmode
- display ap resource
- display ap run-info
- display ap sta-signal strength
- display ap statistics
- display ap traffic statistics wireless
- display ap unauthorized record
- display ap uncontrol all
- display ap update configuration
- display ap update schedule-task
- display ap update status
- display ap username
- display ap version
- display ap whitelist
- display ap wired-port
- display ap-group
- display ap-system-profile
- display ap-type
- display capwap configuration
- display channel switch-record
- display distribute-ap
- display mac-address ap-all
- display mac-address { ap-id | ap-name }
- display port-link-profile
- display provision-ap parameter-list
- display radio
- display radio-2g-profile
- display radio-5g-profile
- display references ap-system-profile
- display references port-link-profile
- display references radio-2g-profile
- display references radio-5g-profile
- display references regulatory-domain-profile
- display references ssid-profile
- display references vap-profile
- display references vlan pool
- display references wired-port-profile
- display regulatory-domain-profile
- display snmp-agent trap feature-name wlan all
- display ssid-profile
- display sta-offline-delay configuration
- display station
- display station assoc-info ap-offline-record
- display station online-fail-record
- display station offline-record
- display station statistics
- display vap
- display vap create-fail-record
- display vap-profile
- display vlan pool
- display wired-port-profile
- display wlan config-errors
- display wlan work-group
- dot11a basic-rate
- dot11a supported-rate
- dot11bg basic-rate
- dot11bg supported-rate
- dtim-interval
- eapol-response dest-address transform-condition
- eapol-response dest-address transform-to
- eapol-start dest-address transform-condition
- eapol-start dest-address transform-to
- eirp
- eth-trunk (AP wired port profile view)
- forward-mode
- fragmentation-threshold
- frequency
- guard-interval-mode
- high-temperature threshold
- ht a-mpdu disable
- ht a-mpdu max-length-exponent
- ipsg enable (AP wired port profile view)
- ip-address (AP view)
- ip-address (AP provisioning view)
- keep-service enable
- keep-service enable allow new-access
- learn-client-address enable (AP wired port profile view)
- legacy-station disable
- lldp admin-status
- lldp dot3-tlv power (AP wired port link profile view)
- lldp enable
- lldp message-transmission delay (AP system profile view)
- lldp message-transmission hold-multiplier (AP system profile view)
- lldp message-transmission interval (AP system profile view)
- lldp report enable
- lldp report-interval
- lldp restart-delay
- lldp tlv-enable (AP wired port link profile view)
- lldp tlv-enable legacy-tlv four-pair-power (AP wired port link profile view)
- log-record-level
- log-server
- low-temperature threshold
- management-vlan
- master-slot
- max-sta-number (SSID profile view)
- memory-usage threshold
- mtu
- mu-mimo disable
- mu-mimo optimize enable
- multicast-rate
- poe af-inrush enable (AP system profile view)
- poe disable (AP wired port link profile view)
- poe force-power (AP wired port link profile view)
- poe high-inrush enable (AP system profile view)
- poe legacy enable (AP wired port link profile view)
- poe max-power (AP system profile view)
- poe power-reserved (AP system profile view)
- poe power-threshold (AP system profile view)
- poe power-off time-range (AP wired port link profile view)
- poe priority (AP wired port link profile view)
- port-link-profile (WLAN view)
- port-link-profile (AP wired port profile view)
- probe-response-retry
- provision-ap
- qbss-load enable
- radio
- radio disable
- radio-2g-profile (WLAN view)
- radio-2g-profile
- radio-5g-profile (WLAN view)
- radio-5g-profile
- radio-type (2G radio profile view)
- radio-type (5G radio profile view)
- reach-max-sta hide-ssid disable
- regulatory-domain-profile (WLAN view)
- regulatory-domain-profile
- report-disassoc-request disable
- report-sta-assoc enable
- report-sta-info enable
- reset ap offline-record
- reset ap online-fail-record
- reset ap unauthorized record
- reset channel switch-record
- reset mac-address { ap-id | ap-name }
- reset station assoc-info ap-offline-record
- reset station offline-record
- reset station online-fail-record
- reset station statistics
- reset statistics
- rf-ping
- rts-cts-mode
- rts-cts-threshold
- sample-time
- service-mode disable
- service-slot
- service-vlan (VAP profile view)
- sftp server disable
- short-preamble disable
- shutdown (AP wired port link profile view)
- single-txchain enable
- slave-slot
- snmp-agent trap enable feature-name wlan
- ssh client first-time enable (AP system profile view)
- ssid
- ssid-hide enable
- ssid-profile (WLAN view)
- ssid-profile (VAP profile view)
- sta-ipv6-service enable
- sta-network-detect disable
- sta-offline-delay aging-time
- sta-offline-delay enable
- sta-offline-delay full-sta-reject enable
- sta-offline-delay max-number
- state block
- stelnet server disable
- stp auto-shutdown enable (AP wired port profile view)
- stp auto-shutdown recovery-time (AP wired port profile view)
- telnet enable
- temporary-management enable (AP system profile view)
- temporary-management enable (VAP profile view)
- temporary-management psk
- traffic-filter (AP wired port profile view)
- traffic-remark (AP wired port profile view)
- traffic-optimize (AP wired port profile view)
- traffic-optimize broadcast-suppression enable (AP system profile view)
- traffic-optimize broadcast-suppression rate-threshold (AP system profile view)
- type (VAP profile view)
- u-apsd enable
- undo ap
- usb enable(AP system profile view)
- user-interface vty idle-timeout
- user-interface vty screen-length
- utmost-powerdisable
- vap-profile (WLAN view)
- vap-profile
- vht a-mpdu max-length-exponent
- vht a-msdu enable
- vht a-msdu max-frame-num
- vht mcs-map
- vlan pool
- vlan (VLAN pool view)
- wifi-light
- wired-port-profile (WLAN view)
- wired-port-profile (AP group view and view)
- wlan
- wlan work-group
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 (#). |
access-user syslog-restrain enable
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.
access-user syslog-restrain period
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.
ac-list (AP view)
Parameters
Parameter | Description | Value |
---|---|---|
ipv4-address | Specifies the IPv4 address of an AC. | The value is in dotted decimal notation. |
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)
Parameters
Parameter | Description | Value |
---|---|---|
ipv4-address | Specifies the IPv4 address of an AC. | The value is in dotted decimal notation. |
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.
active-dull-client enable
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.
address-mode (AP view)
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. | - |
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)
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. | - |
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.
advertise-ap-name enable
Usage Guidelines
In certain scenarios, you can run the advertise-ap-name enable command to enable Beacon frames to carry the AP name. In this way, you can quickly locate and identify APs by identifying the AP name carried in an SSID or display the AP name on STAs that can receive and resolve the host name carried in SSIDs of multiple APs.
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.
Usage Guidelines
Usage Scenario
- STA with one transmit antenna and one receive antenna in 1x1 mode
- STA with two transmit antennas and two receive antennas in 2x2 mode
Prerequisites
Dual-polarized antennas have been connected to radio ports A and B on the same frequency band.
alarm-restriction disable
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.
alarm-restriction period
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.
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.
Enterprise technical support website: http://support.huawei.com/enterprise
Carrier technical support website: http://support.huawei.com
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.
ap blacklist
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. |
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
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.
ap lldp enable
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.
ap manufacturer-config
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. |
ap modify
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.
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. |
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:
- Run the ap update mode command to set the upgrade mode to ftp-mode.
- 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.
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
Usage Guidelines
Usage Scenario
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
- 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.
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. |
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
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. |
- |
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.
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. |
Usage Guidelines
Usage Scenario
- 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.
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
<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
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. |
Usage Guidelines
This command resets APs in batches and can be used only after APs are upgraded in batches.
- 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.
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.
ap update reset
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. |
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.
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. |
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:
- Run the ap update mode command to set the upgrade mode to sftp-mode.
- 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.
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
Usage Guidelines
Usage Scenario
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
- 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.
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. |
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
ap update schedule-task
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. |
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.
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:
|
Usage Guidelines
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.
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. |
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
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.
ap-group
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.
ap-group (AP provisioning view)
Parameters
Parameter | Description | Value |
---|---|---|
ap-group | Specifies the group that an AP joins. | The AP group must exist. |
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.
ap-group (AP view)
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
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:
|
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. |
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.
ap-mac
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:
|
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. |
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.
ap-mode
Parameters
Parameter | Description | Value |
---|---|---|
fat | Specifies the Fat mode. | - |
cloud | Specifies the cloud mode. | - |
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 (AP provisioning view)
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 (" "). |
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.
ap-name (AP view)
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 (" "). |
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.
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. |
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
Parameters
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
ap-rename
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 (" "). |
ap-reset
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
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.
ap-reset work-group
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. | - |
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.
ap-system-profile (WLAN view)
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.
ap-system-profile (AP group view and AP view)
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
Parameters
Parameter | Description | Value |
---|---|---|
even | Sets the VLAN assignment algorithm to even. |
- |
hash | Sets the VLAN assignment algorithm to hash. |
- |
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.
association-timeout
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.
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. |
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.
beacon-2g-rate
Parameters
Parameter | Description | Value |
---|---|---|
beacon-2g-rate | Specifies the transmit rate of Beacon frames. | Enumerated type:
|
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.
beacon-5g-rate
Parameters
Parameter | Description | Value |
---|---|---|
beacon-5g-rate | Specifies the transmit rate of Beacon frames. | Enumerated type:
|
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.
beacon-interval
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.
- 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
beamforming enable
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.
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 |
capwap control-link-priority
Format
capwap control-link-priority { local | remote } priority-value
undo capwap control-link-priority { local | remote }
Parameters
Parameter |
Description |
Value |
---|---|---|
local |
Indicates the priority of CAPWAP management packets from an AC to an AP. The priority of CAPWAP management packets determines the reliability of the link between an AC and an AP. |
- |
remote |
Indicates the priority of CAPWAP management packets from an AP to an AC. The priority of CAPWAP management packets determines the reliability of the link between an AP and an AC. |
- |
priority-value |
Specifies the priority of CAPWAP management packets. |
The value is an integer that ranges from 0 to 7. The value 0 indicates the lowest priority, and the value 7 indicates the highest priority. |
Usage Guidelines
Usage Scenario
You can use the capwap control-link-priority command to configure the DSCP priority of CAPWAP management packets. A higher priority indicates a more reliable link between the AC and AP.
The configuration of the priority of CAPWAP management packets from an AC to an AP takes effect immediately. After the priority of CAPWAP management packets from an AP to an AC is changed, if the AP is online, the priority is sent to the AP in the Echo packet. If the AP is not online, the priority is delivered to the AP in the Echo packet when the AP goes online. The new priority takes effect once the AP receives it.
Precautions
capwap dtls control-link encrypt
Function
The capwap dtls control-link encrypt command enables the function of encrypting the CAPWAP control tunnel using Datagram Transport Layer Security (DTLS).
The undo capwap dtls control-link encrypt command disables the function of encrypting the CAPWAP control tunnel using DTLS.
By default, the function of encrypting the CAPWAP control tunnel using DTLS is disabled.
Usage Guidelines
Usage Scenario
In the Discovery phase of the CAPWAP tunnel establishment between the AP and the AC, the AP obtains the AC IP address using the discovery mechanism. Then in the DTLS negotiation phase, the CAPWAP tunnel encrypts UDP packets using DTLS.
After this command is run, the CAPWAP control packets between the AP and AC are encrypted using DTLS, and the AP and AC use the PSK to perform DTLS negotiation. If the DTLS negotiation fails, the CAPWAP tunnel cannot be established.
Configuration Impact
After this command is run, the AP and AC reestablish a CAPWAP tunnel.
The HA function and DTLS encryption of an inter-AC tunnel cannot be enabled simultaneously on a device; otherwise, the AP waits until the original CAPWAP link is aged out before setting up a new one. During this process, AP services are interrupted. It is recommended that you disable DTLS encryption of an inter-AC tunnel on networks where HA is enabled.
Precautions
When HA is enabled or APs are being upgraded, the status of DTLS encryption cannot be changed.
Example
# Enable the function of encrypting the CAPWAP control tunnel using DTLS.
<HUAWEI> system-view [HUAWEI] capwap dtls control-link encrypt Warning: The DTLS PSK is the default one. It is recommended to change it to ensure security. Change it now?[Y/N]:y New PSK:huawei@123 Configuring the new PSK, waiting......................done. Warning: This operation may cause devices connected through CAPWAP to reset or go offline. Continue? [Y/N]:y
capwap dtls psk
Parameters
Usage Guidelines
Usage Scenario
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.
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.
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.
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. |
Usage Guidelines
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.
PrecautionsIf 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.
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.
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.
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. |
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.
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
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.
Parameters
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.
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
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 }
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.
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. |
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
Enterprise technical support website: http://support.huawei.com/enterprise
Carrier technical support website: http://support.huawei.com
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.
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.
channel-load-mode indoor
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
<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.
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.
channel-switch mode
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.
clear configuration this
Function
The clear configuration this command clears all configurations in the AP provisioning view.
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.
commit (AP provisioning view)
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. |
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
coordinate
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).
|
longitude w longitude-value | Specifies the west longitude value of an AP. |
The value supports two formats: DMS and DD.
|
latitude s latitude-value | Specifies the south longitude value of an AP. |
The value supports two formats: DMS and DD.
|
latitude n latitude-value | Specifies the north longitude value of an AP. |
The value supports two formats: DMS and DD.
|
copy-from
Usage Guidelines
Usage Scenario
- 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.
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. |
Usage Guidelines
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
<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.
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. |
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.
cpu-usage threshold
Usage Guidelines
- 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.
crc-alarm enable
Function
The crc-alarm enable command enables the alarm function for CRC errors on the AP wired interface and specifies the alarm threshold and clear alarm threshold.
The undo crc-alarm enable command disables the alarm function for CRC errors on the AP wired interface and restores the alarm threshold and clear alarm threshold to the default values.
By default, the alarm function for CRC errors is disabled on the AP wired interface. The alarm threshold for CRC errors is 50 and the clear alarm threshold is 20.
Format
crc-alarm enable [ high-threshold high-threshold-value | low-threshold low-threshold-value ]*
undo crc-alarm enable
Parameters
Parameter |
Description |
Value |
---|---|---|
high-threshold high-threshold-value | Specifies the alarm threshold for CRC errors on the AP wired interface. | The value is an integer ranging from 1 to 100. The unit is 1/10000. The value of high-threshold-value must be larger than the value of low-threshold-value. |
low-threshold low-threshold-value | Specifies the clear alarm threshold for CRC errors on the AP wired interface. | The value is an integer ranging from 1 to 100. |
Usage Guidelines
When the AP detects that the number of CRC errors exceeds the configured upper alarm threshold in a specified period (the time period can be configured using the sample-time command, and is 30s by default), it sends an alarm message to the AC. To prevent the AP from frequently sending alarm messages or alarm clearance messages to the AC, you need to configure the lower threshold for clearing the alarm. The AP sends an alarm clearance message to the AC only when the AP detects that the number of CRC errors is lower than the configured lower threshold.
dai enable (AP wired port profile view)
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.
deny-broadcast-probe enable
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.
description (AP wired port profile view)
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.
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.
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. | - |
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.
- 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.
display ac global configuration
Example
# Display AC global configuration.
<HUAWEI> display ac global configuration
--------------------------------------------------------------------------------
AC sysnetid : AC
--------------------------------------------------------------------------------
Item | Description |
---|---|
AC sysnetid |
NE name of an AC. To configure the NE name for an AC, run the ac sysnetid command. |
display ap
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.
|
Example
<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
<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
<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
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. |
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:
|
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:
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. |
display ap around-ssid-list
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
<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
display ap asyn-message err-info
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. |
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
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.
|
display ap blacklist
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
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. |
display ap config-info
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 : - ---------------------------------------------------------------------------------
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.
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. |
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.
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.
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
Item |
Description |
---|---|
ID |
AP ID. |
Name |
AP name. |
Group |
AP group. |
Longitude |
Longitude of an AP. Its display varies depending on the format:
|
Latitude |
Latitude of an AP.
|
display ap elabel
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. |
- |
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=
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
display ap global configuration
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
--------------------------------------------------------------------------------
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
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.
|
- |
brief |
Displays brief LLDP neighbor information of APs. |
- |
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
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 --------------------------------------------------------------------------------
Item | Description |
---|---|
Neighbor index |
Index of a neighbor. |
Host Name |
AP name |
Chassis ID type |
ID subtype of a neighbor device.
|
Chassis ID |
ID of the neighbor device.
|
Port ID type |
ID subtype of the neighbor interface.
|
Port ID |
ID of the neighbor interface.
|
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.
|
System capabilities enabled |
Capabilities enabled on the neighbor device.
|
Management address type |
Management address type of the neighbor. |
Management address |
Management address of the neighbor. |
Power port class | PoE type:
|
PSE power supported | Whether the PSE power is supported.
|
PSE power enabled | Whether the PSE power is enabled.
|
PSE pairs control ability | Whether the PSE control is supported.
|
Power pairs | PoE remote power supply mode.
|
Port power classification | PD power control level on the interface:
|
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:
|
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.
|
PD Load | Whether 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.
|
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. |
display ap neighbor
Function
The display ap neighbor command displays information about neighbors of a radio, including authorized and unauthorized neighbors.
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. |
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
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
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
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. |
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
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
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. |
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
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.
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 --------------------------------------------------------------------------------
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
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 --------------------------------------------------------------------------------
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
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 : -
--------------------------------------------------------------------------------
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
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. |
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
Parameter | Description |
---|---|
AP-ID |
AP ID. |
Port |
AP port. |
State |
Status of the AP port.
|
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
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. |
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
Item | Description |
---|---|
ID |
AP ID. |
MAC |
AP MAC address. |
Name |
AP name. |
Group |
AP group to which an AP belongs. |
Power-workmode |
|
Decided by |
The current power mode of an AP is determined by:
|
display ap resource
Function
The display ap resource command displays the number of CAPWAP tunnel resources used by APs on a card.
Usage Guidelines
- 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.
display ap run-info
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
<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: - --------------------------------------------------------------------------------
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.
|
STP down recovery time(ddd:hh:mm:ss) |
Remaining recovery time of the STP. |
Card status |
IoT card status.
|
display ap sta-signal strength
Function
The display ap sta-signal strength command displays the average signal strength of STAs connected to an AP.
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. |
Usage Guidelines
You can run this command to view the average signal strength of STAs connected to an AP.
display ap statistics
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
--------------------------------------------------------------------------------