各マシンにログインすることで、スマートエージェントをホストマシンにインストールできます。ダウンロードポータルからそれぞれのファイルを必要なホストマシンにダウンロードできます。
Linux または Windows ホストマシンにスマートエージェントをインストールするには、次の手順を実行します。PowerShell を使用してWindowsホスト上でコマンドを実行できます。
- ダウンロードポータルから zip ファイルを必要なホストマシンの任意の場所にダウンロードできます。
unzip -d appdsmartagent appdsmartagent-<version>.zip
- テキストエディタで
config.ini ファイルを開き、プレースホルダの値を、接続する必要がある実際のアクセスキーとサービス URL に置き換えます。config.ini
この情報は、スマートエージェントが目的のサービスと通信するために必要です。各設定オプションの説明については、「スマートエージェントの設定」を参照してください。
スマートエージェントの設定
Linuxの場合：
$ cd appdsmartagent
$ vim config.ini
Windowsの場合：
$ cd appdsmartagent
$ notepad config.ini
smartagentctlを使用して、スマートエージェントをインストールおよび起動します。
smartagentctl
smartagentctl が含まれるディレクトリに移動し、必要なパラメータを使用して実行します。「
変数」と「
インストールパラメータ」を参照してください。
Linuxの場合：
sudo ./smartagentctl start --enable-auto-attach --service --user <user> --group <group>
Windowsの場合：
./smartagentctl.exe start
注: スマートエージェントは、デフォルトで Windows 上でサービスとして実行されるため、 --service パラメータは必要ありません。
Windowsの場合：
./smartagentctl.exe start
注: デフォルトでは、スマートエージェントは Windows 上でサービスとして実行されるため、コマンドに --service パラメータは必要ありません。
- （オプション）単一または複数のリモートホストにスマートエージェントをインストールする必要がある場合は、次の手順を実行します。
注: SSH 接続では、プロキシ設定はサポートされません。
- （Linux のみ）リモートディレクトリに対する書き込み権限を持つユーザーを作成します。ユーザーがすでに存在する場合は、そのユーザーがリモートディレクトリを所有していることを確認します。
たとえば、ユーザー名が
ubuntu で、リモートマシンの
/opt/appdynamics にスマートエージェントをインストールする必要がある場合は、リモートマシンで
/opt/appdynamics が作成され、
ubuntu ユーザーがそれを所有していることを確認します。次のコマンドを実行して、所有権を追加します。
sudo chown ubuntu:ubuntu /opt/appdynamics/smartagent/
既存の のユーザーを使用する場合は、そのユーザーが書き込み権限を持っていることを確認します。以下を実行して、権限を確認します。
ls -ld /opt/appdynamics/smartagent to check the user permissions.
- （Linux または Windows）現在のスマートエージェント ディレクトリに
remote.yaml ファイルを作成します。
以下は、Linux 用の remote.yaml ファイルのサンプルです。
max_concurrency: 5 # the maximum number of hosts that will be processed simultaneously.
hosts:
- host: localhost
port: 22 #default SSH port
remote_dir: /home/my-remote-user/appd/smartagent
protocol:
type: ssh
auth:
username: my-remote-user
private_key_path: /Users/my-local-user/.ssh/private_key
privileged: false # switch to true to install smartagent as a system wide service instead of process
known_hosts_path: /Users/my-local-user/.ssh/known_hosts
---
ここで、ユーザー名は、秘密キーを使用してリモート ホストへの SSH 接続を実行する権限を持つユーザーです。ユーザーとグループは、プロセスを実行するために使用される権限を指定します。
たとえば、ユーザー名が ubuntu で、リモートマシンの /opt/appdynamics/smartagent にスマートエージェントをインストールする必要がある場合は、/opt/appdynamics が作成され、 ubuntu ユーザーがそれを所有していることを確認します。所有権を追加するには、sudo chown ubuntu:ubuntu /opt/appdynamics/smartagent/ を使用します。
ls -ld /opt/appdynamics/smartagent を使用すると、ユーザー権限を確認できます。
以下は、Windows 用の
remote.yaml ファイルのサンプルです。
protocol:
type: winrm
auth:
type: certificate
cert_path: /path/to/cert.pem
key_path: /path/to/key.pem
hosts:
- host: host1.localhost
remote_dir: /dir1/dir
protocol:
type: winrm
auth:
type: certificate
cert_path: host-cert.pem
key_path: host-key.pem
- host: host2.localhost
protocol:
type: winrm
use_plain_text: true
auth:
type: basic
username: testuser
password: testpassword
パラメータの詳細については、Requirements to Install Supported Agent on a Remote Host を参照してください。
- 次のコマンドを実行して、ホストマシンにスマートエージェントをインストールします。
Linuxの場合：
sudo ./smartagentctl start --enable-auto-attach --service --remote
Windowsの場合：
./smartagentctl.exe start --remote
Windowsの場合：
./smartagentctl.exe start --remote
- インストールを検証するには、スマートエージェントのインストールの検証 を参照してください。
複数のホストにスマートエージェントをインストールするには、「複数ノードでのスマートエージェントのインストールの自動化」を参照してください。