Déployer des signatures de diagnostic sur les périphériques réseau ISR, ASR et Catalyst

Introduction

Ce document décrit comment déployer une signature de diagnostic (DS) afin de collecter automatiquement les données de diagnostic requises pour résoudre les problèmes avec les routeurs à services intégrés Cisco (ISR), les routeurs à services d'agrégation Cisco (ASR), les commutateurs de la gamme Cisco Catalyst 6500 et les routeurs de la gamme 7600.

Conditions préalables

Exigences

Aucune exigence spécifique n'est associée à ce document.

Composants utilisés

Les commandes show qui sont utilisées tout au long de ce document ont été capturées à partir d'un routeur de la gamme Cisco ISR 3945 qui exécute Cisco IOS^® Version 15.4(2)T3.

La prise en charge DS est disponible dans les versions de Cisco IOS répertoriées dans le tableau suivant :

Plateforme	Version du logiciel
Routeurs ISR 1900, 2900 et 3900	Cisco IOS 15.4(2)T et versions ultérieures
Routeurs ISR 4300, 4400	Cisco IOS 15.5(2)S, IOS XE 3.15 et versions ultérieures
Routeurs de la gamme ASR 1000	Cisco IOS 15.5(2)S, IOS XE 3.15 et versions ultérieures
Routeur de services cloud Cisco, série 1000V	Cisco IOS 15.5(2)S, IOS XE 3.15 et versions ultérieures
Routeurs, série 7600	Cisco IOS 15.3(3)S et versions ultérieures
Commutateurs de la gamme Catalyst 6500	Cisco IOS 15.1(2)SY3 et versions ultérieures

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, make sure that you understand the potential impact of any command.

Informations générales

Les DS sont des fichiers XML qui contiennent des informations sur les événements déclencheurs de problèmes et les actions à entreprendre afin de corriger ou de dépanner. Ils sont créés par le Centre d'assistance technique Cisco (TAC) et peuvent être déployés via Smart Call Home, ou vous pouvez charger manuellement le fichier sur le périphérique. Vous pouvez utiliser l'Outil de recherche de signature de diagnostic (DSLT) afin de trouver le bon DS pour le type de problème donné.

Dans ce document, vous allez apprendre à trouver et à déployer un DS afin de dépanner les pannes de DSP PVDM-3. Ce DS effectue les actions suivantes :

1. Configure le routeur afin de générer des simulations de panne DSP (Digital Signal Processor).
   
   
2. Détecte les pannes de DSP via l'écriture du message syslog DSP dump to file <nom fichier>.
   
   
3. Collecte les commandes show appropriées.
   
   
4. Envoie les données collectées par e-mail à attach@cisco.com.

Au moment de l'installation, vous êtes invité à saisir le nombre maximal de fichiers de vidage de la mémoire DSP à créer, le numéro de dossier à utiliser dans l'objet de l'e-mail et l'adresse e-mail à notifier de l'occurrence de la panne DSP.

Déploiement

Cette section décrit comment déployer le système de distribution.

Configurer

Remarque : les DS font partie de la fonction Call-Home de Cisco IOS.

La première étape que vous devez effectuer pour déployer le service d'annuaire consiste à configurer la fonction d'appel à distance. Une fois la fonction Call-Home activée, la prise en charge DS est automatiquement activée et configurée pour l'utilisation du profil CiscoTAC-1 par défaut.

Voici un exemple de configuration pour Smart Call Home dans 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#

Télécharger

La deuxième étape consiste à rechercher l'ID de signature ou à télécharger le fichier XML DS. Pour ce faire, fournissez la plate-forme, le produit, l'étendue du problème, le type de problème et la version du logiciel dans l'Outil de recherche de signature de diagnostic comme indiqué ici :

Utilisez ces informations afin de télécharger le DS via Smart Call Home avec l'ID de DS :

call-home diagnostic-signature download 10492

Utilisez ces informations afin de charger manuellement le fichier DS sur le périphérique :

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#

Voici une vue de haut niveau des blocs individuels dans le fichier 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#

Install 

Remarque : cette étape n'est requise que pour les signatures dont l'état est En attente après le téléchargement.

Après avoir configuré et téléchargé le DS, vous devez l'installer :

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#

Au cours du processus d'installation, vous êtes invité à répondre aux questions définies dans la section Invites :

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#

Une fois le DS enregistré, les actions spécifiées dans la section Prérequis sont exécutées. Dans cet exemple, les commandes associées à la génération de crashdump DSP sont configurées :

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

Vérifier

Cette section décrit comment vérifier que le DS est installé et fonctionne correctement.

Événement déclencheur

Cisco vous recommande de simuler le déclenchement du problème afin de vous assurer que le DS fonctionne correctement. Par exemple, vous pouvez simuler une panne de DSP via la commande test voice driver, comme indiqué ici :

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#

  

Voici le résultat de la commande 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>

Entrez la commande show call-home diagnostic-signature statistics afin de vérifier si le déclencheur d'événement de problème a été détecté par le 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#

Valider l'action

La dernière étape que vous devez effectuer pour vérifier le déploiement DS consiste à valider si des actions telles que celles-ci sont effectuées correctement :

• Exécution de la commande
  
  
• Exécution du script
  
  
• Transmission des données collectées par e-mail ou Smart Call Home avec les données collectées

Dans cet exemple, un e-mail est envoyé à attach@cisco.com avec le résultat des commandes show relatives au DSP.