Inhoud

Inleiding

Achtergrondinformatie

Belangrijkste voordelen van de Lab-implementatietools

CML-vereisten voor SD-WAN-gebruikscases

Details van SD-WAN Lab implementatietool

Problemen oplossen

Python-versiemismatch

Inleiding

In dit artikel wordt beschreven hoe u een Catalyst SD-WAN Fabric in Cisco Modeling Labs (CML) op geautomatiseerde wijze kunt maken met de open-source Lab Implementation Tool.

Achtergrondinformatie

De SD-WAN Lab Implementatie Tool automatiseert SD-WAN fabric creatie in CML en vereenvoudigt veel stappen, waaronder het toevoegen van SD-WAN Edge routers aan de Fabric, certificaatinstallatie en andere onboarding taken.

Voordat de SD-WAN Lab Tool gebruikers handmatig SD-WAN controllers en edge routers in CML moesten implementeren - zie voor meer informatie.

Nu is het hele proces volledig geautomatiseerd en duurt het minuten in plaats van uren. Bekijk een korte demo van de Lab Tool in deze YouTube-video.

Belangrijkste voordelen van de Lab-implementatietools

- Volledig geautomatiseerde creatie van SD-WAN controllers

- Voeg meerdere Branches met SD-WAN Edge-routers toe in één geautomatiseerde taak

- Twee SD-WAN transporten: internet en MPLS

- Mogelijkheid om latentie te introduceren als WAN Link Emulation

- Back-up- en terugzetfuncties

- Open source Repo op GitHub

- De Cisco-interne versie van de SD-WAN Lab tool is meer dan 900 keer gebruikt sinds de creatie ervan in verschillende organisaties, waaronder sales, CX (TAC en PS) en BU. Zie meer informatie over de Cisco interne versie.

CML-vereisten voor SD-WAN-gebruikscases

- CML kan worden geïmplementeerd in een on-prem server (bare metal of als VM op ESXi) of op AWS.

- Ondersteunt clustering om de capaciteit te vergroten.

- Voor interne gebruikers van Cisco: licentie kan worden verkregen.

- Voor externe klanten: hier zijn verschillende licentielagen beschikbaar.

- De installatiegids (hetzelfde voor interne en externe gebruikers) vindt u hier.

- De aanbevolen optie voor SD-WAN Simulatie: on-prem CML-cluster met weinig servers.

Details van SD-WAN Lab implementatietool

- De tool wordt momenteel ondersteund op Linux/MacOS-systemen als een afhankelijkheidspakket (pyats) 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 vindt alle afhankelijkheden in het pyproject.toml bestand: https://github.com/cisco-open/sdwan-lab-deployment-tool/blob/main/pyproject.toml

- Zie 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 SW-afbeeldingen van de SD-WAN controllers.

- Heeft u vragen over de SD-WAN Lab implementatietool? Verzend een e-mail naar cml-sdwan-lab-tool@external.cisco.com

Problemen oplossen

Python-versiemismatch

Eind april 2024 is Python versie 3.9 vereist voor het Lab Tools. Als u een recentere Python-versie hebt, kan de installatie mislukken. Houd er rekening mee dat ondersteuning voor Python 3.12 binnenkort beschikbaar is.

Voorbeeld van een mislukte installatie vanwege de verkeerde 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 het probleem op te lossen, kunt u Python 3.9 voor 3.12 in uw omgevingsvariabelen zetten, gebruik pyenv om te switches tussen verschillende versies ("pyenv global 3.9") of downgrade van 3.12 naar 3.9.