المقدمة

يصف هذا وثيقة cisco PDART - Cisco DNA مركز إستعداد أداة ل ال cisco Prime بنية أساسية.

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

المتطلبات

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

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

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

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

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

تقوم Cisco PDART (أداة Cisco Prime Infrastructure Cisco DNA Center Assessment & Ready) بتحليل نشر Cisco Prime Infrastructure وتقييم ما إذا كان مركز Cisco DNA يدعم النشر الحالي.

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

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

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

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

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

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

يتم تضمين التعاون مع فريق هندسة تصعيد مركز بنية الشبكة الرقمية من Cisco والمبيعات وفريق محركات TAC للمراكز CX.

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

• يتم تنفيذ 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 من CLI

الخطوة 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الأمر الذي يضمن أن لديك الملف التنفيذي، و l - 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أ. التحقق من تجزئة MD5.

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

    $ md5sum pdart
    52f429dd275e357fe3282600d38ba133 pdart

الخطوة 3ب. التحقق من تجزئة 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.

انقرUploadلتحميلUBFملف إلى Cisco Prime.

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

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

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

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

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

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

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

الخطوة 3ب. بمجرد تثبيت 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. uBF و Github.
1.01	تستند جميع التقييمات (حالة الاستخدام، الجهاز، النطاق، التقارير) الآن إلى الإصدار 2.2.3.x من مركز بنية الشبكة الرقمية (DNA) من Cisco. ملف JSON جديد لجميع نقاط الوصول وتوافقها. تم تغيير قسم النظام الأساسي إلى "الاستعداد للترحيل" ويتضمن مراكز وحدة المعالجة المركزية (CPU) والذاكرة الإجمالية ومتوسط حمل وحدة المعالجة المركزية (CPU) وقائمة وموقع نقاط الوصول (AP) المخططة والمباني التي لا يوجد بها أي إعدادات لخط العرض/الطول واستخدام القرص والتحقق من تثبيت أداة الترحيل في المرحلة الثانية. Github فقط.
1.02	التوافق مع PI 3. 10. Github فقط.
1.03	تحقق من عدد الأجهزة غير المدارة وإصلاحات الأخطاء المتعددة والتعطل في توافق الأجهزة. توصيات ترحيل خادم ISE. Github فقط.
1.05	يتضمن إصلاح الأخطاء. دعم كل من UBF و Github.
2.01	تستند جميع التقييمات إلى الإصدار 2.3.3.x من مركز بنية الشبكة الرقمية (DNA) من Cisco. الدعم القديم وعمليات فحص إضافية لمنع الترحيل. متوفر على 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 من مركز بنية الشبكة الرقمية (DNA) من Cisco. ميزة القوالب اللاسلكية المقدمة. متوفر على Github فقط. المجموع الاختباري MD5: fd31d1895b32bdd5bbe557b5b816e57c المجموع الاختباري SHA256: 16343616aadb63b676804e2b49cf1e93e142caede1003c889de462b2d6983ffc
3.02	تستند جميع التقييمات إلى الإصدار 2.3.5.x من مركز بنية الشبكة الرقمية (DNA) من Cisco. مصفوفة توافق الجهاز ضمن PDART يتم تحديثها. عمليات فحص وتعديلات إضافية للترحيل: المواقع التي لا يمكن ترحيلها بسبب الأحرف الخاصة غير المدعومة أو تلك التي تبدأ أو تنتهي بمساحة فارغة. التحقق من الترحيل المخطط للتكرار لتضمين المواقع. الأجهزة التي لا يمكن ترحيلها لأنها جزء من نوع مجموعة غير صحيح أو مجموعة غير صحيحة. متوفر على Github و uBF المجموع الاختباري MD5: 6f774cb32143f7333ad8960bcecd871 SHA256 المجموع الاختباري: 78c82e2ebc2e00ac3fd9a98171bfa98c769a51d12b3fa98b73baaf97fd552236

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

اتصل ب 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 في التشغيل عبر واجهة المستخدم، قم بمشاركة لقطات الشاشة وأي سجلات فاشلة.