Genereert en extraheert het RCA-bestand (ondersteuningsbundel) uit het Cisco Catalyst Center (voorheen Cisco DNA Center)

Inleiding

Dit document beschrijft het maken en extraheren van het RCA-bestand/de ondersteuningsbundel (RCA) uit Catalyst Center (voorheen Cisco DNA Center).

Achtergrondinformatie

Het Root Cause Analysis (RCA)-bestand is een ondersteuningsbundel die op het Catalyst Center is gegenereerd. Het omvat de uitgangen van meerdere opdrachten en servicelogboeken, die in wezen een momentopname van het Catalyst Center geven. Hiermee kunnen ondersteuningsengineers problemen sneller oplossen en oplossen. Het omvat geen output van de gegevensbanken. Eerder, werd het RCA-bestand geproduceerd en van de CLI alleen gedownload, maar dit is veranderd van versie 2.3.7.6. Alle opdrachtoutput in dit document is relevant vanaf release 2.3.3.x.

Het Root Cause Analysis File (RCA) of Support Bundle genereren

De eerste stap is het RCA-bestand te genereren. Dit kan worden gegenereerd vanuit de UI (User Interface) of via de CLI (Command Line Interface).

Alle implementaties van fysieke applicaties (UI-optie)

Vanaf 2.3.7.6 is er een nieuwe optie om het RCA-bestand te genereren vanuit de Catalyst Center UI, ook wel de "Support Bundle" in de UI genoemd. Ook zijn er nieuwe opties die in de UI worden geboden zoals de mogelijkheid om het tijdkader van de logboeken te kiezen of om een toepassingsspecifieke logbundel te kiezen. Deze opties zijn beschikbaar voor alle implementaties van fysieke apparaten.

Opmerking: Het is niet mogelijk een ondersteuningsbundel te genereren vanuit de gebruikersinterface van een op ESXi gebaseerd virtueel apparaat.

Stap 1: Klik op de optie "Ondersteuningsbundel" in het Help -menu in de bovenste balk.

Stap 2: Een nieuwe pop-up toont een lijst van steunbundels die vroeger zijn geproduceerd of enkel de optie om nieuwe te creëren als dit de eerste is.

Stap 3: Klik op "Ondersteuningsbundel maken" en er verschijnt een nieuwe pop-up. Er kan een tijdsperiode worden geselecteerd voor de ondersteuningsbundel. Als de kwestie 2 dagen geleden werd gezien, kies dan minstens een dag voor de startdatum voor de steunbundel. De maximale tijdsperiode wordt standaard ingesteld op één maand vanaf de huidige tijd. Zorg ervoor dat altijd "Systeemcategorie" is geselecteerd. Afhankelijk van het soort probleem kan een extra toepassingscategorie worden geselecteerd (optioneel). Het kan tot 30 minuten duren om een bestand te genereren (dit kan hoger zijn bij geschaalde implementaties).

Opmerking: Het is mogelijk om te zien dat sommige logbestanden worden overschreven in minder dan een maand, als de activiteiten/gebeurtenissen of toegangsniveaus hoog zijn.

Stap 4: Zorg ervoor dat een volledig RCA-bestand voor uw probleem is opgenomen. Typ in de laatste optie "true" voordat u op de knop "Submit" klikt, omdat hiermee gewaarborgd wordt dat extra uitgangen worden opgenomen.

Cluster/virtuele applicatie met één knooppunt (CLI-optie)

Log in op de Catalyst Center CLI op poort 222 en gebruikmaglevals gebruikersnaam. Voer vervolgens dercaopdracht uit om het RCA-bestand te genereren. Het RCA-bestand wordt gegenereerd en opgeslagen indata/rca. Het maken van het bestand duurt meestal ongeveer 30 minuten. De bestandsnaam heeft de bestandsindelingmaglev--rca-.tar.gz.

Opmerking: Zorg ervoor dat de SSH ServerAliveInterval is ingeschakeld terwijl het no-op pakketinterval is ingesteld op elke 60 seconden of een lagere waarde. Dit voorkomt dat SSH-verbindingen door inactiviteit voortijdig door de server worden gesloten.

Opmerking: Als u de gebruikersnaam voor beheer/beheer of het IP-adres van het cluster wilt wijzigen, verwijdert u de context met de opdracht "sudo maglev context delete maglev-1" (niet van toepassing op het op ESXi gebaseerde virtuele apparaat).

Het Help-menu van de voorbeeldopdracht RCA

$ rca --help

Help:
rca - root cause analysis collection utilities

Usage: rca [COMMAND] [ARGS]...
Commands:
     clear - clear RCA files
      copy - copy rca files to specified location
      exec - collect RCA
      view - restricted filesystem view

Voorbeeld van een RCA die op een fysiek apparaat wordt gegenereerd

$ rca
===============================================================
VERIFYING SSH/SUDO ACCESS
===============================================================
[sudo] password for maglev: 
Done
changed ownership of '/data/rca/maglev-10.78.9.21-rca-2025-03-11_04-27-49_UTC.tar.gz' from root:root to maglev:maglev
===============================================================
VERIFYING ADMINISTRATION ACCESS
Please note that after 3 failed login attempts, diagnostic
collection will proceed, but not all diagnostics will be
collected.
===============================================================
WARNING: Current token has expired (2025-01-24T22:03:05+00:00Z).
The current time is: 2025-03-11T04:27:54Z
Continuing with login
[administration] password for 'admin': 
User 'admin' logged into 'kong-frontend.maglev-system.svc.cluster.local' successfully
===============================================================
RCA package created on Tue Mar 11 04:28:02 UTC 2025
===============================================================
2025-03-11 04:28:02 | INFO | Generating log for 'date'...
2025-03-11 04:28:02 | INFO | Node ISO type: full-iso

...

Created RCA package: /data/rca/maglev-10.78.9.21-rca-2025-03-11_04-27-49_UTC.tar.gz
2025-03-11 04:58:28 | INFO | Cleaning up RCA temp files...
[Tuesday Mar 11 04:58:30 UTC] maglev@10.78.9.21 (maglev-master-10-78-9-21)
$

Voorbeeld van een RCA die wordt gegenereerd op een ESXi virtuele applicatie

$ rca
===============================================================
VERIFYING SSH/SUDO ACCESS
===============================================================
Done
===============================================================
RCA package created on Tue Mar 11 07:04:15 UTC 2025
===============================================================
2025-03-11 07:04:15 | INFO | Generating log for 'date'...
2025-03-11 07:04:15 | INFO | Generating log for 'sudo cat /root/.bash_history'...
2025-03-11 07:04:15 | INFO | Node ISO type: mks
/usr/local/bin/rca_scripts/network_diag.sh
...

Created RCA package: /data/rca/maglev-10.78.9.122-rca-2025-03-11_07-04-15_UTC.tar.gz
2025-03-11 07:23:23 | INFO | Cleaning up RCA temp files...
[Tuesday Mar 11 07:23:23 UTC] maglev@10.78.9.122 (maglev-master-10-78-9-122)
$

Cluster met drie knooppunten (CLI-optie)

Log in op de Catalyst Center CLI op poort 222 en gebruikmaglevals gebruikersnaam. Voer vervolgens dercaopdracht uit om het RCA-bestand te genereren. Het RCA-bestand wordt gegenereerd en opgeslagen indata/rca. Het maken van het bestand duurt meestal ongeveer 30 minuten. De bestandsnaam heeft de bestandsindelingmaglev--rca-.tar.gz. Zorg ervoor dat een RCA-bestand van alle knooppunten wordt verzameld aangezien de services over de knooppunten worden verdeeld. Als het Catalyst Center om een IP-adres van een cluster vraagt, kan dit een bereikbaar knooppunt/IP-adres van een cluster zijn. Dit is nodig om het admin-token op te halen, die op zijn beurt nodig is voor een deel van de opdrachtoutput.

Opmerking: Zorg ervoor dat de SSH ServerAliveInterval is ingeschakeld terwijl het no-op pakketinterval is ingesteld op elke 60 seconden of een lagere waarde. Dit voorkomt dat SSH-verbindingen door inactiviteit voortijdig door de server worden gesloten.

Opmerking: Als u de gebruikersnaam voor beheer/beheer of het IP-adres van het cluster wilt wijzigen, verwijdert u de context met de opdracht "sudo maglev context delete maglev-1" (niet van toepassing op het op ESXi gebaseerde virtuele apparaat).

[Wed May 30 18:24:26 UTC] maglev@10.1.1.2 (maglev-master-10) ~
$  rca
 
===============================================================
Verifying ssh/sudo access
===============================================================
Done
 
===============================================================
Verifying administration access
===============================================================
Cluster: 10.1.1.3 
[administration] username for 'https://10.1.1.3:443': admin
[administration] password for 'admin': 
User 'admin' logged into '10.1.1.3' successfully
 
===============================================================
RCA package created on Wed May 30 18:24:44 UTC 2018
===============================================================
 
2018-05-30 18:24:44 | INFO | Generating log for 'date'...
tar: Removing leading `/' from member names
/etc/cron.d/
/etc/cron.d/run-remedyctl
...

Nadat de rca-opdracht is uitgevoerd, wordt het IP-adres van het cluster op die knooppunt in/home/maglev/.maglevconfgecachet (niet zichtbaar vanuit magshell). De volgende keer dat de rca-opdracht wordt uitgevoerd, gebruikt Catalyst Center hetzelfde IP-adres van het cluster voor dat knooppunt.

[Wed May 30 18:23:37 UTC] maglev@10.1.1.2 (maglev-master-10) ~
$ rca
[sudo] password for maglev: 
 
===============================================================
Verifying ssh/sudo access
===============================================================
Done
 
===============================================================
Verifying administration access
===============================================================
[administration] password for 'admin': <type the admin password>
User 'admin' logged into '10.1.1.3' successfully <-- it automatically logged into the cluster previously defined as the inter-cluster IP address
 
===============================================================
RCA package created on Wed May 30 18:23:46 UTC 2018
===============================================================
 
2018-05-30 18:23:46 | INFO | Generating log for 'date'...
tar: Removing leading `/' from member names
/etc/cron.d/
…

Het Root Cause Analysis File (RCA of Ondersteuningsbundel) bekijken

De bestanden RCA/Support Bundles kunnen worden bekeken vanuit de CLI of de UI.

De RCA/ondersteuningsbundels bekijken (UI-optie)

Opmerking: Alleen ondersteuningsbundels die door de UI zijn gegenereerd, worden hier weergegeven.

Klik op de optie "Ondersteuningsbundel" in het Help-menu dat in de bovenbalk beschikbaar is om bestaande ondersteuningsbundels te bekijken en de status van dat bestand te bekijken. Als het bestand nog steeds wordt gemaakt, wordt op de status een pictogram van het type "lopend" weergegeven. Het bestand kan worden gedownload of geüpload zodra de status groen is.

De RCA/ondersteuningsbundels bekijken (CLI-optie)

Opmerking: Alleen RCA/ondersteuningsbundels die uit de CLI zijn gegenereerd, worden hier weergegeven.

De RCA/Support-bundels worden opgeslagen in de map /data/rca. Ze kunnen worden bekeken via de "rca view" opdracht of via de Linux opdracht.

$ rca view
total 1124652
-rwxr-xr-x 1 root root 1151639341 Feb 26 15:19 maglev-192.168.5.11-rca-2025-02-26_14-52-52_UTC.tar.gz

[Tuesday Mar 11 07:22:46 UTC] maglev@192.168.5.11 (maglev-master-192-168-5-11)
$

$ ls -lt data/rca/
total 1124652
-rwxr-xr-x 1 0 0 1151639341 Feb 26 15:19 maglev-192.168.5.11-rca-2025-02-26_14-52-52_UTC.tar.gz

[Tuesday Mar 11 07:23:06 UTC] maglev@192.168.5.11 (maglev-master-192-168-5-11)
$

Het Root Cause Analysis File (RCA of Ondersteuningsbundel) uitnemen

Er zijn meerdere manieren om het bestand uit het Catalyst Center te halen op basis van de vraag of het bestand is gegenereerd vanuit de UI of de CLI.

De kopie van het Catalyst Center naar een Cisco-ondersteuningscase openen (UI-optie)

Er zijn 2 opties beschikbaar om het bestand te uploaden vanuit de UI. Voor de tweede optie wordt de Cisco Support Assistant Extension (CSAE) Chrome-plug-in/uitbreiding gebruikt.

Optie 1: Upload vanuit de UI

Er worden drie actieknoppen weergegeven voor elk bestand dat vanuit de UI wordt gegenereerd. De actie rechts is bedoeld om het bestand te uploaden naar de Cisco-ondersteuningscase. Hier is het wachtwoord voor toegang tot CXD nodig. De gebruikersnaam is het Cisco-ondersteuningscasenummer en het wachtwoord is een token dat uniek is voor elke Cisco-ondersteuningscase. De gebruikersnaam/het wachtwoord is altijd aanwezig in een opmerking aan het begin van uw Cisco-ondersteuningscase en kan ook worden ophalen bij de Support Case Manager. Raadpleeg voor meer informatie over het token Uploaden van klantbestanden naar Cisco Technical Assistance Center.

Bestand uploaden1

Optie 2: Upload vanuit de UI terwijl de CSAE-extensie is geïnstalleerd

Installeer de CSAE extensie op uw Chrome of Edge browser. Hiermee wordt de mogelijkheid van de actieknop "pijl-omhoog" geprogrammeerd en kan het bestand zonder referenties worden geüpload naar een Cisco-ondersteuningscase. Kijk voor meer informatie in CSAE-documentatie.

De bestandskopie openen vanuit een Windows-, Mac- of Linux-machine (UI-optie)

Stap 1. Download WinSCP (alleen vensters), FileZilla of uw favoriete SCP/SFTP-client.

Stap 2. Geef uw Catalyst Center IP-adres uw CLI-referenties, kies SCPSFTP als bestandsprotocol en kies het poortnummer 222.

Stap 3. Navigeren naar dedata/rcamap.

Stap 4. Kopieer het RCA-bestand naar uw lokale computer.

Opmerking: in dit voorbeeld gaat het IP-adres van Catalyst Center overmxc-dnac4.cisco.comnaar. Vervang deze hostnaam door de Fully Qualified Domain Name (FQDN) of IP-adres van uw Catalyst Center-applicatie.

De bestandskopie openen vanaf een Mac- of Linux-machine (CLI-optie)

Stap 1. Open een terminalsessie en voer vervolgens deze stappen uit om het RCA-bestand met de naam datmaglev-10.78.9.21-rca-2025-01-14_08-48-51_UTC.tar.gzis opgeslagen op het Catalyst Center-apparaat in dedata/rcamap te kopiëren naar de huidige werkmap op uw computer.

rrahul@MY-MACBOOK ~ % scp -P 2222 maglev@10.78.9.21:data/rca/maglev-10.78.9.21-rca-2025-01-14_08-48-51_UTC.tar.gz .
Welcome to the Cisco DNA Center Appliance
maglev@10.78.9.21's password: 
maglev-10.78.9.21-rca-2025-01-14_08-48-51_UTC.tar.gz                                                                                                  100%  1485MB  32.3MB/s  00:45 
rrahul@MY-MACBOOK ~ % 

De bestandskopie starten van een Catalyst Center naar een Mac- of Linux-machine (CLI-optie)

Opmerking: Zorg ervoor dat de SSH ServerAliveInterval is ingeschakeld terwijl het no-op pakketinterval is ingesteld op elke 60 seconden of een lagere waarde. Dit voorkomt dat SSH-verbindingen door inactiviteit voortijdig door de server worden gesloten.

Gebruik vanuit de CLI van het Catalyst Center-apparaat een van deze opdrachten om het bestand te kopiëren. Beide maken gebruik van SCP.  Er is een klein verschil in de opdrachtsyntaxis zoals in deze voorbeelden:

 $ scp data/rca/<RCA file name> <Mac/Linux username>@<Mac/Linux IP address>:<path to save the file>
OR
 $ rca copy
Help:
copy - copy rca files to specified location
Usage: rca copy [scp-options] --files file1 ... user@host2:file2

Hier zijn voorbeelden van de twee opdrachten die u van een Catalyst Center naar een server kunt kopiëren:

$ scp data/rca/maglev-10.78.9.21-rca-2025-01-14_08-48-51_UTC.tar.gz rrahul@10.105.192.135:
rrahul@10.105.192.135's password: <Enter the destination password>
maglev-10.78.9.21-rca-2025-01-14_08-48-51_UTC.tar.gz                                                                                                100%  1485MB  106.6MB/s  00:13
[Thursday Mar 06 13:02:01 UTC] maglev@10.78.9.21 (maglev-master-10-78-9-21)
$

$ rca copy --files maglev-10.78.9.21-rca-2025-01-14_08-48-51_UTC.tar.gz rrahul@10.105.192.135:
rrahul@10.105.192.135's password: <Enter the destination password>
maglev-10.78.9.21-rca-2025-01-14_08-48-51_UTC.tar.gz                                                                                                100%  1485MB  106.1MB/s  00:13 
[Thursday Mar 06 13:10:31 UTC] maglev@10.78.9.21 (maglev-master-10-78-9-21)
$

De bestandskopie van het Catalyst Center naar een Cisco-ondersteuningscase (CLI-optie) openen

Opmerking: Zorg ervoor dat de SSH ServerAliveInterval is ingeschakeld terwijl het no-op pakketinterval is ingesteld op elke 60 seconden of een lagere waarde. Dit voorkomt dat SSH-verbindingen door inactiviteit voortijdig door de server worden gesloten.

Dit is vergelijkbaar met de vorige optie, waarbij SCP wordt gebruikt om een beveiligde bestandsoverdracht naar cxd.cisco.com uit te voeren (de beperkte shell voorkomt het gebruik van andere opdrachten). De gebruikersnaam is het Cisco-ondersteuningscasenummer en het wachtwoord is een token dat uniek is voor elke Cisco-ondersteuningscase. De gebruikersnaam/het wachtwoord is altijd aanwezig in een opmerking aan het begin van uw Cisco-ondersteuningscase en kan ook worden ophalen bij de Support Case Manager. Raadpleeg voor meer informatie over het token Uploaden van klantbestanden naar Cisco Technical Assistance Center.

$ rca copy --files maglev-10.1.1.233-rca-2024-03-06_14-07-36_UTC.tar.gz 6969XXXXX@cxd.cisco.com:/
FIPS mode initialized
Warning: Permanently added the ECDSA host key for IP address '10.209.135.105' to the list of known hosts.
6969XXXXX6@cxd.cisco.com's password: 
maglev-10.1.1.233-rca-2024-03-06_14-07-36_UTC.tar.gz

De bestandskopie van een Mac- of Linux-machine starten naar een Cisco-ondersteuningscase (CLI-optie)

Opmerking: Deze paragraaf is van toepassing op een Mac of een Linux-server. Het is niet van toepassing op het Catalyst Center sinds de release van versie 2.3.

Er zijn twee opties voor het uploaden van elk bestand (inclusief de RCA) van uw Mac of Linux-machine. In beide opties is de gebruikersnaam het Cisco-ondersteuningscasenummer en is het wachtwoord een token dat uniek is voor elke Cisco-ondersteuningscase. De gebruikersnaam/het wachtwoord is altijd aanwezig in een opmerking aan het begin van uw Cisco-ondersteuningscase en kan ook worden ophalen bij de Support Case Manager. Raadpleeg voor meer informatie over het token Uploaden van klantbestanden naar Cisco Technical Assistance Center.

Voorbeelduitvoer van een Cisco-ondersteuningscase:

Subject: 688046089: CXD Upload Credentials

You can now upload files to the case using FTP/FTPS/SCP/SFTP/HTTPS protocols and the following details:
Hostname: cxd.cisco.com
Username: 688046089
Password: gX***********P7

Optie 1. Upload het bestand via HTTPS (Fast Option en gebruik poort 443)

Stap 1. Test of je verbinding hebt van je Mac of Linux machine naarcxd.cisco.comvia poort 443. Hier is een manier om de test uit te voeren:

$ nc -zv cxd.cisco.com 443
Connection to cxd.cisco.com 443 port [tcp/https] succeeded!
$

Opmerking: Als de test is mislukt, kunt u deze methode niet gebruiken om uw bestand te uploaden.

Stap 2. Als de test succesvol is, uploadt u het bestand via HTTPS met behulp van deze opdracht (dit werkt niet vanaf een Catalyst Center-applicatie):

$ curl -T “” -u  https://cxd.cisco.com/home/ 

(Als u een meer gedetailleerde weergave van het uploaden wilt zien, voegt u de optie toe-v. Bijvoorbeeld "curl -vT…")

Voorbeeld:

$ curl -T "./test.txt" -u 688046089 https://cxd.cisco.com/home/
Enter host password for user '688046089':  
[Tue Dec 10 13:35:47 UTC] maglev@10.1.1.1(maglev-master-1) ~
$

Optie 2. Upload het bestand via SCP (gebruikt poort 2)

Stap 1. Test of u connectiviteit van uw Mac of Linux machine aancxd.cisco.comvia poort 22 hebt. Hier is één manier om de test uit te voeren:

$ nc -zv cxd.cisco.com 22
Connection to cxd.cisco.com 22 port [tcp/ssh] succeeded!
$

Opmerking: Als de test mislukt, kunt u deze methode niet gebruiken om uw bestand te uploaden.

Stap 2. Als de test succesvol is, uploadt u het bestand via SCP met het gebruik van deze opdracht:

$ scp  @cxd.cisco.com:

Voorbeeld:

$ scp ./test.txt 688046089@cxd.cisco.com:
The authenticity of host 'cxd.cisco.com (X.X.X.X)' can't be established.
RSA key fingerprint is SHA256:3c8Vi3Ms2AITZlNzkBccR1pvE5ie9oMs64Uh0uhRado.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'cxd.cisco.com,X.X.X.X' (RSA) to the list of known hosts.
688046089@cxd.cisco.com's password: 
test.txt                                                                                                                                                                                                        100%   39     0.0KB/s   00:00    

[Tue Dec 10 13:44:27 UTC] maglev@10.1.1.1  (maglev-master-1) ~
$