Genereert en extraheert het RCA-bestand uit Cisco DNA-centrum

Inleiding

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

Voorwaarden

Vereisten

U moet toegang hebben tot het DNA-centrum (Opdracht Line Interface (CLI). Om in DNA Center te loggen met behulp van CLI, moet u via Secure Socket Shell (SSH) aan het IP-adres van uw DNA Center verbinden met magnelev als de gebruikersnaam voor poort 222.

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

Stap 1. Meld u aan bij DNA Center Opdracht Line Interface (CLI) op poort 222. Gebruik maglev als de gebruikersnaam, tenzij de gebruikersnaam tijdens de eerste instelling is gewijzigd. Start dan de opdracht.

[Tue Sep 11 15:08:48 UTC] maglev@10.1.1.4 (maglev-master-1) ~
$ 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-10.1.1.4-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-10.1.1.4-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-10.1.1.4-rca-2018-09-11_15-32-40_UTC.tar.gz

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

Opmerking: Het RCA-bestand wordt gegenereerd en opgeslagen in /data/rca. Het maken van het bestand duurt gewoonlijk ongeveer 20 minuten. De bestandsnaam heeft deze bestandsindeling: maglev-<inter-cluster link IP>-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 verdeeld. Wanneer de diensten worden verdeeld, zal RCA van een individueel knooppunt geen logs van de diensten omvatten die in andere knopen lopen. Als u bijvoorbeeld A-actief hebt in knooppunt-1 en u de RCA uit knooppunt-2 krijgt, worden de logbestanden van service A niet opgenomen. Daarom raden we u aan het RCA-bestand van alle knooppunten op te nemen wanneer Cisco TAC om een RCA-bestand vraagt.

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

In dit voorbeeld zijn de inter-cluster IP adressen in het 10.1.1.0/29 bereik.

[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 inter-cluster IP adressen die u hebt opgegeven gecached in /home/maglev/.maglevconf. De volgende keer dat u de opdracht rca uitvoert, gebruikt DNA Center hetzelfde knooppunt 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 your admin password>
User 'admin' logged into '10.1.1.3' successfully <-- it automatically logged into the cluster you previously defined inter-cluster IP
 
===============================================================
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 opdracht rca op een ander knooppunt wilt uitvoeren, moet u de context verwijderen die is ingesteld in DNA Center. Dan zal DNA Center u vragen om een nieuw IP-adres voor meerdere clusters te selecteren en u kunt 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
[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

Haal het RCA-bestand op een Windows-computer af

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

Stap 2. Meld u aan bij DNA Center met uw CLI-referenties, kies SCP als het bestandsprotocol en selecteer poortnummer 222.

Stap 3. Ga naar de map data/rca.

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

Trek het RCA-bestand op een MAC/Linux-computer uit

Opmerking: in dit voorbeeld, lost het IP-adres van het DNA Center op tot mxc-dnac4.cisco.com. Vervang deze hostname door uw DNA Center volledig gekwalificeerd domeinnaam (FQDN) of IP-adres.

Stap 1. Open uw terminal. Volg vervolgens 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 te kopiëren dat in uw DNA-centrum in de huidige werkmap op uw computer is opgeslagen.

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 op een MAC/Linux-computer

Gebruik deze syntaxis:

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

Hier is een voorbeeld van de opdracht in het lab:

$ 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 de TAC-case vanaf uw MAC/Linux/Windows-computer

U kunt het Case File Uploader gereedschap gebruiken om het RCA-bestand naar uw Cisco TAC Service Application te uploaden via een browser. Specificeer desgewenst het casenummer. 

Druk direct op het RCA-bestand vanuit uw Cisco DNA-centrum naar uw Cisco-serviceaanvraag

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

Steekproef van een serviceaanvraag:

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

Upload optie 1. Upload het bestand via HTTPS (snelste optie en gebruik 443)

Stap 1. Test of u connectiviteit van uw Cisco DNA Center naar cxd.cisco.com via poort 443 hebt. Hier is één 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 geen resultaat heeft gehad, kunt u deze methode niet gebruiken om uw bestand te uploaden.

Stap 2. Als de test is geslaagd, uploadt u het bestand via HTTPS.

Opdracht:

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

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

Bijvoorbeeld:

$ 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) ~
$

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

Stap 1. Test of u connectiviteit van uw Cisco DNA Center naar cxd.cisco.com via 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 geen resultaat heeft gehad, kunt u deze methode niet gebruiken om uw bestand te uploaden.

Stap 2. Als de test is geslaagd, kunt u het bestand vervolgens via SCP uploaden.

Opdracht:

$ scp 
     
      
     
     @cxd.cisco.com:

Bijvoorbeeld:

$ scp ./test.txt 688046089@cxd.cisco.com:
The authenticity of host 'cxd.cisco.com (72.163.14.108)' 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,72.163.14.108' (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) ~
$