Generieren und Extrahieren der RCA-Datei aus dem Cisco DNA Center

Einleitung

In diesem Dokument wird beschrieben, wie die Root Cause Analysis (RCA)-Datei erstellt und aus dem Cisco Digital Network Architecture (DNA) Center extrahiert wird.

Hintergrundinformationen

Sie benötigen CLI-Zugriff auf das Cisco DNA Center. Um sich mit der CLI beim Cisco DNA Center anzumelden, müssen Sie über Secure Socket Shell (SSH) eine Verbindung zur Management-IP-Adresse Ihres Cisco DNA Centers mit maglev dem Benutzernamen am Port 2222 herstellen.

Achten Sie auf die eingeschränkte Shell-Funktion, die in 2.3.2.x hinzugefügt wurde und es Ihnen nicht erlaubt, viele Befehle auszuführen, bis Sie sie deaktivieren. Weitere Informationen zum vorübergehenden Deaktivieren der eingeschränkten Shell in 2.3.2.x oder 2.3.3.x finden Sie in diesem Dokument. In Version 2.3.4.0 und höher kann die eingeschränkte Shell nicht deaktiviert werden.

Generieren der RCA-Datei in einem Single-Node-Cluster

Schritt 1: Melden Sie sich bei der Cisco DNA Center-CLI an Port 2222 an. Verwenden Sie den maglev als Benutzernamen, es sei denn, der Benutzername wurde zum Zeitpunkt der Ersteinrichtung geändert. Führen Sie dann den rca Befehl aus.

[Tue Sep 11 15:08:48 UTC] maglev@10.1.1.1 (maglev-master-1) ~ $ sudo 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 '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 <snip> /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@10.1.1.1 (maglev-master-1) ~

In den neueren Cisco DNA Center-Versionen (2.3.4.x und höher) können Sie folgende Funktionen ausführen$ rca copy:

$ 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

Hinweis: Die RCA-Datei wird generiert und gespeichert in /data/rca. Die Erstellung der Datei dauert in der Regel etwa 20 Minuten. Der Dateiname muss das folgende Format haben: maglev-<inter-cluster link IP address>-rca<date and time>.tar.gz.

Generieren der RCA-Datei in einem N-Node-Cluster

Tipp: Wenn Sie einen funktionierenden n-Knoten-Cluster haben, werden die Services verteilt. Wenn die Dienste verteilt werden, enthält die RCA eines einzelnen Knotens keine Protokolle von Diensten, die auf anderen Knoten ausgeführt werden. Wenn Sie z. B. den Dienst A auf Knoten-1 ausführen und die RCA von Knoten-2 erhalten, sind die Protokolle von Dienst A nicht enthalten. Es wird daher empfohlen, die RCA-Datei aller Knoten im Cluster zu erfassen und einzubeziehen, wenn das TAC eine RCA Datei anfordert.

Wenn Sie einen Cluster mit 3 Knoten haben und den rca Befehl auf einem beliebigen Gerät ausführen, fordert Sie das Cisco DNA Center zur Eingabe einer Cluster-IP-Adresse auf. Geben Sie an der Eingabeaufforderung die clusterübergreifende IP-Adresse des Knotens ein, von dem Sie die RCA abrufen möchten.

In diesem Beispiel befinden sich die IP-Adressen zwischen Clustern im Bereich 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': <type your admin password> 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

Nachdem Sie den rca  Befehl ausgeführt haben, werden die angegebenen IP-Adressen zwischen Clustern in zwischengespeichert/home/maglev/.maglevconf. Bei der nächsten Ausführung des rca Befehls verwendet Cisco DNA Center denselben Knoten, um die RCA-Informationen abzurufen.

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

Wenn Sie den rca Befehl auf einem anderen Knoten ausführen müssen, müssen Sie den im Cisco DNA Center konfigurierten Kontext löschen. Anschließend werden Sie aufgefordert, eine neue IP-Adresse für die Clusterübergreifende Auswahl auszuwählen, und Sie können die IP-Adresse des anderen Knotens definieren.

[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

Extrahieren der RCA-Datei auf einem Windows-Computer

Schritt 1: Laden Sie WinSCP oder Ihren bevorzugten SCP-Client herunter.

Schritt 2: Melden Sie sich mit Ihren CLI-Anmeldeinformationen beim Cisco DNA Center an, wählen Sie SCP als Dateiprotokoll aus, und wählen Sie die Portnummer 2222 aus.

Schritt 3: Navigieren Sie zum /data/rca Ordner.

Schritt 4: Kopieren Sie die RCA-Datei auf Ihren lokalen Computer.

Extrahieren der RCA-Datei auf einem Mac- oder Linux-Computer

Hinweis: In diesem Beispiel wird die Cisco DNA Center IP-Adresse zu mxc-dnac4.cisco.com aufgelöst. Ersetzen Sie diesen Hostnamen durch den FQDN (Fully Qualified Domain Name) oder die IP-Adresse Ihrer Cisco DNA Center-Appliance.

Schritt 1: Öffnen Sie eine Terminalsitzung, und führen Sie dann diese Schritte aus, um die RCA-Datei namens maglev-10.1.1.4-rca-2018-09-11_15-32-40_UTC.tar.gz, die auf der Cisco DNA Center-Appliance im Verzeichnis gespeichert ist, in das/data/rca aktuelle Arbeitsverzeichnis auf Ihrem Computer zu kopieren.

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$ 

Push der RCA-Datei auf einen Mac- oder Linux-Computer

Verwenden Sie in der CLI der Cisco DNA Center-Appliance folgende Syntax:

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

Nachfolgend finden Sie ein Beispiel für den in der Übung verwendeten Befehl:

$ 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: <type your Linux or Mac user password> maglev-10.1.1.4-rca-2018-09-11_15-32-40_UTC.tar.gz 100% 335MB 3.7MB/s 01:32 

RCA-Datei in TAC-SR hochladen

Sie können das Uploader für Ticket-Dateien verwenden, um die RCA-Datei über einen Browser in einen TAC Service Request (SR) hochzuladen, der auf Ihrem Computer vorhanden ist. Geben Sie bei Bedarf die Vorgangsnummer an. 

RCA-Datei auf TAC-SR übertragen

Es gibt zwei Optionen, um eine Datei (z. B. die RCA) direkt von einer Cisco DNA Center-Appliance auf einen TAC SR hochzuladen. In beiden Optionen ist der Benutzername die SR-Nummer, und das Kennwort ist ein Token, der für jeden SR eindeutig ist. Der Benutzername/das Passwort ist immer in einer Notiz am Anfang Ihres SR vorhanden und kann auch aus SCM abgerufen werden. Weitere Informationen zum Token finden Sie unter Uploads von Kundendateien an das Cisco Technical Assistance Center.

Beispielausgabe von einem SR:

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

Option 1: Datei über HTTPS hochladen (Schnellste Option und nutzt Port 443)

Schritt 1: Testen Sie, ob eine Verbindung zwischen der Cisco DNA Center-Appliance und cxd.cisco.com Port 443 besteht. So führen Sie den Test durch:

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

Hinweis: Wenn der Test fehlschlug, können Sie Ihre Datei nicht mit dieser Methode hochladen.

Schritt 2: Wenn der Test erfolgreich war, laden Sie die Datei mithilfe des folgenden Befehls über HTTPS hoch:

$ curl -T “<filename with path>” -u <SR number> https://cxd.cisco.com/home/ 

(Wenn Sie eine detailliertere Ansicht des Uploads anzeigen möchten, fügen Sie die -v Option hinzu. Beispiel: 'curl -vT …'.)

Beispiele:

$ curl -T "./test.txt" -u 688046089 https://cxd.cisco.com/home/
Enter host password for user '688046089': <Type your CXD Upload password, unique to a Service Request, here> 
[Tue Dec 10 13:35:47 UTC] maglev@10.1.1.1(maglev-master-1) ~
$

Eingeschränkte Shell

Da die eingeschränkte Shell die Verwendung von CURL verhindert, verwenden wir rca copy, das scp nutzt, um eine sichere Dateiübertragung an cxd.cisco.com zu ermöglichen.

$ 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

Option 2: Laden Sie die Datei über SCP hoch (nutzt Port 22)

Schritt 1: Testen Sie, ob eine Verbindung zwischen der Cisco DNA Center-Appliance und cxd.cisco.com Port 22 besteht. So führen Sie den Test durch:

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

Hinweis: Wenn der Test fehlschlug, können Sie Ihre Datei nicht mit dieser Methode hochladen.

Schritt 2: Wenn der Test erfolgreich war, laden Sie die Datei mithilfe des folgenden Befehls über SCP hoch:

$ scp <local filename with path> <SR number>@cxd.cisco.com:

Beispiele:

$ 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: <Type your CXD Upload password, unique to a service request, here>
test.txt                                                                                                                                                                                                        100%   39     0.0KB/s   00:00    

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