نشر توقيعات التشخيص على أجهزة شبكة ISR و ASR و Catalyst

المقدمة

يصف هذا المستند كيفية نشر توقيع تشخيصي (DS) من أجل التجميع التلقائي لبيانات التشخيصات المطلوبة لاستكشاف أخطاء المشاكل وإصلاحها باستخدام موجهات الخدمات المتكاملة (ISRs) من Cisco وموجهات خدمات التجميع (ASRs) ومحولات السلسلة Cisco Catalyst 6500 وموجهات سلسلة 7600.

المتطلبات الأساسية

المتطلبات

لا توجد متطلبات خاصة لهذا المستند.

المكونات المستخدمة

تم التقاط أوامر العرض التي يتم إستخدامها عبر هذا المستند من موجه سلسلة Cisco ISR 3945 SERIES الذي يشغل الإصدار 15.4(2)T3 من Cisco IOS^®.

يتوفر دعم DS في إصدارات Cisco IOS المدرجة في هذا الجدول:

المنصة	إصدار البرامج
موجهات سلسلة ISR 1900 و 2900 و 3900	Cisco IOS 15.4(2)T والإصدارات الأحدث
موجهات ISR 4300 و 4400 Series	Cisco IOS 15.5(2)S، IOS XE 3.15 والإصدارات الأحدث
سلسلة موجهات ASR 1000	Cisco IOS 15.5(2)S، IOS XE 3.15 والإصدارات الأحدث
سلسلة موجه خدمات الشبكة السحابية 1000V من Cisco	Cisco IOS 15.5(2)S، IOS XE 3.15 والإصدارات الأحدث
الموجهات من السلسلة 7600	IOS 15.3(3)S والإصدارات الأحدث من Cisco
المحولات من السلسلة Catalyst 6500	Cisco IOS 15.1(2)SY3 والإصدارات الأحدث

تم إنشاء المعلومات الواردة في هذا المستند من الأجهزة الموجودة في بيئة معملية خاصة. بدأت جميع الأجهزة المُستخدمة في هذا المستند بتكوين ممسوح (افتراضي). إذا كانت شبكتك مباشرة، فتأكد من فهمك للتأثير المحتمل لأي أمر.

معلومات أساسية

DSs هي ملفات XML التي تحتوي على معلومات حول أحداث مشغل المشكلة والإجراءات التي يجب إتخاذها لإصلاح أو أستكشاف الأخطاء وإصلاحها. يتم إنشاؤها بواسطة مركز المساعدة التقنية (TAC) من Cisco ويمكن نشرها عبر Smart Call Home، أو يمكنك تحميل الملف يدويا على الجهاز. يمكنك إستخدام أداة بحث التوقيع التشخيصي (DSLT) للعثور على DS المناسب لنوع المشكلة المحدد.

في هذا المستند، سوف تتعرف على كيفية العثور على ds ونشره لاستكشاف أخطاء PVDM-3 DSP وإصلاحها. يقوم هذا DS بتنفيذ هذه الإجراءات:

1. تكوين الموجه من أجل إنشاء مكبات مكبات معالج الإشارة الرقمية (DSP).
   
   
2. يكتشف أعطال DSP من خلال الكتابة فوق تفريغ DSP إلى رسالة <file name> syslog.
   
   
3. يجمع أوامر show ذات الصلة.
   
   
4. لإرسال البيانات المجمعة عبر البريد الإلكتروني إلى موقع attach@cisco.com.

في وقت التثبيت، تتم مطالبتك بإدخال الحد الأقصى لعدد ملفات تفريغ DSP الخاصة بالأكسدة المراد إنشاؤها ورقم الحالة المراد إستخدامه في موضوع البريد الإلكتروني وعنوان البريد الإلكتروني الذي سيتم إخطاره بتكرار تعطل DSP.

النشر

يوضح هذا القسم كيفية نشر DS.

التكوين

ملاحظة: تعد معرفات الأمان (DS) جزءا من ميزة الاتصال بالمنزل في Cisco IOS.

تتمثل الخطوة الأولى التي يجب عليك إكمالها لنشر ميزة "ds" في تكوين ميزة الاتصال بالمنزل. بمجرد تمكين ميزة الاتصال بالمنزل، يتم تمكين دعم DS تلقائيا وتكوينه لاستخدام ملف تعريف CiscoTAC-1 بشكل افتراضي.

هنا مثال لتكوين "الاتصال بالمنزل" الذكي في 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#

تنزيل

تتمثل الخطوة الثانية في العثور على معرف التوقيع أو تنزيل ملف DS XML. للقيام بذلك، يمكنك توفير النظام الأساسي والمنتج ونطاق المشكلة ونوع المشكلة وإصدار البرامج في أداة بحث التوقيع التشخيصي كما هو موضح هنا:

أستخدم هذه المعلومات لتنزيل DS عبر "صفحة الاتصال الرئيسية الذكية" باستخدام معرف 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#

الأمر Install 

ملاحظة: هذه الخطوة مطلوبة فقط للتوقيعات التي في حالة التعليق بعد التنزيل.

بعد تكوين 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 وتشغيله بشكل صحيح.

حدث الإطلاق

cisco يوصي أن يحاكي أنت المشكلة مشغل in order to ضمنت أن يعمل ال DS بشكل صحيح. على سبيل المثال، يمكنك محاكاة عطل 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#

  

هنا الإنتاج من العرض سجل مقياس سرعة أمر:

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>

أدخل الأمر show call-home diagnostic-signature statistics للتحقق مما إذا كان قد تم اكتشاف مشغل حدث المشكلة بواسطة 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#

التحقق من صحة الإجراء

الخطوة الأخيرة التي يجب عليك إكمالها للتحقق من نشر DS هي التحقق من صحة ما إذا كان قد تم تنفيذ إجراءات مثل هذه بشكل صحيح:

• تنفيذ الأمر
  
  
• تنفيذ البرنامج النصي
  
  
• نقل بيانات مجمعة عبر البريد الإلكتروني أو صفحة الاتصال الرئيسية الذكية مع البيانات المجمعة

في هذا المثال، يتم إرسال بريد إلكتروني إلى attach@cisco.com مع إخراج أوامر show المتعلقة ب DSP.