DELL Networking SONiC Come generare e raccogliere un file di supporto tecnico

Summary: Questo articolo spiega come generare e raccogliere un file di supporto tecnico in Dell Networking SONiC 4.0 e versioni successive.

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Instructions

Indice

Cos'è il file di supporto tecnico?
Sintassi dei comandi
Come generare un file di supporto tecnico in Dell SONiC
Come tenere traccia dello stato di generazione del file di supporto tecnico
Come recuperare il file di supporto tecnico dallo switch
      FTP
      HTTP
      USB
      Applicazione client SCP
Nome e formato del file di supporto tecnico
Come limitare le voci obsolete e ridurre le dimensioni del file di supporto tecnico
Eliminazione del file di supporto tecnico obsoleto per risparmiare spazio.

Cos'è il file di supporto tecnico?

Il file di supporto tecnico è un file di archivio compresso che contiene informazioni sullo stato dello switch, come Syslog, stato del database, core dump e così via. Gli agenti del supporto tecnico Dell necessitano di un file di supporto tecnico per un'analisi dettagliata di un evento.

  • Il file di supporto tecnico è un file compresso e viene salvato in /var/dump. Il contenuto di questa cartella può essere visualizzato utilizzando il comando: 
    dir tech-support:/
  • Il file di supporto tecnico ha l'estensione .tar.gz.
  • La generazione del file di supporto tecnico potrebbe richiedere più di 15-30 minuti.
  • La dimensione del file varia a seconda dei dati e della durata temporale dei campioni di registro. Per ridurre le dimensioni, è possibile utilizzare l'opzione "since".
  • Se possibile, provare a generare un file di supporto tecnico nello stato del problema
NOTA: per una versione precedente, vedere Dell Networking SONiC OS Come generare un file di supporto tecnico nelle release 3.X

Sintassi dei comandi

COMANDO SPIEGAZIONE
admin@sonic:~$ sonic-cli Accedere a Dell SONiC.
sonic# show tech-support Generare un file di supporto tecnico.
sonic# show tech-support status Mostrare lo stato di generazione del file di supporto tecnico.
sonic# dir tech-support:/ Mostrare il contenuto della directory /var/dump in cui viene generato il file di supporto tecnico.
sonic# copy tech-support://<filename> ftp/home/http/scp/usb://<filename> Copiare un file di supporto tecnico in una posizione remota utilizzando il protocollo FTP, HTTP, SCP oppure la directory principale o usb.

Opzionale

COMANDO SPIEGAZIONE
sonic# show tech-support since <date/time> Generare un file di supporto tecnico da una data e un'ora. Cliccare qui per ulteriori informazioni.
sonic# delete tech-support:/ <filename> Eliminare il file di supporto tecnico precedente. In questo modo si risparmia spazio di memoria flash.

Come generare un file di supporto tecnico in Dell SONiC

Utilizzare il comando "show tech-support" per generare un file di supporto tecnico.

Esempio

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#

Come tenere traccia dello stato di generazione del file di supporto tecnico

Utilizzare il comando "show tech-support status" per tenere traccia dello stato di generazione del file di supporto tecnico. L'output mostra Status: Completato quando la generazione del file è terminata.
Utilizzare il comando "dir tech-support:/" per visualizzare il contenuto della cartella /var/tmp. Il file di supporto tecnico viene generato in questa cartella.

Di seguito è riportato un output di esempio di "show tech-support status" e "dir tech-support:/"

Durante la generazione del file di supporto tecnico:

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

Dopo aver completato la generazione del file di supporto tecnico:

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

Come recuperare il file di supporto tecnico dallo switch

Utilizzare il comando "copy tech-support://<tech-support filename> <destination>//<filename>" per copiare il file di supporto tecnico nella directory principale o usb oppure su un server FTP/HTTP/SCP remoto.

Di seguito sono riportate le opzioni di destinazione disponibili e il loro utilizzo.

  • ftp: copia su server FTP remoto (ftp://userid:passwd@hostip/filepath)
  • home: copia nella directory principale (home://filename)
  • http: copia su server HTTP remoto (http://hostip/filepath)
  • scp: copia su server SCP remoto (scp://userid:password@hostip/filepath)
  • usb: copia nella directory multimediale usb (usb://filename)
NOTA: il comando "tech-support://" in "copy"non viene compilato automaticamente. Digitare manualmente il percorso completo.

Le opzioni riportate di seguito vengono illustrate con un esempio.

FTP
Per copiare un file su un server FTP remoto, utilizzare la sintassi seguente.

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

In questo caso, il file di supporto tecnico viene copiato su un server FTP remoto con IP 10.0.0.1, nome utente: TEST e password PASS

Output di esempio

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
Per copiare un file su un server HTTP remoto, utilizzare la sintassi seguente.

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

In questo caso, il file di supporto tecnico viene copiato su un server HTTP remoto con IP 10.0.0.1.

Output di esempio

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

USB
Per utilizzare USB su Dell SONiC in uno switch di rete, è necessario verificare che il comando di abilitazione usb sia configurato. Per impostazione predefinita, il comando usb è disabilitato.
Eseguire il comando di mounting usb dopo aver inserito l'usb nello switch.

Dell Networking SONiC Come eseguire il mounting e l'unmounting dell'USB

Output di esempio

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

Applicazione client SCP
È possibile utilizzare qualsiasi applicazione client SCP per estrarre il file di supporto tecnico nello switch.
Utilizzare le credenziali di accesso dello switch nell'applicazione client SCP per accedere allo switch. Il file di supporto tecnico si trova nella directory /var/dump/.
Alcune applicazioni client SCP hanno un'interfaccia grafica che rende ancora più semplice copiare un file da /var/dump/ sullo switch in una posizione nel computer locale.

Nome e formato del file di supporto tecnico

Il file di supporto tecnico ha un nome in formato"sonic_dump_<Hostname>_ _YYYYMMDD_HHMMSS.tar.gz"
*YYYYMMDD_HHMMSS indica AnnoMeseGiorno_OraMinutiSecondi. Si tratta dell'ora di generazione del file di supporto tecnico.

Ad esempio, "sonic_dump_DELLSONiC_20230415_202048.tar.gz" è il file di supporto tecnico generato. In questo caso, AAAAMMGG_HHMMSS è 20230415_202048 e DELLSONiC è il nome host dello switch.

Come limitare le voci obsolete e ridurre le dimensioni del file di supporto tecnico

Il file di supporto tecnico può essere un file di grandi dimensioni basato sull'uptime dello switch. In Dell SONiC è possibile ridurre le dimensioni del file limitando la durata della registrazione.

Utilizzare il comando "show tech-support since <date/time>" per acquisire il file di supporto tecnico da un determinato momento.

Output di esempio

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

Si consiglia di acquisire fino all'ora 00 del giorno precedente per eventuali azioni preventive prima dell'evento.

Output di esempio

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

Sintassi dei comandi

Comando Spiegazione
sonic# show tech-support since <date/time> Di seguito è riportato il formato per data/ora.

 "YYYY-MM-DDTHH:MM:SS[.ddd…]Z" or
 "YYYY-MM-DDTHH:MM:SS[.ddd…]+hh:mm" or
 "YYYY-MM-DDTHH:MM:SS[.ddd…]-hh:mm", dove:

 YYYY = anno, MM = mese, DD = giorno,
 T (obbligatorio prima dell'ora),
 HH = ore, MM = minuti, SS = secondi,
 (opzionale) .ddd… = frazione decimale di un secondo (ad esempio ".323")
 Z indica uno scostamento zero dall'ora locale.
 +/- hh:mm indica l'offset ore:minuti dall'ora locale.

Eliminazione il file di supporto tecnico precedente per risparmiare spazio

È possibile eliminare in modo sicuro il file di supporto tecnico nella cartella dump dopo aver estratto il file dallo switch.

Utilizzare il comando "delete tech-support:/ <techsupport file.tar.gz>" per eliminare il file di supporto tecnico.

Output di esempio

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

Utilizzare il comando "dir tech-support:/" per verificare se il file è stato eliminato.

Output di esempio

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

 

Affected Products

Enterprise SONiC Distribution, PowerSwitch E3200-ON Series, Dell EMC Networking N3200-ON, PowerSwitch S5212F-ON, PowerSwitch S5224F-ON, PowerSwitch S5232F-ON, PowerSwitch S5248F-ON, PowerSwitch S5296F-ON, PowerSwitch Z9100-ON, PowerSwitch Z9264F-ON , PowerSwitch Z9332F-ON, PowerSwitch Z9432F-ON ...
Article Properties
Article Number: 000212428
Article Type: How To
Last Modified: 25 Feb 2025
Version:  5
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.