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

各マシンにログインすることで、スマートエージェントをホストマシンにインストールできます。ダウンロードポータルからそれぞれのファイルを必要なホストマシンにダウンロードできます。

注:

  • スマートエージェントは、インストールを簡素化する smartagentctl バイナリにバンドルされています。

  • エージェント管理には、複数のホストへのスマートエージェントのインストールを自動化するために使用できる、スマートエージェント CLI があります。 smartagentctl バイナリは、複数の Linux ホストにスマートエージェントをインストールするためにも使用できます。Linux ホストでは、ライブラリの依存関係がないため smartagentctl を使用します。

次のコマンドを実行して、ホストマシンにスマートエージェントをインストールします。

  1. ダウンロードポータルから zip ファイルを必要なホストマシンの任意の場所にダウンロードできます。
    CODE 
    unzip -d appdsmartagent appdsmartagent-<version>.zip
  2. テキストエディタで config.ini ファイルを開き、プレースホルダの値を、接続する必要がある実際のアクセスキーとサービス URL に置き換えます。
    この情報は、スマートエージェントが目的のサービスと通信するために必要です。各設定オプションの説明については、「スマートエージェントの設定」を参照してください。スマートエージェントの設定
    CODE 
    $ cd appdsmartagent
$ vim config.ini
  3. smartagentctl を使用してスマートエージェントをインストールし、起動します。
    smartagentctl が含まれるディレクトリに移動し、必要な変数とパラメータを使用して実行します。「変数」と「インストールパラメータ」を参照してください。
    CODE 
    sudo ./smartagentctl start --enable-auto-attach --service --user <user> --group <group>
    注:

    • スマートエージェントをサービスとして実行するには、Sudo が必要です。

    • LD_PRELOAD に問題がある場合は、新しいセッションから コマンドを実行します。

    • このコマンドは、--enable-auto-attach パラメータの指定に関係なく、APPD_SMART_AGENT 環境変数を設定します。これは、コントローラがエージェント管理 UI のスマートエージェントと関連付けられるようにするために必要です。サポート対象の AppServer エージェントは変数を解析し、スマートエージェント ID をコントローラに送信します。
  4. （オプション）単一または複数の Linux リモートホストにスマートエージェントをインストールする必要がある場合は、次の手順を実行します。
    注: SSH 接続では、プロキシ設定はサポートされません。
    1. リモートディレクトリに対する書き込み権限を持つユーザーを作成します。ユーザーがすでに存在する場合は、そのユーザーがリモートディレクトリを所有していることを確認します。
      たとえば、ユーザー名が ubuntu で、リモートマシンの /opt/appdynamics にスマートエージェントをインストールする必要がある場合は、リモートマシンで /opt/appdynamics が作成され、 ubuntu ユーザーがそれを所有していることを確認します。次のコマンドを実行して、所有権を追加します。
      CODE 
      sudo chown ubuntu:ubuntu /opt/appdynamics/smartagent/
      既存の のユーザーを使用する場合は、そのユーザーが書き込み権限を持っていることを確認します。以下を実行して、権限を確認します。
      CODE 
      ls -ld /opt/appdynamics/smartagent  to check the user permissions.
    2. 現在のスマート エージェントディレクトリに hosts.yaml ファイルを作成します。

      次に、 hosts.yaml ファイルの例を示します。

      CODE 
      batch_size: 5  # This ensures that the installation is done in batches instead of installing the agent on all the hosts simultaneously.
hosts:
  - name: "host1"  # the name for the remote host 
    host: "localhost"  # the hostname of the primary host
    port: 22       # the default SSH port for the direct communication of primary and remote hosts
    username: "ubuntu"
    private_key_path: "<path-to-private-key>"
    temp_folder_path: "/tmp"  # the temporary folder path of the primary host
    remote_dir: "/opt/appdynamics/smartagent" # path to the remote host directory
  - name: "host2"
    host: "localhost"
    port: 22    #default SSH port
    username: "ec2-user"
    private_key_path: "/Users/akhi85/.ssh/id_rsa"
    temp_folder_path: "/tmp"
    remote_dir: "/opt/appdynamics/smartagent"
---

      ここで、ユーザー名はリモートディレクトリでの書き込み権限を持つ任意のユーザー名にできます。

      たとえば、ユーザー名が ubuntu で、リモートマシンの /opt/appdynamics/smartagent にスマートエージェントをインストールする必要がある場合は、 /opt/appdynamics が作成され、ubuntu ユーザーがそれを所有していることを確認します。sudo chown ubuntu:ubuntu /opt/appdynamics/smartagent/ を使用して、所有権を追加します。

      ls -ld /opt/appdynamics/smartagent を使用して、ユーザー権限を確認できます。

    3. 次のコマンドを実行して、ホストマシンにスマートエージェントをインストールします。
      CODE 
      sudo ./smartagentctl start --enable-auto-attach --service --remote
複数のホストにスマートエージェントをインストールするには、「複数ノードでのスマートエージェントのインストールの自動化」を参照してください。

スマートエージェントの変数

変数の詳細を次の表に示します。

変数名 説明 必須 デフォルト値
user スマート エージェント プロセスを実行するユーザー いいえ
  • root
  • 管理者
グループ スマート エージェント プロセスを実行するグループ いいえ root

スマートエージェントのインストールパラメータ

次の表に、使用できるオプションのパラメータを示します。

パラメータ 説明
--enable-auto-attach 自動接続機能を有効にします。Java および NodeJS エージェントの自動付加 を参照してください。
--user スマート エージェント プロセスのユーザー名を指定します。デフォルト値は現在のユーザーです。値は文字列形式にする必要があります。
--group

スマート エージェント プロセスのグループを指定します。デフォルトは、現在のグループです。

値は文字列形式にする必要があります。
-h, --help スマートエージェントの起動に関するヘルプを表示します。
--service スマートエージェントをサービスとしてインストールします。
--tomcat-env-config

Apache Tomcat 環境ファイルパス。

値は文字列形式にする必要があります。
--remote リモートホストでスマートエージェントのインストールを開始する場合に指定します。値は boolean 形式で指定します。デフォルト値は true です。