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 the threshold value, follow these steps:
  1. Sign in to Katalon TestOps and go to your project. Then navigate to TestOps Settings > Organization Setup.
    Organization setup within the TestOps settings menu.
    This shows the Test Environments page. It also lists the agents you have. Current Agents in Katalon TestOps.
  2. Select your Test Environment from one of the tabs.
  3. Click on the Name of the Agent you want to configure a threshold for.
    The name of an Agent in Katalon TestOps.
    This shows the Agent Details page.
  4. Scroll down to the Threshold section and input the number of sessions you'd like your agent to execute concurrently.
    The threshold setting in the Agent Details page.
  5. Click Update.
You've successfully configured the number of your agent's simultaneous executions. The maximum number of concurrent sessions that an Agent can execute is equal to the threshold value you have configured.

You can check these sessions from the Test Environments page.

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.