Einleitung

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

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-SDWAN (SURE)-Befehlszeilentool führt auf verschiedenen Ebenen des SDWAN-Overlays insgesamt 30 (nicht im Cluster-Modus) oder 36 (im Cluster-Modus) Prüfungen durch. Der Zweck des Tools besteht darin, potenzielle Fehler zu vermeiden und Korrekturmaßnahmen für einen nahtlosen Upgrade-Prozess zu empfehlen. Das Tool ruft Daten mithilfe von GET API-Aufrufen und Show/Shell-Befehlen ab.

Grundkonzept

• Einfach und unkompliziert; verwendet standardmäßige Python-Module, die bereits auf dem vManage-Server verfügbar sind
• Generiert automatisch einen TXT-Bericht.
• Nur erforderlich - vManage und Kennwort.
• vBenutzer mit Administrator- ODER RO-Netzwerkbetreiberberechtigungen verwalten.
• 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 störend
• Laufzeit - 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 im bereitgestellten Bericht und in den Protokollen erhalten.
• Verwenden Sie 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

Anmerkung: Die Version vmanage ist 20.9.4, daher muss die Datei py3_sure.py verwendet werden.

Anmerkung: Die Anwendung kann unter einem beliebigen Verzeichnis heruntergeladen werden, in der Regel wird sie unter dem Home-Verzeichnis des Benutzers heruntergeladen.

Option 1: Isolierte Umgebung

Rufen Sie Dateiinhalte von dieser Website ab, und kopieren Sie diese ü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

• Öffnen Sie die Datei py2_sure.py oder py3_sure.py, und klicken Sie auf Unformatierte Datei kopieren.

• SSH zum vManage hinzufügen und den Befehl vshell verwenden.

vmanage# vshell

• Öffnen Sie vi, drücken Sie Esc und dann i (Buchstabe i), und fügen Sie den Inhalt ein.

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

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

:wq 

Anmerkung: Speichern und ‌ beenden: Drücken Sie im Befehlsmodus die Esc-Taste, um den Einfügemodus zu beenden. Geben Sie dann :wq oder :x ein, und drücken Sie die Eingabetaste, um die Änderungen zu speichern und den vi-Editor zu verlassen.

         Speichern Sie die ‌ nicht: Drücken Sie im Befehlsmodus die Esc-Taste, und geben Sie dann :q! ein, drücken Sie die Eingabetaste, um die Änderungen nicht zu speichern, und erzwingen Sie das Beenden des vi-Editors. Drücken Sie die Eingabetaste, um die Änderungen nicht zu speichern und den vi-Editor zu beenden.

Option 3: WGET

Anmeldung bei vManage CLI-Sitzung:

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

Warnung: Wenn Sie WGET verwenden, müssen Sie es so einrichten, dass Ihr Manager auf die Datei GItHub.com zugreifen kann. 

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:copy source_file_name from vManage intolocal_destination_path with vManage username.

scp vManageUsername@PublicIp:<source_file_name> <local_destination_path>

Beispiel:

Stellen Sie eine Verbindung zu 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, an das Sie die Datei übertragen möchten.

Zugehörige Informationen

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