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 vRealize Operations Cloud.
  • 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. Si no existe, se creará el adaptador de supervisión de aplicaciones que está asignado a vCenter Server.
  • Asegúrese de que Internet esté habilitado.
  • El usuario de 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.
  • Por el momento, solo se admite IPv4.
  • La versión de VMTools debe ser >= 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/download.sh. Ejecute uno de los siguientes comandos:
    wget --no-check-certificate “https://<CloudProxy>/downloads/salt/download.sh”
    curl -k “https://<CloudProxy>/downloads/salt/download.sh” --output download.sh
    Nota: Use la dirección IP/FQDN del proxy de nube correspondiente para <CloudProxy> 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 download.sh
  3. Cree el token de actualización del usuario asociado a la organización actual desde la siguiente ubicación en el portal de Cloud Service: Ajustes de usuario/organización > Mi cuenta > Tokens de API > Generar un nuevo token de API
  4. Para ejecutar el script e instalar/desinstalar el agente, ejecute el siguiente comando:
    download.sh -o operation -t user_saas_refresh_token -c cloud_proxy_ip_or_collector_group_name [-d download_tmp_dir -s sleep_seconds -i list_of_IPs]
    
    Description of arguments:
    operation - Bootstrap operation. values: install, uninstall.
    user_saas_refresh_token - CSP Refresh Token of the user/account. For getting new token, follow - "User/Organization Settings >> My Account >> API Tokens >> Generate a New API Token". It's a mandatory parameter.
    Example: gi7lwabjnvdfiawt4watzksuol8sywrjvg8kabh31mx9x1guepgyhycyx61dqrpq
    cloud_proxy_ip_or_collector_group_name - Cloud Proxy IP on which the AppOS Adapter instance will be created or the name of the application monitoring high availability activated collector group.
    download_tmp_dir - Temporary directory to download agent related bits. It's an optional parameter. Default value: current directory
    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.
    list_of_IPs - This is an optional parameter. Comma separated IPs that are set as properties of a VM in vROps (VM -> Properties -> Network -> <Integer> -> IP Address). If single adapter has multiple IP Addresses then delimit them using '_'
    Example:- If your VM has 3 adapters with the following IP Addresses: 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"
    
    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.