How do I preserve my configured settings during Security Gateway upgrades?

Dynatrace stores Security Gateway configuration settings in 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 upgrade, use custom.properties. Whenever you need to configure a Security Gateway setting (for example, proxy, port, or memory dumps), do this in the custom.properties file and then simply restart Security Gateway.

The custom.properties file is preserved during Security Gateway upgrade; it's copied in its entirety from your existing installation to the new one.

Upgrading from versions not supporting custom.properties

This feature is available for versions 135 and higher. In earlier versions, only the config.properties file exists. 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.

If the settings you want to preserve won't be transferred automatically

  1. Copy the settings from config.properties to a safe place.
  2. Following the upgrade, insert the copied settings into the appropriate section of the custom.properties file, not config.properties. If no relevant section exists, create a section with the appropriate name (section names are enclosed in brackets, for example [http.client]).

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 custom.properties.