Vous pouvez installer 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.
  • La version de Windows PowerShell doit être >= 5.0.
  • 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.
  • 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.
  • Le compte de cloud doit être configuré pour l'instance de vCenter Server à laquelle appartient la machine virtuelle.
    Note : Cette condition préalable s'applique uniquement aux machines virtuelles gérées par le compte de cloud vCenter Server.
  • 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 > 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. 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.
                
                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: .\telegraf-utils.ps1 product-managed -t 8dab02cc-277c-4383-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.

    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.