Installazione di SD-WAN tramite lo strumento di installazione di SD-WAN Lab e i laboratori di modellazione

Introduzione

Questo documento descrive come creare un fabric Catalyst SD-WAN in Cisco Modeling Labs utilizzando lo strumento di distribuzione lab SD-WAN (Open source, BSD-3). 

---

Scarica

• SD-WAN Lab Deployment Tool

---

Premesse

SD-WAN Lab Deployment Tool automatizza la creazione di fabric SD-WAN in CML e semplifica notevolmente vari passaggi, tra cui l'aggiunta di router di edge SD-WAN al fabric, l'installazione dei certificati e altre attività di caricamento. Prima dello strumento SD-WAN Lab, gli utenti dovevano installare manualmente i controller SD-WAN e i router edge in CML. Questo processo è completamente automatizzato e richiede minuti, non ore; Demo su YouTube.

---

Vantaggi principali degli strumenti di installazione Lab

• Creazione completamente automatizzata di controller SD-WAN
• Aggiunta di più filiali con router SD-WAN Edge in un'unica operazione automatizzata
• Due trasporti SD-WAN; Internet e MPLS
• Possibilità di introdurre la latenza come emulazione del collegamento WAN
• Funzionalità di backup e ripristino
• Licenza Open Source BSD-3 ospitata su GitHub

---

---

Requisiti CML per i casi di utilizzo di SD-WAN

• CML può essere implementato su bare metal o tramite macchina virtuale (ESXi o AWS).
• Supporta il clustering per aumentare la capacità.
• L'opzione consigliata per la simulazione SD-WAN è il cluster CML locale con alcuni server.

---

Dettagli sullo strumento di installazione Lab SD-WAN

• Lo strumento è attualmente supportato sui sistemi Linux/MacOS come pacchetto di dipendenze (pyats) ed è disponibile solo per tali sistemi.
• Per eseguire lo strumento su Windows, è necessario un Linux VM/container o Linux su Windows con WSL. È possibile trovare tutte le dipendenze nel file pyproject.toml: SDWAN Lab Deployment Tool.
• Vedere tutti i passaggi di installazione, gli esempi di utilizzo e il codice sorgente su GitHub.
• Verificare che la connessione di rete tra l'host che esegue Lab Tool e il server/cluster CML sia sufficientemente veloce. Ciò è utile durante il caricamento dell'immagine SW dei controller SD-WAN.
• Per qualsiasi domanda sullo strumento di installazione Lab SD-WAN? Inviare un'e-mail a cml-sdwan-lab-tool@external.cisco.com 

---

SD-WAN Lab Deployment Tool in ambiente dCloud

Questo strumento funziona con CML nell'ambiente dCloud. Esaminare questi passaggi per installare un laboratorio di routing SD-WAN/SD nel CML di dCloud.

1. Nel catalogo di dCloud, trovare e prenotare la sessione CML - Catalyst SD-WAN 26.1 Lab Custom Topology.

2. Una volta che la prenotazione è pronta per l'uso, fare clic su View > Info > AnyConnect Credentials, e usare il client sicuro per VPN nella sessione.

3. Preparare un file con le variabili di ambiente da usare per lo strumento di installazione Lab SD-WAN. Questo è un file di esempio utilizzato:

(venv) [csdwan] $ more lab_rc.sh
export CML_IP='198.18.134.1'
export CML_USER='admin'
export CML_PASSWORD='C1sco12345!'
export MANAGER_IP='198.18.128.100'
export MANAGER_USER='sdwan'
export MANAGER_PASSWORD='Cisco123!'
export MANAGER_MASK='/18'
export MANAGER_GATEWAY='198.18.128.1'
export LAB_NAME='sdwan'​

---

1. Sorgere questo file per garantire che le variabili di ambiente diventino effettive:

(venv) [csdwan] $ source lab_rc.sh
(venv) [csdwan] $
(venv) [csdwan] $ env | grep "CML\|MANAGER"
CML_PASSWORD=C1sco12345!
MANAGER_MASK=/18
CML_IP=198.18.134.1
CML_USER=admin
MANAGER_USER=sdwan
MANAGER_PASSWORD=Cisco123!
MANAGER_GATEWAY=198.18.128.1
MANAGER_IP=198.18.128.100​

---

2. Scaricare eventuali immagini qws2 non disponibili nella definizione dell'immagine CML di dCloud nella directory da cui viene eseguito lo strumento ed eseguire il programma di installazione per aggiungere nuove definizioni dell'immagine in CML:

(venv) [csdwan] $ ls -l *qcow2
-rw-r--r--@ 1 cisco  staff  1849884672 Sep 20 12:12 c8000v-universalk9_16G_serial.17.15.01a.qcow2
-rw-r--r--@ 1 cisco  staff   360185856 Sep 10 16:26 viptela-bond-20.15.1-genericx86-64.qcow2
-rw-r--r--@ 1 cisco  staff   360185856 Sep 10 16:09 viptela-smart-20.15.1-genericx86-64.qcow2
-rw-r--r--@ 1 cisco  staff  4717608960 Sep 10 16:09 viptela-vmanage-20.15.1-genericx86-64.qcow2
(venv) [csdwan] $
(venv) [csdwan] $ sdwan-lab setup --list
Verifying software images...Uploading viptela-bond-20.15.1-genericx86-64.qcow2
 |##################################################| 360185856/360185856 100.0% [00:00:22]
Upload completed
Uploading viptela-vmanage-20.15.1-genericx86-64.qcow2
 |##################################################| 4717608960/4717608960 100.0% [00:04:59]
Upload completed
<snip>
Upload completed
Setup task done
Available Software Versions:
- cat-sdwan-manager: ['20.12.3', '20.14.1', '20.15.1', '20.9.5.2']
- cat-sdwan-controller: ['20.12.3', '20.14.1', '20.15.1', '20.9.5.1']
- cat-sdwan-validator: ['20.12.3', '20.14.1', '20.15.1', '20.9.5.1']
- cat-sdwan-edge: ['17.09.05a', '17.12.03', '17.14.01a', '17.15.01a']

---

3. Distribuire il laboratorio:

(venv) [csdwan] $ sdwan-lab deploy 20.15.1
Deploy task done
#############################################
Lab is deployed.
CML URL: https://198.18.134.1
SD-WAN Manager URL: https://198.18.128.100:443
Use the username/password set with the script for CML and SD-WAN Manager login.
All other nodes use default username/password.
#############################################

---

4. Aggiungere spigoli SD-WAN, spigoli di routing SD o entrambi alla topologia lab:

(venv) [csdwan] $ sdwan-lab add 2 edges 17.15.01a
(venv) [csdwan] $ sdwan-lab add 2 sdrouting 17.15.01a

Risoluzione dei problemi

Versione Python non corrispondente

Lab Tools richiede Python versione 3.11 e successive. Se si dispone di una versione Python diversa che non soddisfa i requisiti del pacchetto, l'installazione potrebbe non riuscire. 

Questo è un esempio di installazione non riuscita a causa della versione Python errata:

(venv) [csdwan] $ pip install --upgrade catalyst-sdwan-lab
Collecting catalyst-sdwan-lab
  Downloading catalyst_sdwan_lab-2.0.9-py3-none-any.whl.metadata (20 kB)
...
  Downloading catalyst_sdwan_lab-2.0.6-py3-none-any.whl.metadata (20 kB)
ERROR: Cannot install catalyst-sdwan-lab==2.0.6, catalyst-sdwan-lab==2.0.7, catalyst-sdwan-lab==2.0.8 and catalyst-sdwan-lab==2.0.9 because these package versions have conflicting dependencies.

The conflict is caused by:
    catalyst-sdwan-lab 2.0.9 depends on pyats<24.0 and >=23.1
    catalyst-sdwan-lab 2.0.8 depends on pyats<24.0 and >=23.1
    catalyst-sdwan-lab 2.0.7 depends on pyats<24.0 and >=23.1
    catalyst-sdwan-lab 2.0.6 depends on pyats<24.0 and >=23.1

To fix this you could try to:
1. loosen the range of package versions you've specified
2. remove package versions to allow pip attempt to solve the dependency conflict

ERROR: ResolutionImpossible: for help visit https://pip.pypa.io/en/latest/topics/dependency-resolution/#dealing-with-dependency-conflicts
(venv) [csdwan] $  

---

Per risolvere il problema, utilizzare un ambiente virtuale Python per soddisfare i requisiti specifici della versione Python.

Cronologia delle revisioni

Revisione	Data di pubblicazione	Commenti
3.0	13-Oct-2026	Controllo ortografico, grammaticale e introduttivo aggiornati, inserimento di righe orizzontali per separare le sezioni ai fini della leggibilità.
2.0	13-Oct-2026	Titolo aggiornato, SEO, collegamenti di destinazione, requisiti di stile, traduzione automatica e formattazione.
1.0	18-Jun-2024	Versione iniziale