Try it free

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

Decide on the purpose of the ActiveGate, and then review the corresponding requirements:

  • Route OneAgent traffic—see routing/monitoring requirements.
  • Run Synthetic monitors from a private location—Synthetic-enabled ActiveGates support a subset of operating systems and have higher hardware and system requirements than routing ActiveGates.

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 OneAgent can reach Dynatrace only through this Cluster ActiveGate, such as in a network segment without internet access, install the Cluster ActiveGate before you install OneAgent.

Step 2 Download and run the installer

  1. Sign 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 Download installer to download the installer to the target machine.

    Copy the wget command from the Run this command on the target host field, and paste it into your terminal. Copy the command directly from your Managed Cluster, because it contains the main address of the Managed Cluster.

  5. Run the installer on the target host. Use the command that the Cluster Management Console displays for the ActiveGate purpose you selected, because only that command sets the installer parameter for the purpose.

    To customize the installation, append parameters to the installation command before you run it. For example, to turn off the self-monitoring OneAgent:

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

    Linux only

    ActiveGate version 1.315+

    To install the Cluster ActiveGate in FIPS-compliant mode, see FIPS-compliant mode for prerequisites and setup instructions. For default directories and other defaults, see ActiveGate default settings for Linux.

    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.

    Copy the installation script command from the Run the installer script with root rights step and run it in your terminal.

  6. Verify the installation: select Show deployment status and go to the Dynatrace ActiveGates tab. After the Cluster ActiveGate connects to Dynatrace, installation is complete, and every OneAgent that can reach Dynatrace receives the Cluster ActiveGate as an endpoint. For troubleshooting, see Troubleshoot ActiveGate.

  7. If you installed OneAgent before this Cluster ActiveGate, and OneAgent can reach Dynatrace only through it, reinstall OneAgent. Download the OneAgent installer again, so that it includes the Cluster ActiveGate.