المقدمة
يصف هذا وثيقة يخلق ويستخرج الجذر سبب تحليل (RCA) مبرد/دعم حزمة من مادة حفازة مركز (سابقا cisco dna مركز).
معلومات أساسية
ال الجذر سبب تحليل (RCA) مبرد دعم حزمة يخلق على المادة حفازة مركز. يتضمن مخرجات أوامر متعددة وسجلات خدمات، يعطي أساسا لقطة من مركز Catalyst. وهو يسمح لمهندسي الدعم باستكشاف المشكلات وحلها بشكل أسرع. ولا يشمل هذا النظام نواتج من قواعد البيانات. في وقت سابق، تم إنشاء ملف RCA وتنزيله من واجهة سطر الأوامر (CLI) فقط، ولكن تم تغيير ذلك من الإصدار 2.3.7.6. جميع مخرجات الأوامر في هذا المستند ذات صلة من الإصدار 2.3.3.x.
توليد الجذر سبب تحليل مبرد (RCA أو حزمة دعم)
الخطوة الأولى هي إنشاء ملف RCA. يمكن إنشاء هذا إما من واجهة المستخدم (واجهة المستخدم) أو واجهة سطر الأوامر (CLI).
نشر أي جهاز مادي (خيار واجهة المستخدم)
بداية من 2.3.7.6 هناك خيار جديد أن يخلق ال RCA مبرد من المادة حفازة مركز واجهة مستخدم، أيضا يشار إلى ب "دعم حزمة" في ال ui. أيضا، هناك خيار جديد يزود في ال UI مثل إمكانية أن يختار الإطار الزمني من السجل أو أن يختار تطبيق خاص سجل حزمة. تتوفر هذه الخيارات لجميع عمليات نشر الأجهزة المادية.
ملاحظة: لا يمكن إنشاء حزمة دعم من واجهة مستخدم جهاز افتراضي يستند إلى ESXi.
الخطوة 1: انقر على الخيار "حزمة الدعم" في القائمة "تعليمات" في الشريط العلوي.

الخطوة 2: تظهر منبثقة جديدة قائمة بحزم الدعم التي تم إنشاؤها في وقت سابق أو مجرد خيار لإنشاء واحد جديد إذا كان هذا هو الخيار الأول.

الخطوة 3: انقر على "إنشاء حزمة دعم" وتظهر نقطة منبثقة أخرى. يمكن تحديد فترة زمنية لمجموعة الدعم. إذا كانت المشكلة قد ظهرت قبل يومين، فيرجى إختيار تاريخ البدء على الأقل قبل ذلك التاريخ لمجموعة الدعم. يتم تعيين الحد الأقصى للفترة الزمنية لشهر واحد بشكل افتراضي من الوقت الحالي. يرجى التأكد من تحديد "فئة النظام" دائما. استنادا إلى نوع المشكلة، يمكن تحديد فئة تطبيق إضافية (إختياري). قد يستغرق إنشاء الملف ما يصل إلى 30 دقيقة (يمكن أن يستغرق عمليات النشر واسعة النطاق أكثر من ذلك).
ملاحظة: من الممكن مشاهدة الكتابة فوق بعض ملفات السجل في أقل من شهر واحد، إذا كانت الأنشطة/الأحداث أو مستويات الوصول مرتفعة.

الخطوة 4: تأكد من التقاط ملف RCA كامل لمشكلتك. الرجاء كتابة true" في الخيار الأخير قبل النقر فوق الزر "إرسال" لأن هذا يضمن التقاط مخرجات إضافية.

نظام المجموعة / الجهاز الظاهري أحادي العقدة (خيار واجهة سطر الأوامر)
سجل الدخول إلى Catalyst Center CLI على المنفذ 2222 واستخدمmaglev
كاسم مستخدم. ثم قم بتنفيذrca
الأمر لإنشاء ملف RCA. يتم إنشاء ملف RCA وتخزينه فيdata/rca
. يستغرق إنشاء الملف عادة حوالي 30 دقيقة. اسم الملف له التنسيقmaglev--rca-.tar.gz
.
ملاحظة: تأكد من تمكين خادم SSH ServerAliveInterval مع تعيين الفاصل الزمني للحزمة no-op على كل 60 ثانية أو قيمة أقل. وهذا يؤدي إلى منع إغلاق إتصالات SSH قبل الأوان بواسطة الخادم بسبب عدم النشاط.
ملاحظة: لتغيير اسم مستخدم الإدارة/الإدارة أو عنوان IP لنظام المجموعة، امسح السياق باستخدام الأمر sudo maglev context delete maglev-1" (لا ينطبق على الجهاز الظاهري المستند إلى ESXi).
نموذج قائمة تعليمات أمر RCA
$ rca --help
Help:
rca - root cause analysis collection utilities
Usage: rca [COMMAND] [ARGS]...
Commands:
clear - clear RCA files
copy - copy rca files to specified location
exec - collect RCA
view - restricted filesystem view
مثال على RCA يتم إنشاؤه على جهاز مادي
$ rca
===============================================================
VERIFYING SSH/SUDO ACCESS
===============================================================
[sudo] password for maglev:
Done
changed ownership of '/data/rca/maglev-10.78.9.21-rca-2025-03-11_04-27-49_UTC.tar.gz' from root:root to maglev:maglev
===============================================================
VERIFYING ADMINISTRATION ACCESS
Please note that after 3 failed login attempts, diagnostic
collection will proceed, but not all diagnostics will be
collected.
===============================================================
WARNING: Current token has expired (2025-01-24T22:03:05+00:00Z).
The current time is: 2025-03-11T04:27:54Z
Continuing with login
[administration] password for 'admin':
User 'admin' logged into 'kong-frontend.maglev-system.svc.cluster.local' successfully
===============================================================
RCA package created on Tue Mar 11 04:28:02 UTC 2025
===============================================================
2025-03-11 04:28:02 | INFO | Generating log for 'date'...
2025-03-11 04:28:02 | INFO | Node ISO type: full-iso
...
Created RCA package: /data/rca/maglev-10.78.9.21-rca-2025-03-11_04-27-49_UTC.tar.gz
2025-03-11 04:58:28 | INFO | Cleaning up RCA temp files...
[Tuesday Mar 11 04:58:30 UTC] maglev@10.78.9.21 (maglev-master-10-78-9-21)
$
مثال على RCA يتم إنشاؤه على جهاز ESXi الظاهري
$ rca
===============================================================
VERIFYING SSH/SUDO ACCESS
===============================================================
Done
===============================================================
RCA package created on Tue Mar 11 07:04:15 UTC 2025
===============================================================
2025-03-11 07:04:15 | INFO | Generating log for 'date'...
2025-03-11 07:04:15 | INFO | Generating log for 'sudo cat /root/.bash_history'...
2025-03-11 07:04:15 | INFO | Node ISO type: mks
/usr/local/bin/rca_scripts/network_diag.sh
...
Created RCA package: /data/rca/maglev-10.78.9.122-rca-2025-03-11_07-04-15_UTC.tar.gz
2025-03-11 07:23:23 | INFO | Cleaning up RCA temp files...
[Tuesday Mar 11 07:23:23 UTC] maglev@10.78.9.122 (maglev-master-10-78-9-122)
$
مجموعة ذات ثلاث عقد (خيار CLI)
سجل الدخول إلى Catalyst Center CLI على المنفذ 2222 واستخدمmaglev
كاسم مستخدم. ثم قم بتنفيذrca
الأمر لإنشاء ملف RCA. يتم إنشاء ملف RCA وتخزينه فيdata/rca
. يستغرق إنشاء الملف عادة حوالي 30 دقيقة. اسم الملف له التنسيقmaglev--rca-.tar.gz
. يرجى التأكد من تجميع ملف RCA من جميع العقد أثناء توزيع الخدمات عبر العقد. إذا طلب مركز Catalyst عنوان IP لنظام المجموعة، فيمكن أن يكون هذا أي عنوان IP لعقدة/نظام مجموعة يمكن الوصول إليها. وهذا مطلوب للحصول على الرمز المميز للمسؤول المطلوب بدوره لبعض مخرجات الأمر.
ملاحظة: تأكد من تمكين خادم SSH ServerAliveInterval مع تعيين الفاصل الزمني للحزمة no-op على كل 60 ثانية أو قيمة أقل. وهذا يؤدي إلى منع إغلاق إتصالات SSH قبل الأوان بواسطة الخادم بسبب عدم النشاط.
ملاحظة: لتغيير اسم مستخدم الإدارة/الإدارة أو عنوان IP لنظام المجموعة، امسح السياق باستخدام الأمر sudo maglev context delete maglev-1" (لا ينطبق على الجهاز الظاهري المستند إلى ESXi).
[Wed May 30 18:24:26 UTC] maglev@10.1.1.2 (maglev-master-10) ~
$ rca
===============================================================
Verifying ssh/sudo access
===============================================================
Done
===============================================================
Verifying administration access
===============================================================
Cluster: 10.1.1.3
[administration] username for 'https://10.1.1.3:443': admin
[administration] password for 'admin':
User 'admin' logged into '10.1.1.3' successfully
===============================================================
RCA package created on Wed May 30 18:24:44 UTC 2018
===============================================================
2018-05-30 18:24:44 | INFO | Generating log for 'date'...
tar: Removing leading `/' from member names
/etc/cron.d/
/etc/cron.d/run-remedyctl
...
بعد تنفيذ الأمر rca، يتم تخزين عنوان IP لنظام المجموعة مؤقتا في/home/maglev/.maglevconf
(غير مرئي من الماغshell) على تلك العقدة. في المرة التالية التي يتم فيها تنفيذ الأمر rca، يستخدم مركز Catalyst نفس عنوان IP لنظام المجموعة لتلك العقدة.
[Wed May 30 18:23:37 UTC] maglev@10.1.1.2 (maglev-master-10) ~
$ rca
[sudo] password for maglev:
===============================================================
Verifying ssh/sudo access
===============================================================
Done
===============================================================
Verifying administration access
===============================================================
[administration] password for 'admin': <type the admin password>
User 'admin' logged into '10.1.1.3' successfully <-- it automatically logged into the cluster previously defined as the inter-cluster IP address
===============================================================
RCA package created on Wed May 30 18:23:46 UTC 2018
===============================================================
2018-05-30 18:23:46 | INFO | Generating log for 'date'...
tar: Removing leading `/' from member names
/etc/cron.d/
…
عرض ملف تحليل السبب الجذر (RCA أو حزمة الدعم)
يمكن عرض ملفات حزم RCA/دعم إما من واجهة سطر الأوامر أو واجهة المستخدم.
عرض حزم RCA/دعم (خيار واجهة المستخدم)
ملاحظة: لا تظهر هنا إلا حزم الدعم التي تم إنشاؤها من واجهة المستخدم.
انقر فوق الخيار "حزمة الدعم" في قائمة التعليمات المتوفرة في الشريط العلوي لعرض أي حزم دعم موجودة ولعرض حالة هذا الملف. إذا كان الملف لا يزال قيد الإنشاء، فعندئذ تعرض الحالة أيقونة "قيد التقدم". يتوفر الملف للتنزيل أو التحميل بمجرد أن تكون الحالة خضراء.

عرض حزم RCA/الدعم (خيار واجهة سطر الأوامر)
ملاحظة: لا تظهر هنا إلا حزم RCA/الدعم التي تم إنشاؤها من واجهة سطر الأوامر.
يتم تخزين حزم RCA/الدعم في المجلد /data/rca. يمكن عرضها عبر الأمر "rca view" أو اتباع أمر Linux.
$ rca view
total 1124652
-rwxr-xr-x 1 root root 1151639341 Feb 26 15:19 maglev-192.168.5.11-rca-2025-02-26_14-52-52_UTC.tar.gz
[Tuesday Mar 11 07:22:46 UTC] maglev@192.168.5.11 (maglev-master-192-168-5-11)
$
$ ls -lt data/rca/
total 1124652
-rwxr-xr-x 1 0 0 1151639341 Feb 26 15:19 maglev-192.168.5.11-rca-2025-02-26_14-52-52_UTC.tar.gz
[Tuesday Mar 11 07:23:06 UTC] maglev@192.168.5.11 (maglev-master-192-168-5-11)
$
إستخراج ملف تحليل السبب الجذر (RCA أو حزمة الدعم)
هناك يتعدد طريق أن يستخرج المبرد من المادة حفازة مركز يؤسس على ما إذا كان المبرد ولدت من ال UI أو ال CLI.
بدء النسخ من مركز Catalyst إلى حالة دعم Cisco (خيار واجهة المستخدم)
هناك خياران متاحان لتحميل الملف من واجهة المستخدم. بالنسبة للخيار الثاني، يتم إستخدام Cisco Support Assistant Extension (CSAE) Chrome Plugin/Extension.
الخيار 1: تحميل من واجهة المستخدم
يتم تقديم ثلاثة أزرار إجراء لكل ملف تم إنشاؤه من واجهة المستخدم. الإجراء المتخذ إلى اليمين هو تحميل الملف إلى حالة دعم Cisco. هنا الكلمة أن ينفذ CXD يحتاج. اسم المستخدم هو رقم حالة دعم Cisco وكلمة المرور هي رمز مميز لكل حالة دعم Cisco. يكون اسم المستخدم/كلمة المرور موجودا دائما في ملاحظة في بداية حالة دعم Cisco الخاصة بك ويمكن أيضا إسترداده من مدير حالة الدعم. للحصول على مزيد من التفاصيل حول الرمز المميز، ارجع إلى تحميل ملفات العميل إلى مركز المساعدة التقنية ل Cisco.
FileUpload1
الخيار 2: تحميل من واجهة المستخدم مع تثبيت ملحق CSAE
قم بتثبيت ملحق CSAE على مستعرض Chrome أو Edge. يعمل هذا على إعادة برمجة قدرة زر الإجراء "up arrow" ويسمح بتحميل الملف إلى حالة دعم Cisco دون أي بيانات اعتماد. لمزيد من التفاصيل، راجع وثائق CSAE.
بدء تشغيل نسخة الملف من جهاز يعمل بنظام التشغيل Windows أو Mac أو Linux (خيار واجهة المستخدم)
الخطوة 1. تنزيل WinSCP (في حالة نظام التشغيل Windows فقط) أو FileZilla أو عميل SCP/SFTP المفضل لديك.
خطوة 2. يزود ك مادة حفازة مركز عنوان مع ك CLI اعتماد، يختار SCP
أو SFTP كمبرد بروتوكول، واختر الميناء رقم 2222.

الخطوة 3. انتقل إلىdata/rca
المجلد.

الخطوة 4. انسخ ملف RCA إلى الكمبيوتر المحلي.

ملاحظة: في هذا المثال، يتم تحليل عنوان IP الخاص بمركز Catalyst إلىmxc-dnac4.cisco.com
. استبدلت هذا مضيف إسم مجال مؤهل بالكامل (FQDN) أو عنوان من ك مادة حفازة مركز تطبيق.
بدء تشغيل نسخة الملف من جهاز Mac أو Linux (خيار CLI)
الخطوة 1. افتح جلسة طرفية، ثم أنجزت هذا steps أن ينسخ ال RCA مبرد يعينmaglev-10.78.9.21-rca-2025-01-14_08-48-51_UTC.tar.gz
على المادة حفازة مركز جهاز فيdata/rca
الدليل إلى الحالي عمل دليل على حاسبك.
rrahul@MY-MACBOOK ~ % scp -P 2222 maglev@10.78.9.21:data/rca/maglev-10.78.9.21-rca-2025-01-14_08-48-51_UTC.tar.gz .
Welcome to the Cisco DNA Center Appliance
maglev@10.78.9.21's password:
maglev-10.78.9.21-rca-2025-01-14_08-48-51_UTC.tar.gz 100% 1485MB 32.3MB/s 00:45
rrahul@MY-MACBOOK ~ %
بدء تشغيل نسخة الملف من مركز Catalyst إلى جهاز Mac أو Linux (خيار CLI)
ملاحظة: تأكد من تمكين خادم SSH ServerAliveInterval مع تعيين الفاصل الزمني للحزمة no-op على كل 60 ثانية أو قيمة أقل. وهذا يؤدي إلى منع إغلاق إتصالات SSH قبل الأوان بواسطة الخادم بسبب عدم النشاط.
من ال CLI من المادة حفازة مركز جهاز، استعملت واحد من هذا أمر أن ينسخ المبرد، كلا منهم يستعمل SCP. هناك أختلاف بسيط في صياغة الأمر كما هو موضح في هذه الأمثلة:
$ scp data/rca/<RCA file name> <Mac/Linux username>@<Mac/Linux IP address>:<path to save the file>
OR
$ rca copy
Help:
copy - copy rca files to specified location
Usage: rca copy [scp-options] --files file1 ... user@host2:file2
هنا مثال من الإثنان أمر أن ينسخ من مادة حفازة مركز إلى نادل:
$ scp data/rca/maglev-10.78.9.21-rca-2025-01-14_08-48-51_UTC.tar.gz rrahul@10.105.192.135:
rrahul@10.105.192.135's password: <Enter the destination password>
maglev-10.78.9.21-rca-2025-01-14_08-48-51_UTC.tar.gz 100% 1485MB 106.6MB/s 00:13
[Thursday Mar 06 13:02:01 UTC] maglev@10.78.9.21 (maglev-master-10-78-9-21)
$
$ rca copy --files maglev-10.78.9.21-rca-2025-01-14_08-48-51_UTC.tar.gz rrahul@10.105.192.135:
rrahul@10.105.192.135's password: <Enter the destination password>
maglev-10.78.9.21-rca-2025-01-14_08-48-51_UTC.tar.gz 100% 1485MB 106.1MB/s 00:13
[Thursday Mar 06 13:10:31 UTC] maglev@10.78.9.21 (maglev-master-10-78-9-21)
$
بدء نسخ الملف من مركز Catalyst إلى حالة دعم Cisco (خيار CLI)
ملاحظة: تأكد من تمكين خادم SSH ServerAliveInterval مع تعيين الفاصل الزمني للحزمة no-op على كل 60 ثانية أو قيمة أقل. وهذا يؤدي إلى منع إغلاق إتصالات SSH قبل الأوان بواسطة الخادم بسبب عدم النشاط.
هذا مماثل للخيار السابق، أي يستخدم SCP، أن ينجز يأمن مبرد نقل إلى cxd.cisco.com (ال يقيد طبقة يمنع إستعمال آخر أمر). اسم المستخدم هو رقم حالة دعم Cisco وكلمة المرور هي رمز مميز لكل حالة دعم Cisco. يكون اسم المستخدم/كلمة المرور موجودا دائما في ملاحظة في بداية حالة دعم Cisco الخاصة بك ويمكن أيضا إسترداده من مدير حالة الدعم. للحصول على مزيد من التفاصيل حول الرمز المميز، ارجع إلى تحميل ملفات العميل إلى مركز المساعدة التقنية ل Cisco.
$ rca copy --files maglev-10.1.1.233-rca-2024-03-06_14-07-36_UTC.tar.gz 6969XXXXX@cxd.cisco.com:/
FIPS mode initialized
Warning: Permanently added the ECDSA host key for IP address '10.209.135.105' to the list of known hosts.
6969XXXXX6@cxd.cisco.com's password:
maglev-10.1.1.233-rca-2024-03-06_14-07-36_UTC.tar.gz
بدء تشغيل نسخة الملف من جهاز Mac أو Linux إلى حالة دعم Cisco (خيار CLI)
ملاحظة: هذا قسم مناسب إلى ماك أو أي لينوكس نادل. لا ينطبق على مركز Catalyst منذ إصدار 2.3.
هناك خياران لتحميل أي ملف (بما في ذلك RCA) من جهاز Mac أو Linux. في كلا الخيارين، يكون اسم المستخدم هو رقم حالة دعم Cisco وكلمة المرور هي رمز مميز لكل حالة دعم Cisco. يكون اسم المستخدم/كلمة المرور موجودا دائما في ملاحظة في بداية حالة دعم Cisco الخاصة بك ويمكن أيضا إسترداده من مدير حالة الدعم. للحصول على مزيد من التفاصيل حول الرمز المميز، ارجع إلى تحميل ملفات العميل إلى مركز المساعدة التقنية ل Cisco.
نموذج للمخرجات من حالة دعم Cisco:
Subject: 688046089: CXD Upload Credentials
You can now upload files to the case using FTP/FTPS/SCP/SFTP/HTTPS protocols and the following details:
Hostname: cxd.cisco.com
Username: 688046089
Password: gX***********P7
خيار 1. قم بتحميل الملف عبر HTTPS (أسرع خيار ويستخدم المنفذ 443)
الخطوة 1. اختبر ما إذا كان لديك اتصال من جهاز Mac أو Linux الخاص بك إلىcxd.cisco.com
عبر المنفذ 443. هنا طريقة واحدة لإجراء الاختبار:
$ nc -zv cxd.cisco.com 443
Connection to cxd.cisco.com 443 port [tcp/https] succeeded!
$
ملاحظة: إذا فشل الاختبار، لا يمكنك إستخدام هذه الطريقة لتحميل الملف.
الخطوة 2. إذا نجح الاختبار في تحميل الملف عبر HTTPS باستخدام هذا الأمر (لا يعمل هذا من جهاز Catalyst Center):
$ curl -T “” -u https://cxd.cisco.com/home/
(إذا كنت ترغب في رؤية طريقة عرض أكثر تفصيلا للتحميل، فقم بإضافة-v
الخيار. على سبيل المثال،curl -vT…
")
على سبيل المثال:
$ curl -T "./test.txt" -u 688046089 https://cxd.cisco.com/home/
Enter host password for user '688046089':
[Tue Dec 10 13:35:47 UTC] maglev@10.1.1.1(maglev-master-1) ~
$
الخيار 2. تحميل الملف عبر SCP (يستخدم المنفذ 22)
الخطوة 1. اختبر ما إذا كان لديك اتصال من جهاز Mac أو Linux الخاص بك إلىcxd.cisco.com
عبر المنفذ 22. فيما يلي طريقة واحدة لإجراء الاختبار:
$ nc -zv cxd.cisco.com 22
Connection to cxd.cisco.com 22 port [tcp/ssh] succeeded!
$
ملاحظة: إذا فشل الاختبار، لا يمكنك إستخدام هذه الطريقة لتحميل الملف.
الخطوة 2. إذا نجح الاختبار في تحميل الملف عبر SCP باستخدام هذا الأمر:
$ scp @cxd.cisco.com:
على سبيل المثال:
$ scp ./test.txt 688046089@cxd.cisco.com:
The authenticity of host 'cxd.cisco.com (X.X.X.X)' can't be established.
RSA key fingerprint is SHA256:3c8Vi3Ms2AITZlNzkBccR1pvE5ie9oMs64Uh0uhRado.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'cxd.cisco.com,X.X.X.X' (RSA) to the list of known hosts.
688046089@cxd.cisco.com's password:
test.txt 100% 39 0.0KB/s 00:00
[Tue Dec 10 13:44:27 UTC] maglev@10.1.1.1 (maglev-master-1) ~
$