Install OneAgent on a server

  • Latest Dynatrace
  • 3-min read

Follow this guide to install Dynatrace OneAgent for the first time.

Once you've followed this guide, you'll have OneAgent installed on a host and can use Dynatrace to monitor that host and its processes.

The information on this page applies to AIX, Linux, and Windows.

For OS-specific information on OneAgent installation and advanced operation, select your OS for the detailed instructions.

Prerequisites

Before you begin, make sure you have:

  • A Dynatrace environment.
  • Administrator access to a Linux, Windows, or AIX host (that doesn't have any existing OneAgent installations).
  • A network that supports SSL communication.

OneAgent setup

To download and install OneAgent on a host:

  1. Go to Discovery & Coverage Discovery & Coverage and select Install > Install OneAgent.

  2. Enter or select the following parameters (see the screenshot below for an example).

    • OS type

      Choose Linux, Windows, or AIX according to your host's operating system.

    • Architecture

      Linux only Select one of the available options from the list.

    • Monitoring mode

      Options are Full-Stack, Infrastructure, or Discovery. If you are using a free Dynatrace trial, select Full-Stack to see everything that Dynatrace is capable of observing. You can always change the monitoring mode after installation.

    • For Optional parameters, you can add a Custom host name for easier identification.

      The rest of the parameters are out of scope for this guide.

    OneAgent setup parameters
    OneAgent setup parameters

  3. Select Generate token to generate an API token that lets your Dynatrace environment access OneAgent. Copy the token and save it somewhere safe, because you won't be able to access it again. You don't need to do anything else with this token right now.

  4. Download OneAgent. Either use the provided CLI command or select Download.

  5. Verify the signature. Linux and AIX only Use the provided CLI command.

  6. Install OneAgent. Either use the provided CLI command or run the executable by selecting it in the GUI. Follow the installer steps.

    If you install via the GUI, we recommend adding the following options in the Optional: advanced command-line settings screen: --set-monitoring-mode=fullstack --set-app-log-content-access=true

  7. When the installer shows a Congratulations! Dynatrace OneAgent was successfully installed! message, OneAgent is installed on the host. Select Finish to exit the installer.

  8. Because OneAgent can't inject itself into running processes, restart all processes you want OneAgent to monitor.

  9. To confirm that OneAgent is monitoring your host, open Dynatrace and go to Infrastructure & Operations Infrastructure & Operations > Hosts. If everything is working as expected, you'll see the name of your host in the Hosts table.

    Infrastructure & Operations view of a newly added OneAgent on host
    Infrastructure & Operations view of a newly added OneAgent on host

OneAgent is now set up and monitoring your host. See Get started with Dynatrace to continue your first journey with Dynatrace.