Het RCA-bestand genereren en extraheren uit Cisco DNA Center

Inleiding

Dit document beschrijft hoe u het Root Cause Analysis (RCA)-bestand kunt maken en extraheren uit het Cisco Digital Network Architecture (DNA) Center.

Voorwaarden

Vereisten

U moet CLI-toegang tot Cisco DNA Center hebben. Als u wilt inloggen op Cisco DNA Center met de CLI, moet u via Secure Socket Shell (SSH) verbinding maken met het IP-adres van het beheer van uw Cisco DNA Center met Maglev als gebruikersnaam op poort 2222.

Het RCA-bestand genereren in een cluster met één knooppunt

Stap 1. Log in op de Cisco DNA Center CLI op poort 222. Gebruik maglev als de gebruikersnaam, tenzij de gebruikersnaam werd gewijzigd ten tijde van de eerste instelling. Voer vervolgens de rca-opdracht uit.

[Tue Sep 11 15:08:48 UTC] maglev@x.x.x.x (maglev-master-1) ~
$ sudo rca
[sudo] password for maglev: 

===============================================================
Verifying ssh/sudo access
===============================================================
Done

===============================================================
Verifying administration access
===============================================================
[administration] password for 'admin': 
     
     
User 'admin' logged into 'kong-frontend.maglev-system.svc.cluster.local' successfully

===============================================================
RCA package created on Tue Sep 11 15:32:47 UTC 2018
===============================================================

2018-09-11 15:32:47 | INFO | Generating log for 'date'...
tar: Removing leading `/' from member names
/etc/cron.d/
/etc/cron.d/clean-journal-files

     
     
/data/rca/maglev-x.x.x.x-rca-2018-09-11_15-32-40_UTC/docker_inspect_k8s_platform-ui_platform-ui-2963217120-rxv5d_maglev-system_1a09eb87-9f00-11e8-9d42-005d73c0c790_0.log
/data/rca/maglev-x.x.x.x-rca-2018-09-11_15-32-40_UTC/sudo_ethtool_calife1d52fff20.log
2018-09-11 15:43:14 | INFO | Cleaning up RCA temp files...

Created RCA package: /data/rca/maglev-x.x.x.x-rca-2018-09-11_15-32-40_UTC.tar.gz

[Tue Sep 11 15:43:14 UTC] maglev@x.x.x.x (maglev-master-1) ~

Opmerking: Het RCA-bestand wordt gegenereerd en opgeslagen in /data/rca. Het maken van het bestand duurt meestal ongeveer 20 minuten. De bestandsnaam heeft deze bestandsindeling: maglev-<inter-cluster link IP-adres>-rca<datum en tijd>.tar.gz.

Het RCA-bestand in een N-knooppunt-cluster genereren

Tip: Wanneer u een functioneel n-knooppunt-cluster hebt, worden de services gedistribueerd. Wanneer de services worden gedistribueerd, bevat de RCA van een individueel knooppunt geen logbestanden van services die op andere knooppunten worden uitgevoerd. Als u bijvoorbeeld service A hebt die op knooppunt-1 wordt uitgevoerd en u de RCA van knooppunt-2 krijgt, worden de logbestanden van service A niet opgenomen. Daarom wordt aangeraden om het RCA-bestand van alle knooppunten in het cluster op te nemen wanneer de TAC om een RCA-bestand vraagt.

Wanneer u een cluster met 3 knooppunten hebt en u de rca-opdracht op elk apparaat uitvoert, vraagt Cisco DNA Center u om een IP-adres voor een cluster. Voer bij de prompt het IP-adres in van het knooppunt waarvan u de RCA wilt ophalen.

In dit voorbeeld zijn de IP-adressen tussen de clusters in het bereik 10.1.1.0/29.

[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 u de rca-opdracht hebt uitgevoerd, worden de IP-adressen tussen clusters die u hebt opgegeven, gecachet in /home/maglev/.maglevconf. De volgende keer dat u de rca-opdracht uitvoert, gebruikt Cisco DNA Center dezelfde node om de RCA-informatie te verkrijgen.

[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/
… rca continued…

Als u de rca-opdracht op een ander knooppunt wilt uitvoeren, moet u de context verwijderen die in Cisco DNA Center is geconfigureerd. Vervolgens vraagt Cisco DNA Center u om een nieuw IP-adres tussen clusters te selecteren en kunt u het IP-adres van het andere knooppunt definiëren.

[Wed May 30 18:24:10 UTC] maglev@10.1.1.2 (maglev-master-10) ~
$ sudo maglev context delete maglev-1
Removed command line context 'maglev-1'
 
[Wed May 30 18:24:18 UTC] maglev@10.1.1.2 (maglev-master-10) ~
$ more /home/maglev/.maglevconf
;---------------------------------------------------------------------
; Modified by Maglev: Wed, 30 May 2018 18:24:18 UTC
; maglev 73529
;---------------------------------------------------------------------
 
[global]
 
 
[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.2 <-- now it asks for the new cluster IP address
[administration] username for 'https://10.1.1.2:443': admin
[administration] password for 'admin': <type your admin password>
User 'admin' logged into '10.1.1.2' 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

Het RCA-bestand op een Windows-computer extraheren

Stap 1. Download WinSCP voor uw favoriete SCP-client.

Stap 2. Log in bij Cisco DNA Center met uw CLI-referenties, kies SCP als het bestandsprotocol en selecteer poortnummer 222.

Stap 3. Navigeer naar de map /data/rca.

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

Haal het RCA-bestand op een Mac of Linux computer

N.B.: in dit voorbeeld lost het IP-adres van Cisco DNA Center zich op in mxc-dnac4.cisco.com. Vervang deze hostnaam door het volledig gekwalificeerde domeinnaam (FQDN) of IP-adres van uw Cisco DNA Center-apparaat.

Stap 1. Open een terminalsessie en volg de volgende stappen om het RCA-bestand met de naam maglev-10.1.1.4-rca-2018-09-11_15-32-40_UTC.tar.gz dat op het Cisco DNA Center-apparaat is opgeslagen in de map /data/rca, naar de huidige werkmap op uw computer te kopiëren.

ALECARRA-M-P1Z8:~ alecarra$ scp -P 2222 maglev@mxc-dnac4.cisco.com:/data/rca/maglev-10.1.1.4-rca-2018-09-11_15-32-40_UTC.tar.gz ./
Welcome to the Maglev Appliance
maglev@mxc-dnac4.cisco.com's password: <type your maglev password>
maglev-10.1.1.4-rca-2018-09-11_15-32-40_UTC.tar.gz                                                                                                    100%  335MB   3.3MB/s   01:41    
ALECARRA-M-P1Z8:~ alecarra$ 

Duw het RCA-bestand naar een Mac of Linux computer

Gebruik deze syntaxis vanuit de CLI van het Cisco DNA Center-apparaat:

 $ scp /data/rca/<RCA file name> <Mac/Linux username>@<Mac/Linux IP address>:<path to save the file>

Hier is een voorbeeld van het bevel dat in het laboratorium wordt gebruikt:

$ scp /data/rca/maglev-10.1.1.4-rca-2018-09-11_15-32-40_UTC.tar.gz alecarra@10.24.133.238:/Users/alecarra/Documents/DNA
The authenticity of host '10.24.133.238 (10.24.133.238)' can't be established.
ECDSA key fingerprint is SHA256:u660kUomvMParNkcPIm7oXrDp84rilP5CM9wCWCFOAE.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '10.24.133.238' (ECDSA) to the list of known hosts.
Password: 
     
     
maglev-10.1.1.4-rca-2018-09-11_15-32-40_UTC.tar.gz                                                                                                    100%  335MB   3.7MB/s   01:32    

Upload het RCA-bestand naar een bestaande TAC-serviceaanvraag vanaf uw computer

U kunt de Case File Uploader tool gebruiken om het RCA-bestand naar uw TAC-serviceaanvraag te uploaden via een browser. Geef het casenummer op indien dit vereist is. 

Druk het RCA-bestand rechtstreeks vanuit uw Cisco DNA Center-applicatie naar uw TAC-serviceaanvraag

Er zijn twee opties om een bestand (zoals de RCA) rechtstreeks te uploaden van een Cisco DNA Center-applicatie naar een TAC-serviceaanvraag (SR). In beide opties is de gebruikersnaam het SR-nummer en is het wachtwoord een token dat uniek is voor elke SR. De gebruikersnaam/het wachtwoord is altijd aanwezig in een notitie aan het begin van uw serviceaanvraag en kan ook worden opgehaald uit SCM. Raadpleeg voor meer informatie over het token Uploaden van klantbestanden naar Cisco Technical Assistance Center.

Voorbeeld van uitvoer van een serviceverzoek:

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

Uploadoptie 1. Upload het bestand via HTTPS (snelste optie en gebruik poort 43)

Stap 1. Test of u connectiviteit van uw Cisco DNA Center-applicatie hebt naar cxd.cisco.com via poort 443. Dit 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 niet is geslaagd, kunt u deze methode niet gebruiken om uw bestand te uploaden.

Stap 2. Als de test is geslaagd, uploadt u het bestand via HTTPS met behulp van deze opdracht:

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

(Als u een meer gedetailleerde weergave van het uploaden wilt zien, voegt u de optie -v toe. 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@192.168.5.11 (maglev-master-1) ~
$

Uploadoptie 2. Upload het bestand via SCP (gebruikt poort 22)

Stap 1. Test of u connectiviteit van uw Cisco DNA Center-applicatie hebt naar cxd.cisco.com via poort 22. Dit is een 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 niet is geslaagd, kunt u deze methode niet gebruiken om uw bestand te uploaden.

Stap 2. Als de test is geslaagd, 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@192.168.5.11  (maglev-master-1) ~
$