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
MSIinstaller 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.
Once you’ve confirmed that your OneAgent has been deployed to all relevant hosts, continue with monitoring setup.
SERVER - The address of the Dynatrace Server. Use the IP address or a name. Add the port number following a colon, for example
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
18.104.22.168: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
1, 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.
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?