Test Agent Applianceのインストール
インストール トピックでは、Test Agent Appliance をブータブル イメージとしてカスタム x86 ハードウェアにインストールし、Test Agent Appliance を Proxmox サーバーにインストールし、ローカル コンソールから Test Agent Appliance を登録する手順について説明します。
Test Agent Applianceは、ネットワークパフォーマンスをテストするために設計された本格的なテストエージェントであり、最適化されたDebian Linuxオペレーティングシステムと統合されています。Test Agent Applianceは、さまざまな方法でパッケージ化して提供することができます。
-
専用テストエージェント—テストエージェントアプライアンスソフトウェアイメージをダウンロードして、カスタムx86ハードウェアにインストールできます。
-
テストエージェント仮想化ネットワーク機能(TA VNF)—テストエージェントソフトウェアイメージを仮想化プラットフォームにアップロードし、ハイパーバイザーで実行されている仮想マシン(VM)で実行できます。
始める前に
Test Agent Applianceのインストールを開始する前に:
- TCP ポート 6800 で Routing Director への接続をブロックしているファイアウォールがないことを確認します。
- Test Agent Applianceをインストールするプラットフォームに、最低4.1GiBのストレージスペースがあることを確認してください。
カスタムx86ハードウェアにTest Agent Applianceをインストールする
Test Agent Applianceは、USBフラッシュ ドライブから直接起動できます。仮想マシンベースの導入の代わりに、USBフラッシュドライブベースの導入を使用することもできます。
カスタムx86ハードウェアにTest Agent Applianceをインストールするには、以下のことが必要です:
ddなどのコマンドラインツールや、EtcherやWin32 Disk Imageなどのアプリケーションを使用して、起動可能なUSBフラッシュドライブを作成します。詳細については、「 起動可能なUSBフラッシュドライブを作成する」を参照してください。
BIOS ブートマネージャーを使用して、カスタム x86 ハードウェアを USB フラッシュ ドライブから起動します。詳細については、「 USBフラッシュドライブからカスタムx86ハードウェアを起動する」を参照してください。
起動可能なUSBフラッシュドライブを作成する
ブータブルUSBフラッシュドライブは、以下のいずれかの方法で作成できます。
-
Etcherを使用して起動可能なUSBフラッシュドライブを作成するには:
ソフトウェアのダウンロードページからTest Agent Applianceの最新イメージをダウンロードします。
Etcherをデバイスにダウンロードしてインストールし、起動可能なUSBフラッシュドライブを作成します。
- 4.1GB以上の空き容量があるUSBフラッシュドライブをハードウェアに挿入します。
Etcherを起動し、x86ハードウェアのハードディスクからTest Agent Applianceイメージを選択します。
イメージを書き込むUSBフラッシュ ドライブを選択します。
フラッシュ をクリックしてプロセス を開始します。
イメージがフラッシュされたら、USBフラッシュドライブを取り出すことができます。
USBフラッシュ ドライブを取り出します。
これで、USBフラッシュ ドライブを起動可能なディスクとして使用する準備ができました。
Etcherの詳細については、 Etcherのドキュメントを参照してください。
-
Win32 ディスク イメージを使用して起動可能な USB フラッシュ ドライブを作成するには、「Windows デバイスを使用して起動可能な USB フラッシュ ドライブを作成する」を参照してください。
-
MaxまたはLinuxで dd コマンドを使用して起動可能なUSBフラッシュドライブを作成するには、「 MAC OS Xを使用して起動可能なUSBフラッシュドライブを作成する」を参照してください。
警告:USBフラッシュ ドライブに一時インストール ファイル用に4.1 GiBのメモリがあり、USBフラッシュ ドライブ上の既存のコンテンツはすべて消去されていることを確認します。
カスタムx86ハードウェアをUSBフラッシュ ドライブから起動します
カスタムx86ハードウェアは、BIOSブートマネージャーを使用して、USBフラッシュドライブから起動できます。
カスタムx86ハードウェアをUSBフラッシュドライブから起動するには、次の手順に従います。
ブータブルUSBフラッシュドライブをカスタムx86ハードウェアのUSBポートに挿入します。
x86ハードウェアの電源を入れ、ハードウェアに応じてDEL、ESC、F2、またはF12を押して、BIOSメニューにアクセスします。
これで、BIOS ブート マネージャーにアクセスして USB の選択を確認できます。
[起動順序設定] に移動し、USB フラッシュ ドライブを優先順位リストの一番上に移動します。
[保存] を選択して設定を更新し、再起動します。
ブートプロセスには最大20秒かかり、完了するとログインプロンプトが表示されます。
システム資格情報を使用してシステムにログインします。ユーザー名は「admin」、パスワードは「admin」です。
[ 公共 ] に移動し、[ ディスクにインストール] を選択します。
インストールが完了すると、USBフラッシュ ドライブを取り外してハードウェアを再起動するように求められます。
手記:x86ハードウェアを再起動する前に、USBフラッシュ ドライブを取り外します。x86ハードウェアを再起動します。
x86ハードウェアにTest Agent Applianceが正常にインストールされ、カスタムx86ハードウェアがTest Agent Applianceとして起動します。
Test Agent Applianceを使用する前に、Test Agent ApplianceをRouting Directorに登録する必要があります。
ローカルコンソールからTest Agent Applianceを登録する
Test Agent Applianceで管理インターフェイスを設定します
Test Agent Appliance で管理インターフェイスを設定するには:
カスタムx86ハードウェアを再起動して、ローカルコンソールにアクセスします。
テキストベースのテストエージェント管理メニューは、カスタムx86ハードウェアを再起動すると自動的に表示されます。
管理 の設定を選択し、 OKをクリックします。
管理インターフェイスの選択ページが表示されます。
管理トラフィックのインターフェイスを選択し、 OKをクリックします。
インターフェイス速度の選択ページが表示されます。
選択した管理インターフェイスの速度と二重設定を選択し、 OKをクリックします。
管理インターフェイスにVLANタグを使用するかどうかを尋ねるページが表示されます。
(オプション)VLAN タグを指定します。ネットワーク設定にVLANタグ付けが必要な場合は、[ はい ]を選択し、適切なVLAN IDを指定します。
以下のIPv4アドレスタイプのいずれかを選択し、 OKをクリックします。
なし—IPv4アドレスタイプを設定しません。
静的—IPv4アドレスを手動で指定します。
DHCP—IPv4アドレスを自動的に割り当てます。
以下のIPv6アドレスタイプのいずれかを選択し、 OKをクリックします。
なし—IPv6アドレスタイプを設定しません。
SLAAC—ステートレスアドレスを自動的に設定します。
静的—IPv6アドレスを手動で指定します。
DHCP—IPv6アドレスを自動的に割り当てます。
IPv6アドレスを設定すると、NTPクライアントのIPv6サポートを有効にするかどうかを尋ねるページが表示されます。
正確な時刻同期のためにNTPサーバーをカンマ区切りリストとして指定し、 OKをクリックします。
指定した情報が正しいかどうかを尋ねるページが表示されます。
情報を確認し、 はいをクリックします。
次に、Test Agent Adminメニューに戻り、Test Agent ApplianceをRouting Directorに登録できます。
シークレットを使用してテストエージェントアプライアンスを登録する
シークレットを使用してテストエージェントアプライアンスを登録するには:
Routing Director GUIで—
テストエージェント (アクティブアシュアランス>テストエージェント>インベントリ) ページに移動します。
テスト エージェントを追加 ボタンをクリックします。
テストエージェントの追加ページが表示されます。
テストエージェントのタイプとしてテストエージェントアプライアンスを選択します。
テストエージェントの名前、タグ、説明を指定します。
作成をクリックします。
Routing Directorがテストエージェントアプライアンスを正常に追加したことを確認するメッセージが表示され、テストエージェントの詳細 (アクティブアシュアランス>テストエージェント>テストエージェントの詳細> ページにリダイレクトされます。
[ ダウンロードして実行] タブで、[シークレット] テキスト ボックスの横にある [コピー ] ボタンを使用して、Routing Director によって生成されたシークレット キーをコピーします。この秘密キーを使用して、Routing Director との接続を確立できます。
テストエージェントの管理メニュー
テストエージェントアプライアンス上の管理インターフェイスの設定の説明に従って、管理インターフェイスを設定します。
テキストベースのテストエージェント管理メニューから 登録/接続 を選択します。
登録/接続メニューページが表示されます。
シークレットを使用して登録を選択し、OKをクリックします。
登録情報の入力ページが表示されます。
以下の詳細を指定し、OKをクリックします。
Routing DirectorテストエージェントゲートウェイのIPアドレス。
Routing Directorに接続するTCPポート番号。デフォルトのTCPポート番号は6800です。
ダウンロードして実行タブからコピーしたシークレット。
登録に成功したことを示す確認メッセージが表示されます。
登録が成功すると、Routing Director GUIのテストエージェント( アクティブアシュアランス>テストエージェント>インベントリ) ページにテストエージェントアプライアンスが表示されます。
手記:Routing Directorが自己署名証明書を使用している場合は、テストエージェント管理メニュー 公共>SSL証明書検証に移動し、SSL証明書検証を無効にします。
ユーザー名とパスワードを使用してTest Agent Applianceを登録する
テキストベースのテストエージェント管理メニューでユーザー名とパスワードを使用して、テストエージェントアプライアンスを登録できます。
Test Agent Appliance を登録するには、シークレットを使用することが推奨されます。
シングルサインオン(SSO)と二要素認証(2FA)が有効になっている場合、ユーザー名とパスワードの認証は機能しません。
ユーザー名とパスワードを使用してTest Agent Applianceを登録するには:
テストエージェント管理メニューから 登録/接続 を選択します。
登録/接続メニューページが表示されます。
ユーザー/パスワードを使用して登録を選択し、OKをクリックします。
登録情報の入力ページが表示されます。
以下の詳細を指定し、 OKをクリックします。
Routing DirectorテストエージェントゲートウェイのIPアドレス。
Routing Directorに接続するTCPポート番号。デフォルトのTCPポート番号は6800です。
Routing Directorアカウントに関連付けられているメールアドレス。
Test Agent Applianceの名前
認証用のRouting Directorアカウントパスワードを入力し、 OKをクリックします。
組織の選択ページが表示されます。
リストから組織を選択し、 OKをクリックします。
登録に成功したことを示す確認メッセージが表示されます。
登録が成功すると、Routing Director GUIのテストエージェント (アクティブアシュアランス>テストエージェント>インベントリ) ページにテストエージェントアプライアンスが表示されます。
ProxmoxにTest Agent Applianceをインストールする
Proxmox は、Test Agent Appliance を仮想マシン (VM) として展開できるオープンソースの仮想化プラットフォームです。この方法を使用すると、専用の物理ハードウェアではなく仮想環境でTest Agent Applianceを実行することができます。
ProxmoxサーバーにTest Agent Applianceをインストールするには:
オペレーティングシステムなしのVMを作成します。
Proxmox Web UIにログインします。
左側のナビゲーション バーから [VM の作成 ] ボタンをクリックします。
作成:仮想マシンページが表示されます。
[一般] タブで、VM ID を指定して VM を識別します。
[OS] タブで、[ メディアを使用しない ] を選択して、VM が CD-ROM または ISO ファイルから起動しないようにします。
ディスクタブで、 削除 (ゴミ箱)アイコンをクリックして、デフォルトのディスクを削除します。
CPU、メモリ、およびネットワークタブで、VMの要件に基づいて詳細を指定し、 完了をクリックします。詳細については、「 Proxmox VM 設定」を参照してください。
手記:テストエージェントの要件は次のとおりです。CPU— 最小1 vCPU(推奨—2 vCPU)
- メモリ—最小256MB RAM(推奨—4GB RAM)
- ディスク領域—4.1 GBディスク
qcow2イメージを格納するディレクトリを作成します。
開始する前に、 ソフトウェアのダウンロード ページからテストエージェントqcow2の最新イメージをダウンロードします。
Proxmox UIで、左側のナビゲーション バーからホスト をクリックし、シェルをクリックしてターミナルを開きます。
ディレクトリを作成するには、次のコマンドを使用します。
sudo mkdir /var/lib/vz/template/qcow
作成されたディレクトリに移動し、次のコマンドを実行してイメージをダウンロードします。
wget ta-ng.qcow2
ダウンロード後、qcow2イメージのインポートに進みます。
qcow2イメージをインポートします。
Proxmox シェルで、次のコマンドを実行します。
qm importdisk <101> <paa-test-agent_5.0.0.4.qcow2 local-lvm>
手記:コマンドで使用される<値>はプレースホルダーです。設定の必要性に基づいて、必要な値に置き換える必要があります。
qcow2 仮想ディスクを VM に接続します。
作成したVMを選択し、 ハードウェア>ハードディスクに移動します。
未使用のディスクの下に表示されている、新しくインポートされたQCOW2ディスクを選択し、 編集 ボタンをクリックします。
追加:未使用ディスクページが表示されます。
ドロップダウンリストからバスタイプ VirtIOブロック を選択し、 追加をクリックします。
qcow2 ディスクを VirtIO ブロック デバイスとして VM に正常に接続しました。
起動順序を変更します。
オプション>起動順序に移動します。
[Boot Order] を選択し、VirtIO ブロック ディスクを一番上に移動します。
OKをクリックします。
VMを起動します。
コンソールメニューに移動します。
今すぐ開始をクリックして、Test Agent Applianceを起動します。
Proxmox に Test Agent Appliance が正常に展開されました。
cloud-configメタデータを使用して、Routing Directorとの通信を確立できます。
cloud-configメタデータのフォーマット
仮想化プラットフォームでは、クラウド構成メタデータ(ユーザーデータ)を指定できます。仮想マシンのデプロイ中に、クラウド init は クラウド コンフィグ (YAML ベースのファイル形式) を使用して仮想マシンの初期化を自動化します。クラウド構成メタデータをカスタマイズして、ネットワーク構成とアプリケーション固有のパラメーターを定義できます。Amazon Web ServicesまたはOpenStackにTest Agent Applianceをデプロイする場合、クラウド構成メタデータはTest Agent Appliance設定の自動化に役立ちます。テストエージェントアプライアンスをRouting Directorに登録する管理サーバーとの安全な通信を確立します。
次のクラウド構成ファイルを参照として使用できます。
#cloud-config
paa_test_agent:
# Registration using secret
server: "<server_address>"
port: 6800
secret: "<registration_secret>"
# Disable/enable SSL certificate validation
ssl_no_check: false # (Optional) Set to true to disable SSL checks (not recommended)
# Optional HTTP proxy settings
http_proxy:
address: "<proxy_address>" # (Required if using a proxy) Proxy server address
port: <proxy_port> # (Required) Proxy server port
username: "<proxy_username>" # (Optional) Proxy authentication username
password: "<proxy_password>" # (Optional) Proxy authentication password
# User account passwords
user_passwords:
admin: "<admin_password>" # (Optional) Password for the admin user
root: "<root_password>" # (Optional) Password for the root user
# Network management configuration
management:
interface: "eth0" # (Optional) Network interface (default: eth0)
mtu: <mtu_value> # (Optional) MTU size (default: None)
address_type: "dhcp" # (Optional) IP assignment type: 'none', 'dhcp', or 'static' (default: dhcp)
ip: "<static_ip>" # (Required if using 'static' address type) Static IPv4 address
dns: ["<dns_server_1>", "<dns_server_2>"] # (Optional) List of DNS servers
default_gateway: "<gateway_ip>" # (Optional) Default IPv4 gateway
ntp: ["time.google.com"] # (Optional) NTP server(s) (default: time.google.com)
address6_type: "dhcp" # (Optional) IPv6 assignment type: 'none', 'dhcp', 'static', or 'slaac' (default: dhcp)
ip6: "<static_ipv6>" # (Required if using 'static' address type) Static IPv6 address
dns6: ["<dns6_server_1>", "<dns6_server_2>"] # (Optional) List of IPv6 DNS servers
default_gateway6: "<gateway_ipv6>" # (Optional) Default IPv6 gateway
ntp_allow_ipv6: false # (Optional) Enable IPv6 NTP (default: false)
# Test Agent application settings
ta_application:
log_level: "warn" # (Optional) Logging level: 'debug', 'info', 'warn', 'error', 'critical' (default: warn)
コマンドで使用される<値>はプレースホルダーです。設定の必要性に基づいて、必要な値に置き換える必要があります。