You can install or uninstall an agent on an end point VM using a script.
Procedure
- Log in to the end point VM on which you want to install/uninstall the agent and download the sample script from cloud proxy from the following location: https://<CloudProxy>/downloads/salt/ telegraf-utils.sh. Run one of the following commands:
wget --no-check-certificate “https://<CloudProxy>/downloads/salt/telegraf-utils.sh”
curl -k “https://<CloudProxy>/downloads/salt/telegraf-utils.sh” --output telegraf-utils.sh
Note: Use the relevant cloud proxy
IP address for <CloudProxy> in the preceding commands and location specified. For application monitoring high availability activated collector groups, provide the virtual IP.
- Make the script executable by running the following command:
chmod +x telegraf-utils.sh
- Create the user's refresh token associated with the current organization from the following location in the Cloud Service portal: User/Organization Settings > My Account > API Tokens > Generate a New API Token
- To execute the script and install/uninstall the agent, run the following command:
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.
saas: CSP Refresh Token of the user/account. For getting new token, follow - User/
Organization Settings >> My Account >> API Tokens >> Generate a New API Token.
Example: gi7lwabjnvdfiawt4watzksuol8sywrjvg8kabh31mx9x1guepgyhycyx61dqrpq
-d : [OPTIONAL] download_tmp_dir - Temporary directory for agent installation. Default: current directory
-g : [OPTIONAL] [SAAS-SPECIFIC] gateway_url - argument to override default VMware Aria Operations SaaS gateway URL
-a : [OPTIONAL] [SAAS-SPECIFIC] csp_auth_url - argument to override default CSP authentication URL
-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-4383-b910-bd2e89c7e741::8bcde100-6318-44d7-a8dc-11f4ff84b3b -v 10.10.10.100 -c 10.10.10.101
Note: The
-c
argument is mandatory to run the helper script.
Note: The default gateway URL is
https://www.mgmt.cloud.vmware.com/vrops-cloud and the default authentication URL is
https://console.cloud.vmware.com/csp/gateway/am/api/auth/api-tokens/authorize. If the authentication URL and gateway URL are different from the default settings, provide the appropriate arguments (-g and -a).
To verify the bootstrap status, view the
uaf-bootstrap-results file. If the installation fails, look for error messages in
uaf_bootstrap.log.
If the script is successful, the agent status will be updated in the Manage Telegraf Agents tab after one collection cycle that takes 5–10 minutes.
Note: When you use an automation script, concurrent agent installation with a batch size of 20 is supported.