Install a Cluster ActiveGate
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.
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-syntheticparameter (for Linux installations) or the
ENABLE_SYNTHETIC=trueparameter (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
wgetcommand 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
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
sudo /bin/bash psg-installer.sh
- Red Hat Enterprise Linux
su -c '/bin/bash psg-installer.sh'
- Other Linux distributions with root session
After a few validation steps, ActiveGate is automatically installed and connected to the cluster nodes.
Default installation directories
- Distribution directory:
- Install/Binaries directory:
- TEMP directory:
- ActiveGate configuration:
- Log files directory: