Install an Environment ActiveGate

Follow these steps to install an Environment ActiveGate.

Before you begin

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

optional You can add a proxy certificate. If you use a proxy that performs SSL termination, add a proxy certificate to the ActiveGate trusted keystore file trusted.jks.
The trusted.jks file has the following path:

  • For Windows:
    %PROGRAMDATA%\dynatrace\gateway\ssl\customkeys\trusted.jks,
    where
    %PROGRAMDATA% depends on the system and often resolves to C:\ProgramData\. For example:
    C:\ProgramData\dynatrace\gateway\ssl\customkeys\trusted.jks
  • For Linux:
    [CONFIG]/gateway/ssl/customkeys/trusted.jks,
    where
    [CONFIG] is the top-level ActiveGate configuration directory, /var/lib/dynatrace by default. For example:
    /var/lib/dynatrace/gateway/ssl/customkeys/trusted.jks

Execute the following command—for linux or Windows—in the folder where trusted.jks resides (or provide a path to trusted.jks):

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.