NetScaler Console サービス

インスタンスを管理するための組み込みエージェントの設定

組み込みエージェントは、バージョン 12.1.48.13 以降を実行しているNetScaler MPX、VPX、Gatewayインスタンス、およびバージョン 13.0 61.x 以降と 12.1 58.x 以降を実行しているNetScaler SDXインスタンスで利用できます。データセンターまたはパブリッククラウドに専用エージェントをインストールする代わりに、NetScalerインスタンスでこのエージェントを起動できます。組み込みエージェントは、インスタンスとNetScaler Console間の通信を可能にします。

注:

組み込みエージェントは、以下のNetScalerインスタンスタイプでのみ利用可能です。

  • NetScaler MPX
  • NetScaler VPX
  • NetScaler SDX
  • NetScaler Gateway

組み込みエージェントは、小規模なNetScalerスタンドアロンまたはHAペア展開に最適です。複数のNetScalerインスタンスがある場合は、展開に専用エージェントを使用してください。このエージェントは、組み込みエージェントよりも優れたデータ集約機能を提供します。詳細については、「オンプレミスでのエージェントのインストール」を参照してください。

NetScaler Consoleは、組み込みエージェントを使用したNetScalerインスタンスの管理と監視をサポートしています。ただし、組み込みエージェントでは以下の機能はサポートされていません。

  • アプリケーションダッシュボード
  • Web Insight
  • SSL Insight
  • HDX Insight
  • Gateway Insight
  • Security Insight
  • 高度な分析
  • プール/フレックスライセンス

組み込みエージェントから外部エージェントに移行できます。詳細については、「組み込みエージェントから外部エージェントへの移行」を参照してください。

前提条件

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
      ユーザー資格情報 nsroot と入力します。または、nsroot と同じアクセス権を持つユーザー名を使用できます。 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ペアでは、プライマリノードで登録を完了します。セカンダリノードで登録コマンドを実行すると、次のメッセージが表示されます: Please run the registration command on the primary node
  4. NetScaler Consoleページに戻り、[インスタンスの登録] をクリックします。

  5. [インスタンスの追加] で、組み込みエージェントを起動したインスタンスを表示します。インスタンスが [稼働中] ステータスであることを確認し、[次へ] をクリックします。

  6. [完了] をクリックします。

組み込みエージェントの構成が成功すると、NetScaler Consoleの以下の機能にアクセスできます。

  • 仮想サーバーと分析 – 仮想サーバーにライセンスを適用してNetScalerインスタンスを管理します。詳細については、「サブスクリプションの管理」を参照してください。

  • アプリケーションダッシュボード – すべてのアプリケーションを全体的に表示します。詳細については、「アプリケーション管理とダッシュボード」を参照してください。

  • インフラストラクチャ分析 – この機能は、インスタンスで問題が発生した、または発生する可能性のある要因を視覚化するのに役立ちます。詳細については、「インフラストラクチャ分析」を参照してください。

NetScaler組み込みエージェントによるライセンスサーバーの設定

注:

NetScaler組み込みエージェントにはLSAロールを割り当てることができません。

あるサイトでライセンスサーバーエージェント (LSA) を構成しており、他のサイトから同じLSAを使用したい場合は、NetScaler組み込みエージェントを使用できます。組み込みエージェントを使用している間は、NetScalerインスタンスで次のコマンドを使用してライセンスサーバーを構成する必要があります。

add licenseserver 127.0.0.1 -port 27000
<!--NeedCopy-->

この構成では、NetScalerはConsoleサービスを介してライセンスサーバーエージェント (LSA) に到達できます。

注:

[インフラストラクチャ] > [インスタンス] > [エージェント] > [アクティベーションコードの生成] ページに移動して、組み込みエージェントを構成することもできます。URLとアクティベーションコードをNetScalerインスタンスにコピーして貼り付け、そのインスタンスを検出します。

組み込みエージェントが起動されたら、[インフラストラクチャ] > [インスタンス] > [NetScaler] に移動します。このページには、組み込みエージェントを使用して検出された管理対象インスタンスの詳細が表示されます。

トラブルシューティング

登録が失敗した場合、または登録は成功したが組み込みエージェントがNetScaler Console GUIに表示されない場合は、ログを確認できます。

  • 登録が失敗した場合は、/var/mastools/logs/mastools_reg.py.log のログを確認します。
  • 登録は成功したが、組み込みエージェントがNetScaler Console GUIに表示されない場合は、以下を確認します。
    • /var/mastools/logs/mastools_upgrade.logMastools_upgrade ログ
    • /var/log/mastoolsd.logバイナリログ
インスタンスを管理するための組み込みエージェントの設定