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.
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.

If you've already installed OneAgent

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.

Start installation

To start installing a Cluster ActiveGate

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).

Windows

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.

Linux

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.

WindowsLinux

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.

Customize installation

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:

shell
[root@localhost]# /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.

You've arrived

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.