Bereitstellung von SD-WAN mit dem SD-WAN Lab Deployment Tool und den Modellierungslaboren

Einleitung

Dieses Dokument beschreibt die Erstellung einer Catalyst SD-WAN-Fabric in Cisco Modeling Labs mithilfe des SD-WAN Lab Deployment Tools (Open Source, BSD-3). 

---

Herunterladen

• SD-WAN Lab Deployment Tool

---

Hintergrundinformationen

Das SD-WAN Lab Deployment Tool automatisiert die Erstellung der SD-WAN-Fabric in CML und vereinfacht die einzelnen Schritte erheblich. Dazu gehören das Hinzufügen von SD-WAN-Edge-Routern zur Fabric, die Zertifikatsinstallation und andere Onboarding-Aufgaben. Vor der Einführung des SD-WAN Lab Tools mussten Benutzer in CML manuell SD-WAN-Controller und Edge-Router bereitstellen. Dieser Vorgang ist vollständig automatisiert und dauert nur wenige Minuten statt mehrerer Stunden. YouTube-Demo:

---

Die wichtigsten Vorteile der Tools für die Laborbereitstellung

• Vollautomatisierte Erstellung von SD-WAN-Controllern
• Hinzufügen mehrerer Zweigstellen mit SD-WAN-Edge-Routern in einer automatisierten Aufgabe
• Zwei SD-WAN-Transportnetze Internet und MPLS
• Einführung von Latenz als WAN-Link-Emulation
• Backup- und Wiederherstellungsfunktionen
• Open Source BSD-3-Lizenz gehostet auf GitHub

---

---

CML-Anforderungen für SD-WAN-Anwendungsfälle

• CML kann auf Bare Metal oder über virtuelle Systeme (ESXi oder AWS) bereitgestellt werden.
• Unterstützt Clustering zur Erhöhung der Kapazität.
• Die empfohlene Option für die SD-WAN-Simulation ist ein standortbasiertes CML-Cluster mit wenigen Servern.

---

Details zum SD-WAN Lab-Bereitstellungstool

• Das Tool wird derzeit auf Linux/MacOS-Systemen als Abhängigkeitspaket (pyats) unterstützt und ist nur für diese Systeme verfügbar.
• Um das Tool unter Windows auszuführen, benötigen Sie eine Linux VM/container oder Linux unter Windows mit WSL. Sie finden alle Abhängigkeiten in der Datei pyproject.toml: SDWAN-Bereitstellungstool für Labs.
• Hier finden Sie alle Installationsschritte, Anwendungsbeispiele und den Quellcode auf GitHub.
• Stellen Sie sicher, dass die Netzwerkverbindung zwischen dem Host, auf dem das Lab Tool ausgeführt wird, und dem CML-Server bzw. -Cluster schnell genug ist. Dies hilft beim Hochladen des SW-Images der SD-WAN-Controller.
• Haben Sie Fragen zum SD-WAN Lab Deployment Tool? Senden Sie eine E-Mail an cml-sdwan-lab-tool@external.cisco.com 

---

SD-WAN Lab Deployment Tool in dCloud-Umgebung

Dieses Tool arbeitet mit CML in der dCloud-Umgebung. Gehen Sie diese Schritte durch, um ein SD-WAN/SD-Routing-Lab in der dCloud-CML bereitzustellen.

1. Suchen und reservieren Sie im dCloud-Katalog die CML - Catalyst SD-WAN 26.1 Lab Custom Topology-Sitzung.

2. Sobald die Reservierung einsatzbereit ist, klicken Sie auf Anzeigen > Info > AnyConnect-Anmeldedaten, und verwenden Sie den sicheren Client für die VPN-Verbindung in der Sitzung.

3. Bereiten Sie eine Datei mit den Umgebungsvariablen für das SD-WAN Lab Deployment Tool vor. Dies ist eine Beispieldatei, die verwendet wird:

(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. Laden Sie diese Datei herunter, um sicherzustellen, dass die Umgebungsvariablen wirksam werden:

(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. Laden Sie alle in der dCloud-CML-Image-Definition nicht verfügbaren qcow2-Images in das Verzeichnis herunter, in dem das Tool ausgeführt wird, und führen Sie Setup aus, um neue Image-Definitionen in CML hinzuzufügen:

(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. Stellen Sie die Übung bereit:

(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. Fügen Sie der Labortopologie SD-WAN-Kanten, SD-Routing-Kanten oder beides hinzu:

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

Fehlerbehebung

Python-Versionskonflikt

Für die Labortools ist Python Version 3.11 und höher erforderlich. Wenn Sie eine andere Python-Version haben, die nicht der Paketanforderung entspricht, kann die Installation fehlschlagen. 

Dies ist ein Beispiel für eine fehlgeschlagene Installation aufgrund der falschen Python-Version:

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

---

Um dieses Problem zu beheben, verwenden Sie eine virtuelle Python-Umgebung, um die spezifischen Anforderungen der Python-Version zu erfüllen.

Revisionsverlauf

Überarbeitung	Veröffentlichungsdatum	Kommentare
3.0	13-Oct-2026	Aktualisierte Rechtschreibung, Grammatik, Einführung, eingefügte horizontale Linien in separate Abschnitte für die Lesbarkeit.
2.0	13-Oct-2026	Aktualisierter Titel, SEO, Zielverknüpfungen, Stilanforderungen, maschinelle Übersetzung und Formatierung.
1.0	18-Jun-2024	Erstveröffentlichung