Controller property key

Environment variable

[Recorder]

controller.recorder.pause=1000

NL_PROPERTY_RECORDER_CONTROLLER_RECORDERPAUSE=1000

The standard format is: "NL_PROPERTY_CATEGORY_MYPROPERTY=value"

Argument

Action

-baseLabel <label>

Labels the base test when generating a comparison report. The default value is Base.

This argument requires the -comparisonReport argument.

-baseTest <baseTest>

Names the baseTest to use when generating the comparison report.

This argument requires the -comparisonReport argument.

-cacheUpdate

Launches a Virtual User iteration before starting test to update cache information.

-checkoutProject

Checks out a project.
-checkoutProject "<project name>"

For example -checkoutProject "ProjectName"

-Collab

Specifies the SVN third-party collaboration server URL. This argument requires the -checkoutProject argument.

-Collab "<protocol>://<host name>:<port>/<path>".

For example -Collab "svn://svnServerAddress:3690/neoload/"

This command is necessary when using an SVN third-party server to check out a project. It is not possible to clone a Git repository. In command line, the NeoLoad project has to be cloned with a Git client.

-CollabLogin

Specifies the collaboration server login information.

-CollabLogin "<login>:<hashed password>", or

-CollabLogin "<login>:<private key>:<hashed passphrase>", or

-CollabLogin "<login>:<hashed password>:<private key>:<hashed passphrase>"

For example -CollabLogin "admin:VyVD4FQg=="

This command is necessary when using a third party server to check out a project.

-comparisonReport <files>

Generates test comparison reports (comma separated list of report files). NeoLoad configures the report format from the file extension (.html, .pdf, .xml). The base report is set using the -baseTest argument.

-currentLabel <label>

Labels the current test when generating a comparison report. The default value is Last.

This argument requires the -comparisonReport argument.

-customReportContents

When this argument is set, the report will be generated based on the last report contents settings defined for this project. Otherwise, the report will be generated with default settings.

-debug

Runs the scenario in debug mode.

-description <test description>

Describes the test.

-exit

In GUI mode, exits NeoLoad when the test is completed. When a shared license is used, it is automatically released.

-exitCodeFailIgnore

Sets the exit code to "0" even when if test status is failed and should be "1".

-exportRaw <file>

Exports in the defined file the raw results of all the Transactions of a test

-help

Displays the list of argument used.

-inactivateKey

Deactivates the NeoLoad standard license key for this computer.

-launch <scenario>

Starts the test with the specified scenario from the project specified by -project <file>. When a YAML or JSON file including scenarios to launch has been specified (via the -project argument), the -launch argument allows launching a scenario included in the YAML or JSON file.

For more information, see the YAML syntax documentation.

Warning: If having the same name, the scenario included in the YAML or JSON file replaces the scenario existing in the NeoLoad project. Also, if the scenario available in the YAML or JSON file does not exist in the NeoLoad project, it is then added in the project.

Warning: When a YAML or JSON file is declared with the -project argument but when no infrastructure is declared via the -loadGenerators or --override-lg argument, the populations of the specified scenario will use the local host to launch the load test.

This argument requires the -project or -checkoutProject argument.

For more information, see NeoLoad as-code.

-leaseLicense

Specifies the license to lease.

-leaseLicense "<license id>:<virtual user count>:<duration in hours>"

For example -leaseLicense "MCwC==:50:2"

Specifies the license to lease including Web VUs and SAP VUs.

-leaseLicense "<license id>:<web virtual user count>;<sap virtual user count>"

For example: -leaseLicense "44jMC25A78wyC13==:50;50:2"

-leaseServer

Allows specifying the license server to use (NTS or NeoLoad Web) to lease a license.
Example to launch a project by leasing a license with NeoLoad Web:
NeoloadCmd -noGUI -project ~/neoload_projects/testLease/testLease.nlp -launch scenario1 -leaseServer nlweb -leaseLicense 50:1

-loadGenerators

Checks the YAML or JSON file describing the infrastructure to use.
For more information, see the infrastructure descriptor format.
If using an infrastructure including Cloud Load Generators, the -NCPLogin argument must also be used to provide the credentials to connect to NeoLoad Cloud Platform.

-maxVuhEstimation <value>

Specifies the maximum number of VUH that can be estimated to launch the test.

If the number of VUH estimated is lower or equal to the parameter value, the test can be launched.

Otherwise, if the number of VUH estimated is greater than the parameter value, the test will not start.

Information: To prevent the usage of VUH, add the argument with value 0, example:

-maxVuhEstimation 0

-monitoredHosts <Hosts>

Enables hosts to monitor during the test (comma-separated list of monitored machine names). Using this argument, only the listed machines are enabled.

-NCPLogin

Connects to NeoLoad Cloud Platform using the specified login and password. The password hash command line utility must be used to hash the password before using this command.

This command is necessary when using NeoLoad Cloud Platform to launch a load test with a Cloud Load Generator or Virtual User session.

The format must be as follows: -NCPLogin "<login>:<hashed password>" or <token>

For example: -NCPLogin "loginUser:VyVmg=="

For more information, see How do I use the Password Scrambler tool?

-nlweb

Enables test data transfer to NeoLoad Web.

This argument can only work if the connection with NeoLoad Web has been activated and a token has been declared. These 2 operations can be performed:

• either via the command line with the -nlwebToken argument below
• or in Edit > Preferences > General settings > NeoLoad Web

-nlwebAPIURL <APIURL>

Specifies the URL of the NeoLoad API in order to connect with NeoLoad Web when it is deployed on-premise.

This argument requires the -nlweb argument.

-nlwebProxy

Allows connecting NeoLoad Web by using a proxy. The argument must be used as follows: -nlwebProxy http://{login:password}@{myproxy}

This argument requires the -nlweb argument.

This argument can also be used to connect a Controller Agent or Load Generator Agent to NeoLoad Web by using a proxy. For more information, see Platform set-up for Runtime.

-nlwebToken <token>

Allows authenticating to NeoLoad Web with an access token.

This overrides any configuration made in the Preferences screen.

-nlwebWorkspace <workspace>

Specifies the Workspace (name or ID) to use in NeoLoad Web

-nlwebTest <Test>

Specifies the NeoLoad Web Test (name or ID) of the running test. The configuration of the Test in NeoLoad Web will not change. This argument requires the -nlwebWorkspace argument.

-nlwebZoneId

Allows overriding the Zone of the resource (Controller or Load Generator Agent). Example: -nlweb [MyZoneID]

-noGUI

Launches NeoLoad in non-GUI mode.

This argument can be used in 2 different ways:

• Either to launch a test directly.
  In this case, it requires the -project or -checkoutProject argument and the -launch argument.
• Or to access NeoLoad APIs, for example as part of a Continuous Integration process.
  In this case, NeoLoad starts without the need to require any argument.

-NTS

Connects to Neotys Team Server (NTS) at the specified host name and port.
-NTS "http://<host name>:<port>"

For example -NTS "http://serverName.com:8080"

This command is necessary when using NTS to lease a license and/or to check out a project.

-NTSLogin

Connects to Neotys Team Server using the specified login and password. The password hash command line utility must be used to hash the password before using this command.
-NTSLogin "<login>:<hashed password>" or

-NTSLogin "<login>:<private key>:<hashed passphrase>" or

-NTSLogin "<login>:<hashed password>:<private key>:<hashed passphrase>

For example -NTSLogin "loginUser:VyVmg=="

For more information, see How do I use the Password Scrambler tool?

This command is necessary when using NTS to lease a license and/or to check out a project.

-NTSCollabPath

Specifies the Neotys Team Server (NTS) configuration parameter path.

-NTSCollabPath "/repository_name"

This command is necessary when using NTS to lease a license and/or to check out a project.

--override-lg <parameter>

Short form: -L <parameter>

In the context of jobs automation and Cloud testing, replaces Load Generators planned in the scenario with other Load Generators.

If you want to override LGs for a specified population, use <population_name>=<path to txt file> for the <parameter> option.

If you want to override LGs for any population, use <path to txt file> for the <parameter> option.

Load Generators can be replaced for a single or several populations in a same scenario.

This argument can be repeated as needed.

The TXT file must contain the list of the Load Generators separated by a line drop.

Examples of .TXT file content:
host1
host2@zone

To override populations x and y:
NeoloadCMD -project project.nlp -launch scenario1 -L x=lg1.txt -L y=lg2.txt

To override all populations:
NeoloadCMD -project project.nlp -launch scenario1 -L lg.txt

-publishTestResult

When working with a shared project (on NTS or SVN), the results are published after the scenario is run. It is not possible to publish a test result for a project shared with Git.

-project <files>

Uses a given project file (*.nlp). A YAML or JSON file including the test element(s) to launch can optionally be added. Also, several YAML or JSON files can be declared without declaring any ".nlp” file. For more information, see NeoLoad as-code.

For example: NeoLoadCmd.exe -project "C: /Work/Demos/MyProject/MyProject.nlp" "C: /Work/Demos/MyScenarios.yaml" -launch MyScenario1

Other example without declaring the “.nlp” file: NeoLoadCmd.exe -project "C: /Work/Demos/MyProject/MyDesign.yaml" "C: /Work/Demos/MyScenarios.yaml" -launch MyScenario1

For more information, see YAML syntax documentation.

-report <files>

Generates a test report at the end of the test. NeoLoad configures the report format from the file extension (.html, .pdf, .xml).

For example -report "C:\jenkins\workspace\myReport.xml,
C:\jenkins\workspace\myReport.html"

This argument requires the -project or -checkoutProject argument and the -launch argument.

-SLAJUnitMapping

Maps an "acceptable" SLA alert to "pass" or "fail". Defaults to "pass".
-SLAJUnitMapping "<pass/fail>"

For example -SLAJUnitMapping "fail"

This argument requires the -SLAJUnitResults argument.

-SLAJUnitReport

Creates a jUnit test results file based on SLA results. The generated XML report is jUnit compatible.
-SLAJUnitReport "<output file path>"

For example -SLAJUnitReport "C:\jenkins\workspace\nljunit.xml"

This argument requires the -project or -checkoutProject argument and the -launch argument.

-SLAJUnitResults

Warning: This command is deprecated. The command to use is -SLAJUnitReport.

Creates a jUnit test results file based on SLA results.
-SLAJUnitResults "<output file path>"

For example -SLAJUnitResults "C:\jenkins\workspace\nljunit.xml"

This argument requires the -project or -checkoutProject argument and the -launch argument.

-testResultName

It is the name of the test results published to Neotys Team Server and found in the NeoLoad GUI. It may include a date/time stamp, such as -TestResults "-$Date{yyyy-MM-dd_HH.mm}" on Windows or -TestResults "-\$Date{yyyy-MM-dd_HH.mm}" on Linux. The sequence of replacement characters is replaced by the current date.

Can be used together with the -publishTestResult argument.

-testResultName "<test results name>"

For example:
Windows: -testResultName abc-$Date{yyyy-MM-dd_HH.mm} becomes abc-2014-01-22_14.37
Linux: -testResultName abc-\$Date{yyyy-MM-dd_HH.mm} becomes abc-2014-01-22_14.37

-variables <constant1=value1,constant2=value2>

Overrides constant-type variable defined in project. If no variable is defined, a constant-type variable is created.

For example:

-variables env=preprod

This command overrides constant-type variable named "env" defined in project with the preprod value.

Information: It's possible to override constant-type variables with Environment Variables, for example: nlvariableenv=preprod overrides constant-type variable named "env".

Discontinued argument

Valid argument to use

-NLS

Use -NTS

-NLSLogin

Use -NTSLogin

-SVNLogin

Use -CollabLogin

-SVNURL

Use -Collab

Command

Explanation

NeoLoadCmd -project projects/jpetstore/jpetstore.nlp -launch scenario1 \

-noGUI -report projects/jpetstore/reports/report.xml

NeoLoadCmd: starts NeoLoad.

-project projects/jpetstore/jpetstore.nlp: This project file is opened.

-launch scenario1: This scenario is started.

-noGUI: The NeoLoad GUI is not opened.

-report projects/jpetstore/reports/report.xml: This report file is created.

NeoLoadCmd -project projects/jpetstore/jpetstore.nlp projects/jpetstore/scenarios.yaml -loadGenerators projects/jpetstore/infrastructures.yaml -launch scenario1 -noGUI -report projects/jpetstore/reports/report.xml

NeoLoadCmd: Starts NeoLoad.

-project projects/jpetstore/jpetstore.nlp projects/jpetstore/scenarios.yaml: This project file is opened and the scenarios are added or replaced in the given project.

-loadGenerators projects/jpetstore/infrastructures.yaml: This infrastructure is used from the scenario selected.

-launch scenario1: This scenario is started.

-noGUI: The NeoLoad GUI is not opened.

-report projects/jpetstore/reports/report.xml: This report file is created.

-checkoutProject Project51 -launch "scenario1" -noGUI -NTS "http://10.0.5.11:18080" -NTSLogin "noure:QuM36humHJWA5uAvgKinWw==" -leaseLicense "MCwCFC54ZB4sNH1q9RnNrlKi7MM0q+20AhRNmr10XW3c3qIdrzSpyQbAIBCwqQ==:50:1" -exit -NTSCollabPath "/repository_1"

Lease a license from Neotys Team Server (NTS) and check out a project from NTS.

-checkoutProject: This checks out the project from NTS.

-NTS "http://192.168.0.56:18080": This specifies the NTS server for the license and the project.

-NTSLogin "user:AgY58iAvgK==": This specifies the User ID for the NTS server.

-NTSCollabPath "/repository_1": This specifies the repository path on the NTS server.

Note: The checkoutProject command will only use the NTS server specified if the -NTSCollabPath is also specified.

-checkoutProject Project51 -launch "scenario1" -noGUI -NTS "http://10.0.5.11:18080" -NTSLogin "noure:QuM36humHJWA5uAvgKinWw==" -leaseLicense "MCwCFC54ZB4sNH1q9RnNrlKi7MM0q+20AhRNmr10XW3c3qIdrzSpyQbAIBCwqQ==:50:1" -exit -Collab "svn://svnServerAddress:3690/neoload/" -CollabLogin "admin:VyVD4FQg=="

Lease a license from Neotys Team Server (NTS) and check out a project from a third-party SVN server.

-checkoutProject: This checks out the project from NTS.

-NTS "http://192.168.0.56:18080": This specifies the NTS server for the license.

-NTSLogin "user:AgY58isvLQES7uAvgK==": This specifies the User ID for the NTS server.

-Collab "svn://svnServerAddress:3690/neoload/": This specifies the third-party SVN server to use to check out the project.

-CollabLogin "admin:VyVD4FQg==": This specifies the User ID for the third-party SVN server.