This page describes how to download and install Dynatrace OneAgent on Windows.
- If you're a Dynatrace SaaS customer, go to Dynatrace.com, click SaaS login, and sign in using the username and password you received from Dynatrace in your signup confirmation email.
- If you're a Dynatrace Managed customer, access the Cluster Management Console and choose the environment you want to monitor.
Then continue with the installation steps provided below.
- You need administrator rights for the servers where OneAgent will be installed as well as for changing firewall settings (necessary only if your internal routing policy may prevent Dynatrace software from reaching the Internet).
- You need permissions and credentials for restarting all your application services.
- You need to check also the disk space requirements.
- The host on which you install OneAgent needs at least 300 MB RAM.
- OneAgent installation isn't supported on networked storage mount points that are managed by standards such as NFS or iSCSI.
- All hosts that are to be monitored need to be able to send data to the Dynatrace cluster. Depending on whether your Dynatrace deployment is on SaaS, or on Managed environment, and on your network layout and security settings, you may choose to either provide a direct access to Dynatrace cluster, or to set up an ActiveGate.
OneAgent Windows installer doesn't support the modify and repair operations. You can't reinstall OneAgent using the same installer version as the installed OneAgent. To reinstall OneAgent, uninstall it first or simply install a newer version.
Select Deploy Dynatrace from the navigation menu.
Click the Start installation button and select Windows.
Download the installer. There are two options:
Click the Download agent.exe button to download the Windows installer (EXE file) for single-server installation.
The OneAgent Windows EXE installer is preconfigured for your environment. If you need to customize it, you can add add the installation parameters at a Windows command line. You can also add the
--set-param=<value>parameters on the Configure OneAgent settings installer screen.
For more information, see Customize OneAgent installation on Windows
Group Policy deployment?
Download the OneAgent EXE installer and run it with the
--unpack-msiparameter to extract the MSI package and the installation batch file. Optionally, you can specify an existing path. If you skip the path, the files are saved to a working directory. For example:
C:\Downloads\Dynatrace-OneAgent-Windows.exe --unpack-msi "C:\installers"
When using the
--unpack-msiparameter, no other installation parameters are allowed. Add the
--quietparameter to run the MSI package extraction in quiet mode. Use the
--helpparameter to display a pop-up window with a list of available parameters.
Copy and paste the MSI package and the batch file when configuring Group Policy for Dynatrace installation. The default installation should work in most cases, but if you need to customize it, you can modify the installation parameters. Then, you have to create a distribution point, assign a package (the OneAgent MSI package with parameters), and publish your policy.
Click the Download MSI package link to download the Windows installer for Group Policy deployments. You get a ZIP package that includes an MSI file and a batch file with the command line you can copy and paste when configuring Group Policy for Dynatrace installation. The default installation should work in most cases, but if you need to customize it, you can modify the installation parameters. Then, you have to create a distribution point, assign a package (the OneAgent MSI package with parameters), and publish your policy.
Run the executable file and follow the displayed instructions. If your environment is segmented, for example into development and production, consider organizing your hosts into host groups. To do this, select the Set host group for this host option and provide a name. If the name you enter exists already, the host will be added to the group with this name. If you provide a new name, a new host group will be created. The EXE installer provides a quiet mode. Simply use it with command-line
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.
OneAgent is a set of specialized services that have been configured specifically for your monitoring environment. The role of these services is to monitor various aspects of your hosts, including hardware, operating system, and application processes.
During the installation process, the installer
Installs executable code and libraries that are used by OneAgent.
Creates entries in the Windows Registry that start OneAgent as a
SYSTEMservice. Additionally, the
WinPcapare installed to allow better integration with the operating system and to facilitate the capture of network statistics.
Checks the system’s global proxy settings.
Checks for a connection to Dynatrace Server or ActiveGate (if you installed ActiveGate and downloaded the OneAgent installer after ActiveGate was connected to Dynatrace).
OneAgent 1.193 and earlier Creates its own user (
dtuser) to run OneAgent extensions. This user is a member of the Performance Monitoring Users group, and can only log in as a service. The password is randomly generated during installation and stored encrypted. You can't change the password. For security purposes, the
dtuseris not allowed to:
- Access computer from the network.
- Log in as a batch job.
- Log in locally.
- Log in through Remote Desktop Services.
dtuseris required for Dynatrace to operate properly, therefore you must not delete it. If, for some reason, the
dtuserwas deleted, next update will recreate it.
OneAgent 1.195+ For fresh OneAgent 1.195+ installations, the default
LocalSystem accountis used to run OneAgent extensions. For a summarized view of the changes made to your system by OneAgent installation, see OneAgent security on Windows.
It’s recommended that you install the version of
WinPcap that is packaged with the OneAgent installer. Its library is the cornerstone of Dynatrace network analysis. We’ve packaged the library in such a way that its DLLs are seamlessly integrated with Dynatrace software, thereby enabling unattended updates and other advantages. If you already have
WinPcap installed, please remove it before OneAgent installation. The installer includes the latest, unmodified version of the library—so any other software you have that relies on
WinPcap won’t suffer from library loss.
Great, setup is complete! You can now take a look around your new monitoring environment. If you are a SaaS customer, you can access your monitoring environment anytime by going to Dynatrace website and clicking the Login button in the upper-right corner. If you are a Managed customer, you can access your monitoring environment through the Cluster Management Console.
One last thing: to monitor your processes, you need to restart them. At any time, you can check which processes aren't monitored and need to be restarted. Just select Deployment status from the navigation menu, click the All hosts or Recently connected hosts tab, and expand the host you are interested in.