Install an Environment ActiveGate on Windows

Follow these steps to install an Environment ActiveGate on Windows.

Before you begin

Decide what your ActiveGate purpose will be and review the respective hardware and system requirements. ActiveGates have different hardware and system requirements depending on the purpose for which they are installed:

Ensure that your firewall settings allow communication to Dynatrace. ActiveGate normally 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.

On the Install Environment ActiveGate page, select Windows.

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. Provide a PaaS token. This token is required to download the ActiveGate installer from your environment. If you don't have a PaaS token, you can create one right in the UI. The token is automatically appended to the download and installation commands you'll use later.
  3. Download the installer. There are two options:
    • Select Download installer to download the Windows installer (EXE file).
    • Download via Windows Command Prompt. Copy and run the command. Note: this command will only work with PowerShell 3.0 and TLS 1.2 (or .later)

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.

Customize installation

You can add additional parameters to the installation command to customize your installation. For example, to install Environment ActiveGate in a different directory, use the INSTALL=<path> parameter:

C:\ Dynatrace-ActiveGate-Windows-x86-1.0.0.exe INSTALL=D:\hosted_app\dynatrace

Default installation settings

For installation defaults, including default directories, see ActiveGate default settings for Windows.

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.