Execute on the command line

  1. Execute <install-dir>\bin\NeoLoadCmd.exe
  2. Type the commands to execute the NeoLoad options you want.

  1. Execute <install-dir>/bin/NeoLoadCmd
  2. Type the commands to execute the NeoLoad options you want.


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 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 a third party server to check out a project.

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

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

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

-nlweb

Enables to transfer test data to NeoLoad Web.

 

This argument works if and only if the following parameters have been set in the NeoLoad Web section of NeoLoad General settings Preferences:

- the "Activate data transfer to NeoLoad Web" option is enabled

- an access token has been pasted

 

-noGUI

Launches NeoLoad in non-GUI mode.

This argument requires the -project or -checkoutProject argument and the -launch 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=="

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.

-publishTestResult

When working with a shared project, the results are published after the scenario is run.

-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


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.


    Home