各マシンにログインすることで、スマートエージェントをホストマシンにインストールできます。ダウンロードポータルからそれぞれのファイルを必要なホストマシンにダウンロードできます。
Linux または Windows ホストマシンにスマートエージェントをインストールするには、次の手順を実行します。PowerShell を使用してWindowsホスト上でコマンドを実行できます。
- ダウンロードポータルから zip ファイルを必要なホストマシンの任意の場所にダウンロードできます。
unzip -d appdsmartagent appdsmartagent-<version>.zip
- テキストエディタで
config.ini ファイルを開き、プレースホルダの値を、接続する必要がある実際のアクセスキーとサービス URL に置き換えます。
この情報は、スマートエージェントが目的のサービスと通信するために必要です。各設定オプションの説明については、「スマートエージェントの設定」を参照してください。
スマートエージェントの設定
Linuxの場合：
$ cd appdsmartagent
$ vim config.ini
Windowsの場合：
$ cd appdsmartagent
$ notepad config.ini
smartagentctl を使用してスマートエージェントをインストールし、起動します。
smartagentctl が含まれるディレクトリに移動し、必要な変数とパラメータを使用して実行します。「
変数」と「
インストールパラメータ」を参照してください。
Linuxの場合：
sudo ./smartagentctl start --enable-auto-attach --service --user <user> --group <group>
Linuxの場合：
sudo ./smartagentctl start --enable-auto-attach --service --user <user> --group <group>
Windowsの場合：
./smartagentctl.exe start --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 ファイルのサンプルです。
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
user: "appd-user"
group: "appd-group"
username: "ec2-user"
private_key_path: "/Users/abc123/.ssh/id_rsa"
temp_folder_path: "/tmp"
remote_dir: "/opt/appdynamics/smartagent"
---
ここで、ユーザー名は、秘密キーを使用してリモート ホストへの 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
パラメータの詳細については、サポート対象エージェントをリモートホストにインストールするための要件 を参照してください。
- 次のコマンドを実行して、ホストマシンにスマートエージェントをインストールします。
Linuxの場合：
sudo ./smartagentctl start --enable-auto-attach --service --remote
Windowsの場合：
./smartagentctl.exe start --service --remote
- インストールを検証するには、スマートエージェントのインストールの検証 を参照してください。
複数のホストにスマートエージェントをインストールするには、「複数ノードでのスマートエージェントのインストールの自動化」を参照してください。