Bereitstellung von Diagnosesignaturen auf ISR-, ASR- und Catalyst-Netzwerkgeräten

Einleitung

In diesem Dokument wird die Bereitstellung einer Diagnose-Signatur (DS) beschrieben, um automatisch die Diagnosedaten zu erfassen, die zur Fehlerbehebung bei Cisco Integrated Services Routern (ISRs), Cisco Aggregation Services Routern (ASRs), Cisco Catalyst Switches der Serie 6500 und Cisco Routern der Serie 7600 erforderlich sind.

Voraussetzungen

Anforderungen

Es gibt keine spezifischen Anforderungen für dieses Dokument.

Verwendete Komponenten

Die in diesem Dokument verwendeten Befehle show wurden von einem Cisco Router der Serie ISR 3945 erfasst, auf dem Cisco IOS® Version 15.4(2)T3 ausgeführt wird.

Die DS-Unterstützung ist in den in dieser Tabelle aufgeführten Cisco IOS-Versionen verfügbar:

Plattform	Software-Version
ISR Router der Serien 1900, 2900, 3900	Cisco IOS 15.4(2)T und neuere Versionen
ISR-Router der Serien 4300 und 4400	Cisco IOS 15.5(2)S, IOS XE 3.15 und höher
Router der Serie ASR 1000	Cisco IOS 15.5(2)S, IOS XE 3.15 und höher
Cisco Cloud Services Router der Serie 1000V	Cisco IOS 15.5(2)S, IOS XE 3.15 und höher
Router der Serie 7600	Cisco IOS 15.3(3)S und neuere Versionen
Catalyst Switches der Serie 6500	Cisco IOS 15.1(2)SY3 und neuere Versionen

Die Informationen in diesem Dokument beziehen sich auf Geräte in einer speziell eingerichteten Testumgebung. Alle Geräte, die in diesem Dokument benutzt wurden, begannen mit einer gelöschten (Nichterfüllungs) Konfiguration. Wenn Ihr Netz Live ist, überprüfen Sie, ob Sie die mögliche Auswirkung jedes möglichen Befehls verstehen.

Hintergrundinformationen

Bei den DSs handelt es sich um XML-Dateien, die Informationen über problemauslösende Ereignisse und Maßnahmen enthalten, die zur Behebung oder Behebung von Problemen ergriffen werden müssen. Sie werden vom Cisco Technical Assistance Center (TAC) erstellt und können über Smart Call Home bereitgestellt werden. Sie können die Datei aber auch manuell auf das Gerät laden. Sie können das Diagnostic Signature Lookup Tool (DSLT) verwenden, um den richtigen DS für die jeweilige Problemart zu finden.

In diesem Dokument wird erläutert, wie Sie einen DS finden und bereitstellen, um PVDM-3 DSP-Abstürze zu beheben. Dieser DS führt folgende Aktionen aus:

1. Konfiguriert den Router, um DSP-Abstürze (Digital Signal Processor) zu generieren.
   
   
2. Erkennt DSP-Abstürze, indem DSP-Dump in die Datei <Dateiname> geschrieben wird.
   
   
3. Erfasst die relevanten show-Befehle.
   
   
4. Sendet die gesammelten Daten per E-Mail an attach@cisco.com.

Bei der Installation werden Sie aufgefordert, die maximale Anzahl der zu erstellenden DSP-Absturzdateien, die im Betreff der E-Mail zu verwendende Ticketnummer und die E-Mail-Adresse einzugeben, die über den DSP-Absturz benachrichtigt werden soll.

Bereitstellung

In diesem Abschnitt wird die Bereitstellung des DS beschrieben.

Konfigurieren

Hinweis: Die DSs sind Teil der Call-Home-Funktion des Cisco IOS.

Der erste Schritt, den Sie ausführen müssen, um den DS bereitzustellen, besteht in der Konfiguration der Call-Home-Funktion. Sobald die Call-Home-Funktion aktiviert ist, wird der DS-Support automatisch aktiviert und standardmäßig für die Verwendung des CiscoTAC-1-Profils konfiguriert.

Nachfolgend finden Sie ein Beispiel für die Konfiguration von Smart Call Home im 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#

Herunterladen

Der zweite Schritt besteht darin, die Signatur-ID zu finden oder die DS XML-Datei herunterzuladen. Geben Sie dazu im Diagnostic Signature Lookup Tool die Plattform, das Produkt, den Problembereich, den Problemtyp und die Softwareversion wie folgt an:

Verwenden Sie diese Informationen, um die DS über Smart Call Home mit der DS-ID herunterzuladen:

call-home diagnostic-signature download 10492

Verwenden Sie diese Informationen, um die DS-Datei manuell auf das Gerät zu laden:

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#

Im Folgenden finden Sie eine grobe Übersicht der einzelnen Blöcke in der DS-Datei:

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 

Hinweis: Dieser Schritt ist nur für Signaturen erforderlich, die sich nach dem Download im Status "Ausstehend" befinden.

Nachdem Sie den DS konfiguriert und heruntergeladen haben, müssen Sie ihn installieren:

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#

Während des Installationsvorgangs werden Sie mit Fragen konfrontiert, die im Abschnitt Eingabeaufforderungen definiert sind:

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#

Sobald der DS registriert ist, werden die im Abschnitt "Voraussetzungen" angegebenen Aktionen ausgeführt. In diesem Beispiel werden die Befehle für die DSP-Absturzspeichergenerierung konfiguriert:

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

Überprüfung

In diesem Abschnitt wird beschrieben, wie Sie überprüfen, ob der DS installiert ist und ordnungsgemäß funktioniert.

Trigger-Ereignis

Cisco empfiehlt, den Problem-Trigger zu simulieren, um sicherzustellen, dass der DS ordnungsgemäß funktioniert. Sie können beispielsweise einen DSP-Absturz mithilfe des Befehls test voice driver simulieren, wie hier gezeigt:

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#

  

Hier ist die Ausgabe des Befehls 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>

Geben Sie den Befehl show call-home diagnostic-signature statistics ein, um zu überprüfen, ob der Problemereignisauslöser vom DS erkannt wurde:

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#

Aktion überprüfen

Der letzte Schritt, den Sie ausführen müssen, um die DS-Bereitstellung zu überprüfen, besteht darin, zu überprüfen, ob die folgenden Aktionen ordnungsgemäß ausgeführt werden:

• Befehlsausführung
  
  
• Skriptausführung
  
  
• Erfassung der Datenübertragung per E-Mail oder Smart Call Home mit Erfassung der Daten

In diesem Beispiel wird eine E-Mail an attach@cisco.com mit der Ausgabe der DSP-bezogenen show-Befehle gesendet.