Deploy an OPLG on Linux

8 core CPU (recommended)

16 GB (recommended)

Ensure that the date and time on the load generator machine are correct.

Tip: Synchronize your computer clock with an Internet time server.

The load generator machine needs to be able to access the OpenText Core Performance Engineering servers in SaaS and the cloud machines. (Only outbound HTTPS connection on port 443 needs to be enabled.)

If there is no connection between OpenText Core Performance Engineering servers and the Load Generator (on-premises load generator Status=Not Connected), an error message is reported when you try to run your test.

If you receive a system error -1030, check the network connectivity between your on-premises load generator and the cloud (AWS). Also ensure that outbound communication over port 443 is enabled.

If your company's security or firewall requires static allocated IP addresses, submit a service request to request them.

The load generator can run only one test at a time. If the required load generator is already in use by another test, an error message is reported when you try to run your test.

Vusers in your on-premises load test cannot exceed the maximum number of Vusers allotted to your license.

Pull the OneLG Docker image from the Docker Hub:

docker pull performancetesting/opentext_onelg_ubuntu:latest

Type the following command:

To create the container in background/detached mode:

docker run -d \
      -e "STORM_TENANT=<your tenant id>"  \
      -e "STORM_USERNAME=<your user name>" \
      -e "STORM_PASSWORD=<your password>" \
      --net=host performancetesting/opentext_onelg_ubuntu

To run the container in the foreground:

docker run -t -i \
      -e "STORM_TENANT=<your tenant id>"  \
      -e "STORM_USERNAME=<your user name>" \
      -e "STORM_PASSWORD=<your password>" \
      --net=host performancetesting/opentext_onelg_ubuntu

To enable JMeter or Gatling on the load generator, add the variable "ENABLE_JMETER=1" or "ENABLE_GATLING=1" to the command. For example:

" docker run -d -e ENABLE_JMETER=1 -e ENABLE_GATLING=1 ...."

Type the following command:

      docker run -d \
      -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/opentext_onelg_ubuntu

You can also pass environment variables using the --env-file command line parameter.

• STORM_TENANT: Your Tenant ID [required]
• STORM_USERNAME: Your LoadRunner Cloud user name [required]
• STORM_PASSWORD: Your LoadRunner Cloud password [required]
• STORM_PROJECT_ID: The id number for project (default value 1) [optional]
• STORM_KEY: The load generator's key (Linux only) [optional]

• ENABLE_JMETER: Enable JMeter functionality [optional]

• ENABLE_GATLING: Enable Gatling functionality [optional]

1. In OpenText Core Performance Engineering, 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.

   

For the new opentext_onelg_ubuntu image, run:

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

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

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": "loadrunner-cloud.saas.microfocus.com",
        "user": "<YOUR USERNAME>",
        "password": "<YOUR PASSWORD>",
        "tenant": "<YOUR TENANTID>"
    },
    "injector": {
        "rootPath": "../injector_mdrv"
    }
}

Note: You can get the LRC server address by coping the URL from the address bar of the browser in which you opened LoadRunner Cloud. For example, if the URL in the address bar of the browser is https://loadrunner-cloud.saas.microfocus.com/home/?TENANTID=208294383&projectId=1, copy the address https://loadrunner-cloud.saas.microfocus.com.

Type the following command:

node bin/stormagent.js --config ./sample_conf.json