How to install a Cluster ActiveGate

This topic applies to Dynatrace Managed installations only.

Cluster ActiveGate can be installed either on Linux or Windows.

Before you begin

Please check the hardware and system requirements for ActiveGate.

Download the installer

Downloading the installer is easy—just follow the steps below.

  1. Log into your Dynatrace Server and select Home from the navigation menu to enter the Dynatrace Cluster Management Console.

  2. Click the browse [...] button and select Add new Cluster ActiveGate.

  3. Choose the operating system on which you would like to install the Cluster ActiveGate.

  4. Select the purpose of the ActiveGate. You can choose from the following purposes:

  • Route traffic: Routes OneAgent 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. The clean ActiveGate installation set to Synthetic monitoring will disable all other ActiveGate features, including communication with OneAgents.
  1. Download the installer. For Windows, click Download the installer. For Linux, copy the wget command line and paste it into your terminal window. Make sure to copy the command directly from the cluster page because the command contains your cluster master address.

Run the installer

You'll need root rights to install a Cluster ActiveGate. You can use su or sudo to run the installation script.

Since version 1.155, the user running the ActiveGate service doesn't require root rights. If you don't specify your own user to run the ActiveGate service, existing or not, the installer by default creates the dtuserag user. For more information see Customize ActiveGate installation on Linux

To install ActiveGate, type one of the following commands into the directory where you downloaded the installation script.

  • If you’re on an Ubuntu Server:
    sudo /bin/bash
  • If you’re using Red Hat Enterprise Linux:
    su -c '/bin/bash'
  • If you start a root session:

After a few validation steps, ActiveGate is automatically installed and connected to the cluster nodes.

What are the default settings?

  • Distribution path: /opt/dynatrace/gateway_<id>
  • Dynatrace Server data files: /var/opt/dynatrace-managed
  • Cluster ActiveGate configuration: /var/lib/dynatrace/gateway/config
  • Log files directory: /var/log/dynatrace/gateway

What happens during installation?

The installer also optimizes operating system settings:

  • Swap is turned off (using swapoff).
  • iptables "PREROUTING " rules are enhanced to enable communication forwarding to Dynatrace Server (HTTPS to port 8021). To see the exact rules, type iptables -L -vt nat in your terminal.
  • readahead page cache is set to 512.
  • Limits for users are changed globally (unlimited locked-in-memory address space, unlimited address space, increased limit for number of processes and open files).
    See /etc/security/limits.conf for details.
  • max_map_count is modified.