SD-WANラボ導入ツールおよびモデリングラボを使用した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が登場する前は、SD-WANコントローラとエッジルータをCMLに手動で導入する必要がありました。このプロセスは完全に自動化されており、数時間ではなく数分で完了します。YouTubeデモ。

---

ラボ導入ツールの主な利点

• SD-WANコントローラの完全自動作成
• SD-WANエッジルータを使用した複数のブランチの追加を1つの自動タスクで実行
• 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/コンテナまたはLinux on Windows（WSLを使用）が必要です。すべての依存関係はpyproject.tomlファイルのSDWAN Lab Deployment Toolで確認できます。
• GitHubでインストール手順、使用例、ソースコードをすべて参照してください。
• ラボツールを実行しているホストとCMLサーバ/クラスタの間のネットワーク接続が十分に高速であることを確認します。これは、SD-WANコントローラのソフトウェアイメージのアップロード中に役立ちます。
• SD-WAN Lab Deployment Toolに関する質問はありますか。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 Lab Custom Topologyセッションを検索し、予約します。

2. 予約を使用する準備ができたら、View > Info > AnyConnect Credentialsの順にクリックし、セキュアクライアントを使用してセッションに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ルーティングエッジ、またはその両方をラボトポロジに追加します。

(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	初版