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, DESK enables you to configure a single ActiveGate in support of multiple monitoring environments. This significantly reduces maintenance and setup overhead. Thanks to this feature, you don't need to deploy multiple ActiveGates and adjust firewall settings for each Environment ActiveGate installation. Such multi-environment ActiveGates are capable of handling all traffic from the environments they are associated with.

You can't use an Environment ActiveGate configured for multi-environment support to:

Monitor mainframe with zRemote
Monitor remote technologies with ActiveGate plugins
Execute private synthetic monitors
Run Database Insights

To configure an existing Environment ActiveGate for multi-environment support

Create a file called multitenant.properties that lists each DESK environment you want the Environment ActiveGate to support. Use the following format:

tenant = <tenant1_ID>;<tenant1_token>
tenant = <tenant2_ID>;<tenant2_token>

Note that tenant_ID corresponds to environment ID. For security reasons, you can no longer find the tenant_token in the DESK web UI.

Where can I find the tenant token?

Let's assume an environment called E1 for which you have already installed an Environment ActiveGate, and a second environment called E2, for which you want to use the same Environment ActiveGate. To find the tenant token:

Navigate to the OneAgent installation page of the environment E2 by clicking Deploy DESK > Start installation.
Click Set up PaaS monitoring. Note that there should already be an InstallerDownload token.
Click Show token next to InstallerDownload and then click Copy to copy the token (For example, API_Token).
In your browser, run the following DESK API call.
https://<your url>/api/v1/deployment/installer/agent/connectioninfo?Api-Token=API_Token

where <your url> is your environment ID.

You'll get the API response listing the environemnt ID tenantUUID and the token tenantToken.
```
{
  "tenantUUID" : "E2_ID",
  "tenantToken" : "E2_Token",
  "communicationEndpoints" : [
     "<url>",
     "<url>"
   ]
}
```
Repeat steps 3-7 for the environment E1 or extract the tenantUUID and tenantToken from the already installed Environment ActiveGate by looking into config/instance.properties.

Save the file to the following folder:

on Linux: /var/lib/desk/gateway/config
on Windows: %ProgramData%\desk\gateway\config

Restart the Environment ActiveGate.

Note:

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 DESK ONE product specialist by clicking the chat button in the upper-right corner of the DESK menu bar..