Install OneAgent on Linux

This page describes how to download and install Dynatrace OneAgent on Linux.

Then continue with the installation steps provided below.

Requirements

  • You need administrator rights for the servers where Dynatrace OneAgent will be installed and 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 the disk space requirements.
  • The host on which you install OneAgent needs at least 300 MB RAM.
  • There are certain limitations when deploying OneAgent on a Linux host with mounted NFS drives. See Troubleshoot OneAgent installation.
  • All hosts that are to be monitored need to be able to send data to the Dynatrace cluster. Depending on whether your Dynatrace environment is a SaaS or a Managed deployment, and depending on your network layout and security settings, you can choose to either provide direct access to the Dynatrace cluster, or you can set up an ActiveGate.

Installation

Select Deploy Dynatrace from the navigation menu.

Select Start installation and choose Linux.

Choose the installer type from the list. Use the Linux shell script installer on any Linux system that's supported by Dynatrace, regardless of the packaging system your distribution depends on.

Copy the command provided in the Use this command on the target host text field.

Paste the command into your terminal window and execute it.

After the download is complete, verify the signature:

  • Copy the command from the Verify signature text field.
  • Paste the command into your terminal window and execute it. Make sure your system is up to date, especially SSL and related certificate libraries.

Copy the command provided in the And run the installer with root rights text field.

If your environment is segmented (for example, into development and production), consider organizing your hosts into host groups.

Paste the command into your terminal window and execute it. Note that you’ll need root access. 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.

Notes:

  • If you plan to download Dynatrace OneAgent directly to a server, note that outdated or missing libraries (for example, CA certificates or OpenSSL) prevent the installer from downloading.
  • Dynatrace uses encrypted connections. OpenSSL is required to enable wget to access the server. You can also download the installer by clicking Download OneAgent installer in the page footer and saving the installer script to any location you want, which bypasses the wget command altogether.

You've arrived!

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.

home dashboard

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.