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. L'adaptateur de surveillance d'applications mappé au vCenter Server est créé s'il n'existe pas.
    Note : Cette condition préalable s'applique uniquement aux machines virtuelles gérées par le compte de cloud vCenter Server. Pour plus d'informations sur les types d'objet, reportez-vous à la section Surveillance du système d'exploitation et des applications.
  • 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 doit être 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.
    Note : Cette condition préalable s'applique uniquement aux machines virtuelles gérées par le compte de cloud vCenter Server. Pour plus d'informations sur les types d'objet, reportez-vous à la section Surveillance du système d'exploitation et des applications.
  • Assurez-vous d'être connecté à Internet.
  • 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, 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.
  • La version de VMTools doit être supérieure ou égale à la version 10.2.
    Note : Applicable uniquement aux machines virtuelles gérées par le compte de cloud vCenter Server.

Procédure

  1. 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.ps1.
    Si le téléchargement du script échoue avec le message suivant : La demande a été abandonnée : impossible de créer un canal sécurisé SSL/TLS, suivez les étapes mentionnées dans Échec du téléchargement du script sur une plate-forme Windows.
    Exécutez l'une des commandes suivantes :
    PowerShell command:
    Invoke-WebRequest "https://<CloudProxy>/downloads/salt/telegraf-utils.ps1" -OutFile telegraf-utils.ps1
    
    Or if you have the wget tool:
    wget --no-check-certificate https://<CloudProxy>/downloads/salt/telegraf-utils.ps1
    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. Créez le jeton d'actualisation de l'utilisateur associé à l'organisation actuelle à partir de l'emplacement suivant dans le portail de services Cloud : Paramètres d'utilisateur/d'organisation > Mon compte > Jetons d'API > Générer un nouveau jeton d'API
  3. Pour exécuter le script et installer/désinstaller l'agent, exécutez la commande suivante :
    telegraf-utils.ps1  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: .\telegraf-utils.ps1 product-managed -t 8dab02cc-265c-4392-b910-bd2e89c7e741::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.
    Note : L'URL de la passerelle par défaut est https://www.mgmt.cloud.vmware.com/vrops-cloud et l'URL d'authentification par défaut est https://console.cloud.vmware.com/csp/gateway/am/api/auth/api-tokens/authorize. Si l'URL d'authentification et l'URL de la passerelle sont différentes des paramètres par défaut, fournissez les arguments appropriés (-g et -a).
    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.