Criando dumps centrais

Introdução

Este documento explica as várias opções que você pode usar para ativar dumps principais no software Cisco IOS®.

Observação: pode ser difícil obter os dumps principais. Somente a equipe técnica da Cisco que tem acesso ao código fonte e aos mapas detalhados de memória deve tentar interpretar os dumps principais. Em muitas plataformas, o uso do recurso crashinfo pode tornar os dumps principais desnecessários. Consulte Recuperando Informações do Arquivo Crashinfo para obter mais informações.

Pré-requisitos

Requisitos

A Cisco recomenda que você tenha conhecimento destes tópicos:

• Troubleshooting de Travamentos de Roteador

Componentes Utilizados

As informações neste documento são baseadas nestas versões de software e hardware:

• Software Cisco IOS versão 12.0 e posterior

As informações neste documento foram criadas a partir de dispositivos em um ambiente de laboratório específico. Todos os dispositivos utilizados neste documento foram iniciados com uma configuração (padrão) inicial. Se a sua rede estiver ativa, certifique-se de que entende o impacto potencial de qualquer comando.

Conventions

Consulte as Convenções de Dicas Técnicas da Cisco para obter mais informações sobre convenções de documentos.

Como criar despejos de núcleo

Quando um roteador travar, lembre-se de obter uma cópia de todo o conteúdo de memória do roteador, que é conhecido como dump central. Seu representante de suporte técnico usa o dump central para identificar a causa do travamento. O roteador grava o conteúdo da memória no servidor antes de recarregar. Nem todos os travamentos produzem um dump central. Para obter mais detalhes, consulte Tipos de travamento.

Sempre capture os logs do console quando o roteador tentar fazer dump de um núcleo. Os logs de console fornecem informações sobre o travamento. Além disso, o ROM Monitor (ROMMON) normalmente imprime informações no console (e somente no console) no momento do travamento.

Cuidado: os dumps principais não são necessários para resolver a maioria dos casos de travamento. A criação de um dump central enquanto o roteador estiver funcionando em uma rede pode interromper a operação da rede. Use os comandos neste documento somente sob a direção de um representante do suporte técnico.

Configuração básica

Existem quatro maneiras básicas de configurar o roteador de forma a gerar um dump central:

• Por meio do Protocolo de Transferência de Arquivos (FTP)

• Por meio do protocolo de cópia remota (RCP)

• Por meio de um disco flash

• Através do Protocolo de Transferência de Arquivos Trivial (TFTP - Trivial File Transfer Protocol)

Cada um desses métodos usa estes comandos de configuração:

• exception region-size size

  Esse comando especifica o tamanho da região para o pool de memória de tempo de exceção. O pool de memória de tempo de exceção é usado caso a memória do processo fique corrompida. O parâmetro size é expresso em bytes e você pode configurar o tamanho de 1024 a 65536 bytes.

• exception core-file filename [compress]

  Esse comando especifica um nome para o arquivo de dump central diferente do nome default. Para reverter para o nome padrão, use a forma no desse comando.

Para obter mais informações sobre os comandos neste documento, consulte a ferramenta de referência de comandos (somente clientes registrados) .

Use o comando exception region-size para definir uma pequena quantidade de memória para servir como um pool de fallback quando o pool de memória do processador se torna corrompido. Ajuda a evitar falhas de memória durante o processo de dump central. O parâmetro size é expresso em bytes e você pode configurar o tamanho de 1024 a 65536 bytes, com um valor padrão de 16384 bytes. Configure a exception region-size como 65536 bytes para aumentar a chance de um dump central bem-sucedido.

Por padrão, o dump principal da memória do processador é gravado em um arquivo chamado "hostname-core", onde hostname é o nome do roteador, que o comando de configuração hostname define. Se o roteador tiver memória de Entrada/Saída (E/S) (por exemplo, o Cisco 7200), um dump principal de memória de E/S também poderá ser criado, gravado no arquivo "hostname-coreiomem".

Use o comando exception core-file para anular o nome de arquivo de dump central. Se o servidor de arquivos tiver um sistema de arquivos DOS FAT, não especifique um nome de arquivo com mais de seis caracteres. Por exemplo, se você configurar um roteador com "exception core-file foobar", o nome da memória do processador do dump principal será "foobar" e o nome do dump da memória de E/S será "foobario" (suficiente para dar uma dica de que você tem um dump da memória de E/S).

Verifique se há espaço em disco suficiente no servidor de arquivos para armazenar vários dumps principais completos. Você pode compactar arquivos de dump central com a opção compress.

Observação: Compress se aplica automaticamente quando você grava arquivos de dump central no disco Flash. Se você usar RCP, a opção compress não será suportada.

Usar protocolo de transferência de arquivos

Observação: o File Transfer Protocol (FTP) é o método recomendado para configurar um dump central.

Para usar o FTP para configurar o roteador para um dump central, use estes comandos:

• ip ftp username username —Este comando configura o nome de usuário para conexões FTP. Para configurar o roteador para tentar o FTP anônimo, use a forma no desse comando.

• ip ftp password password —Este comando configura a senha para a conexão FTP.

• exception protocol ftp — esse comando configura o protocolo usado para FTP de dump central.

• exception region-size 65536 — esse comando configura o tamanho da região.

• exception dump ip-address — esse comando configura o endereço ip do servidor para o qual o roteador envia o dump principal em caso de um travamento.

Observação: para evitar o congestionamento da rede, a Cisco recomenda que você conecte o roteador diretamente ao servidor FTP, sem saltos intermediários. Se você precisar passar por um ou mais saltos intermediários, talvez precise usar o comando ip ftp source-interface para especificar qual interface usar para acessar o servidor FTP. Consulte Configuração de um Roteador para Usar Conexões FTP para obter mais informações.

Se você não tiver configurado o nome de usuário e a senha, o roteador tentará o FTP anônimo.

Quando um representante de suporte técnico da Cisco solicita arquivos de dump central, você pode enviar os arquivos de dump central para a Cisco por meio de FTP anônimo. O servidor FTP é ftp-sj.cisco.com e o diretório é /incoming.

Observação: o diretório /incoming é invisível.

Certifique-se de definir o modo de transferência como binário. Se os arquivos ainda não estiverem compactados, compacte-os com um utilitário de compactação comum, por exemplo, gzip ou zip.

Certifique-se também de incluir o arquivo crashinfo, se disponível, junto com o dump central. O arquivo crashinfo estará disponível se o hardware ou software suportar esse recurso. Consulte Recuperando Informações do Arquivo Crashinfo para obter instruções sobre como fazer isso.

Certifique-se de que o FTP funcione primeiro. Use este exemplo:

c7500#copy running-config ftp: 
Address or name of remote host []? 172.18.125.3 
Destination filename [c7500-confg]? 
Writing c7500-confg ! 
2781 bytes copied in 0.944 secs 

Usar protocolo de cópia remota

Para usar o RCP para configurar o roteador para um dump central, use estes comandos:

• ip rcmd remote-username username -Este comando configura o nome de usuário remoto para ser usado quando você solicita uma cópia remota através do protocolo de cópia remota (RCP).

• exception protocol rcp — esse comando configura o protocolo usado para dumps principais como RCP.

• exception region-size 65536 — esse comando configura o tamanho da região.

• exception dump ip-address

Se você não tiver configurado o nome de usuário, o roteador usará seu nome de host como o nome de usuário para RCP.

Observação: para evitar o congestionamento da rede, a Cisco recomenda que você conecte o roteador diretamente ao servidor RCP, sem saltos intermediários. Se você precisar passar por um ou mais saltos intermediários, use o comando ip rcmd source-interface para especificar qual interface usar para acessar o servidor RCP. Consulte Configuração de um Roteador para Usar rsh e rcp para obter mais informações.

Certifique-se de que o RCP funcione primeiro. Use este exemplo:

c7500#copy running-config rcp: 
Address or name of remote host []? 172.18.125.3 
Destination username [c7500]? 
Destination filename [c7500-confg]? 
Writing c7500-confg ! 
2781 bytes copied in 0.944 secs 

Usar um disco flash

Algumas plataformas de roteador oferecem suporte ao disco Flash como uma alternativa para a memória Flash linear ou a placa de Flash PCMCIA. A grande capacidade de armazenamento desses discos Flash os torna um bom meio para capturar um dump central. Para obter informações sobre as plataformas de roteador e as versões do software Cisco IOS que suportam o disco Flash, consulte as Release Notes do Cisco IOS .

Observação: Ao capturar um dump central em um disco Flash, você deve garantir que o disco Flash tenha mais tamanho de armazenamento do que a memória DRAM que causa o dump central. Por exemplo, se você tiver um tamanho de memória DRAM de 128 MB, o disco Flash deverá ter uma capacidade de armazenamento superior a 128 MB. Uma memória de disco flash maior é necessária para obter o dump central corretamente. Se houver falta de memória no disco Flash, o dump central não será criado.

Para usar um disco Flash para configurar um roteador para um dump central, use este comando:

exception flash procmem|iomem|all device_name [:partition_number] 

!--- This command uses a Flash disk to configure the router for a core dump.

O comando EXEC show flash all lista os dispositivos que você pode usar para o comando exception flash.

Usar protocolo de transferência de arquivo trivial

Devido a uma limitação da maioria dos aplicativos TFTP, o roteador despeja apenas os primeiros 16 MB do arquivo de núcleo. Portanto, se a memória principal do roteador for maior que 16 MB, não use TFTP. Consulte Cisco IOS TFTP Client Cannot Transfer Files Larger than 16MB in Size para obter mais informações.

Para usar o TFTP para configurar um roteador para um dump central, use estes comandos:

• exception protocol tftp — esse comando configura o TFTP como o protocolo para dumps principais.

• exceção por tamanho da região 65536

• exception dump ip-address

TFTP é o protocolo padrão para exceções.

Observação: para evitar o congestionamento da rede, a Cisco recomenda que você conecte o roteador diretamente ao servidor TFTP, sem saltos intermediários. Se você precisar passar por um ou mais saltos intermediários, use o comando ip tftp source-interface para especificar qual interface usar para acessar o servidor TFTP.

Com base no servidor TFTP usado, talvez seja necessário criar arquivos de destino vazios com as permissões apropriadas antes que o roteador possa gravar neles.

Certifique-se de que o TFTP funcione primeiro. Use este exemplo:

c7500#copy running-config tftp: 
Address or name of remote host []? 172.18.125.3 
Destination filename [c7500-confg]? 
! 
2781 bytes copied in 0.944 secs 

Configuração avançada

Use os comandos de configuração desta seção além dos comandos da seção Configuração básica.

Memória de exceção

Para depurar alguns problemas de memória, você pode fazer com que o roteador crie um dump central e reinicialize no caso de violação de certos parâmetros de tamanho de memória. Use estes comandos exception memory para disparar um dump central:

• exception memory minimum size — esse comando forçará um travamento se a quantidade de memória livre do processador for reduzida abaixo do limite configurado.

• exception memory fragment size — esse comando forçará um travamento se o software Cisco IOS não puder alocar um bloco de memória de processador contíguo maior que o limite configurado.

O parâmetro size é expresso em bytes e é verificado a cada 60 segundos por padrão.

Esses comandos provocam a reinicialização do roteador apenas quando as condições configuradas são satisfeitas. Se você também configurar exception dump ou exception flash, o roteador criará um dump principal primeiro. Esses comandos ajudam a diagnosticar vazamentos de memória.

Debug Sanity

Em alguns casos, o representante do suporte técnico solicita que você habilite o debug sanity ao configurar o dump central. O comando debug sanity é um comando oculto na maioria das versões do software Cisco IOS e, às vezes, é necessário para depurar a corrupção da memória, especialmente a corrupção da memória de E/S. Quando você habilita debug sanity, o sistema executa uma verificação de sanidade em cada buffer alocado e executa uma verificação de sanidade novamente quando o buffer é liberado.

Você deve executar o comando debug sanity no modo EXEC privilegiado (ou no modo enable). Embora esse comando use alguma capacidade da CPU, debug sanity não afeta significativamente a funcionalidade do roteador. Como outros comandos debug, debug sanity não é salvo na configuração e, portanto, não sobrevive a uma reinicialização do sistema.

Nem todos os tipos de travamento exigem que você habilite debug sanity. Use debug sanity somente quando o representante do suporte técnico solicitar que você habilite esse comando.

Para desativar as verificações de sanidade, use o comando EXEC privilegiado undebug sanity.

Testar a configuração do despejo principal

Depois de configurar o roteador para dump central, teste a configuração.

O software Cisco IOS fornece o comando especial write core no modo EXEC privilegiado (ou modo enable) para fazer com que o roteador gere um dump central sem um recarregamento.

Se obtiver êxito, os arquivos de dump central terão o tamanho das respectivas regiões de memória. Lembre-se de que toda a região da memória é despejada, não apenas a memória que está em uso.

O comando write core também é útil no caso de um roteador com mau funcionamento, mas que não travou.

Informações Relacionadas

• Configurando um Dump Central em uma placa de linha de GSR
• Troubleshooting de Travamentos de Roteador
• Troubleshooting de Suspensões do Roteador
• Troubleshooting Problemas de Memória
• Suporte de produto dos roteadores
• Suporte Técnico e Documentação - Cisco Systems