Solucionar problemas de recargas inesperadas no Cisco IOS®/Cisco IOS® Plataformas XE com TAC.

Introduction

Este documento descreve os arquivos necessários para determinar a causa de uma recarga inesperada no Cisco IOS®/Cisco IOS XE e carregá-los em um caso do TAC. As implantações de SDWAN não são discutidas.

Prerequisites

Requirements

• Este documento se aplica aos roteadores e switches Cisco que executam o software Cisco IOS/Cisco IOS XE.
• Para coletar os arquivos descritos neste documento, o dispositivo deve estar ativo e estável. 
• Para extrair os arquivos através do protocolo de transferência, é necessário um servidor (com aplicativo/serviço de transferência de arquivos instalado) com acessibilidade L3.
• O console ou a conexão remota via SSH/Telnet com o dispositivo é necessária.

Note: Em um evento de recarregamento inesperado, é possível que alguns arquivos não sejam gerados com base na natureza do recarregamento e da plataforma.

Mostrar arquivos de suporte técnico

A saída do comando show tech-support inclui informações gerais sobre o status atual do dispositivo (memória e utilização da CPU, registros, configuração, etc.) e informações sobre os arquivos criados relacionados a quando ocorreu o evento inesperado de recarregamento.

No caso de uma reinicialização inesperada, os pontos principais a serem revisados são:

• A versão atual do Cisco IOS/Cisco IOS XE instalada no dispositivo.
• Configuração do sistema com detalhes de portas, placas e módulos.
• Presença de arquivos adicionais para fornecer uma análise de causa básica nos sistemas de arquivos.

A saída show tech-support pode ser capturada de duas maneiras diferentes: registrar uma sessão de terminal ou criar um arquivo no armazenamento e transferi-lo do dispositivo:

Registrar uma sessão de terminal

Em Putty, navegue até Session > Logging e selecione dentro da guia Session logging, selecione a opção All session output, como mostrado nesta imagem. 

O arquivo é armazenado na pasta Putty por padrão com o nome putty.log. A pasta e o nome do arquivo podem ser alterados com o botão Procurar.

Quando a configuração for concluída, a sessão Putty deverá ser conectada ao dispositivo por meio do Console, Telnet ou SSH.

Na sessão do dispositivo, é aconselhável definir o comando terminal length 0 no modo privilegiado e, em seguida, usar o comando show tech-support .

# terminal length 0
# show tech-support

Note: A execução do comando pode levar alguns segundos. Não interrompa a execução.

Criar um arquivo no armazenamento

Um arquivo show tech-support pode ser criado no dispositivo e armazenado em um dos sistemas de arquivos de armazenamento (interno ou externo). A sintaxe do comando permanece a mesma em todos os dispositivos, mas o sistema de arquivos usado pode ser alterado. O arquivo também pode ser criado diretamente em um servidor externo. Esta seção mostra a sintaxe de um sistema de arquivos local.

Para criar o arquivo dentro da memória flash, é necessário usar o comando show tech-support | redirecionar flash:Showtech.txt no modo privilegiado:

# show tech-support | redirect flash:Showtech.txt

O terminal não pode ser usado por alguns segundos enquanto o arquivo de texto é gerado. Depois de concluído, você pode verificar se a criação do arquivo está correta com o comando show [file system]: comando; como o arquivo é um arquivo de texto simples, o conteúdo pode ser exibido no dispositivo com mais comandos.

# show flash:
# more flash:Showtech.txt

Depois que o arquivo é criado, ele pode ser extraído para um armazenamento externo com um protocolo de transferência escolhido (FTP/TFTP/SCP) e compartilhado para análise.

Arquivo Crashinfo

O arquivo crashinfo é um arquivo de texto, que inclui detalhes de depuração que ajudariam a identificar o motivo do travamento. O conteúdo pode variar de plataforma para plataforma. Em geral, ele tem o buffer de registro antes do travamento e as funções que foram executadas pelo processador, antes do travamento em um modo codificado. Nas plataformas Cisco IOS, esse é o arquivo mais comum que pode ser encontrado nos sistemas de arquivos após o travamento. Nas plataformas Cisco IOS XE, esse arquivo é gerado quando o travamento acontece somente no processo IOSd; se qualquer outro processo falhar, o dispositivo não cria um arquivo crashinfo.

Os arquivos crashinfo podem ser encontrados em armazenamento flash, bootflash, hardware ou crashinfo na base da plataforma. No caso de plataformas de plano de controle redundantes, os arquivos de travamento podem ser encontrados no supervisor ativo e/ou em standby.

O conteúdo desse arquivo é limitado, pois ele apenas tira um ajuste da memória DRAM antes da reinicialização inesperada e da região da memória dos processos. Arquivos/saídas adicionais podem ser necessários para identificar a causa raiz da reinicialização em alguns casos.

Arquivos principais

Nas plataformas Cisco IOS XE, quando um processo ou serviço termina sua execução devido a um erro de tempo de execução (e causa uma reinicialização inesperada), um arquivo central é criado. Este arquivo contém informações de contexto sobre o evento de recarregamento.

Nas plataformas Cisco IOS XE, ele é gerado por padrão quando a reinicialização inesperada é orientada por software. Os arquivos principais podem ser criados em qualquer processo Linux (processos IOSd incluídos).

Os arquivos principais são arquivos compactados que contêm as informações de toda a memória em execução usada pelo processo específico que disparou o travamento. Este arquivo requer ferramentas especiais para decodificar, portanto, para manter sua consistência, é necessário extrair o arquivo sem qualquer alteração. Descompactar o arquivo ou extrair as informações como texto (como com mais comandos), não permite a capacidade de decodificar o conteúdo pela equipe de suporte.

Os arquivos principais geralmente são armazenados na pasta central, dentro do flash de inicialização ou disco rígido.

A seguir, um exemplo que mostra como o arquivo corefile aparece dentro da pasta central no sistema de arquivos bootflash:

------------------ show bootflash: all ------------------

 9   10628763 Jul 14 2021 09:58:49 +00:00 /bootflash/core/Router_216_Router_RP_0_ucode_pkt_PPE0_3129_1626256707.core.gz
10   10626597 Jul 23 2021 13:35:26 +00:00 /bootflash/core/Router_216_Router_RP_0_ucode_pkt_PPE0_2671_1627047304.core.gz

Note: Para que o TAC analise o Corefile com êxito, é necessário extrair os arquivos sem qualquer modificação ou alteração.

Para verificar a maneira de extrair esse arquivo do dispositivo, navegue até a seção Extrair arquivos.

Tracelogios

Os rastreamentos são logs internos de cada processo no Cisco IOS XE. O diretório tracelogs é criado por padrão e seu conteúdo é substituído periodicamente. Esta pasta pode ser encontrada no flash de inicialização ou no disco rígido.

A pasta pode ser removida com segurança, embora não seja recomendado, pois pode fornecer informações adicionais no caso de um evento de recarregamento inesperado.

Para extrair o conteúdo da pasta, a abordagem mais fácil é criar um arquivo compactado que inclua todos os arquivos tracelogs. Com base na plataforma, você pode usar estes comandos:

Para roteadores Cisco IOS XE:

# request platform software trace slot rp active archive target bootflash:TAC_tracelogs 

Para switches e controladores sem fio Cisco IOS XE:

# request platform software trace archive target bootflash:TAC_tracelogs

Os registros de rastreamento são arquivos codificados que exigem ferramentas adicionais para decodificar, portanto, é necessário extrair o arquivo compactado à medida que ele é criado.

Para verificar a maneira de extrair esse arquivo do dispositivo, navegue até a seção Extrair arquivos.

Relatórios do sistema

Um relatório do sistema é um arquivo compactado que coleta a maioria das informações disponíveis na execução do software quando ocorre uma recarga inesperada. O relatório do sistema contém rastreamentos, informações de travamento e arquivos principais. Esse arquivo é criado no caso de uma recarga inesperada em switches Cisco IOS XE e controladores sem fio.

O arquivo pode ser encontrado no diretório principal do flash de inicialização ou do disco rígido.

Ele sempre contém os rastreamentos gerados logo antes da reinicialização. No caso de um recarregamento inesperado, ele tem arquivos de travamento e arquivos principais do evento.

Este arquivo é compactado, a pasta pode ser descompactada, mas requer ferramentas adicionais para decodificar as informações.

Para verificar a maneira de extrair esse arquivo do dispositivo, navegue até a seção Extrair arquivos.

Núcleos do kernel

Os núcleos do kernel são criados pelo Kernel do Linux e não pelos processos do Cisco IOS XE. Quando um dispositivo é recarregado devido a uma falha de kernel, geralmente é criado um núcleo de kernel completo (arquivo compactado) e um resumo dos arquivos de núcleo de kernel (texto simples).

Os processos que levaram à reinicialização inesperada podem ser revisados, mas é sempre recomendável fornecer o arquivo ao Cisco TAC para fornecer uma análise completa do motivo do recarregamento.

Os arquivos do núcleo do kernel podem ser encontrados no diretório principal do flash de inicialização ou do disco rígido. 

Como extrair arquivos

Esta seção descreve a configuração básica necessária para transferir os arquivos necessários da plataforma Cisco IOS/Cisco IOS XE para um cliente de armazenamento externo.

Espera-se que a acessibilidade do dispositivo ao servidor esteja disponível. Se necessário, confirme se não há nenhum firewall ou configuração que bloqueie o tráfego do dispositivo para o servidor.

Não é recomendado nenhum aplicativo de servidor específico nesta seção.

TFTP

Para transferir um arquivo sobre TFTP, é necessário definir a acessibilidade para o aplicativo de servidor TFTP. Nenhuma configuração adicional é necessária.

Por padrão, alguns dispositivos têm a configuração ip tftp source interface ativa através da interface de gerenciamento. Se o servidor não puder ser alcançado através da interface de gerenciamento, execute o comando para remover esta configuração:

(config)# no ip tftp source interface

Uma vez concluída a configuração para acessar o servidor, para transferir o arquivo, você pode executar estes comandos:

#copy 
     
     :<file> tftp:
Address or name of remote host []? X.X.X.X
Destination filename [<file>]?

FTP

Para transferir um arquivo por FTP, é necessário definir a acessibilidade para o aplicativo FTP server. É necessário configurar o nome de usuário e a senha FTP do dispositivo e do aplicativo de servidor FTP. Para definir as credenciais no dispositivo, execute estes comandos:

(config)#ip ftp username username
(config)#ip ftp password password 

Opcionalmente, você pode configurar uma interface de origem de FTP no dispositivo com estes comandos:

(config)# ip ftp source interface interface

Quando a configuração para acessar o servidor estiver concluída, para transferir o arquivo, execute o seguinte comando:

#copy 
     
     :<file> ftp:
Address or name of remote host []? X.X.X.X
Destination filename [<file>]?

SCP

Para transferir um arquivo sobre SCP, é necessário definir a acessibilidade para o aplicativo de servidor SCP. É necessário configurar o nome de usuário e a senha locais no dispositivo (as credenciais são necessárias para iniciar a transferência) e no aplicativo de servidor SCP. Também é necessário ter o SSH configurado no dispositivo. Para confirmar se o serviço SSH está configurado, execute o comando:

#show running-config | section ssh
ip ssh version 2
ip ssh server algorithm encryption 3des-cbc aes128-ctr aes192-ctr aes256-ctr
ip ssh client algorithm encryption 3des-cbc aes128-ctr aes192-ctr aes256-ctr
transport input ssh
transport input ssh

Para definir as credenciais no dispositivo, execute o comando:

(config)#username USER password PASSWORD

Note: Caso TACACS ou outro serviço seja usado para autenticação de usuário SSH, essas credenciais podem ser usadas se o servidor SCP também tiver as informações de usuário.

Uma vez concluída a configuração, para transferir o arquivo, você pode executar estes comandos:

#copy 
     
     :<file> scp:
Address or name of remote host []? X.X.X.X
Destination filename [<file>]?

USB

A transferência de arquivos através da flash USB não exige acessibilidade para nenhum servidor externo na rede, mas exige acesso físico ao dispositivo.

Todos os dispositivos físicos com Cisco IOS/Cisco IOS XE têm portas USB que podem ser usadas como armazenamento externo.

Para confirmar se a unidade flash USB é reconhecida, execute o comando show file systems:

#show file systems
File Systems:

	Size(b) 	Free(b) 	Type 	Flags 	Prefixes
		- 	- 		opaque 	rw 	system:
		- 	- 		opaque 	rw 	tmpsys:
* 	11575476224 	10111098880 	disk 	rw 	bootflash: flash: 
	2006351872 	1896345600 	disk 	ro 	webui:
		- 	- 		opaque 	rw 	null:
		- 	- 		opaque 	ro 	tar:
		- 	- 		network rw 	tftp:
	33554432 	33527716 	nvram 	rw 	nvram:
		- 	- 		opaque 	wo 	syslog:
		- 	- 		network rw 	rcp:
		- 	- 		network rw 	pram:
		- 	- 		network rw 	http:
		- 	- 		network rw 	ftp:
		- 	- 		network rw 	scp:
		- 	- 		network rw 	sftp
		- 	- 		network rw 	https:
		- 	- 		network ro 	cns:
	2006351872	1896345600	disk	rw	usbflash0:

Observação: os dispositivos Cisco IOS/Cisco IOS XE suportam unidades flash USB oficiais da Cisco. Para qualquer flash USB de terceiros, o suporte é limitado.

Quando a memória flash USB for reconhecida pelo dispositivo no slot apropriado (usbflash0 ou usbflash1) e houver espaço livre suficiente disponível, use estes comandos para transferir o arquivo:

#copy 
     
     :<file> usbflashX:
Destination filename [<file>]?

Troubleshoot

Esta seção descreve alguns dos erros e soluções comuns que podem ser encontrados e usados durante a transferência de arquivos (de um dispositivo Cisco IOS ou Cisco IOS XE) para um método externo.

Confirmar portas abertas

Se o dispositivo mostrar um erro de conexão recusada quando a acessibilidade ao servidor foi confirmada, pode ser útil verificar se as portas no lado do dispositivo estão disponíveis (nenhuma entrada de ACL que bloqueia o tráfego) e se as portas no lado do servidor também estão disponíveis (para a última parte, o comando telnet com a porta necessária pode ser usado).

Com base no protocolo usado, execute estes comandos:

TFTP
#telnet X.X.X.X 69

FTP
#telnet X.X.X.X 21

SCP
#telnet X.X.X.X 22

Note: As portas anteriores são as portas padrão de cada protocolo, é possível alterar essas portas.

Se o comando não fornecer uma porta aberta bem-sucedida, é útil confirmar qualquer erro de configuração (do lado do servidor ou de qualquer firewall no caminho) que possa descartar o tráfego.

Formato USB

O USB de terceiros não pode ser reconhecido para a maioria dos dispositivos Cisco IOS e Cisco IOS XE.

O USB maior que 4 GB não pode ser reconhecido por roteadores e switches Cisco IOS. O USB com tamanho maior que 4 GB pode ser reconhecido pelas plataformas Cisco IOS XE.

No caso de um USB de terceiros, ele pode ser testado com formatação FAT32 ou FAT16. Nenhum outro formato pode ser reconhecido mesmo para uma unidade de memória USB compatível.

Interrupções de transferência

É possível que a transferência de arquivos possa ser interrompida e necessária para iniciar a transferência novamente para servidores com muitos saltos.

Neste cenário, pode ser útil usar esta configuração nas linhas vty:

(config)#line vty 0 4
(config-line)#exec-timeout 0 0

A configuração anterior garante que a sessão de transferência não seja descartada, mesmo que o pacote de controle seja descartado no caminho ou o pacote leve muito tempo para ser reconhecido.

Após a conclusão da transferência, é recomendável remover essa configuração das linhas vty.

É sempre recomendável colocar o servidor de arquivos o mais perto possível do dispositivo.

Servidor TFTP intermediário.

Os dispositivos Cisco podem ser usados como um servidor TFTP temporal para transferências que não podem ser feitas diretamente para um servidor de arquivos local.

No dispositivo (com o arquivo que requer extração), você pode executar o comando:

(config)#tftp-server 
     
     :<file>

No dispositivo configurado como um cliente, você pode executar os comandos que aparecem na seção TFTP.