Install Dynatrace ActiveGate environment on CentOS | Ubuntu

You can download this article in PDF format via the link below to support us.
Download the guide in PDF formatshut down

Dynatrace is a software solution for intelligently monitoring the complexity of enterprise clouds and accelerating digital transformation. By using Dynatrace AI causality engine and full automation, Dynatrace can provide you with deep insights about application performance, its infrastructure, and end user experience.

Dynatrace was created to seamlessly integrate infrastructure and cloud, application performance and digital experience monitoring into an all-in-one automation solution powered by artificial intelligence. The following are the key monitoring functions provided by the Dynatrace solution:

  • Mobile application monitoring
  • Real user monitoring
  • Server-side service monitoring
  • Network, process and host monitoring
  • Container monitoring
  • Root Cause Analysis
  • Cloud and virtual machine monitoring

Standard infrastructure monitoring using Dynatrace involves the setup of a client tool called OneAgent. This agent collects and unifies all operational and business performance indicators of all types of entities in your environment. This can be applications, servers, databases, and many other services deployed across every layer of the technology stack (including containers).

So what is Dynatrace ActiveGate?

ActiveGate acts as an agent between Dynatrace OneAgent and Dynatrace cluster. ActiveGate has three main purposes:

The most common use cases are:

  • Data routing and network path management between OneAgent and Dynatrace cluster
  • Remote monitoring (via API) AWS, Azure, GCP service, CloudFoundry and Kubernetes stack, VMware engine and IBM Z mainframe
  • Dedicated location for comprehensive monitoring
  • Hosted and local execution of many remote monitoring extensions listed in Dynatrace Hub

The target use case of my deployment is to route OneAgent traffic to Dynatrace. When I plan to use Dynatrace to monitor the Kubernetes/OpenShift cluster environment, ActiveGate will be responsible for data routing and network path management between OneAgent and Dynatrace clusters.

Dynatrace ActiveGate environment installation

The following are the minimum hardware requirements for installing ActiveGate:

  • 2 GB free disk space
  • 2 GB RAM (4 GB recommended)
  • 1 dual-core processor

If the server requirements are met, proceed to the following installation steps.

Step 1: Log in to Dynatrace

The first step is to log in to Dynatrace.Install Dynatrace Active Door 01

Step 2: Install Dynatrace ActiveGate environment on CentOS | Ubuntu

Then navigate to management > Deploy Dynatrace:Install Dynatrace Active Door 02

On the next screen, select “Install ActiveGate“.Install Dynatrace Active Door 03

select”Linux“As the installation platform of ActiveGate:Install Dynatrace Active Door 04

Select the purpose of ActiveGate installation:Install Dynatrace Active Door 05

Run the command shown in the target host to download the installer, and then you can verify the signature.

Then run the installer with root privileges.

chmod +x
sudo ./

Wait for the installation process to complete:

17/03 17:48:41 Dynatrace ActiveGate installer version, build date 04.03.2021
17/03 17:48:41 Detected init system: 'systemd'
17/03 17:48:41 Checking for previous Ruxit Gateway installations, verifying target installation folder...
17/03 17:48:41 Checking for previous Dynatrace ActiveGate installations, verifying target installation folder...
17/03 17:48:41 Previous Dynatrace Gateway installation NOT detected as a running process.
17/03 17:48:41 No information on previous installation folders found in /etc/init.d.
17/03 17:48:41 Verifying system compatibility...
17/03 17:48:41 Checking system security limits.
17/03 17:48:41 Hard limit of the "Maximum number of open file descriptors" will be set to 500000 for Dynatrace Gateway service
17/03 17:48:41 Remote Plugin Module will be installed by default
17/03 17:48:41 Remote Plugin Modules capability: active
17/03 17:48:41 Additional capabilities will be installed, if newer versions are available on the server.
17/03 17:48:41 Creating user: dtuserag
17/03 17:48:42 Checking access rights to folders...
17/03 17:48:42 Using custom Dynatrace Gateway user: dtuserag:dtuserag
17/03 17:48:42 Installing...
17/03 17:48:47 Installation unpacked successfully

After successful installation, the output is similar to the following shared output:

17/03 17:49:48 Package is being installed. Please wait...
        17:49:51 Starting Dynatrace Remote Module...
        17:49:51 oneagentremoteplugin service started
        17:49:51 Checking if remotepluginmodule is connected to server...
        17:49:53 remotepluginmodule connection status: connected to
        17:49:53 remotepluginmodule connected to server.
17/03 17:49:53 Installation of package finished successfully.
17/03 17:49:53
17/03 17:49:53
17/03 17:49:53 --------------------------------------------------------------
17/03 17:49:53
17/03 17:49:53 Capabilities(s) installed successfully:
17/03 17:49:53 Removing old installation log files...
17/03 17:49:53 Installation finished successfully.

ActiveGate listens to traffic from OneAgent on the port 9999.

$ grep port /var/lib/dynatrace/gateway/config/
port-ssl = 9999
port = 9998 #HTTP connection port

Custom parameter setting file:

$ sudo vim /var/lib/dynatrace/gateway/config/

in”Deployment status“>”Active gateInstall Dynatrace Active Door 06

You can customize the ActiveGate directory by specifying the following installation parameters during ActiveGate installation:

  • INSTALL -Executable files, libraries and related files; default /opt/dynatrace
  • CONFIG -Configuration file; default /var/lib/dynatrace
  • LOG -Log file; default /var/log/dynatrace
  • TEMP -Temporary files; default /var/tmp/dynatrace
  • PACKAGES_DIR -Installation package for ActiveGate upgrade or additional functions; default /var/lib/dynatrace/packages

Restart the service for any changes:

sudo systemctl restart dynatracegateway.service


You can download this article in PDF format via the link below to support us.
Download the guide in PDF formatshut down

Related Posts