Implante SD-WAN através da ferramenta de implantação de laboratório SD-WAN e dos laboratórios de modelagem

Introdução

Este documento descreve como criar uma estrutura Catalyst SD-WAN no Cisco Modeling Labs usando a SD-WAN Lab Deployment Tool (Open Source, BSD-3). 

---

Download

• Ferramenta de implantação de laboratório SD-WAN

---

Informações de Apoio

A SD-WAN Lab Deployment Tool automatiza a criação de estrutura SD-WAN na CML e simplifica consideravelmente várias etapas, incluindo a adição de roteadores de borda SD-WAN à estrutura, instalação de certificado e outras tarefas de integração. Antes da SD-WAN Lab Tool, os usuários tinham que implantar manualmente controladores SD-WAN e roteadores de borda na CML. Esse processo é totalmente automatizado e leva minutos, não horas; Demo no YouTube.

---

Principais benefícios das ferramentas de implantação em laboratório

• Criação totalmente automatizada de controladores SD-WAN
• Adicionar várias filiais com roteadores de borda SD-WAN em uma tarefa automatizada
• Dois transportes SD-WAN; Internet e MPLS
• Capacidade de introduzir latência como emulação de link de WAN
• Recursos de backup e restauração
• Licença BSD-3 de código aberto hospedada no GitHub

---

---

Requisitos de CML para casos de uso de SD-WAN

• A CML pode ser implantada diretamente no hardware ou por meio de uma máquina virtual (ESXi ou AWS).
• Suporte a clustering para aumentar a capacidade.
• A opção recomendada para Simulação de SD-WAN é um cluster CML no local com alguns servidores.

---

Detalhes da ferramenta de implantação de laboratório SD-WAN

• A ferramenta é atualmente suportada em sistemas Linux/MacOS como um pacote de dependências (pyats) e está disponível apenas para esses sistemas.
• Para executar a ferramenta no Windows, você precisa de uma VM/contêiner Linux ou Linux no Windows com WSL. Você pode encontrar todas as dependências no arquivo pyproject.toml: SDWAN Lab Deployment Tool (Ferramenta de implantação de laboratório SDWAN).
• Veja todas as etapas de instalação, exemplos de uso e código-fonte no GitHub.
• Verifique se a conexão de rede entre o host que executa a Lab Tool e o servidor/cluster CML é rápida o suficiente. Isso ajuda durante o upload da imagem de SW dos controladores SD-WAN.
• Em caso de dúvidas sobre a ferramenta de implantação de laboratório SD-WAN? Envie um e-mail para cml-sdwan-lab-tool@external.cisco.com 

---

Ferramenta de implantação de laboratório SD-WAN no ambiente dCloud

Essa ferramenta funciona com CML no ambiente dCloud. Revise estas etapas para implantar um laboratório de SD-WAN/SD-Routing na CML do dCloud.

1. No catálogo do dCloud, localize e reserve a sessão CML - Catalyst SD-WAN 26.1 Lab Custom Topologies.

2. Quando a reserva estiver pronta para uso, clique em View > Info > AnyConnect Credentials e use o Secure Client para VPN na sessão.

3. Prepare um arquivo com as variáveis de ambiente a serem usadas para a SD-WAN Lab Deployment Tool. Este é um arquivo de exemplo usado:

(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. Use este arquivo como origem para garantir que as variáveis de ambiente entrem em vigor:

(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. Baixe todas as imagens qcow2 não disponíveis na definição de imagem CML do dCloud para o diretório em que a ferramenta está sendo executada e execute a instalação para adicionar novas definições de imagem na 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. Implante o laboratório:

(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. Adicione bordas de SD-WAN, bordas de roteamento de SD ou ambas à topologia do laboratório:

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

Troubleshooting

Incompatibilidade de Versão do Python

As Ferramentas de Laboratório exigem Python Versão 3.11 e posterior. Se você tiver uma versão diferente do Python que não corresponda ao requisito de pacote, a instalação poderá falhar. 

Este é um exemplo de uma instalação com falha devido à versão incorreta do 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 corrigir esse problema, use um ambiente virtual Python para atender aos requisitos específicos da versão Python.

Histórico de revisões

Revisão	Data de publicação	Comentários
3.0	13-Oct-2026	Ortografia, gramática, introdução atualizadas, linhas horizontais inseridas para separar seções para facilitar a leitura.
2.0	13-Oct-2026	Título, SEO, links de destino, requisitos de estilo, tradução automática e formatação atualizados.
1.0	18-Jun-2024	Versão inicial