インスタンスを管理するように組み込みエージェントを構成する

最終公開日 : Oct 02, 2026
NetScaler MPX、VPX、Gateway インスタンス (バージョン 12.1.48.13 以降を実行) および NetScaler SDX インスタンス (バージョン 13.0 61.x 以降および 12.1 58.x 以降を実行) で、組み込みエージェントを利用できます。データセンターまたはパブリッククラウドに専用エージェントをインストールする代わりに、NetScaler インスタンスでこのエージェントを起動できます。組み込みエージェントは、インスタンスとNetScaler Console間の通信を可能にします。
注:
組み込みエージェントは、以下のNetScalerインスタンスタイプでのみ利用可能です。
  • NetScaler MPX
  • NetScaler VPX
  • NetScaler SDX
  • ネットスケーラー ゲートウェイ
組み込みエージェントは、小規模なNetScalerスタンドアロンまたはHAペア展開に最適です。複数のNetScalerインスタンスがある場合は、展開に専用エージェントを使用してください。このエージェントは、組み込みエージェントよりも優れたデータ集約機能を提供します。詳細については、「オンプレミスにエージェントをインストールする」を参照してください。
NetScaler Consoleの組み込みエージェントは、インスタンス管理、監視、およびプールまたはフレックスライセンスをサポートしています。ただし、組み込みエージェントでは以下の機能はサポートされていません。
  • アプリケーションダッシュボード
  • ウェブ インサイト
  • SSL インサイト
  • HDX™ インサイト
  • ゲートウェイ インサイト
  • セキュリティインサイト
  • 高度な分析
  • プールまたはフレックスライセンス (ファイルベースライセンス)
組み込みエージェントから外部エージェントに移行できます。詳細については、「組み込みエージェントから外部エージェントへの移行」を参照してください。
Related information
はじめに

前提条件

NetScalerインスタンスで組み込みエージェントを構成する前に、以下を確認してください。
  • NetScaler (MPX、VPX、またはGateway) インスタンスはバージョン 12.1.48.13 以降で実行されています。SDXインスタンスはバージョン 13.0.61.x 以降で実行されています。
  • NetScalerインスタンスにDNSネームサーバーが追加されています。
    詳細については、「ネームサーバーの追加」を参照してください。
  • Citrix Cloudアカウントをお持ちであること。詳細については、「Citrix Cloudへのサインアップ」を参照してください。
注:
ポートおよびその他のシステム要件に関するすべての情報については、「システム要件」を参照してください。

組み込みエージェントの構成

NetScaler組み込みエージェントを構成するには、次のタスクを実行します。
  1. 「はじめに」の指示に従って、 オプションを選択します。
  2. 「サービスURL」と「アクティベーションコード」をコピーします。
    エージェントはサービスURLを使用してサービスを特定し、アクティベーションコードを使用してサービスに登録します。MPXまたはGatewayのお客様は、手順7をスキップしてください。
  3. SSHクライアントを使用して組み込みエージェントを起動します。Gatewayユーザーはこの手順をスキップする必要があります。
    1. NetScalerインスタンスにログオンします。詳細については、「NetScalerへのアクセス」を参照してください。
    2. /var/mastools/scriptsディレクトリに移動し、次のコマンドを入力します。
      SDXインスタンスの場合
      NetScalerプロファイルでの登録 NetScalerプロファイルなしでの登録
      前提条件 登録する前に、NetScalerプロファイルを作成します。詳細については、「NetScalerプロファイルの作成方法」を参照してください。
      このコマンドを実行します ./mastools_init.sh <device-profile-name> <service-url> <activation-code> -sdx -profile ./mastools_init.sh <user_name> <service-url> <activation-code> -sdx
      ユーザー資格情報 <device_profile_name>にnsrootを入力します。または、nsrootと同じアクセス権限を持つユーザー名を使用することもできます。 <user_name>にnsrootを入力します。または、nsroot と同じアクセス権限を持つユーザー名を使用することもできます。
      注：
      NetScaler Console は、その SDX で実行されているすべての VPX インスタンスを検出し、VPX インスタンスを個別に登録する必要はありません。
      SDX アプライアンスで実行されていない VPX インスタンス、および MPX および Gateway インスタンスの場合：
      NetScaler イメージのバージョンが 13.0 61.x または 12.1 57.x より低い場合は、コマンド cat /var/mastools/version.txt を入力して mastools のバージョンを確認する必要があります。出力が 0.0-0.0 の場合、初回です。
      ソフトウェアのバージョンに応じて、次のいずれかのコマンドを入力します。
      注：
      NetScaler プロファイルに登録する前に、プロファイルを作成する必要があります。詳細については、「NetScaler プロファイルの作成方法」を参照してください。
      NetScaler イメージバージョン mastools_version は 0.0-0.0 ですか？ プロファイルを使用した登録コマンド プロファイルを使用しない登録コマンド
      13.0 61.xx および 12.1 57.xx より低い はい ./mastools_init.sh <device_profile_name> <service_url> "MAS;<activation_code>" -profile ./mastools_init.sh <user_name> <pwd> <service_url> "MAS;<activation_code>"
      13.0 61.xx および 12.1 57.xx より低い いいえ ./mastools_init.sh <device_profile_name> <service_url> <activation_code> -profile ./mastools_init.sh <user_name> <pwd> <service_url> <activation_code>
      13.0 61.x および 12.1 57.xx より高い 該当なし ./mastools_init.sh <device_profile_name> <service_url> <activation_code> -profile ./mastools_init.sh <user_name> <pwd> <service_url> <activation_code>
    注:
    • <device_profile_name> または <user_name> に、nsroot と入力します。または、nsroot と同じアクセス権限を持つユーザー名を使用することもできます。
    • HAペアでは、プライマリノードで登録を完了します。セカンダリノードで登録コマンドを実行すると、次のメッセージが表示されます: プライマリノードで登録コマンドを実行してください。
  4. NetScaler Consoleページに戻り、インスタンスの登録をクリックします。
  5. インスタンスの追加で、組み込みエージェントを起動したインスタンスを表示します。インスタンスが稼働中ステータスであることを確認し、次へをクリックします。
  6. 完了をクリックします。
組み込みエージェントの構成が成功すると、NetScaler Consoleの機能にアクセスできます。たとえば、次のとおりです。
  • 仮想サーバーと分析 – 仮想サーバーにライセンスを適用して、NetScalerインスタンスを管理します。詳細については、「サブスクリプションの管理」を参照してください。
  • アプリケーションダッシュボード – すべてのアプリケーションを包括的に表示します。詳細については、「アプリケーション管理とダッシュボード」を参照してください。
  • インフラストラクチャ分析 – この機能は、インスタンスで問題を引き起こした、または引き起こす可能性のある要因を視覚化するのに役立ちます。詳細については、「インフラストラクチャ分析」を参照してください。

NetScaler®組み込みエージェントを介したライセンスサーバーの構成

注:
NetScaler組み込みエージェントにはLSAロールを割り当てることはできません。
あるサイトでライセンスサーバーエージェント (LSA) が構成されており、他のサイトから同じLSAを使用したい場合は、NetScaler組み込みエージェントを使用できます。組み込みエージェントを使用している間は、NetScalerインスタンスで次のコマンドを使用してライセンスサーバーを構成する必要があります。
add licenseserver 127.0.0.1 -port 27000
この構成では、NetScalerはConsoleサービスを介してライセンスサーバーエージェント (LSA) に到達できます。
注:
組み込みエージェントは、インフラストラクチャ > インスタンス > エージェント > アクティベーションコードの生成ページに移動して構成することもできます。URLとアクティベーションコードをNetScalerインスタンスにコピーして貼り付け、そのインスタンスを検出します。
組み込みエージェントが起動したら、インフラストラクチャ > インスタンス > NetScalerに移動します。このページには、組み込みエージェントを使用して検出された管理対象インスタンスの詳細が表示されます。

トラブルシューティング

登録が失敗した場合、または登録は成功したが組み込みエージェントがNetScaler Console GUIに表示されない場合は、ログを確認できます。
  • 登録に失敗した場合は、/var/mastools/logs/mastools_reg.py.logでログを確認してください。
  • 登録が成功しても、ビルトインエージェントがNetScaler Console GUIに表示されない場合は、以下を確認してください。
    • /var/mastools/logs/mastools_upgrade.logのMastools_upgradeログ
    • /var/log/mastoolsd.logのバイナリログ。