Follow these steps to install an Environment ActiveGate on Windows.
Before you begin
- 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 9999and 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.
If you've already installed OneAgent In such instances, you must first install the Environment ActiveGate and then download the OneAgent installer. For example, if you download the OneAgent installer and use it to install Dynatrace in a DMZ or network segment that has no internet access and then subsequently install an Environment ActiveGate, you’ll need to download and install OneAgent again to ensure that the installer provides the proper configuration between OneAgent and Environment ActiveGate. This is because OneAgent needs to be automatically configured during installation to connect to your monitored environment and send monitoring data back to the Dynatrace Cluster via your Environment ActiveGate.
Sign in to Dynatrace, select Deploy Dynatrace from the navigation menu and select Install ActiveGate.
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.
- Select the ActiveGate purpose.
- 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.
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
C:\ Dynatrace-ActiveGate-Windows-x86-1.0.0.exe DYNATRACE_ACTIVEGATE_SERVER_CONNECTION_TIMEOUT=200
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.
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 file has the following path:
%PROGRAMDATA% depends on the system and often resolves to
Execute the following command 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