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 authentication

User authentication adds an additional layer of protection and control to the DEX Monitor. When enabled, only authenticated users can access the DEX Monitor UI and, therefore, monitor and control test execution. Authentication is performed via Tricentis User Administration, where you can manage users and specify individual permissions.

To enable user authentication for the DEX Monitor, follow the steps below:

1. Set up Tricentis User Administration, if you haven't yet:

   • Configure the Tricentis Authentication Service via Service Configuration.

   • Create a Tricentis User Administration account. Note that only administrators can cancel test execution and change Agent configurations. Other users have read-only access to the Event View.

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

3. Go to the Security section and set the value of Deactivate to false.

  "Security": {
    "Deactivate": false
  }

4. Save and close the file.

5. Restart the service Tricentis.DistributedExecutionMonitor in the Windows Task Manager.

6. Go to your Tosca Server landing page and navigate to Distributed Execution.

7. When prompted, enter the login credentials of your Tricentis User Administration account. You can use the LOGOUT button in the upper-right corner of the screen to end your current session at any time.

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