Einleitung

In diesem Dokument wird beschrieben, wie Sie die AURA-Bereitstellung vor dem vManage-Upgrade konfigurieren.

---

Voraussetzungen

Anforderungen

Cisco empfiehlt, dass Sie über Kenntnisse in folgenden Bereichen verfügen:

• Cisco Software-defined Wide Area Network (SD-WAN).

---

Verwendete Komponenten

Die Informationen in diesem Dokument basieren auf Cisco vManager Version 20.9.4.

Die Informationen in diesem Dokument beziehen sich auf Geräte in einer speziell eingerichteten Testumgebung. Alle Geräte, die in diesem Dokument benutzt wurden, begannen mit einer gelöschten (Nichterfüllungs) Konfiguration. Wenn Ihr Netzwerk in Betrieb ist, stellen Sie sicher, dass Sie die möglichen Auswirkungen aller Befehle kennen.

---

Hintergrundinformationen

Das Cisco AURA SD-WAN (SURE)-Befehlszeilentool führt auf verschiedenen Ebenen des SD-WAN-Overlays insgesamt 30 (nicht im Cluster-Modus) oder 36 (im Cluster-Modus) Prüfungen durch. Dieses Tool soll potenzielle Fehler verhindern und Korrekturmaßnahmen für einen nahtlosen Upgrade-Prozess empfehlen. Dieses Tool ruft Daten mithilfe von GET API-Aufrufen und Show/Shell-Befehlen ab.

---

Grundkonzept

• Einfach und unkompliziert. Verwendet Standard-Python-Module, die bereits auf dem vManage-Server verfügbar sind.
• Generiert automatisch einen .TXT-Bericht.
• Erfordert nur Ihren vManager und Ihr Kennwort.
• vManager-Benutzer mit Administrator- oder RO-Netzwerkbetreiberberechtigungen.
• Das Benutzerkennwort von vManage darf kein "!" enthalten. zeichen.
• Kopieren Sie die Datei zum Ausführen einfach in vManage, und führen Sie sie auf dem Server aus.
• Nicht aufdringlich.
• Die Laufzeit beträgt in der Regel weniger als 60 Sekunden, abhängig von der Bereitstellungsgröße.
• Für die Durchführung von Prüfungen ist kein Root-Zugriff erforderlich.
• Es werden keine Daten gesammelt oder an Dritte weitergegeben. Alle vom Tool verwendeten Informationen bleiben in den bereitgestellten Berichten und Protokollen erhalten.
• Verwendet keine Real-Time-APIs mit Skalierungseinschränkungen.

---

Skript für vManage herunterladen

Identifizieren der Python-Versionsdatei, die basierend auf der vManage-Version ausgeführt werden soll

vManage-Version	Python-Version	Python-Datei ausführen
Vor 20,5	Python 2	python2/py2_sure.py
20,5 Jahre und älter	Python 3	python3/py3_sure.py

Option 1: Isolierte Umgebung

1. Holen Sie den Dateiinhalt von dieser Website, dann kopieren über SCP auf den Server.

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

---

MAC-Betriebssystem

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-Betriebssystem

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 

---

Option 2. Paste-Methode

1. Öffnen Sie die Datei py2_sure.py oder py3_sure.py und klicken Sie auf Rohdatei kopieren.

---

---

2. SSH zum vManage ausführen und den Befehl vshell ausführen.

vmanage# vshell

---

3. vi öffnen, Esc drücken und dann i (Buchstabe i), dann den Inhalt einfügen.

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

---

4. Nach dem Einfügen drücken Sie Esc, :wq (Symbol : und Buchstaben w,q) zu speichern.

:wq 

Option 3: WGET

1. Melden Sie sich bei der vManage CLI-Sitzung an:

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

Ausführung

Befehlszeilenoptionen

Verwendung: sure.py [-h] [-q] [-v] [-d] -u BENUTZERNAME

SURE - SDWAN Upgrade Readiness Engine - v3.2.1

optionale Argumente:
-h, —help zeigt diese Hilfe an und beendet den Vorgang
-q, —silet Ruhige Ausführung des Skripts
-v, —verbose Ausführliche Ausführung des Skripts

-d, —debug Ausführung des Skripts debuggen
-u USERNAME, —username USERNAME
vManage-Benutzername
-vp VMANAGE_PORT, —vmanage_port VMANAGE_PORT
vManage-Kennwort

---

Im normalen Ausführungsmodus ausführen

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 

---

Bericht prüfen

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 | +----------------------------------------------------+---------------+ 

---

Bericht von vManage auf lokalen Computer hochladen

Option 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

---

Option 2: Linux/Mac-Terminal

Befehlssyntax - Der Befehl lautet wie folgt: copy source_file_name from vManage into local_destination_path with vManage username.

scp vManageUsername@PublicIp:<source_file_name> <local_destination_path>

---

Beispiel: Stellen Sie eine Verbindung mit Ihrem lokalen Linux/Mac-Terminal her, und führen Sie den SCP-Befehl aus, um die Datei in das gewünschte Verzeichnis zu kopieren:

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

---

Option 3. FileZilla oder ein anderer FTP- oder SFTP-Client

Verbindung herstellen mit:

• SFTP als Protokoll oder Port 22
• vManage-URL, öffentliche oder private IP (sofern vManage vor Ort ist)
• Verwenden Sie einen gültigen Benutzernamen und ein gültiges Kennwort

Auf dem FTP- oder SFTP-Client werden die Dateien im vManage-Basisverzeichnis aufgeführt. Ziehen Sie die Datei einfach an das lokale Ziel auf der linken Seite, wo Sie sie übertragen möchten.

---

Zugehörige Informationen

• Upgrade von SD-WAN-Controllern mithilfe der vManage-GUI oder -CLI 
• AURA-SD-WAN (SICHER) 
• Übertragen von Dateien zwischen einem cEdge und vManage 

Revisionsverlauf

Überarbeitung	Veröffentlichungsdatum	Kommentare
2.0	12-Oct-2026	Aktualisierte Rechtschreibung, Grammatik, Abstände, eingefügte horizontale Linien in separate Abschnitte zur besseren Lesbarkeit, korrigierte CCW-Warnungen.
1.0	18-Sep-2025	Erstveröffentlichung