Citrix Application Delivery Managementサービス

インスタンスを管理するように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インスタンスタイプでのみ使用できます。

  • Citrix ADC MPX
  • Citrix ADC VPX
  • Citrix ADC SDX
  • Citrix Gateway

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

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

  • アプリケーションダッシュボード
  • Web Insight
  • SSL insight
  • HDX Insight
  • Gateway insight
  • セキュリティに関する洞察
  • 高度な分析
  • プールライセンス

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

前提条件

Citrix ADCインスタンスで組み込みエージェントを構成する前に、次のことを確認してください。

  • Citrix ADC(MPX、VPX、またはゲートウェイ) インスタンスがバージョン12.1.48.13以降で実行されている。SDX インスタンスは、バージョン13.0.61.x以降を実行しています。

  • Citrix ADCインスタンス上にDNSネームサーバーが追加されます。

    詳しくは、「ネームサーバの追加」を参照してください。

  • Citrix Cloudアカウントがある。詳しくは、「Citrix Cloudへのサインアップ」を参照してください。

ポートおよびその他のシステム要件に関する情報については、「システム要件」を参照してください。

組み込みエージェントの設定

ADC 組み込みエージェントを設定するには、次の作業を実行します。

  1. Citrix Cloudにサインインします。

  2. [ アプリケーション配信の管理 ] タイルで、[ 管理] をクリックします。次に、ビジネスニーズに合った地域を選択します。詳しくは、「エクスプレスアカウントでCitrix ADMを管理する」を参照してください。

    Citrix ADM Expressアカウント

  3. [ 開始] をクリックします。

    導入

  4. ADC 展開の種類として [オンプレミス ] を選択します。

    オンプレミスの ADC 展開の種類を選択

  5. 組み込みエージェント」を選択します。

    重要

    組み込みエージェントを使用するには、Citrix ADC インスタンスがバージョン 12.1 ビルド 48.13 以上である必要があります。

    組み込みエージェントを選択

    サービス URL とアクティベーションコードが生成され、GUI に表示されます。

  6. サービス URLとアクティベーションコードをコピーします

    エージェントは、サービス URL を使用してサービスを検索し、アクティベーションコードを使用してサービスに登録します。MPX または Gateway カスタマーの場合は、手順 7 をスキップします。

    サービス URL とアクティベーションコードのコピー

  7. SSH クライアントを使用して組み込みエージェントを開始します。ゲートウェイユーザーは、この手順を省略する必要があります。

    1. Citrix ADCインスタンスにログオンします。詳しくは、「Citrix ADCへのアクセス」を参照してください。

    2. /var/mastools/scriptsディレクトリに移動し、次のコマンドを入力します。

      SDX インスタンス

      ./mastool_int.sh <user-name> <service-url> <activation-code> -sdx
      <!--NeedCopy-->
      

      または

      ./mastool_init.sh <device-profile-name> <service-url> <activation-code> -sdx -profile
      
      <!--NeedCopy-->
      

      注:

      ADMは、そのSDX上で実行されているすべてのVPXインスタンスを検出します。VPXインスタンスを個別に登録する必要はありません。

      SDXアプライアンスおよびMPXインスタンスおよびゲートウェイインスタンスで実行されていないVPXインスタンス

      ADM イメージのバージョンが 13.0 61.x または 12.1 57.x より低い場合は、コマンドcat /var/mastools/version.confを入力してmastoolsバージョンを確認する必要があります。出力が0.0-0.0の場合、これが初めてです。

      ソフトウェアのバージョンに応じて、次のコマンドのいずれかを入力します。

      ADCイメージ・バージョン mastools_version0.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>
      • <username>で、Citrix ADC ユーザー名を入力します。

      • <password>で、ADC パスワードを入力します。

      • <service_url>で、前の手順でコピーした URL を貼り付けます。

      • <activation_code>で、前の手順でコピーしたアクティベーションコードを貼り付けます。

      CLIが組み込みエージェントを開始

    MPX、VPX、および Gateway インスタンスの場合、mastoolsコマンドを使用した初期化が完了すると、エージェントと ADM サービス間の通信が確立されます。エージェントは、最新のソフトウェアバージョンが使用可能になると、自動的にアップグレードされます。ただし、バージョン ADC 12.1 57.18 以降、および ADC 13.0 61.48 以降では、組み込みエージェントは初期化なしで ADM サービスと通信し、定期的に最新のソフトウェアバージョンに自動的にアップグレードされます。 SDX インスタンスの場合、エージェントには 13.0 61.x 以降、12.1 58.x 以降のすべてのサポートされているバージョンで自動アップグレード機能が付属しています。

    注:

    HAペアでは、プライマリノードでの登録を完了します。2 次ノードで登録を実行すると、次のメッセージが表示されます。

    1 次ノードで登録コマンドを実行してください。

  8. ADM サービスページに戻り、[ インスタンスの登録] をクリックします。

  9. [ Add Instances] で、組み込みエージェントを開始したインスタンスを表示します。インスタンスが [ Up ] ステータスになっていることを確認し、[ Next] をクリックします。

    インスタンスを追加する

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

完全な組み込みエージェント構成

組み込みエージェントの設定に成功すると、次のようなADM機能にアクセスできます。

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

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

  • インフラストラクチャ分析 — この機能は、インスタンスに問題を引き起こした、または結果として生じる可能性のある要因を視覚化するのに役立ちます。詳しくは、「インフラストラクチャ分析」を参照してください。

注:

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

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

トラブルシューティング

登録が失敗した場合、または登録は成功しても、組み込みエージェントが ADM GUI に表示されない場合は、ログをチェックできます。

  • 登録に失敗した場合は、/var/mastools/logs/mastools_reg.py.logのログをチェックしてください
  • 登録は成功しても、組み込みエージェントがADM GUIに表示されない場合は、次の点を確認してください。
    • /var/mastools/logs/mastools_upgrade.logログのMastools_upgrade
    • /var/log/mastoolsd.logバイナリログ
インスタンスを管理するようにADC組み込みエージェントを構成する