Install a Cluster ActiveGate
This topic applies to Dynatrace Managed installations only.
Follow these steps to install a Cluster ActiveGate on Linux or Windows.
Before you begin
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:
- Purpose: Route OneAgent traffic to Dynatrace, monitor cloud environments, or monitor remote technologies with extensions.
Hardware and system requirements for routing/monitoring ActiveGates.
- Purpose: Run Synthetic monitors from a private location
Synthetic-enabled ActiveGates support a subset of operating systems and are more demanding in terms of hardware and system requirements than are ActiveGates that are used for routing and monitoring.
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
- In the Dynatrace Cluster Management Console, go to Home.
- From the menu in the upper-right corner, select Add new Cluster ActiveGate.
- Select the target operating system: Windows or Linux.
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 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.
Copy the installation script command from the Run the installer script with root rights step and execute it in 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:
/bin/bash Dynatrace-ActiveGate-Linux-x86-1.0.0.sh --install-agent off
Default installation settings
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.
- To check the status of the installation, select Show deployment status and switch to the Dynatrace ActiveGates tab.
- For troubleshooting help, see Troubleshoot ActiveGate.