从Catalyst 9800 WLC收集各种场景的日志和调试

简介

本文档介绍从Catalyst 9800无线LAN控制器(WLC)收集重要调试或show命令的步骤。 在技术支持中心(TAC)服务请求(SR)中预先提供此信息，有助于您在问题解决方面立即行动。

先决条件

要求

Cisco 建议您了解以下主题：

• 基本了解Catalyst 9800无线LAN控制器(WLC)

使用的组件

本文档中的信息基于以下软件和硬件版本：

• Catalyst 9800 WLC 

任何WLC问题上要收集的日志

• 记录确切和详细的问题描述：

提供有关WLC平台、代码版本、受影响的AP/客户端数量、发现问题的SSID、观察到的问题的信息。

例如：9800-40（高可用性），软件版本为16.12.3的访客客户端无法连接到SSID ACME_CORP_GUEST、500个AP和200个客户端。

• AP详细信息/客户端详细信息：Make、MAC地址、型号、操作系统版本、WLAN适配器版本。

提供一个客户端/AP无法与AP/客户端的MAC地址、型号、软件版本和WLAN适配器驱动程序版本配合使用的具体示例。确保这是用于收集输出和调试的AP/客户端。

例如：在AP AP02_ACME 9120AXI中出现问题，其中客户端无法使用驱动程序版本21.0.0.5连接英特尔AX200客户端MAC@ aaaa.bbbb.cccc

• 问题的时间戳。问题频率：

问题是何时开始的？问题多久发生一次？问题是否得到一致的观察？

提供收集数据时发现的问题的具体时间戳。

例如：每次客户端尝试连接时，问题都会始终出现。从16.12.3升级到16/0/4/2020后，问题开始出现   

• 工作与非工作/更改/触发器：

这之前能行吗？如果运行正常，会发生哪些可能触发问题的更改？它是否可复制？要复制它，需要执行哪些步骤？提供有关运行和不运行的详细信息。

例如：在16.12.2s中运行正常，问题在16.12.3中开始出现。当您将任何客户端连接到ACME_CORP_GUEST时，此问题始终可重复。其他SSID工作正常，同一客户端能够连接到同一AP中的其他SSID。 

• 收集以下项的输出：

  WLC-9800-CLI# show tech wireless

   从Catalyst 9800 CLI中。或者，您也可以通过GUI通过导航至Troubleshooting>Debug Bundle菜单来收集相同的输出：

有关9800 WLC中AP/客户端调试的高级信息

此处总结了Catalyst 9800 WLC中提供的一些调试功能。有关这些调试的用途和用途的详细说明，请参阅本文。

始终跟踪

show logging profile wireless filter mac <radio-or-ethernet-AP-mac> to-file always-on-<FILENAME.txt>

RadioActive跟踪

debug wireless mac <MAC> [internal]
!!Reproduce
no debug wireless mac <MAC> [internal]
!! Provide ra_trace file generated in bootflash:
dir bootflash: | i ra_trace

嵌入式数据包捕获

在AP IP上过滤的数据包捕获

ip access-list extended CAP-FILTER
 permit ip host <AP_IP> any
 permit ip any host <AP_IP>

monitor capture MYCAP clear
monitor capture MYCAP interface Po1 both
monitor capture MYCAP buffer size 100
monitor capture MYCAP match any
monitor capture MYCAP access-list CAP-FILTER
monitor capture MYCAP start
!!Reproduce
monitor capture MYCAP stop
monitor capture MYCAP export flash:|tftp:|http:.../filename.pcap

在客户端MAC上过滤的数据包捕获（在Cisco IOS® XE 17.1.1s之后提供）

monitor capture MYCAP clear
monitor capture MYCAP interface Po1 both
monitor capture MYCAP buffer size 100
monitor capture MYCAP match any
monitor capture MYCAP inner mac <Client_MAC>
monitor capture MYCAP start
!!Reproduce
monitor capture MYCAP stop
monitor capture MYCAP export flash:|tftp:|http:.../filename.pcap

验证

show monitor capture MYCAP
show monitor capture MYCAP buffer brief/detail/dump

方案特定日志收集：

WLC平台问题

此场景涵盖由于WLC重新加载、切换、崩溃、高CPU、内存问题而导致的WLC不稳定。 

输出以检查关键绩效指标KPI以确定是否可能存在WLC平台问题

检查正常运行时间是否低于预期、CPU使用率高或WLC崩溃

show ver | i uptime
show redundancy | i Uptime
show proc cpu sorted | i CPU
dir all | i core

为WLC平台问题收集的其他日志:

收集崩溃/核心转储系统报告/AP崩溃。这可以通过GUI完成：导航至故障排除>核心转储和系统报告

或通过CLI:

# more bootflash:system-report* 
# copy bootflash:system-report-YYYYMMDD-HHMMSS-Timezone.tar.gz {tftp: | ftp: | https: ..}

OR

# more harddisk:system-report*
# copy harddisk:system-report-YYYYMMDD-HHMMSS-Timezone.tar.gz {tftp: | ftp: | https: ..}

此外，收集以下输出：

show proc cpu platform sorted 1min
show proc mem platform accounting
show redundancy switchover history
show redundancy history

对于任何AP崩溃，可以从WLC GUI>>Configuration>>Wireless>Access Points>>单击相关AP >> Advanced（高级）选项卡收集AP崩溃文件

AP加入/连接问题

此场景包括由于AP无法加入WLC、AP断开连接、CAPWAP隧道摆动、AP崩溃而导致的AP不稳定。

输出以检查关键性能指标KPI，确定是否可能存在AP问题：

检查AP崩溃，对于正常运行时间低于预期的AP，检查关联正常运行时间低于预期的AP

show ap uptime
show ap crash-file
dir all | i crash

要收集的其他日志以解决AP问题：

Always-On Tracing: 
show logging profile wireless filter mac <radio-or-ethernet-AP-mac> to-file always-on-<FILENAME.txt>
RadioActive Tracing:
debug wireless mac <AP_Radio_MAC> 
debug wireless ip <AP_IP>
Embedded Captures filtered by AP IP address ACL
ip access-list extended CAP-FILTER
 permit ip host <AP_IP> any
 permit ip any host <AP_IP>

monitor capture MYCAP clear
monitor capture MYCAP interface Po1 both
monitor capture MYCAP buffer size 100
monitor capture MYCAP match any
monitor capture MYCAP access-list CAP-FILTER
monitor capture MYCAP start
!!Reproduce
monitor capture MYCAP stop
monitor capture MYCAP export flash:|tftp:|http:.../filename.pcap

show wireless stats ap discovery
show wireless stats ap join summary
show wireless stats ap history
show tech-support wireless ap
show tech-support wireless ap name <ap-name>

客户端连接问题

此场景涵盖客户端连接问题、关联问题、身份验证问题、断开连接和漫游问题。

用于检查关键绩效指标KPI的输出，以确定是否存在客户端连接问题：

检查客户端删除原因，确定主要删除原因并查看计数器是否增加

show wireless stats client delete reasons | ex 0

要收集的其他日志，以解决客户端连接问题。

Always-On Tracing: 
show logging profile wireless filter mac <Client_MAC> to-file always-on-<FILENAME.txt>
RadioActive Tracing:
debug wireless mac <Client_MAC> 
Embedded Captures filtered by client MAC:
monitor capture MYCAP clear
monitor capture MYCAP interface Po1 both
monitor capture MYCAP buffer size 100
monitor capture MYCAP match any
monitor capture MYCAP inner mac <Client_MAC>
monitor capture MYCAP start
!!Reproduce
monitor capture MYCAP stop
monitor capture MYCAP export flash:|tftp:|http:.../filename.pcap

show wireless stats client summary | i MAC|<Client_MAC>
show tech-support wireless client
show tech-support wireless client mac-address <Client_MAC>

访客中心Web身份验证(CWA)或本地Web身份验证(LWA)问题

此场景包括访客客户端Web身份验证问题、客户端未接收重定向URL、无法进行身份验证。

用于检查关键性能指标KPI以确定是否可能存在Web身份验证问题的输出：

检查客户端是否停滞在Webauth状态，检查被拦截的请求数、收到的消息数和回复的错误状态回复数 

show wireless client summary | i Webauth|Number
show wireless stats client detail | i HTTP

要收集的其他日志以解决Web身份验证问题：

Always-On Tracing: 
show logging profile wireless filter mac <rClient_MAC> to-file always-on-<FILENAME.txt>
RadioActive Tracing:
debug wireless mac <Client_MAC> 
Embedded Captures filtered by client MAC:
monitor capture MYCAP clear
monitor capture MYCAP interface Po1 both
monitor capture MYCAP buffer size 100
monitor capture MYCAP match any
monitor capture MYCAP inner mac <Client_MAC>
monitor capture MYCAP start
!!Reproduce
monitor capture MYCAP stop
monitor capture MYCAP export flash:|tftp:|http:.../filename.pcap
show wireless stats client summary | i <Client_MAC>
show wireless stats client delete reasons
show tech wireless client mac-address <Client_MAC>
!!Client WLAN Adapter wireshark captures or Over The Air(OTA) sniffer trace.
show ip http server all
show tcp statistics
show ip traffic
show ip access-list
show tech-support wireless client 
show tech-support wireless client mac-address <Client_MAC>

射频(RF)或射频资源管理(RRM)问题

输出以检查关键性能指标KPI，以确定是否存在RF或RRM问题：

检查使用相同信道、最大传输功率、高信道计数或高信道利用率的AP。有关更详细的射频分析，请使用配置分析器。 

show ap dot11 [24ghz|5ghz] summary
sh ap auto-rf dot11 [24ghz|5ghz] | i Channel Change Count|Channel Utilization

要收集的其他日志以解决RF和RRM问题：

set platform software trace wireless chassis active r0 rrm all info 
!!Debug txpower logs:
set platform software trace wncd chassis active r0 radio-history-txpower info
!!Debug channel changes logs:
set platform software trace wncd chassis active r0 radio-history-channel info
!!Debug radio resets
set platform software trace wncd chassis active r0 radio-history-reset info
!!Debug DFS events
set platform software trace wncd chassis active r0 radio-history-dfs info
!!Collect and decode traces:
show logging profile wireless internal [to-file <file-name>] 
!!Change level back to notice:
set platform software trace wncd chassis active R0 all-modules notice 
set platform software trace wireless chassis active R0 rrm all notice

许可问题

输出以检查关键性能指标KPI以确定是否可能存在许可证问题：

确认WLC显示为已注册，且许可的AP数与AP数匹配

show license summary | i Status:|AP
sh ap sum | i Number of APs

要收集的许可证问题的其他日志

show tech-support license
show logging process ios start last boot to-file bootflash: <file-name>

高可用性问题

用于检查关键绩效指标(KPI)以确定是否可能存在高可用性问题的输出：

检查冗余对等体的正常运行时间，以及是否存在冗余事件

show redundancy | i ptime
sh log | i REDUNDANCY

要收集的其他日志，以解决高可用性问题

show redundancy states
show redundancy counters
show redundancy switchover history
sh logging onboard uptime !!just for physical WLCs: 9800-40/9800-80/9800-L
show chassis ha-status active
show chassis ha-status standby
sh platform software stack-mgr chassis active R0 sdp-counters
sh platform software stack-mgr chassis standby R0 sdp-counters
sh platform software stack-mgr chassis active R0 peer-timeout
sh platform software stack-mgr chassis standby R0 peer-timeout

Web用户界面或GUI问题

• 错误/问题和再现步骤的确切屏幕截图。
• Web浏览器 — 名称（Firefox、Chrome等）、浏览器版本
• 前端HTTP存档格式(HAR)文件。此处提到了步骤
• 前端控制台日志。这可以通过以下步骤导出。
• 后端Web服务器日志。从WebUI“故障排除>日志> Web服务器日志”下载