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).- From the left menu, select. From theApplicationspanel, selectManage Telegraf Agents. You see theManage Telegraf Agentspage.
- From theManage Telegraf Agentspage, select the VMs managed by thevCenter Servercloud account on which you want to install the agent.
- From theManage Telegraf Agentspage, clickAgent Actions, and then clickInstall.
- If theVMware Aria OperationsApplication Monitoring Adapter instance has not been created for the specificvCenter Server, you see theInstalling Telegraf Agentdialog box. You can configure high availability for application monitoring via collector groups:
- SelectCloud Proxy Groups, with High-Availabilityif you want to associate an application monitoring high availability activated collector group to thevCenter Server. You can choose the collector group from theHA Enabled Groupdrop down list, or
- SelectCloud Proxies, without High-Availabilityif you want to associate a cloud proxy to thevCenter Server. You can choose a cloud proxy from theCloud Proxydrop down list.
- ClickDone.
If thevCenter Serveris on the default collector, the cloud proxy options are blank. If thevCenter Serveris on a specific cloud proxy, the cloud proxy option is automatically populated. To deploy theVMware Aria OperationsApplication Monitoring Adapter instance on a different cloud proxy, select another cloud proxy or application monitoring high availability activated collector group. - You see theManage Agentdialog box.
- From theHow do you want to provide VM Credentialspage, complete the following steps:
- If you have a common user name and password for all the VMs, select theCommon username and passwordoption.
- If you have different user names and passwords for all the VMs, select theEnter virtual machine credentialsoption.
- ClickNext.
- From theProvide Credentialspage, depending on whether you have a common credential for all VMs managed by thevCenter Servercloud account or different credentials for all VMs managed by thevCenter Servercloud account, enter the following details:
- If the selected VMs have a common user name and password, enter the common user name and password.
- 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 thevCenter Servercloud account. Use theBrowsebutton to select the template.
- TheCreate run time user on Linux virtual machines, with required permissions as part of agent installationcheck box is selected by default. For more information, see User Account Prerequisites.
- ClickNext.
- From theSummarypage, you can view the list of VMs managed by thevCenter Servercloud account on which the agent is to be deployed.
- ClickInstall Agent. Refresh the UI to view the agents that are installed.On User Account Control (UAC) deactivated Windows VMs managed by thevCenter Servercloud account, the Telegraf agent installation completes with theAgent runningagent status andInstall SuccessLast operation status, if all prerequisites are performed.UAC Activated on Windows VMs Managed by the vCenter Server Cloud AccountIn the case of UAC activated VMs, for a non-administrator user who belongs to the administrator group, Telegraf agent installation completes with theNot Startedagent status andDownload Successlast operation status, if all the prerequisites are performed. The bits are downloaded to the VM. You must manually install the bits. FromC:\VMware\UCP\downloads, run a bootstrap launcher, and then the agent status becomesAgent Runningand the Last operation status becomesInstall Success.
- Open PowerShell with administrator privileges.
- Go to$SYSTEMDRIVE\VMware\UCP\downloadsfolder:cd $SYSTEMDRIVE\VMware\UCP\downloads
- Run thecmd /c uaf-bootstrap-launcher.bat > uaf_bootstrap.log 2>&1command.
- View the results fromuaf_bootstrap.log.
- Verify the status of agent installation from theAgent StatusandLast Operation Statuscolumns in theManage Telegraf Agentspage.
- 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 thevCenter Servercloud account on which the agent is installed in theManage Telegraf Agentspage. You can view the status of agent installation from theAgent Statuscolumn in theManage Telegraf Agentspage.
- After installation, an OS object will be created under VMs managed by thevCenter Servercloud account topology. To view the object, select a VM from page. Click theGo detailsbutton, and click on theMetricstab. Expand theObject relationshipwidget, and select the OS object.
- If agent installation fails, a detailed error message is displayed when you hover over the red exclamation icon before the Install Failed text in theLast operation statuscolumn. 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.