Implementeer SD-WAN via SD-WAN Lab Deployment Tool en Modeling Labs

Inleiding

In dit document wordt beschreven hoe u een Catalyst SD-WAN-verbinding kunt maken in Cisco Modeling Labs met behulp van de SD-WAN Lab Deployment Tool (Open source, BSD-3). 

---

downloaden

• SD-WAN Lab Deployment Tool

---

Achtergrondinformatie

De SD-WAN Lab Deployment Tool automatiseert het maken van SD-WAN-verbindingen in CML en vereenvoudigt drastisch verschillende stappen, waaronder het toevoegen van SD-WAN Edge-routers aan de verbinding, certificaatinstallatie en andere onboarding-taken. Voor de SD-WAN Lab Tool moesten gebruikers handmatig SD-WAN-controllers en edge-routers in CML implementeren. Dit proces is volledig geautomatiseerd en duurt minuten, geen uren; YouTube Demo.

---

Belangrijkste voordelen van de Lab Deployment Tools

• Volledig geautomatiseerde aanmaak van SD-WAN-controllers
• Voeg meerdere vestigingen toe met SD-WAN Edge-routers in één geautomatiseerde taak
• Twee SD-WAN-transporten; internet en MPLS
• Mogelijkheid om latentie te introduceren als WAN Link Emulation
• Back-up- en herstelmogelijkheden
• Open Source BSD-3 licentie gehost op GitHub

---

---

CML-vereisten voor SD-WAN-use cases

• CML kan worden geïmplementeerd op bare metal of via een virtuele machine (ESXi of AWS).
• Ondersteunt clustering om de capaciteit te vergroten.
• De aanbevolen optie voor SD-WAN-simulatie is een on-prem CML-cluster met een paar servers.

---

SD-WAN Lab Deployment Tool - Gegevens

• De tool wordt momenteel ondersteund op Linux / MacOS-systemen als een afhankelijkheidspakket (pyats) en is alleen beschikbaar voor die systemen.
• Om de tool op Windows uit te voeren, hebt u een Linux VM / container of Linux op Windows met WSL nodig. U kunt alle afhankelijkheden vinden in het bestand pyproject.toml: SDWAN Lab Deployment Tool.
• Bekijk alle installatiestappen, gebruiksvoorbeelden en broncode op GitHub.
• Zorg ervoor dat de netwerkverbinding tussen de host waarop het Lab Tool wordt uitgevoerd en de CML-server/cluster snel genoeg is. Dit helpt bij het uploaden van het SW-image van de SD-WAN-controllers.
• Heeft u vragen over de SD-WAN Lab Deployment Tool? Stuur een email naar cml-sdwan-lab-tool@external.cisco.com 

---

SD-WAN Lab Deployment Tool in dCloud-omgeving

Deze tool werkt met CML in de dCloud-omgeving. Bekijk deze stappen om een SD-WAN/SD-Routing-lab te implementeren in de dCloud CML.

1. Zoek en reserveer in de dCloud-catalogus de CML - Catalyst SD-WAN 26.1 Lab Custom Topologies-sessie.

2. Zodra de reservering klaar is voor gebruik, klikt u op Weergave > Info > AnyConnect-referenties en gebruikt u de beveiligde client om VPN in de sessie te gebruiken.

3. Maak een bestand met de omgevingsvariabelen die moeten worden gebruikt voor de SD-WAN Lab Deployment Tool. Dit is een gebruikt voorbeeldbestand:

(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. Bron dit bestand om ervoor te zorgen dat de omgevingsvariabelen effect hebben:

(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. Download alle qcow2-images die niet beschikbaar zijn in de afbeeldingsdefinitie van dCloud CML naar de directory waar het hulpprogramma wordt uitgevoerd en voer de installatie uit om nieuwe afbeeldingsdefinities toe te voegen 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. Implementeer het lab:

(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. SD-WAN-randen, SD-routeringsranden of beide toevoegen aan de laboratoriumtopologie:

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

Problemen oplossen

Python-versie komt niet overeen

De Lab Tools vereist Python versie 3.11 en hoger. Als u een andere Python-versie hebt die niet voldoet aan de pakketvereiste, kan de installatie mislukken. 

Dit is een voorbeeld van een mislukte installatie vanwege de onjuiste Python-versie:

(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] $  

---

Om dit probleem op te lossen, gebruikt u een virtuele Python-omgeving om te voldoen aan de specifieke Python-versie-vereisten.

Revisiegeschiedenis

Revisie	Publicatiedatum	Opmerkingen
3.0	13-Oct-2026	Bijgewerkte spelling, grammatica, inleiding, ingevoegde horizontale lijnen naar afzonderlijke secties voor leesbaarheid.
2.0	13-Oct-2026	Bijgewerkte titel, SEO, doellinks, stijlvereisten, machinevertaling en opmaak.
1.0	18-Jun-2024	Eerste vrijgave