Diagnostische handtekeningen implementeren op ISR-, ASR- en Catalyst-netwerkapparaten

Inleiding

Dit document beschrijft hoe u een diagnostische handtekening (DS) kunt implementeren om automatisch de diagnostische gegevens te verzamelen die nodig zijn om problemen met de Cisco geïntegreerde services routers (ISR’s), Cisco Aggregation Services Routers (ASR’s), en Cisco Catalyst 6500 Series switches en 7600 Series routers op te lossen.

Voorwaarden

Vereisten

Er zijn geen specifieke vereisten van toepassing op dit document.

Gebruikte componenten

De showopdrachten die door dit document worden gebruikt, zijn opgenomen van een Cisco ISR 3945 Series router die Cisco IOS^® versie 15.4(2)T3 uitvoert.

De DS-ondersteuning is beschikbaar in de Cisco IOS-versies die in deze tabel worden vermeld:

Platform	Softwareversie
ISR 1900, 2900, 3900 Series routers	Cisco IOS 15.4(2)T en hoger
ISR 4300, 4400 Series routers	Cisco IOS 15.5(2)S, IOS XE 3.15 en hoger
ASR 1000 Series routers	Cisco IOS 15.5(2)S, IOS XE 3.15 en hoger
Cisco Cloud-services router 1000V Series	Cisco IOS 15.5(2)S, IOS XE 3.15 en hoger
7600 Series routers	Cisco IOS 15.3(3)S en hoger
Catalyst 6500 Series switches	Cisco IOS 15.1(2)SY3 en hoger

De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u de potentiële impact van elke opdracht begrijpen.

Achtergrondinformatie

De DS’en zijn XML-bestanden die informatie bevatten over probleemactiveringsgebeurtenissen en acties die moeten worden ondernomen om problemen te verhelpen of op te lossen. Ze worden gemaakt door het Cisco Technical Assistance Center (TAC) en kunnen worden geïmplementeerd via Smart Call Home, of u kunt het bestand handmatig op het apparaat laden. U kunt de Diagnostic Signature Lookup Tool (DSLT) gebruiken om de juiste DS voor het gegeven type probleem te vinden.

In dit document leert u hoe u een DS kunt vinden en implementeren om problemen op te lossen met PVDM-3 DSP-crashes. Dit DS voert de volgende acties uit:

1. Configureert de router om crashdumps met Digital Signal Processor (DSP) te genereren.
   
   
2. Detecteert DSP crashes via het uitschrijven DSP dump naar bestand <bestandsnaam> syslog bericht.
   
   
3. Verzamelt de relevante show commando's.
   
   
4. Verstuurt de verzamelde gegevens per e-mail naar attach@cisco.com.

Op het moment van de installatie wordt u gevraagd om het maximale aantal DSP crashdump-bestanden in te voeren dat gemaakt moet worden, het casenummer dat gebruikt moet worden in het e-mailonderwerp en het e-mailadres dat op de hoogte moet worden gesteld van het optreden van de DSP-crash.

Implementeren

In deze paragraaf wordt beschreven hoe de DS kan worden geïmplementeerd.

Configureren

Opmerking: de DS-systemen maken deel uit van de call-home-functie in Cisco IOS.

De eerste stap die u moet voltooien om de DS te implementeren is het configureren van de call-home functie. Zodra de call-home functie is ingeschakeld, wordt de DS-ondersteuning automatisch ingeschakeld en standaard geconfigureerd voor het gebruik van het Cisco TAC-1-profiel.

Hier is een voorbeeldconfiguratie voor Smart Call Home in 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#

Downloaden

De tweede stap is om de handtekening-ID te vinden of het DS XML-bestand te downloaden. Om dit te doen, het platform, product, probleemgebied, probleemtype, en softwareversie in Diagnostic Signature Lookup Tool verstrekken zoals hier getoond:

Gebruik deze informatie om de DS via Smart Call Home met de DS-ID te downloaden:

call-home diagnostic-signature download 10492

Gebruik deze informatie om het DS-bestand handmatig op het apparaat te 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#

Hier is een weergave op hoog niveau van afzonderlijke blokken in het DS-bestand:

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#

Installeren

Opmerking: deze stap is alleen vereist voor handtekeningen die na het downloaden nog in behandeling zijn.

Nadat u de DS hebt geconfigureerd en gedownload, moet u deze vervolgens installeren:

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#

Tijdens het installatieproces wordt u gevraagd om vragen die worden gedefinieerd in het gedeelte Vragen:

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#

Zodra de DS is geregistreerd, worden de acties uitgevoerd die in de sectie Voorwaarde zijn gespecificeerd. In dit voorbeeld zijn de opdrachten die gerelateerd zijn aan de DSP crashdump-generatie geconfigureerd:

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

Verifiëren

In dit deel wordt beschreven hoe kan worden geverifieerd dat de DS correct is geïnstalleerd en werkt.

triggergebeurtenis

Cisco raadt u aan de probleemtrigger te simuleren om er zeker van te zijn dat de DS correct werkt. U kunt bijvoorbeeld een DSP-crash simuleren via de opdracht stemstuurprogramma, zoals hier wordt getoond:

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 is de output van het bevel van het showlogboek:

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>

Voer de opdracht statistieken over diagnostische handtekeningen bij de show call-home in om te controleren of de activering van de probleemgebeurtenis door de DS is gedetecteerd:

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#

Handeling valideren

De laatste stap die u moet voltooien om de DS-implementatie te verifiëren is te valideren of acties zoals deze correct worden uitgevoerd:

• Opdracht uitvoeren
  
  
• Script-uitvoering
  
  
• Verzamelde gegevensoverdracht via e-mail of Smart Call Home met verzamelde gegevens

In dit voorbeeld wordt een e-mail verzonden naar attach@cisco.com met de uitvoer van de DSP-gerelateerde show opdrachten.