专业知识
华为AP上线失败定位常用定位思路
2022-06-26
AP上线失败定位常用定位思路
查看AP信息
命令行：display ap { all | ap-group ap-group }
用途：主要用于查看AP的IP地址以及状态信息，重点关注AP是否正常获取到IP地址，AP状态是否正常。
AP的状态如表8-1所示。
表8-1 AP状态列表
|
AP状态 |
描述 |
处理建议 |
|---|---|---|
|
commit-failed（cmtfa） |
AP上线后WLAN业务配置下发失败状态。 AP在AC上正常上线之后，在AC上对AP进行WLAN业务配置，如果AC和AP之间存在链路不通或者对端设备无回应等情况，AC下发WLAN业务配置给AP失败。 |
检查AC和AP之间网络状态。请参考AP和AC之间的网络不通进行处理。 |
|
committing（cmt） |
AP上线后WLAN业务配置正在下发状态。 AP在AC上正常上线之后，在AC上对AP进行WLAN业务配置，AC给AP下发这些配置的过程就是committing状态。 |
正常过程状态，无需关注。 |
|
config（cfg） |
AP上线过程中WLAN业务配置正在下发状态。 当AP和AC建链成功后，在AC下发业务配置给AP的阶段，AP的状态为config。 |
正常过程状态，无需关注。 |
|
config-failed（cfgfa） |
AP上线过程中的WLAN业务配置下发失败状态。 当AP和AC建链成功后，AC下发业务配置给AP，如果存在链路不通等原因，下发失败，AP的状态为config-failed。 |
AC下发初始化配置失败，请参考AP初始化配置失败进行处理。 |
|
download（dload） |
AP正在升级状态。 AP执行升级操作时，会切换到download状态。 |
AP升级状态，请确认AP升级结束后，再次查看AP状态。如果升级失败，请参考AP在线升级失败进行处理。 |
|
fault |
AP上线失败状态。 |
请参考查看AP上线失败的原因查看AP上线失败的具体原因。 |
|
idle |
AP和AC建链前的初始状态。 |
idle状态可能的原因以及对应的处理手段如下：
|
|
name-conflicted（namec） |
AP名称重名冲突状态。 AP的名称和已在AC上上线的AP名称冲突 |
执行命令ap-rename ap-id ap-id new-name ap-new-name更改AP名称。 |
|
normal（nor） |
AP正常状态。 AP在AC上成功上线。 |
正常过程状态，无需关注。 |
|
standby（stdby） |
AP在备AC上的正常状态。 在双机热备份、双链路冷备份和N+1备份场景下，主备AC链路建立正常，AP正常上线之后在备AC上的状态是standby状态，在主AC上是normal状态。 |
正常过程状态，无需关注。 |
|
ver-mismatch（vmiss） |
AC和AP的版本不匹配状态。 |
请参考AC和AP之间版本不匹配进行处理。 |
|
countryCode-mismatch（cmiss） |
AC和AP的国家码不匹配状态。 AP不支持AC上配置的国家码。 |
AP不支持该国家码，请升级AP或者修改AC的国家码配置。 |
|
type-mismatch（tmiss） |
AP类型不匹配状态。 配置的AP类型和实际不匹配。 |
请修改AP类型配置。 |
|
unauth |
AP未通过认证的状态。 |
可使用命令display ap unauthorized record查询未通过认证的AP。 执行命令ap-confirm，确认认证未通过的AP，可允许其上线。 |
查看AP上线失败的原因
命令行：display ap online-fail record
用途：主要用于查看AP上线失败的原因，然后可以根据具体原因采取相应的措施。
AP上线失败原因（仅列举部分上线失败原因）如表8-2所示。
表8-2 AP上线失败原因列表
|
AP上线失败原因 |
解释 |
处理建议 |
|---|---|---|
|
Insufficient license resources. |
License资源不足。 |
请参考AP连接数超过AC最大能接入的AP数进行处理。 |
|
The AP is not in the SN whitelist. |
AP不在SN白名单中。 |
请执行命令ap whitelist sn ap-sn1 [ to ap-sn2 ]添加AP到白名单，或者执行命令ap-confirm对此AP执行通过认证操作。 |
|
The AP is not in the MAC whitelist. |
AP不在MAC白名单中。 |
请执行命令ap whitelist mac ap-mac1 [ to ap-mac2 ]添加AP到白名单，或者执行命令ap-confirm对此AP执行通过认证操作。 |
|
The AP is added to the AP blacklist. |
AP被添加到黑名单中。 |
请参考AP被加入到黑名单进行处理。 |
|
The MAC address and SN of the AP do not match. |
AP的MAC和SN不匹配。 |
请参考AC上配置的AP MAC和AP SN与实际AP不一致进行处理。 |
|
DTLS negotiation for CAPWAP tunnel setup fails. |
CAPWAP链路的DTLS协商失败。 |
请参考DTLS协商失败进行处理。 |
|
DTLS negotiation failed, because of negotiation timeout or inconsistent PSKs on two ends. |
DTLS协商失败，协商超时或者密钥不一致。 |
请参考DTLS协商失败进行处理。 |
|
CAPWAP tunnel negotiation fails. |
CAPWAP建链协商失败。 |
请参考AP和AC之间的网络不通进行处理。 |
|
APs cannot go online during data backup. |
数据备份期间暂停支持AP上线。 |
请等待备份结束。 |
|
The upgrade fails. |
升级失败。 |
请参考AP在线升级失败进行处理。 |
|
The CAPWAP tunnel fails to be established. |
CAPWAP建链失败。 |
请参考AP和AC之间的网络不通进行处理。 |
|
The configuration fails to be delivered. |
配置下发失败。 |
设备会尝试重新下发配置，若持续失败请参考AP和AC之间的网络不通进行处理。 |
|
The versions of the AP and AC do not match. |
AP版本与AC版本不匹配。 |
请参考AC和AP之间版本不匹配进行处理。 |
|
The AC does not support the AP type. |
AC不支持此AP类型。 |
请更换AP为AC支持的类型，或更换AC版本为支持此AP的版本。 |
|
Unsupported AP type, AC version may need to be upgraded. |
||
|
The AP name conflicts. |
AP名称冲突。 |
请通过命令ap-rename修改AP名称。 |
|
The number of central APs reaches the upper limit. |
中心AP数达到最大规格。 |
请参考AP连接数超过AC最大能接入的AP数进行处理。 |
|
The number of common APs reaches the upper limit. |
普通AP数达到最大规格。 |
请参考AP连接数超过AC最大能接入的AP数进行处理。 |
|
The CAPWAP sensitive-info PSK is different on the two ends of the CAPWAP tunnel. |
CAPWAP链路两端敏感信息加密预共享密钥不匹配。 |
请参考DTLS协商失败进行处理。 |
|
The CAPWAP integrity-check PSK is different on the two ends of the CAPWAP tunnel. |
CAPWAP链路两端报文完整性校验预共享密钥不匹配。 |
请参考DTLS协商失败进行处理。 |
|
The AC license is not active. |
AC license没有激活。 |
请激活AC license。 |
|
Too many APs go online concurrently, leading to a failure to create sufficient DBSS interfaces. |
并发上线AP数过多，DBSS口还没有及时创建完成。 |
无需处理，AP会尝试重新上线。 |
|
The country codes of the AP and AC are inconsistent, and the country code of the AP is locked. |
AP的国家码和AC下发的不一致，AP国家码已锁定。 |
部分AP款型的国家码不可修改，例如后缀是-US的AP款型，仅在美国使用，国家码固定为美国。在AC上配置国家码，应和AP的国家码保持一致。 |
|
Reset for the AC mode switching. |
AC模式切换。 |
无需处理。 |
全流程跟踪
命令行：trace enable brief和trace object mac-address ap-mac-address
用途：对AP进行业务流程诊断，重点关注打印信息中是否存在异常情况。
正常的AP上线全流程如下所示，包含了获取IP地址、Discovery、Join、配置下发以及配置更新等各个阶段。如果AP上线失败，可以通过全流程跟踪方式进行定位，通过将打印信息和正常流程进行对比，来观察AP是在哪个阶段出现的问题，然后有针对地进行故障处理。
[AC] trace enable brief [AC] trace object mac-address acf9-703e-90a0 [BTRACE][2020/03/12 15:36:01][768][DHCPPRO][acf9-703e-90a0]:Receive DHCP DISCOVER message.orgif:GE0/0/3 srcif:Vlanif400 L3if:Vlanif400 DstIf:GE0/0/3 srcmac:acf9-703e-90a0 dstmac:ffff-ffff-ffff vsi:- vlan:400/0 srcip:0.0.0.0 dstip:255.255.255.255 VPN:- src-port:68 dst-port:67 msgtype:BOOT-REQUEST dhcp msgtype:DHCP DISCOVER bflag:uc chaddr:acf9-703e-90a0 ciaddr:0.0.0.0 reqip:0.0.0.0 giaddr:0.0.0.0 serverid:0.0.0.0 yiaddr:0.0.0.0 xid:0x166d4ae3 [BTRACE][2020/03/12 15:36:01][768][DHCPS][acf9-703e-90a0]:DHCP Server is enable.(interface:Vlanif400). [BTRACE][2020/03/12 15:36:01][768][DHCPS][acf9-703e-90a0]:Gateway=192.168.1.1, mask=255.255.255.0. [BTRACE][2020/03/12 15:36:01][768][DHCPS][acf9-703e-90a0]:Get pool Vlanif400 by gateway 192.168.1.1 and vrf 0. [BTRACE][2020/03/12 15:36:01][768][DHCPS][acf9-703e-90a0]:New session hash node(mac:acf9-703e-90a0 Xid=376261347) [BTRACE][2020/03/12 15:36:01][768][DHCPS][acf9-703e-90a0]:Discover session create(Xid=376261347 mac:acf9-703e-90a0) [BTRACE][2020/03/12 15:36:01][768][DHCPS][acf9-703e-90a0]:Get pool Vlanif400 by gateway 192.168.1.1 and vrf 0. [BTRACE][2020/03/12 15:36:01][768][DHCPS][acf9-703e-90a0]:Proc Request IP ACK.(MsgType = 773, MsgType = 1, usPool = 0, ERRcode = 10, IPAlloc = 192.168.1.176, SessionStatus = 0) [BTRACE][2020/03/12 15:36:01][768][DHCPS][acf9-703e-90a0]:Send DHCP OFFER packet.(Chaddr=acf9-703e-90a0, Offer IP=192.168.1.176). [BTRACE][2020/03/12 15:36:01][768][DHCPPRO][acf9-703e-90a0]:Receive DHCP OFFER message.orgif: srcif: L3if: DstIf:GE0/0/3 srcmac:084f-0a6d-0df2 dstmac:acf9-703e-90a0 vsi:- vlan:400/0 srcip:192.168.1.1 dstip:192.168.1.176 VPN:- src-port:67 dst-port:68 msgtype:BOOT-REPLY dhcp msgtype:DHCP OFFER bflag:uc chaddr:acf9-703e-90a0 ciaddr:0.0.0.0 reqip:0.0.0.0 giaddr:0.0.0.0 serverid:192.168.1.1 yiaddr:192.168.1.176 xid:0x166d4ae3 [BTRACE][2020/03/12 15:36:01][768][DHCPPRO][acf9-703e-90a0]:Receive DHCP REQUEST message.orgif:GE0/0/3 srcif:Vlanif400 L3if:Vlanif400 DstIf:GE0/0/3 srcmac:acf9-703e-90a0 dstmac:ffff-ffff-ffff vsi:- vlan:400/0 srcip:0.0.0.0 dstip:255.255.255.255 VPN:- src-port:68 dst-port:67 msgtype:BOOT-REQUEST dhcp msgtype:DHCP REQUEST bflag:uc chaddr:acf9-703e-90a0 ciaddr:0.0.0.0 reqip:192.168.1.176 giaddr:0.0.0.0 [BTRACE][2020/03/12 15:36:01][768][DHCPS][acf9-703e-90a0]:Send DHCP ACK packet.(Chaddr=acf9-703e-90a0, Offer IP=192.168.1.176). [BTRACE][2020/03/12 15:36:01][768][DHCPPRO][acf9-703e-90a0]:Receive DHCP ACK message.orgif: srcif: L3if: DstIf:GE0/0/3 srcmac:084f-0a6d-0df2 dstmac:acf9-703e-90a0 vsi:- vlan:400/0 srcip:192.168.1.1 dstip:192.168.1.176 VPN:- src-port:67 dst-port:68 msgtype:BOOT-REPLY dhcp msgtype:DHCP ACK bflag:uc chaddr:acf9-703e-90a0 ciaddr:0.0.0.0 reqip:0.0.0.0 giaddr:0.0.0.0 serverid:192.168.1.1 yiaddr:192.168.1.176 xid:0x166d4ae3 [BTRACE][2020/03/12 15:36:12][256][WLAN_AC][acf9-703e-90a0]:[Process:1][CAPWAP] Process discovery request message. [BTRACE][2020/03/12 15:36:12][256][WLAN_AC][acf9-703e-90a0]:[Process:1][CAPWAP] Send discovery response successfully. MAC: acf9-703e-90a0 [BTRACE][2020/03/12 15:36:17][512][WLAN_AC][acf9-703e-90a0]:[Process:2][CAPWAP] Create Link Success, Link[3] Sip[192.168.1.176] SrcUdpPort[58138] Vpn[-1]. [BTRACE][2020/03/12 15:36:17][512][WLAN_AC][acf9-703e-90a0]:[Process:2][CAPWAP] Process join request message. MAC: acf9-703e-90a0 [BTRACE][2020/03/12 15:36:17][512][WLAN_AC][acf9-703e-90a0]:[Process:2][CAPWAP] Send join response successfully. MAC: acf9-703e-90a0 [BTRACE][2020/03/12 15:36:17][512][WLAN_AC][acf9-703e-90a0]:[Process:2][CAPWAP] Process config status request message. MAC: acf9-703e-90a0 [BTRACE][2020/03/12 15:36:17][512][WLAN_AC][acf9-703e-90a0]:[Process:2][CAPWAP] Send configuation state response successfully. MAC: acf9-703e-90a0 [BTRACE][2020/03/12 15:36:17][512][WLAN_AC][acf9-703e-90a0]:[Process:2][CAPWAP] Process change state event request message and status id CONFIGURE. MAC: acf9-703e-90a0 [BTRACE][2020/03/12 15:36:17][512][WLAN_AC][acf9-703e-90a0]:[Process:2][CAPWAP] Send change state event response successfully. MAC: acf9-703e-90a0 [BTRACE][2020/03/12 15:36:17][512][WLAN_AC][acf9-703e-90a0]:[Process:2][CAPWAP] FSM DataLinkEnterinRun, Dlink[3] CLink[3] Mac[acf9-703e-90a0] DevId[1] [BTRACE][2020/03/12 15:36:17][512][WLAN_AC][acf9-703e-90a0]:[Process:2][CAPWAP] CtrlLink[3] enterin run. MAC: acf9-703e-90a0 [BTRACE][2020/03/12 15:36:18][512][WLAN_AC][acf9-703e-90a0]:[WDEV] AP:1 CONFIG phase-0 Func-0xacb8accc TimeOut-300000 IsDAp-0 Ret-0x0 IsNeedCfg-0 [BTRACE][2020/03/12 15:36:18][512][WLAN_AC][acf9-703e-90a0]:[WDEV] AP:1 CONFIG notify next phase result-0x0 [BTRACE][2020/03/12 15:36:18][512][WLAN_AC][acf9-703e-90a0]:[WDEV] AP:1 CONFIG phase-1 Func-0xabf7f150 TimeOut-300000 IsDAp-0 Ret-0x0 IsNeedCfg-1 [BTRACE][2020/03/12 15:36:18][512][WLAN_AC][acf9-703e-90a0]:[WDEV] AP:1 CONFIG phase-2 Func-0xac0d570c TimeOut-300000 IsDAp-0 Ret-0x0 IsNeedCfg-1 [BTRACE][2020/03/12 15:36:18][512][WLAN_AC][acf9-703e-90a0]:[WDEV] AP:1 CONFIG pass phase3 Ret 0x0 [BTRACE][2020/03/12 15:36:18][512][WLAN_AC][acf9-703e-90a0]:[WDEV] AP:1 CONFIG phase-4 Func-0xabc66570 TimeOut-300000 IsDAp-0 Ret-0x0 IsNeedCfg-1 [BTRACE][2020/03/12 15:36:18][512][WLAN_AC][acf9-703e-90a0]:[WCFG] AP[1] receive commit start response, begin to config ap tree. [BTRACE][2020/03/12 15:36:18][512][WLAN_AC][acf9-703e-90a0]:[WCFG] AP[1] SET AP object 0x0001ffff ac Ret 0x0 CfgFlag 1 [BTRACE][2020/03/12 15:36:18][512][WLAN_AC][acf9-703e-90a0]:[WCFG] AP[1] SET Radio object 0x000100ff ac Ret 0x0 CfgFlag 1 [BTRACE][2020/03/12 15:36:18][512][WLAN_AC][acf9-703e-90a0]:[WCFG] AP[1] SET Radio object 0x000101ff ac Ret 0x0 CfgFlag 1 [BTRACE][2020/03/12 15:36:18][512][WLAN_AC][acf9-703e-90a0]:[WCFG] AP[1] SET AP object 0x0001ffff ap ret ok ProcRet 0 [BTRACE][2020/03/12 15:36:19][512][WLAN_AC][acf9-703e-90a0]:[WCFG] AP[1] SET Radio object 0x000100ff ap ret ok ProcRet 0 [BTRACE][2020/03/12 15:36:19][512][WLAN_AC][acf9-703e-90a0]:[WCFG] AP[1] SET Radio object 0x000101ff ap ret ok ProcRet 0 [BTRACE][2020/03/12 15:36:19][512][WLAN_AC][acf9-703e-90a0]:[WCFG] AP[1] WMP cfg success over [BTRACE][2020/03/12 15:36:19][512][WLAN_AC][acf9-703e-90a0]:[WCFG] AP[1] pdt-cfg-phase-0 Func-0xabc5c168 Ret 0x0 TimeOut 60000 [BTRACE][2020/03/12 15:36:19][512][WLAN_AC][acf9-703e-90a0]:[WCFG] AP:1 cmt result 0 [Cur 0 - Notify 0] [BTRACE][2020/03/12 15:36:19][512][WLAN_AC][acf9-703e-90a0]:[WCFG] AP[1] pdt phase-0 notify cmt success [BTRACE][2020/03/12 15:36:19][512][WLAN_AC][acf9-703e-90a0]:[WCFG] AP[1] pdt-cfg-phase-1 Func-0xabc5c1b0 Ret 0x0 TimeOut 30000 [BTRACE][2020/03/12 15:36:19][512][WLAN_AC][acf9-703e-90a0]:[WCFG] AP:1 cmt result 0 [Cur 0 - Notify 0] [BTRACE][2020/03/12 15:36:19][512][WLAN_AC][acf9-703e-90a0]:[WCFG] AP[1] pdt phase-1 notify cmt success [BTRACE][2020/03/12 15:36:19][512][WLAN_AC][acf9-703e-90a0]:[WCFG] AP[1] pdt commit over [BTRACE][2020/03/12 15:36:19][512][WLAN_AC][acf9-703e-90a0]:[Process:2]RTRecePktProc Link[3]Type[0]Msg[514828]Que[1]SN[50]Len[4]Ret[0]Mac[acf9-703e-90a0] [BTRACE][2020/03/12 15:36:19][512][WLAN_AC][acf9-703e-90a0]:[WCFG] AP[1] receive commit-end response