Problemen met Catalyst 9800 draadloze LAN-controllers oplossen

Inleiding

Dit document beschrijft en biedt een overzicht van alle Cisco IOS® XE-functies en -mogelijkheden die worden gebruikt voor het oplossen van problemen met de Catalyst 9800.

Voorwaarden

Vereisten

Cisco raadt kennis van de volgende onderwerpen aan:

• Kennis van Wireless LAN Controllers (WLC).
• Basiskennis van de use case flows die betrokken zijn bij het gebruik van een WLC.

Gebruikte componenten

Dit document is gebaseerd op de volgende software- en hardwareversies:

Dit document heeft betrekking op 9800-CL, 9800-L, 9800-40 en 9800-80 controllers. Het is voornamelijk gebaseerd op 17.3 Cisco IOS® XE versie.

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

Cisco IOS® XE draait op 9800 WLC's en bestaat in wezen uit een Linux-kernel (binOS) met Cisco IOS® en alle draadloze processen die als daemons worden geïmplementeerd.

Alle procesdaemons kunnen worden gebundeld onder de generieke term Control Plane (CP) en zijn verantwoordelijk voor de besturing en provisioning van toegangspunten (CAPWAP), mobiliteit, radioresourcebeheer (RRM). Rogue Management, Network Mobility Service Protocol (NMSP) die bestemd zijn voor en vanaf de 9800 WLC.

Data Plane (DP) verwijst naar de componenten die gegevens doorsturen op 9800 WLC.

Op alle iteraties van 9800 (9800-40, 9800-80, 9800-CL, 9800-SW, 9800-L), Control Plane blijft redelijk gebruikelijk.

Data Plane varieert echter met 9800-40 en 9800-80 die een hardwarematig Quantum Flow Processor (QFP)-complex gebruiken dat vergelijkbaar is met ASR1k, terwijl 9800-CL en 9800-L software-implementatie van Cisco Packet Processor (CPP) gebruiken. 9800-SW maakt gewoon gebruik van de Doppler-chipset op switches uit de Catalyst 9k-reeks voor gegevensoverdracht.

Pakketstroom binnen 9800 WLC

 

Wanneer een pakket vanuit fysieke poorten de 9800 WLC binnenkomt, wordt het, als wordt vastgesteld dat het controleverkeer is, gekoppeld aan de bijbehorende controlevlakprocessen.

Voor een AP-join zouden dit alle capwap- en dtls-uitwisseling zijn die afkomstig is van AP. In het geval van client join, zou dit al het verkeer afkomstig van de client totdat de client gaat naar RUN staat.

Terwijl de verschillende daemons het binnenkomende verkeer verwerken, wordt het resulterende retourverkeer (capwap-respons, dot11, dot1x, dcp-respons) afkomstig van 9800 WLC die naar de client wordt verzonden, terug geïnjecteerd in het gegevensvlak dat naar de fysieke poort wordt verzonden.

Terwijl u AP-verbindingen verwerkt, lid wordt van de client, uitwisselingen van mobiliteit, moet het gegevensvliegtuig worden geprogrammeerd zodat het gegevensverkeer kan doorsturen.

Dit gebeurt wanneer meerdere componenten sequentieel worden geprogrammeerd over het programmeerpad dat in de afbeelding wordt aangegeven.

Cisco IOS® XE biedt een veelzijdige toolset om het pakket te traceren vanaf het moment dat het 9800 WLC binnenkomt tot het verwerkte verkeer de doos verlaat.

De volgende sectie introduceert deze tools samen met de opdrachten die worden gebruikt om deze tools vanuit de command line interface (CLI) op te roepen.

tracering van het controlevlak

In dit gedeelte worden de opdrachten en hulpmiddelen beschreven die beschikbaar zijn om de verwerking te bekijken die wordt uitgevoerd door de processen van het controlevlak nadat het pakket dat bedoeld is voor 9800 WLC uit DP is gepunteerd of voordat het responspakket van 9800 WLC naar de DP wordt geïnjecteerd voor het verzenden van de fysieke interface

Syslog

Logs gegenereerd door de 9800 WLC zijn de eerste manier om de algemene gezondheid van het systeem te verifiëren.

Elke overschrijding van de vooraf gedefinieerde drempelwaarde voor systeembronnen zoals CPU, geheugen, buffers worden in het log gerapporteerd.

Ook worden eventuele fouten die door subsystemen worden gegenereerd, in logboeken geschreven. Als u de logboeken wilt bekijken, gaat u naar Problemen oplossen > Syslog.

Voer de opdracht CLI uit:

# show logging

Deze uitvoer toont algemene logboeken en enkele logboeken met draadloze specificaties. Echter, in tegenstelling tot de oude Cisco IOS®, geen draadloze debugging meestal maakt zijn weg naar deze logging output.

Opmerking: Als WLC9800 is geconfigureerd om deze logs om te leiden naar een externe syslog-server, moet u ook de logs op een externe syslog-server controleren.

Always-on tracering

Elk controlevliegtuigproces op de WLC9800 logt voortdurend op logniveau van Notice naar zijn eigen speciale buffer. Dit wordt ook wel always-on tracing genoemd.

Dit is een unieke mogelijkheid waarmee u contextuele gegevens kunt verkrijgen over een fout die is opgetreden zonder dat de faalvoorwaarde moet worden gereproduceerd.

Als u bijvoorbeeld bekend bent met AireOS, moet u voor het oplossen van problemen met de connectiviteit van een client foutmeldingen inschakelen en de probleemstatus voor de connectiviteit van de client reproduceren om de hoofdoorzaak te identificeren.

Met always-on tracing kunt u terugkijken op reeds vastgelegde sporen en vaststellen of dit een veel voorkomende oorzaak is.  Afhankelijk van het volume van de gegenereerde logs, kunnen we enkele uren terugkijken op enkele dagen.

Nu, terwijl de sporen worden vastgelegd per individueel proces, is het mogelijk om ze holistisch te bekijken voor een bepaalde context van belang, zoals client mac of AP mac of AP ip-adres. Voer hiervoor het commando uit

# show logging profile wireless filter mac  to-file bootflash:

Standaard gaat deze opdracht slechts 10 minuten terug in de tijd om de logs te genereren en te decoderen. Je kunt ervoor kiezen om verder terug in de tijd te gaan met:

# show logging profile wireless start last <number> [minutes|hours|days] filter mac  to-file bootflash:

Voer de opdracht uit om logboeken per proces weer te geven

# show logging process  to-file bootflash:

Opmerking: er zijn meerdere filteropties op deze CLI's, waaronder module, logniveau, starttijdstempel enzovoort. Voer de opdracht uit om deze opties te bekijken en te verkennen

# show logging profile wireless ?
# show logging process  ?

Voorwaardelijke foutopsporing en RadioActive Tracing

Voorwaardelijke foutopsporing maakt het mogelijk om foutopsporingsniveau-logging in te schakelen voor specifieke functies voor de interessevoorwaarden.

RadioActive tracing gaat nog een stap verder door de mogelijkheid toe te voegen om voorwaardelijk foutopsporingsinformatie af te drukken over processen, threads voor de conditie van interesse.

Dit betekent dat de onderliggende architectuur volledig geabstraheerd is.

Opmerking: op 10.12 wordt radioactieve tracering alleen geïmplementeerd voor het oplossen van problemen met AP, samen met AP-radio- en ethernet-mac-adressen, client-join met client-mac-adres en mobiliteitsproblemen met peer-ip-mobiliteit en CMX-connectiviteit met het CMX-ip-adres als voorwaarden van belang.

Opmerking: MAC-adres versus IP-adres als voorwaarde biedt verschillende uitgangen omdat verschillende processen op de hoogte zijn van verschillende identificatiecodes voor dezelfde netwerkentiteit (AP of client of peer mobility).

Met clientconnectiviteit, als voorbeeld om problemen op te lossen, wordt voorwaardelijke foutopsporing uitgevoerd voor client-mac om de weergave van begin tot eind in het controlevlak te krijgen.

Radioactieve sporen via web-UI

Navigeer naar het menu van de pagina Problemen oplossen en kies Radioactief overtrekken.

Klik op Toevoegen en voer een client of AP mac adres in dat u wilt oplossen.  Vanaf 19.12 kunnen alleen Mac-adressen worden toegevoegd via de GUI. U kunt een IP-adres toevoegen via CLI.

U kunt verschillende mac-adressen toevoegen om te volgen. Wanneer u klaar bent om de radioactieve tracering te starten, klikt u op Start.

Eenmaal gestart, worden debug logging geschreven naar de schijf over elke controle vliegtuig verwerking met betrekking tot de bijgehouden mac-adressen.

Wanneer u het probleem dat u wilt oplossen hebt gereproduceerd, klikt u op Stoppen.

Voor elk mac-adres dat is gedebugd, kunt u een logbestand genereren dat alle logs met betrekking tot dat mac-adres verzamelt door op Genereren te klikken.

Kies hoelang u wilt dat het verzamelde logbestand wordt opgeslagen en klik op Toepassen op apparaat.

U kunt het bestand nu downloaden door op het kleine pictogram naast de bestandsnaam te klikken. Dit bestand is aanwezig in de bootflash drive van de controller en kan ook uit de doos gekopieerd worden via CLI.

Radioactieve sporen via CLI

Voer de opdracht uit om voorwaardelijke foutopsporing in te schakelen

# debug wireless {mac | ip} {aaaa.bbbb.cccc | x.x.x.x } {monitor-time} {N seconds}

Voer de opdracht uit om de momenteel ingeschakelde voorwaarden weer te geven

# show debugging

Deze foutmeldingen drukken geen uitvoer af op de terminalsessie, maar slaan het foutopsporingsuitvoerbestand op flash op om daarna te worden opgehaald en geanalyseerd. Het bestand wordt opgeslagen met de naamgevingsconventie ra_trace_*

Voor mac-adres aaaa.bbbb.cccc is de gegenereerde bestandsnaam bijvoorbeeld ra_trace_MAC_aaaabbcccc_HHMMSS.XXX_timezone_DayWeek_Month_Day_year.log.

Een voordeel is dat dezelfde opdracht kan worden gebruikt voor het oplossen van problemen met AP-verbindingen (invoer AP-radio-mac en Ethernet-mac), problemen met de clientverbinding (invoer client-mac), problemen met de mobiliteitstunnel (invoer peer-ip), problemen met de roaming van clients (invoer client-mac).

Met andere woorden, u hoeft niet meerdere opdrachten te onthouden, zoals debug capwap, debug client, debug mobility enzovoort.

Opmerking: met debug wireless kunt u ook naar een FTP-server wijzen en nog meer uitgebreide logboekregistratie uitvoeren met intern trefwoord. Het wordt niet aanbevolen om deze op dit moment te gebruiken, omdat er enkele problemen worden opgelost.

Voer de opdracht uit om het uitvoerbestand op de terminalsessie te debuggen:

# more bootflash:ra_trace_MAC_*.log 

Voer de opdracht uit om de foutopsporingsuitvoer om te leiden naar een externe server voor offline analyse:

# copy bootflash:ra_trace_MAC_*.log ftp://username:password@FTPSERVERIP/path/RATRACE_FILENAME.txt

Er is een veel uitgebreidere weergave van dezelfde debug log levels. Voer de opdracht uit om deze breedbeeldweergave te zien:

# show logging profile wireless internal filter mac  to-file 

Voer de opdracht uit om foutopsporing uit te schakelen voor specifieke context of voordat de geconfigureerde of standaardmonitortijd is verstreken.

# no debug wireless mac <aaaa.bbbb.cccc>

Waarschuwing: De voorwaardelijke foutopsporing maakt logboekregistratie op foutopsporingsniveau mogelijk, waardoor het volume van de gegenereerde logboeken toeneemt. Als u deze functie laat werken, wordt de hoeveelheid tijd die u terug in de tijd kunt gebruiken om logboeken te bekijken, verminderd. Het wordt daarom aanbevolen om altijd debuggen uit te schakelen aan het einde van de sessie voor probleemoplossing.

 Voer de volgende opdrachten uit om alle foutopsporing uit te schakelen:

# clear platform condition all
# undebug all

Onvoorwaardelijke foutopsporing per proces

Voor de use cases en processen, die niet zijn geïmplementeerd voor radioactieve tracering, kunt u sporen op debugniveau krijgen. Gebruik de opdracht om het foutopsporingsniveau in te stellen voor een specifiek proces:

# set platform software trace <PROCESS_NAME> wireless chassis active R0 { module_name | all-modules } 

Voer de opdracht uit om de traceringsniveaus van de verschillende modules te controleren:

# show platform software trace level <PROCESS_NAME> chassis active R0

Voer de opdracht uit om de verzamelde sporen te bekijken:

# show logging process  to-file 

Data Plane Packet Tracing

Wanneer een pakket voor het eerst 9800 WLC binnenkomt, vindt er enige verwerking plaats op het gegevensvlak om te identificeren of het verkeer een controlevliegtuig of een gegevensvliegtuig is.

Packet-Trace biedt een gedetailleerd overzicht van deze Cisco IOS® XE-verwerking op dataplane en de beslissing over het punt, doorsturen, neerzetten of consumeren van het pakket. Deze functie op WLC 9800 werkt precies hetzelfde als de implementatie op ASR!k.

Packet Tracer op 9800 WLC biedt drie inspectieniveaus, dezelfde als ASR1K.

• Statistieken - Biedt het aantal pakketten dat de netwerkprocessor binnenkomt en verlaat.
• Samenvatting-
  • Dit wordt verzameld voor een eindig aantal pakketten die overeenkomen met specifieke interessevoorwaarden.
  • De overzichtsuitvoer geeft de in- en uitgangs-interfaces aan, de beslissing van het gegevensvlak om op te zoeken en ook eventuele punt-, drop- en injecteerpakketten.
  • Deze output geeft een beknopt beeld van de gegevensverwerking.
• Padgegevens - Dit biedt de meest gedetailleerde weergave van de verwerking van DP-pakketten. Verzameld voor een eindig aantal pakketten, bevat het voorwaardelijke debugging-id die kan worden gebruikt om DP-pakketten te correleren om planfouten, tijdstempels en kenmerkspecifieke pad-trace-gegevens te beheren. Deze gedetailleerde weergave heeft twee optionele mogelijkheden.
  • Met Packet Copy kunt u in- en uitstappakketten kopiëren op verschillende lagen van het pakket (laag 2, laag 3 en laag 4).
  • Feature Invocation Array (FIA) is de sequentiële lijst van functies die op het pakket worden uitgevoerd door het gegevensvlak. Deze functies zijn afgeleid van de standaard en door de gebruiker ingeschakelde configuratie op WLC 9800.

Raadpleeg de Cisco IOS XE Datapath Packet Trace-functie voor gedetailleerde uitleg over de functie en subopties

Voor draadloze workflows zoals AP join, clientconnectiviteit, enzovoort, volgt u de uplink bidirectioneel.

Let op: de dataplane packet-tracer parseert alleen de buitenste CAPWAP-header. Dus, omstandigheden zoals draadloze client mac leveren geen nuttige output op.

 Stap 1. Definieer de conditie van interesse.

# debug platform condition { interface | mac | ingress | egress | both | ipv4 | ipv6 | mpls | match }

Waarschuwing: Zowel de commando's - debug platform conditie functie als debug platform conditie mac aaaa.bbb.ccccą zijn bedoeld voor controle vliegtuig pakkettracering en geen dataplane pakketsporen retourneren.

Stap 2. Voer de opdracht uit om de momenteel ingeschakelde voorwaarden te bekijken:

# show platform conditions

Stap 3. Packet-tracer inschakelen voor een eindig aantal pakketten. Dit pakketnummer wordt gedefinieerd als een vermogen van 2 in het bereik van 16 - 8192. Standaard worden zowel de samenvattings- als de functiegegevens vastgelegd. Optioneel kunt u ervoor kiezen om alleen een overzichtsweergave te krijgen als u de suboptie Alleen overzicht gebruikt. U hebt ook subopties beschikbaar om fia-trace te krijgen, pakketgrootte te definiëren in bytes, trace punt, injecteer of drop-pakketten. enzovoort.

# debug platform packet-tracer packet <packet-number> {fia-trace}

Stap 4. (Optioneel) U kunt de pakketten kopiëren en dumpen terwijl ze worden getraceerd.

# debug platform packet-trace copy packet both size 2048 { l2 | l3 | l4 }

Stap 5. Voorwaardelijke foutopsporing inschakelen.

# debug platform condition start

Stap 6. Om te zien of de packet-trace enige output verzamelt, moet u de statistieken controleren.

# show platform packet-trace statistics

Stap 7. Voer de opdracht uit om de uitvoer van de packet-trace te bekijken:

# show platform packet-tracer summary

 Stap 8. (Optioneel) U kunt pakketdump exporteren voor offline analyse door Cisco TAC.

# show platform packet-trace packet all | redirect { bootflash: | tftp: | ftp: } pactrac.txt

Embedded Packet Capture

Embedded Packet Capture (EPC) is een pakketopnamefaciliteit die zicht biedt op pakketten die bestemd zijn voor, afkomstig zijn van en door de Catalyst 9800 WLC's gaan. Deze opnames kunnen worden geëxporteerd voor offline analyse met Wireshark.

Raadpleeg de EPC-configuratiehandleiding voor meer informatie over de functie

In vergelijking met AireOS, in plaats van te vertrouwen op pakketvastlegging en verkeersspiegelmogelijkheden op uplink-switch, maakt 9800 WLC het mogelijk om pcap-vastlegging op de doos zelf uit te voeren.

Op de 9800 kan deze opname zowel vanuit de Command Line Interface (CLI) als op de Graphical User Interface (GUI) worden ingesteld.

Als u wilt configureren via GUI, gaat u naar Problemen oplossen > Packet Capture > +Add.

Stap 1. Definieer de naam van de packet capture. Maximaal 8 karakters zijn toegestaan.

Stap 2. Definieer filters, indien aanwezig

Stap 3. Schakel het selectievakje in om het verkeer te bewaken als u wilt zien dat het verkeer wordt gekoppeld aan de CPU van het systeem en opnieuw in het gegevensvlak wordt geïnjecteerd.

Stap 4. Definieer de grootte van de buffer. Maximaal 100 MB is toegestaan.

Stap 5. Definieer de limiet, hetzij door de duur die een bereik van 1 - 1000000 seconden mogelijk maakt, hetzij door het aantal pakketten dat een bereik van 1 - 100000 pakketten mogelijk maakt, zoals gewenst

Stap 6. Kies de interface uit de lijst met interfaces in de linkerkolom en selecteer de pijl om deze naar de rechterkolom te verplaatsen

Stap 7. Opslaan en toepassen op apparaat.

Stap 8. Als u de opname wilt starten, selecteert u Start.

Stap 9. U kunt de opname tot de gedefinieerde limiet laten lopen. Als u de opname handmatig wilt stoppen, selecteert u Stoppen.

Stap 10. Zodra de export is gestopt, wordt een knop beschikbaar om te klikken met de optie om het opnamebestand (.pcap) te downloaden op een lokaal bureaublad via https of TFTP-server of FTP-server of lokale systeemharddisk of flash.

Opmerking: CLI biedt een beetje meer granulariteit van opties zoals Limit by. GUI is voldoende om pakketten vast te leggen voor algemene gebruiksgevallen.

Configureren via CLI:

Maak de monitoropname:

monitor capture uplink interface <uplink_of_the_9800> both

Koppel een filter. Het filter kan inline worden opgegeven of er kan naar een ACL- of klassenkaart worden verwezen.

In dit voorbeeld is het de ACL om het verkeer tussen de 2 ip-adressen van de 9800 en een andere WLC 5520 te matchen. Typisch scenario voor probleemoplossing voor mobiliteit:

conf t

ip access-list extended mobilitywlcs
permit ip host <5520_ip_address> host <9800_ip_address>
     permit ip host <9800_ip_address> host <5520_ip_address>
end

monitor capture uplink access-list mobilitywlcs

Als u wilt dat de opname in een cirkelvormige buffer wordt uitgevoerd, geeft dit enige tijd om het probleem op te merken en vervolgens de opname te stoppen en op te slaan.

Stel het bijvoorbeeld in op een buffer van 50 MB. Het duurt maximaal 50 MB schijf op de 9800 en het is vrij groot om enkele minuten gegevens vast te leggen in de hoop dat u het optreden van het probleem krijgt.

monitor capture uplink buffer circular size 50

Start de vastlegging. U kunt het via GUI of CLI downloaden:

monitor capture uplink start

De vastlegging is nu actief.

Laat de benodigde data verzamelen.

Stop de vastlegging. Dit kan via GUI of CLI:

monitor capture uplink stop

U kunt de opname ophalen via de GUI > Problemen oplossen > Packet Capture > Exporteren.

Of uploaden naar een server vanuit CLI. Voorbeeld via ftp:

monitor capture uplink export ftp://x.x.x.x/MobilityCAP.pcap

Zodra de benodigde data zijn verzameld, verwijdert u de vastlegging:

no monitor capture uplink

Alarm LED en kritieke platformalarmen

Alle 9800 toestellen (9800-L, 9800-40 en 9800-80) hebben een ALM LED op hun voorpaneel. Als die LED rood wordt, betekent dit dat er een kritisch alarm op het platform is.

U kunt de alarmen controleren die ervoor zorgen dat de LED rood wordt met de opdracht Alarmstatus faciliteit tonen.

WLC#show facility-alarm status
System Totals  Critical: 2  Major: 0  Minor: 0

Source                     Time                   Severity      Description [Index]
------                     ------                 --------      -------------------
TenGigabitEthernet0/1/0    Jul 26 2019 15:14:04   CRITICAL      Physical Port Link Down [1]
TenGigabitEthernet0/1/1    Jul 26 2019 15:14:04   CRITICAL      Physical Port Link Down [1]

Revisiegeschiedenis

Revisie	Publicatiedatum	Opmerkingen
8.0	01-Sep-2026	Hercertificering - bijgewerkte alt-tekst, doelkoppelingen, grammatica en opmaak.
7.0	24-Apr-2026	Een opmerking toegevoegd over het maximale aantal MAC-adressen dat gelijktijdig kan worden getraceerd
6.0	20-Aug-2024	Verminderde titelgrootte om te voldoen aan Cisco.com Style Guide.
5.0	29-Mar-2024	Verwijderde trace-on-failure sectie vanwege afschrijvingen
4.0	12-Jul-2023	hercertificering
3.0	22-Jun-2022	Verandering in trace-on-failure. Toegevoegd "start last x" optie om logboekprofiel te tonen
2.0	20-Feb-2022	Kleine spellingswijzigingen en titelwijziging
1.0	04-Oct-2021	Eerste vrijgave