What is NeoLoad Controller?

NeoLoad⁠ is a load testing solution developed by Neotys⁠. NeoLoad realistically simulates user activity and monitors infrastructure behavior so you can eliminate bottlenecks in all your web and mobile applications. NeoLoad controller uses one or many Load Generators to generate the load against the server under test.

This image allows you to run NeoLoad tests within two different scopes:

• Managed by NeoLoad Web - The NeoLoad Controller is connected to NeoLoad Web which initiates the test (only available since NeoLoad 6.7)
• Stand-Alone usage - The NeoLoad Controller runs a test from the project and license specified as environment parameters. Results can be optionally pushed live to NeoLoad Web.

It is recommended to use external Load Generators such as Docker Load Generators. This image must be used with NeoLoad shared licenses and Neotys Team Server⁠.

Managed by NeoLoad Web

The NeoLoad Controller is connected to NeoLoad Web which initiates the test.

docker run -d --rm \
        -e MODE=Managed
        -e NEOLOADWEB_URL={nlweb-onpremise-apiurl:port} \
        -e NEOLOADWEB_TOKEN={nlweb-token} \
        -e NTS_URL={nts-url} \
        -e NTS_LOGIN={login:password} \
        neotys/neoload-controller

Parameters

Stand-Alone Usage

The NeoLoad Controller runs a test from the project and license specified as environment parameters. Results can be optionally pushed live to NeoLoad Web.

With the Load Generators listed in the Project

docker run -d --rm \
        -e PROJECT_NAME={project-name} \
        -e SCENARIO={scenario} \
        -e NTS_URL={nts-url} \
        -e NTS_LOGIN={login:password} \
        -e COLLAB_URL={collab-url} \
        -e LICENSE_ID={license-id} \
        -e VU_MAX={vu-max} \
        -e DURATION_MAX={duration-max} \
        -e NEOLOADWEB_URL={nlweb-onpremise-apiurl:port} \
        -e NEOLOADWEB_TOKEN={nlweb-token} \
        -e PUBLISH_RESULT={publish-result} \
        neotys/neoload-controller

With overridden Load Generators

Create a Load Generator override file by following documentation of --override-lg parameter⁠. Map your created file to the container by adding the following option to the previous example. The new line must be added before the neotys/neoload-controller line.

    -v /path/to/your/local/lg/file:/tmp/lg.txt \

Then you must add the --override-lg parameter using the OTHER_ARGS environment variable like this: Add the following option to the previous example before the neotys/neoload-controller line.

    -e OTHER_ARGS=--override-lg /tmp/lg.txt \

With Load Generators that accept only TRUSTED controllers

Add the following options to the previous example before the neotys/neoload-controller line.

    -e CERTIFICATE_PASSWORD=your_password \
    -e CERTIFICATE_PATH=/tmp/cert.pkcs12 \
    -v /path/to/your/local/NeoLoad_Controller_Certificate.pkcs12:/tmp/cert.pkcs12 \

Parameters

These parameters refer to the command line argument of NeoLoadCmd. For more information, see List of arguments⁠. If the max memory limit is not set, it will be automatically set at the recommended ratio.

License

NeoLoad is licensed under the following License Agreement⁠. You must agree to this license agreement to download and use the image.

Note: This license does not permit further distribution.

Supported Docker versions

This image is officially supported on Docker version 1.11.0. Support for older versions (down to 1.6) is provided on a best-effort basis. Please see the Docker installation documentation⁠ for details on how to upgrade your Docker Deamon.

User Feedback

For general issues relating to NeoLoad you can get help from NeoLoad Support⁠ or NeoLoad Community⁠.