Private cloud (beta)

Automatically provision on-premises load generators for load tests. Docker host machines connected to a StormRunner Load agent create a private distribution location for your load tests.

Configure Docker host machines

Action How to
Get a Docker image

To obtain a Docker image, open a support ticket.

Open port

Select one of the following:

  • To communicate over HTTP, open docker daemon port 2375.
  • To communicate over HTTPS, open docker daemon port 2376.

    Note: If you are communicating over HTTPS, create certificates for the docker daemon.

Back to top

Install the private cloud agent - Windows

You can install the private cloud agent on the following Windows systems:

  • Recommended: Windows 2012 R2 and Windows 2008 R2.
  • Supported: Windows 7 (64 bit) and above.

Do the following to install the private cloud agent for Windows:

Action How to:
Get the installation package

To obtain the installation package, open a support ticket.

Copy the installation package

Copy the installation .zip file to the machine on which you want to install the private cloud agent and extract its contents.

Start the installation

Run srprivatecloud.exe and then follow the installation wizard. During the course of the installation you can specify the installation path, which by default is C:\Program Files\stormrunner_privatecloud.

Configure the agent

You must configure the agent before running it. For details, see Configure the private cloud agent.

Run the agent

Click the Start SR Private Cloud icon created during the installation.

Back to top

Install the private cloud agent - Linux

Do the following to install the private cloud agent for Linux:

Action How to
Get the installation package

To obtain the installation package, open a support ticket.

Unzip the installation file Unzip the compressed file: gunzip StomRunnerLoadPrivateCloud.bin.gz

Copy installation package

Copy the installation file on the Linux machine where you want to install the Private Cloud agent. For example, /var/tmp/.

Add run permissions

Add run permissions to the installation folder:

chmod +x ./srprivatecloud.bin

Start the installation

Run sudo ./srprivatecloud.bin in the bin folder and then follow the installation wizard. During the course of the installation you can specify the installation path, which by default is /opt/stormrunner_privatecloud.

Configure the agent

You must configure the agent before running it. For details, see Configure the private cloud agent.

Run the agent
  • Linux GUI: Click the Start SR Private Cloud icon created during the installation.
  • Linux command line: In the agent installation directory, use the command Run ./stormagent_run.sh.

Back to top

Configure the private cloud agent

Do the following to configure the private cloud agent:

Action How to
Start the configuration
  • Windows: Click the Configure SR Private Cloud icon created during the installation or run <agent installation directory>\stormagent_configure.bat.
  • Linux GUI: Click the Configure SR Private Cloud icon created during the installation or run <agent installation directory>/stormagent_configure.sh.
  • Linux command line: Run <agent installation directory>/stormagent_configure.sh.
Select the configuration method

Select from the following options:

  • Full configuration
  • Edit current configuration
  • Show current configuration

For a new agent installation, select Full configuration.

Enter basic configuration data

Enter the following:

  • SRL key. The name of your agent.
  • SRL username. Your user name in StormRunner Load.
  • SRL password. Your password in StormRunner Load.
  • SRL tenant id. Your StormRunner Load tenant id.
  • SRL Project id. The project to assign to the agent (default 1).
Configure Docker hosts

Configure at least one Docker host by entering the following details:

  • SRL docker hostname. The name of the Docker machine.
  • SRL docker port. The Docker daemon port.

If the Docker host uses certificates, additionally configure:

  • SRL docker CA name. The full path of the CA certificate file.
  • SRL docker Key name. The full path of the KEY certificate file.
  • SRL docker Certificate name. The full path of the CERT certificate file.

Tip: You can manually configure the agent by editing the <agent installation directory>/testexec.server/stormagent/private_cloud_sample_conf.json file.

Back to top

Distribute vusers to the private cloud location

Action How to
Define a test For details, see Define a load test.
Distribute Vusers to the private cloud
  1. In the Load Tests page, click the Distributions pane.
  2. Click the Private Cloud tab.
  3. Click the Edit Locations button and select the private cloud location to add to your test.

  4. Enter Vuser distribution. Enter the percentage of Vusers you want to distribute to this location. The Vuser distribution must total 100 percent.

Back to top

Limitations

  • StormRunner Load supports only the latest version of private cloud agents.

  • The private cloud agent and the Docker machines cannot be on the same host.

  • The following script types are supported:

    • Web HTTP/HTML

    • TruAPI

    • SAP Web

    • JMeter HTTP

    • Gatling

    • Oracle NCA

    • Oracle Web

Back to top

Troubleshooting

In the Agents page (Assets > Agents), when you select an agent that is connected, all the Docker hosts that are connected to that agent are displayed on the right of the page together with their status. This can assist you when troubleshooting agent issues.

Back to top