display distribute-ap

Function

The display distribute-ap command displays information about RUs.

Format

display distribute-ap { all | ap-id ap-id | ap-mac ap-mac | ap-name ap-name | central-ap-id central-ap-id | central-ap-mac central-ap-mac | central-ap-name central-ap-name }

Parameters

Parameter	Description	Value
all	Displays information about all RUs.	-
ap-id ap-id	Displays information about the RU of a specified ID.	The RU ID must exist.
ap-mac ap-mac	Displays information about the RU of a specified MAC address.	The MAC address must exist.
ap-name ap-name	Displays information about the RU of a specified name.	The RU name must exist.
central-ap-id central-ap-id	Displays information about the RUs connected to the central AP of a specified ID.	The central AP ID must exist.
central-ap-mac central-ap-mac	Displays information about the RUs connected to the central AP of a specified MAC address.	The MAC address of the central AP must exist.
central-ap-name central-ap-name	Displays information about the RUs connected to the central AP of a specified name.	The central AP name must exist.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to check RU information.

Example

# Display information about all RUs.

<HUAWEI> display distribute-ap all
Total AP information: 
nor : normal           [3] 
-----------------------------------------------------------------------------------------------------------------
ID   MAC            Name           Group   IP         Type  State  Central-AP ID  Central-AP MAC  Central-AP name
-----------------------------------------------------------------------------------------------------------------
1    fcb6-98f5-ec20 fcb6-98f5-ec20 240D-1  10.1.1.182 R240D nor    0              88cf-9837-98a0  88cf-9837-98a0 
2    fcb6-98f5-7280 fcb6-98f5-7280 240D    10.1.1.158 R240D nor    0              88cf-9837-98a0  88cf-9837-98a0 
3    fcb6-98f6-0ce0 ap1            default 10.1.1.181 R240D nor    0              88cf-9837-98a0  88cf-9837-98a0 
-----------------------------------------------------------------------------------------------------------------
Total: 3

**Table 1** Description of the **display distribute-ap all** command output
Item	Description
ID	RU ID.
MAC	MAC address of the RU.
Name	Name of the RU.
Group	AP group to which an RU belongs.
IP	IP address of the RU.
Type	RU type.
State	RU state, which is the same as a common AP. For details, see Table 2.
Central-AP ID	ID of the central AP.
Central-AP MAC	MAC address of the central AP.
Central-AP name	Name of the central AP.

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