サポート対象エージェントをリモートホストにインストールするための要件
サポート対象エージェントをリモートホストにインストールし、サービスまたはプロセスとして動作させることができます。
remote.yaml ファイルを作成し、プライマリホストに使用したものと同じコマンドを、--remote パラメータを追加して使用する必要があります。remote.yaml ファイルを使用すると、次のものを指定できます。1 つ以上のリモートサーバーに接続するための詳細情報。
使用するプロトコル。Windows の場合は
WinRM、Linux の場合はSSHです。認証方式。
その他の操作パラメータ。
このファイルは、すべてのホストに適用されるグローバル コンフィギュレーションと、特定のホストに適用される特定のコンフィギュレーションをサポートします。グローバル設定を上書きしたり、ホストごとの個別設定を含めたりするには、remote.yaml ファイルで host パラメータを使用します。
remote.yaml ファイルには次のパラメータが必要です。- Linuxの場合：
Parameters 説明 max_concurrency 同時に処理されるホストの最大数を決定します。デフォルト値は4です。
このパラメータの値は正の整数である必要があります。たとえば、max_concurrency
: 3を指定すると、スマートエージェントは、指定された最初の 3 つのホストへのインストールを開始します。1 つのホストへのインストールが完了し、他の 2 つのホストがまだ処理中の場合、スマートエージェントは、次のホストの処理を開始し、3 つのホストが同時に処理されるようにします。remote_dir スマートエージェントのインストールなどの操作が実行される 1 つまたは複数のリモートホスト上のターゲットディレクトリ。たとえば、 /home/my-remote-user/appd/smartagentです。プロトコル リモートホストに接続するためのプロトコル。これには、次のサブパラメータが含まれます。
type：プロトコルのタイプ。接続プロトコルはsshに指定します。auth：SSH プロトコルに必要な認証固有の設定。これらの設定は、サブパラメータとして含めることができます。username：SSH 認証用のユーザー名。これは、リモートディレクトリでの書き込み権限を持つ任意のユーザー名にすることができます。ユーザーが
ubuntuで、/opt/appdynamics/smartagentにあるリモートホストにサポート対象エージェントをインストールする場合は、ディレクトリ/opt/appdynamicsが作成され、Ubuntu ユーザーがそのディレクトリの所有者であることを確認してください。private_key_path：認証用の SSH 秘密キーファイルへのパス。たとえば、/Users/my-local-user/.ssh/private_keyです。privileged：リモートホストでルートアクセスを取得するオプション。値はtrueまたはfalseです。この値はtrueに指定することをお勧めします。デフォルト値はfalseであり、提供されたユーザー権限を使用してプロセスを実行します。値をtrueに指定すると、ユーザーはリモートホストでのルート権限を取得し、システム全体のサービスをインストールできるようになります。known_hosts_path： SSH のknown_hostsファイルへのパス。これは、ホストキーの検証に使用されます。たとえば、/Users/my-local-user/.ssh/known_hostsです。ignore_host_key_validation：SSH ホストキーの検証を無視するオプション。デフォルト値はfalseで、これは推奨値でもあります。
port プライマリホストとリモートホストの直接通信用の SSH ポート。SSH 接続では、プロキシ設定はサポートされません。
デフォルト値は
22です。hosts すべてのホストのリスト。各ホストには、リモートサーバーの IP アドレスまたはホスト名が含まれます。また、ホストパラメータ内で remote_dir and protocolを指定して、グローバルremote_dir and global protocolで個別に指定された値を上書きすることもできます。 - Windowsの場合：
Parameters 説明 max_concurrency 同時に処理されるホストの最大数を決定します。デフォルト値は4です。 remote_dir スマートエージェントのインストールなどの操作が実行される 1 つまたは複数のリモートホスト上のターゲットディレクトリ。たとえば、 c:\users\administrator\appd\smartagentです。protocol これには、次のサブパラメータが含まれます。
type：プロトコルのタイプ。接続プロトコルはwinrmに指定します。root_ca_cert_path： TLSルートCA証明書ファイルへのパス。たとえば、
root-ca.pemです。これは、信頼を確立するための自己署名証明書に使用されます。use_plain_text：HTTP または HTTPS を使用するオプション。値は true または false です。値が true の場合、HTTP が、暗号化されていない通信のために使用されます。デフォルト値は false であるため、HTTPS が、セキュアな通信のために使用されます。
- tls_skip_verification：TLS 証明書の検証プロセスをスキップするオプション。値が true の場合、スマートエージェントは、TLS 証明書の検証プロセスをスキップします。デフォルト値は false であり、セキュアな通信が確保されます。
auth：WinRM プロトコルに必要な認証固有の設定。サブパラメータとして含めることができる設定については、「auth」を参照してください。
auth
これは
Protocolのサブパラメータであり、認証固有の設定を指定する次のサブパラメータを含めることができます。type：WinRM 認証方式のタイプ。値は certificate または basic です。certificateには、次のパラメータを指定する必要があります。cert_path：クライアント証明書へのパス。たとえば、
winrm_client_cert.pemです。key_path：クライアント証明書の秘密キーファイルへのパス。
basicでは、ユーザー名と共に次のいずれかのパスワード設定を指定する必要があります。username：認証用のユーザー名。
password：指定されたユーザー名のパスワード。
passwordEnv：パスワードを保存する環境変数の名前。たとえば、
WINRM_PASSWORDです。
port 接続のポート番号。
デフォルト値は 5985（HTTP）および 5986（HTTPS）です。
hosts すべてのホストのリスト。各ホストには、リモートサーバーの IP アドレスまたはホスト名が含まれます。また、ホストパラメータ内で remote_dir and protocolを指定して、グローバルremote_dir and global protocolで個別に指定された値を上書きすることもできます。