インスタンスを管理するようにADC組み込みエージェントを構成する
組み込みエージェントは、バージョン12.1.48.13
以降を実行しているCitrix ADC MPX、VPX、Gatewayインスタンス、およびバージョン13.0 61.x以降および12.1 58.x以降を実行するCitrix ADC SDXインスタンスで使用できます。データセンターやパブリッククラウドに専用エージェントをインストールする代わりに、ADC インスタンスでこのエージェントを開始できます。ビルトインエージェントにより、インスタンスとCitrix ADM 間の通信が可能になります。
注
組み込みエージェントは、次のCitrix ADCインスタンスタイプでのみ使用できます。
- NetScaler MPX
- NetScaler VPX
- NetScaler SDX
- NetScaler Gateway
内蔵エージェントは、小規模なADCスタンドアロンまたはHAペアの導入に最適です。複数の ADC インスタンスがある場合は、デプロイ用に専用エージェントを使用します。このエージェントにより、組み込みエージェントよりも優れたデータ集約機能が確保されます。詳細については、「 エージェントをオンプレミスにインストールする」を参照してください。
NetScaler ADM は、組み込みエージェントを使用して NetScaler インスタンスの管理と監視をサポートします。ただし、次の機能は組み込みエージェントではサポートされていません。
- アプリケーションダッシュボード
- Web Insight
- SSL insight
- HDX Insight
- Gateway insight
- セキュリティに関する洞察
- 高度な分析
- プールライセンス
組み込みエージェントから外部エージェントに移行できます。詳細については、「 組み込みエージェントから外部エージェントへの移行」を参照してください。
前提条件
Citrix ADCインスタンスで組み込みエージェントを構成する前に、次のことを確認してください。
-
NetScaler(MPX、VPX、またはゲートウェイ) インスタンスがバージョン
12.1.48.13
以降で実行されている。SDX インスタンスは、バージョン13.0.61.x
以降を実行しています。 -
Citrix ADCインスタンス上にDNSネームサーバーが追加されます。
詳細については、「 ネームサーバーの追加」を参照してください。
-
Citrix Cloudアカウントがある。詳しくは、「 Citrix Cloud へのサインアップ」を参照してください。
注
ポートとその他のシステム要件に関連するすべての情報については、「 システム要件」を参照してください。
組み込みエージェントの設定
ADC 組み込みエージェントを設定するには、次の作業を実行します。
-
「 はじめに」の指示に従って、ビルトインエージェントオプションを選択します。
-
サービス URLとアクティベーションコードをコピーします。
エージェントは、サービス URL を使用してサービスを検索し、アクティベーションコードを使用してサービスに登録します。MPX または Gateway カスタマーの場合は、手順 7 をスキップします。
-
SSH クライアントを使用して組み込みエージェントを開始します。ゲートウェイユーザーは、この手順を省略する必要があります。
-
Citrix ADCインスタンスにログオンします。詳しくは、「 Citrix ADCへのアクセス」を参照してください。
-
/var/mastools/scripts
ディレクトリに移動し、次のコマンドを入力します。SDX インスタンス
./mastools_init.sh <user_name> <service-url> <activation-code> -sdx <!--NeedCopy-->
-
<user_name>
で、NetScaler ユーザー名を入力します。
./mastools_init.sh <device-profile-name> <service-url> <activation-code> -sdx -profile <!--NeedCopy-->
注:
Citrix ADMは、そのSDX上で実行されているすべてのVPXインスタンスを検出するため、VPXインスタンスを個別に登録する必要はありません。
SDXアプライアンスで実行されていないVPXインスタンス、およびMPXおよびゲートウェイインスタンスの場合:
ADC イメージのバージョンが 13.0 61.x または 12.1 57.x より低い場合は、コマンド
cat /var/mastools/version.txt
を入力してmastools
バージョンを確認する必要があります 。出力が0.0-0.0
の場合、これが初めてです。ソフトウェアのバージョンに応じて、次のコマンドのいずれかを入力します。
ADCイメージ・バージョン 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>
-
<user_name>
で、NetScaler ユーザー名を入力します。
-
注:
HA ペアでは、プライマリノードで登録を完了します。2 次ノードで登録を実行すると、次のメッセージが表示されます。
プライマリノードで登録コマンドを実行してください。
-
-
NetScaler ADM ページに戻り、「 インスタンスの登録」をクリックします。
-
[ Add Instances] で、組み込みエージェントを開始したインスタンスを表示します。インスタンスが [ Up ] ステータスになっていることを確認し、[ Next] をクリックします。
-
[完了] をクリックします。
組み込みエージェントの設定が成功すると、次のようなCitrix ADM機能にアクセスできます。
-
仮想サーバーと分析 — ライセンスを仮想サーバーに適用して、ADC インスタンスを管理します。詳細については、「 サブスクリプションの管理」を参照してください。
-
アプリケーションダッシュボード — すべてのアプリケーションを総合的に表示します。詳細については、「 アプリケーション管理とダッシュボード」を参照してください。
-
インフラストラクチャ分析 — この機能は、インスタンスに問題を引き起こした、または結果として生じる可能性のある要因を視覚化するのに役立ちます。詳細については、「 インフラストラクチャ分析」を参照してください。
注:[ インフラストラクチャ] > [インスタンス] > [エージェント] > [アクティベーションコードの生成] ページに移動して、ビルトインエージェントを設定することもできます 。URL とアクティベーションコードをコピーして ADC インスタンスに貼り付け、そのインスタンスを検出します。
ビルトインエージェントが開始されたら、[ インフラストラクチャ]>[インスタンス]>[NetScaler]に移動します。このページには、組み込みエージェントを使用して検出された管理対象インスタンスの詳細が表示されます。
トラブルシューティング
登録に失敗した場合や登録は成功しても組み込みエージェントがCitrix ADM GUIに表示されない場合は、ログを確認できます。
- 登録に失敗した場合は、
/var/mastools/logs/mastools_reg.py.log
のログをチェックしてください - 登録は成功してもCitrix ADM GUIにビルトインエージェントが表示されない場合は、以下を確認してください。
-
/var/mastools/logs/mastools_upgrade.log
ログのMastools_upgrade -
/var/log/mastoolsd.log
のバイナリログ。
-