Optional Tosca Distributed Execution Monitor configurations

You can configure the behavior of the Tosca Distributed Execution (DEX) Monitor:

• Change the synchronization interval between DEX Monitor and Tosca Distribution (DEX) Server.

• Change how many finished TestEvents the DEX Monitor displays.

• Enable user authentication to access the DEX Monitor.

• Set up a custom DEX Monitor port.

• Update the Consul and Ocelot configuration files.

Change synchronization interval

By default, the DEX Monitor queries the DEX Server every 20 seconds for information. You can define a different interval on the machine that holds the DEX Monitor.

Note that shorter intervals give you more up-to-date information in the DEX Monitor, but increase your CPU usage.

To change the interval, follow the steps below:

1. Open the DEX Monitor appsettings.json file. By default, this file is located at C:\Program Files (x86)\TRICENTIS\Tosca Server\DexMonitor.

2. Go to pollingInterval and enter a new value in milliseconds.

3. Save and close the file.

4. Restart the service Tricentis.DistributedExecutionMonitor.

Example: a synchronization interval of 10 seconds

  "pollingInterval": "10000"

Change number of displayed TestEvents

By default, the DEX Monitor displays a maximum of 10 finished TestEvents. Finished TestEvents only include passed TestEvents. Recently failed TestEvents are also displayed, but aren't included in this count.

To change this number, follow the steps below:

1. On the DEX Server machine, open the Tricentis.DistributionServerService.exe.config file. By default, this file is located at C:\Program Files (x86)\TRICENTIS\Tosca Server\DEXServer.

2. In the applicationSettings section, enter a new value for FinishedEventCount.

3. Save and close the file.

4. Restart the service Tricentis.DistributedExecutionService .

Example: display a maximum of 15 finished TestEvents

<setting name="FinishedEventCount" serializeAs="String">
    <value>15</value>
</setting>

Manage user access

By default, any user with access to the DEX Monitor can change Agent configurations or cancel executions.

You can put access management protocols in place so that only users with an administrator account in Tricentis User Administration can perform these tasks. All other users are limited to viewing rights to the Event View.

Prerequisites

To use this feature, you need to meet the following requirements:

• You have set up Tricentis User Administration.

• You have assigned administrator rights to the users that should have permission to configure Agents or cancel tests in the DEX Monitor.

Enable access restrictions

To put your access management protocol in place, follow these steps:

1. Open the DEX Monitor appsettings.json file. After a default installation, this file is located at C:\Program Files (x86)\TRICENTIS\Tosca Server\DexMonitor.

2. Go to the Security section and set the value of AuthorizationEnabled to true.

3. Save and close the file.

4. Restart the service Tricentis.DistributedExecutionMonitor.

Set a custom DEX Monitor port

By default, DEX Monitor runs on port 5008. To use a different port, follow the steps below:

1. Open the DEX Monitor appsettings.json file. By default, this file is located at C:\Program Files (x86)\TRICENTIS\Tosca Server\DexMonitor.

2. Go to "Port" and specify the new port number.

        "Port": <NEW PORT NUMBER>,

3. Save and close the file.

4. Configure Tricentis Tosca to use the new DEX Monitor port. To do so, go to Project->Settings->Commander->Distributed Execution->Monitor Url and update the Url setting accordingly.

5. Update the Consul and Ocelot configuration files with the new port number.

Consul and Ocelot configuration

Apply the changes

Restart the following services to apply the changes: 

• Tricentis.DistributedExecutionMonitor

• Tricentis.GatewayService

• ConsulService