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

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

前提条件

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

手順

エージェントをインストールまたはアンインストールするエンドポイント仮想マシンにログインし、次の場所でクラウドプロキシからサンプルスクリプトをダウンロードします：https://<CloudProxy>/downloads/salt/telegraf-utils.sh。
次のいずれかのコマンドを実行します。
```
wget --no-check-certificate https://<CloudProxy>/downloads/salt/telegraf-utils.sh
curl -k “https://<CloudProxy>/downloads/salt/telegraf-utils.sh” --output telegraf-utils.sh
```
注：上記で指定したコマンドおよび場所の <CloudProxy> には、関連するクラウドプロキシ [IP アドレス] を使用します。アプリケーション監視の高可用性が有効なコレクタグループの場合は、仮想 IP アドレスを指定します。
次のコマンドを実行してスクリプトを実行可能にします。
```
chmod +x telegraf-utils.sh
```

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

telegraf-utils.sh  product-managed -c cloud_proxy_ip_or_collector_group_name -t token (-v vmwareariaoperations_ip_or_fqdn | [-g gateway_url -a csp_auth_url]) [-d download_tmp_dir -s sleep_seconds -i list_of_IPs -o operation]
    
Description of arguments:
      -c : [REQUIRED] cloud_proxy_ip_or_collector_group_name - Cloud Proxy IP or Collector Group Name
      -t : [REQUIRED] token - This can be user_saas_refresh_token or on-prem vmwareariaoperations_auth_token.
            
            on-prem: Auth Token of the user/account. For getting new token
                     ( https://<VMwareAriaOperations_IP>/suite-api/ or curl -ks -X POST https://<VMwareAriaOperations_IP>/suite-api/api/auth/token/acquire -H \"Content-Type: application/json\" -H \"Accept: application/json\" -d \"{\"username\":\"<VMwareAriaOperations_USER>\",\"password\":\"<VMwareAriaOperations_USER_PASSWORD>\"}\")
      -d : [OPTIONAL] download_tmp_dir - Temporary directory for agent installation. Default: current directory
      -v : [CONDITIONAL] [ON-PREM-SPECIFIC] vmwareariaoperations_ip_or_fqdn - IP/FQDN of VMware Aria Operations master node and required for on-prem.
      
      -o : [OPTIONAL] operation - The type of operation to be performed {install,uninstall} Default: install
      -s : [OPTIONAL] 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.
      -i : [OPTIONAL] list_of_IPs - This is an optional parameter. Comma separated IPs that are set as properties of a VM in VMware Aria Operations (VM -> Properties -> Network -> <Integer> -> IP Address). If single adapter has multiple IP Addresses, then delimit them using '_'
                    ex:- If your VM has 3 adapters with IP Address as follows: 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"

Example: /bin/bash telegraf-utils.sh product-managed -t 8dab02cc-277c-4392-b910-bd2e98c7e741::8bcde100-6318-44d7-a8dc-11f4ff84b3b -v 10.10.10.100 -c 10.10.10.101

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

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

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

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