Implante assinaturas de diagnóstico em dispositivos de rede ISR, ASR e Catalyst

Introdução

Este documento descreve como implantar uma Assinatura de Diagnóstico (DS) para coletar automaticamente os dados de diagnóstico necessários para solucionar problemas com os Cisco Integrated Services Routers (ISRs), Cisco Aggregation Services Routers (ASRs), switches Cisco Catalyst 6500 Series e roteadores 7600 Series.

Pré-requisitos

Requisitos

Não existem requisitos específicos para este documento.

Componentes Utilizados

Os comandos show usados neste documento foram capturados de um roteador Cisco ISR 3945 Series que executa o Cisco IOS^® versão 15.4(2)T3.

O suporte DS está disponível nas versões do Cisco IOS listadas nesta tabela:

Platform	Versão de software
Roteadores ISR séries 1900, 2900 e 3900	Cisco IOS 15.4(2)T e posterior
Roteadores ISR 4300, 4400 Series	Cisco IOS 15.5(2)S, IOS XE 3.15 e posterior
Roteadores ASR 1000 Series	Cisco IOS 15.5(2)S, IOS XE 3.15 e posterior
Roteador de serviços em nuvem Cisco 1000V Series	Cisco IOS 15.5(2)S, IOS XE 3.15 e posterior
Roteadores 7600 Series	Cisco IOS 15.3(3)S e posterior
Catalyst 6500 Series Switches	Cisco IOS 15.1(2)SY3 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.

Informações de Apoio

Os DSs são arquivos XML que contêm informações sobre eventos de acionamento de problemas e ações a serem tomadas para remediar ou solucionar problemas. Eles são criados pelo Cisco Technical Assistance Center (TAC) e podem ser implantados por meio do Smart Call Home, ou você pode carregar o arquivo manualmente no dispositivo. Você pode usar a Diagnostic Signature Lookup Tool (DSLT) para encontrar o DS correto para o tipo de problema específico.

Neste documento, você aprenderá como localizar e implantar um DS para solucionar problemas de travamentos de PVDM-3 DSP. Este DS executa as seguintes ações:

1. Configura o roteador para gerar despejos de memória do Processador de Sinal Digital (DSP).
   
   
2. Detecta travamentos de DSP por meio da mensagem de syslog write out DSP dump to file <file name>.
   
   
3. Coleta os comandos show relevantes.
   
   
4. Envia os dados coletados por email para attach@cisco.com.

No momento da instalação, você será solicitado a inserir o número máximo de arquivos de despejo de memória DSP a serem criados, o número do caso a ser usado no assunto do e-mail e o endereço de e-mail a ser notificado sobre a ocorrência de falha de DSP.

Implantar

Esta seção descreve como implantar o DS.

Configurar

Observação: os DSs fazem parte do recurso de call-home no Cisco IOS.

A primeira etapa que você deve concluir para implantar o DS é configurar o recurso call-home. Uma vez que o recurso call-home esteja ativado, o suporte DS é automaticamente ativado e configurado para o uso do perfil CiscoTAC-1 por padrão.

Aqui está um exemplo de configuração do Smart Call Home no Cisco IOS:

service call-home
call-home
 contact-email-addr router@cisco.com
 mail-server 192.0.2.33 priority 1
 http-proxy "192.0.2.60" port 3128
 no syslog-throttling
 profile "CiscoTAC-1"
  active
  destination transport-method http
  no destination transport-method email

Router#show call-home diagnostic-signature 
Current diagnostic-signature settings:
 Diagnostic-signature: enabled
 Profile: CiscoTAC-1 (status: ACTIVE)
 Environment variable:
           Not yet set up

Downloaded DSes:
                                       Last Update
DS ID    DS Name   Revision Status     (GMT+00:00)
-------- --------- -------- ---------- ------------

Router#

Download

A segunda etapa é encontrar o ID da assinatura ou fazer o download do arquivo XML do DS. Para fazer isso, forneça a plataforma, o produto, o escopo do problema, o tipo de problema e a versão do software na Diagnostic Signature Lookup Tool conforme mostrado aqui:

Use estas informações para baixar o DS via Smart Call Home com o ID DS:

call-home diagnostic-signature download 10492

Use estas informações para carregar manualmente o arquivo DS no dispositivo:

Router#copy ftp://192.0.2.10/DS_10492.xml flash:
Destination filename [DS_10492.xml]? 
Accessing ftp://192.0.2.10/DS_10492.xml...!
[OK - 3804/4096 bytes]

3804 bytes copied in 0.476 secs (7992 bytes/sec)

Router#
Router#call-home diagnostic-signature load flash:DS_10492.xml
Load file flash:DS_10492.xml success
Router#

Esta é uma visualização de alto nível de blocos individuais dentro do arquivo DS:

Router#show call-home diagnostic-signature 10492
ID              : 10492
Name            : DS_PVDM3_DSP_Crash_Event_1

Functionality:
This DS configures DSP crash dump generation, identifies crash event and
collects show commands required to troubleshoot and identify root cause.

This DS will have no impact on the performance of the router.

Prompts:
    Variable: ds_number_of_files               Prompt: Number of crashdump files
     to be stored in the flash    (1-5)
        Type: integer    Range: 1..5                                            
    Variable: ds_case_number                   Prompt: Enter TAC Case Number
     (Case number to which diagnostics data need to be uploaded)
        Type: regexp    Pattern: 6[0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9]       
    Variable: ds_user_email                    Prompt: Enter Notification Email-Address
     (Email address to which problem occurrence needs to be notified)
        Type: regexp    Pattern: [a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]+     

Prerequisite:
    Type            : CMD
    Element List    : 
        CMD : config t
        CMD : voice dsp crash-dump destination flash:dsp_crashdump
        CMD : voice dsp crash-dump file-limit $ds_number_of_files

Event:
    Action Tag      : a1 
    Event Tag       : e1
    Type            : syslog
    Syslog Pattern  : .*writing out DSP dump to file ([^[:space:]]+).*

Includes action steps that may impact device state: No
Action:
    Action Tag      : a1
    Type            : EMAILTO
    Email To        : attach@cisco.com,$ds_user_email
    Subject         : DSP Crashdump
    Attach SR       : $ds_case_number
    Element List    : 
        DATA: show version
        DATA: show voice dsp group all
        DATA: show call active voice brief
        DATA: show call active video brief
        DATA: show call active fax brief
        DATA: show sccp connection
        DATA: show dspfarm all
        DATA: dir $ds_dsp_crashdump_file
        DATA: show run

Postrequisite:
    Type            : CMD
    Element List    : 
        CMD : config t
        CMD : no voice dsp crash-dump destination flash:dsp_crashdump
        CMD : no voice dsp crash-dump file-limit $ds_number_of_files
        CMD : end

Router#

Instalação

Observação: esta etapa é necessária apenas para assinaturas com status pendente após o download.

Depois de configurar e transferir o DS, instale-o:

Router#show call-home diagnostic-signature 
Current diagnostic-signature settings:
 Diagnostic-signature: enabled
 Profile: CiscoTAC-1 (status: ACTIVE)
 Environment variable:
           Not yet set up

Downloaded DSes:
                                                             Last Update
DS ID    DS Name                         Revision Status     (GMT-04:00)
-------- ------------------------------- -------- ---------- -------------------
10492    DS_PVDM3_DSP_Crash_Event_1      1.0      pending    2015-06-04 20:01:24

Router#

Durante o processo de instalação, você receberá perguntas definidas na seção Prompts:

Router#call-home diagnostic-signature install 10492
Number of crashdump files to be stored in the flash (1-5) 5
Enter TAC Case Number (Case number to which diagnostics data need to be uploaded)
 600000001
Enter Notification Email-Address (Email address to which problem occurrence needs
 to be notified) attach@cisco.com
All prompt variables are configured successfully.

Router#

Router#show call-home diagnostic-signature 
Current diagnostic-signature settings:
 Diagnostic-signature: enabled
 Profile: CiscoTAC-1 (status: ACTIVE)
 Environment variable:
           Not yet set up

Downloaded DSes:
                                                             Last Update
DS ID    DS Name                         Revision Status     (GMT-04:00)
-------- ------------------------------- -------- ---------- -------------------
10492    DS_PVDM3_DSP_Crash_Event_1      1.0      registered 2015-06-04 20:01:24

Router#

Depois que o DS é registrado, as ações especificadas na seção Pré-requisito são executadas. Neste exemplo, os comandos relacionados à geração de despejo de memória DSP são configurados:

Router#show run | section voice dsp
voice dsp crash-dump file-limit 3
voice dsp crash-dump destination flash:dsp_crashdump
Router#

Verificar

Esta seção descreve como verificar se o DS está instalado e funcionando corretamente.

Evento de Disparador

A Cisco recomenda que você simule o disparador do problema para garantir que o DS funcione corretamente. Por exemplo, você pode simular um travamento de DSP através do comando test voice driver, como mostrado aqui:

Router#test voice driver
Enter Voice NM  slot number : 0

C29xx/C39xx Debugging Section;

1 - FPGA Registers Read/Write
2 - 5510 DSP test
3 - DSPRM test
5 - IOCTRL TDM Registers Read/Write
6 - IOCTRL HDLC Registers Read/Write
7 - IOCTRL TDM Memory Read/Write
8 - get conn store address
9 - TDM PLL Read/Wrire
10 - SP2600 DSP test
11 - Quit

Select option : 10

SP2600 DSP Testing Section:

1 - Display Device Information
2 -  Reset 1 DSP
3 -  Reset All DSPs
4 -  Download DSP Firmware
5 -  JTAG Read DSP Memory
6 -  JTAG Write DSP Memory
7 -  Keepalive Enable/Disable
8 -  Display DSP Keepalive Status
9 -  Simulate DSP Crash
10 - ACK Testing
11 - Set Mbrd_dsp_debug Value
12 - PLD watch dog timers Enable/Disable
13 - Send Status_Request DSP Message
14 - Display Host and DSP MAC Address
15 - Display PLD and BOOTLOADER Version
16 - GigE enable/disable port
17 - Reset TDM port
18 - Show ports receiving oversubscription tone
19 - Display firmware build string
20 - Simulate All ARM Crash
21 - Simulate All ARM Crash after All DSS Crash
22 - Read PVDM PLD register
23 - Write PVDM PLD register
24 - Import DSP command file
25 - Switch DSP application between HR image and Streamware
26 - Show video capabilities of a DSP
27 - QUIT

Select option : 9
(1=DSP, 2=ARM) :1
Enter DSP id : 1
Enter Mode: 
Mode 1: Simulates Assert Condition
Mode 2: Simulates Endless loop
Mode 3: Stop High Level Responses to Commands

Enter Mode: 1

SP2600 DSP Testing Section:

1 - Display Device Information
2 -  Reset 1 DSP
3 -  Reset All DSPs
4 -  Download DSP Firmware
5 -  JTAG Read DSP Memory
6 -  JTAG Write DSP Memory
7 -  Keepalive Enable/Disable
8 -  Display DSP Keepalive Status
9 -  Simulate DSP Crash
10 - ACK Testing
11 - Set Mbrd_dsp_debug Value
12 - PLD watch dog timers Enable/Disable
13 - Send Status_Request DSP Message
14 - Display Host and DSP MAC Address
15 - Display PLD and BOOTLOADER Version
16 - GigE enable/disable port
17 - Reset TDM port
18 - Show ports receiving oversubscription tone
19 - Display firmware build string
20 - Simulate All ARM Crash
21 - Simulate All ARM Crash after All DSS Crash
22 - Read PVDM PLD register
23 - Write PVDM PLD register
24 - Import DSP command file
25 - Switch DSP application between HR image and Streamware
26 - Show video capabilities of a DSP
27 - QUIT

Select option : 27

C29xx/C39xx Debugging Section;

1 - FPGA Registers Read/Write
2 - 5510 DSP test
3 - DSPRM test
5 - IOCTRL TDM Registers Read/Write
6 - IOCTRL HDLC Registers Read/Write
7 - IOCTRL TDM Memory Read/Write
8 - get conn store address
9 - TDM PLL Read/Wrire
10 - SP2600 DSP test
11 - Quit

Select option : 11
Router#

  

Esta é a saída do comando show log:

032517: Jun  5 00:02:46.300: writing out DSP dump to file
 flash:dsp_crashdump-1433462566-1
032517: Jun  5 00:02:46.300: writing out DSP dump to file
 flash:dsp_crashdump-1433462566-1, sequence 
032517: Jun  5 00:02:46.300: writing out DSP dump to file
 flash:dsp_crashdump-1433462566-1, timestamp 
032532: Jun  5 00:02:46.344: DS-ACT-TRACE: call_home_ds_regexp_paren_str_get[2571],
 run regular expression once with pattern .*writing out DSP dump to file
 ([^[:space:]]+).*
032534: Jun  5 00:02:46.344: DS-ACT-TRACE: : writing out DSP dump to file flash:
dsp_crashdump-1433462566-1
032551: Jun  5 00:02:46.348: CALL-HOME-TRACE: Event 41 description <032517:
 Jun 5 00:02:46.300: writing out DSP dump to file flash:dsp_crashdump-1433462566-1>

Insira o comando show call-home diagnostic-signature statistics para verificar se o disparador de evento de problema foi detectado pelo DS:

Router#show call-home diagnostic-signature statistics 
                                           Triggered/     Average Run  Max Run
DS ID     DS Name                          Max/Deinstall  Time(sec)    Time(sec)
--------  -------------------------------  -------------  -----------  ---------
10492     DS_PVDM3_DSP_Crash_Event_1       0/0/N          0.000        0.000    

3900-12#
3900-12#
3900-12#
3900-12#show call-home diagnostic-signature statistics 
                                           Triggered/     Average Run  Max Run
DS ID     DS Name                          Max/Deinstall  Time(sec)    Time(sec)
--------  -------------------------------  -------------  -----------  ---------
10492     DS_PVDM3_DSP_Crash_Event_1       1/0/N          15.152       15.152   

Router#

Validar Ação

A etapa final que você deve concluir para verificar a implantação de DS é validar se ações como estas são executadas corretamente:

• Execução do comando
  
  
• Execução de script
  
  
• Transmissão de dados coletados por e-mail ou Smart Call Home com dados coletados

Neste exemplo, um e-mail é enviado para attach@cisco.com com a saída dos comandos show relacionados ao DSP.