Introduction

Once you have created a test case containing a number of test steps for execution, we can move onto setting up an execution environment.

We may choose any of the available execution models such as Testsigma Lab, Hybrid, Private Grid, Sauce Labs or BrowserStack.


For Hybrid Model and Private Grid, we need to configure a local machine to execute the tests. We can do that by setting up and executing the Testsigma Agent on the 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.


We assume that you have already created a Hybrid Execution on Testsigma website before configuring your local machine. If not, please refer to this article for a detailed guide on creating a Hybrid Execution - How to Create a Hybrid Execution for running Tests on Local Machine?

After creating an Execution, come back to this article for setting up the local machine for Hybrid Execution.


Note: Below article explains the process of setting up your local machine for Hybrid Execution by configuring the Testsigma Agent Application(newer, auto-update version). If you have previously configured Testsigma Agent(old, manual-update version) on your local machine and you are trying to upgrade to the newer auto update version, please follow this guide: How to upgrade the Testsigma Agent to the newest auto-update version(One time setup)?


Before starting the setup for Hybrid Execution, please make sure the following prerequisites are satisfied.

Prerequisites

  • Java Development Kit(JDK)

    Java Run-time is required for running Testsigma Agent on a machine. As you might already know, Java Run-time is always included within a JDK. So, if you already have JDK installed on your machine, you can skip to Environment variables part below. If not, You can download JDK from official Oracle website here: JDK 8 Download Page


  • Environment variables for Java - JAVA_HOME, JDK_HOME, JRE_HOME

    After installing JDK, you need to set Environment Variables to easily execute Java Applications on your machine.


    Please check the below article for a detailed guide on setting the Environment variables:
    How to set Environment variables on your machine?

    You may also refer to the official documentation given below:

    Windows | Linux | Mac


Setting up your Local machine

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

1. Extract the Testsigma Agent-Drivers bundle archive

2. Start Testsigma Server

3. Register the Agent and start Tests


1. Extracting the Testsigma Agent-Drivers bundle archive


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

Windows - Testsigma Agent-Driver Bundle Windows 32bit | Testsigma Agent-Driver Bundle Windows 64bit
Mac - Testsigma Agent-Driver Bundle Mac 32bit | Testsigma Agent-Driver Bundle Mac 64bit
Linux - Testsigma Agent-Driver Bundle Linux 32bit
Testsigma Agent-Driver Bundle Linux 64bit


Extract the archive somewhere in your home directory:


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

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


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


2. Starting 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-Win64\apache-tomcat-8.5.30\bin"


2. Type "startup.bat" and press Enter. 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:

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


2. Type startup.sh and press Enter. 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.


3. Registering the agent


1. Once your Testsigma agent is up, go to the below URL on your Web Browser(Google chrome is preferred).

http://localhost:8080/agent


Testsigma Agent Dashboard page would open up as shown below:



2. Click on Register Agent link on the left navigation pane, enter your Testsigma Account details and click on Register.


3. Click on the Executions link and check your Execution status there. You would see the Execution name and the 'Running' status later when your Tests are executing.


4. Go to Testsigma website on a new tab if not open already and Start the Execution by clicking on Run Now button in the Executions page or perform a Dry Run.


5. Switch back to the Testsigma Agent tab and go to Executions link to view the status of Execution.




Your Execution will start shortly on the prescribed machine.


Happy Automation Testing!!