Integrate algoQA with HyperExecute
Integrate your algoQA project with HyperExecute to run tests in parallel on the LambdaTest cloud grid.
Prerequisites
To run the tests on HyperExecute from your local system, you require:
- Your LambdaTest Username and Access key.
- HyperExecute CLI in order to initiate a test execution Job. Download the appropriate operating system link to run the executable file.
- Set up the environment variables.
- A HyperExecute YAML file which contains all the necessary instructions.
Setting Up Your Test Suite
You can use your own project to configure and test it or a sample project is attached for you to test it.
After downloading the sample project, you need to set up the CLI and the environment variable.
The CLI is used for triggering the tests on HyperExecute. It is recommended to download the CLI binary on the host system and keep it in the root directory of the suite to perform the tests on HyperExecute.
You can download the CLI for your desired platform from the links below:
Setting Up Environment Variables
To export your environment variables LT_USERNAME and LT_ACCESS_KEY that are available in the LambdaTest Profile page, run the following commands in your terminal to set up the CLI and the environment variables on your Windows system:

Configuring YAML in Your Test Suite
---
version: 0.1
globalTimeout: 150
testSuiteTimeout: 150
testSuiteStep: 150
runson: win
autosplit: true
retryOnFailure: true
maxRetries: 1
concurrency: 2
cacheKey: '{{ checksum "pom.xml" }}'
cacheDirectories:
- .m2
pre:
- mvn -Dmaven.repo.local=./.m2 dependency:resolve
report: true
partialReports:
type: json
location: target/
frameworkName: extent-native
uploadArtifacts:
- name: FinalReport
path:
- ExtentReports/**
testDiscovery:
type: automatic
mode: static
args:
featureFilePaths: src/test/java/features/
frameWork: java
testRunnerCommand: mvn test `-Dplatname=win `-Dmaven.repo.local=./.m2 `-Dcucumber.features="$test"
jobLabel: ['HYP', 'algoQA']
Configuring the ApplicationSettings.xml file
The algoQA-generated scripts follow an organized folder structure. Search and locate the ApplicationSettings.xml file. For example, you can find the ApplicationSettings.xml file in an algoQA-generated script folder for web automation available at - ScriptGeneration_202310311222.zip\AlgoAFScript_202310311222\src\test\java. In your ApplicationSettings.xml file, update the following parameters:
- BrowserType : It must be Lambda.
- LambdaTestBuild : Provide your build name.
- LambdaTestURL : Provide your HUB URL. For example, https://username:access-key@hub.lambdatest.com/wd/hub
Executing Your Tests
- Run the following command in your terminal at the root folder of the project:
For example:
./hyperexecute --config RELATIVE_PATH_OF_YOUR_YAML_FILE/hyperexecute.exe --user <username> --key <value> --config <name of the YAML file> - Alternatively, use this command if you have not exported your username and access key in step 2.

Monitoring the Test Execution
Navigate to the HyperExecute Dashboard to verify your Job status.
