SD-WAN Lab Deployment Tool 및 Modeling Labs를 통해 SD-WAN 구축

소개

이 문서에서는 SD-WAN Lab Deployment Tool(오픈 소스, BSD-3)을 사용하여 Cisco Modeling Labs에서 Catalyst SD-WAN 패브릭을 생성하는 방법에 대해 설명합니다. 

---

다운로드

• SD-WAN 랩 구축 툴

---

배경 정보

SD-WAN Lab Deployment Tool은 CML에서 SD-WAN 패브릭 생성을 자동화하고 패브릭에 SD-WAN 에지 라우터 추가, 인증서 설치 및 기타 온보딩 작업을 포함한 다양한 단계를 대폭 간소화합니다. SD-WAN Lab Tool을 사용하기 전에 사용자는 CML에서 SD-WAN 컨트롤러와 에지 라우터를 수동으로 배포해야 했습니다. 이 프로세스는 완전히 자동화되어 있으며 몇 시간이 아니라 몇 분 정도 소요됩니다. YouTube 데모.

---

랩 구축 툴의 주요 이점

• 완전히 자동화된 SD-WAN 컨트롤러 생성
• 하나의 자동화된 작업에서 SD-WAN 에지 라우터로 여러 브랜치 추가
• 2개의 SD-WAN 전송, 인터넷 및 MPLS
• 레이턴시를 WAN 링크 에뮬레이션으로 도입 가능
• 백업 및 복원 기능
• GitHub에서 호스팅되는 오픈 소스 BSD-3 라이센스

---

---

SD-WAN 활용 사례에 대한 CML 요건

• CML은 베어 메탈 또는 가상 머신(ESXi 또는 AWS)을 통해 구축할 수 있습니다.
• 용량 증가를 위한 클러스터링 지원
• SD-WAN 시뮬레이션에 권장되는 옵션은 몇 대의 서버가 포함된 온프레미스 CML 클러스터입니다.

---

SD-WAN 랩 구축 툴 세부 정보

• 이 도구는 현재 Linux/MacOS 시스템에서 pyats(dependency package)로 지원되며 해당 시스템에서만 사용할 수 있습니다.
• Windows에서 도구를 실행하려면 Linux VM/컨테이너 또는 WSL이 있는 Windows의 Linux가 필요합니다. pyproject.toml 파일에서 모든 종속성을 찾을 수 있습니다. SDWAN 랩 구축 툴.
• GitHub의 모든 설치 단계, 사용 예 및 소스 코드를 확인하십시오.
• Lab Tool을 실행 중인 호스트와 CML 서버/클러스터 간의 네트워크 연결 속도가 충분한지 확인합니다. 이는 SD-WAN 컨트롤러의 SW 이미지 업로드 중에 도움이 됩니다.
• SD-WAN Lab Deployment Tool에 대해 질문이 있으십니까? cml-sdwan-lab-tool@external.cisco.com으로 이메일 보내기 

---

dCloud 환경의 SD-WAN 랩 구축 툴

이 도구는 dCloud 환경에서 CML과 함께 작동합니다. dCloud CML에서 SD-WAN/SD-Routing Lab을 구축하려면 다음 단계를 검토하십시오.

1. dCloud 카탈로그에서 CML - Catalyst SD-WAN 26.1 Lab Custom Topology 세션을 찾아 예약합니다.

2. 예약을 사용할 준비가 되면 보기 > 정보 > AnyConnect 자격 증명을 클릭하고 Secure Client to VPN을 사용하여 세션에 연결합니다.

3. SD-WAN Lab Deployment Tool에 사용할 환경 변수를 사용하여 파일을 준비합니다. 다음은 사용된 예제 파일입니다.

(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. 환경 변수를 적용하려면 이 파일을 소싱합니다.

(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. dCloud CML 이미지 정의에서 사용할 수 없는 qcow2 이미지를 툴이 실행 중인 디렉토리로 다운로드한 다음 설치 프로그램을 실행하여 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

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. 실습 구축:

(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 에지, SD-Routing 에지 또는 둘 다를 추가합니다.

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

문제 해결

Python 버전 불일치

실습 도구에는 Python 버전 3.11 이상이 필요합니다. 패키지 요구 사항과 일치하지 않는 다른 Python 버전이 있는 경우 설치가 실패할 수 있습니다. 

다음은 잘못된 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] $  

---

이 문제를 해결하려면 Python 가상 환경을 사용하여 특정 Python 버전 요구 사항을 충족해야 합니다.

개정 이력

개정	게시 날짜	의견
3.0	13-Oct-2026	맞춤법, 문법, 소개, 가로줄 삽입, 가독성을 위해 섹션 구분.
2.0	13-Oct-2026	업데이트된 제목, SEO, 대상 링크, 스타일 요구 사항, 기계 번역 및 서식.
1.0	18-Jun-2024	최초 릴리스