For Test Lab models such as Hybrid and Private Grid, we need to configure a local machine to execute the tests. We can do that by running a small utility program named 'Testsigma Agent' on the local machine. The Agent will do the required configuration, avoid the hassle of numerous configuration for end-users and allow us to concentrate on managing the tests alone.


Setting up your Local machine

Setting up your Windows, Mac or Linux Machine for Hybrid Execution consists of three steps. They are:

I. Extract the Testsigma Agent-Drivers bundle

II. Start the Testsigma Agent Server

III. Register the Testsigma Agent


I. Extract the Testsigma Agent-Drivers bundle

Download the Testsigma Agent archive corresponding to your Operating System below:

Windows - Testsigma Agent Windows
Mac - Testsigma Agent Mac
Linux - Testsigma Agent Linux


Extract the archive somewhere in your home directory:


For Windows, you may use "C:\Users\<username>\Documents"

For Linux, you may use "/home/<username>/Documents"

For Mac, you may use "/Users/<username>"


Replace the <username> part with your Account username. The home directory is recommended so as to avoid hassles of setting file permissions and ownership.


For Mac, we recommend the User directory to put the Testsigma Agent in order to avoid syncing with iCloud which might corrupt the files due to frequent changes.


II. Start the Testsigma Agent Server

For Windows

1. Open your Command Prompt and navigate to the Testsigma Agent directory using cd command as follows:

cd "C:\Users\<username>\Documents\Testsigma-Agent\apache-tomcat\bin"


2. Start the Testsigma Agent using the below command:

startup.bat

A new window will open up and tomcat server will start running. Wait for the "Server startup in X ms" message to come up. Your Testsigma Agent server is up and running now.


For Mac/Linux

1. Open Terminal and navigate to Testsigma Agent directory using cd command as follows:

For Linux:

cd "/home/<username>/Documents/Testsigma-Agent/apache-tomcat/bin"

For Mac:

cd "/Users/<username>/Testsigma-Agent/apache-tomcat/bin"


2. Start the Testsigma Agent using the below command

sh ./startup.sh

Tomcat server will start running as a background process. Wait for a few seconds. Your Testsigma Agent server is up and running now.


For Mac/Linux, the Agent app will start as a background process. If you want to see the logs in realtime, use the command sh ./catalina.sh run


III. Register the Testsigma Agent

1. Once your Testsigma agent is up and running, click on configuration on the Left-hand side Navigation bar.



2. After navigating to the configuration page click on Agent:


3. Click on Add a new Agent icon that you see on the top right corner. If your Agent is running you will get a screen asking to enter the Title you want to give your Agent:


Note: By default, Agent will be visible only to your account, you can make this agent visible to all the other users by toggling "Visible to me" to "Visible to all" which you see below the title text box.

 

 

4. Once you have entered the Title, click on save to save the Agent. After saving, the agent that you registered will be displayed with all the available browsers in that Agent machine: 

  

 

5. If you want to register an Agent running on a different machine, then toggle the switch from "Local machine" to "Remote Machine":

 


Note: To register an Agent running on a different machine, the machine needs to be in the same network as the system that you're using to register it

6. Now enter the Title of the Agent and also the IP Address of the system that the Agent is running and click on Save to finish registering the Agent.

  

Starting the Execution

We assume that you are already on the Test Case details page trying to create a Hybrid Dry Run or on the Test Plans page trying to create a Hybrid Test Plan. Please refer this article for a detailed guide on creating a Hybrid Execution - How to Create a Hybrid Execution for running Tests on Local Machine?


Smart Test Automation!