Configurer le déploiement AURA avant la mise à niveau vManage
Table des matières
Introduction
Ce document décrit comment configurer le déploiement AURA avant la mise à niveau vManage.
Conditions préalables
Exigences
Cisco vous recommande de prendre connaissance des rubriques suivantes :
- Réseau étendu défini par logiciel (SD-WAN) de Cisco.
Composants utilisés
Les informations contenues dans ce document sont basées sur la version 20.9.4 de Cisco vManager
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.
Informations générales
L'outil de ligne de commande Cisco AURA-SDWAN (SURE) effectue un total de 30 (mode non cluster) ou 36 (mode cluster) vérifications à différents niveaux de la superposition SDWAN. L'objectif de l'outil est d'empêcher les défaillances potentielles et de recommander des actions correctives pour un processus de mise à niveau transparent. L'outil récupère les données à l'aide des commandes GET API Calls et show/shell.
Concept De Base
- Simple et direct, utilise des modules python par défaut qui sont déjà disponibles sur le serveur vManage
- Génère automatiquement un rapport TXT.
- Requiert uniquement : vManage et mot de passe.
- vManage utilisateur avec des privilèges d'administrateur OU d'opérateur réseau RO.
- Le mot de passe utilisateur vManage ne doit pas contenir le caractère "!" caractère .
- Pour l'exécuter, il vous suffit de copier le fichier dans le vManage et de l'exécuter sur le serveur.
- Non intrusif
- Durée d'exécution : généralement inférieure à 60 secondes, selon la taille de votre déploiement
- L'accès racine n'est pas requis pour effectuer une vérification.
- Aucune donnée n'est collectée ou partagée avec quiconque. Toutes les informations utilisées par l'outil restent dans le rapport et les journaux fournis
- N'utilisez pas d'API en temps réel avec des limites d'évolutivité
Télécharger le script sur vManage
Identifier le fichier de version Python à exécuter en fonction de la version de vManage
|
Version de vManage |
Version de Python |
Fichier Python à exécuter |
|
Avant 20,5 |
Python2 |
python2/py2_sure.py |
|
À partir de 20,5 |
Python3 |
python3/py3_sure.py |
Remarque : La version de vmanage étant 20.9.4, le fichier py3_sure.py doit être utilisé.
Remarque : L'application peut être téléchargée dans n'importe quel répertoire souhaité, généralement dans le répertoire d'accueil de l'utilisateur.
Option 1. Environnement isolé
Obtenez le contenu du fichier à partir de ce site, puis copiez-le vers le serveur via SCP.
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 système d'exploitation 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
Option 2. Méthode de collage
- Ouvrez le fichier py2_sure.py ou py3_sure.py, cliquez sur le bouton Copy raw file.
- Établissez une connexion SSH avec vManage et utilisez la commande vshell.
vmanage# vshell
- Ouvrez vi, appuyez sur Échap, puis sur i (lettre i), puis collez le contenu.
vmanage:~$ vi py3_sure.py
E1187: Failed to source defaults.vim
Press ENTER or type command to continue
- Après le collage, appuyez sur Échap, :wq (symbole : et les lettres w, q) pour l'enregistrer.
:wq
Remarque : Enregistrer et quitter : En mode commande, appuyez sur la touche Échap pour quitter le mode insertion, puis tapez :wq ou :x et appuyez sur Entrée pour enregistrer les modifications et quitter l'éditeur vi.
Ne pas enregistrer les de sortie : En mode commande, appuyez sur la touche Échap, puis tapez :q! , appuyez sur la touche Entrée pour ne pas enregistrer les modifications et forcer la sortie de l'éditeur vi.
Option 3. WGET
Connectez-vous à la session 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
Avertissement : Si vous utilisez WGET, vous devez le faire de sorte que votre vmanage puisse accéder à GItHub.com.
Comment exécuter
Options de ligne de commande
utilisation : sure.py [-h] [-q] [-v] [-d] -u NOM D'UTILISATEUR
SURE - Moteur de préparation à la mise à niveau SDWAN - v3.2.1
arguments facultatifs :
-h, —help afficher ce message d'aide et quitter
-q, —quiet Exécution silencieuse du script
-v, —verbose Exécution détaillée du script
-d, —debug Exécution du script par débogage
-u USERNAME, —username USERNAME
Nom d'utilisateur vManage
-vp VMANAGE_PORT, —vmanage_port VMANAGE_PORT
Mot de passe vManage
Exécution en mode d'exécution 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 feedbackVérifier le rapport
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 continueCisco 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 | +----------------------------------------------------+---------------+
Télécharger le rapport de vManage vers l'ordinateur local
Option 1. CLI 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
Option 2. Terminal Linux/Mac
Syntaxe de commande:
La commande est lue en tant que :copy source_file_name à partir de vManage intolocal_destination_path avec vManage username.
scp vManageUsername@PublicIp:<source_file_name> <local_destination_path>
Exemple :
Connectez-vous à votre terminal Linux/Mac local et exécutez la commande SCP pour copier le fichier dans le répertoire souhaité.
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 ou tout autre client FTP ou SFTP
Connectez-vous à :
- SFTP comme protocole ou port 22
- URL vManage, IP publique ou IP privée (si vManage est sur site)
- Utiliser un nom d'utilisateur et un mot de passe valides
Sur le client FTP ou SFTP, les fichiers du répertoire d'accueil de l'utilisateur vManage sont répertoriés. Il vous suffit d'effectuer un glisser-déposer vers la destination locale à gauche où vous souhaitez transférer le fichier.
Informations connexes
Historique de révision
| Révision | Date de publication | Commentaires |
|---|---|---|
1.0 |
18-Sep-2025
|
Première publication |
CommentairesContacter Cisco
- Ouvrir un dossier d’assistance
- (Un contrat de service de Cisco est requis)