Guide de démarrage rapide sur les journaux et les débogages à collecter à partir du WLC Catalyst 9800 pour divers scénarios

Introduction

Ce document décrit les étapes à suivre pour collecter des débogages importants ou des commandes show à partir des contrôleurs de réseau local sans fil (WLC) Catalyst 9800. Pour fournir ces informations dès le départ dans une demande de service (SR) du centre d'assistance technique (TAC), vous pouvez être en mesure de résoudre les problèmes.

Prérequis

Exigence

Cisco vous recommande de prendre connaissance des rubriques suivantes :

• Compréhension de base des contrôleurs LAN sans fil Catalyst 9800 (WLC)

Components Used

Les informations contenues dans ce document sont basées sur les versions de matériel et de logiciel suivantes :

• WLC Catalyst 9800 

Journaux à collecter sur tout problème WLC

• Documenter la description exacte et détaillée du problème :

Fournir des informations sur la plate-forme WLC, la version du code, le nombre d'AP/clients affectés, les SSID où le problème est vu, les problèmes observés.

Ex : 9800-40 en HA exécutant 16.12.3 clients invités ne pouvant pas se connecter au SSID ACME_CORP_GUEST, 500 points d'accès et 200 clients affectés.

• Détails du point d'accès/Détails du client : Marque, Adresse MAC, Modèle, Version du système d'exploitation, Version de l'adaptateur WLAN.

Fournissez un exemple concret de client/AP qui ne fonctionne pas avec l'adresse MAC du point d'accès/client, du modèle, de la version logicielle et de la version du pilote de la carte WLAN. Assurez-vous qu'il s'agit d'AP/Client utilisé pour collecter les sorties et les débogages.

Ex : Un problème est détecté dans le client AP02_ACME 9120AXI n'ayant pas pu connecter le client Intel AX200 MAC@ aaa.bbbb.cccc à l'aide du pilote version 21.0.0.5

• Horodatage de la question. Fréquence du problème :

Quand le problème a-t-il commencé ? À quelle fréquence le problème se produit-il ? La question est-elle systématiquement respectée ?

Fournir des horodatages concrets du problème rencontré lors de la collecte des données.

Ex : Le problème est toujours présent chaque fois que le client tente de se connecter. Le problème a commencé à se produire le 16/0/4/2020 après la mise à niveau vers 16.12.3   

• Travailler/ne pas travailler/modifications/Déclencheur :

Cela fonctionnait-il bien auparavant ? Si le problème fonctionnait correctement, quels changements se sont produits pour déclencher le problème ? Est-il reproductible ? Quelles sont les étapes suivies pour le reproduire ? Fournir des détails sur ce qui fonctionne et ce qui ne fonctionne pas.

Ex : Il fonctionnait bien dans 16.12.2, le problème a commencé à se produire dans 16.12.3. Le problème est systématiquement reproductible lors de la connexion d'un client à ACME_CORP_GUEST. D'autres SSID fonctionnent correctement, le même client peut se connecter à d'autres SSID dans le même AP. 

• Collecter la sortie de :

  WLC-9800-CLI# show tech wireless

   à partir de l'interface de ligne de commande Catalyst 9800. Vous pouvez également collecter la même sortie via l'interface utilisateur graphique en accédant au menu Dépannage>Ensemble de débogage :

Informations avancées sur les débogages point d'accès/client à partir du WLC 9800

Certaines des fonctionnalités de débogage disponibles dans le WLC Catalyst 9800 sont résumées ci-dessous. Reportez-vous à cet article pour une explication détaillée de l'objectif et de l'utilisation de ces débogages.

Suivi permanent

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

Suivi 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

Capture de paquets intégrée

Capture de paquets filtrée sur IP AP

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 export flash:|tftp:|http:.../filename.pcap

Capture de paquets filtrée sur l'adresse MAC du client (disponible après 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 export flash:|tftp:|http:.../filename.pcap

Vérification

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

Collection de journaux spécifique au scénario :

Problèmes de plate-forme WLC

Ce scénario couvrira l'instabilité du WLC due aux rechargements de WLC, aux commutateurs, aux pannes, aux problèmes de CPU élevés et de mémoire. 

Sorties permettant de vérifier les indicateurs clés de performance KPI pour identifier s'il pourrait y avoir des problèmes de plate-forme WLC

Vérifier si le temps de disponibilité est inférieur à ce qui était prévu, si l'utilisation du CPU est élevée ou si le WLC tombe en panne

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

Journaux supplémentaires à collecter pour les problèmes de plate-forme WLC :

Collecter les plantages/coredumps system-reports/AP crashes. Pour ce faire, utilisez l'interface utilisateur graphique : Naviguez jusqu'à Dépannage > Rapport CoreDump et System

ou 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: ..}

Collectez également les résultats ci-dessous :

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

Pour toute panne de point d'accès, vous pouvez collecter les fichiers de panne de point d'accès à partir de l'interface graphique du WLC »Configuration »Wireless>Access Points » Cliquez sur le point d'accès approprié » onglet Advanced

Problèmes de connexion/connectivité des points d'accès

Ce scénario couvrira l'instabilité des points d'accès en raison de l'incapacité des points d'accès à rejoindre le WLC, les déconnexions des points d'accès, les basculements de tunnel CAPWAP, les pannes des points d'accès.

Extrants permettant de vérifier les indicateurs clés de performance KPI pour déterminer s'il pourrait y avoir des problèmes de points d'accès :

Vérifier les pannes de points d'accès et, pour les points d'accès dont le temps de disponibilité est inférieur à ce qui était prévu, vérifier si les points d'accès dont le temps de disponibilité de l'association est inférieur à ce qui était prévu

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

Journaux supplémentaires à collecter pour les problèmes de points d'accès :

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

Problèmes de connectivité client

Ce scénario couvre les problèmes de connectivité des clients, les problèmes d'association, les problèmes d'authentification, les déconnexions, les problèmes d'itinérance.

Extrants permettant de vérifier les indicateurs de performance clés KPI pour identifier s'il pourrait y avoir des problèmes de connectivité client :

Rechercher les raisons de suppression du client, identifier le motif de suppression principal et voir si les compteurs augmentent

show wireless stats client delete reasons | ex 0

Journaux supplémentaires à collecter pour les problèmes de connectivité 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 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>

Problèmes liés à l'authentification Web centralisée des invités (CWA) ou à l'authentification Web locale (LWA)

Ce scénario couvre les problèmes d'authentification Web du client invité, le client ne recevant pas d'URL de redirection, ne pouvant pas s'authentifier.

Extrants permettant de vérifier les indicateurs de performance clés KPI pour identifier s'il pourrait y avoir des problèmes d'authentification Web :

Rechercher les clients bloqués à l'état de webauth, vérifier le nombre de demandes interceptées, de messages reçus et de réponses d'état d'erreur 

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

Journaux supplémentaires à collecter pour les problèmes d'authentification 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 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>

Problèmes de radiofréquence (RF) ou de gestion des ressources radio (RRM)

Extrants permettant de vérifier les indicateurs de performance clés KPI pour déterminer s'il peut y avoir des problèmes de RF ou de RRM :

Vérifiez si les points d'accès utilisent le même canal, la puissance de transmission maximale, le nombre élevé de canaux ou l'utilisation élevée des canaux. Pour une analyse RF plus détaillée, utilisez l'analyseur de configuration. 

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

Journaux supplémentaires à collecter pour les problèmes RF et 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

Problèmes de licence

Extrants permettant de vérifier les indicateurs clés de performance KPI pour déterminer s'il pourrait y avoir un problème de licence :

Confirmer que le WLC est affiché en tant que registre et que le nombre de points d'accès sous licence correspond au nombre de points d'accès

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

Journaux supplémentaires à collecter pour les problèmes de licence

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

Problèmes de haute disponibilité

Extrants permettant de vérifier les indicateurs de performance clés (KPI) pour déterminer s'il peut y avoir un problème de haute disponibilité :

Vérifier la disponibilité des homologues de redondance et s'il y a un événement de redondance

show redundancy | i ptime
sh log | i REDUNDANCY

Journaux supplémentaires à collecter pour les problèmes de haute disponibilité

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

Problèmes d'interface utilisateur Web ou d'interface utilisateur graphique

• Capture d'écran exacte des étapes d'erreur/problème et de reproduction.
• Navigateur Web - Nom (Firefox, Chrome, etc.), Version du navigateur
• Fichier HAR (Frontend HTTP Archive Format). Les étapes sont mentionnées ici
• Journaux de la console frontale. Vous pouvez l'exporter en utilisant ces étapes.
• Journaux du serveur Web principal. Télécharger à partir de WebUI “ Troubleshooting > Logs > Web Server Logs ”