Switch Distributed Execution options

Tosca Distributed Execution offers two main setup options (see chapter "Tosca Distributed Execution"):

• Distribution Execution with Automation Object Service (AOS)

• Distributed Execution without AOS

If you're not happy with the option that you chose initially, you can switch without losing your common repositories and settings.

Don't switch while tests are running. If you do, all running and queued tests are lost.

The information in this chapter describes a switch between setup options of the same version. For instance, Distributed Execution without AOS 16.0 to Distributed Execution with AOS 16.0. You cannot switch from version 12.3 or lower to the most current version. In this case, you must perform a clean uninstall of the previous version.

Switch to Distributed Execution with AOS

To switch from Distributed Execution without AOS to Distributed Execution with AOS, follow the steps below:

1. Stop the service Tricentis.DistributedExecutionService in the Windows Task Manager.

2. Open the file Tricentis.DistributionServerService.exe.config. By default, this file is located at C:\Program Files (x86)\TRICENTIS\Tosca Server\DEXServer.

3. Navigate to the section Tricentis.DistributionServer.Properties.Settings.

4. Change the value of the setting EnableWorkspacelessExecution to True.

<setting name="EnableWorkspacelessExecution" serializeAs="String">
    <value>True</value>
</setting>

5. Save and close the file.

6. Make sure that you have installed and configured the Tosca Administration Console.

   The Administration Console consists of several services. You need some of these services for Distributed Execution with AOS.

7. Ensure that the additional ports that Distributed Execution with AOS requires are open:

   • Automation Object Service

   • Tosca Gateway Service

   Optionally, you can configure different ports in the Tricentis Service Configuration.

8. Restart the service in the Windows Services app.

9. Create a workspace for the Automation Object Service (AOS):

   • Note the name of the project root of your repository (see chapter "Create user workspaces"). You need this name when you create your AOS workspace.

   • Create the AOS workspace (see chapter "Create the AOS workspace").

10. Connect Tosca Commander and the Distributed Execution Server.

    To do so, populate the Tosca Gateway Service setting as described in chapter "Connect Tosca Commander".

11. If you want to set up parallel execution, create the necessary project root setting.

12. Optionally, remove your Agent workspaces. You don't need them for Distributed Execution with AOS.

Legacy: Switch to Distributed Execution without AOS

To switch from Distributed Execution with AOS to Distributed Execution without AOS, follow the steps below:

1. Stop the service Tricentis.DistributedExecutionService in the Windows Task Manager.

2. Open the file Tricentis.DistributionServerService.exe.config. By default, this file is located at C:\Program Files (x86)\TRICENTIS\Tosca Server\DEXServer.

3. Navigate to the section Tricentis.DistributionServer.Properties.Settings.

4. Change the value of the setting EnableWorkspacelessExecution to False.

<setting name="EnableWorkspacelessExecution" serializeAs="String">
    <value>False</value>
</setting>

5. Save and close the file.

6. Restart Tricentis.DistributedExecutionService in the Windows Task Manager.

7. Set up workspaces on the Agent machines (see chapter "Create Agent workspaces").