Install an Agent from the UI

You must select the
vCenter Server
VMs on which you want to install the agent. All the
vCenter Server
VMs of the
vCenter Server
cloud account are listed in the
Manage Telegraf Agents
page.
You cannot install an agent from the
VMware Aria Operations
user interface, on physical servers and target machines (Discovered in
VMware Aria Operations
as the
Endpoint
object type).
Ensure that you have completed all the prerequisites. For more information, see Prerequisites.
  1. From the left menu, select
    Environment
    Applications
    . From the
    Applications
    panel, select
    Manage Telegraf Agents
    . You see the
    Manage Telegraf Agents
    page.
  2. From the
    Manage Telegraf Agents
    page, select the VMs managed by the
    vCenter Server
    cloud account on which you want to install the agent.
  3. From the
    Manage Telegraf Agents
    page, click
    Agent Actions
    , and then click
    Install
    .
  4. If the
    VMware Aria Operations
    Application Monitoring Adapter instance has not been created for the specific
    vCenter Server
    , you see the
    Installing Telegraf Agent
    dialog box. You can configure high availability for application monitoring via collector groups:
    • Select
      Cloud Proxy Groups, with High-Availability
      if you want to associate an application monitoring high availability activated collector group to the
      vCenter Server
      . You can choose the collector group from the
      HA Enabled Group
      drop down list, or
    • Select
      Cloud Proxies, without High-Availability
      if you want to associate a cloud proxy to the
      vCenter Server
      . You can choose a cloud proxy from the
      Cloud Proxy
      drop down list.
    • Click
      Done
      .
    If the
    vCenter Server
    is on the default collector, the cloud proxy options are blank. If the
    vCenter Server
    is on a specific cloud proxy, the cloud proxy option is automatically populated. To deploy the
    VMware Aria Operations
    Application Monitoring Adapter instance on a different cloud proxy, select another cloud proxy or application monitoring high availability activated collector group.
  5. You see the
    Manage Agent
    dialog box.
  6. From the
    How do you want to provide VM Credentials
    page, complete the following steps:
    1. If you have a common user name and password for all the VMs, select the
      Common username and password
      option.
    2. If you have different user names and passwords for all the VMs, select the
      Enter virtual machine credentials
      option.
    3. Click
      Next
      .
  7. From the
    Provide Credentials
    page, depending on whether you have a common credential for all VMs managed by the
    vCenter Server
    cloud account or different credentials for all VMs managed by the
    vCenter Server
    cloud account, enter the following details:
    1. If the selected VMs have a common user name and password, enter the common user name and password.
    2. For different user names and passwords for each VM, download the CSV template and add the required details such as the user name, password for each VM managed by the
      vCenter Server
      cloud account. Use the
      Browse
      button to select the template.
    3. The
      Create run time user on Linux virtual machines, with required permissions as part of agent installation
      check box is selected by default. For more information, see User Account Prerequisites.
    4. Click
      Next
      .
  8. From the
    Summary
    page, you can view the list of VMs managed by the
    vCenter Server
    cloud account on which the agent is to be deployed.
  9. Click
    Install Agent
    . Refresh the UI to view the agents that are installed.
    On User Account Control (UAC) deactivated Windows VMs managed by the
    vCenter Server
    cloud account, the Telegraf agent installation completes with the
    Agent running
    agent status and
    Install Success
    Last operation status, if all prerequisites are performed.
    UAC Activated on Windows VMs Managed by the vCenter Server Cloud Account
    In the case of UAC activated VMs, for a non-administrator user who belongs to the administrator group, Telegraf agent installation completes with the
    Not Started
    agent status and
    Download Success
    last operation status, if all the prerequisites are performed. The bits are downloaded to the VM. You must manually install the bits. From
    C:\VMware\UCP\downloads
    , run a bootstrap launcher, and then the agent status becomes
    Agent Running
    and the Last operation status becomes
    Install Success
    .
    • Open PowerShell with administrator privileges.
    • Go to
      $SYSTEMDRIVE\VMware\UCP\downloads
      folder:
      cd $SYSTEMDRIVE\VMware\UCP\downloads
    • Run the
      cmd /c uaf-bootstrap-launcher.bat > uaf_bootstrap.log 2>&1
      command.
    • View the results from
      uaf_bootstrap.log
      .
    • Verify the status of agent installation from the
      Agent Status
      and
      Last Operation Status
      columns in the
      Manage Telegraf Agents
      page.
  10. The agent discovers the application services that are installed on the target machines. You can view the application services by clicking the drop down arrow against the VMs managed by the
    vCenter Server
    cloud account on which the agent is installed in the
    Manage Telegraf Agents
    page. You can view the status of agent installation from the
    Agent Status
    column in the
    Manage Telegraf Agents
    page.
  11. After installation, an OS object will be created under VMs managed by the
    vCenter Server
    cloud account topology. To view the object, select a VM from
    Environment
    Applications
    Manage Telegraf Agents
    page. Click the
    Go details
    button, and click on the
    Metrics
    tab. Expand the
    Object relationship
    widget, and select the OS object.
  12. If agent installation fails, a detailed error message is displayed when you hover over the red exclamation icon before the Install Failed text in the
    Last operation status
    column. You can take appropriate action based on the error message to resolve the agent installation issues.
You can manage the services on each agent.
For information about uninstalling an agent, see Uninstall an Agent.