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

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

注:

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

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

ダウンロードポータルから zip ファイルを必要なホストマシンの任意の場所にダウンロードできます。
```
unzip -d appdsmartagent appdsmartagent-<version>.zip
```
テキストエディタで config.ini ファイルを開き、プレースホルダの値を、接続する必要がある実際のアクセスキーとサービス URL に置き換えます。config.ini
この情報は、スマートエージェントが目的のサービスと通信するために必要です。各設定オプションの説明については、「スマートエージェントの設定」を参照してください。スマートエージェントの設定
```
$ cd appdsmartagent
$ vim config.ini
```
smartagentctl を使用してスマートエージェントをインストールし、起動します。smartagentctl
smartagentctlsmartagentctl が含まれるディレクトリに移動し、必要なパラメータを使用して実行します。「変数」と「インストールパラメータ」を参照してください。
```
sudo ./smartagentctl start --enable-auto-attach --service --user <user> --group <group>
```
注:
- スマートエージェントをサービスとして実行するには、Sudo が必要です。
- LD_PRELOAD に問題がある場合は、新しいセッションからコマンドを実行します。
- --enable-auto-attach パラメータの有無にかかわらず、このコマンドは APPD_SMART_AGENT 環境変数を設定します。これは、コントローラがエージェント管理 UI のスマートエージェントと関連付けられるようにするために必要です。サポート対象の AppServer エージェントは変数を解析し、スマートエージェント ID をコントローラに送信します。
（オプション）単一または複数の Linux リモートホストにスマートエージェントをインストールする必要がある場合は、次の手順を実行します。

注: SSH 接続では、プロキシ設定はサポートされません。
1. リモートディレクトリに対する書き込み権限を持つユーザーを作成します。ユーザーがすでに存在する場合は、そのユーザーがリモートディレクトリを所有していることを確認します。
  たとえば、ユーザー名が ubuntu で、リモートマシンの /opt/appdynamics にスマートエージェントをインストールする必要がある場合は、リモートマシンで /opt/appdynamics が作成され、ubuntu ユーザーがそれを所有していることを確認します。次のコマンドを実行して、所有権を追加します。
```
sudo chown ubuntu:ubuntu /opt/appdynamics/smartagent/
```
  既存ののユーザーを使用する場合は、そのユーザーが書き込み権限を持っていることを確認します。以下を実行して、アクセス許可を確認します。
  ls -ld /opt/appdynamics/smartagent to check the user permissions.
2. 現在のスマートエージェントディレクトリに hosts.yaml ファイルを作成します。
  以下にサンプルの hosts.yaml ファイルを示します。
```
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. 次のコマンドを実行して、ホストマシンにスマートエージェントをインストールします。
```
sudo ./smartagentctl start --enable-auto-attach --service --remote
```

`ls -ld /opt/appdynamics/smartagent to check the user permissions.`

複数のホストにスマートエージェントをインストールするには、「複数ノードでのスマートエージェントのインストールの自動化」を参照してください。

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

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


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

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

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


パラメータ	説明
--enable-auto-attach	自動接続機能を有効にします。Java および NodeJS エージェントの自動付加を参照してください。
--user	スマートエージェントプロセスのユーザー名を指定します。デフォルト値は現在のユーザーです。値は文字列形式にする必要があります。
--group	スマートエージェントプロセスのグループを指定します。デフォルトは、現在のグループです。値は文字列形式にする必要があります。
-h, --help	スマートエージェントの起動に関するヘルプを表示します。
--service	スマートエージェントをサービスとしてインストールします。
--tomcat-env-config	Apache Tomcat 環境ファイルパス。値は文字列形式にする必要があります。
--remote	リモートホストでスマートエージェントのインストールを開始する場合に指定します。値は boolean 形式で指定します。デフォルト値は `true` です。