Deploy a Docker container for Linux

Deploy and configure a Docker container to load test your secure applications.

Note: The Docker client (engine) must be installed on each host machine where you want to install the StormRunner Load Docker container.

StormRunner Load on-premises Docker versions on Docker Hub

Choose a StormRunner Load on-premises docker version to deploy. Images are available on Docker Hub.

Version Description
Full version

The full version supports the following script protocols:

  • Web HTTP/HTML
  • TruAPI
  • SAP Web
  • JMeter HTTP
  • Gatling
  • Oracle NCA
  • Oracle Web
Lite version

The lite version supports the following script protocols:

  • TruAPI
  • JMeter HTTP

  • Gatling

Back to top

Deploy and configure the Docker container from Docker Hub

For additional help, consult the Docker help.

Do the following to deploy and configure the Docker container:

Action How to
Pull Docker image

Pull a StormRunner Load on-premises Docker version to deploy. Images are available on Docker Hub.

Pull commands:

  • Full version:

    docker pull performancetesting/stormrunner_load_generator:latest

  • Lite version:

    docker pull performancetesting/stormrunner_load_generator:latest_lite

Launch a container

Type the following command:

docker run -t -i \
      -e "STORM_TENANT=<your tenant id>"  \
      -e "STORM_USERNAME=<your user name>" \
      -e "STORM_PASSWORD=<your password>" \
      --net=host performancetesting/stormrunner_load_generator
Launch a container with HTTP(s) proxy

Type the following command:

      docker run -t -i \
      -e "STORM_TENANT=<your tenant id>" \
      -e "STORM_USERNAME=<your user name>" \
      -e "STORM_PASSWORD=<your password>" \
      -e "http_proxy=<your proxy url e.g. http://proxy.com>" \
      -e "https_proxy=<your proxy url e.g. http://proxy.com>" \
      --net=host performancetesting/stormrunner_load_generator

Back to top

Manually deploy and configure a Docker container

You can manually deploy the Docker container

Action How to
Define your StormRunner Load load generator in StormRunner Load and note the key:
  1. In StormRunner Load, select Assets > Load Generators.
  2. Click Create. Give the load generator a meaningful name and description.

  3. Select Linux as the OS.
  4. Note the load generator's key.

Create the container

Type the following command:

docker run -t -i \
-e "STORM_DISABLE_AUTO_REGISTER=1" \
--net=host performancetesting/stormrunner_load_generator

The current working folder is: /opt/testexec.server/stormagent

Edit the sample_conf.json

Add your load generator key and your credentials to the sample_conf.json file:

{
    "key": "<YOUR KEY>",
    "interval": 20000,
    "logLevel": "info",
    "server": {
        "protocol": "https:",
        "addr": "stormrunner-load.saas.hpe.com",
        "user": "<YOUR USERNAME>",
        "password": "<YOUR PASSWORD>",
        "tenant": "<YOUR TENANTID>"
    },
    "injector": {
        "rootPath": "../injector_mdrv"
    }
}
Launch the container

Type the following command:

./start_storm_agent.sh

Back to top

Run a test using my Docker container

Action How to
Create a test

From StormRunner Load > Load Tests, select a load test or create a new test.

Select On-premise as the location of the load generators

From the Scripts tab, select a script and then select On-Premise from the Location drop-down list.

Add a load generator

From the Distribution tab, click On Premise and then click Add from Assets to select the on-premises StormRunner Load Generators to use for your test.

Back to top

Create and view logs

You can create and view test run logs.

Create a log

To use the Docker container to create logs, launch the container with the -r or --reserveTestLog flag. For example:

Example: docker run -d -e STORM_AGENT_EXTRA_CONFIG='--reserveTestLog'

Logs are saved in the inj_o_*** folders under /storm.

View logs

You can view logs from within a running Docker container, or copy the logs to your local file system.

  • View logs from within a running Docker container

    1. Run the command: docker exec -t -i <container ID> /bin/bash
    2. Enter the /storm folder and check the required log.
  • Copy logs to your local file system

    Run the command: docker cp <container ID>:/storm /tmp/

    In this instance, the logs are copied to the tmp folder in your local file system.

  • Back to top