7 Advanced Management Console エージェントのインストールと構成

Advanced Management Console エージェントは、クライアント・デスクトップでオペレーティング・システム(WindowsおよびmacOS)を使用するネイティブ・サービスとして動作します。エージェントは、インストールされたすべてのJava Runtime Environment (JRE)を探し、Java使用状況トラッカを有効にして自動的に構成します。企業ネットワークでは、エージェントによって、エージェント管理デスクトップでJava使用状況トラッカが有効になります。システム起動時、エージェントにより、Advanced Management Consoleクライアントでデータが報告されます。エージェントは、データ(オペレーティング・システムのファミリ、バージョンおよびインストールされたJRE)をAdvanced Management Consoleサーバーに定期的に報告します。エージェントは、インストールされたJREにデプロイメント・ルール・セットをダウンロードして適用します。これにより、WindowsおよびmacOSオペレーティング・システム上のインストールされたJREでJava使用状況トラッカが自動的に有効になります。

このトピックには、Advanced Management Consoleエージェント、エージェントのバンドル、エージェントのインストールおよびエージェントの配布について説明する、次の各項が含まれています。

Advanced Management Console エージェントについて

Advanced Management Console エージェントは、バックグラウンド・サービスです。

Advanced Management Console エージェントは、次のタスクを実行します。

  • インストールされたすべてのJREをデスクトップで特定し、結果のリストをAdvanced Management Consoleサーバーに報告します。

  • Java使用状況トラッカが使用可能なJREごとに、Java使用状況トラッカを有効化します。

  • Advanced Management Consoleサーバーからデプロイメント・ルール・セットをダウンロードして、各JREにインストールします。

Advanced Management Console エージェントはLinuxデスクトップではサポートされていないため、これらのデスクトップでは、さらにJava使用状況トラッカの手動構成が必要となります。Java使用状況トラッカを含むJREバージョンについては、「Advanced Management Consoleコンポーネントのソフトウェアの前提条件とシステム要件」を参照してください。

Advanced Management Consoleサーバーおよびそのすべてのコンポーネントでは、様々なプロトコルを使用して通信します。

Advanced Management Console エージェントのバンドル

Advanced Management Consoleエージェントのバンドルは、ダウンロード元のAdvanced Management Consoleサーバーに固有です。このエージェント・バンドルは、別のAdvanced Management Consoleサーバーでは機能しません。

Advanced Management Console エージェントは、.zipファイルでバンドルされています。バンドル・ファイルは、アプリケーション・サーバーのURLおよびアプリケーション・サーバーの証明書チェーンで構成されます。エージェントのバンドルは、Advanced Management Consoleユーザー・インタフェース(UI)を使用してAdvanced Management Consoleサーバーからダウンロードできます。バンドルにより、 Advanced Management Console サーバーによる管理が必要なデスクトップにエージェントがインストールされます。

Advanced Management Console エージェントのインストール

Advanced Management Console エージェントのインストールには、管理者権限が必要であり、システム管理者が実行する必要があります。

エージェント・プロキシとエージェント間隔の構成

エージェント・プロキシ・サーバーはバンドルに含まれています。バンドルがすでにダウンロードされ、その後でプロキシが変更された場合には、バンドルにはそのプロキシ設定が含まれません。

エージェント・プロキシとエージェント間隔を構成するには、次のようにします。
  1. ブラウザにhttps://server:port/amcwebuiと入力し、管理者資格証明を使用してAdvanced Management Console UIにログインし、Advanced Management Consoleを初期化します。「Advanced Management Consoleの初期化」を参照してください。
  2. エージェント・プロキシ・サーバーのホストとポートを構成します。

    ノート:

    ステップ2はエージェント・バンドルをダウンロードする前に完了する必要があります。プロキシ・サーバーがAMCサーバーにアクセスするために必要な場合、この情報がないとエージェントは登録するサーバーにアクセスできません。

    1. Advanced Management Console UIで、「構成」タブをクリックします。
    2. 「エージェントのダウンロード」をクリックします。
    3. 「編集」をクリックして、「AMCエージェント・プロキシ設定の構成」ダイアログを表示します。
    4. エージェントがAdvanced Management Console サーバーに接続するための次の詳細を入力します。
      • エージェント・プロキシ・ホスト名: プロキシ・サーバーのホスト名を指定します。

      • エージェント・プロキシ・ポート: プロキシ・サーバーのポート番号を指定します。

    5. 「保存」をクリックします。
  3. エージェント間隔を構成します。

    ノート:

    エージェント間隔を大きくすると、システム負荷が減少します。エージェント間隔を大きくすると、エージェントのAdvanced Management Console サーバーとの通信が減少するため、システム負荷が減少します。
    1. 「構成」タブをクリックします。
    2. 「エージェント設定」をクリックします。
    3. 「編集」をクリックして、フィールドを編集できるようにします。
    4. 次のいずれかの値を編集します。すべての値を編集することも、必要な1つの値のみを編集することもできます。
      JUT処理間隔
      エージェントがJava Usage Trackerレコードをサーバーにレポートする間隔
      コマンド確認間隔
      サーバーにエージェントのコマンドがあるかどうかを確認する間隔
      標準JREスキャン間隔
      標準の場所(Windowsの場合はC:\Program Files\Javaなど)でJava Runtime Environment (JRE)をスキャンし、サーバーにレポートする間隔
      アプリケーションJREスキャン間隔
      アプリケーションの場所(Windowsの場合はC:\Program Filesなど)でJREをスキャンし、サーバーにレポートする間隔
      LocalStorage JREスキャン間隔
      ローカル・ストレージ・システム全体(特定のディレクトリをターゲット設定していない)でJREをスキャンし、サーバーにレポートする間隔
      エージェント自動更新
      エージェント自動更新を有効または無効にします
      エージェント・ログ・ファイル最大サイズ(Kb)
      エージェント・ログ・ファイルの最大サイズ(Kb)
      エージェント・ログ・ファイルの数
      エージェント・ログ・ローテーション中のエージェント・ログ・ファイルの最大数
      間隔のランダム化
      間隔のランダム化を有効または無効にします
    5. 「保存」をクリックします。

WindowsでのAdvanced Management Console エージェントのインストール

Advanced Management Consoleエージェントをデスクトップにインストールする前に、Advanced Management Consoleサーバーが実行されており、デスクトップによってアクセスできることを確認してください。

Windows上にエージェントをインストールするには、次のようにします。

  1. エージェント・プロキシとエージェント間隔を構成します。「エージェント・プロキシとエージェント間隔の構成」を参照してください。
    エージェント・プロキシ・サーバーはバンドルに含まれています。プロキシ・サーバー設定を変更した場合は、エージェント・バンドルを再びダウンロードし、更新されたバンドルを配布する必要があります。
  2. Advanced Management Console UIで、「構成」タブをクリックして「エージェントのダウンロード」を選択します。

    ノート:

    「エージェントのダウンロード」を選択すると、場合によってはMD5値の計算が完了するまで待機する必要があります。バンドルがまだ生成されていない場合は、構築されるまでしばらくかかります。表示されたバンドルはダウンロードできます。

  3. 「agent-bundle-win32.zip」リンクをクリックしてバンドルを保存します。

    ノート:

    エージェント・バンドルをダウンロードする場合、Advanced Management Console は、アプリケーション・サーバーのURLやアプリケーション・サーバーの証明書チェーンなどのパラメータをバンドルに挿入します。これにより、エージェント・バンドルは、常に特定インスタンスのAdvanced Management Console サーバーに制限されます。URLまたは証明書を変更する場合は、https://server:port/amcwebuiからエージェントのバンドルをダウンロードする必要があります。

  4. Windowsのファイル・エクスプローラを開き、.zipファイルを選択して、右クリックで「すべて展開」を選択します。

    Cygwinユーティリティを使用して、エージェントのバンドルを展開しないでください。Cygwin抽出ユーティリティにより、不適切なファイル・パーミッションが付与されるため、エージェントは起動できません。

  5. AMC_AgentディレクトリをC:\Program Files (x86)\Oracle\Java AMC\など(またはC:\AMC_Agentなどの任意のディレクトリ)に移動します。次のステップでは、C:\AMC_Agentは、Advanced Management Consoleエージェントがインストールされる%AMC_DIR%を表します。権限があるユーザーのみがフォルダの内容にアクセスできることを確認します。
  6. Advanced Management Console 2.2以降では、これはオプションのステップです。%AMC_DIR%\conf\AMCUser.properties.template%AMC_DIR%\conf\AMCUser.propertiesにコピーし、3つの情報値をユーザーの実際の資格証明で構成します。
  7. Windowsのコマンド・プロンプトを管理者権限で開きます。%AMC_DIR%\bin\AMCAgent.exe -installを実行します。

    エージェントは、指定したユーザー資格証明でAdvanced Management Console サーバーに登録されます。

    ノート:

    Advanced Management Console サーバーが実行していることと、デスクトップがサーバーに接続できることを確認します。Advanced Management Console 2.4以降では、サーバーが停止しているかサーバーにアクセスできない場合、エージェント・サービスは最初に失敗してから1時間ごとにサーバーへの登録を試行します。次回エージェント・サービスを起動すると、サーバーへの接続を再試行します。

  8. 「コントロール パネル」「管理ツール」を選択して、「サービス」を選択します。エージェント・サービスが起動して実行していることを確認します。
  9. エージェント・サービスが開始されない場合は、Windowsの「イベント ビューアー」でいくつかのログ・メッセージを確認することもできます。「コントロール パネル」「管理ツール」「イベント ビューアー」の順に選択してログを表示します。
  10. Advanced Management Console Web UIに再度ログインします。「デスクトップ」ページに移動して、デスクトップが(デスクトップ所有者の登録済電子メールを使用して) Advanced Management Console サーバーに登録されていることを確認します。Advanced Management Console UIには、デスクトップ所有者が所有者として表示されています。

ノート:

Advanced Management Console は、32ビットおよび64ビットのWindowsオペレーティング・システムでのみエージェントをサポートします。agent-bundle-win32.zipバンドルは、32ビットおよび64ビットのWindowsオペレーティング・システムに対して機能します。

LinuxでのAdvanced Management Consoleエージェントのインストール

Linuxオペレーティング・システムでAdvanced Management Consoleエージェントをインストールおよびアンインストールするには、bin/AMCAgent.shスクリプト・ファイルを使用できます。Advanced Management Consoleエージェントは、Linux端末から起動、停止、または再起動できるネイティブ・サービスです。

Linuxオペレーティング・システムにAdvanced Management Consoleエージェントをインストールするには:
  1. エージェント・プロキシとエージェント間隔を構成します。「エージェント・プロキシとエージェント間隔の構成」を参照してください。
    エージェント・プロキシ・サーバーはバンドルに含まれています。プロキシ・サーバー設定を変更した場合は、エージェント・バンドルを再びダウンロードし、更新されたバンドルを配布する必要があります。
  2. Advanced Management Console UIで、「構成」タブをクリックして「エージェントのダウンロード」を選択します。
  3. agent-bundle-linux64.zipリンクをクリックし、バンドルを目的の場所に保存します。
  4. Linux端末を起動します。zipファイルをダウンロードしたフォルダに移動します。zipを解凍します。次のステップで、${AMC_DIR}はJava Advance Management Agentファイルの抽出先のAMC_Agentディレクトリを表します。
  5. Advanced Management Console 2.2以降では、これはオプションのステップです。${AMC_DIR}/conf/AMCUser.properties.templateという名前を${AMC_DIR}/conf/AMCUser.propertiesに変更し、3つの情報値をユーザーの実際の資格証明で構成します。
  6. 次のコマンドを使用して、端末からAMCAgent.shスクリプトを実行します:
    sudo bash ${AMC_DIR}/bin/AMCAgent.sh -install 
  7. Advanced Management Console Web UIに再度ログインします。「デスクトップ」ページに移動して、デスクトップがAdvanced Management Consoleサーバーに登録されていることを確認します。ユーザーの資格証明がステップ5で構成されている場合、デスクトップ所有者はAdvanced Management Console UIで所有者として表示されます。
インストールの一環として、エージェント・バイナリが/usr/local/Oracle/Java_AMCディレクトリにコピーされ、デーモンが起動されます。また、systemdまたはupstartフレームワークの登録ファイルを/etc/systemd/system/または/etc/init/ディレクトリにそれぞれ配置することにより、ネイティブ・サービスも登録されます。

macOSでのAdvanced Management Console エージェントのインストール

macOSオペレーティング・システム上でAdvanced Management Console をインストールおよびアンインストールするには、bin/AMCAgent.shスクリプト・ファイルを使用できます。Advanced Management Console は起動されたデーモンであり、launchctlコマンドを使用して起動、停止または再起動できます。

macOSオペレーティング・システムにAdvanced Management Console をインストールするには、次のようにします。
  1. エージェント・プロキシとエージェント間隔を構成します。「エージェント・プロキシとエージェント間隔の構成」を参照してください。
    エージェント・プロキシ・サーバーはバンドルに含まれています。プロキシ・サーバー設定を変更した場合は、エージェント・バンドルを再びダウンロードし、更新されたバンドルを配布する必要があります。
  2. Advanced Management Console UIで、「構成」タブをクリックして「エージェントのダウンロード」を選択します。

    ノート:

    「エージェントのダウンロード」を選択すると、場合によってはMD5値の計算が完了するまで待機する必要があります。バンドルがまだ生成されていない場合は、構築されるまでしばらくかかります。表示されたバンドルはダウンロードできます。

  3. 「agent-bundle-macosx.zip」リンクをクリックしてバンドルを保存します。
  4. Finderを開き、.zipファイルを選択し、右クリックして「開く」を選択してから、「アーカイブユーティリティ」をクリックしてファイルを解凍します。.zipファイルをダブルクリックすることで、アーカイブユーティリティを開いて現在のフォルダにファイルを解凍することもできます。
    スクリプト・ファイルには、実行するための権限はありません。chmodコマンドを使用して、実行権限を手動で設定してください。
  5. コマンド・プロンプトで次のコマンドを使用してAMCAgent.shスクリプトを実行します。
    sudo ${AMC_DIR}/bin/AMCAgent.sh -install
  6. Advanced Management Console Web UIに再度ログインします。「デスクトップ」ページに移動して、デスクトップが(デスクトップ所有者の登録済電子メールを使用して) Advanced Management Console サーバーに登録されていることを確認します。Advanced Management Console UIには、デスクトップ所有者が所有者として表示されています。
インストール後に、スクリプトによって、エージェントのバイナリが/Library/Application Support/Oracle/Java_AMCディレクトリに、.plistファイルが /Library/LaunchDaemons/にコピーされ、デーモンが起動されます。

Advanced Management Consoleエージェントのロギング

Advanced Management Console エージェントは、Javaロガーを利用して、エージェントによって実行されたタスクおよび発生したエラーに関する情報をログに出力します。

Windowsでは、ログ・ファイルは%PROGRAMDATA%\Oracle\Java_AMCディレクトリにあります。 macOS環境では、ログは/Library/Application Support/Oracle/Java_AMCディレクトリにあります。 ログは、ポリシーに従ってローテーションされます。Advanced Management Console 2.7以降、ログ・ファイルの最大サイズおよびファイルの数は、AMCAgent.propertiesを使用して構成できます。デフォルトでは、ローテーションで最大サイズ64Kの3個のログ・ファイルを使用します。 つまり、最初のログ・ファイルのサイズが64Kに到達すると、ログは2番目のログ・ファイルに書き込まれるようになります。 3番目のログ・ファイルがいっぱいになると、ログはローテーションして最初のファイルに戻り、そこに出力されている既存の内容を上書きします。ロギングのパラメータを編集するために使用できる手順は、「エージェント・プロキシとエージェント間隔の構成」を参照してください。

Advanced Management Console エージェントのアンインストール

WindowsでのAdvanced Management Console エージェントのアンインストール

Windowsでは、-removeコマンドを実行して、Advanced Management Consoleエージェントをアンインストールし、Advanced Management Consoleサーバー上のすべてのJava Usage Trackerプロパティ・ファイルを削除できます。

Advanced Management Console エージェントをアンインストールするには、次のようにします。
  1. 管理者権限を使用してWindowsのコマンド・プロンプトを開きます。
  2. %AMC_DIR%\bin\AMCAgent.exe -removeを実行してエージェントをアンインストールします。
    %AMC_DIR%は、Advanced Management Console エージェントがインストールされているディレクトリです。エージェントは、アンインストールの前に、Advanced Management Console サーバー上のそれ自体を登録解除しようとします。サーバー上でエージェントが登録解除されると、デスクトップ上のすべてのJava Usage Tracker構成ファイル(usagetracker.properties)も削除されます。

    Advanced Management Console サーバーに到達できない場合は、このことにより、アンインストールが行き詰まるか失敗します。この場合は、%AMC_DIR%\bin\AMCAgent.exe -forceremoveを使用して、最初に登録解除せずに、エージェントのアンインストールを強制実行できます。

    次のシナリオではAMCAgent.exe -forceremoveコマンドを実行します。
    • %AMC_DIR%\bin\AMCAgent.exe -removeでエージェント・サービスのアンインストールに失敗した場合は、%AMC_DIR%\bin\AMCAgent.exe -forceremoveコマンドを実行してエージェントのアンインストールを強制実行します。

    • エージェントがサーバー上に正常に登録されなかった場合、AMCAgent.exe -forceremoveコマンドを実行して、エージェントをアンインストールします。このようなシナリオでは、AMCAgent.exe -removeは機能しません。

サーバー上でエージェントが登録解除されると、デスクトップ上のすべてのJava Usage Tracker構成ファイル(usagetracker.properties)も削除されます。

LinuxでのAdvanced Management Consoleエージェントのアンインストール

Linuxでは、removeコマンドを実行して、Advanced Management Consoleエージェントをアンインストールし、デスクトップからすべてのJava Usage Trackerプロパティ・ファイルを削除できます。

エージェントをアンインストールするには、Linux端末を開き、次のコマンドを実行します:
sudo bash ${AMC_DIR}/bin/AMCAgent.sh -remove

エージェントは、アンインストールの前に、Advanced Management Consoleサーバーで自身を登録解除しようとします。サーバー上でエージェントが登録解除されると、デスクトップ上のすべてのJava Usage Tracker構成ファイル(usagetracker.properties)も削除されます。

Advanced Management Consoleサーバーにアクセスできない場合は、アンインストールが停止または失敗する可能性があります。この場合は、sudo bash ${AMC_DIR}/bin/AMCAgent.sh -forceremoveコマンドを使用し、最初に登録解除せずに、エージェントを強制的にアンインストールできます。ただし、AMCAgent.exe -forceremoveusagetracker.propertiesファイルのクリーンアップを実行しません。

次のシナリオではAMCAgent.sh -forceremoveコマンドを実行する必要があります。
  • AMCAgent.sh -removeコマンドを使用してエージェント・サービスをアンインストールできなかった場合は、AMCAgent.sh -forceremoveコマンドを実行して強制的にエージェントをアンインストールします。

  • エージェントがサーバー上に正常に登録されなかった場合、AMCAgent.sh -forceremoveコマンドを実行して、エージェントをアンインストールする必要があります。AMCAgent.sh -removeコマンドはこのようなシナリオでは機能しません。

ノート:

エージェントをユーザー・インタフェースから登録解除するには、「Advanced Management Consoleユーザー・インタフェースでのデスクトップの登録解除」を参照してください。
エージェントをアンインストールすると、スクリプトはデーモンを停止し、サービス管理フレームワークに基づいて次のいずれかからサービス登録ファイルを削除します:
  • /etc/systemd/system/

  • /etc/init/

macOSでのAdvanced Management Console エージェントのアンインストール

macOSでは、-removeコマンドを実行して、Advanced Management Consoleエージェントをアンインストールし、Advanced Management Consoleサーバー上のすべてのJava Usage Trackerプロパティ・ファイルを削除できます。

エージェントをアンインストールするには、次のようにします。
  1. 次のコマンドを実行します。
    sudo ${AMC_DIR}/bin/AMCAgent.sh -remove

    エージェントは、アンインストールの前に、Advanced Management Consoleサーバー上のそれ自体を登録解除しようとします。サーバー上でエージェントが登録解除されると、デスクトップ上のすべてのJava Usage Tracker構成ファイル(usagetracker.properties)も削除されます。

    Advanced Management Consoleサーバーに到達できない場合は、このことにより、アンインストールが行き詰まるか失敗します。この場合は、${AMC_DIR}/bin/AMCAgent.sh -forceremoveコマンドを使用し、最初に登録解除せずに、エージェントを強制的にアンインストールできます。

    次のシナリオではAMCAgent.sh -forceremoveコマンドを実行する必要があります。
    • ${AMC_DIR}/bin/AMCAgent.sh -removeコマンドを使用してエージェント・サービスをアンインストールできなかった場合は、${AMC_DIR}/bin/AMCAgent.sh -forceremoveコマンドを実行して強制的にエージェントをアンインストールします。

    • エージェントがサーバー上に正常に登録されなかった場合、AMCAgent.sh -forceremoveコマンドを実行して、エージェントをアンインストールする必要があります。AMCAgent.sh -forceremoveはこのようなシナリオでは役立ちません。

エージェントがアンインストールされると、サーバー上でエージェントが登録解除され、デスクトップ上のすべてのJava Usage Tracker構成ファイルusagetracker.propertiesが削除されます。スクリプトによってデーモンが停止され、次のディレクトリから.plistファイルが削除されます。
  • /Library/LaunchDaemons/

  • /Library/Application Support/Oracle/Java_AMC

Advanced Management Console ユーザー・インタフェースでのデスクトップの登録解除

-removeを実行してWindowsおよびmacOSでAdvanced Management Consoleエージェントをアンインストールした後、Advanced Management Consoleを使用して、Advanced Management Consoleサーバーに接続できないデスクトップを削除できます。

Advanced Management Console サーバーにアクセスできないデスクトップを削除するには、次のようにします。
  1. Advanced Management Console UIで、「デスクトップ」タブをクリックします。
  2. 「表示」ドロップダウン・リストから「デスクトップ」が選択されていることを確認します。
    「その他のアクション」 ボタンは、「デスクトップ」 表示オプションを設定した場合のみ使用可能です。
  3. 「表」アイコンが選択されていることを確認します。
  4. (オプション)登録解除するデスクトップのみを示すように、フィルタ条件を設定します。
    1. 「条件の追加」をクリックします。
    2. フィルタを選択し、選択した各フィルタに値を設定します。
  5. 「デスクトップ」表で、デスクトップの横にあるチェックボックスを選択して、登録解除するデスクトップを選択します。
  6. 「その他のアクション」をクリックしてから「デスクトップの登録解除」を選択して、「デスクトップの登録解除」ダイアログを表示します。
  7. 次のいずれかのオプションを選択して、ターゲット・デスクトップを選択します。
    • 選択済のデスクトップ: 選択済のデスクトップの数を示します。
    • すべてのフィルタ処理済デスクトップ: 含まれるフィルタ処理済デスクトップの数を示します。
  8. 「確認」をクリックします。
    選択したデスクトップまたはフィルタリングされたすべてのデスクトップが登録解除されます。
選択したデスクトップが、サーバー上で登録解除されます。

Advanced Management Console の配布

Advanced Management Consoleエージェントのバンドルの配布は、Advanced Management Consoleでは行われません。

Advanced Management Consoleエージェントのバンドルは、Advanced Management Console Web UIでダウンロードできます。Microsoft SCCMなどのSoftware Management Systemを使用して、企業内のデスクトップにエージェントのバンドルを配布できます。

使用するSoftware Management Systemでは、Advanced Management Console の安全なエージェントの配布に対応するために、カスタマイズされたオプションを提供する必要があります。このシステムは、管理者権限を使用して次の操作を行う必要があります。

  • 「WindowsでのAdvanced Management Consoleエージェントのインストール」の説明に従った、エージェント・バンドルの展開。展開が正しく行われない場合、不適切なファイル・パーミッションが生じるため、エージェントは起動できません。

  • デスクトップ所有者のユーザー資格証明に基づくバンドルの構成。

  • インストール・コマンドを使用したエージェントのインストール。

エージェントが配布された後に、エージェントを受け取った各デスクトップは、デスクトップに構成されたユーザー資格証明を使用してAdvanced Management Console サーバーに登録されます。また、エージェントは自動的にJava使用状況トラッカを構成し、Java使用状況トラッカ・レコードをデスクトップに構成されたユーザー資格証明に関連付けます。その後、エージェントはオペレーティング・システム・ファミリ、バージョン、インストールされたJREなどのデータをAdvanced Management Console サーバーに定期的に報告します。

Advanced Management Consoleサーバーに登録されたデスクトップを表示するには、Advanced Management Console Web UIにログインして、「デスクトップ」タブをクリックします。