VMware ESXi 上でのNetScaler® エージェントの展開を自動化

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

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

エージェントの構成を自動化するには、.ovf ファイルに次のパラメータの値を追加します。
  1. IPAddress
  2. Netmask
  3. Gateway
  4. Nameserver
  5. Hostname
注:
.ovf ファイルはエージェントイメージファイルに含まれています。NetScaler エージェントファイルをダウンロードするには、<https://www.citrix.com/downloads/citrix-application-management/> にアクセスしてください。エージェントイメージファイルの命名パターンは次のとおりです。MASAGENT-ESX-releasenumber-buildnumber.zip

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

注記:
登録とデフォルトパスワードの変更を行う前に、NetScaler エージェントの構成で指定されているパラメータを追加したことを確認してください。
NetScaler エージェントの登録とデフォルトパスワードの変更を自動化するには、同じ .ovf ファイルで次のパラメータの値を追加します。
  1. NetScaler Console Server IP
  2. NetScaler Console Username
  3. NetScaler Console Password
  4. Agent New Password

前提条件

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

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

ステップ1:.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>NetScaler Console Server IP</Label>
    </Property>

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

    <Property ovf:userConfigurable="true" ovf:password="true" ovf:value="VALUE"
    ovf:type="string" ovf:key="eth0.ServerPassword">
    <Label>NetScaler Console 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>
  3. 設定したいパラメーターについては、ovf:value="VALUE"に対応する値を追加します。
    • NetScalerエージェントを設定するには、以下のパラメーターに値を追加します。
      • IPAddress
      • Netmask
      • Gateway
      • Nameserver
      • Hostname
    • NetScalerエージェントを登録し、デフォルトのパスワードを変更するには、以下のパラメーターに値を追加します。
      • NetScaler Console Server IP
      • NetScaler Console Username
      • NetScaler Console Password
      • Agent New Password
    注:
    • エージェントを登録してデフォルトパスワードを変更する前に、NetScalerエージェントを設定する必要があります。
    • .ovfファイルでデフォルトパスワードを登録して変更しない場合は、VMの展開後にこれらのアクションを手動で実行してください。
    OVFファイルを編集
  4. パラメータとその値を追加したら、.ovfファイルを保存します。

ステップ2:VMware ESXiにNetScaler Console仮想アプライアンスをインストールする

  1. VMWare vSphere Clientにログインし、管理者資格情報を入力します。ログインをクリックします。
    vSphereログイン
  2. ESXiサーバーを選択し、右クリックしてOVFテンプレートの展開を選択します。
    OVFテンプレートの展開
  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 Consoleサーバーに登録された後、登録成功メッセージが表示されます。NetScalerエージェントがデプロイされ、デフォルトパスワードが変更されたことを確認するには、NetScalerエージェント のユーザー名と新しいパスワードでログインします。
    エージェント登録成功メッセージ

ステップ 3: 確認

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