المقدمة

يصف هذا وثيقة cisco PDART - cisco مادة حفازة مركز جاهزية أداة ل ال cisco prime بنية أساسية.

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

المتطلبات

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

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

تستند المعلومات الواردة في هذا المستند إلى النظام الأساسي Cisco Catalyst Center والبنية الأساسية Cisco Prime.

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

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

تحلل أداة Cisco Prime Infrastructure Data Assessment & Readiness Tool (Cisco PDART) نشر Cisco Prime Infrastructure وتقيم ما إذا كان مركز Cisco Catalyst يدعم النشر الحالي.

يقيم PDART البنية الأساسية ل Cisco Prime من هذه المنظورات:

1. إستخدام الحالات - يمكن أن تقوم هذه الأداة بالتحقق من أكثر من 170 حالة إستخدام تلقائيا. وهو يتحقق مما إذا كانت حالات الاستخدام هذه قيد الاستخدام أو تم إستخدامها في الماضي. بعد ذلك يقيم كل حالة إستخدام (قيد الاستخدام/المستخدم فقط) مقابل مركز Cisco Catalyst. وهو يقيم ما إذا كانت حالات الاستخدام هذه مدعومة حاليا، أو غير مدعومة، أو على خريطة الطريق لمركز Cisco Catalyst. هناك 23 حالة إستخدام إضافية تتطلب التحقق اليدوي وهذه مدرجة في التقرير.
2. Scale Parameters - يمكن لهذه الأداة التحقق من تسعة معلمات للقياس تلقائيا ومقارنة المقياس بالقيم القصوى المدعومة للنشر الحالي. ثم يقوم بمقارنة معلمات النطاق هذه مع النطاق الموصى به عبر مختلف عوامل الشكل المادية لمركز Cisco Catalyst.
3. التقارير - يمكن أن تحدد هذه الأداة التقارير المستخدمة والمجدولة. وهو يقارن هذه التقارير بتلك المتاحة مع مركز Cisco Catalyst ويقيم ما إذا كانت هذه التقارير مدعومة حاليا، أو غير مدعومة، أو على خريطة الطريق.
4. توافق الأجهزة - يمكن لهذه الأداة اكتشاف جميع الأجهزة التي تمت إدارتها وتخطيط كل جهاز إلى قائمة الأجهزة المدعومة في مركز Cisco Catalyst. وهو يقوم بتقييم كل جهاز استنادا إلى توافق الأجهزة وتوافق البرامج والدعم القديم الخاص به.
5. عمليات التحقق من الاستعداد للترحيل - يتضمن هذا القسم عشر عمليات فحص تتضمن عمليات التحقق من الصحة الأساسية لجهاز البنية الأساسية Cisco Prime، وتحليل أدوات منع الترحيل المعروفة. (يمكن الحصول على عمليات تحقق إضافية قريبا.)
6. القوالب (المضافة في PDART الإصدار 3.01) - يمكن أن تحدد هذه الأداة القوالب اللاسلكية التي تم دفعها بواسطة البنية الأساسية ل Cisco Prime. وهو يقيم ما إذا كان هذه القوالب يمكن تطبيقها بواسطة مركز Cisco Catalyst والخصائص المدعومة من قبل مركز Cisco Catalyst.

PDART هو أداة سهلة الاستخدام للقراءة فقط ولا تسبب أي تأثير. كما أنها لا تحتفظ بأية معلومات سرية أو ترسل أي معلومات خارج عملية النشر. يقيم PDART النشر لإصدار 2.3.x من Cisco Catalyst Center.

إن مخرجات الأداة هي TAR GZ ملف يحتوي على:

1. PDF مبرد - تقييم ملخص لنشر البنية الأساسية ل Cisco Prime الحالي والتخطيط باستخدام مركز Cisco Catalyst
2. Run log الملف - يحتوي على سجلات تشغيل وحدة التحكم
3. JSON الملف - يحتوي على التقرير بتنسيق JSON
4. Debug Log الملف - يحتوي على مكبات قاعدة بيانات (DB) للحصول على معلومات إضافية حول الإعداد (مفيد لاستكشاف الأخطاء وإصلاحها)
5. AP Log ملف - قائمة بكل نقاط الوصول (AP) وتوافقها

عندما يتم تنفيذ PDART عبر واجهة المستخدم، فإن المخرجات هي ملفان، TAR GZ والملف كما هو PDF الملف.

تعاون مدمج مع فريق هندسة التصعيد والمبيعات وفريق محركات TAC في مراكز CX و Catalyst Center.

متطلبات الأداة

• يتم تنفيذ PDART على البنية الأساسية ل Cisco Prime.
• يعمل خيار CLI مع إصدار Cisco Prime Infrastructure 3.5 والإصدارات الأحدث فقط.
• يعمل خيار uBF مع إصدار Cisco Prime Infrastructure 3.7 والإصدارات الأحدث فقط.
• إذا كان لديك عمليات نشر متعددة ل Cisco Prime، فيجب تنفيذ PDART على كل عملية نشر.
• يجب تنفيذ PDART كجذر مستخدم (متطلب لتنفيذ PDART من CLI فقط).
  
• إذا كان نشر بنية Prime الأساسية من Cisco زوج إمكانية توفر عالية (HA) (تكوين ميزة HA)، فاستخدم الإجراءات المفصلة هنا لتثبيت PDART uBF (متطلب لتنفيذ PDART من uBF فقط).

تنفيذ الأداة

هناك طريقتان لتشغيل الأداة:

الخيار 1: تشغيل ملف PDART التنفيذي من واجهة سطر الأوامر

الخطوة 1. انسخ الملف القابل للتنفيذ pdart من Github إلى أي دليل على البنية الأساسية ل Cisco Prime. يتوفر أحدث إصدار من PDART القابل للتنفيذ في هذا الموقع: CiscoDevNet/PDART.

هناك طريقتان لنسخ الملف:

1. أداة لنقل الملفات مثل Filezilla أو WinSCP.
2. إذا كانت بنية Cisco Prime الأساسية تحتوي على اتصال بالإنترنت، فأستخدم هذا الأمر لتنزيل الملف:

wget --no-check-certificate https://github.com/CiscoDevNet/PDART/raw/main/pdart

مثال:

[root@pi ~]# wget --no-check-certificate https://github.com/CiscoDevNet/PDART/raw/main/pdart
--2021-07-16 00:23:44-- https://github.com/CiscoDevNet/PDART/raw/main/pdart
Resolving github.com (github.com)... 10.82.113.3
Connecting to github.com (github.com)|10.82.113.3|:443... connected.
HTTP request sent, awaiting response... 302 Found
Location: https://raw.githubusercontent.com/CiscoDevNet/PDART/main/pdart [following]
--2021-07-16 00:23:44-- https://raw.githubusercontent.com/CiscoDevNet/PDART/main/pdart
Resolving raw.githubusercontent.com (raw.githubusercontent.com)... 192.168.109.133, 192.168.108.133, 192.168.108.133, ...
Connecting to raw.githubusercontent.com (raw.githubusercontent.com)|192.168.109.133|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 14545120 (14M) [application/octet-stream]
Saving to: ‘pdart’

100%[=============================================================================================================================================================================================================>] 14,545,120 11.2MB/s in 1.2s

2021-07-16 00:23:45 (11.2 MB/s) - ‘pdart’ saved [14545120/14545120]

[root@pi ~]#

الخطوة 2. قم بتغيير أذونات الملف إلى قابلة للتنفيذ.

[root@pi ~]# chmod 755 pdart

قم بتنفيذ الأمر Linux file لضمان حصولك على الملف القابل للتنفيذ و ls -l للتحقق مما إذا كان chmod الأمر قد سمح للمستخدم الجذري بتنفيذ الملف pdart.

file pdart
ls -l pdart

مثال:

[root@pi ~]# file pdart
pdart: ELF 64-bit LSB executable, x86-64, version 1 (SYSV), dynamically linked (uses shared libs), for GNU/Linux 2.6.32, BuildID[sha1]=294d1f19a085a730da19a6c55788ec08c2187039, stripped
[root@pi ~]# 
[root@pi ~]#  ls -l pdart
-rwxr-xr-x. 1 root root 14545120 Jul 16 00:23 pdart
[root@pi ~]# 

الخطوة 3. (إختياري) تحقق من تجزئة الملف pdart لضمان تنزيل الملف الصحيح.

لضمان تنزيل الملف الصحيح، قارن قيم تجزئة MD5 أو تجزئة SHA256 المتوفرة في نهاية هذه الصفحة. يمكن أن يحتوي كل إصدار من PDART على مجموعة فريدة من قيم التجزئة.

الخطوة 3.1. التحقق من تجزئة MD5.

أستخدم الأمر md5sum (كما هو مدرج). قم بإنشاء التجزئة على Cisco Prime الوارد لديك أو أي نظام Linux آخر وقارن قيمة التجزئة مع القيمة في نهاية هذه الصفحة. 

    $ md5sum pdart
    52f429dd275e357fe3282600d38ba133 pdart

الخطوة 3.2. التحقق من تجزئة SHA256.

أستخدم الأمر sha256sum (كما هو مدرج). قم بإنشاء التجزئة على Cisco Prime الوارد لديك أو أي نظام Linux آخر وقارن قيمة التجزئة مع القيمة في نهاية هذه الصفحة.

    $ sha256sum pdart
    c91b6092ab4fa57adbe698a3c17f9146523bba5b0315222475aa4935662a0b6e pdart

الخطوة 4. أمر واحد لتنفيذ الملف من CLI (تأكد من أنك قمت بتسجيل الدخول كجذر مستخدم).

 ./pdart

نموذج للمخرجات من واجهة سطر الأوامر:

[root@pi ~]# ./pdart
####################################################
###                                              ###
###          Welcome to Cisco PDART              ###
###               version: 3.01                  ###
###                                              ###
####################################################
###

## 
## Script Start Time: 2023-06-12_13:03:25 
##


###### 
## 
## Initiating DB Accessible Check ... 
##


# DB is accessible, continuing....

###### 
## 
## Initiating Platform Checks ... 
##

...


###### 
## 
## All Checks completed, building the PDF ... 
##


## Summary page built, working on the pages with the details...


## Report built for - Device compatibility checks...


## Report built for - Scale checks...


## Report built for - Use Case checks...


## Report built for - Reporting checks...


## Report built for - Wireless Templates checks...


## Report built for - Platform checks...


## 
## Script End Time: 2023-06-12_13:07:13 
##



******
Cisco PDART Tool has successfully completed.
PDF report, run logs and a json of the results can be found at:

PDART tarfile - /localdisk/defaultRepo/pdart.d/PDART_2023-06-12_13-03-25.tar.gz
[root@pi ~]#

الخطوة 5. يتم إنشاء ملف واحد TAR GZ بواسطة الأداة ويتوفر في الموقع /localdisk/defaultRepo/pdart.d/. يمكن نسخ الملف من Prime باستخدام Filezilla أو WinSCP. يمكن حل TAR GZ الملف قبل أو بعد النسخة.

يمكن أن يقوم هذا الأمر بإلغاء تحديد الملف على البنية الأساسية ل Cisco Prime لديك (خطوة إختيارية).

[root@pi ~]# tar -xvf PDART_2023-06-12_13-03-25.tar.gz
PDART_report_2023-06-12_13-03-25.pdf
PDART_results_2023-06-12_13-03-25.json
PDART_runlog_2023-06-12_13-03-25.log
PDART_aps_2023-06-12_13-03-25.json
PDART_debuglog_2023-06-12_13-03-25.log
[root@pi ~]#

الخيار 2: تنفيذ PDART عبر حزمة UBF

يمكن تنفيذ PDART عبر واجهة المستخدم باستخدام هذه الطريقة. يعد PDART القابل للتنفيذ جزءا من ملف تصحيح Updated Bundle File (UBF) يجب تنزيله من Cisco.com وتحميله إلى المثيل Prime، ثم تثبيته. بيانات اعتماد الجذر ليست متطلبا لهذا الخيار. هذه هي الخطوات التفصيلية:

الخطوة 1. تعرف على إصدار البرنامج الخاص بك وقم بتنزيل UBF المطابق من Cisco.com.

قم بتنزيل الملف الذي يبدأ ب DNACAssessmentReadiness_(يلزم تسجيل الدخول إلى CCO لتنزيل الملف).

3.10.1 - برنامج تنزيل Prime Infrastructure، الإصدار 3.10.1

3.9.1 - برنامج تنزيل Prime Infrastructure الإصدار 3.9.1

3.8.1 - برنامج تنزيل Prime Infrastructure، الإصدار 3.8.1

3.7.1 - تنزيل البرنامج Prime Infrastructure، الإصدار 3.7.1

هنا صورة ل 3.8.1:

Primeubf381

الخطوة 2. قم بتحميل الملف UBF من النظام المحلي وتثبيته (يلزم إعادة تحميل Cisco Prime).

بمجرد تنزيل الملف إلى النظام المحلي، يمكن تحميل الملف وتثبيته UBF عبر واجهة المستخدم. من القائمة الرئيسية، انتقل إلى صفحة تحديث البرامج.

انقرAdministration > Licenses and Software Updates > Software Update and then click Upload لتحميل UBF الملف إلى Cisco Prime.

تصفح خلال الكمبيوتر المحلي لاختيار UBF الملف المطلوب وانقر Ok.

بمجرد تحميل الملف، انقر فوق Install الزر لتثبيت UBF.

انقر Yes في الإطار المنبثق لإعادة تشغيل بنية Cisco Prime الأساسية وتثبيت UBF.

تتم إعادة تشغيل البنية الأساسية ل Cisco Prime وتخرج من الخدمة لمدة تتراوح من 15 إلى 30 دقيقة.

الخطوة 3. انتقل إلى شاشة PDART (إما الخطوة 3.1. أو 3.2.).

الخطوة 3.1. بمجرد تثبيت UBF، انتقل إلى عنوان URL هذا الذي يعرض الصفحة الرئيسية ل PDART. انقر RUN PDART TOOL لتنفيذ PDART.

https://<Cisco Prime IP Address>/webacs/pdart.jsp

الخطوة 3.2. بمجرد تثبيت UBF، وفي حالة تثبيت "أداة ترحيل البيانات ل Prime" الإصدار 5 أيضا، يمكن تشغيل PDART من قائمة الهمبرجر كما هو الحال بالنسبة لالتقاط هذه الشاشة.

الخطوة 4. تنفيذ PDART من واجهة المستخدم.

تلتقط الشاشة هذه ترشدك خلال تنفيذ PDART:

يستغرق PDART حوالي 3-5 دقائق من أجل إكماله في معظم الحالات، ولكن في الإعداد الذي تم قياسه، يمكن أن يستغرق ما يصل إلى 10 دقائق للاكتمال.

تظهر هذه الخيارات بمجرد أن ينتهي PDART من التنفيذ.

انقر Download PDART Report لعرض تقرير PDART PDF أو انقر Back to Main Page، للعودة إلى الصفحة الرئيسية لإعادة تشغيل PDART.

تقرير عينة

تتضمن الصورة الصفحة الأولى من التقرير والتي هي ملخص لكل التحققات التي تم تنفيذها. الصفحات التالية تتضمن تفاصيل أكثر عن التحققات التي تم تنفيذها.

إصدارات PDART

إصدار PDART	التعليقات
حتى 0.09	تستند جميع التقييمات إلى الإصدار 2.2.2.x من Cisco Catalyst Center. UBF و Github.
1.01	تستند جميع التقييمات (حالة الاستخدام، الجهاز، المقياس، التقارير) الآن إلى الإصدار 2.2.3.x من Cisco Catalyst Center. ملف JSON جديد لجميع نقاط الوصول (APs) وتوافقها. تم تغيير قسم النظام الأساسي إلى "الاستعداد للترحيل" ويتضمن مراكز وحدة المعالجة المركزية (CPU)، والذاكرة الإجمالية، ومتوسط حمل وحدة المعالجة المركزية (CPU)، وقائمة وموقع نقاط الوصول المخطط لها، والمباني التي لا يوجد بها أي إعدادات لخط العرض/الطول، واستخدام القرص، والتحقق من تثبيت أداة الترحيل في المرحلة الثانية. Github فقط.
1.02	التوافق مع PI 3. 10. Github فقط.
1.03	تحقق من عدد الأجهزة غير المدارة وإصلاحات الأخطاء المتعددة والتعطل في توافق الأجهزة. توصيات ترحيل خادم ISE. Github فقط.
1.05	يتضمن إصلاح الأخطاء. دعم كل من UBF و Github.
2.01	تستند جميع التقييمات إلى الإصدار 2.3.3.x من Cisco Catalyst Center. الدعم القديم وعمليات فحص إضافية لمنع الترحيل. متوفر على Github فقط.
2.02	يتوفر هذا الإصدار في كلا النمطين، ك uBF (التحديث 3) على CCO ويتوفر كقابل للتنفيذ على Github. أرقام المقياس متوافقة مع الأرقام الجديدة المنشورة لإصدار 2.3.3.x. ملفات UBF هي: Cisco DNACAessessreadiness_3_7_update_03-1.0.3.ubf Cisco DNACAessessreadiness_3_8_update_03-1.0.3.ubf Cisco DNACAessmentReadiness_3_9_Update_03-1.0.3.ubf Cisco DNACAessessreadiness_3_10_update_03-1.0.3.ub
2.03	إصلاح الأخطاء الثانوية ومتوفر على Github فقط.
2.04	إصلاح الأخطاء الثانوية ومتوفر على Github فقط.
3.01	تستند جميع التقييمات إلى الإصدار 2.3.5.x من Cisco Catalyst Center. ميزة القوالب اللاسلكية المقدمة. متوفر على Github فقط. المجموع الاختباري MD5: fd31d1895b32bdd5bbe557b5b816e57c المجموع الاختباري SHA256: 16343616aadb63b676804e2b49cf1e93e142caede1003c889de462b2d6983ffc
3.02	تستند جميع التقييمات إلى الإصدار 2.3.5.x من Cisco Catalyst Center. يتم تحديث مصفوفة توافق الجهاز ضمن PDART. عمليات فحص وتعديلات إضافية للترحيل: المواقع التي لا يمكن ترحيلها بسبب الأحرف الخاصة غير المدعومة أو تلك التي تبدأ أو تنتهي بمساحة فارغة. التحقق من الترحيل المخطط للتكرار لتضمين المواقع. الأجهزة التي لا يمكن ترحيلها لأنها جزء من المجموعة الخطأ أو نوع المجموعة الخطأ. متوفر على Github و ubf. المجموع الاختباري MD5: 6f774cb32143f7333ad8960bcecd871 SHA256 المجموع الاختباري: 78c82e2ebc2e00ac3fd9a98171bfa98c769a51d12b3fa98b73baaf97fd552236
3.03	غيرت الإسم إلى cisco مادة حفازة مركز. Github فقط.

مشكلات الأداة

اتصل ب pdart-tool-support@cisco.com للحصول على أي مساعدة حول الأداة.

إذا تم تنزيل ملف PDART إلى Cisco Prime Infrastructure بنجاح ولكنه لا يتم تنفيذه، فعليك مشاركة إخراج هذه Linux الأوامر:

file pdart
ls -l pdart
log files in /localdisk/defaultRepo/pdart.d/
tool run logs seen on screen (in case of CLI version) 

إذا فشل PDART في التشغيل عبر واجهة المستخدم، قم بمشاركة لقطات الشاشة وأي سجلات فاشلة.