Document toolboxDocument toolbox

Execution in Remote/Distributed Environment

You can execute the test cases using offline package after configuring settings accordingly. This gives you provision to trigger suite execution using any machine in the network. You do not need to move the offline package to different machines to execute it.

You can do it in following two ways:

Normal Remote Execution

This option can be used when you are aware of the remote machine details where you wish to execute your test cases.  Please note that here you choose to execute Offline Package on a remote machine with specific details.

Qualitia uses the selenium-standalone-server-jar for test case executions on the target remote machine.

To run selenium-stand- alone jar:

  1. Download the selenium-standalone-jar on the target machine where you want to execute test cases.
  2. Download the drivers corresponding to the offline execution browser (chromedriver, IEdriverServer, and so on) and store it in the same location where the selenium-stand-alone-jar is saved.
  3. Open the Command Prompt window and navigate to the location where jar is stored.
  4. Do one of the following:
    1. If the execution browser is Iexpore and selenium sever standalone version is 2.xx.x, execute following command: java -jar selenium-server-standalone-2.45.0.jar - Dwebdriver.ie.driver="D:\Data\Testing\Apps\IEDriverServer.exe”.

    2. If the execution browser is Iexpore and selenium sever standalone version is 3.xx.x, execute following command: java -Dwebdriver.ie.driver="D:\Data\Testing\Apps\IEDriverServer.exe" -jar selenium-server-standalone-3.0.1.jar

Configuration Settings

Once you download Selenium-stand-alone jar and browser drivers, you need you change some settings in the qualitia.properties file in order to run Normal Remote Execution.

To configure settings as for Normal Remote Execution:

  1. Open the qualitia.properties file from the config folder of offline package.
  2. Set the ExecutionEnvironment value as
  3. Set the RemoteURL value to a valid remote URL that is IP and port of remote machine.
    For example: RemoteURL=http://192.168.25.123:4445

Qualitia Bot - Execution

After you configure all the files, you can trigger the test case execution by opening the command prompt and navigating to the folder where you saved the Qualitia bot. After navigating to the designated folder: execute the following command;

java -jar qualitiaoffline-xxx.jar

This command executes tests available at the xmlPath mentioned in the qualitia.properties file.

(warning) In case you have multiple versions of java, Qualitia uses the version set against the "JAVA_HOME" system variable under System Properties settings of your computer.

It uses browsers available on local machine for test case executions. For example, if you have selected "Firefox" as an execution browser and the local machine has Firefox version 42, Qualitia continues execution using Firefox version 42. Execution Reports are displayed on the local machine after executing the test cases.

Mobile Test Case Executions

In order to execute mobile test cases on the remote machine, make sure that Appium server is up and running on the designated remote machine.

Remote Execution through Selenium Grid

What is Hub?

The Hub is the main command center for managing which machines your test will run on. This is where you can see list of all the available nodes currently running in your grid environment (Remote Execution Environment).

What is Node?

A Node is a machine that you register with your Hub. By registering with Hub, the Hub now knows about the Node and any configuration information you used when you registered the node.

In order to perform remote execution through selenium grid, you need to configure Hub and Node in the network.

Creating Hub in the Network

A Hub can be created in the network following the steps mentioned below.

  1. Decide a machine in the network to register as hub (with IP, for example, 192.168.25.6).
  2. Download the Selenium-server-standalone jar file on Hub machine.
  3. Open Command Prompt and navigate to the location where Selenium-server-standalone-jar is saved.
  4. Execute command "java -jar selenium-server-standalone-2.xx.0.jar-role hub -port 4445".

Create Node and Register to Hub

Once hub is created in the network, you can select multiple machines to act as its nodes. Registering nodes include following steps.

  1. Download the Selenium-server-standalone jar file on Hub machine.
  2. Launch the command prompt and navigate to the location where Selenium-server-standalone jar file is saved.
  3. Execute command "java -jar selenium-server-standalone-2.xx.x.jar -role node–hub http://hubIP:4445/grid/register".

You can bundle your IEServerDriver.exe, Geckodriver.exe, or ChromeDriver.exe running while registering to Hub.

Configuration Settings

Prior executing test cases in remote execution in selenium grid, you need to configure settings accordingly. Here are some important points to keep in mind when configuring settings for remote execution in selenium grid.

To configure settings for remote execution in selenium grid:

  1. Open the qualitia.properties file from the config folder of offline package.
  2. Set the ExecutionEnvironment value as remote to inform qualitia-offline.jar that offline package has to be executed on a remote machine.
  3. Set the RemoteURL value to a valid remote URL that is IP and port of remote machine. For example: RemoteURL=http://192.168.25.123:4445
  4. Set the GridPlatform value to valid platform where you want to execute test cases. For example: Set the GridPlatform=Win10

Qualitia Bot - Execution

After you configure all the files, you can trigger the test case execution by opening the command prompt and navigating to the folder where you saved the Qualitia bot. After navigating to the designated folder: execute the following command;

java -jar qualitiaoffline-xxx.jar

This command executes tests available at the xmlPath mentioned in the qualitia.properties file.

(warning) In case you have multiple versions of java, Qualitia uses the version set against the "JAVA_HOME" system variable under System Properties settings of your computer.

It uses browsers available on local machine for test case executions. For example, if you have selected "Firefox" as an execution browser and the local machine has Firefox version 42, Qualitia continues execution using Firefox version 42. Execution Reports are displayed on the local machine after executing the test cases.

Mobile Test Case Execution on Nodes

In order to execute mobile test cases using selenium grid, make sure that Appium server is up and running on the designated node.