【NEEDLEWORK 仮想版】テスト環境構築について徹底解説

そもそも NEEDLEWORK って？という人はコチラからどうぞ。

【NEEDLEWORK 仮想】テスト環境はどう構築したら良い？
テスト用インターフェースの追加
ライセンスアクティベート
1. 手動でのライセンスアクティベート
USB LAN アダプタの接続構成はどうしたら良い？
管理アクセスはリモート端末からも可能
NEEDLEWORK の管理画面にアクセスできない場合
参考資料
1. 評価ライセンス申請

【NEEDLEWORK 仮想】テスト環境はどう構築したら良い？

ネットワークテスト自動化アプライアンスである NEEDLEWORK の仮想アプライアンスについて、Hyper-V 上へのインストールが完了していること(※)を前提として、そこから NEEDLEWORK 端末でどのようにテスト実行環境を構築したら良いのか、について記載します。
(※)NEEDLEWORK インストール用 PowerShell スクリプトを実行した状態

なお、ここでは重要ポイントのみ記載するため、全体の手順については公式の事前準備マニュアルを確認してください。

テスト用インターフェースの追加

PowerShell スクリプトによって NEEDLEWORK のインストールを実施した直後の時点では、NEEDLEWORK の仮想マシンにはインターフェースとして管理用インターフェースのみが作成されている状態となっています。

ここからテスト用インターフェース（テスト対象の FW などと接続するためのインターフェース）を追加する必要があります。

USB LAN アダプタの用意

テスト用インターフェースを NEEDLEWORK に追加するためには、NEEDLEWORK がインストールされている端末に有線 LAN アダプタが必要です。

最近のノート PC では有線 LAN アダプタが無いものも多く、またテスト用インターフェースは最低 2 ポート必要なため、USB LAN アダプタを使用することになります。

公式の動作環境情報によると、推奨されている USB LAN アダプタの仕様は以下の通りです。

USB LAN アダプタ推奨仕様

リンクレート：1Gbps
チップ：ASIX AX88179
USB規格：USB 3.2 Gen 1×1（USB 3.1 Gen 1/USB3.0）以上

松田が動作確認して正常動作を確認できた USB LAN アダプタは以下の通りです。
※ポリシーテストでの正常動作を確認

また、推奨仕様外の 100Mbps の Realtek のアダプタですが以下でもポリシーテストについては正常に動作することを確認しています。

Hanmir 有線LAN アダプター

ASIX 製チップのアダプタについては、現時点ではドライバーバージョンとして 1.20.7.0 が推奨されています。

テスト用インターフェース追加スクリプトの実行

NEEDLEWORK の VM イメージをダウンロードした際に一緒にダウンロードできる、テスト用インターフェース追加スクリプトがあるため、これを使用して NEEDLEWORK の仮想マシンにインターフェースを追加します。

スクリプトを実行する前に、USB LAN アダプタを端末に接続し、さらにケーブルを接続して UP させておく必要があります。そうでなければスクリプト実行時にアダプタが検出されません。

スクリプトを実行すると、以下のように UP 状態のアダプタが検出され、使用するアダプタを指定することになります。

トランスクリプトが開始されました。出力ファイル: C:\Users\user01\Documents\90_job\06_softwater\NEEDLEWORK\AddTestInterface_Log_20220315211159
ネットワークアダプタ情報を取得中です。
仮想スイッチ情報を取得中です。(10分程度かかる場合があります)


現在テスト用インターフェースとして指定できるネットワークアダプタです。

Name                          Status InterfaceDescription
----                          ------ --------------------
VMware Network Adapter VMnet1 Up     VMware Virtual Ethernet Adapter for VMnet1
VMware Network Adapter VMnet8 Up     VMware Virtual Ethernet Adapter for VMnet8
イーサネット 8                Up     ASIX AX88179 USB 3.0 to Gigabit Ethernet Adapter #2
イーサネット 11               Up     ASIX AX88179 USB 3.0 to Gigabit Ethernet Adapter #3
イーサネット                  Up     Intel(R) Ethernet Connection (2) I219-V
Wi-Fi 3                       Up     TP-Link Wireless MU-MIMO USB Adapter


テスト用インターフェースとして使用するネットワークアダプタ名（Name）を指定してください。:

上の「イーサネット 8」と「イーサネット 11」が USB LAN アダプタです。

例として、「イーサネット 8」を指定します。すると、以下のように作成するスイッチ名を問われます。

テスト用インターフェースとして使用するネットワークアダプタ名（Name）を指定してください。: イーサネット 8
新たに作成するスイッチ名を入力してください。:

このスイッチとは、Hyper-V における仮想スイッチのことです。指定したスイッチ名の仮想スイッチ（外部ネットワーク設定）が作成され、その仮想スイッチに指定したアダプタが紐づけられることになります。

ここでは例としてスイッチ名を TestSW01 とします。すると以下のように処理が進みます。

テスト用インターフェースとして使用するネットワークアダプタ名（Name）を指定してください。: イーサネット 8
新たに作成するスイッチ名を入力してください。: TestSW01
vSwitchを作成しています...
VMNetworkAdapterを作成しています...
VLANを構成しています...
テスト用インターフェースの作成が完了しました。
--作成オブジェクト---
VMSwitch: TestSW01
Testinterface: TestInterface_TestSW01
PhysicalInterface: イーサネット 8
-----

終了するには何かキーを押してください。

上のログにもある通り、NEEDLEWORK の仮想マシンに対しては、TestInterface_TestSW01 という名前のインターフェースが追加されます。

スクリプト実行後の Hyper-V の設定を見てみます。

まず、仮想スイッチですが以下のようにスクリプト実行中に指定した名前のスイッチが作成されています。外部ネットワーク設定で、アダプタとしてはスクリプト実行中に指定したアダプタが設定されています。

続いて仮想マシン NEEDLEWORK の設定ですが、以下の通りネットワークアダプタが追加され、スクリプトで作成された仮想スイッチが設定されています。

このように、スクリプトを実行すると仮想マシン NEEDLEWORK のインターフェースが一つ追加されます。

追加するインターフェースの数分だけスクリプトを実行することになります。
※テスト用インターフェースの最大数は 3 です

テスト用インターフェース追加スクリプトでは、NEEDLEWORK のインターフェース追加に加えて、そのインターフェースについてタグ Vlan の設定も実施されています。

PS C:\WINDOWS\system32> Get-VMNetworkAdapterVlan

VMName     VMNetworkAdapterName    Mode  VlanList
------     --------------------    ----  --------
NEEDLEWORK ネットワーク アダプター Trunk 0,1-4094
NEEDLEWORK TestInterface_TestSW01  Trunk 0,1-4094

なお、USB ポートが 2 ポートしかない端末だとしても、NEEDLEWORK のインターフェースを 3 つ作成することが可能です。USB LAN アダプタを別のアダプタに差し替えてスクリプトを実行すれば OK です。NEEDLEWORK のインターフェースを 3 つ作成しておけば、3 つの USB LAN アダプタの内、任意の 2 つを端末に接続して NEEDLEWORK でテストを実行する、といったことができます。