Linux Install Using ZIP with Bundled JRE

This page describes how to install the Machine Agent using the Linux ZIP archive that includes JRE 17.

It is easier to download and use the RPM package if your Linux distribution supports theRPM Package Manager.

エージェントのインストール

  1. インストールする前に、「マシンエージェントのインストール」を参照してください。
    注: <machine-agent-home> インストールディレクトリの読み取り/書き込み権限が必要です。
  2. エージェントの zip バンドルをダウンロードして解凍します。コマンドラインから、次のように入力します。ここで、<zip-bundle.zip> は環境の zip アーカイブの名前、
    unzip <zip-bundle.zip> -d <machine_agent_home>
    <agent_home> はエージェントのインストール先となるディレクトリの名前です。
  3. 設定の詳細を収集し、<machine_agent_home >/conf/controller-info.xml ファイルを編集するか、JVM 起動スクリプトファイルにシステムプロパティを追加してエージェントを設定します。「JRE がバンドルされている ZIP を使用した Linux へのインストール」を参照してください。
    1. （必須）コントローラのホスト名、ポート番号、およびアカウントアクセスキーを設定します。
    2. （オプション）メモリ要件を確認します。「マシンエージェントの要件とサポートされる環境」を参照してください。
    3. （オプション）SSL を使用するようにエージェントを設定します。「マシンエージェントの SSL の有効化」を参照してください。
    4. （オプション）プロキシ設定を使用するようにエージェントを設定します。「マシンエージェントの設定プロパティ」を参照してください。
    5. （マルチテナントモードまたは SaaS インストールの場合に必須）エージェントアカウント情報を設定します。 「エージェントアカウント情報の設定」を参照してください。
    6. （オプション）アプリケーション名と階層名を指定する必要があるかどうかを決定します。「マシンエージェントとアプリケーション」を参照してください。すべてのアプリケーション エージェントと同じサーバーにマシンエージェントをインストールする場合は、アプリケーション名と階層名を指定しないでください。
  4. マシンエージェントをサービスとして追加する場合は、「エージェントをサービスとして追加する」を参照してください。
  5. 次のように入力して、マシンエージェントを起動します。マシンエージェントの使用状況を確認するには、次のように入力します。
    machine-agent -h
    ./bin/machine-agent
    Usage: machine-agent [-dh] [-j JAVA_HOME] [-p pidfile] [-D prop] [-X prop]
Start the machine agent.
-d            daemonize (run in background)
-p pidfile    write PID to <pidfile>
-h
--help        print command line options
-D prop       set JAVA system property
-X prop       set non-standard JAVA system property
  6. （オプション）インストールを確認します。「マシンエージェントのインストールの確認」を参照してください。

SysV を使用してサービスとしてエージェントを追加する

  1. マシンエージェントをインストールします。
  2. /etc/sysconfig へのリンクを作成します。
    ln -s <machine-agent-home>/etc/sysconfig/appdynamics-machine-agent /etc/sysconfig/appdynamics-machine-agent
  3. マシンエージェントを /etc/init.d にコピーします。
    cp <machine-agent-home>/etc/init.d/appdynamics-machine-agent /etc/init.d/appdynamics-machine-agent
  4. /etc/sysconfig/appdynamics-machine-agent の環境変数を編集します。
    • MACHINE_AGENT_HOME：マシンエージェントファイルが配置されている場所を指定します。
    • JAVA_HOME：エージェントが使用する JRE を指定します。JRE にバンドルされているマシンエージェントを使用することを推奨します。ただし、既存の JRE を使用することはできます。（1.8 以降）
    • MACHINE_AGENT_USER：マシンエージェントを起動するために使用するシステムユーザーを指定します。デフォルトでは、これは root です。マシンエージェントを実行するための非ルートユーザーを作成することを推奨します。新しいユーザには、controller-info.xml の読み取りアクセス権とログファイルへの書き込みアクセス権が必要です。「マシンエージェントを実行するために必要な権限」を参照してください。
  5. エージェントをサービスとして追加します。たとえば、次のように入力します。Ubuntu の場合は、update-rc.d sysv-rc-conf を使用できます。
    chkconfig --add appdynamics-machine-agent
  6. エージェントサービスを開始します。サービス appdynamics-machine-agent が開始されます。
  7. エージェントがコントローラにレポートしていることを確認します。「JRE がバンドルされている ZIP を使用した Linux へのインストール」を参照してください。

systemd を使用してサービスとしてエージェントを追加する

  1. マシンエージェントをインストールします。
  2. 必要に応じて、サービスファイルで環境変数とオプションを編集します。<
    1. MACHINE_AGENT_HOME：マシンエージェントファイルが配置されている場所を指定します。
    2. JAVA_HOME：エージェントが使用する JRE を指定します。JRE にバンドルされているマシンエージェントを使用することを推奨します。ただし、既存の JRE を使用することはできます。- JRE 1.7 以降（4.3 の場合）- JRE 1.8 以降（4.4 以降の場合）
    3. User：サービスファイルのこのオプションは、マシンエージェントを起動するために使用するシステムユーザーを指定します。デフォルトでは、これは root です。マシンエージェントを実行するための非ルートユーザーを作成することを推奨します。新しいユーザには、controller-info.xml の読み取りアクセス権と、ログファイルへの書き込みアクセス権が必要です。「マシンエージェントを実行する非ルートユーザーの権限」を参照してください。systemd サービスファイルには "MACHINE_AGENT_USER" 変数が含まれていません。
  3. ファイルをコピーします。 
    cp <machine-agent-home>/etc/systemd/system/appdynamics-machine-agent.service \
/etc/systemd/system/appdynamics-machine-agent.service
  4. システムの起動時にマシンエージェントを起動できるようにします。 
    systemctl enable appdynamics-machine-agent
  5. エージェントサービスを開始します。 
    systemctl start appdynamics-machine-agent
  6. サービスのステータスを確認します。 
    systemctl status appdynamics-machine-agent
  7. エージェントがコントローラにレポートしていることを確認します。「JRE がバンドルされている ZIP を使用した Linux へのインストール」を参照してください。