Installer/désinstaller un agent à l'aide d'un script sur une plate-forme Linux

Vous pouvez installer ou désinstaller un agent sur une VM de point de terminaison à l'aide d'un script.

Conditions préalables

• La machine virtuelle de point de terminaison doit être disponible dans VMware Aria Operations.
• Complétez toutes les conditions préalables. Pour plus d'informations, consultez : Conditions préalables.
• Le module de décompression doit être disponible sur la machine virtuelle de point de terminaison.
• L'utilisateur doit disposer d'autorisations d'accès au dossier de téléchargement.
• L'adresse IP de l'invité doit être correctement configurée et est unique sur les instances de vCenter Server. Si plusieurs machines virtuelles de point de terminaison ayant la même adresse IP dans différentes instances de vCenter Server sont surveillées, le script ne peut pas être résolu et s'abonner à la surveillance d'applications.
• Le compte de cloud doit être configuré pour l'instance de vCenter Server à laquelle appartient la machine virtuelle de point de terminaison.
• La VM de point de terminaison VMware Aria Operations doit pouvoir accéder au port 443.
• L'utilisateur de VMware Aria Operations doit disposer des autorisations suivantes :
  • Administration > REST-API > Toutes les autres API de lecture et d'écriture
  • Administration > REST-API > Accès en lecture aux API
  • Environnement > Applications > Gérer l'agent Telegraf
  • Environnement > Actions > Démarrer des machines virtuelles
  • Environnement > Actions > Télécharger le démarrage
  Note : Pour vérifier les autorisations, accédez à Administration > Contrôle d'accès > Rôles, 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.

Procédure

1. Connectez-vous à la VM de point de terminaison 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 précédentes et à l'emplacement spécifiés. Pour les groupes de collecteurs activés pour la haute disponibilité de surveillance d'applications, fournissez l'adresse IP virtuelle.
2. Rendez le script exécutable en exécutant la commande suivante :

   chmod +x telegraf-utils.sh

3. 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.