How to automate agent install using Active Directory

The Uptrends Infra Agent can be installed manually on any supported Windows server or workstation. However, you might prefer to install the Agent remotely, using a Group Policy in Active Directory. In this document we describe how you can set up such an automated install.

Tip: Please bear in mind that the .NET Framework 4.0 (or higher) must be present on the Agent machine. The automated install will fail if this prerequisite is not met.

Installing the MSI package

The first step is to download the MSI package containing the Agent Setup. This can be found at http://www.uptrendsinfra.com/downloads/uptrendsinfraagent.msi. You should make this MSI package available in a network share within your company’s network.

Then you can define a new Group Policy within your Active Directory. We recommend you to use machines, rather than users for the Security Filtering. As the Agent runs as a Windows Service, no user will be required to log in to the applicable server at all.

You can now register the MSI package within the Group Policy (Computer Configuration/Policies/Software Settings/Software installation). The default settings are fine.

This process is well-documented by Microsoft, e.g. on http://support.microsoft.com/kb/816102. Please refer to this document for more insight.

Registering the agent

After the Agent is installed, it needs to be registered in order to run properly. This implies providing an Uptrends Infra account, to which the Agent will be connected. The registration process can be executed interactively by starting the executable program in:

%programfiles(86)%\UptrendsInfra Agent\Uptrends.Infra.RegisterAgent.exe

It is also possible to provide the account information in the command line of the program mentioned above. In that case provide the username and password as parameters, e.g.:

Uptrends.Infra.RegisterAgent.exe myusername@example.com mypassword

This command can also be scripted, if you like, using a batch file or PowerShell script.