Running tests with containerized agents

If you already have a local workbench, instead of installing the agents on different machines and locations, you can just deploy the containerized agents to generate the load.

Before you begin

You must have configured Docker container as per the instructions in the Configuring Docker containers topic.

About this task

Typically, when the agents are installed, you specify the workbench host name and port number to establish the connection with the workbench. If you use containerized agents, they are already installed. Therefore, you specify the connection information during the run.
Note: The version number of the container images and the desktop products must match. If you have previous version of the container image, uninstall it and install the current version. To uninstall the image, use these commands:
  1. Stop the container by running
    docker stop "CONTAINER  ID"
  2. Uninstall the image by running
    docker rmi -f "image ID"


  1. Start the container instance of the agent:
    $ docker run -dit --rm -e MASTER_NAME=WorkbenchIP imageName:imageVersion
    Table 1. Description of parameters
    Command Description
    -dit Specifies that the agent container runs in the background.
    --rm Specifies to clean up the container and remove the file system when the container exits.
    MASTER_NAME Specifies the IP or host name of the workbench.
    MASTER_PORT Specifies the port number of the workbench. If you use the default port number of 7080, this command is optional.
    imageName:imageVersion Specifies the name and version of the image.
  2. From the Web UI Test perspective, select the Web UI tests to run and from the context menu click Run Distributed Tests. The tests are distributed among the connected agents. For more information, see Running multiple tests simultaneously.