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.

• Google Chrome

  • 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.

• Mozilla Firefox

  • Download the correct web driver version according to the version of your Firefox browser by following the table below!

• Microsoft Edge

  • 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.

• Internet Explorer

  • 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

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:

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

1. Open the command-line as an administrator.

2. Go to the directory where the agent is downloaded.

3. Run ‘INSTALL-SERVICE.bat’

For Linux systems

1. Open the terminal

2. Go to the directory where the agent is downloaded.

3. 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.

If you want to add more nodes to the locally installed Agent on the virtual machine follow these steps:

1. 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.

   1. Note that TESTaide and Selenium only have support for Chrome, Firefox, Microsoft Edge, Internet Explorer, and Safari for now.

2. Download the correct Webdriver for the browser and version of the browser, follow the steps above.

3. Configure the new paths by changing directory to:

   cd /home/TESTaide/infrastructure-configuration-agent/config #Edit the configuration file vim development.json

4. By using the keyboard to move, add the new objects for the web drivers.

   1. 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”}

   2. 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" } ] }