Configurable properties of Dynatrace Managed

The configurable Dynatrace Managed properties are stored in the /server/conf/config.properties file, but do not edit them in that file. It is overwritten during an update.

Important

If you configure properties directly in /server/conf/config.properties, your custom configuration won't be preserved during an update.

Instead of editing /server/conf/config.properties, make all your edits in the custom.settings file located in the /opt/dynatrace-managed/installer directory of each cluster node. You can create the file if it doesn't already exist. During an upgrade, the installer reads custom.settings and modifies config.properties accordingly.

The custom.settings file specifies:

  • The location of the file to be modified
  • The section to modify
  • The property and value to be set

Example custom.settings edits

Suppose you have made two modifications to settings:

  • Set the connection-timeout property to 3000000
  • Set the proxy-off property to true

To preserve these settings during upgrade:

Open the custom.settings file for editing.

  • File location: /opt/dynatrace-managed/installer directory of the cluster node.
  • Create the file in that location if it does not already exist.

Add one line to specify the configuration file to modify during the install.

<server/conf/config.properties>

Be sure to include the chevrons (< and >).

Add two lines to specify the section, property name, and property value to be modified for connection-timeout, which is in the [settings] section.

[settings]  
connection-timeout=3000000

Add two lines to specify the section, property name, and property value to be modified for proxy-off, which is in the [http.client.external] section.

[http.client.external]  
proxy-off = true

The resulting custom.settings file for this example should now look like this:

<server/conf/config.properties>
[settings]
connection-timeout=3000000
[http.client.external]
proxy-off = true

With this custom.settings file placed on all of the cluster nodes in the /opt/dynatrace-managed/installer directory, every time you upgrade the node the installer will set connection-timeout to 3000000 and proxy-off to true in the config.properties, thus preserving your custom configuration.

Applies to service restarts

Dynatrace Managed also executes this custom configuration action with each restart of the Dynatrace service.

Section: [com.compuware.apm.webserver]

Property Default value Description
port‑ssl 8021 The port where Dynatrace Server listens for traffic from OneAgent.
ssl‑protocols TLSv1.2 Supported SSL protocols. Can be one or a list of the following values: TLSv1, TLSv1.1, TLSv1.2
excluded‑ciphers unset List of additionally excluded ciphers (ciphers are defined by a substring matching at least a part of the cipher name, for example _DHE_)