VMware ESXiへのNetScalerエージェントの展開を自動化する

最終公開日 : Sep 25, 2026
NetScaler ADMを使用すると、VMware ESXiへのNetScalerエージェントの展開を自動化できます。
管理者として、次のアクションを自動化できます。
  • NetScalerエージェントを構成する
  • NetScalerエージェントを登録し、エージェントのデフォルトパスワードを変更する。
Related information

NetScalerエージェントを構成する

エージェントの構成を自動化するには、.ovfファイルに次のパラメータの値を追加します。
  1. IPアドレス
  2. ネットマスク
  3. ゲートウェイ
  4. ネームサーバー
  5. ホスト名
注
.ovfファイルはエージェントイメージファイルで利用できます。NetScalerエージェントファイルをダウンロードするには、<https://www.citrix.com/downloads/citrix-application-management/>にアクセスしてください。エージェントイメージファイルの命名パターンは次のとおりです。MASAGENT-ESX-releasenumber-buildnumber.zip

NetScalerエージェントを登録し、デフォルトパスワードを変更する

注記
デフォルトパスワードを登録して変更する前に、「NetScalerエージェントの設定」(#configure-the-citrix-adm-agent)で指定されたパラメータを追加したことを確認してください。
NetScalerエージェントの登録とデフォルトパスワードの変更を自動化するには、同じ.ovfファイルに、以下のパラメータの値を追加します。
  1. ADMサーバーIP
  2. ADMユーザー名
  3. ADMパスワード
  4. エージェントの新しいパスワード

前提条件

仮想アプライアンスのインストールを開始する前に、以下を確認してください。
  • 最小システム要件を満たす管理ワークステーションにVMware vSphere 8.xをインストールします。
  • NetScaler® ADMセットアップファイルをダウンロードします。

NetScalerエージェントを設定および登録する方法

.OVF ファイルをダウンロードして編集する

  1. MASAGENT-ESX-releasenumber-buildnumber.zip からファイルを目的の場所に抽出します。以下のファイルが利用可能です。
    • .ovf ファイル
    • .vmdk ファイル
    • .ova ファイル
    • .mf ファイル
  2. .ovf ファイルを任意のエディターで開き、以下の <ProductSection>..</ProductSection> サンプルコードを </VirtualHardwareSection> タグの後に追加します。
<ProductSection>
    <Info>Information about the installed software</Info>
    <Product>Application Delivery management</Product>
    <Vendor>Citrix</Vendor>

    <Property ovf:userConfigurable="true" ovf:value="VALUE" ovf:type="string"
    ovf:key="eth0.ip">
    <Label>IPAddress</Label>
    </Property>

    <Property ovf:userConfigurable="true" ovf:value="VALUE" ovf:type="string"
    ovf:key="eth0.netmask">
    <Label>Netmask</Label>
    </Property>

    <Property ovf:userConfigurable="true" ovf:value="VALUE" ovf:type="string"
    ovf:key="eth0.gateway">
    <Label>Gateway</Label>
    </Property>

    <Property ovf:userConfigurable="true" ovf:value="VALUE" ovf:type="string"
    ovf:key="eth0.nameserver">
    <Label>Nameserver</Label>
    </Property>

    <Property ovf:userConfigurable="true" ovf:value="VALUE" ovf:type="string"
    ovf:key="eth0.hostname">
    <Label>Hostname</Label>
    </Property>

    <Property ovf:userConfigurable="true" ovf:value="VALUE" ovf:type="string"
    ovf:key="eth0.ServerIP">
    <Label>ADM Server IP</Label>
    </Property>

    <Property ovf:userConfigurable="true" ovf:value="VALUE" ovf:type="string"
    ovf:key="eth0.ServerUname">
    <Label>ADM Username</Label>  
    </Property>

    <Property ovf:userConfigurable="true" ovf:password="true" ovf:value="VALUE"
    ovf:type="string" ovf:key="eth0.ServerPassword">
    <Label>ADM Password</Label>
    </Property>

    <Property ovf:userConfigurable="true" ovf:password="true" ovf:value="VALUE"
    ovf:type="string" ovf:key="eth0.NewPassword">
    <Label>Agent New Password</Label>
    </Property>

</ProductSection>
  1. 設定したいパラメーターについては、ovf:value="VALUE" に対応する値を追加します。
    • NetScaler エージェントを設定するには、以下のパラメーターに値を追加します。
      • IPアドレス
      • ネットマスク
      • ゲートウェイ
      • ネームサーバー
      • ホスト名
    • NetScaler エージェントを登録し、デフォルトパスワードを変更するには、以下のパラメーターに値を追加します。
      • ADMサーバーIP
      • ADMユーザー名
      • ADMパスワード
      • エージェントの新しいパスワード
    注
    • エージェントを登録してデフォルトパスワードを変更する前に、NetScalerエージェントを設定する必要があります。
    • .ovfファイルでデフォルトパスワードを登録して変更しない場合、VMの展開後にこれらのアクションを手動で実行する必要があります。
    OVFファイルを編集する(/en-us/netscaler-application-delivery-management-software/media/automate-adm-agent-ovf.png)
  2. パラメータとその値を追加したら、.ovfファイルを保存します。

VMware ESXiにNetScaler ADM仮想アプライアンスをインストールする

  1. VMWare vSphere Clientにログインし、管理者資格情報を入力します。「ログイン」をクリックします。
    vSphereログイン(/en-us/netscaler-application-delivery-management-software/media/automate-adm-agent-vmsphere.png)
  2. ESXiサーバーを選択し、右クリックして「OVFテンプレートの展開」を選択します。
    OVFテンプレートの展開(/en-us/netscaler-application-delivery-management-software/media/automate-adm-agent-deploy-ovf.png)
  3. 「OVFテンプレートの展開」ページで、次のようにします。
    1. OVF テンプレートの選択: ローカルファイル を選択し、編集した .ovf ファイルと .vmdk ファイルを保存した場所に移動します。ファイルを選択し、開く をクリックしてアップロードします。次へ をクリックします。
      OVF テンプレートの選択
    2. 名前とフォルダーの選択: 仮想アプライアンスの名前を追加し、仮想マシンを展開する ESXi 上の場所を選択します。次へ をクリックします。
      名前とフォルダーの選択
    3. コンピューティングリソースの選択: テンプレートの展開後に実行するリソースを選択します。次へ をクリックします。
      コンピューティングリソースの選択
    4. 詳細の確認: OVF テンプレートの詳細を確認します。次へ をクリックします。
      詳細の確認
    5. ストレージの選択: OVF テンプレートを保存するデータストアを選択します。次へ をクリックします。
      ストレージの選択
    6. ネットワークの選択: デフォルト設定で続行します。次へ をクリックします。
      ネットワークの選択
    7. テンプレートのカスタマイズ: OVF テンプレートのすべてのプロパティを確認します。.OVF ファイルのダウンロードと編集 セクションの .ovf ファイルに追加したすべてのパラメーターと値が表示されます。
      テンプレートの確認
    8. 完了準備完了: 設定を保存して展開プロセスを開始するには、完了 をクリックします。
      デプロイメントの完了
    デプロイメントが完了するまで待ちます。OVFテンプレートのデプロイ操作のステータスが100%完了すると、エージェントがデプロイされます。
    OVFデプロイメントのステータス
    重要
    設定を編集する前に、仮想アプライアンスの電源をオンにしないでください。
  4. インストールした新しい仮想アプライアンスをクリックし、Configure > Settings > vApp Options > Edit に移動します。
  5. vAppオプションの編集ウィンドウで、OVF詳細 > OVF環境トランスポート に移動し、VMware Tools を選択します。OK をクリックします。
    設定の構成
  6. 仮想マシンを右クリックし、パワーオン をクリックします。または、仮想マシンのサマリータブを選択し、パワーオン をクリックすることもできます。
    VMのパワーオン
  7. サマリータブで、Webコンソールの起動 を選択します。 コンソールの起動ウィンドウで、Webコンソール を選択します。起動 をクリックします。
    コンソールの起動Webコンソールの選択
  8. コンソールに、NetScalerエージェントがNetScaler ADMサーバーに登録されると、登録成功メッセージが表示されます。NetScalerエージェントが展開され、デフォルトのパスワードが変更されたことを確認するには、NetScalerエージェントの ユーザー名と新しいパスワードでログインします。
    エージェント登録成功メッセージ

確認

NetScalerエージェントが展開されていることを確認するには:
  1. NetScalerエージェントが展開された後、ブラウザでNetScaler ADMサーバーのIP アドレスを入力してNetScaler ADM GUIにアクセスします。
  2. 資格情報を使用してサーバーにログインします。
  3. Infrastructure > Instances > Agents に移動します。 新しく展開されたエージェントがESXプラットフォームに表示されます。