Configuration

Configure a NeoLoad scenario

Execute a NeoLoad scenario

You can execute a NeoLoad scenario in an existing TeamCity job.

To execute a NeoLoad scenario, follow these steps:

1. Select the project where you want to execute a NeoLoad scenario.

2. Select the job where you want to execute a NeoLoad scenario.

3. Click Edit Configuration Settings.

4. Click Build Steps.

5. In the Build Steps section, click Add build step and select NeoLoad.

6. In the newly created step, enter the information required to execute the NeoLoad scenario.

NeoLoad Runner Parameters section

• NeoLoad executable path:

  • If NeoLoad is deployed on the agents as a Tool, use the variable teamcity.tool.<NeoLoad installed tool id>.
    

    For example, if NeoLoad has been installed as a zip archive named "neoload.zip" as explained in Recommendations, the variable to use is %teamcity.tool.neoload%/bin/NeoLoadCmd.

  • If NeoLoad is installed on an agent, use the absolute path of the NeoLoad installation.
    

    For example,
    on Unix: /home/myLogin/Neoload5.4.0/bin/NeoLoadCmd
    on Windows: C:\Program Files\NeoLoad 5.4.0\bin\NeoLoadCmd.exe

• Collaboration Server:

  • If the project is located on the hard drive, select "The project is on Hard Drive" and enter the absolute path of the NeoLoad project file in the NeoLoad project path field.

  • If the project is shared, use a SVN or GIT plugin to check out your projects and enter the absolute path of the NeoLoad project file in the NeoLoad project path field.

License Parameters section

• License Server: configure license leasing through NeoLoad Web.

• Number of VUs: enter the number of Virtual Users you want to use for your test.

• Leasing duration: enter the duration required for your test

Override a NeoLoad project with a YAML or JSON file

A YAML or JSON file containing one or more scenarios to launch can be used to override the existing scenarios of your NeoLoad project. For more information, see www.neotys.com.

Caution: Only scenarios with the same name will be overridden.

To override a NeoLoad project with a YAML or JSON file

1. Follow the steps 1 to 5 from Execute a NeoLoad scenario.

2. In the Custom command line options field enter:

   • -project <path to the YAML or JSON file> or -project "<path to the YAML or JSON file>" if the path includes spaces.

   • If you want to use a YAML or JSON file specifying the infrastructure to use, then add -loadGenerators "<Path to the infrastructures definition YAML or JSON file>".
     

     Example: -project "C:/Work/Demos/scenarios.yaml" -loadGenerators "C:/Work/Demos/infrastructures.yaml"

Define NeoLoad Trend Graphs

You can define as many customized graphs as you want from your NeoLoad project. Each graph can display several curves.

Note: You need to run a build before being able to add custom graphs.

To add a custom graph, follow these steps:

1. Select the job where you want to execute a NeoLoad scenario and select the Statistics tab.

2. Click Add new chart.

3. In the Add Custom Chart screen, enter the information required to define a custom graph:

   • Enter a name to identify the graph.
     

     Tip: NeoLoad statistics names are prefixed with "NeoLoad".

   • In Add a statistic value, select a statistic value for each curve you want to trace in the graph.

4. Click Save.