Can I automate installation using Windows Group Policy?

In addition to an EXE download, we also have an MSI file that you can use with Microsoft Group Policy to remotely install Dynatrace OneAgent on your Windows machines. The MSI installer is not pre-configured like the EXE installer is, but it offers the same functionality. Look for the download link for the MSI file during Windows host monitoring setup page, as shown below:

Download and deploy the installer

Download the archive that contains the installation files. The archive contains an MSI installer file and a batch file with an example command line. Use the command line to deploy agents with the default installation settings. You can add or skip any parameters in the batch command. Typically it’s enough to use settings from the batch file.

Configure your Group Policy:

  • Create a distribution point.
  • Assign a package (the agent MSI installer with parameters).
  • Publish your policy.

Take a look at the Microsoft documentation if you need help.

Each successful agent installation is recorded by Dynatrace. You’ll see that your agent has been successfully deployed once communication is established between your OneAgent and Dynatrace.

Successfully connected agent listed on the installation page.

Once you’ve confirmed that your OneAgent has been deployed to all relevant hosts, continue with monitoring setup.

Windows MSI installer parameters

SERVER - The address of the Dynatrace Server. Use the IP address or a name. Add the port number following a colon, for example http://100.20.10.1:8020.

TENANT - Your Dynatrace environment ID. You received this ID with your activation e-mail. By default, this setting is already set to the correct value. If you’re selling Dynatrace-based services, use this option to set your customers’ IDs (available from the pool of IDs you purchased from Dynatrace).

TENANT_TOKEN - Your Dynatrace environment authorization token.

PROXY - The address of the proxy server. Use the IP address or a name. Add the port number following a colon, for example 172.1.1.128:8080. We also support IPv6 addresses. Skip the PROXY parameter to force the installer to auto detect or ask for proxy details. If you want the installer to ignore proxy detection or want to skip entering proxy details, type NO_PROXY as the PROXY parameter value.

APP_LOG_CONTENT_ACCESS - When set to true, allows Dynatrace OneAgent to access log files for the purpose of log analytics. This value can be changed during installation via the installer UI.

All parameters are optional—if you skip them using the MSI installer, OneAgent installation won’t fail. However OneAgent won’t be able to communicate with Dynatrace Server.

Next steps

Following Dynatrace OneAgent installation you need to restart all processes that you want to monitor. You’ll be prompted with a list of the processes that need to be restarted. Note that you can restart your processes at any time, even during your organization’s next planned maintenance period. Though until all processes have been restarted, you’ll only see a limited set of metrics, for example CPU or memory consumption. For more information, see How do I enable deep process monitoring?