Puede instalar o desinstalar un agente en una máquina virtual de endpoint mediante un script.

Requisitos previos

  • La máquina virtual de endpoint debe estar disponible en VMware Aria Operations.
  • Complete todos los requisitos previos. Para obtener más información, consulte Requisitos previos.
  • El paquete descomprimido debe estar disponible en la máquina virtual de endpoint.
  • El usuario debe tener permisos de acceso a la carpeta de descarga.
  • La IP de invitado debe estar configurada correctamente y ser única en todas las instancias de vCenter Server. Si se supervisan varias máquinas virtuales de endpoint con la misma dirección IP en las instancias de vCenter Server, el script no podrá resolverse ni suscribirse a la supervisión de aplicaciones.
  • La cuenta de nube debe configurarse para la instancia de vCenter Server a la que pertenece la máquina virtual de endpoint.
  • El puerto 443 en VMware Aria Operations debe estar accesible para la máquina virtual de endpoint.
  • El usuario de VMware Aria Operations debe tener los siguientes permisos:
    • Administración > REST API > Todas las demás API de lectura y escritura
    • Administración > REST API > Acceso de lectura a las API
    • Entorno > Aplicaciones > Administrar agente de Telegraf
    • Entorno > Acciones > Máquinas virtuales de arranque
    • Entorno > Acciones > Descargar arranque
    Nota: Para comprobar los permisos, desplácese hasta Administración > Control de acceso > Roles y seleccione la función a la que está asignado el usuario. Puede ver los permisos en la parte derecha al final de la página.
  • Actualmente, solo se admite IPv4 para el proxy de nube.
  • Versión de VMTools >= 10.2.

Procedimiento

  1. Inicie sesión en la máquina virtual de endpoint en la que desea instalar o desinstalar el agente y descargue el script de muestra desde el proxy de nube en la siguiente ubicación: https://<CloudProxy>/downloads/salt/telegraf-utils.sh.
    Ejecute uno de los siguientes comandos: 
    wget --no-check-certificate https://<CloudProxy>/downloads/salt/telegraf-utils.sh
curl -k “https://<CloudProxy>/downloads/salt/telegraf-utils.sh” --output telegraf-utils.sh
    Nota: Use la dirección IP del proxy de nube correspondiente para <proxy-de-nube> en los comandos y la ubicación anteriores especificados. Para los grupos de recopiladores activados de alta disponibilidad para supervisión de aplicaciones, proporcione la IP virtual.
  2. Convierta el script en ejecutable mediante la ejecución del siguiente comando: 
    chmod +x telegraf-utils.sh
  3. Para ejecutar el script e instalar/desinstalar el agente, ejecute el siguiente comando: 
    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
    Nota: El argumento -c es obligatorio para ejecutar el script de aplicación auxiliar.

    Para comprobar el estado de arranque, consulte el archivo uaf-bootstrap-results. Si se produce un error en la instalación, busque mensajes de error en uaf_bootstrap.log.

    Si el script es correcto, el estado del agente se actualizará en la pestaña Administrar agentes de Telegraf después de un ciclo de recopilación que tarda entre 5 y 10 minutos.

    Nota: Cuando se usa un script de automatización, se admite la instalación simultánea de agentes con un tamaño de lote de 20.