List of arguments

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.

-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>.

This argument requires the -project or -checkoutProject argument.

-leaseLicense

Specifies the license to lease.

 

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

 

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

-loadGenerators

Checks the YAML or JSON file describing the infrastructure to use.
For more information, see http://www.neotys.com

-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 Neotys 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 Neotys 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 to transfer test data 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.

-nlwebToken <token>

Activates the connection with NeoLoad Web and declares an access token.
This overrides any configuration made in the Preferences screen.

This argument requires the -nlweb argument.

-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 <file>

Uses a given project file (*.nlp).

For example -project "C:\Users\owner\Documents\NeoLoad Projects\ProjectName\ProjectName.nlp"

-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.

-SLAJUnitResults

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: nl_variable_env=preprod overrides constant-type variable named "env".

Discontinued arguments

Discontinued argument

Valid argument to use

-NLS

Use -NTS

-NLSLogin

Use -NTSLogin

-SVNLogin

Use -CollabLogin

-SVNURL

Use -Collab

Example commands

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.

-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.