توليد واستخراج ملف RCA من مركز Catalyst
المحتويات
المقدمة
يصف هذا وثيقة كيف أن يخلق ويستخرج ال RCA مبرد (حزمة دعم) من cisco مادة حفازة مركز (سابقا cisco DNA مركز).
معلومات أساسية
ال الجذر سبب تحليل (RCA) مبرد دعم حزمة يخلق على المادة حفازة مركز. يتضمن مخرجات أوامر متعددة وسجلات خدمات، يعطي أساسا لقطة من مركز Catalyst. وهو يسمح لمهندسي الدعم باستكشاف المشكلات وحلها بشكل أسرع. ولا يشمل هذا النظام نواتج من قواعد البيانات. في وقت سابق، تم إنشاء ملف RCA وتنزيله من واجهة سطر الأوامر (CLI) فقط، ولكن تم تغيير ذلك من الإصدار 2.3.7.6. جميع مخرجات الأوامر في هذا المستند ذات صلة من الإصدار 2.3.3.x.
توليد الجذر سبب تحليل مبرد (RCA أو حزمة دعم)
الخطوة الأولى هي إنشاء ملف RCA. يمكن إنشاء ذلك إما من واجهة المستخدم (UI) أو واجهة سطر الأوامر (CLI).
نشر أي جهاز مادي (خيار واجهة المستخدم)
بدءا من 2.3.7.6 هناك خيار جديد لإنشاء ملف RCA من واجهة مستخدم Catalyst Center، ويشار إليها أيضا باسم حزمة الدعم في واجهة المستخدم. أيضا، هناك خيار جديد يزود في ال UI مثل إمكانية أن يختار الإطار الزمني من السجل أو أن يختار تطبيق خاص سجل حزمة. تتوفر هذه الخيارات لجميع عمليات نشر الأجهزة المادية.
الخطوة 1: انقر فوق خيار حزمة الدعم في قائمة التعليمات في الشريط العلوي.
الخطوة 2: تظهر منبثقة جديدة قائمة بحزم الدعم التي تم إنشاؤها في وقت سابق أو مجرد خيار لإنشاء واحد جديد إذا كان هذا هو الخيار الأول.
الخطوة 3: طقطقة يخلق دعم حزمة وآخر جديد يظهر pop-up. يمكن تحديد فترة زمنية لمجموعة الدعم. إذا كانت المشكلة قد ظهرت قبل يومين، فيرجى إختيار تاريخ البدء على الأقل قبل ذلك التاريخ لمجموعة الدعم. يتم تعيين الحد الأقصى للفترة الزمنية لشهر واحد بشكل افتراضي من الوقت الحالي. الرجاء التأكد من تحديد فئة النظام دائما. استنادا إلى نوع المشكلة، يمكن تحديد فئة تطبيق إضافية (إختياري). يمكن أن يستغرق إنشاء الملف ما يصل إلى 30 دقيقة (يمكن أن يستغرق المزيد من الوقت لعمليات النشر واسعة النطاق).
الخطوة 4: تأكد من التقاط ملف RCA كامل لمشكلتك. اكتب true في الخيار الأخير قبل النقر على زر إرسال حيث يضمن ذلك التقاط مخرجات إضافية.
نظام المجموعة / الجهاز الظاهري أحادي العقدة (خيار واجهة سطر الأوامر)
سجل الدخول إلى Catalyst Center CLI على المنفذ 2222 واستخدمmaglevكاسم مستخدم. ثم قم بتنفيذrcaالأمر لإنشاء ملف RCA. يتم إنشاء ملف RCA وتخزينه فيdata/rca. يستغرق إنشاء الملف عادة حوالي 30 دقيقة. اسم الملف له التنسيقmaglev-.
نموذج قائمة تعليمات أمر 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 من جميع العقد أثناء توزيع الخدمات عبر العقد. إذا طلب مركز Catalyst عنوان IP لنظام المجموعة، فيمكن أن يكون هذا أي عنوان IP لعقدة/نظام مجموعة يمكن الوصول إليها. وهذا مطلوب للحصول على الرمز المميز للمسؤول المطلوب بدوره لبعض مخرجات الأمر.
[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/الدعم في المجلد /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. يعمل هذا على إعادة برمجة إمكانية زر إجراء السهم العلوي ويسمح بتحميل الملف إلى حالة دعم Cisco دون أي بيانات اعتماد. لمزيد من التفاصيل، راجع وثائق CSAE.
بدء تشغيل نسخة الملف من جهاز يعمل بنظام التشغيل Windows أو Mac أو Linux (خيار واجهة المستخدم)
الخطوة 1. تنزيل WinSCP (في حالة نظام التشغيل Windows فقط) أو FileZilla أو عميل SCP/SFTP المفضل لديك.
خطوة 2. يزود ك مادة حفازة مركز عنوان مع ك CLI اعتماد، يختارSCP أو SFTP كمبرد بروتوكول، واخترت الميناء رقم 2222.
الخطوة 3. انتقل إلىdata/rcaالمجلد.
الخطوة 4. انسخ ملف RCA إلى الكمبيوتر المحلي.
بدء تشغيل نسخة الملف من جهاز 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)
من ال 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)
وهذا مماثل للخيار السابق، والذي يستغل SCP لإجراء نقل آمن للملفات إلى cxd.cisco.com (يمنع shell المقيد إستخدام أوامر أخرى). اسم المستخدم هو رقم حالة دعم 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)
هناك خياران لتحميل أي ملف (بما في ذلك 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) ~
$
محفوظات المراجعة
| المراجعة | تاريخ النشر | التعليقات |
|---|---|---|
5.0 |
23-Apr-2026
|
عنوان محدث، نص بديل، متطلبات النمط، والتنسيق. |
4.0 |
12-Mar-2025
|
تم تحديث قسم المقدمة والروابط المصححة والارتباطات المصححة لفتح صفحة جديدة ومراجعة تعليقات المستخدمين وفحصها بحثا عن معلومات أساسية (PII). |
2.0 |
17-Feb-2022
|
المشكلات المتعلقة باسم المنتج التي تم تصحيحها. |
1.0 |
13-Aug-2021
|
الإصدار الأولي |
التعليقات