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 14.0 to Distributed Execution with AOS 14.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 Tosca Server via the IIS Manager.

2. Open the file Web.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. Modify your Tosca Server installation to add the server feature 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

   • Service Discovery

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

8. Start the Tosca Server via the IIS Manager.

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 Tricentis Service Discovery 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.

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 Tosca Server via the IIS Manager.

2. Open the file Web.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 the Tosca Server via the IIS Manager.

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