Start the Tosca Distribution Agent
To set up Tosca Distributed Execution, you need to start and configure each Tosca Distribution Agent.
You can start a Tosca Distribution Agent in one of the following ways:
Start the Tosca Distribution Agent with GUI
To start your agent with GUI, right-click the file ToscaDistributionAgent.exe and select Run as administrator from the context menu. This file is located at %TRICENTIS_DEX_AGENT_HOME%.
|
You need administrator privileges to edit files in an agent's default installation folder. Running the agent as an administrator is necessary for the proper functioning of the agent. |
To verify that you successfully started the agent, you can check an agent's status in the Windows task bar (see chapter "Check an agent's status"):
Agent icon in the Windows taskbar
Start the Tosca Distribution Agent without GUI
You can start the agent without its GUI elements if you want the agent to work in the background. If you start your agent without GUI, you can still run GUI tests, but the GUI elements of the agent are not visible:
-
Agent icon in the Windows taskbar
-
ToscaDistributionAgent Configuration window
|
If you start your agent without GUI, you cannot configure it with the ToscaDistributionAgent Configuration window. You can only configure the agent using the Distributed Execution Monitor. |
The procedure to start the agent without GUI depends on whether you have already specified the agent-server connection:
-
If you have not yet established the agent-server connection, you need to specify the server address when you start your agent.
-
If you have already specified the agent-server connection, you can start your agent without specifying the server address.
Start the agent without GUI and specify the server address
If you want to start your agent without GUI and you have not yet specified the agent-server connection, you need to specify the server address in the command line when you start your agent.
To do so, follow the steps below:
-
Open a command prompt with administrator privileges.
-
Navigate to the folder %TRICENTIS_DEX_AGENT_HOME%.
-
Enter the following command line:
ToscaDistributionAgent.exe cmd-only http://<server IP address>:<port>/DistributionServerService/ManagerService.svc
Replace <server address> and <port> with the IP address and the port of the Tosca Distribution Server.
Start the agent without GUI without specifying the server address
If you have already specified the server address on the agent machine, follow the steps below to start your agent without GUI and without specifying the server address:
-
Open a command prompt with administrator privileges.
-
Navigate to the folder %TRICENTIS_DEX_AGENT_HOME%.
-
Enter the following command line:
ToscaDistributionAgent.exe cmd-only