TESTaide Infrastructure Agent
This guide provides information on how to properly configure and install the Infrastructure Agent that manages the Selenium hubs and nodes used by the TESTaide application to automate test scripts.
Downloading Selenium & Webdrivers
Selenium Grid Download
You can download the Selenium Grid .jar file from the Selenium website. Scroll down on the page to find a full list containing previous releases.
Webdriver Download
Additionally, a webdriver for the available web browsers are required. The correct web driver has to be downloaded for the correct browser version. Below are links to where to find the web driver for each corresponding web browser.
Download the correct web driver where the version matches the version of your Chrome browser, e.g. driver version 108.x.xxxx.xx for browser version 108. Note that only the first 3 numbers need to match up with each other.
Download the correct web driver version according to the version of your Firefox browser by following the table below!
Download the correct web driver where the version matches the version of your Edge browser, e.g. driver version 89.0.774.77 for browser version 89.0.774.77.
Download the correct web driver for the corresponding version of the Selenium Grid previously downloaded. The Internet Explorer web driver must additionally be placed in the %PATH% environment variable.
Firefox Web driver supported versions
Geckodriver (web driver) | Version of Firefox browser | Geckodriver (web driver) | Version of Firefox browser |
---|---|---|---|
0.32.0 | Minimum: v.102 Extended Support Release (ESR) | 0.26.0 | Minimum: v.60 |
0.31.0 | Minimum: v.91 Extended Support Release (ESR) | 0.25.0 | Minimum: v.57 |
0.30.0 | Minimum: v.78 Extended Support Release (ESR) | 0.24.0 | Minimum: v.57 |
0.29.1 | Minimum: v.60 | 0.23.0 | Minimum: v.57 |
0.29.0 | Minimum: v.60 | 0.22.0 | Minimum: v.57 |
0.28.0 | Minimum: v.60 | 0.21.0 | Minimum: v.57 |
0.27.0 | Minimum: v.60 |
|
|
Configuring the agent
In the downloaded folder for the TESTaide Infrastructure Agent, you will find a ./config folder which will contain the configuration file. This file will allow the agent to utilize the required tools to function properly.
In the ./config folder is a file named, ‘development.json.example.windows’, open this file in a text editor where you will find the configuration fields of which there are a few fields to configure:
Field | Description |
---|---|
Name | The IP address of the machine that is hosting the hub and nodes. |
Port | The port for the TESTaide Infrastructure Agent. |
Java | Path to where the Java executable is installed. |
Selenium → Binary | Path to where the Selenium .jar file is downloaded. |
Selenium → Server-jars(?) |
|
Selenium → Platform | Describes which system is used to install the Agent on, e.g. Linux or Windows. |
Selenium → Chrome/Edge/Firefox → Driver | Path to where the corresponding web driver executable is downloaded. |
Selenium → Chrome/Edge/Firefox → Versions[] → Version | The version number of the specific web driver |
Selenium → Chrome/Edge/Firefox → Versions[] → Driver | Path to where the corresponding web driver for the specific version. |
TESTaide → Base URL | The URL and port for where the local TESTaide is available. |
You can have additional web drivers for the browser by adding another version & driver to the list of versions.
Installing the TESTaide Infrastructure Agent service
After configuring the .json file, you will need to install the agent as a service. This will provide a automatically run service on the start-up of the system.
For Windows systems
Open the command-line as an administrator.
Go to the directory where the agent is downloaded.
Run ‘INSTALL-SERVICE.bat’
For Linux systems
Open the terminal
Go to the directory where the agent is downloaded.
Run ‘sh start.sh’
For TESTaide Azure Virtual Machine
If you have purchased TESTaide from the Azure Marketplace then the virtual machine will already include the Agent installed and configured, you can ignore the previous instructions. However, if you want to connect an external Agent then you need to install it by following the instructions above.
Make a backup file for the development.json file before making any changes to be able to revert back to if any issues arise.
If you want to add more nodes to the locally installed Agent on the virtual machine follow these steps:
If you want to add more nodes to the Chrome and/or Firefox configurations skip to step 2, otherwise, install the desired web browser for the new nodes.
Note that TESTaide and Selenium only have support for Chrome, Firefox, Microsoft Edge, Internet Explorer, and Safari for now.
Download the correct Webdriver for the browser and version of the browser, follow the steps above.
Configure the new paths by changing directory to:
cd /home/TESTaide/infrastructure-configuration-agent/config #Edit the configuration file vim development.json
By using the keyboard to move, add the new objects for the web drivers.
If you are adding new web drivers for Chrome/Firefox, simply add a new object to the versions[] array for the respective browser.
{“version”: “xx.x.x“, “driver”: “path/to/webdriver”}
For a new browser, add a new object in the style of the example below. The name for the browser object should be ['chrome', ‘firefox’, ‘edge’, ‘ie’] for the respective browser.
"edge": { "driver": "/path/to/default/webdriver", "versions": [ {"version": "xx.x.x", "driver": "/path/to/version/webdriver" } ] }
Make sure to follow correct JSON syntax when editing the configuration file.