VirtRunner Command Line

The fully qualified path to the project that contains the virtual services to be run. If the file name or path includes spaces, enclose the entire argument in quotes.

Examples:

Commands the runner to disable blocking. This is required if you are going to run VirtRunner with the nohup command on Linux or as a service on Windows.

Specifies a value of a system property for the test run. The specified value will override the variable’s value during the run.

Usage: -D<variable>=<value>. If the value includes spaces, enclose the entire argument in quotes. To override several variable values, specify the -D argument several times.

Example:

Specifies the root directory, to which the runner will export results of the virtual service.

Example:

Specifies a value of a global property for the test run. The specified value will override the variable’s value during the run.

Usage: -G<variable>=<value>. If the value includes spaces, enclose the entire argument in quotes. To override several variable values, specify the -G argument several times.

Example:

Commands the runner to create coverage reports.

Coverage reporting works only when you run a SOAP virtual service. To use coverage reports in your tests, you need a ReadyAPI Virtualization license. Sign up for a free trial to try how it works.

Specify a virtual service for the run. Use the following syntax:

where –

• virt-name – The name of the virtual service to start. Specify the name as it is shown in the virtual service editor. If the name includes spaces, enclose it in quotes (see an example below).

• port – Optional. The port the virtual service will use during the run. This parameter overrides the port number specified in properties of the virtual service.

  • If your project contains several REST or SOAP virtual services using the same port, specify different paths for them.

  • If there is a JDBC or TCP virtual service sharing a port number with any virtual service, neither of them will start.

• path – Optional. The “path” part of the service’s URL. This option overrides the path specified by the service’s properties. The path must start with a slash –/.

Example:

To run several virtual services, separate them with commas: -m<virt1:port1:path1>,<virt2:port2:path2>,… (see an example below).

If you do not use the -m argument, the runner will start all the virtual services from your project. The runner will use the ports and paths that properties of these virtual services specify.

Commands the runner to open generated coverage reports in your default browser.

This argument is significant only if you also use the -g argument.

Specifies a value of a project property for the test run. The specified value will override the property’s value during the run. Typically, it is used to override custom properties.

Usage: -P<variable>=<value>. If the value includes spaces, enclose the entire argument in quotes. To override several variable values, specify the -P argument several times.

Example:

Commands the runner to save the project after the virtual service run is over. This may be useful if your service stores data to the project during the run.

Specifies the workspace settings to use during the virtual service run. By default, these settings are stored in the <User directory>/.readyapi/readyapi‑settings.xml file. This argument allows you to specify another settings file for the run. It may be useful to use different proxy, SSL, HTTP and other settings without changing them in ReadyAPI.

Specifies the password for your settings file.

Specifies the project password if the project is encrypted.