Test Agent Applianceのインストール
インストールのトピックでは、Test Agent Applianceをブート可能なイメージとしてカスタムx86ハードウェアにインストールし、Test Agent ApplianceをProxmoxサーバーにインストールし、ローカルコンソールからTest Agent Applianceを登録する手順について説明します。
Test Agent Applianceは、ネットワークパフォーマンスをテストするために設計された本格的なテストエージェントであり、最適化された Debian Linux オペレーティングシステムと統合されています。Test Agent Applianceは、さまざまな方法でパッケージ化して提供することができます。
-
専用のテストエージェント—Test Agent Applianceソフトウェアイメージをダウンロードして、カスタムx86ハードウェアにインストールできます。
-
Test Agent Virtualized Network Function (TA VNF)—テストエージェントソフトウェアイメージを仮想化プラットフォームにアップロードし、ハイパーバイザーで実行されている仮想マシン(VM)上で実行することができます。
始める前に
Test Agent Applianceのインストールを開始する前に、以下を実行してください。
- ファイアウォールがTCPポート6800上のParagon Automationへの接続をブロックしていないことを確認します。
- Test Agent Applianceをインストールするプラットフォームに、4.1 GiB以上のストレージ容量があることを確認します。
カスタムx86ハードウェアへのTest Agent Applianceのインストール
Test Agent Applianceは、USBフラッシュドライブから直接起動できます。仮想マシン ベースの展開の代わりに、USB フラッシュ ドライブ ベースの展開を使用できます。
カスタムx86ハードウェアにTest Agent Applianceをインストールするには、以下を実行する必要があります。
ddなどのコマンドラインツール、またはEtcherやWin32ディスクイメージなどのアプリケーションを使用して、起動可能なUSBフラッシュドライブを作成します。詳細については、「 起動可能な USB フラッシュ ドライブを作成する」を参照してください。
BIOS ブート マネージャーを使用して、USB フラッシュ ドライブからカスタム x86 ハードウェアをブートします。詳細については、「 カスタム x86 ハードウェアを USB フラッシュ ドライブから起動する」を参照してください。
起動可能なUSBフラッシュドライブを作成する
起動可能なUSBフラッシュ ドライブは、次のいずれかの方法で作成できます。
-
Etcherを使用して起動可能なUSBフラッシュドライブを作成するには:
ソフトウェアダウンロードページから、Test Agent Applianceの最新イメージをダウンロードします。
デバイスにEtcherをダウンロードしてインストールし、起動可能なUSBフラッシュドライブを作成します。
- 4.1 GB 以上の空き容量のある 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 フラッシュ ドライブから起動します
BIOS ブート マネージャーを使用して、USB フラッシュ ドライブからカスタム x86 ハードウェアをブートできます。
カスタム 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をParagon Automationに登録する必要があります。
ローカルコンソールからのTest Agent Applianceの登録
Test Agent Applianceでの管理インターフェイスの構成
Test Agent Applianceで管理インターフェイスを設定するには、次の手順に従います。
カスタム x86 ハードウェアを再起動して、ローカル コンソールにアクセスします。
テキストベースのテストエージェント管理メニューは、カスタムx86ハードウェアを再起動すると自動的に表示されます。
「 管理の構成」を選択し、「 OK」をクリックします。
[管理インターフェイスの選択(Select Management Interface)] ページが表示されます。
管理トラフィックのインターフェイスを選択し、[ OK] をクリックします。
[Select Interface speed](インターフェイス速度の選択)ページが表示されます。
選択した管理インターフェイスの速度とデュプレックスの設定を選択し、[ OK] をクリックします。
管理インターフェイスに VLAN タグを使用するかどうかを尋ねるページが表示されます。
(オプション)VLAN タグを指定します。ネットワーク設定でVLANタグ付けが必要な場合は、[ はい ]を選択し、適切なVLAN IDを指定します。
次の IPv4 アドレスの種類のいずれかを選択し、[ OK] をクリックします。
[なし(None)]:IPv4 アドレス タイプを設定しません。
[静的(Static)]:IPv4 アドレスを手動で指定します。
DHCP—IPv4アドレスを自動的に割り当てます。
次の IPv6 アドレスの種類のいずれかを選択し、[ OK] をクリックします。
[なし(None)]:IPv6 アドレス タイプを設定しません。
SLAAC—ステートレス アドレスを自動的に設定します。
[静的(Static)]:IPv6 アドレスを手動で指定します。
DHCP—IPv6 アドレスを自動的に割り当てます。
IPv6アドレスを設定すると、NTPクライアントのIPv6サポートを有効にするかどうかを尋ねるページが表示されます。
正確な時刻同期のためにNTPサーバをカンマ区切りリストとして指定し、[ OK]をクリックします。
指定した情報が正しいかどうかを尋ねるページが表示されます。
情報を確認し、「 はい」をクリックします。
これで、Test Agent Adminメニューに戻り、Test Agent ApplianceをParagon Automationに登録できます。
シークレットを使用したTest Agent Applianceの登録
シークレットを使用してTest Agent Applianceを登録するには、次の手順に従います。
Paragon Automation GUIで、
テストエージェント (インベントリ > Active Assurance > テストエージェント) ページに移動します。
「 テスト・エージェントの追加 」ボタンをクリックします。
「テスト・エージェントの追加」ページが表示されます。
テスト・エージェントのタイプとして「テスト・エージェント・アプライアンス」を選択します。
テストエージェントの名前、タグ、説明を指定します。
「作成」をクリックします。
Paragon Automationがテストエージェントアプライアンスを正常に追加したことを確認するメッセージが表示され、テストエージェントの詳細 (インベントリ>アクティブアシュアランス>テストエージェント>テストエージェントの詳細) ページにリダイレクトされます。
[ Download & Run]タブで、[Secret]テキストボックスの横にある [Copy ]ボタンを使用して、Paragon Automationによって生成された秘密鍵をコピーします。この秘密鍵を使用して、Paragon Automationとの接続を確立できます。
[Test Agent Admin] メニューで、
Test Agent Applianceでの管理インターフェイスの構成の説明に従って、管理インターフェイスを設定します。
テキストベースのテストエージェント管理メニューから [登録/接続 ]を選択します。
[Register/Connect Menu](登録/接続メニュー)ページが表示されます。
[シークレットを使用して登録] を選択し、[OK] をクリックします。
[登録情報の入力] ページが表示されます。
次の詳細を指定し、「OK」をクリックします。
Paragon AutomationテストエージェントゲートウェイのIPアドレス。
Paragon Automationに接続するTCPポート番号。デフォルトのTCPポート番号は6800です。
[ Download & Run ] タブからコピーしたシークレット。
登録が成功したことを示す確認メッセージが表示されます。
登録が成功すると、Test Agent ApplianceがParagon Automation GUIの[Test Agents]ページ ([Inventory > Active Assurance > Test Agents] )にリストされます。
手記:Paragon Automationが自己署名証明書を使用している場合は、Test Agent Admin Menuの[ Utilities] > [SSL Certificate Validation]に移動し、SSL 証明検証を無効にします。
ユーザー名とパスワードを使用した Test Agent Appliance の登録
テキストベースのTest Agent Admin Menuでユーザー名とパスワードを使用して、Test Agent Applianceを登録できます。
Test Agent Applianceの登録には、シークレットを使用する方法が推奨されます。
シングルサインオン(SSO)と2要素認証(2FA)が有効になっている場合、ユーザー名とパスワードの認証は機能しません。
ユーザー名とパスワードを使用してTest Agent Applianceを登録するには、次の手順に従います。
[Test Agent Admin Menu] から [ Register/Connect ] を選択します。
[Register/Connect Menu](登録/接続メニュー)ページが表示されます。
「 ユーザー/パスワードを使用して登録 」を選択し、「 OK」をクリックします。
[登録情報の入力] ページが表示されます。
次の詳細を指定し、「 OK」をクリックします。
Paragon AutomationテストエージェントゲートウェイのIPアドレス。
Paragon Automationに接続するTCPポート番号。デフォルトのTCPポート番号は6800です。
Paragon Automationアカウントに関連付けられたメールアドレス。
Test Agent Applianceの名前。
認証用のParagon Automationアカウントのパスワードを入力し、[ OK]をクリックします。
[組織の選択] ページが表示されます。
リストから組織を選択し、[ OK] をクリックします。
登録が成功したことを示す確認メッセージが表示されます。
登録が成功すると、Test Agent ApplianceがParagon Automation GUIの[Test Agents]( インベントリ>Active Assurance > Test Agents) ページに一覧表示されます。
Test Agent ApplianceをProxmoxにインストールする
Proxmoxは、Test Agent Applianceを仮想マシン(VM)として配信できるオープンソースの仮想化プラットフォームです。この方法は、専用の物理ハードウェアではなく、仮想環境でTest Agent Applianceを実行するのに役立ちます。
Test Agent ApplianceをProxmoxサーバにインストールするには、次の手順に従います。
オペレーティング システムなしで VM を作成します。
Proxmox Web UIにログインします。
左側のナビゲーション バーから [ VM の作成 ] ボタンをクリックします。
[作成: 仮想マシン] ページが表示されます。
[全般] タブで、VM を識別するための VM ID を指定します。
[OS] タブで、[ メディアを使用しない ] を選択して、VM が CD-ROM または ISO ファイルから起動しないようにします。
「ディスク」タブで、「 削除 」(ごみ箱)アイコンをクリックして、デフォルトのディスクを削除します。
[CPU]、[メモリ]、および [ネットワーク] タブで、VM の要件に基づいて詳細を指定し、[ 完了] をクリックします。詳細については、「 Proxmox VM 設定」を参照してください。
qcow2 イメージを格納するディレクトリを作成します。
Proxmox UIで、左側のナビゲーションバーから[ホスト]をクリックし、[シェル]をクリックしてターミナルを開きます。
次のコマンドを使用します。
sudo mkdir /var/lib/vz/template/qcow
qcow2 イメージをインポートします。
Proxmoxシェルで、次のコマンドを実行します。
qm importdisk 101 paa-test-agent_5.0.0.4.qcow2 local-lvm
qcow2 仮想ディスクを VM に接続します。
作成した VM を選択し、 ハードウェア > ハード ディスクに移動します。
[未使用のディスク] の下に表示されている、新しくインポートされた QCOW2 ディスクを選択し、[ 編集 ] ボタンをクリックします。
[Add: Unused Disk](追加:未使用ディスク)ページが表示されます。
ドロップダウン リストからバス タイプ [ VirtIO Block ] を選択し、[ 追加] をクリックします。
これで、qcow2 ディスクが VirtIO ブロックデバイスとして VM に正常に接続されました。
起動順序を変更します。
[Options] > [Boot Order] に移動します。
[Boot Order] を選択し、VirtIO Block Disk を一番上に移動します。
[ OK] をクリックします。
VM を起動します。
「コンソール」メニューに移動します。
[ Start Now] をクリックして、Test Agent Applianceを起動します。
これで、ProxmoxにTest Agent Applianceが正常に配信されました。
cloud-configメタデータを使用して、Paragon Automationとの通信を確立できます。
cloud-configメタデータの形式
仮想化プラットフォームでは、cloud-configメタデータ(ユーザーデータ)を指定できます。仮想マシンのデプロイ時に、cloud-init は cloud-config (YAML ベースのファイル形式) を使用して仮想マシンの初期化を自動化します。cloud-configメタデータをカスタマイズして、ネットワーク構成とアプリケーション固有のパラメーターを定義できます。Amazon Web ServicesまたはOpenStackにTest Agent Applianceを展開する場合、cloud-configメタデータはTest Agent Appliance設定の自動化に役立ちます。Test Agent ApplianceをParagon Automationに登録する管理サーバーとのセキュアな通信を確立します。
次の cloud-config ファイルを参照として使用できます。
#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)