Implementación de SD-WAN a través de la herramienta de implementación de laboratorio SD-WAN y los laboratorios de modelado

Introducción

Este documento describe cómo crear un entramado Catalyst SD-WAN en Cisco Modeling Labs mediante la herramienta de implementación de laboratorio SD-WAN (código abierto, BSD-3). 

---

Descargar

• Herramienta de implementación de laboratorio SD-WAN

---

Antecedentes

La herramienta de implementación de laboratorio SD-WAN automatiza la creación de fabric SD-WAN en CML y simplifica drásticamente diversos pasos, incluidos la adición de routers periféricos SD-WAN al fabric, la instalación de certificados y otras tareas de incorporación. Antes de la herramienta de laboratorio SD-WAN, los usuarios tenían que implementar manualmente controladores SD-WAN y routers de borde en CML. Este proceso está totalmente automatizado y tarda minutos, no horas; Demostración en YouTube.

---

Ventajas clave de las herramientas de implementación de laboratorio

• Creación totalmente automatizada de controladores SD-WAN
• Añada varias sucursales con routers periféricos SD-WAN en una sola tarea automatizada
• Dos transportes de SD-WAN; Internet y MPLS
• Posibilidad de introducir la latencia como emulación de enlace WAN
• Funciones de copia de seguridad y restauración
• Licencia de código abierto BSD-3 alojada en GitHub

---

---

Requisitos de CML para casos prácticos de SD-WAN

• CML se puede implementar sin software específico o a través de una máquina virtual (ESXi o AWS).
• Admite agrupación en clúster para aumentar la capacidad.
• La opción recomendada para la simulación de SD-WAN es el clúster CML en las instalaciones con unos pocos servidores.

---

Detalles de la herramienta de implementación de laboratorio SD-WAN

• Actualmente, la herramienta es compatible con sistemas Linux/MacOS como un paquete de dependencias (pyats) y solo está disponible para esos sistemas.
• Para ejecutar la herramienta en Windows, necesita una VM/contenedor Linux o Linux en Windows con WSL. Puede encontrar todas las dependencias en el archivo pyproject.toml: Herramienta de implementación de laboratorio de SDWAN.
• Consulta todos los pasos de instalación, ejemplos de uso y código fuente en GitHub.
• Asegúrese de que la conexión de red entre el host que ejecuta Lab Tool y el servidor/clúster CML sea lo suficientemente rápida. Esto ayuda durante la carga de la imagen SW de los controladores SD-WAN.
• ¿Tiene alguna pregunta sobre la herramienta de implementación de laboratorio de SD-WAN? Envíe un correo electrónico a cml-sdwan-lab-tool@external.cisco.com 

---

Herramienta de implementación de laboratorio SD-WAN en entorno dCloud

Esta herramienta funciona con CML en el entorno dCloud. Revise estos pasos para implementar un laboratorio de ruteo SD-WAN/SD en dCloud CML.

1. En el catálogo dCloud, busque y reserve la sesión CML - Catalyst SD-WAN 26.1 Lab Custom Topology.

2. Una vez que la reserva esté lista para su uso, haga clic en View > Info > AnyConnect Credentials, y utilice Secure Client para VPN en la sesión.

3. Prepare un archivo con las variables de entorno que se utilizarán para la Herramienta de implementación de laboratorio SD-WAN. Este es un ejemplo de archivo utilizado:

(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. Genere este archivo para asegurarse de que las variables de entorno tengan efecto:

(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. Descargue cualquier imagen qcow2 no disponible en la definición de imagen dCloud CML al directorio desde el que se ejecuta la herramienta, y ejecute setup para agregar nuevas definiciones de imagen en 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. Implemente el 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. Agregue los bordes de SD-WAN, los bordes de routing de SD o ambos a la topología de laboratorio:

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

Troubleshoot

Discordancia de versión de Python

Lab Tools requiere Python versión 3.11 y posteriores. Si tiene una versión diferente de Python que no coincide con el requisito del paquete, la instalación puede fallar. 

Este es un ejemplo de una instalación fallida debido a la versión incorrecta de Python:

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

---

Para solucionar este problema, utilice un entorno virtual de Python para cumplir los requisitos específicos de la versión de Python.

Historial de revisiones

Revisión	Fecha de publicación	Comentarios
3.0	13-Oct-2026	Ortografía, gramática, introducción, líneas horizontales insertadas actualizadas para separar las secciones y facilitar su lectura.
2.0	13-Oct-2026	Título actualizado, SEO, vínculos objetivo, requisitos de estilo, traducción automática y formato.
1.0	18-Jun-2024	Versión inicial