Coletando informações de suporte para Intel® Ethernet Fabric Suite problemas

Documentação

Solução de problemas

000088354

16/11/2021

Como eu uso o comando ethcapture comando?

O ethcapture captura informações críticas do sistema em um arquivo de piche zipped. O arquivo tar resultante deve ser enviado para o Suporte ao Cliente juntamente com qualquer relatório Ethernet Intel® de problemas de malha relacionados a este sistema.

Nota

O arquivo de captura de host resultante pode exigir quantidades significativas de espaço no host. O tamanho real varia, mas os tamanhos podem ser múltiplos megabytes. A Intel recomenda garantir que o espaço em disco adequado está disponível no sistema host.

Sintaxe: ethcapture [-d detail] output_tgz_file

Opções:

--help: produz texto de ajuda total.

-d detail: captura o nível de detalhes:

1 (local): obtém informações locais do host. Este é o padrão se nenhuma opção for inserida.

2 (malha): além do Local, também obtém informações básicas de malha por consultas ao SM e análise de erros de malha usando ethreport.

3 (Análise): além da Fabric, também obtém resultados de ethallanalysis. Se ethallanalysis ainda não foi executado, ele é executado como parte da captura.

Nota

Os níveis de detalhes 2 a 3 podem ser usados quando ocorrerem problemas operacionais de malha. Se o problema for específico do nó, o nível de detalhes 1 deve ser suficiente. Os níveis de detalhes de 2 a 3 exigem uma malha operacional. Normalmente, seu representante de suporte solicita um determinado nível de detalhes. Se um determinado nível de detalhes levar muito tempo ou não for reunido, tente um nível de detalhes mais baixo. Para níveis de detalhes de 2 a 3, as informações adicionais estão disponíveis apenas em um nó com Intel® Ethernet Fabric Suite FastFabric Toolset instalado.

output_tgz_file: especifica o nome de um arquivo a ser criado pelo ethcapture. O nome do arquivo especificado é sobregravado se ele já existir. A Intel recomenda usar o sufixo .tgz no nome do arquivo fornecido. Se o nome do arquivo fornecido não tiver um sufixo .tgz, o sufixo .tgz é adicionado.

Exemplos:

ethcapture mycapture.tgz
ethcapture -d 3 030127capture.tgz

 

Como eu uso o comando ethpacaptureall comando?

O ethcaptureall captura informações de suporte para um relatório de problemas de todos os hosts e uploads para este sistema.

Quando um ethcaptureall host é executado, o ethcapture é executado para criar o arquivo de captura especificado em ~root em cada host (com o sufixo .tgz adicionado conforme necessário). Os arquivos são carregados e desempacodados em um nome de diretório correspondente upload_dir/hostname/ no sistema local. O nome do arquivo padrão é hostcapture.

As capturas carregadas são combinadas em um arquivo .tgz com o nome do arquivo especificado e o sufixo .all.tgz adicionado.

Opções:

--help: produz texto de ajuda total.

-p: executa o upload de captura em paralelo em todos os hosts.

-f hostfile: especifica o arquivo com hosts no cluster. O padrão é /etc/ethtools/hosts arquivo.

-h hosts: especifica a lista de hosts em que realizar uma captura.

-d upload_dir: especifica o diretório para o qual carregar. O padrão é uploads. Se não especificado, a variável de ambiente UPLOADS_DIR é usada.

-D detail_level: especifica o nível de detalhes da captura passada para o host ethcapture.

1 (local): obtém informações locais de cada host.

2 (Malha): além do Local, também obtém informações básicas de malha por consultas à análise de erros de malha e malha usando ethreport.

3 (Análise): além do Fabric, também obtém ethallanalysis resultados. Se ethallanalysis ainda não foi executado, ele é executado como parte da captura.

Nota

Para os níveis de detalhes 2 a 3, as informações adicionais são coletadas apenas no nó executando o comando ethcaptureall comando.

file: especifica o nome do arquivo de captura. O sufixo .tgz é anexado se ele não estiver especificado no nome.

Exemplos:

ethcaptureall
# Creates a hostcapture directory in upload_dir/hostname/ for each host in
/etc/eth-tools/hosts file, then creates hostcapture.all.tgz.

ethcaptureall mycapture
# Creates a mycapture directory in upload_dir/hostname/ for each host in
/etc/eth-tools/hosts file, then creates mycapture.all.tgz.

ethcaptureall -h 'arwen elrond' 030127capture
# Gets the list of hosts from arwen elrond file and creates
030127capture.tgz file.

Variáveis de ambiente

As seguintes variáveis de ambiente também são usadas por este comando:

  • HOSTS: lista de hosts, usada se -h opção não fornecida.
  • HOSTS_FILE: arquivo contendo uma lista de hosts, usado na ausência de -f e -h.
  • UPLOADS_DIR: diretório para carregar, usado na ausência de -d.
  • FF_MAX_PARALLEL: quando a opção -p for usada, as operações simultâneas máximas são realizadas.

Mais informações

Ao executar ethcaptureall em hosts, o SSH interno é usado. O comando ethcaptureall requer que o SSH sem senha seja configurado entre o host executando Intel® Ethernet Fabric Suite FastFabric Toolset e os hosts ethcaptureall estão operando. O ethsetupssh pode ajudar na configuração de SSH sem senha.

Nota

Os arquivos de captura de host resultantes podem exigir quantidades significativas de espaço no host Intel® Ethernet Fabric Suite FastFabric Toolset. O tamanho real varia, mas os tamanhos podem ser múltiplos megabytes por host. A Intel recomenda que você garanta que o espaço adequado esteja disponível no sistema Intel® Ethernet Fabric Suite FastFabric Toolset. Em muitos casos, pode não ser necessário executar ethcaptureall todos os hosts; em vez disso, um subconjunto representativo pode ser suficiente. Consulte seu representante de suporte para obter mais informações.