Install an Environment ActiveGate

Follow these steps to install an Environment ActiveGate.

Before you begin

  • Check the hardware and system requirements for ActiveGate.

  • If you plan to use the ActiveGate for a private synthetic location, see System and hardware requirements for private synthetic locations.

  • Decide what will be your ActiveGate purpose. You can use your ActiveGate for one of the following purposes:

  • Ensure that your firewall settings allow communication to Dynatrace. Environment ActiveGate listens (accepts incoming connections) on port 9999 and talks to Dynatrace (makes outgoing connections) on port 443. For more information, see Which network ports does ActiveGate use?.

  • Normally it’s fine to install an Environment ActiveGate at any time following OneAgent installation. In some cases, however, the OneAgent installer must know about your Environment ActiveGate installation before OneAgent can be installed.

Start installation

Sign in to Dynatrace, select Deploy Dynatrace from the navigation menu and select Install ActiveGate.

How you download and install an Environment ActiveGate depends on the operating system platform. Select Windows or Linux.

Download the installer

How you download your installer depends on your setup and needs. You can choose to download an installer directly to the server where you plan to install Environment ActiveGate or you can download an installer to a different machine and then transfer the installer to the server.

  1. Select the ActiveGate purpose.
  2. Click Download installer.

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.

You need administrator rights to install Environment ActiveGate. Run the executable file using administrator rights and follow the displayed instructions.

Environment ActiveGate can use an HTTP proxy server address. You can enter this address in one of the installer steps.

Customizing installation

You can add additional parameters to the installation command to customize your installation. For example, to define the maximum length of time (in seconds) the installer will wait for a connection to the server, you can use the DYNATRACE_ACTIVEGATE_SERVER_CONNECTION_TIMEOUT=<seconds> parameter:

C:\ Dynatrace-ActiveGate-Windows-x86-1.0.0.exe DYNATRACE_ACTIVEGATE_SERVER_CONNECTION_TIMEOUT=200

You've arrived

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

To check the status of the installation, click Show deployment status and select the Dynatrace ActiveGates tab.

You can also check the Troubleshoot ActiveGate page for solutions to problems related to ActiveGate.

Proxy certificate

Optionally, you can add a proxy certificate. If you use a proxy that performs SSL termination, add a proxy certificate to the trusted keystore (trusted.jks).
In a standard installation, the trusted.jks file is in one of the following folders:

  • For Windows: JAVA_HOME\JRE\lib\security\cacert
  • For Linux: /var/lib/dynatrace/gateway/ssl/customkeys/

Execute the following command (Linux or Windows):

keytool -importcert -file /path/to/your/SSLcert.cer -keystore trusted.jks

When prompted, provide the trusted keystore password. You can find the password in the ActiveGate config.properties file.