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 u 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:

• Catalyst 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 over elk WLC-probleem

• Exacte en gedetailleerde beschrijving van het probleem:

Geef informatie over het WLC-platform, de versie van de code, het aantal AP's/clients waarop het probleem betrekking heeft, SSID's waar het probleem wordt gezien en problemen die zijn waargenomen.

Voorbeeld: 9800-40 in HA met softwareversie 16.12.3 gastclients die geen verbinding kunnen maken met SSID ACME_CORP_GUEST, 500 toegangspunten en 200 clients die zijn getroffen.

• AP-gegevens/clientgegevens: merk, MAC-adres, model, versie besturingssysteem, versie WLAN-adapter.

Geef een concreet voorbeeld van client/AP wanneer dit niet werkt met het MAC-adres van het AP/Client-model, de softwareversie en de stuurprogrammaversie van de WLAN-adapter. Zorg ervoor dat dit toegangspunt/client wordt gebruikt om uitgangen en foutmeldingen te verzamelen.

Voorbeeld: Probleem is te zien 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 het probleem:

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 op 16 april 2020 na de upgrade naar 16.12.3.  

• Werken vs. niet werken/wijzigingen / Trigger:

Werkte dit eerder goed? Als het goed werkte, welke veranderingen vonden plaats die het probleem konden veroorzaken? Is het reproduceerbaar? Wat zijn de stappen om het te reproduceren? Geef details over wat werkt en wat niet werkt.

Voorbeeld: het werkte prima in 16.12.2s, het probleem begon op te treden 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 in hetzelfde toegangspunt. 

•  Van Catalyst 9800 CLI, verzamel output van:

WLC-9800-CLI# show tech wireless

Als alternatief kunt u dezelfde uitvoer via GUI verzamelen. Navigeer naar Problemen oplossen>Menu Bundel foutopsporing:

Geavanceerde informatie over AP/Client-fouten van 9800 WLC

Enkele van de foutopsporingsfuncties die beschikbaar zijn in Catalyst 9800 WLC worden samengevat in dit document Begrijpen van draadloze foutopsporingen en Logverzameling op Catalyst 9800 draadloze LAN-controllers. Deze gids geeft een gedetailleerde uitleg over 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

Pakketvastlegging 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

Scenariospecifieke verzameling van logbestanden

Problemen met WLC-platform

Dit scenario heeft betrekking op WLC-instabiliteit als gevolg van WLC-herladen, switchovers, crashes, hoge CPU, geheugenproblemen. 

Outputs om de belangrijkste prestatie-indicatoren (KPI’s) te controleren om te bepalen of er problemen met het WLC-platform kunnen zijn.

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 om te verzamelen voor WLC-platformproblemen:

Verzamel crashes/coredumps-systeemrapporten/AP-crashes. Dit kan via GUI. Ga 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 outputs:

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 van WLC GUI > Configuratie > Draadloos > Toegangspunten. Klik op relevant toegangspunt > Geavanceerd tabblad.

Problemen met AP-aansluiting/connectiviteit

Dit scenario heeft betrekking op de instabiliteit van het toegangspunt omdat toegangspunten niet hebben kunnen deelnemen aan WLC, ontkoppelde toegangspunten, CAPWAP-tunnelkleppen, crashes van het toegangspunt.

Outputs om de belangrijkste prestatie-indicatoren te controleren om na te gaan of er AP-problemen kunnen zijn:

Controleer op crashes van het toegangspunt en op toegangspunten met een lagere uptime dan verwacht, controleer op toegangspunten met een lagere uptime 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

Dit scenario heeft betrekking op problemen met de connectiviteit van clients, associatieproblemen, verificatieproblemen, verbroken verbindingen en roamingproblemen.

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

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

show wireless stats client delete reasons | ex 0

Extra logs om te 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 voor gasten (CWA) of lokale webverificatie (LWA)

In dit scenario worden webverificatieproblemen van gastclients behandeld; de client ontvangt geen doorverwijzing-URL of kan niet verifiëren.

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

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

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

Extra logs om te verzamelen voor webverificatieproblemen:

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 radiofrequentie (RF) of radioresourcebeheer (RRM)

Uitgangen 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. Gebruik voor meer gedetailleerde RF-analyse de config-analysator. 

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

Aanvullende logbestanden 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

Uitgangen om KPI's te controleren om te bepalen of er een licentieafgifte kan zijn:

Bevestig dat WLC wordt weergegeven als geregistreerd en dat het aantal toegangspunten dat is gelicentieerd, overeenkomt met het aantal toegangspunten.

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

Aanvullende logbestanden 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

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

Controleer de uptime voor redundantiepeers en als er een redundantiegebeurtenis is:

show redundancy | i ptime
sh log | i REDUNDANCY

Extra logboeken 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 schermopname van de fout/probleem- en reproductiestappen.
• Webbrowser - Naam (Firefox, Chrome, enzovoort), Browserversie.
• Frontend HTTP Archive Format (HAR)-bestand. De stappen worden vermeld Een HAR-bestand genereren om problemen op te lossen.
• Logboeken van de frontend-console. Dit kan worden geëxporteerd met de stappen in Verzamel Chrome Console Logs.
• Backend-webserverlogs. Download van webUI Problemen oplossen > Logs > Webserver Logs.
  
  

Gerelateerde informatie

• Cisco Technical Support en downloads

Revisiegeschiedenis

Revisie	Publicatiedatum	Opmerkingen
8.0	17-Aug-2026	Opmaak bijgewerkt.
7.0	23-Apr-2025	Bijgewerkte grammatica en opmaak.
6.0	12-Apr-2024	hercertificering
5.0	24-Mar-2023	Correcte CCW-waarschuwingen, correcte opmaak. Hercertificering.
4.0	23-Feb-2022	Kleine wijzigingen in opmaak en titelwijziging
3.0	18-Feb-2022	kleine wijzigingen
2.0	17-Feb-2022	Opgeloste kleine fouten
1.0	13-May-2020	Eerste vrijgave