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 the Agent tab on  Left-hand side Navigation bar.


2. Once you land on the Agent page you will see two options: 1. Download Agent

                                                                                                      2. Add a new Agent                            


3. Click on Add new Agent

 


3. If Agent is not running you will get the following error:


4. if the agent is in sync you will be asked to enter the title of your machine and click on save:


Note: By default, Agent will be visible only to everyone, you can make this agent visible to only your account by unchecking visible to Everyone. 


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: 

  

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!