Running tests with containerized agents

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

You must have configured the Docker container. See Configuring Docker containers.

Typically, when the agents are installed, you specify the workbench host name and port number to establish the connection with the workbench. But containerized agents 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 then install the latest version.

To uninstall the image, you must stop the container by running the docker stop "CONTAINER ID" command, and then run the docker rmi -f "image ID" command to uninstall the image.

  1. Start the container instance of the agent by running the following command: 
    $ docker run -dit --rm -e MASTER_NAME=Workbench_name or IP -e MASTER_PORT=port_number -e AGENT_NAME=Agent_name -e AGENT_IP=IP_address 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.
    AGENT_NAME Optional: Specifies the name of the agent that report to the workbench.
    AGENT_IP Optional: Specifies the IP address of the agent that report to the workbench.
    imageName:imageVersion Specifies the name and version of the image.
  2. Select the Web UI tests to run from the UI Test perspective, and then click Run Distributed Tests from the context menu.

    The tests are distributed among the connected agents.