Install a Cluster ActiveGate

  • How-to guide
  • 4-min read

To install a Cluster ActiveGate on Linux or Windows, follow the steps below.

Step 1

Review requirements

Step 2

Download installer

Step 3

Run installer

Step 4

Finalize

Step 1 Review requirements

Before you install, decide on the purpose of the ActiveGate and review the corresponding requirements:

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.

Step 2 Download installer

  1. Log in to the Cluster Management Console.

  2. Go to Home, select the browse […] button, and choose Add new Cluster ActiveGate.

  3. Select Windows or Linux, depending on your operating system, and choose a purpose:

    • Route traffic — routes OneAgent, public synthetic, mobile, Real User Monitoring, and REST API traffic.
    • Run synthetic monitors from a private location — runs synthetic monitors exclusively. Installing ActiveGate with this purpose disables all other ActiveGate features, including communication with OneAgents.

    The selected purpose automatically sets the corresponding installer parameter (--enable-synthetic on Linux, ENABLE_SYNTHETIC=true on Windows).

  4. Download or copy the installer command for your platform.

    Select the ActiveGate purpose and select Download installer to download it to the target machine.

Step 3 Run 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. If your 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.

Customize installation

You can append additional parameters to the installation command. For example, to disable the self-monitoring OneAgent:

[root@localhost]# /bin/bash Dynatrace-ActiveGate-Linux-x86-1.0.0.sh --install-agent off

Federal Information Processing Standard (FIPS) compliance

Linux only

ActiveGate version 1.315+

To install Cluster ActiveGate in FIPS-compliant mode, see FIPS-compliant mode for prerequisites and setup instructions.

Default installation settings

For default directories and other defaults, see ActiveGate default settings for Linux.

Step 4 Finalize

After the Cluster ActiveGate connects to Dynatrace, installation is complete and OneAgent is reconfigured to send monitoring data through the Cluster ActiveGate.

  • To verify the installation, select Show deployment status and go to the Dynatrace ActiveGates tab.
  • For troubleshooting, see Troubleshoot ActiveGate.