Implemente firmas de diagnóstico en dispositivos de red ISR, ASR y Catalyst

Introducción

Este documento describe cómo implementar una firma de diagnóstico (DS) para recopilar automáticamente los datos de diagnóstico que se requieren para resolver problemas con los routers de servicios integrados (ISR) de Cisco, los routers de servicios agregados (ASR) de Cisco, los switches Catalyst de Cisco serie 6500 y los routers serie 7600.

Prerequisites

Requirements

No hay requisitos específicos para este documento.

Componentes Utilizados

Los comandos show que se utilizan a lo largo de este documento fueron capturados de un Cisco ISR 3945 Series Router que ejecuta Cisco IOS^® Versión 15.4(2)T3.

La compatibilidad con DS está disponible en las versiones de Cisco IOS que se enumeran en esta tabla:

Platform	Versión del software
Routers ISR series 1900, 2900 y 3900	Cisco IOS 15.4(2)T y posterior
Routers ISR series 4300 y 4400	Cisco IOS 15.5(2)S, IOS XE 3.15 y versiones posteriores
Routers de la serie ASR 1000	Cisco IOS 15.5(2)S, IOS XE 3.15 y versiones posteriores
Router para servicios basados en la nube de Cisco serie 1000V	Cisco IOS 15.5(2)S, IOS XE 3.15 y versiones posteriores
Routers serie 7600	Cisco IOS 15.3(3)S y posterior
Catalyst 6500 Series Switches	Cisco IOS 15.1(2)SY3 y posterior

La información que contiene este documento se creó a partir de los dispositivos en un ambiente de laboratorio específico. Todos los dispositivos que se utilizan en este documento se pusieron en funcionamiento con una configuración verificada (predeterminada). If your network is live, make sure that you understand the potential impact of any command.

Antecedentes

Los DS son archivos XML que contienen información acerca de los eventos desencadenadores de problemas y las acciones que se deben llevar a cabo para solucionar problemas. El Cisco Technical Assistance Center (TAC) los crea y se pueden implementar a través de Smart Call Home, o bien se puede cargar manualmente el archivo en el dispositivo. Puede utilizar la Herramienta de búsqueda de firmas de diagnóstico (DSLT) para encontrar el DS correcto para el tipo de problema dado.

En este documento, aprenderá cómo encontrar e implementar un DS para resolver problemas de caídas de PVDM-3 DSP. Este DS realiza estas acciones:

1. Configura el router para generar crashdumps del Procesador de señales digitales (DSP).
   
   
2. Detecta caídas de DSP a través del mensaje syslog de escritura de volcado de DSP en el archivo <nombre de archivo>.
   
   
3. Recopila los comandos show relevantes.
   
   
4. Envía los datos recopilados por correo electrónico a attach@cisco.com.

En el momento de la instalación, se le pedirá que introduzca el número máximo de archivos de volcado de DSP que se van a crear, el número de caso que se va a utilizar en el asunto del correo electrónico y la dirección de correo electrónico a la que se va a notificar la aparición del bloqueo de DSP.

Implementación

En esta sección se describe cómo implementar DS.

Configurar

Nota: Las DS son parte de la función de llamada a casa en el IOS de Cisco.

El primer paso que debe completar para implementar DS es configurar la función de llamada a casa. Una vez habilitada la función de llamada a casa, la compatibilidad con DS se habilita y configura automáticamente para el uso del perfil Cisco TAC-1 de forma predeterminada.

A continuación se muestra un ejemplo de configuración de Smart Call Home en 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#

Descargar

El segundo paso consiste en buscar el ID de firma o descargar el archivo XML de DS. Para ello, proporcione la plataforma, el producto, el alcance del problema, el tipo de problema y la versión de software en la herramienta de búsqueda de firmas de diagnóstico, como se muestra aquí:

Utilice esta información para descargar el DS a través de Smart Call Home con el ID de DS:

call-home diagnostic-signature download 10492

Utilice esta información para cargar manualmente el archivo DS en el 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#

A continuación se muestra una vista de alto nivel de los bloques individuales dentro del archivo 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#

Instalar

Nota: Este paso sólo es necesario para las firmas que tengan el estado pendiente después de la descarga.

Después de haber configurado y descargado el DS, debe instalarlo:

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 el proceso de instalación, se le formularán preguntas que se definen en la sección Mensajes:

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#

Una vez registrado el DS, se ejecutan las acciones especificadas en la sección Requisitos previos. En este ejemplo, se configuran los comandos relacionados con la generación de crashdump de DSP:

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

Verificación

En esta sección se describe cómo comprobar que DS está instalado y funciona correctamente.

Evento desencadenador

Cisco recomienda que simule el desencadenador del problema para asegurarse de que DS funcione correctamente. Por ejemplo, puede simular un desperfecto de DSP mediante el comando test voice driver, como se muestra aquí:

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#

  

Aquí está el resultado del 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>

Ingrese el comando show call-home diagnostic-signature statistics para verificar si el DS ha detectado el disparador del evento del problema:

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 acción

El último paso que debe completar para verificar la implementación de DS es validar si acciones como estas se realizan correctamente:

• Ejecución de comandos
  
  
• Ejecución de script
  
  
• Transmisión de datos recopilados por correo electrónico o Smart Call Home con datos recopilados

En este ejemplo, se envía un correo electrónico a attach@cisco.com con la salida de los comandos show relacionados con DSP.