Configure ActiveGate launcher

ActiveGate launcher is a watchdog process that starts a virtual machine for your ActiveGates. The customizable ActiveGate launcher config 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 (i.e., on Linux: /var/lib/dynatrace/gateway/config/launcheruserconfig.conf and on Windows C:\ProgramData\dynatrace\gateway\config\launcheruserconfig.conf).

Note that you should not modify the main configuration file dynatracegateway.ini, as this file won't be preserved during upgrades. In contrast to dynatracegateway.ini, modifications to launcheruserconfig.conf are preserved during upgrades. Any settings specified in the dynatracegateway.ini file can be overridden by specifying them again in launcheruserconfig.conf—in particular the Xmx JVM memory settings for ActiveGate. Note that the main configuration file dynatracegateway.ini contains a reference that denotes the location of the customizable configuration file launcheruserconfig.conf.

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

# Xmx settings 80% of available RAM + 0 MB
-memorylimit.absolute=0
-memorylimit.percentage=80