Collect Logs and Debugs from Catalyst 9800 WLC (Logbestanden en debug-informatie van Catalyst 9800 WLC verzamelen)

Inleiding

In dit document worden de stappen beschreven om belangrijke debug-informatie te verzamelen van Catalyst 9800 Wireless LAN-controllers (WLC) of show-opdrachten uit te voeren. 

Voorwaarde

eis

Cisco raadt je aan om kennis te hebben van dit onderwerp:

• Basiskennis van Catalyst 9800 Wireless LAN-controllers (WLC)

Gebruikte componenten

De informatie in dit document is gebaseerd op de volgende software- en hardware-versies:

• Katalysator 9800 WLC 

De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u zorgen dat u de potentiële impact van elke opdracht begrijpt.

Achtergrondinformatie

In dit document worden de stappen beschreven om belangrijke debug-informatie te verzamelen van Catalyst 9800 Wireless LAN-controllers (WLC) of show-opdrachten uit te voeren. 

Logs die moeten worden verzameld voor elk WLC-probleem

• Document exacte en gedetailleerde probleembeschrijving:

Geef informatie over het WLC-platform, de codeversie, het aantal AP's/clients dat is getroffen, SSID's waar het probleem wordt gezien en waargenomen problemen.

Voorbeeld: 9800-40 in HA met softwareversie 16.12.3 gastclients die geen verbinding kunnen maken met SSID ACME_CORP_GUEST, 500 AP's en 200 clients die zijn beïnvloed.

• AP-gegevens/clientgegevens: Merk, MAC-adres, Model, OS-versie, WLAN-adapterversie.

Geef een concreet voorbeeld van client/AP wanneer deze niet werkt met het MAC-adres van het toegangspunt/de client, het model, de softwareversie en de versie van het stuurprogramma voor de WLAN-adapter. Zorg ervoor dat dit toegangspunt/client wordt gebruikt voor het verzamelen van uitgangen en foutopsporingen.

Voorbeeld: Probleem treedt op in AP02_ACME 9120AXI waarbij de client geen verbinding maakt met Intel AX200 client MAC@ aaaa.bbbb.cccc met stuurprogrammaversie 10.21.0.5

• Tijdstempels van de kwestie. Frequentie van de uitgifte:

Wanneer is het probleem begonnen? Hoe vaak komt het probleem voor? Wordt het probleem consequent in acht genomen?

Geef concrete tijdstempels van het probleem dat wordt gezien wanneer u gegevens verzamelt.

Voorbeeld: het probleem wordt consistent gezien telkens wanneer de client probeert verbinding te maken. Het probleem begon zich voor te doen op 16 april 2020 na de upgrade naar 16.12.3.  

• Werken versus niet-werken / wijzigingen / Trigger:

Werkte dit voordien goed? Als het goed werkte, welke veranderingen hebben zich voorgedaan die het probleem kunnen veroorzaken? Is het reproduceerbaar? Wat zijn de stappen om het te reproduceren? Geef informatie over wat werkt en wat niet werkt.

Voorbeeld: Het werkte prima in 16.12.2s, het probleem begon zich voor te doen in 16.12.3. Het probleem is consistent reproduceerbaar wanneer u een client verbindt met ACME_CORP_GUEST. Andere SSID's werken prima, dezelfde client kan verbinding maken met andere SSID's in hetzelfde toegangspunt. 

•  Verzamel van Catalyst 9800 CLI de output van:

WLC-9800-CLI# show tech wireless

U kunt ook dezelfde uitvoer verzamelen via de GUI. Navigeer naar Problemen oplossen> Menu Foutopsporingsbundel:

Geavanceerde informatie over AP/Client-debugs van 9800 WLC

Enkele van de foutopsporingsfuncties die beschikbaar zijn in Catalyst 9800 WLC worden samengevat in dit document Begrijp draadloze foutopsporingsfouten en Logboekverzameling op Catalyst 9800 draadloze LAN-controllers. Deze gids geeft een gedetailleerde uitleg van het doel en het gebruik van deze debugs.

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

Embedded Packet Capture

Packet Capture Gefilterd op 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

Packet Capture Gefilterd op client-MAC (beschikbaar na 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

Verifiëren

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

Scenario Specific Log Collection

Problemen met WLC-platform

Dit scenario dekt WLC-instabiliteit als gevolg van WLC-herladingen, switchovers, crashes, hoge CPU, geheugenproblemen. 

Outputs om essentiële prestatie-indicatoren (KPI’s) te controleren om vast te stellen of er problemen kunnen zijn met het WLC-platform.

Controleer of de uptime lager is dan verwacht, of er een hoog CPU-gebruik of WLC-crashes zijn.

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

Extra logs verzamelen voor problemen met het WLC-platform:

Systeemrapporten/AP-crashes verzamelen/coredumps verzamelen. Dit kan via de GUI. Navigeer naar Problemen oplossen > CoreDump en systeemrapport.

Of via 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: ..}

Verzamel ook deze uitgangen:

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

Voor eventuele AP-crashes kunt u de AP-crashbestanden verzamelen via WLC GUI > Configuratie > Draadloos > Toegangspunten. Klik op het betreffende toegangspunt > tabblad Geavanceerd.

Problemen met AP-aansluiting/connectiviteit

Dit scenario heeft betrekking op AP-instabiliteit omdat AP's zich niet hebben kunnen aansluiten bij WLC, AP-ontkoppelingen, CAPWAP-tunnelkleppen, AP-crashes.

Outputs om essentiële prestatie-indicatoren te controleren om vast te stellen of er AP-problemen kunnen zijn:

Controleer of het toegangspunt is vastgelopen en controleer of het toegangspunt een lagere uptime heeft dan verwacht en of het toegangspunt een lagere uptime heeft dan verwacht.

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

Extra logs om te verzamelen voor AP-problemen:

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>

Problemen met clientconnectiviteit

In dit scenario worden problemen met de connectiviteit van clients, associatieproblemen, authenticatieproblemen, verbroken verbindingen en zwerfproblemen behandeld.

Uitgangen om KPI's te controleren om te bepalen of er problemen met de clientconnectiviteit kunnen zijn:

Controleer om redenen voor clientverwijdering, identificeer de belangrijkste reden voor verwijderen en kijk of de tellers toenemen.

show wireless stats client delete reasons | ex 0

Extra logs verzamelen voor problemen met de connectiviteit van de client.

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>

Problemen met centrale webverificatie (CWA) of lokale webverificatie (LWA)

Dit scenario behandelt problemen met webverificatie van gastclients; client ontvangt geen redirect-URL of kan niet worden geverifieerd.

Uitgangen om KPI's te controleren om te bepalen of er problemen met webverificatie kunnen optreden:

Controleer of clients vastzitten in de webauth-status, controleer het aantal onderschepte verzoeken, ontvangen berichten en beantwoorde antwoorden op de foutstatus.

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

Extra logs om te verzamelen voor problemen met webverificatie:

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>

Problemen met RF (Radio Frequency) of RRM (Radio Resource Management)

Outputs om KPI's te controleren om te bepalen of er RF- of RRM-problemen kunnen zijn:

Controleer op toegangspunten met hetzelfde kanaal, maximaal zendvermogen, hoog aantal kanalen of hoog kanaalgebruik. Voor meer gedetailleerde RF-analyse gebruikt u de config-analyzer. 

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

Extra logs om te verzamelen voor RF- en RRM-problemen:

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

Licentieproblemen

Outputs om KPI's te controleren om te bepalen of er licentieproblemen kunnen zijn:

Bevestig dat WLC wordt weergegeven als geregistreerd en dat het aantal gelicentieerde toegangspunten overeenkomt met het aantal toegangspunten.

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

Extra logs om te verzamelen voor licentieproblemen:

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

Problemen met hoge beschikbaarheid

Outputs om KPI's te controleren om te bepalen of er een probleem met hoge beschikbaarheid kan zijn:

Controleer de uptime voor redundantie-peers en als er een redundantie-gebeurtenis is.

show redundancy | i ptime
sh log | i REDUNDANCY

Extra logs om te verzamelen voor problemen met hoge beschikbaarheid

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

Problemen met webgebruikersinterface of GUI

• Exacte schermafbeelding van de fout/probleem- en reproductiestappen.
• Webbrowser - Naam (Firefox, Chrome, enzovoort) Browserversie.
• Frontend HTTP Archive Format (HAR) bestand. De genoemde stappen zijn Een HAR-bestand genereren om problemen op te lossen.
• Frontend-consolelogs. Dit kan worden geëxporteerd met de stappen in Chrome Console-logboeken verzamelen.
• Webserver-back-endlogs. Downloaden via webUI Troubleshooting > Logs > Webserverlogboeken.
  
  

Gerelateerde informatie

• Cisco Technical Support en downloads