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.

• Set up DEX Monitor and DEX Server on separate machines.

• Set up a custom DEX Monitor port.

Change synchronization interval

By default, the DEX Monitor queries the DEX Server every 20 seconds for information.

You can define a different interval. 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 on the machine that holds the DEX Monitor:

1. Open the appConfig.json file. By default, this file is located at C:\Program Files (x86)\Tricentis\Tosca Server\DexAdmin\Frontend\assets.

2. Enter a new value (in milliseconds) for pollingInterval.

3. Save and close the file.

4. Restart the service Tricentis.DistributedExecutionMonitor.

Example: a synchronization interval of 10 seconds

{
    "baseUrl": "http://localhost:5007/",
    "landingPageUrl": "http://localhost:5012",
    "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>

DEX Monitor and DEX Server on separate machines

Tricentis recommends that you install the DEX Monitor and the DEX Server on the same machine.

However, you can install them on separate machines.

Do not do this while tests are running. If you do, all currently running and queued tests are lost. In this case, you have to restart Tosca Server and trigger them again.

To set up DEX Monitor and the DEX Server on separate machines, follow the steps below:

1. On the machine that holds the DEX Monitor, open the appConfig.json file. By default, this file is located at C:\Program Files (x86)\Tricentis\Tosca Server\DexAdmin\Frontend\assets.

2. Enter the address of the DEX Server as the value of baseUrl.

{
    "baseUrl": "111.111.1.1:80",
    "landingPageUrl": "http://localhost:5012",
    "pollingInterval": "20000"
}

3. Save and close the file.

4. On the machine that holds the DEX Monitor, restart the service Tricentis.DistributedExecutionMonitor .

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

6. Enter the address of the DEX Monitor as the value of CORSAllowedOrigins.

<setting name="CORSAllowedOrigins" serializeAs="String">
    <value>222.222.2.2:80</value>
</setting>

7. Save and close the file.

8. On the machine that holds the DEX Server, restart the service Tricentis.DistributedExecutionService.

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\DEXAdmin.

2. Enter the desired port number, without quotation marks, after the word "Port".

{
  "Logging": {
    "LogLevel": "Warning",
    "LogPath": "%PROGRAMDATA%\\TRICENTIS\\Logs\\DistributionExecutionMonitor\\DistributionExecutionMonitor_Log_.txt"
  },
  "HttpServer": {
    "Endpoints": {
      "Http": {
        "Port": <NEW PORT NUMBER>,
        "Scheme": "http",
        "SubjectName": "",
        "Thumbprint": "",
        "StoreName": "My",
        "StoreLocation": "LocalMachine"
      } 
    } 
  } 
}

3. Save and close the file.

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

5. Open the Tosca Server landing page configuration file data.xml. By default, this file is located at C:\Program Files (x86)\TRICENTIS\Tosca Server\LandingPage\wwwroot\resources\data.

6. Update the distmonitor address with the new port number.

7. Save and close the file.

  <feature id="distmonitor">
    <isInstalled>1</isInstalled>
    <url>http://localhost:NEWPORTNUMBER</url>
  </feature>

8. 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.