Introducción

Este documento describe cómo configurar AURA Deployment antes de vManage Upgrade.

Prerequisites

Requirements

Cisco recomienda que tenga conocimiento sobre estos temas:

• Red de área extensa (SD-WAN) definida por software de Cisco.

Componentes Utilizados

La información de este documento se basa en Cisco vManager versión 20.9.4

La información que contiene este documento se creó a partir de los dispositivos en un ambiente de laboratorio específico. Todos los dispositivos que se utilizan en este documento se pusieron en funcionamiento con una configuración verificada (predeterminada). Si tiene una red en vivo, asegúrese de entender el posible impacto de cualquier comando.

Antecedentes

La herramienta de línea de comandos Cisco AURA-SDWAN (SURE) realiza un total de 30 (modo no clúster) o 36 (modo clúster) comprobaciones en diferentes niveles de la superposición de SDWAN. El objetivo de la herramienta es evitar posibles fallos y recomendar acciones correctivas para un proceso de actualización sin problemas. La herramienta recupera datos mediante llamadas API GET y comandos show/shell.

Concepto básico

• Sencillo y sencillo, utiliza módulos de Python predeterminados que ya están disponibles en el servidor vManage
• Genera automáticamente un informe TXT.
• Solo requiere - vManage y contraseña.
• Usuario de vManage con privilegios de administrador O operador de red RO.
• La contraseña de usuario de vManage no debe contener "!" carácter.
• Para ejecutar, copie el archivo en vManage y ejecútelo en el servidor.
• No es intrusivo
• Tiempo de ejecución: normalmente menos de 60 segundos, en función del tamaño de la implementación
• El acceso raíz no es necesario para realizar ninguna comprobación.
• No se recopila ni comparte ningún dato con nadie. Toda la información utilizada por la herramienta permanece en el informe y los registros proporcionados
• No utilice API en tiempo real que tengan limitaciones de escala

Descargue el script en vManage

Identificar qué archivo de versión de Python se ejecutará según la versión de vManage

Nota: La versión de vmanage es 20.9.4, por lo que se debe utilizar el archivo py3_sure.py.

Nota: La aplicación se puede descargar en cualquier directorio deseado, normalmente se descarga en el directorio de inicio del usuario.

Opción 1. Entorno aislado

Obtenga el contenido del archivo de este sitio y, a continuación, cópielo mediante SCP en el servidor.

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

MAC OS

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  

SO 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 

Opción 2. Método Paste

• Abra el archivo py2_sure.py o py3_sure.py, haga clic en el botón Copiar archivo raw.

• SSH al vManage y utilice el comando vshell.

vmanage# vshell

• Abra vi, pulse Esc y, a continuación, i (letra i) y, a continuación, pegue el contenido.

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

• Después de pegar, presione Esc, :wq (símbolo : y letras w,q) para guardarlo.

:wq 

Nota: Guardar y salir de ‌: En el modo de comandos, presione la tecla Esc para salir del modo de inserción, luego escriba :wq o :x y presione enter para guardar las modificaciones y salir del editor de vi.

         No guardar ‌ de salida: En el modo de comandos, presione la tecla Esc y luego escriba :q!, presione la tecla enter para no guardar las modificaciones y fuerce la salida del editor de vi.

Opción 3. WGET

Inicie sesión en la sesión de vManage CLI:

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

Advertencia: Si utiliza WGET, debe hacerlo para que vmanage pueda acceder a GItHub.com. 

Cómo ejecutar

Opciones de línea de comandos

uso: sure.py [-h] [-q] [-v] [-d] -u NOMBREDEUSUARIO

SURE - Motor de preparación para la actualización a SDWAN - v3.2.1

argumentos opcionales:
-h, —help muestra este mensaje de ayuda y sale
-q, —quiet Ejecución silenciosa del script
-v, —verbose Ejecución detallada del script

-d, —debug Debug execution of the script
-u NOMBRE DE USUARIO, —username NOMBRE DE USUARIO
Nombre de usuario de vManage
-vp VMANAGE_PORT, —vmanage_port VMANAGE_PORT
Contraseña de vManage

Ejecutar en modo de ejecución normal

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

Comprobar informe

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

Cargar informe de vManage al equipo local

Opción 1. CLI de Viptela

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

Opción 2. Terminal Linux/Mac

Sintaxis del comando:

El comando se lee como:copy source_file_name from vManage intolocal_destination_path with vManage username.

scp vManageUsername@PublicIp:<source_file_name> <local_destination_path>

Ejemplo:

Conéctese a su terminal local Linux/Mac y ejecute el comando SCP para copiar el archivo en el directorio deseado.

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

Opción 3. FileZilla o cualquier otro cliente FTP o SFTP

Conectar con:

• SFTP como protocolo o puerto 22
• URL de vManage, IP pública o IP privada (si vManage está en las instalaciones)
• Usar nombre de usuario y contraseña válidos

En el cliente FTP o SFTP, se enumeran los archivos del directorio de inicio del usuario de vManage. Solo tiene que arrastrar y soltar en el destino local de la izquierda donde desea transferir el archivo.

Información Relacionada

• Actualización de controladores SD-WAN con el uso de vManage GUI o CLI
• AURA-SDWAN (SEGURO)
• Transferencia de archivos entre cEdge y vManage