このページでは、JRE 1.8 を含む Linux ZIP アーカイブを使用してマシンエージェントをインストールする方法について説明します。

Linux ディストリビューションが RPM パッケージマネージャをサポートしている場合、RPM パッケージをダウンロードして使用する方が簡単です。

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

  1. インストールする前に、「マシンエージェントのインストール」を参照してください。

    <machine-agent-home> インストールディレクトリの読み取り/書き込み権限が必要です。

  2. エージェントの zip バンドルをダウンロードして解凍します。コマンドラインから、次のように入力します。 

    unzip <zip-bundle.zip> -d <machine_agent_home>
    CODE

    ここで <zip-bundle.zip> は、ご使用の環境の zip アーカイブの名前であり、<agent_home> は、エージェントをインストールするディレクトリの名前です。

  3. 設定の詳細を収集し、<machine_agent_home>/conf/controller-info.xml ファイルを編集するか、JVM 起動スクリプトファイルにシステムプロパティを追加することで、エージェントを設定します。「.Linux Install Using ZIP with Bundled JRE v22.1」を参照してください。

    1. （必須）コントローラのホスト名、ポート番号、およびアカウントアクセスキーを設定します。 
    2. （オプション）メモリ要件を確認します。詳細については、「マシンエージェントの要件とサポートされる環境」を参照してください。
    3. （オプション）SSL を使用するようにエージェントを設定します。詳細については、マシンエージェントの SSL の有効化を参照してください。
    4. （オプション）プロキシ設定を使用するようにエージェントを設定します。詳細については、マシンエージェントの設定プロパティを参照してください。
    5. （マルチテナントモードまたは SaaS インストールの場合に必須）エージェントアカウント情報を設定します。「マルチテナント コントローラ アカウント」を参照してください。
    6. （オプション）アプリケーション名と階層名を指定する必要があるかどうかを決定します。「マシンエージェントとアプリケーション」を参照してください。
      いずれかの APM アプリケーション エージェントと同じサーバにマシンエージェントをインストールする場合は、アプリケーション名と階層名を指定しないでください。 
  4. マシンエージェントをサービスとして追加する場合は、「エージェントをサービスとして追加する」を参照してください。

  5. <machine_agent_home>/bin/machine-agent と入力してマシンエージェントを起動します。たとえば、<machine_agent_home> ディレクトリからの場合、次のようにします。

    ./bin/machine-agent

    マシンエージェントの使用状況を確認するには、次のように入力します。machine-agent -h

    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
    CODE

  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 を指定します。AppDynamics では、JRE にバンドルされているマシンエージェントを使用することを推奨しています。ただし、既存の JRE を使用することはできます。（1.8 以降）
    • MACHINE_AGENT_USER：マシンエージェントを起動するために使用するシステムユーザを指定します。デフォルトでは、これは root です。AppDynamics では、マシンエージェントを実行するための非ルートユーザを作成することを推奨しています。新しいユーザには、controller-info.xml の読み取りアクセス権とログファイルへの書き込みアクセス権が必要です。「マシンエージェントを実行するために必要な権限」を参照してください。

  5. エージェントをサービスとして追加します。たとえば、次のように入力します。

    chkconfig --add appdynamics-machine-agent


    Ubuntu の場合は、update-rc.d または sysv-rc-conf を使用できます。詳細については、Ubuntu のドキュメントを参照してください。

  6. エージェントサービスを開始します。service appdynamics-machine-agent start. 

  7. エージェントがコントローラにレポートしていることを確認します。「.Linux Install Using ZIP with Bundled JRE v22.1」を参照してください。

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

  1. マシンエージェントをインストールします。

  2. 必要に応じて、サービスファイルで環境変数とオプションを編集します。<machine-agent-home>/etc/systemd/system/appdynamics-machine-agent.service

    1. MACHINE_AGENT_HOME：マシン エージェント ファイルが配置されている場所を指定します。
    2. JAVA_HOME：エージェントが使用する JRE を指定します。Appdynamics では、JRE にバンドルされているマシンエージェントを使用することを推奨しています。ただし、既存の JRE を使用することはできます。
      - JRE 1.7 以降（4.3 の場合）
      - JRE 1.8 以降（4.4 以降の場合）
    3. User：サービスファイルのこのオプションは、マシンエージェントを起動するために使用するシステムユーザを指定します。デフォルトでは、これは root です。AppDynamics では、マシンエージェントを実行するための非ルートユーザを作成することを推奨しています。新しいユーザには、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. エージェントがコントローラにレポートしていることを確認します。「.Linux Install Using ZIP with Bundled JRE v22.1」を参照してください。