Skip to main content

Load Balancing for Local Test Environments

With Katalon TestOps, your tests can be executed in parallel using load-balanced configurations.

To do so, Katalon TestOps distributes Test Executions over Agents to optimize Remote Execution efficiency.

Each Agent can be configured with a unique Threshold. Test Executions can then be setup to minimize Agent idleness.


Configure an Agent's Threshold

An Agent's Threshold is the maximum number of sessions that an Agent can execute concurrently in a Local Test Environment.

You must configure the Threshold value to assign the number of jobs to an Agent.

  • By default, the Threshold value of all Agents is set as 1.

To configure an Agent's Threshold, follow these steps:

  1. Sign in to Katalon TestOps and go to your Project.

  2. Go to Configurations > Test Environments.

    The Test Environments page appears.

  3. Click on the Local Test Environment you want to configure the Agent's Threshold for.

    The Agent Details page appears as below.

    agent details page

  4. Update the value in the Threshold section.

  5. Click Update.

The maximum number of concurrent sessions that an Agent can execute is equal to the Threshold value you have configured.

You can check the sessions in the Test Environments page.

test environment page highlight assigned sessions

Assign an Agent to execute Test Runs

For a new Test Plan

You can create a new Test Runs Schedule to assign an Agent for Test Executions. See: Schedule Test Runs.

When creating a new Test Runs Schedule, you are asked to select Test Environments. You can select an Agent here to assign it to your new Test Plan.

For an existing Test Plan

  1. Go to your Project > Test Execution > Test Run List.

  2. Click on a Test Run List.

    a verify match exact name page

  3. Click Edit.

    The Schedule Test Run dialog appears as below.

    highlight select test environment section

  4. Go to the Test Environments section, select a new Agent.

  5. Click Save.

  • You can reassign an old Test Run List or assign multiple new Test Run Lists to any configured Agent.

To check the Test Execution process, go back to the Test Environments page.