Dell Networking SONiC – Como gerar e coletar o arquivo de suporte técnico

摘要: Este artigo explica como gerar e coletar o arquivo de suporte técnico no Dell Networking SONiC versão 4.0 ou posterior.

本文适用于 本文不适用于 本文并非针对某种特定的产品。 本文并非包含所有产品版本。
查看其他资源

说明

Índice

O que é o arquivo de suporte técnico?
Sintaxe de comando
Como gerar o arquivo de suporte técnico no Dell SONiC
Como monitorar o status de geração do arquivo de suporte técnico
Como recuperar o arquivo de suporte técnico a partir do switch
      FTP
      HTTP
      USB
      Aplicativo client do SCP
Nome e formato do arquivo de suporte técnico
Como restringir as entradas antigas e reduzir o tamanho do arquivo de suporte técnico
Como excluir o arquivo antigo de suporte técnico para economizar espaço.

O que é o arquivo de suporte técnico

O arquivo de suporte técnico é um arquivo compactado, composto por informações sobre o estado do switch, como o Syslog, o estado do banco de dados, o dump de núcleo, entre outros. Os agentes de suporte técnico Dell precisam de um arquivo de suporte técnico para poderem fazer a análise detalhada de um evento.

  • O arquivo de suporte técnico é um arquivo compactado, salvo em /var/dump. O conteúdo dessa pasta pode ser visualizado usando o comando: 
    dir tech-support:/
  • O arquivo de suporte técnico tem a extensão .tar.gz
  • A geração do arquivo de suporte técnico pode levar de 15 a 30 minutos.
  • O tamanho do arquivo varia de acordo com os dados e o período de tempo das amostras de log. Para reduzir o tamanho, podemos usar a opção "since"
  • Se possível, tente gerar um arquivo de suporte técnico no estado do problema
Nota: Para obter uma versão mais antiga, consulte Dell Networking SONiC OS – Como gerar um arquivo de suporte técnico nas versões 3.X

Sintaxe de comando

COMANDO EXPLICAÇÃO
admin@sonic:~$ sonic-cli Entrar no Dell SONiC.
sonic# show tech-support Gerar um arquivo de suporte técnico.
sonic# show tech-support status Mostrar status de geração do arquivo de suporte técnico.
sonic# dir tech-support:/ Mostrar o conteúdo do diretório /var/dump, onde o arquivo de suporte técnico foi gerado.
sonic# copy tech-support://<filename> ftp/home/http/scp/usb://<filename> Copiar um arquivo de suporte técnico para um local remoto usando um diretório base, usb ou protocolo ftp, http ou scp

Opcional

COMANDO EXPLICAÇÃO
sonic# show tech-support since <date/time> Gerar um arquivo de suporte técnico a partir de uma data e hora. Clique aqui para obter mais informações.
sonic# delete tech-support:/ <filename> Excluir o arquivo antigo de suporte técnico. Isso economiza espaço em flash.

Como gerar o arquivo de suporte técnico no Dell SONiC

Use o comando "show tech-support" para gerar um arquivo de suporte técnico.

Exemplo

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#

Como monitorar o status de geração do arquivo de suporte técnico

Use o comando "show tech-support status" para monitorar o status de geração do arquivo de suporte técnico. O resultado mostra o "Status: Completed" quando a geração do arquivo é concluída.
Use o comando "dir tech-support:/" para ver o conteúdo da pasta /var/tmp. O arquivo de suporte técnico é gerado nessa pasta.

Veja abaixo um exemplo de saída de "show tech-support status" e "dir tech-support:/"

Durante a geração do arquivo de suporte técnico:

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

Depois de a geração do arquivo de suporte técnico ser concluída com sucesso.

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

Como recuperar o arquivo de suporte técnico a partir do switch

Use o comando "copy tech-support://<tech-support filename> <destination>//<filename>" para copiar o arquivo de suporte técnico para o diretório base, usb ou servidor ftp/http/scp remoto.

Veja abaixo as opções de destino disponíveis e os respectivos usos.

  • ftp: Copiar para o servidor FTP remoto (ftp://userid:passwd@hostip/filepath)
  • home: Copiar para o diretório base (home://filename)
  • http: Copiar para o servidor HTTP remoto (http://hostip/filepath)
  • scp: Copiar para o servidor SCP remoto (scp://userid:passwd@hostip/filepath)
  • usb: Copiar para o diretório de mídia USB (usb://filename)
Nota: O comando "tech-support://" em "copy" não é preenchido automaticamente. Portanto, digite o caminho completo manualmente.

Explicaremos as opções abaixo com um exemplo.

FTP
Para copiar um arquivo para um servidor FTP remoto, use a seguinte sintaxe.

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

Considere que estamos copiando o arquivo de suporte técnico para um servidor FTP remoto com IP 10.0.0.1, nome de usuário: TEST e senha PASS

Exemplo de saída

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
Para copiar um arquivo para um servidor HTTP remoto, use a seguinte sintaxe.

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

Considere que estamos copiando o arquivo de suporte técnico para um servidor HTTP remoto com IP 10.0.0.1.

Exemplo de saída

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

USB
Para usar USB no DELL SONiC, em um switch de rede, devemos garantir que o comando "usb enable" esteja configurado. Por padrão, o USB fica desativado.
Execute o comando "usb mount" depois de inserir o USB no switch.

Dell Networking SONiC – Como montar e desmontar um USB

Exemplo de saída

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

Aplicativo client SCP
Você pode usar qualquer aplicativo client SCP para extrair o arquivo de suporte técnico no switch.
Use as credenciais de login do switch no aplicativo client SCP para fazer login no switch. O arquivo de suporte técnico fica localizado no diretório /var/dump/.
Alguns aplicativos client SCP têm uma interface gráfica que torna ainda mais fácil copiar um arquivo do switch /var/dump/ para uma pasta em sua máquina local.

Nome e formato do arquivo de suporte técnico

O arquivo de suporte técnico tem um nome no formato "sonic_dump_<Hostname>_ _YYYYMMDD_HHMMSS.tar.gz"
*YYYYMMDD_HHMMSS refere-se a Ano Mês Dia_Hora Minuto Segundo. Este é o momento da geração do arquivo de suporte técnico.

Por exemplo, "sonic_dump_DELLSONiC_20230415_202048.tar.gz" é o arquivo de suporte técnico gerado. Aqui, YYYYMMDD_HHMMSS é 20230415_202048, e DELLSONiC é o nome do host do switch.

Como restringir as entradas antigas e reduzir o tamanho do arquivo de suporte técnico

O arquivo de suporte técnico pode ser um arquivo grande, conforme o tempo de funcionamento do switch. No Dell SONiC, podemos reduzir o tamanho do arquivo limitando a duração do log.

Use o comando "show tech-support since <date/time>" para capturar o arquivo de suporte técnico de um período específico.

Exemplo de saída

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

Recomenda-se capturar até a hora 0 do dia anterior para verificar qualquer possível ação precedente ao evento.

Exemplo de saída

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

Sintaxe de comando

Comando Explicação
sonic# show tech-support since <date/time> Veja abaixo o formato de data/hora.

 "YYYY-MM-DDTHH:MM:SS[.ddd…]Z" ou
 "YYYY-MM-DDTHH:MM:SS[.ddd…]+hh:mm" ou
 "YYYY-MM-DDTHH:MM:SS[.ddd…]-hh:mm". Em que:

 AAAA = ano, MM = mês, DD = dia,
 T (obrigatório antes do tempo),
 HH = horas, MM = minutos, SS = segundos,
 (opcional) .ddd... = fração decimal de um segundo (por exemplo, ".323")
 Z indica um desvio de zero da hora local.
 +/- hh:mm indica um desvio de hora:minuto da hora local.

Como excluir o arquivo antigo de suporte técnico para economizar espaço

Podemos excluir com segurança o arquivo de suporte técnico na pasta dump depois de extrair o arquivo do switch.

Use o comando "delete tech-support:/ <techsupport file.tar.gz>" para excluir o arquivo de suporte técnico.

Exemplo de saída

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

Use o comando "dir tech-support:/" para verificar se o arquivo foi excluído.

Exemplo de saída

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

 

受影响的产品

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 ...
文章属性
文章编号: 000212428
文章类型: How To
上次修改时间: 25 2月 2025
版本:  5
从其他戴尔用户那里查找问题的答案
支持服务
检查您的设备是否在支持服务涵盖的范围内。