Vous pouvez installer ou désinstaller un agent sur une machine cible à l’aide d’un script.
Conditions préalables
- Complétez toutes les conditions préalables. Pour plus d'informations, consultez : Conditions préalables.
- Le module unzip doit être disponible sur la machine cible.
- L'utilisateur doit disposer d'autorisations d'accès au dossier de téléchargement.
- Le compte de cloud doit être configuré pour l'instance de vCenter Server à laquelle appartient la machine virtuelle.
- La machine virtuelle gérée par le compte de cloud vCenter Server doit être disponible dans VMware Aria Operations.
Note : Cette condition préalable s'applique uniquement aux machines virtuelles gérées par le compte de cloud
vCenter Server.
- L'adresse IP de l'invité doit être correctement configurée et est unique sur les instances de vCenter Server. Si plusieurs machines virtuelles sont gérés par le compte de cloud vCenter Server avec la même adresse IP surveillée, le script ne peut pas être résolu et s'abonner à la surveillance d'applications.
- La machine cible doit pouvoir accéder au port 443 dans VMware Aria Operations.
- L'utilisateur de VMware Aria Operations doit disposer des autorisations suivantes :
- Administration > Panneau de configuration > REST-API > Toutes les autres API de lecture et d'écriture
- Administration > Panneau de configuration > REST-API > Accès en lecture aux API
- Opérations > Applications > Gérer l'agent Telegraf
- Inventaire > Actions > Démarrer des machines virtuelles
- Inventaire > Actions > Télécharger le démarrage
Note : Pour vérifier les autorisations, accédez à
, puis sélectionnez le rôle auquel l'utilisateur est attribué. Vous pouvez afficher les autorisations sur le côté droit à la fin de la page.
- Seul IPv4 est actuellement pris en charge pour le proxy cloud.
- Version de VMTools >=10.2.
Note : Applicable uniquement aux machines virtuelles gérées par le compte de cloud
vCenter Server.
Procédure
- Connectez-vous à la machine cible sur laquelle vous souhaitez installer/désinstaller l'agent et téléchargez l'exemple de script du proxy cloud, à partir de l'emplacement suivant : https://<CloudProxy>/downloads/salt/telegraf-utils.sh.
Exécutez l'une des commandes suivantes :
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 : Utilisez l'
adresse IP du proxy cloud approprié pour <CloudProxy> dans les commandes et à l'emplacement précédemment spécifiés. Pour les groupes de collecteurs activés pour la haute disponibilité de surveillance d'applications, fournissez l'adresse IP virtuelle.
- Rendez le script exécutable en exécutant la commande suivante :
chmod +x telegraf-utils.sh
- Pour exécuter le script et installer/désinstaller l'agent, exécutez la commande suivante :
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
Note : L'argument
-c est obligatoire pour exécuter le script d'aide.
Pour vérifier l'état du démarrage, affichez le fichier uaf-bootstrap-results. En cas d'échec de l'installation, recherchez les messages d'erreur dans uaf_bootstrap.log.
Si l'exécution du script réussit, le statut de l'agent est mis à jour dans l'onglet Gérer les agents Telegraf après un cycle de collecte d'une durée de 5 à 10 minutes.
Note : Lorsque vous utilisez un script d'automatisation, l'installation simultanée d'un agent avec une taille de lot de 20 est prise en charge.
