How do I install Dynatrace OneAgent?

To install Dynatrace OneAgent go to Dynatrace.com and Login using the username and password you received from Dynatrace in your signup confirmation email. The basic installation steps are simple. Still, we'll guide you each step of the way.

What you need

  • Your Dynatrace password for login.
  • Administrator credentials for the servers where Dynatrace OneAgent will be installed.
  • Administrator rights for changing firewall settings (necessary only if your internal routing policy may prevent Dynatrace software from reaching the Internet).
  • Permissions and credentials required for restarting all your application services.

Note: All hosts that are to be monitored require full Internet access.

Step 1: Download the installer

  1. Select Deploy Dynatrace from the navigation menu.

  2. Click the Start installation button.

  3. Select one of the following installation options:

You have two options:

  • Windows installer (EXE file) for single-server installation. This is the most commonly used file for Windows deployments. Click the Windows button, then click the Download agent.exe button on the following page.

  • Windows installer for Group Policy deployments. You get a ZIP package that includes an MSI file and an example command line in the form of a batch file (you can copy and paste the command line when configuring Group Policy for Dynatrace installation). For the group policy option, click the Windows button. On the Download Dynatrace OneAgent for Windows page, click the Download MSI package link.

If installing OneAgent with Elastic Beanstalk, continue with Create a configuration to install Dynatrace OneAgent

Step 2: Install OneAgent

Run the executable file and follow the displayed instructions. You will need administrator rights to install OneAgent.

During installation, either enable or disable the following two settings:

Note:
On Windows, Dynatrace OneAgent runs as a system process.

During the installation process, the installer

  • Checks the system’s global proxy settings. If your system has global proxy settings, OneAgent will discover them and prompt you for permission to use them. If a proxy is required for an Internet connection, but it’s not configured in the system’s global proxy settings, then you must configure the proxy.

  • Checks for a connection to Dynatrace Server or Security Gateway (if you installed Security Gateway and downloaded the OneAgent installer after Security Gateway was connected to Dynatrace).

  • Creates its own user (dtuser). This user is utilized by services that don’t require root privileges. 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 dtuser is not allowed to:
    • Access computer from the network.
    • Log in as a batch job.
    • Log in locally.
    • Log in through Remote Desktop Services.

The dtuser is required for Dynatrace to operate properly, therefore you must not delete it. If, for some reason, the dtuser was deleted, next update will recreate it.

Note:
It’s recommended that you install the version of WinPcap that is packaged with the Dynatrace 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 Dynatrace 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.

Note:
To find the white list of the IP addresses that can be used for communication with Dynatrace SaaS environments:

  1. In the navigation menu, select Deploy Dynatrace.
  2. Click Start installation and then your operating system. The list appears at the end of this page.

Step 3: Restart your server processes

While still logged into the systems where your server processes run, you need to restart each process so that its command line can be modified. The processes that require restart are listed for you during setup.

To restart your server processes, you’ll need to restart your web or application server. If your server is operating in a production environment, you may want to hold off on restart until the next scheduled maintenance period.

Note

When you visit certain Host pages, Dynatrace may display a message telling you that you must restart the related host processes. Restart these processes to enable Dynatrace analysis of these hosts.

You can always check which process types Dynatrace supports.

You've arrived!

Great, the first stage of Dynatrace setup is complete! Now take a look around your new home dashboard. You can access your new Dynatrace home dashboard anytime by going to Dynatrace website and clicking the Login button in the upper-right corner.