NetScaler CPXインスタンスをNetScaler Consoleに追加する

最終公開日 : Sep 25, 2026
DockerホストにインストールされているNetScaler CPXインスタンスを管理および監視するには、それらをNetScaler Application Delivery Management (ADM) ソフトウェアに追加する必要があります。
インスタンスは、ADMを初めてセットアップするとき、または後で追加できます。
インスタンスを追加するには、インスタンスプロファイルを作成し、各インスタンスのホスト名またはIPアドレス、あるいはIPアドレスの範囲を指定する必要があります。このインスタンスプロファイルには、NetScaler Consoleに追加するインスタンスのユーザー名とパスワードが含まれています。インスタンスタイプごとに、デフォルトプロファイルが利用可能です。たとえば、ns-root-profile はNetScalerインスタンスのデフォルトプロファイルです。このプロファイルは、デフォルトのADC管理者資格情報によって定義されます。インスタンスのデフォルトの管理者資格情報を変更した場合は、それらのインスタンス用にカスタムインスタンスプロファイルを定義できます。インスタンスが検出された後にインスタンスの資格情報を変更した場合は、インスタンスプロファイルを編集するか、プロファイルを作成してから、インスタンスを再検出する必要があります。

前提条件

以下のことを確認してください。
  • Citrix XenServerにNetScaler Consoleソフトウェアがインストールされていること。詳しくは、「NetScaler Console Documentation」を参照してください。
  • DockerホストにNetScaler CPXインスタンスがインストールされていること。
NetScaler CPXインスタンスをADMに追加するには：
  1. Webブラウザーで、NetScaler Application Delivery Management のIPアドレスを入力します（例：http://192.168.100.1）。
  2. User Name フィールドと Password フィールドに、管理者資格情報を入力します。デフォルトの管理者資格情報は nsroot と nsroot です。
  3. Networks \> Instances > NetScaler に移動し、CPX タブをクリックします。
  4. Add をクリックして、NetScaler Consoleに新しいCPXインスタンスを追加します。
  5. Add NetScaler CPX ページが開きます。次のパラメーターの値を入力します。
    1. CPXインスタンスの到達可能なIPアドレス、またはCPXインスタンスがホストされているDockerコンテナのIPアドレスのいずれかを指定して、CPXインスタンスを追加できます。
    2. CPXインスタンスのプロファイルを選択します。
    3. インスタンスをデプロイするサイトを選択します。
    4. エージェントを選択します。
    5. オプションとして、インスタンスにキーと値のペアを入力できます。キーと値のペアを追加すると、後でインスタンスを簡単に検索できるようになります。
      CPXインスタンスの追加(/en-us/cpx/media/add-cpx-instances.png)
  6. OKをクリックします。
注
インスタンスを再検出する場合は、ネットワーク \> インスタンス \> NetScaler > CPXを選択し、再検出するインスタンスを選択してから、アクションの選択ドロップダウンリストから再検出をクリックします。

環境変数を使用してNetScaler CPXインスタンスをNetScaler Consoleに追加する

環境変数を使用してNetScaler CPXインスタンスをNetScaler Consoleに追加することもできます。インスタンスを追加するには、NetScaler CPXインスタンスに対して以下の環境変数を構成する必要があります。
  • NS_MGMT_SERVER - ADM IPアドレス/FQDN
  • HOST - ノードIPアドレス
  • NS_HTTP_PORT - ノード上のマッピングされたHTTPポート
  • NS_HTTPS_PORT - ノード上のマッピングされたHTTPSポート
  • NS_SSH_PORT - ノード上のマッピングされたSSHポート
  • NS_SNMP_PORT - ノード上のマッピングされたSNMPポート
  • NS_ROUTABLE - (NetScaler CPXポッドのIPアドレスは外部からルーティングできません。)
  • NS_MGMT_USER – ADMユーザー名
  • NS_MGMT_PASS – ADMパスワード
以下は、NetScaler ConsoleにNetScaler CPXインスタンスを追加するためのdocker runコマンドの例です。
 docker run -dt --privileged=true -p 9080:9080 -p 9443:9443 -p 9022:22 -p 9161:161 -e EULA=yes -e NS_MGMT_SERVER=abc-mgmt-server.com -e HOST=10.1.1.1 -e NS_HTTP_PORT=9080 -e NS_HTTPS_PORT=9443 -e NS_SSH_PORT=9022 -e NS_SNMP_PORT=9161 -e NS_ROUTABLE=0 --ulimit core=-1 –name test cpx:latest

Kubernetes ConfigMapを使用してNetScaler ConsoleにNetScaler CPXインスタンスを追加する

NetScaler CPXは、Kubernetes ConfigMapを介してボリュームマウントされたファイルを使用することで、NetScaler Consoleへの登録をサポートします。この登録方法を有効にするには、NetScaler CPXは、ConfigMapとSecretを介してボリュームマウントされたファイルとともに指定されるいくつかの環境変数を必要とします。
以下は、必要な環境変数とその説明です。
  • NS_HTTP_PORT - ノード上のマッピングされたHTTPポートを指定します。
  • NS_HTTPS_PORT - ノード上のマッピングされたHTTPSポートを指定します。
  • NS_SSH_PORT - ノード上のマッピングされたSSHポートを指定します。
  • NS_SNMP_PORT- ノード上のマッピングされたSNMPポートを指定します。
リストされている環境変数とは別に、NetScaler CPXは登録する必要があるADMエージェントに関する情報を必要とします。この情報には、ADMエージェントのIPアドレスまたはFQDNの詳細と資格情報が含まれます。NetScaler CPXは、ボリュームマウントされたファイルからこの情報を取得します。IPアドレスまたはFQDNを含むConfigMapは、NetScaler CPXインスタンスのファイルシステムにファイルとしてマウントされます。ADMエージェントの資格情報を含むKubernetesシークレットも、NetScaler CPXインスタンスのファイルシステムにファイルとしてマウントされます。登録に必要なすべての情報が揃うと、NetScaler CPXはADMエージェントへの登録を試みます。
以下は、ConfigMapとSecretがファイルとしてマウントされたNetScaler CPX YAMLファイルスニペットの例です。
    …
    env:
    - name: "EULA"
      value: "yes"
    - name: "NS_HTTP_PORT"
      value: "9080"
    - name: "NS_HTTPS_PORT"
      value: "9443"
    - name: "NS_SSH_PORT"
      value: "22"
    - name: "NS_SNMP_PORT"
      value: "161"
    - name: "KUBERNETES_TASK_ID"
      value: ""
    …
    volumeMounts:
      …
      - mountPath: /var/adminfo/server/
        name: adm-agent-config
      - mountPath: /var/adminfo/credentials/
        name: adm-agent-user
      …
volumes:
…
- name: adm-agent-config
  configMap:
    name: adm-agent-config
- name: adm-agent-user
  secret:
    secretName: adm-secret
上記の例では、adm-agent-configという名前のConfigMapとadm-agent-userというシークレットが使用されています。以下は、必要なConfigMapとSecretを作成する例です。
ConfigMap: ConfigMap は adm_reg_envs という名前のファイルから作成されます。このファイルには、ADM エージェントの IP アドレスまたは FQDN を次の形式で指定する必要があります。
NS_MGMT_SERVER=adm-agent
上記の形式では、adm-agent は NetScaler CPX インスタンスを登録する必要がある ADM エージェントの FQDN です。
ConfigMap を作成するには、次のコマンドを使用します。
kubectl create configmap adm-agent-config --from-file=adm_reg_envs
注: ファイル名には adm_reg_envs 変数を含める必要があり、/var/adminfo/server/ のパスにマウントする必要があります。
シークレット: Kubernetes シークレットを作成するには、次のコマンドを使用します。次のコマンドでは、user123 は ADM エージェントのユーザー名、pass123 はパスワードです。
kubectl create secret generic adm-secret --from-literal=NS_MGMT_USER=user123 --from-literal=NS_MGMT_PASS=pass123
NetScaler CPX インスタンスは、ADM エージェントをクラスターに展開する前でも、必要な環境変数とボリュームマウントされたファイルを使用して Kubernetes クラスターに展開できます。ADM エージェントを展開する前に NetScaler CPX インスタンスを展開すると、ADM エージェントが展開されるまで NetScaler CPX は登録を試行し続けます。ADM エージェントが展開されると、NetScaler CPX インスタンスは、環境変数とボリュームマウントされたファイルを通じて提供された構成データを使用して ADM エージェントに登録します。これにより、構成情報を含む NetScaler CPX の再展開を回避できます。
すでに ADM エージェントに登録されている NetScaler CPX インスタンスは、構成の変更後に別の ADM エージェントへの登録を動的に変更できます。このためには、すでに展開されている NetScaler CPX の ConfigMap とシークレットの構成情報を更新できます。ConfigMap が作成されたファイルを新しい ADM エージェントの IP アドレスまたは FQDN で更新し、古い ConfigMap を削除してから、新しい ConfigMap を作成する必要があります。同様に、既存のシークレットを削除し、新しい ADM エージェントの資格情報で新しいシークレットを作成する必要があります。