This topic applies to Dynatrace Managed installations only.
Follow these steps to install a Cluster ActiveGate on Linux or Windows.
Decide what your ActiveGate purpose will be and review the respective hardware and system requirements. ActiveGates have different hardware and system requirements depending on the purpose for which they are installed:
In most cases, you can install an ActiveGate at any time following OneAgent installation. In some cases, however, the installation order matters, because the OneAgent installer needs to know about your ActiveGate installation before the OneAgent can be installed.
In such instances, first install the 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 then subsequently install an ActiveGate, you’ll need to download and install OneAgent again to ensure that the installer provides the proper configuration between OneAgent and 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 Cluster via your ActiveGate.
To start installing a Cluster ActiveGate
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:
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.
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 installer on the target host or, if your ActiveGate purpose is Run synthetic monitors from a private location, copy the installation script command from the Run the installer via Command Prompt step and paste it into your terminal.
You can add additional parameters to the installation command to customize your installation. For example, to disable installation of self-monitoring OneAgent, use the --install-agent <on|off>
parameter:
[root@localhost]# /bin/bash Dynatrace-ActiveGate-Linux-x86-1.0.0.sh --install-agent off
For installation defaults, including default directories, see ActiveGate default settings for Linux.
After the Cluster ActiveGate connects to Dynatrace, installation is complete and OneAgent is reconfigured to send monitoring data through the Cluster ActiveGate.