DELL Networking SONiC: Erzeugen und Erfassen von tech-support-Dateien

Index

Was ist die tech-support-Datei?
Befehlssyntax
So erzeugen Sie eine tech-support-Datei in Dell SONiC
So verfolgen Sie den Erzeugungsstatus der tech-support-Datei
So rufen Sie die tech-support-Datei vom Switch ab
FTP
HTTP
USB
SCP-Client-Anwendung
Name und Format der tech-support-Datei
So beschränken Sie ältere Einträge und reduzieren die Größe der tech-support-Datei
Löschen älterer tech-support-Dateien, um Speicherplatz zu sparen

Was ist die tech-support-Datei?

Die tech-support-Datei ist eine komprimierte Archivdatei, die Informationen zum Status des Switch wie Syslog, Datenbankstatus, Core-Speicherabbild usw. enthält. Die MitarbeiterInnen des technischen Supports von Dell benötigen eine tech-support-Datei für detaillierte Analysen eines Ereignisses.

• Die tech-support-Datei ist eine komprimierte Datei und wird in /var/dump gespeichert. Der Inhalt dieses Ordners kann mit dem folgenden Befehl angezeigt werden:

  dir tech-support:/

• Die tech-support-Datei hat die Erweiterung „.tar.gz“.
• Die Erzeugung der tech-support-Datei kann länger als 15 bis 30 Minuten dauern.
• Die Dateigröße variiert je nach Datenmenge und Zeitdauer der Protokollstichproben. Um die Größe zu reduzieren, kann die Option „since“ verwendet werden.
• Versuchen Sie, wenn möglich, eine tech-support-Datei zu erzeugen, während sich das System im Problemstatus befindet.

Befehlssyntax

Optional

So erzeugen Sie eine tech-support-Datei in Dell SONiC

Verwenden Sie den Befehl show tech-support, um eine tech-support-Datei zu erzeugen.

Beispiel

admin@DELLSONiC:~$ sonic-cli
DELLSONiC# 
DELLSONiC# show tech-support 
%Info: Tech-support process started, please check "show tech-support status" for tech-support progress
DELLSONiC#

So verfolgen Sie den Erzeugungsstatus der tech-support-Datei

Verwenden Sie den Befehl show tech-support status, um den Status der Erzeugung der tech-support-Datei zu überprüfen. Die Ausgabe zeigt „Status: Completed“ an, wenn die Dateierzeugung abgeschlossen ist.
Verwenden Sie den Befehl dir tech-support:/, um den Inhalt des /var/tmp-Ordners anzuzeigen. Die tech-support-Datei wird in diesem Ordner erzeugt.

Unten finden Sie eine Beispielausgabe für show tech-support status und dir tech-support:/.

Während der Erzeugung der tech-support-Datei:

DELLSONiC# show tech-support status 
Status: In Progress (Collecting Counters-1) Total items collected: 12

DELLSONiC# dir tech-support:/
-------------------------------------------------------------------------
Date(Last Modified)      Size(Bytes)    Type      Filename                        
-------------------------------------------------------------------------                
2023-04-15 20:21         4096           d         sonic_dump_DELLSONiC_20230415_202048
2023-04-15 20:22         11100160       -         sonic_dump_DELLSONiC_20230415_202048.tar

Nach der erfolgreichen Erzeugung der tech-support-Datei:

DELLSONiC# show tech-support status
Status: Completed
File Name: /var/dump/sonic_dump_DELLSONiC_20230415_202048.tar.gz

DELLSONiC# dir tech-support:/ 
-------------------------------------------------------------------------
Date(Last Modified)      Size(Bytes)    Type      Filename                        
-------------------------------------------------------------------------                
2023-04-15 20:27         252932846      -         sonic_dump_DELLSONiC_20230415_202048.tar.gz

So rufen Sie die tech-support-Datei vom Switch ab

Verwenden Sie den Befehl copy tech-support://<tech-support-Dateiname> <Ziel>//<Dateiname>, um die tech-support-Datei in ein Stammverzeichnis, auf USB oder auf einen Remote-FTP/HTTP/SCP-Server zu kopieren.

Nachfolgend finden Sie die verfügbaren Zieloptionen und deren Verwendung.

• ftp: Kopieren auf Remote-FTP-Server (ftp://Nutzer_ID:Kennwort@Host-IP/Dateipfad)
• home: Kopieren in Stammverzeichnis (home://Dateiname)
• http: Kopieren auf Remote-HTTP-Server (http://Host-IP/Dateipfad)
• scp: Kopieren auf Remote-SCP-Server (scp://Nutzer-ID:Kennwort@Host-IP/Dateipfad)
• usb: Kopieren in USB-Medienverzeichnis (usb://Dateiname)

Nachfolgend werden die Optionen anhand eines Beispiels veranschaulicht.

FTP
Verwenden Sie zum Kopieren einer Datei auf einen Remote-FTP-Server die folgende Syntax.

copy techsupport://<techsupport file.tag.gz> ftp://userid:passwd@hostip/filepath

Angenommen die tech-support-Datei wird auf einen Remote-FTP-Server mit der IP-Adresse: 10.0.0.1, dem Nutzernamen: TEST und dem Kennwort: PASS kopiert.

Beispielausgabe

DELLSONiC# copy tech-support://sonic_dump_DELLSONiC_20230415_202048.tar.gz ftp://TEST:PASS@10.0.0.1/sonic_dump_DELLSONiC_20230415_202048.tar.gz

HTTP
Verwenden Sie zum Kopieren einer Datei auf einen Remote-HTTP-Server die folgende Syntax.

copy techsupport://<techsupport file.tag.gz> http://hostip/filepath

Angenommen die tech-support-Datei wird auf einen Remote-HTTP-Server mit der IP-Adresse: 10.0.0.1 kopiert.

Beispielausgabe

DELLSONiC# copy tech-support://sonic_dump_DELLSONiC_20230415_202048.tar.gz http://10.0.0.1/sonic_dump_DELLSONiC_20230415_202048.tar.gz

USB
Für die Verwendung von USB in einem DELL SONiC auf einem Netzwerkswitch muss der USB-Aktivierungsbefehl konfiguriert werden. USB ist standardmäßig deaktiviert.
Führen Sie den USB-Einhängebefehl aus, nachdem Sie den USB-Stick in den Switch eingesteckt haben.

Dell Networking SONiC: Ein- und Aushängen von USB

Beispielausgabe

sonic#
sonic# configure terminal
sonic(config)# usb enable
sonic(config)# exit
sonic# usb mount
DELLSONiC# copy tech-support://sonic_dump_DELLSONiC_20230415_202048.tar.gz usb://sonic_dump_DELLSONiC_20230415_202048.tar.gz

SCP-Client-Anwendung
Sie können eine beliebige SCP-Client-Anwendung verwenden, um die tech-support-Datei vom Switch zu extrahieren.
Verwenden Sie in der SCP-Client-Anwendung die Switch-Zugangsdaten, um sich beim Switch anzumelden. Die tech-support-Datei befindet sich im Verzeichnis /var/dump/.
Einige SCP-Client-Anwendungen verfügen über eine grafische Benutzeroberfläche, die das Kopieren einer Datei aus dem /var/dump/-Verzeichnis des Switch an einen Speicherort auf Ihrem lokalen Rechner noch einfacher macht.

Name und Format der tech-support-Datei

Der Name der tech-support-Datei hat das Format sonic_dump_<Hostname>_ _YYYYMMDD_HHMMSS.tar.gz
*YYYYMMDD_HHMMSS steht für Jahr, Monat, Tag_ Stunde, Minute, Sekunde und gibt den Zeitpunkt der Erzeugung der tech-support-Datei an.

Beispiel: sonic_dump_DELLSONiC_20230415_202048.tar.gz ist die erzeugte tech-support-Datei. YYYYMMDD_HHMMSS ist in diesem Fall 20230415_202048 und DELLSONiC ist der Hostname des Switch.

So beschränken Sie ältere Einträge und reduzieren die Größe der tech-support-Datei

Die tech-support-Datei kann je nach Betriebszeit des Switch eine umfangreiche Datei sein. In Dell SONiC lässt sich die Größe der tech-support-Datei reduzieren, indem die Protokollierungsdauer begrenzt wird.

Verwenden Sie den Befehl show tech-support since <Datum/Uhrzeit>, um die tech-support-Datei ab einem bestimmten Zeitpunkt zu erfassen.

Beispielausgabe

DELLSONiC# show tech-support since "2023-04-14T12:30:30Z"
%Info: Tech-support process started, please check "show tech-support status" for tech-support progress

Es wird empfohlen, die Erfassung ab der 0. Stunde des Vortags durchzuführen, um mögliche dem Ereignis vorausgehende Aktionen zu erfassen.

Beispielausgabe

DELLSONiC# show tech-support since "2023-04-14T00:00:00Z"
%Info: Tech-support process started, please check "show tech-support status" for tech-support progress

Befehlssyntax

Löschen älterer tech-support-Dateien, um Speicherplatz zu sparen

Die tech-support-Datei im Speicherabbildordner kann sicher gelöscht werden, nachdem die Datei vom Switch extrahiert wurde.

Verwenden Sie den Befehl delete tech-support:/ <techsupport-Dateiname.tar.gz>, um die tech-support-Datei zu löschen.

Beispielausgabe

DELLSONiC# delete tech-support:/ sonic_dump_DELLSONiC_20230415_202048.tar.gz
Proceed to delete tech-support:/sonic_dump_DELLSONiC_20230415_202048.tar.gz? [y/N]:y

Verwenden Sie den Befehl dir tech-support:/, um zu überprüfen, ob die Datei gelöscht wurde.

Beispielausgabe

DELLSONiC# dir tech-support:/ 
-------------------------------------------------------------------------
Date(Last Modified)      Size(Bytes)    Type      Filename                        
-------------------------------------------------------------------------