This site requires JavaScript to be enabled

We're currently experiencing some technical difficulties with our Chat channel. To resolve those issues please clear your browser cache and reload the page. Further information: Atricle NEW0000472

How can we help?

Solution Suggestions

Please enter your question to get suggestions.
Boolean Operators
OR or vertical bar symbol (|)
Finds a match if either the terms exist in a document (a union using sets).
Finds a match if both terms exist in a document (an intersection of sets).
NOT, minus (-), or exclamation point (!)
Excludes documents that contain the term after NOT (a difference of sets).
Asterisk (*)
The asterisk symbol performs a multi character wildcard search.
Percent sign (%)
The percent sign performs a single character wildcard search.
Quotation marks (")
Use quotation marks to search for an exact phrase with multiple terms.
For examples and more information look at our Knowledge Base: Advanced Search On The Support Portal

How to setup ToscaDistributionAgent in a CITRIX environment

Setting up Tosca Distributed Execution (DEX) in a CITRIX environment can be tricky.
This guide will explain the necessary initial configuration steps to run multiple ToscaDistributionAgents on the same machine.


Tosca Distributed Execution is designed for execution/distribution of ExecutionLists between several machines/VMs that have Tosca installed and that run the ToscaDistributionAgent.

In a CITRIX environment the setup however requires certain initial configuration steps to make it work.

CITRIX is defined through one environment and every user is working on an instance of this environment.
This means, that every instance in general works on the same machine, and therefore uses the same installed applications.

The main challenge in the context of Tosca DEX is now, to run several unique instances of ToscaDistributionAgent on the same machine.


We assume that several users (User1, User2, User3, ...) exist on the machine.

  1. Login to the machine with User1
  2. Copy the directory C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\ToscaCommander\DistributedExecution\Agent to a location where User1 has read and write access
  3. Rename the new directory to 'Agent_User1'
  4. Create a workspace to the common repository with the Name ‘Workspace_User1’
  5. Login into this workspace and create a new Tosca user for this machine ‘User1’
  6. Within the folder C:\ProgramData\TRICENTIS\TOSCA Testsuite\7.0.0\DistributedExecutionAgent create a new Directory called ‘Agent_User1’
  7. Open up the ToscaDistributionAgent.exe.config from the newly created agent directory ‘Agent_User1’
  8.  Set the path to the newly created workspace:
      <setting name="Workspace" serializeAs="String">
  9. Set ‘User1’ as the workspace user
    Also set the password if required.
     <setting name="UserName" serializeAs="String">
     <setting name="Password" serializeAs="String">
  10. Set a valid open TCP port for EACH agent
    This requires an open port range e.g. from 9002 – 10000 depending on the number of agents you want to run on your CITRIX environment
      <setting name="PortForServerCallbacks" serializeAs="String">
  11. Save the ToscaDistributionAgent.exe.config from the newly created agent directory ‘Agent_User1’
  12. Run the ToscaDistributionAgent.exe from the newly created agent directory ‘Agent_User1’
  13. As soon as the agent is green (Idle), right click on the agent symbol within the Tray icon and click Configure Agent.

  14. Set the HostName setting to guarantee a unique name for the agent and Save

  15. Log off the machine and repeat the steps with every other user that should host an agent.


2 0

Philipp Dessovic

Created: 2019-04-30 16:42:05

Two steps are missing:

1. Add to ToscaDistributionAgent.exe.config the name of the configuration subfolder created in step 6:

<setting name="ConfigurationSubFolder" serializeAs="String">

2. For each workspace overwrite WorkspaceSettings.xml to save buffers inside the workspace. (Filepath e.g. "C:\Tosca_Projects\Tosca_Workspaces\<Workspace>\Settings\WorkspaceSettings.xml")


<?xml version="1.0" encoding="utf-8"?>
<TOSCASettings xmlns="TOSCANamespace" xmlns:xsi="">
  <Category name="Engine">
    <Collection name="Buffer" legacyPath="Buffer.Local">
      <CollectionEntry name="DEMO">DEMO</CollectionEntry>
  <Category name="Workspace">
    <Setting name="SettingsDir" legacyPath="Workspace.SettingsDir">.\Settings</Setting>