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.

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>

Enable user authorization

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

If you don't want this, you can enable user authorization. In this case, only Tricentis User Administration administrators can perform these tasks. All other users only get 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 authorization

To enable user authorization, 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