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.

Before you begin

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:

    • Windows installer (EXE file) for single-server installation. This is the most commonly used file for Windows deployments. Just 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. Then click the Download MSI package link on the following page.

    • Linux shell script installer. Use this installation approach on any Linux system that's supported by Dynatrace, regardless of the packaging system your distribution depends on. Click the Linux button. Then copy the command that's provided in the Use this command on the target host text field and paste the command into your terminal. Once the download is complete, you can verify the signature by copying the command from the Verify signature text field and pasting the command into your terminal window. Make sure your system is up to date, especially SSL and related certificate libraries. If you plan to download Dynatrace OneAgent directly to a server, note that outdated or missing libraries (for example, CA certificates or OpenSSL) will prevent the installer from downloading (we use encrypted connections. OpenSSL is required to enable wget to access the server). You can also download the installer by clicking the Download OneAgent installer link and saving the installer script to any location you want (bypassing the wget command altogether).

Step 2: Install OneAgent

For Windows, run the executable file and follow the displayed instructions. You will need administrator rights to install OneAgent.

Note

On Windows, Dynatrace OneAgent runs as a system process.

For Linux, copy the command from the And run the installer with root rights text field and paste the command into your terminal. Note that you’ll need root privileges. You’ll need to make the script executable before you can run it. You can use su or sudo to run the installation script. To do this, type one of the following commands into the directory where you downloaded the installation script.

Note

On Linux, Dynatrace OneAgent runs as root.

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).

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.

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.