收集 Catalyst 9800 WLC 的記錄與偵錯資料

下載選項

PDF (594.0 KB)
在多種裝置上使用 Adobe Reader 檢視
ePub (229.7 KB)
在 iPhone、iPad、Android、Sony Reader 或 Windows Phone 上的各種應用程式中檢視
Mobi (Kindle) (221.0 KB)
在 Kindle 裝置或多部裝置的 Kindle 應用程式上檢視

已更新: 2024 年 4 月 12 日

文件 ID:215523

無偏見用語

本產品的文件集力求使用無偏見用語。針對本文件集的目的，無偏見係定義為未根據年齡、身心障礙、性別、種族身分、民族身分、性別傾向、社會經濟地位及交織性表示歧視的用語。由於本產品軟體使用者介面中硬式編碼的語言、根據 RFP 文件使用的語言，或引用第三方產品的語言，因此本文件中可能會出現例外狀況。深入瞭解思科如何使用包容性用語。

關於此翻譯

思科已使用電腦和人工技術翻譯本文件，讓全世界的使用者能夠以自己的語言理解支援內容。請注意，即使是最佳機器翻譯，也不如專業譯者翻譯的內容準確。Cisco Systems, Inc. 對這些翻譯的準確度概不負責，並建議一律查看原始英文文件（提供連結）。

簡介

本文說明收集 Catalyst 9800 無線 LAN 控制器 (WLC) 重要偵錯資料或顯示命令的步驟。

必備條件

需求

思科建議您瞭解以下主題：

Catalyst 9800無線LAN控制器(WLC)的基本瞭解

採用元件

本文中的資訊係根據以下軟體和硬體版本：

Catalyst 9800 WLC

本文中的資訊是根據特定實驗室環境內的裝置所建立。文中使用到的所有裝置皆從已清除（預設）的組態來啟動。如果您的網路運作中，請確保您瞭解任何指令可能造成的影響。

背景資訊

本文說明收集 Catalyst 9800 無線 LAN 控制器 (WLC) 重要偵錯資料或顯示命令的步驟。

在任何WLC問題上要收集的日誌

記錄精確和詳細的問題描述：

提供有關WLC平台、代碼版本、受影響的AP/客戶端數量、發現問題的SSID以及觀察到的問題的資訊。

例如：HA中的9800-40與軟體版本16.12.3的訪客客戶端無法連線到SSID ACME_CORP_GUEST，受影響的500個AP和200個客戶端。

AP詳細資訊/客戶端詳細資訊：品牌、MAC地址、型號、作業系統版本、WLAN介面卡版本。

提供一個客戶端/AP的具體示例，當它無法與AP/客戶端的MAC地址、型號、軟體版本和WLAN介面卡驅動程式版本一起使用時。確保這是用於收集輸出和調試的AP/客戶端。

示例：在AP AP02_ACME 9120AXI中發現問題，其中客戶端無法連線使用驅動程式10.21.0.5版的Intel AX200客戶端MAC@ aaaa.bbbb.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收集相同的輸出。導航到故障排除>調試捆綁包選單：

偵錯套件組合

9800 WLC中的AP/客戶端調試高級資訊

本文檔瞭解Catalyst 9800無線LAN控制器上的無線調試和日誌收集中彙總了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完成：導航到故障排除> CoreDump和系統報告。

核心傾印

或透過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加入/連線問題

此案例包括由於AP無法加入WLC而導致的AP不穩定、AP斷開、CAPWAP隧道抖動、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。有關更詳細的RF分析，請使用配置分析器。

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下載。

修訂	發佈日期	意見
6.0	12-Apr-2024	重新認證
5.0	24-Mar-2023	更正CCW警報，更正格式。重新認證。
4.0	23-Feb-2022	次要格式變更和標題變更
3.0	18-Feb-2022	細微變更
2.0	17-Feb-2022	已修正次要錯誤
1.0	13-May-2020	初始版本

收集 Catalyst 9800 WLC 的記錄與偵錯資料

下載選項

無偏見用語

關於此翻譯

目錄

簡介

必備條件

需求

採用元件

背景資訊

在任何WLC問題上要收集的日誌

9800 WLC中的AP/客戶端調試高級資訊

永遠線上跟蹤

RadioActive追蹤

內嵌式封包擷取

在AP IP上過濾的資料包捕獲

在客戶端MAC上過濾的資料包捕獲(在Cisco IOS^® XE 17.1.1s之後提供)

驗證

案例特定日誌收集：

WLC平台問題

AP加入/連線問題

客戶端連線問題

訪客中央Web驗證(CWA)或本地Web驗證(LWA)問題

射頻(RF)或無線電資源管理(RRM)問題

授權問題

高可用性問題

Web使用者介面或GUI問題

相關資訊

修訂記錄

由思科工程師貢獻

這份文件是否有所幫助？

讓思科協助您

本文件適用於這些產品

收集 Catalyst 9800 WLC 的記錄與偵錯資料

下載選項

無偏見用語

關於此翻譯

目錄

簡介

必備條件

需求

採用元件

背景資訊

在任何WLC問題上要收集的日誌

9800 WLC中的AP/客戶端調試高級資訊

永遠線上跟蹤

RadioActive追蹤

內嵌式封包擷取

在AP IP上過濾的資料包捕獲

在客戶端MAC上過濾的資料包捕獲(在Cisco IOS® XE 17.1.1s之後提供)

驗證

案例特定日誌收集：

WLC平台問題

AP加入/連線問題

客戶端連線問題

訪客中央Web驗證(CWA)或本地Web驗證(LWA)問題

射頻(RF)或無線電資源管理(RRM)問題

授權問題

高可用性問題

Web使用者介面或GUI問題

相關資訊

修訂記錄

由思科工程師貢獻

這份文件是否有所幫助？

讓思科協助您

本文件適用於這些產品

在客戶端MAC上過濾的資料包捕獲(在Cisco IOS^® XE 17.1.1s之後提供)