通過SD-WAN實驗室部署工具和建模實驗室部署SD-WAN

簡介

本文檔介紹如何使用SD-WAN實驗室部署工具（開源，BSD-3）在Cisco建模實驗中建立Catalyst SD-WAN交換矩陣。 

---

下載

• SD-WAN實驗室部署工具

---

背景資訊

SD-WAN Lab Deployment Tool可自動在CML中建立SD-WAN交換矩陣，並大大簡化各種步驟，包括將SD-WAN邊緣路由器新增到交換矩陣、證書安裝和其他自註冊任務。使用SD-WAN實驗工具之前，使用者必須在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)受到支援，並且僅對這些系統可用。
• 要在Windows上運行該工具，您需要一個Linux VM/容器，或在Windows上使用WSL運行Linux。在pyproject.toml檔案中可以找到所有依賴項：SDWAN實驗室部署工具。
• 請參閱GitHub上的所有安裝步驟、使用示例和原始碼。
• 確保運行實驗工具的主機與CML伺服器/群集之間的網路連線速度足夠快。這在SD-WAN控制器的SW映像上傳期間很有幫助。
• 如果您對SD-WAN實驗室部署工具有任何疑問？傳送電子郵件至cml-sdwan-lab-tool@external.cisco.com 

---

dCloud環境中的SD-WAN實驗室部署工具

此工具可與dCloud環境中的CML配合使用。檢視以下步驟，在dCloud CML中部署SD-WAN/SD-Routing實驗。

1.在dCloud目錄中找到並保留CML - Catalyst SD-WAN 26.1實驗室自定義拓撲會話。

2.預留準備好使用後，按一下檢視>資訊> AnyConnect憑證，並在會話中使用Secure Client to VPN。

3.使用環境變數準備檔案，以用於SD-WAN實驗室部署工具。以下是使用的範例檔案：

(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映像下載到運行該工具的目錄，並運行setup以在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	初始版本