Configure ActiveGate launcher

ActiveGate launcher is a watchdog process that starts a virtual machine for your ActiveGates. The customizable ActiveGate launcher configuration file is enabled as of ActiveGate version 1.154.

The launcher configuration is separate from the ActiveGate configuration. It's stored in two configuration files:

  • dynatracegateway.ini, the main configuration file. On Linux, this file is located in the launcher subfolder of the installation directory. On Windows, it's stored directly in the installation folder.

  • launcheruserconfig.conf, which includes a customizable configuration and is stored in the ActiveGate configuration folder:

    On Linux: /var/lib/dynatrace/gateway/config/launcheruserconfig.conf
    On Windows: %PROGRAMDATA%\dynatrace\gateway\config\launcheruserconfig.conf

You should not modify the main configuration file dynatracegateway.ini, as this file won't be preserved during upgrades. Note that the main configuration file dynatracegateway.ini contains a reference that denotes the location of the customizable configuration file launcheruserconfig.conf.

The following modifications to launcheruserconfig.conf are preserved during upgrades:

  • Memory limit settings (-memorylimit.absolute and -memorylimit.percentage)
  • JVM settings (settings beginning with -D)
  • Port range settings (settings begining with -portrange=)

Here are some example entries in the customizable file launcheruserconfig.conf:

All lines after -vmargs are passed as arguments to the JVM, so you must specify all arguments and options for ActiveGates after the -vmargs flag:


# Xmx settings 80% of available RAM + 0 MB

By default, the ActiveGate launcher will utilize ports above 50000. Certain deployments may require you to configure a different port. To specify the port range that the ActiveGate launcher should use, add or modify the -portrange property in the launcheruserconfig.conf file. For example: