Dynatrace stores ActiveGate configuration settings in the file
config.properties. Upon each upgrade,
config.properties is updated and the existing settings are overwritten (with some exceptions—see below). To avoid losing your settings with each update, use
custom.properties to preserve them. Whenever you need to configure an ActiveGate setting (for example, proxy, port, or memory dump), do this in the
custom.properties file and then restart the ActiveGate.
custom.properties file is preserved during ActiveGate upgrade; it's copied in its entirety from your existing installation to the new one.
Upgrading from versions that don't support custom.properties
This feature is available for Dynatrace versions 135 and higher. In earlier versions, only the
config.properties file is available. If you're upgrading from a version of Dynatrace earlier than 135, then some properties will be automatically transferred from
config.properties in the old installation to
custom.properties in the new installation.
proxy-server proxy-port proxy-scheme proxy-user proxy-password proxy-password-encr use_aws_proxy_role port-ssl dnsEntryPoint ec2InternalDomain ignoreClusterRuntimeInfo dumpDir maxSizeGb maxAgeDays maxConcurrentUploads AWSAgentEnabled DumpSupported
For more information on ActiveGate properties, see How to configure an ActiveGate
If the settings you want to preserve won't be transferred automatically
- Copy and paste the settings from
config.propertiesto a safe location.
- Following the update, insert the copied settings into the appropriate section of the
config.properties. If no relevant section exists, create a section with the appropriate name (section names are enclosed in brackets, for example
Keep in mind that
custom.properties takes precedence over
config.properties. Therefore, if a setting occurs in both files, the value of the setting in the
custom.properties file will take precedence. Also, command line settings (if any) take precedence over those stored in