المقدمة

يوضح هذا المستند كيفية تكوين نشر AURA قبل ترقية vManage.

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

المتطلبات

توصي Cisco بأن تكون لديك معرفة بالمواضيع التالية:

• شبكة منطقة واسعة معرفة بالبرامج (SD-WAN) من Cisco.

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

تستند المعلومات الواردة في هذا المستند إلى الإصدار 20.9.4 من Cisco vManager

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

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

تقوم أداة سطر الأوامر Cisco AURA-SDWAN (Sure) بتنفيذ ما مجموعه 30 (وضع عدم نظام المجموعة) أو 36 (وضع نظام المجموعة) من التحققات على مستويات مختلفة من تغشية SDWAN. الغرض من الأداة هو منع الأعطال المحتملة والتوصية بإجراءات تصحيحية لعملية ترقية سلسة. تقوم الأداة باسترداد البيانات باستخدام إستدعاءات GET API وأوامر show/shell.

مفهوم أساسي

• فهو يتميز بالبساطة وسهولة الاستخدام، كما أنه يستخدم وحدات python الافتراضية المتوفرة بالفعل على خادم vManage
• إنشاء تقرير TXT تلقائيا.
• يتطلب فقط - vManage وكلمة المرور.
• إدارة المستخدم بامتيازات عامل تشغيل شبكة RO أو المسؤول.
• يجب ألا تحتوي كلمة مرور مستخدم vManage على "!" الحرف.
• للتنفيذ، ما عليك سوى نسخ الملف إلى vManage وتشغيله على الخادم.
• غير تطفلي
• وقت التشغيل - عادة أقل من 60 ثانية، وفقا لحجم النشر
• الوصول الجذر غير مطلوب لإجراء أي تدقيق.
• لا يتم تجميع أية بيانات أو مشاركتها لأي شخص. تظل جميع المعلومات التي تستخدمها الأداة موجودة في التقرير المقدم والسجلات
• لا تستخدم واجهات برمجة تطبيقات الوقت الحقيقي التي لها قيود على النطاق

تنزيل البرنامج النصي على vManage

تحديد ملف إصدار Python المطلوب تنفيذه استنادا إلى إصدار vManage

ملاحظة: إصدار vManage هو 20.9.4، لذلك يجب إستخدام ملف py3_sure.py.

ملاحظة: يمكن تنزيل التطبيق تحت أي دليل مرغوب فيه، وعادة ما يتم تنزيله تحت دليل المستخدم الرئيسي.

الخيار 1 - البيئة المعزولة

الحصول على محتوى الملف من هذا الموقع، ثم النسخ عبر SCP إلى الخادم.

scp source_file.py {user}@{vManageIP}:/home/{user}

ماك أو إس

felix:Downloads felix$ scp -P 28215 py3_sure.py admin@10.124.x.x:/home/admin/
viptela 20.9.4  
(admin@10.124.x.x) Password:  
py3_sure.py                                                     100%  167KB 340.5KB/s   00:00  

نظام التشغيل Windows

C:\Users\felix>scp C:\Users\felix\py3_sure.py admin@10.124.x.x:/home/admin/
viptela 20.9.4

(admin@10.124.x.x) Password:
py3_sure.py 

الخيار 2. طريقة اللصق

• افتح ملف py2_sure.py أو py3_sure.py، انقر على زر نسخ الملف الخام.

• SSH إلى vManage، واستخدم الأمر vshell.

vmanage# vshell

• فتح vi، اضغط على Esc ثم i (حرف i)، ثم لصق المحتوى.

vmanage:~$ vi py3_sure.py
E1187: Failed to source defaults.vim
Press ENTER or type command to continue

• بعد اللصق، اضغط Esc، :wq (الرمز : وحروف w،q) لحفظها.

:wq 

ملاحظة: حفظ وخروج خارج: في وضع الأوامر، اضغط على مفتاح Esc للخروج من وضع الإدخال، ثم اكتب:wq أو:x واضغط enter لحفظ التعديلات والخروج من المحرر السادس.

         لا تحفظ خروج: في وضع الأوامر، اضغط على مفتاح ESC ثم اكتب :q!، واضغط على مفتاح enter لعدم حفظ التعديلات واضطر محرر vi إلى الخروج.

الخيار 3. WGET

تسجيل الدخول إلى جلسة عمل واجهة سطر الأوامر في vManage:

vmanage# vs
vmanage:~$ wget https://raw.githubusercontent.com/CiscoDevNet/sure/main/python3/py3_sure.py 
OR
vmanage:~$ wget https://raw.githubusercontent.com/CiscoDevNet/sure/main/python2/py2_sure.py

تحذير: إذا كنت تستخدم WGET، فيجب عليك جعله بحيث يتمكن vManage من الوصول إلى GItHub.com. 

كيفية التشغيل

خيارات سطر الأوامر

الاستخدام: بالتأكيد.py [-h] [-q] [-v] [-d] -u اسم المستخدم

بالتأكيد - SDWAN Upgrade Readiness Engine - v3.2.1

الوسيطات الاختيارية:
-h، —المساعدة في إظهار رسالة المساعدة هذه والخروج
-q، —تنفيذ هادئ للنص
-v، —تنفيذ سريع للنص

-d، —تصحيح أخطاء تنفيذ البرنامج النصي
-u username، —username
اسم المستخدم vManage
-vp vmanage_port، —vmanage_port vmanage_port
كلمة مرور vManage

التشغيل في وضع التنفيذ العادي

vmanage:~$ python3 py3_sure.py -u admin
vManage Password (Note: Tool doesn't support passwords containing "!") :
#########################################################
###      AURA SDWAN (SURE) - Version 3.2.0            ###
#########################################################
###    Performing SD-WAN Audit & Upgrade Readiness    ###
#########################################################


****Collecting Preliminary Data

*Starting Checks, this may take several minutes

**** Performing Critical checks

 Critical Check:#01
 Critical Check:#02
 Critical Check:#03
 Critical Check:#04
 Critical Check:#05
 Critical Check:#06
 Critical Check:#07
 Critical Check:#08
 Critical Check:#09
 Critical Check:#10
 Critical Check:#11
 Critical Check:#12
 Critical Check:#13
 Critical Check:#14
 Critical Check:#15
 Critical Check:#16
 Critical Check:#17

**** Performing Warning checks

 Warning Check:#18
 Warning Check:#19
 Warning Check:#20
 Warning Check:#21
 Warning Check:#22
 Warning Check:#23
 Warning Check:#24
 Warning Check:#25

**** Performing Informational checks

 Informational Check:#26
 Informational Check:#27
 Informational Check:#28

******
Cisco AURA SDWAN tool execution completed.

Total Checks Performed: 28
Overall Assessment: 4 Critical errors, 2 Warnings, please check report for details.
    -- Full Results Report: sdwan_sure/sure_report_08_07_2025_06_15_25.txt 
    -- Logs: sdwan_sure/sure_logs_08_07_2025_06_15_25.log
    -- Json Summary: sdwan_sure/sure_json_summary_08_07_2025_06_16_22.json

Reach out to sure-tool@cisco.com if you have any questions or feedback

فحص التقرير

vmanage:~$ cat sdwan_sure/sure_report_08_07_2025_06_15_25.txt
E1187: Failed to source defaults.vim
Press ENTER or type command to continue




Cisco SDWAN AURA v3.2.0 Report

Cisco SDWAN AURA command line tool performs a total of 26(Non Cluster Mode) or 32(Cluster Mode) checks at different levels of the SDWAN overlay.

Reach out to sure-tool@cisco.com  if you have any questions or feedback

Summary of the Results:
-----------------------------------------------------------------------------------------------------------------
AURA SDWAN Version:          3.2.0

vManage Details:
        Software Version:    20.9.4        System IP Address:   1.1.1.1

Script Execution Time:
        Start Time:          08-07-2025 06:15:20
        End Time:            08-07-2025 06:16:22

-----------------------------------------------------------------------------------------------------------------

Overall upgrade evaluation:  Critical issues found that need to be resolved before an upgrade

-----------------------------------------------------------------------------------------------------------------

Check Results:
        Total Checks Performed:     28
        Total Checks Passed:        24 out of 28
        Total Checks Failed:        4 out of 28
        Total Checks with Errors:   4
        Total Checks with Warnings: 2

-----------------------------------------------------------------------------------------------------------------

Detailed list of failed checks, and actions recommended

+----------+----------------------------------------------------+----------------------------------------------------+----------------------------------------------------+
| Check no | Check Name                                         | Check Result                                       | Check Actions                                      |
+----------+----------------------------------------------------+----------------------------------------------------+----------------------------------------------------+
| #03      | Memory size                                        | Memory size is 67 GB, it is below the hardware siz | Correct the memory available to the server         |
|          |                                                    | e recommendations when DPI is enabled. Memory size |                                                    |
|          |                                                    |  should be 128 GB. For more information please che |                                                    |
|          |                                                    | ck: https://www.cisco.com/c/en/us/td/docs/routers/  |                                                    |
|          |                                                    | sdwan/release/notes/compatibility-and-server-recom |                                                    |
|          |                                                    | mendations/ch-server-recs-20-3.html                |                                                    |
+----------+----------------------------------------------------+----------------------------------------------------+----------------------------------------------------+
| #04      | CPU Count                                          | No. of Processors is below minimum supported size  | Allocate more processors                           |
|          |                                                    | when DPI is in use. CPU Count is 16, it should be  |                                                    |
|          |                                                    | 32 or higher.                                      |                                                    |
+----------+----------------------------------------------------+----------------------------------------------------+----------------------------------------------------+
| #10      | NTP status across network                          | Devices with invalid ntp association found         | Please validate the NTP time synchronization acros |
|          |                                                    |                                                    | s the network                                      |
+----------+----------------------------------------------------+----------------------------------------------------+----------------------------------------------------+
| #17      | Verify if stale entry of vManage+vSmart UUID prese | The vManage+vSmart UUIDs are not consistent in cEd | Contact TAC to find out why there are inconsistenc |
|          | nt on any one cEdge                                | ges                                                | ies in the vManage+vSmart UUIDS in cEdges          |
+----------+----------------------------------------------------+----------------------------------------------------+----------------------------------------------------+


-----------------------------------------------------------------------------------------------------------------

Preliminary Tabulated data:

+----------------------------------------------------+---------------+
| Parameters                                         | Value         |
+----------------------------------------------------+---------------+
| vManage System IP address                          | 1.1.1.1       |
+----------------------------------------------------+---------------+
| vManage CPU Speed                                  | 2.198         |
+----------------------------------------------------+---------------+
| vManage CPU Count                                  | 16            |
+----------------------------------------------------+---------------+
| xEdge Count                                        | 10            |
+----------------------------------------------------+---------------+
| vManage Cluster Size                               | 1             |
+----------------------------------------------------+---------------+
| vManage Server Mode                                | Single Server |
+----------------------------------------------------+---------------+
| vManage Disk Controller Type                       | /dev/sdb      |
+----------------------------------------------------+---------------+

تحميل التقرير من vManage إلى الكمبيوتر المحلي

الخيار 1. Viptela CLI

vmanage# vs 
vmanage:~$ scp sdwan_sure/sure_report_08_07_2025_06_15_25.txt /home/admin
vmanage:~$ ls -l
total 1812
-rw------- 1 admin admin 2 Jul 8 06:21 123
-rw------- 1 admin admin 0 Jul 8 06:21 456
-rw-r--r-- 1 admin admin 566 May 9 17:10 archive_id_rsa.pub
-rwxrwxr-x 1 vmanage admin 1235617 Jul 2 03:07 config_db.tar.gz
-rw------- 1 admin admin 178539 Jul 8 07:42 py2_sure.py
-rw------- 1 admin admin 178540 Jul 8 07:09 py3_sure.py
drwx------ 2 admin admin 4096 Jul 8 08:14 sdwan_sure
-rw------- 1 admin admin 25544 Jul 8 08:18 sure_report_08_07_2025_06_15_25.txt                     <<<<<<
-rw------- 1 admin admin 15260 Jul 4 05:34 test.pcap
-rw------- 1 admin admin 178540 Jul 8 06:13 test0708
-rw-r--r-- 1 admin admin 1216 Jan 15 2024 vmanage_csr
vmanage:~$ exit

vmanage# request upload vpn 512 scp://admin@10.207.x.x:/test.file sure_report_08_07_2025_06_15_25.txt 
Warning: Permanently added '10.207.x.x' (ECDSA) to the list of known hosts.

admin@10.207.x.x's pasword: 
sure_report_08_07_2025_06_15_25.txt 100% 25KB 479.5KB/s 00:00 
Upload successful

الخيار 2. محطة لينوكس/ماك الطرفية

صياغة الأمر:

تتم قراءة الأمر كما يلي:copy source_file_name من vManage interface_destination_path باستخدام اسم المستخدم vManage.

scp vManageUsername@PublicIp:<source_file_name> <local_destination_path>

مثال:

ربطت إلى Linux/Mac انتهائية محلي وشغل ال SCP أمر أن ينسخ الملف إلى الدليل المرغوب.

adminIT@cisco:~$ scp admin@10.124.X.X:sure_report_08_07_2025_06_15_25.txt  /Users/adminIT/Downloads/
viptela 20.9.4

Password:
sure_report_08_07_2025_06_15_25.txt  100% 25KB 479.5KB/s

الخيار 3. FileZilla أو أي عميل FTP أو SFTP آخر

الاتصال ب:

• SFTP كبروتوكول أو منفذ 22
• عنوان URL الخاص بإدارة vManage أو IP العام أو IP الخاص (إذا كان vManage متوفرا على الكمبيوتر)
• إستخدام اسم مستخدم وكلمة مرور صحيحين

في FTP أو SFTP Client، يتم سرد الملفات الموجودة في الدليل الرئيسي للمستخدم vManage. قم فقط بالسحب والإفلات إلى الوجهة المحلية على اليسار حيث تريد نقل الملف.

معلومات ذات صلة

• ترقية وحدات التحكم في SD-WAN باستخدام واجهة المستخدم الرسومية (GUI) vManage أو واجهة سطر الأوامر (CLI)
• AURA-SDWAN (بالتأكيد)
• نقل الملفات بين cEdge و vManage