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
launchersubfolder 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:
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. The JVM parameters must be preceded with the
-vmargs flag, just like in the main configuration file.
Note that the main configuration file
dynatracegateway.ini contains a reference that denotes the location of the customizable configuration file
Here are some example entries in the customizable file
# Xmx settings 80% of available RAM + 0 MB -memorylimit.absolute=0 -memorylimit.percentage=80 -vmargs -Dhttps.proxyHost=127.0.0.1 -Dhttps.proxyPort=8080
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: