Configure an Environment ActiveGate for multi-environment support

If you've set up several monitoring environments, it may be cumbersome to install and maintain multiple ActiveGates. Therefore, Dynatrace enables you to configure a single ActiveGate in support of multiple monitoring environments. Such an ActiveGate is referred to as a multi-environment ActiveGate.

This kind of configuration significantly reduces maintenance and setup overhead. Thanks to this feature, you don't need to deploy multiple ActiveGates and don't need to adjust firewall settings for each additional Environment ActiveGate. Multi-environment ActiveGates are capable of handling all traffic from all the environments they are associated with.

You cannot use an Environment ActiveGate configured for multi-environment support to:

All other ActiveGate features are supported.

To configure an existing Environment ActiveGate for multi-environment support:

In the ActiveGate configuration directory, locate the authorization.properties file.

Familiarize yourself with the content of the authorization.properties file.
The file lists information for each environment, identified by the environment ID: tenantToken and optionally authorization properties.
One and only one of the sections will contain the property mainTenant = true. This is for the environment from which the ActiveGate was downloaded and installed. Do not remove this section or this entry. Do not remove any other sections—relating to other environments—unless you do not want the ActiveGate to support those particular environments any more.

Format of the entries in authorization.properties:

[<environment_ID>]  
tenantToken = <tenant_token>  
mainTenant = true     # identifies environment from which the ActiveGate was downloaded  
authToken = <authorization_token>     # present, if required

For example:

[mySampleEnv]
tenantToken = abcdevjhij1234567890
authToken = dt0g01.HVMTLRLZ.1234567890ZYXWVUTSRQPONMLKJIHGFEDCBA01234567890ABCDEFGHIGKLMNOPQ
mainTenant = true

Note
For security reasons, you can no longer find the <tenant_token> in the Dynatrace web UI.

To add more environments, add new sections to the authorization.properties file: list each Dynatrace environment you want the Environment ActiveGate to support. Use the following format:

[<environment_ID>]  
tenantToken = <tenant_token>

[<environment_ID>]  
tenantToken = <tenant_token>

For example:

[mySampleEnv]
tenantToken = abcdevjhij1234567890

[myAnotherEnv]
tenantToken = 0987654321jijvedcba

Save the authorization.properties file.

Verify that the new environments have been added successfully.
The ActiveGate log file should contain the entry listing the number of environments that the ActiveGate is working with, for example:

Working mode is set to MULTITENANT with 5 tenant(s).

If the log message does not list the number of environments that you have attempted to configure, scan the log file for entries indicating an error in the authorization.properties file. Error messages appear in this form:

Error during parsing config file `...\conf\authorization.properties` - invalid configuration: ...
Troubleshooting

All environments that are to be supported by the same Environment ActiveGate must run on the same cluster. Therefore, if your Environment ActiveGate configuration for multiple environments fails, please contact a Dynatrace ONE product specialist by clicking the chat button in the upper-right corner of the Dynatrace menu bar.