Erfassen von Protokollen und Debugs vom Catalyst 9800 WLC

Einleitung

In diesem Dokument werden die Schritte zum Erfassen wichtiger Debugs oder Anzeigen von Befehlen auf Catalyst 9800 Wireless LAN Controllern (WLCs) beschrieben. 

Voraussetzung

Anforderung

Cisco empfiehlt, dass Sie über Kenntnisse in diesem Thema verfügen:

• Grundlegendes Verständnis der Catalyst Wireless LAN Controller (WLC) der Serie 9800

Verwendete Komponenten

Die Informationen in diesem Dokument basierend auf folgenden Software- und Hardware-Versionen:

• Catalyst 9800 WLC 

Die Informationen in diesem Dokument beziehen sich auf Geräte in einer speziell eingerichteten Testumgebung. Alle Geräte, die in diesem Dokument benutzt wurden, begannen mit einer gelöschten (Nichterfüllungs) Konfiguration. Wenn Ihr Netzwerk in Betrieb ist, stellen Sie sicher, dass Sie die möglichen Auswirkungen aller Befehle kennen.

Hintergrundinformationen

In diesem Dokument werden die Schritte zum Erfassen wichtiger Debugs oder Anzeigen von Befehlen auf Catalyst 9800 Wireless LAN Controllern (WLCs) beschrieben. 

Bei jedem WLC-Problem zu erfassende Protokolle

• Dokumentieren Sie die genaue und detaillierte Problembeschreibung:

Geben Sie Informationen zur WLC-Plattform, zur Codeversion, zur Anzahl der betroffenen Access Points/Clients, zu den SSIDs, bei denen das Problem aufgetreten ist, und zu den beobachteten Problemen.

Beispiel: 9800-40 in HA mit der Software-Version 16.12.3 können Gäste-Clients keine Verbindung zu SSID ACME_CORP_GUEST, 500 APs und 200 Clients herstellen.

• AP-Details/Client-Details: Marke, MAC-Adresse, Modell, Betriebssystemversion, WLAN-Adapterversion.

Stellen Sie ein konkretes Beispiel für Client/AP bereit, wenn diese nicht mit der MAC-Adresse des AP/Client, dem Modell, der Softwareversion und der Treiberversion für den WLAN-Adapter kompatibel sind. Stellen Sie sicher, dass AP/Client zum Sammeln von Ausgaben und Debugging verwendet wird.

Beispiel: Das Problem tritt bei AP AP02_ACME 9120AXI auf, wenn der Client die Intel AX200-Client-MAC@ aaa.bbb.cccc mit der Treiberversion 10.21.0.5 nicht anschließen kann.

• Zeitstempel der Ausgabe. Häufigkeit der Ausgabe:

Wann begann das Problem? Wie oft tritt das Problem auf? Wird das Problem konsequent beachtet?

Geben Sie konkrete Zeitstempel für das Problem an, das bei der Datenerfassung auftritt.

Beispiel: Das Problem tritt immer dann auf, wenn der Client versucht, eine Verbindung herzustellen. Das Problem trat am 16.04.2020 nach dem Upgrade auf 16.12.3 auf.  

• Working vs. Non-Working/Changes/Trigger:

Hat das früher gut funktioniert? Welche Änderungen konnten das Problem auslösen, wenn es reibungslos funktionierte? Ist es reproduzierbar? Welche Schritte werden unternommen, um sie zu reproduzieren? Geben Sie Details zu funktionierenden und nicht funktionierenden Komponenten an.

Beispiel: Es funktionierte in 16.12.2s gut, das Problem trat in 16.12.3 auf. Das Problem ist immer reproduzierbar, wenn Sie einen beliebigen Client mit ACME_CORP_GUEST verbinden. Andere SSIDs funktionieren einwandfrei. Der gleiche Client kann sich mit anderen SSIDs im gleichen AP verbinden. 

•  Sammeln Sie von Catalyst 9800 CLI die Ausgabe von:

WLC-9800-CLI# show tech wireless

Alternativ können Sie dieselbe Ausgabe über die GUI erfassen. Navigieren Sie zu Troubleshooting>Debug Bundle (Fehlerbehebung):

Erweiterte Informationen zu AP/Client-Debugs vom 9800 WLC

Einige der in Catalyst 9800 WLC verfügbaren Debugfunktionen werden in diesem Dokument "Verstehen von Wireless-Debugs und der Protokollsammlung auf Catalyst 9800 Wireless LAN-Controllern" zusammengefasst. Dieses Handbuch enthält eine detaillierte Erläuterung des Zwecks und der Verwendung dieser Debugfunktionen.

Stets verfügbare Nachverfolgung

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

RadioActive Tracing

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

Integrierte Paketerfassung

Paketerfassung gefiltert auf 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

Paketerfassung gefiltert auf Client-MAC (verfügbar nach 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

Überprüfung

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

Szenariospezifische Protokollerfassung

Probleme mit der WLC-Plattform

In diesem Szenario wird die Instabilität des WLC aufgrund von WLC-Neuladevorgängen, Switchovers, Abstürzen, CPU-Auslastung und Speicherproblemen behandelt. 

Ausgaben zur Überprüfung wichtiger Leistungsindikatoren, um festzustellen, ob Probleme mit der WLC-Plattform auftreten können.

Überprüfen Sie, ob die Verfügbarkeit geringer als erwartet ist, ob die CPU-Auslastung hoch ist oder ob der WLC abstürzt.

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

Zusätzliche Protokolle, die bei Problemen mit der WLC-Plattform erfasst werden:

Zusammenstellen von Abstürzen/Coredumps, Systemberichten/AP-Abstürzen. Dies kann über die GUI erfolgen. Navigieren Sie zu Troubleshooting > CoreDump and System Report.

oder über 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: ..}

Sammeln Sie außerdem die folgenden Ausgänge:

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

Bei AP-Abstürzen können Sie die AP-Absturzdateien über die WLC-GUI > Konfiguration > Wireless > Access Points erfassen. Klicken Sie auf die Registerkarte AP > Advanced (Erweitert).

AP-Beitritt/Verbindungsprobleme

In diesem Szenario wird die Instabilität der Access Points dadurch behandelt, dass die Access Points nicht in der Lage waren, dem WLC beizutreten, Access Points getrennt werden, CAPWAP-Tunnelverbindungen und Access Points abstürzen.

Ausgaben zur Überprüfung wichtiger Leistungsindikatoren, um festzustellen, ob AP-Probleme auftreten können:

Prüfen Sie, ob der Access Point abstürzt, und ob die Betriebszeit der Access Points kürzer als erwartet ist. Prüfen Sie, ob die Betriebszeit der Access Points kürzer als erwartet ist.

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

Zusätzliche Protokolle, die bei AP-Problemen gesammelt werden müssen:

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>

Verbindungsprobleme des Clients

In diesem Szenario werden Probleme mit der Client-Verbindung, Zuordnungsprobleme, Authentifizierungsprobleme, Verbindungstrennungen und Roaming-Probleme behandelt.

Ausgaben zur Überprüfung von KPIs, um mögliche Probleme mit der Client-Verbindung zu identifizieren:

Suchen Sie nach den Gründen für das Löschen durch den Client, geben Sie den wichtigsten Grund für das Löschen an, und überprüfen Sie, ob die Zähler erhöht werden.

show wireless stats client delete reasons | ex 0

Zusätzliche Protokolle, die bei Client-Verbindungsproblemen gesammelt werden müssen.

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>

Probleme mit der Guest Central Web Authentication (CWA) oder der Local Web Authentication (LWA)

In diesem Szenario werden Web-Authentifizierungsprobleme bei Gastclients behandelt. Client empfängt keine Umleitungs-URL oder kann sich nicht authentifizieren.

Ausgaben zur Überprüfung von KPIs, um festzustellen, ob Probleme mit der Webauthentifizierung auftreten können:

Suchen Sie nach Clients, die im Webauth-Status feststecken, überprüfen Sie die Anzahl der abgefangenen Anfragen, haben Nachrichten empfangen und Antworten auf den Fehlerstatus beantwortet.

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

Zusätzliche Protokolle, die bei Problemen mit der Webauthentifizierung gesammelt werden müssen:

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>

Probleme mit Funkfrequenzen oder Funkressourcen-Management

Ausgaben zur Überprüfung der Kennzahlen, um festzustellen, ob RF- oder RRM-Probleme vorliegen:

Prüfen Sie, ob die APs denselben Kanal, dieselbe maximale Übertragungsleistung, eine hohe Kanalanzahl oder eine hohe Kanalauslastung aufweisen. Für eine detailliertere RF-Analyse verwenden Sie den Konfigurationsanalysator. 

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

Zusätzliche Protokolle für RF- und RRM-Probleme:

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

Lizenzprobleme

Ausgaben zur Überprüfung von KPIs, um zu ermitteln, ob ein Lizenzproblem vorliegt:

Vergewissern Sie sich, dass WLC als registriert angezeigt wird und die Anzahl der lizenzierten APs mit der Anzahl der APs übereinstimmt.

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

Zusätzliche Protokolle, die bei Lizenzproblemen erfasst werden:

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

Probleme mit hoher Verfügbarkeit

Ausgaben zur Überprüfung der Kennzahlen, um festzustellen, ob ein Problem mit der Hochverfügbarkeit vorliegt:

Überprüfen Sie die Betriebszeit auf Redundanz-Peers und auf mögliche Redundanzereignisse.

show redundancy | i ptime
sh log | i REDUNDANCY

Zusätzliche Protokolle für Probleme mit der hohen Verfügbarkeit

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

Probleme mit der Web-Benutzeroberfläche

• Genaue Screenshot der Fehler-/Problem- und Wiedergabeschritte.
• Webbrowser - Name (Firefox, Chrome usw.) Browserversion.
• HAR-Datei (Frontend HTTP Archive Format). Die Schritte werden erwähnt: Generate a HAR File to Troubleshoot.
• Frontend-Konsolenprotokolle Dies kann mithilfe der Schritte unter Chrome-Konsolenprotokolle sammeln exportiert werden.
• Backend-Webserver-Protokolle. Herunterladen von WebUI Troubleshooting > Logs > Web Server Logs.
  
  

Zugehörige Informationen

• Technischer Support und Downloads von Cisco