このページでは、マシンエージェントをインストールするための要件、権限、および手順について説明します。AppDynamics エージェントインストーラを使用して、マシンエージェントの導入を合理化できます。エージェントインストーラは、エージェントのインストールプロセスを簡素化します。

Kubernetes にマシンエージェントをインストールする場合は、「Kubernetes CLI を使用したクラスタエージェントのインストール」を参照してください。


実稼働環境に展開する前に、ステージング環境またはテスト環境で展開を徹底的にテストしてください。

JRE の要件

  • JRE 1.8 が必要です。
  • バンドルされた JRE があるマシンエージェントのインストールには、以下が含まれます。

    • AARCH64、Linux、Solaris(Solaris_sparcv9)、Solaris(Solaris_X64)、Windows:Zulu 11.62 として JRE 11(JDK 11.0.18)
    • AIX:JRE なしのマシンエージェント(AIX に固有の JRE 1.8 を使用)
  • バンドルされた JRE がないマシンエージェントのインストールでは、以下が使用されます。

    • Linux:JRE 11
    • その他のオペレーティングシステム:JRE 8
  • マシンエージェントは、専用の JVM 内で起動します。
  • ご使用の環境にすでにインストールされている既存の JRE を使用できます。

権限

  • 権限の問題を回避するには、マシン エージェント ファイルを所有している同じユーザとして、またはホストマシンの管理者としてエージェントをインストールします。 

  • <machine-agent-home> インストールディレクトリ内のすべてのファイルを、マシンエージェントが読み取ることができるようにする必要があります。 
  • マシンエージェントを実行するユーザには、ログ出力ディレクトリとエージェント インストール ディレクトリの /conf ディレクトリに対する書き込み権限が必要です。
  • JVM クラッシュガードを有効にする場合は、JVM クラッシュガード」を参照して必要な権限を確認してください。
  • マシンエージェントを実行する非ルートユーザを作成するには、「マシンエージェントを実行するために必要な権限」を参照してください。
  • ファイルとサブフォルダの Windows 権限は、デフォルトでは親フォルダ(<machine_agent_home>)から継承されます。AppDynamics では、マシンエージェントを開始、停止、および設定する権限を持つユーザに対する権限を制限することをお勧めします。
    • <machine-agent-home> の下にあるすべてのファイルとサブフォルダに対する読み取り権限と書き込み権限。
    • 実行方法が次の場合:
      • ターミナルアプリケーションとして実行している場合、ファイル <machine-agent-home>\bin\machine-agent.vbs の読み取り、書き込み、および実行権限を制限します。
      • サービスとして実行している場合、マシンエージェントサービスの開始、停止、および再起動の権限を制限します。サービスをインストールするには、管理者権限のみ必要です。マシンエージェントは、ローカルシステムに対する広範な権限を持つローカルシステムアカウントで実行されます。ただし、WMI アクセスが取り消されている場合は、マシンエージェントを管理者として実行する必要があります。通常、ユーザには WMI アクセス権があります。「User Account Control and WMI」を参照してください。
  • Windows マシンエージェントの場合は Windows スクリプトホストを有効にします。

インストールディレクトリとパス名の要件

次の表に、<machine-agent-home> ディレクトリ名またはパス内の任意のディレクトリに対してサポートされていない文字を示します。

どの OS でもサポートされていない
Linux でサポートされていない
Windows でサポートされていない
空白文字% #% # \ / : * ? " < > |
ディレクトリ名の末尾に感嘆符
ASCII EOL、CR などの制御文字

設定

controller-info.xml ファイルには、エージェントからコントローラへの通信を指定するために使用されるプロパティが含まれます。コントローラのホスト、ポート、およびアカウントアクセスキーの各プロパティを指定するには、「マシンエージェントの設定の計画」を参照してください。インストール要件に応じて、追加のプロパティを設定する必要が生じる場合があります。

新しいマシンエージェントのインストール

次の手順は、新規インストールの手順です。4.3 以前のバージョンのマシンエージェントをアップグレードするには、「マシンエージェントのアップグレード」を参照してください。

  1. マシンエージェントの設定の計画] をクリックします。 
  2. AppDynamics ダウンロードから、ご使用の OS 環境用のマシン エージェント インストール パッケージを、モニタするマシンにダウンロードします。 

    ご使用の OS 用のダウンロードバンドルがない場合は、JRE なしのマシンエージェントの zip ファイルを使用し、個別にダウンロードした JRE を使用してそのマシンエージェントを実行します。マシンにすでにインストールされている JRE が JRE 1.8 よりも前のバージョンの場合は、個別の JRE をダウンロードする必要があります。

  3. マシンエージェントのインストールの確認)。

  4. <machine_agent_home>/bin/machine-agent を実行してマシンエージェントを起動します。java または system プロパティがある場合は、コマンドの末尾に追加できます。マシンの使用状況を確認するには、machine-agent -h と入力します。