簡介
本文說明收集 Catalyst 9800 無線 LAN 控制器 (WLC) 重要偵錯資料或顯示命令的步驟。
必備條件
需求
思科建議您瞭解以下主題:
- 對Catalyst 9800無線LAN控制器(WLC)的基本瞭解
採用元件
本文中的資訊係根據以下軟體和硬體版本:
本文中的資訊是根據特定實驗室環境內的裝置所建立。文中使用到的所有裝置皆從已清除(預設)的組態來啟動。如果您的網路運作中,請確保您瞭解任何指令可能造成的影響。
背景資訊
本文說明收集 Catalyst 9800 無線 LAN 控制器 (WLC) 重要偵錯資料或顯示命令的步驟。
在任何WLC問題上要收集的日誌
提供有關WLC平台、代碼版本、受影響的AP/客戶端數量、發現問題的SSID以及觀察到的問題的資訊。
範例:HA中的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中發現問題,其中客戶端無法連線驅動程式版本為10.21.0.5的英特爾AX200客戶端MAC@ aaaaa.bbb.cccc
問題是什麼時候開始的?該問題出現的頻率如何?問題是否一直得到遵守?
提供收集資料時發現問題的具體時間戳。
範例:每次客戶端嘗試連線時都會出現此問題。升級到16.12.3後,問題開始於2020年4月16日。
以前工作正常嗎?如果運行正常,則發生了哪些更改可能觸發此問題?是否可複製?要複製它需要執行哪些步驟?提供有關正在運行和不正在運行的裝置的詳細資訊。
範例:它在16.12.2s運行正常,問題開始於16.12.3。當您將任何客戶端連線到ACME_CORP_GUEST時,該問題始終可重複。其他SSID工作正常,同一客戶端可以連線到同一AP中的其他SSID。
- 在Catalyst 9800 CLI中,收集以下內容的輸出:
WLC-9800-CLI# show tech wireless
或者,您也可以通過GUI收集相同的輸出。導覽至Troubleshooting>Debug Bundle功能表:

有關從9800 WLC進行AP/客戶端調試的高級資訊
Catalyst 9800 WLC中可用的某些偵錯功能在本檔案瞭解Catalyst 9800無線LAN控制器上的無線偵錯和日誌收集中進行了總結。本指南提供這些偵錯的用途和使用的詳細說明。
永遠在追蹤
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完成。導覽至Troubleshooting > CoreDump and System Report。

或通過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崩潰檔案。按一下相關的AP > Advanced選項卡。

AP加入/連線問題
此案例包括AP由於無法加入WLC而導致的AP不穩定、AP斷開、CAPWAP隧道抖動、AP崩潰。
用於檢查關鍵效能指標以確定是否存在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。有關更詳細的RF分析,請使用config analyzer。
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)檔案。產生HAR檔案以排解疑難步驟。
- 前端控制檯日誌。這可通過收集Chrome控制檯日誌中的步驟匯出。
- 後端Web伺服器日誌。從WebUI Troubleshooting > Logs > Web Server Logs下載。

相關資訊