Install a Cluster ActiveGate

This topic applies to Dynatrace Managed installations only.

Cluster ActiveGate can be installed either on Linux or Windows.

Before you begin

  • If you've set up several monitoring environments:
    It may be cumbersome to install and maintain multiple ActiveGates. Therefore, Dynatrace enables you to configure a single ActiveGate in support of multiple monitoring environments. This significantly reduces maintenance and setup overhead. You don't need to deploy multiple ActiveGates and adjust firewall settings for each Cluster ActiveGate installation. Multi-environment ActiveGates are capable of handling all traffic from the environments they are associated with.

  • Check the hardware and system requirements for ActiveGate.

  • If you've already installed OneAgent:
    Normally it’s fine to install an Cluster ActiveGate at any time following OneAgent installation. In some cases, however, the OneAgent installer must know about your Cluster ActiveGate installation before OneAgent can be installed. In such instances, you must first install the Cluster ActiveGate and then download the OneAgent installer.

    For example, if you download the OneAgent installer and use it to install Dynatrace in a DMZ or network segment that has no internet access and subsequently install Cluster ActiveGate, you’ll need to download and install OneAgent again to ensure that the installer provides the proper configuration between OneAgent and Cluster ActiveGate. This is because OneAgent needs to be automatically configured during installation to connect to your monitored environment and send monitoring data back to the Dynatrace Managed Cluster via your Cluster ActiveGate.

Download the installer

To download the Cluster ActiveGate installer

In the Dynatrace menu, go to Home to enter the Dynatrace Cluster Management Console.

Click the browse [] button and select Add new Cluster ActiveGate.

Click Windows or Linux, depending on your operating system.

You can then choose one of the following ActiveGate purposes:

  • Route traffic: Use your Cluster ActiveGate to route OneAgent, public synthetic, mobile and Real User Monitoring, and REST API traffic.
  • Run synthetic monitors from a private location: Use your Cluster ActiveGate to run synthetic monitors from a private location. A synthetic-enabled ActiveGate is used exclusively to run synthetic monitors. A clean ActiveGate installation set to Synthetic monitoring will disable all other ActiveGate features, including communication with OneAgents.

Depending on the ActiveGate purpose you select, an install parameter is automatically set for the command to run the installer. For example, the option Run synthetic monitors from a private location modifies the command to run the installer with the --enable-synthetic parameter (for Linux installations) or the ENABLE_SYNTHETIC=true parameter (for Windows installations).


Select the purpose of the ActiveGate and click Download installer to download the installer directly to the machine where you want to install the ActiveGate or to another suitable location.


Select the purpose of the ActiveGate, copy the wget command line from the first (Run this command on the target host) text box, and paste it into your terminal window. Make sure you copy the command directly from the cluster page, because the command contains your cluster main address.

Run the installer

An install parameter (determined by the ActiveGate purpose you selected) is automatically set for the command to run the installer. Make sure you use the command displayed in the Dynatrace web UI that reflects the ActiveGate purpose.


Run the executable file using administrator rights and follow the displayed instructions. For a synthetic-enabled Cluster ActiveGate, make sure you use the exact command displayed in the Dynatrace web UI.


You'll need root rights to install a Cluster ActiveGate. You can use su or sudo to run the installation script.

Since ActiveGate version 1.155, the user running the ActiveGate service doesn't require root rights. If you don't specify your own user to run the ActiveGate service, existing or not, the installer will create and use the dtuserag user by default. For more information, see Customize ActiveGate installation

To install ActiveGate, run one of the following commands in the directory where you downloaded the installation script.

  • Ubuntu Server
    [user@ubuntu]# sudo /bin/bash
  • Red Hat Enterprise Linux
    [user@rhel]# su -c '/bin/bash'
  • Other Linux distributions with root session
    [root@host]# /bin/bash

After a few validation steps, ActiveGate is automatically installed and connected to the cluster nodes.

Default installation directories

  • Distribution directory: /opt/dynatrace/gateway_<id>
  • Install/Binaries directory: /opt/dynatrace/gateway
  • TEMP directory: /var/tmp/dynatrace/gateway
  • ActiveGate configuration: /var/lib/dynatrace/gateway/config
  • Log files directory: /var/log/dynatrace/gateway