ISR、ASR、および Catalyst ネットワーク デバイスでの診断シグニチャの導入

はじめに

このドキュメントでは、Ciscoサービス統合型ルータ(ISR)、Ciscoアグリゲーションサービスルータ(ASR)、Cisco Catalyst 6500シリーズスイッチおよび7600シリーズルータの問題のトラブルシューティングに必要な診断データを自動的に収集するために、診断シグニチャ(DS)を展開する方法について説明します。

前提条件

要件

このドキュメントに関する固有の要件はありません。

使用するコンポーネント

このドキュメント全体で使用されているshowコマンドは、Cisco IOS^®バージョン15.4(2)T3が稼働するCisco ISR 3945シリーズルータでキャプチャされたものです。

DSのサポートは、次の表に示すCisco IOSバージョンで使用できます。

Platform	[Software Version]
ISR 1900、2900、3900シリーズルータ	Cisco IOS 15.4(2)T以降
ISR 4300、4400シリーズルータ	Cisco IOS 15.5(2)S、IOS XE 3.15以降
ASR 1000 シリーズ ルータ	Cisco IOS 15.5(2)S、IOS XE 3.15以降
シスコ クラウド サービス ルータ 1000V シリーズ	Cisco IOS 15.5(2)S、IOS XE 3.15以降
7600 シリーズ ルータ	Cisco IOS 15.3(3)S以降
Catalyst 6500 シリーズ スイッチ	Cisco IOS 15.1(2)SY3以降

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、クリアな（デフォルト）設定で作業を開始しています。対象のネットワークが実稼働中である場合には、どのようなコマンドについても、その潜在的な影響について確実に理解しておく必要があります。

背景説明

DSはXMLファイルであり、問題のトリガーイベントと、修復またはトラブルシューティングのために実行するアクションに関する情報が含まれています。これらのファイルはCisco Technical Assistance Center(TAC)によって作成され、Smart Call Homeを介して展開できます。または、手動でファイルをデバイスにロードすることもできます。Diagnostic Signature Lookup Tool(DSLT)を使用して、特定の種類の問題に適したDSを検索できます。

このドキュメントでは、PVDM-3 DSPのクラッシュをトラブルシューティングするためにDSを見つけて導入する方法を説明します。このDSは次のアクションを実行します。

1. デジタルシグナルプロセッサ(DSP)のクラッシュダンプを生成するようにルータを設定します。
   
   
2. Writing out DSP dump to file <file name> syslogメッセージを介してDSPクラッシュを検出します。
   
   
3. 関連するshowコマンドを収集します。
   
   
4. 収集したデータを電子メールでattach@cisco.comに送信します。

インストール時に、作成するDSPクラッシュダンプファイルの最大数、電子メールの件名に使用するケース番号、およびDSPクラッシュが発生したことを通知する電子メールアドレスの入力が求められます。

展開

ここでは、DSの導入方法について説明します。

設定

注:DSは、Cisco IOSのCall Home機能の一部です。

DSを導入するために最初に完了する必要がある手順は、call-home機能の設定です。Call Home機能を有効にすると、DSサポートが自動的に有効になり、デフォルトでCiscoTAC-1プロファイルを使用するように設定されます。

Cisco IOSでのSmart Call Homeの設定例を次に示します。

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#

ダウンロード

2番目の手順では、シグニチャIDを見つけるか、DS XMLファイルをダウンロードします。これを行うには、次に示すように、Diagnostic Signature Lookup Toolでプラットフォーム、製品、問題の範囲、問題のタイプ、およびソフトウェアバージョンを指定します。

DS IDを使用してSmart Call Home経由でDSをダウンロードするには、次の情報を使用します。

call-home diagnostic-signature download 10492

DSファイルをデバイスに手動でロードするには、次の情報を使用します。

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#

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#

インストール

注：この手順が必要なのは、ダウンロード後にpendingステータスになっているシグニチャだけです。

DSの設定とダウンロードが完了したら、それをインストールする必要があります。

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#

インストールプロセス中に、「プロンプト」セクションで定義されている質問が表示されます。

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#

DSが登録されると、「前提条件」セクションで指定したアクションが実行されます。この例では、DSPクラッシュダンプの生成に関連するコマンドを設定します。

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

確認

このセクションでは、DSがインストールされ、正しく動作していることを確認する方法について説明します。

トリガー イベント

シスコでは、DSが正しく動作していることを確認するために、問題のトリガーをシミュレートすることを推奨します。たとえば、次に示すように、test voice driverコマンドでDSPのクラッシュをシミュレートできます。

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#

  

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>

問題のイベントトリガーがDSによって検出されたかどうかを検証するには、show call-home diagnostic-signature statisticsコマンドを入力します。

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#

アクションの検証

DSの展開を確認するために完了する必要がある最後の手順は、次のようなアクションが正しく実行されているかどうかを検証することです。

• コマンドの実行
  
  
• スクリプトの実行
  
  
• EメールまたはSmart Call Homeを介した収集データの送信

この例では、DSP関連のshowコマンドの出力が含まれた電子メールがattach@cisco.comに送信されます。