Windows プラットフォームにおけるスクリプトでのエージェントのインストール/アンインストール

スクリプトを使用して、エンドポイント仮想マシンでエージェントのインストール/アンインストールができます。

前提条件

エンドポイント仮想マシンを vRealize Operations Cloud で使用できる必要があります。
すべての前提条件を満たします。詳細については、「前提条件」を参照してください。
解凍パッケージをエンドポイント仮想マシンで使用できる必要があります。
ユーザーにダウンロードフォルダへのアクセス権限が必要です。
ゲスト IP アドレスが適切に構成され、vCenter Server 全体で一意である必要があります。vCenter Server 間で同じ IP アドレスを持つ複数のエンドポイント仮想マシンが監視されている場合、スクリプトは解決されず、アプリケーションの監視にサブスクライブすることはできません。
クラウドアカウントは、エンドポイント仮想マシンが属する vCenter Server 用に構成されている必要があります。vCenter Server にマッピングされているアプリケーション監視アダプタは、存在しない場合に作成されます。
インターネットが有効であることを確認します。
ユーザーに、次の権限が必要です。
- 管理 > REST-API > その他のすべての読み取り、書き込み API
- 管理 > REST-API > API への読み取りアクセス
- 環境 > アプリケーション > Telegraf エージェントの管理
- 環境 > アクション > 仮想マシンのブートストラップ
- 環境 > アクション > ブートストラップのダウンロード
注：権限を確認し、 [管理] > [アクセスコントロール] > [ロール] の順に移動して、ユーザーが割り当てられているロールを選択します。権限はページの右端に表示されます。
現在は IPv4 のみがサポートされています。
VMware Tools のバージョンは 10.2 以上にする必要があります。

手順

エージェントをインストールまたはアンインストールするエンドポイント仮想マシンにログインし、次の場所でクラウドプロキシからサンプルスクリプトをダウンロードします：https://<CloudProxy>/downloads/salt/download.ps1。
スクリプトのダウンロードが失敗し、 要求が中止されました：SSL/TLS セキュアチャネルを作成できませんでした というメッセージが表示される場合は、 Windows プラットフォームでスクリプトのダウンロードに失敗するに記載されている手順に従ってください。
次のいずれかのコマンドを実行します。
```
PowerShell command:
Invoke-WebRequest "https://<CloudProxy>/downloads/salt/download.ps1" -OutFile download.ps1

Or if you have the wget tool:
wget --no-check-certificate https://< CloudProxy >/downloads/salt/download.ps1
```
注：上記で指定したコマンドおよび場所の <CloudProxy> には、関連するクラウドプロキシ IP アドレス/FQDN を使用します。アプリケーション監視の高可用性が有効なコレクタグループの場合は、仮想 IP アドレスを指定します。
現在の組織に関連付けられているユーザーの更新トークンを、クラウドサービスポータルの次の場所から作成します: [ユーザー/組織設定] > [マイアカウント] > [API トークン] > [新しい API トークンを生成]

スクリプトを実行し、エージェントをインストールまたはアンインストールするには、次のコマンドを実行します。

download.ps1 -o operation -t user_saas_refresh_token -c cloud_proxy_ip_or_collector_group_name [-d download_tmp_dir -s sleep_seconds -i list_of_IPs]

Description of arguments:
operation - Bootstrap operation. values: install, uninstall.
user_saas_refresh_token - CSP Refresh Token of the user/account. For getting new token, follow - User/Organization Settings >> My Account >> API Tokens >> Generate a New API Token. It's a mandatory parameter.
Example: gi7lwabjnvdfiawt4watzksuol8sywrjvg8kabh31mx9x1guepgyhycyx61dqrpq
cloud_proxy_ip_or_collector_group_name - Cloud Proxy IP on which the AppOS Adapter instance will be created or the name of the application monitoring high availability activated collector group.
download_tmp_dir - Temporary directory to download agent related bits. It's an optional parameter. Default value: current directory
sleep_seconds - Time (in seconds) to delay the script execution. This optional parameter will be helpful when this script is used in vRA to have agent installed on deploying VM. Recommended time 600 seconds.
list_of_IPs - This is an optional parameter. Comma separated IPs that are set as properties of a VM in vROps (VM -> Properties -> Network -> <Integer> -> IP Address). If single adapter has multiple IP Addresses then delimit them using '_'
Example:- If your VM has 3 adapters with the following IP Addresses: Adapter1: 10.0.0.1 Adapter2: 10.0.0.2 & 10.0.0.3 Adapter3: 10.0.0.4
Then this parameter should be given as '10.0.0.1,10.0.0.2_10.0.0.3,10.0.0.4'

注：ヘルパースクリプトを実行するには、 -c 引数が必須です。

ブートストラップのステータスを確認するには、 uaf-bootstrap-results のファイルを確認します。インストールが失敗した場合は、 uaf_bootstrap.log でエラーメッセージを探します。

スクリプトが正常に実行された場合は、1 回の収集サイクル後に [Telegraf エージェントの管理] タブのエージェントステータスが更新されます。サイクルの完了には約 5 ～ 10 分かかります。

注：自動化スクリプトを使用する場合、バッチサイズが 20 のエージェントの同時インストールがサポートされます。