Sistema operativo Dell Networking SONiC: come generare un supporto tecnico nelle versioni 3.X

Sommario

• Che cos'è il file di supporto tecnico?
• Come generare un file del supporto tecnico
• Posizione del file del supporto tecnico
• Come recuperare il file del supporto tecnico dallo switch
  • USB
  • Server SCP remoto
  • Applicazione client SCP
• Formato del nome file del supporto tecnico
• Come limitare le voci precedenti e ridurre le dimensioni del file del supporto tecnico
• Elimina il vecchio file del supporto tecnico per risparmiare spazio

Che cos è un file di supporto tecnico

Il file del supporto tecnico è un file di archivio compresso costituito da informazioni sullo stato dello switch come Syslog, stato del database e così via. Gli agenti del supporto tecnico Dell necessitano di un file del supporto tecnico per un analisi dettagliata.

• Provare a generare un file del supporto tecnico in stato di problema
• Il file del supporto tecnico è un file compresso e viene salvato in /var/dump
• Il file del supporto tecnico ha l'estensione ".tar.gz"
• La generazione dei file del supporto tecnico può richiedere più di 15-30 minuti a seconda della durata del registro

Come generare un file del supporto tecnico

Sintassi dei comandi

Output di esempio

admin@DELLSONiC:~$ sonic-cli
DELLSONiC#
DELLSONiC# show tech-support
Output stored in:  /var/dump/sonic_dump_DELLSONiC_20230419_043803.tar.gz
DELLSONiC#

Uscire e accedere all'interfaccia della riga di comando di Dell SONiC per controllare il file generato dal supporto tecnico ed eliminare i file del supporto tecnico precedenti.

DELLSONiC#
DELLSONiC# exit
admin@DELLSONiC:~$

Posizione del file del supporto tecnico

Il file del supporto tecnico viene salvato in /var/dump.

admin@DELLSONiC:~$ dir /var/dump/
sonic_dump_DELLSONiC_20230419_043803.tar.gz
admin@DELLSONiC:~$ 

Come recuperare il file del supporto tecnico dallo switch

È possibile copiare il file del supporto tecnico in un server SFTP/SCP remoto, in qualsiasi applicazione SCP come WINSCP o in un dispositivo USB inserito nello switch. Di seguito menzioniamo tre metodi.

USB
Utilizzare USB con formato FAT32.
Output di esempio

admin@DELLSONiC:~$sudo mkdir /mnt/usb
admin@DELLSONiC:~$sudo mount /dev/sdb1 /mnt/usb
admin@DELLSONiC:~$sudo cp /var/dump/sonic_dump_DELLSONiC_20230419_043803.tar.gz /mnt/usb/sonic_dump_DELLSONiC_20230419_043803.tar.gz

Sintassi dei comandi

Server
SCP remotoPer la copia su un server SCP remoto, utilizzare la sintassi seguente:

scp /var/dump/sonic_dump_DELLSONiC_20230419_043803.tar.gz username@<Ip address or hostname of scp server>:/<path>

admin@DELLSONiC:~$ scp /var/dump/sonic_dump_DELLSONiC_20230419_043803.tar.gz username@10.0.0.1:/home/admin/                       
username@10.0.0.1's password:

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.

Formato del nome file del supporto tecnico

Il file del supporto tecnico ha un nome in formato.

sonic_dump_<Hostname>_ _YYYYMMDD_HHMMSS.tar.gz

Ad esempio, sonic_dump_DELLSONiC_20230419_043803.tar.gz è il file del supporto tecnico generato dove YYYYMMDD_HHMMSS è 20230419_043803 e DELLSONiC è il nome host dello switch.

Come limitare le voci precedenti e ridurre le dimensioni del file del supporto tecnico

Il file di supporto tecnico può essere un file di grandi dimensioni basato sull'uptime dello switch. È possibile ridurre le dimensioni del supporto tecnico diminuendo la quantità di Syslog utilizzando l'opzione since .

show tech-support since <date/time>

Formato della data e dell'ora
" AAAA-MM-GGTHH:MM:SS[.ddd...]Z" o
"AAAA-MM-GGTHH:MM:SS[.ddd...]+hh:mm" o
"AAAA-MM-GGTHH:MM:SS[.ddd...]-hh:mm" Dove:

AAA = anno, MM = mese, GG = giorno,T
(obbligatorio prima dell'ora),
HH = ore, MM = minuti, SS = secondi,
(opzionale) .ddd... = frazione decimale di secondo (ad esempio ".323")
Z indica uno scostamento zero dall'ora locale.
+/- hh:mm indica la differenza di ore/minuti rispetto all'ora locale.

Per esempio

DELLSONiC# show tech-support since "2023-04-18T19:31:00Z"
Output stored in: /var/dump/sonic_dump_DELLSONiC_20230419_043803.tar.gz

Si consiglia di acquisire fino alle 0 ore del giorno precedente per eventuali azioni preventive prima dell'evento.

DELLSONiC# show tech-support since "2023-04-18T00:00:00Z"

Elimina il vecchio file del supporto tecnico per risparmiare spazio

È possibile eliminare in modo sicuro il file del supporto tecnico o la cartella dump dopo aver estratto il file dallo switch. Se è necessario generare un nuovo file del supporto tecnico, viene creata una nuova cartella dump in var.

Per rimuovere file specifici, utilizzare:

sudo rm /var/dump/<techsupportfile>.tar.gz

Output di esempio

admin@DELLSONiC:~$ ^C
admin@DELLSONiC:~$ sudo rm -r /var/dump/sonic_dump_DELLSONiC_20230419_043803.tar.gz
admin@DELLSONiC:~$

Per rimuovere la cartella /var/dump:

sudo rm -r /var/dump

Output di esempio

admin@DELLSONiC:~$ sudo rm -r /var/dump
admin@DELLSONiC:~$

Checking
admin@DELLSONiC:~$ ls /var/dump
ls: cannot access '/var/dump': No such file or directory
admin@DELLSONiC:~$