display ap

Function

The display ap command displays AP information.

Format

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

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

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

Parameters

Parameter	Description	Value
all	Displays information about all APs.	-
ap-group ap-group	Specifies the AP group to which an AP belongs.	The AP group must exist.
by-ssid ssid	Specifies an SSID.	The SSID must exist.
by-state state	Displays the status of an AP.	The value is of the enumerated type: commit-failed: Displays information about APs in configuration commitment failed state. committing: Displays information about APs in configuration committing state. config: Displays information about APs in configuration initialization state. config-failed: Displays information about APs in initialization failed state. download: Displays information about APs in system software downloading state. fault: Displays information about APs that failed to go online. idle: Displays information about APs in initialization state before the link is established for the first time. name-conflicted: Displays information about APs having duplicate names. normal: Displays information about APs in normal state. standby: Displays information about APs in standby state. ver-mismatch: Displays information about APs with versions that do not match the AC version. countrycode-mismatch: Displays information about APs with country codes that do not match the AC's country code. type-mismatch: Displays information about APs with types that are different from the actual types.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To view information about APs, run this command.

Example

# Display information about all APs.

<HUAWEI> display ap all
Total AP information:
nor  : normal          [2]
ExtraInfo : 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 AP6050DN        nor   0   4H:49M:11S  P
1    60de-4474-9640 area_2 ap-group1 192.168.120.253 AP6050DN        nor   0   6H:3M:40S   -
----------------------------------------------------------------------------------------------------
Total: 2

# Display information about APs bound to SSID hw-wlan.

<HUAWEI> display ap by-ssid hw-wlan
Total AP information:
nor  : normal          [2]
ExtraInfo : 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 AP6050DN        nor   0   4H:49M:11S  P
1    60de-4474-9640 area_2 ap-group1 192.168.120.253 AP6050DN        nor   0   6H:3M:40S   -
----------------------------------------------------------------------------------------------------
Total: 2

# Display information about APs in normal state.

<HUAWEI> display ap by-state normal
Total AP information:
nor  : normal          [2]
ExtraInfo : 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 AP6050DN        nor   0   4H:49M:11S  P
1    60de-4474-9640 area_2 ap-group1 192.168.120.253 AP6050DN        nor   0   6H:3M:40S   -
----------------------------------------------------------------------------------------------------
Total: 2

**Table 1** Description of the **display ap** command output
Item	Description
ID	AP ID.
MAC	MAC address of an AP.
Name	AP name.
Group	Name of the AP group to which an AP belongs.
IP	IP address of an AP.
Type	AP type.
State	AP state. For details, see Table 2.
STA	Number of STAs connected to an AP.
Uptime	Online duration of an AP.
ExtraInfo	Extra information. The value P: insufficient power supply indicates that the power supply to an AP is insufficient The value of D: data link exception indicates that data links of RUs have not established. Check the network connection between the AC and RUs.
Total	Total number of queried APs.

**Table 2** AP state list
AP State	Description	Possible Cause	Handling Suggestion
commit-failed (cmtfa)	WLAN service configurations fail to be delivered to an AP after the AP goes online on an AC.	After an 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 (cmt)	WLAN service configurations are being delivered to an AP after the AP goes online on an AC.	After an AP goes online on the AC, WLAN service configurations are being delivered to the AP. During this process, the AP is in committing state.	This is a normal state, and no action is required.
config (cfg)	WLAN service configurations are being delivered to an AP when the AP is going online on an AC.	After an 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 (cfgfa)	WLAN service configurations fail to be delivered to an AP when the AP is going online on an AC.	After an 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 (dload)	An AP is in upgrade state.	When an 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.	An AP fails to go online, which is usually caused by the following: The AP fails to obtain an IP address or obtains an incorrect IP address. The network between the AP and AC is faulty. The AP fails to be authenticated. The number of APs on an AC has reached the maximum value. The AP is faulty.	Handle the AP online failure. For details, see AP Online Failure in the Troubleshooting Insights.
idle	It is the initialization state of an AP before it establishes a link with the AC for the first time.	When an AP has not established a CAPWAP link with the AC, the MAC address and SN of an AP that is added offline are different from the actual MAC address and SN of the AP, or the AC cannot manage an AP due to license resource insufficiency, the AP enters the idle state.	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: Run the display ap all command to check AP information. Run the undo ap { ap-name ap-name \| ap-id ap-id \| ap-mac ap-mac \| ap-group group-name \| all } command to delete the AP. Run the ap-id ap-id [ [ type-id type-id \| ap-type ap-type ] { ap-mac ap-mac \| ap-sn ap-sn \| ap-mac ap-mac ap-sn ap-sn } ] or ap-mac ap-mac [ type-id type-id \| ap-type ap-type ] [ ap-id ap-id ] [ ap-sn ap-sn ] command to add correct AP information. If the fault persists, expand the license capacity. Note that RUs managed by the AC do not occupy license resources of the AC.
name-conflicted (namec)	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 (nor)	An AP is working properly.	An AP successfully goes online on an AC.	This is a normal state, and no action is required.
standby (stdby)	An 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, an 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 (vmiss)	The version of an AP does not match that of an AC on which the AP is about to go online.	The versions of the AP and AC do not match.	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. Enterprise technical support website: https://support.huawei.com/enterprise Carrier technical support website: https://support.huawei.com
countryCode-mismatch (cmiss)	The version of an AP does not match that of an AC on which the AP is about to go online.	The AP's current version does not support the country code configured on the AC.	The AP does not support the country code. Upgrade the AP or modify the country code configuration on the AC.
type-mismatch (tmiss)	The AP type does not match that configured on the AC.	The AP type configured on the AC did not match the actual AP type.	Change the AP type configured on the AC.
unauth	An AP is not authenticated.	The AP fails to be authenticated.	Run the display ap unauthorized record command to query authenticated APs. Run the ap-confirm command to confirm unauthenticated APs and allow them to go online.