VirtServer Command-Line Arguments

Applies to VirtServer 3.21.0, last modified on June 11, 2024

You can send upstart commands to the VirtServer application from the command line. The main purpose is to manage licenses and users that can work with virtual services. To work with virtual services, for example, deploy or undeploy them, you use a separate command-line utility.

In general, the command-line syntax is as follows:

virtserver [options] [<settings-file>]

Here is the list of available command-line options:

Short Form Long Form Description
<settings-file> The name of the settings file (.yml) that VirtServer will use for work. If you skip the file name, VirtServer will load the file from the default location to which the file is installed. See VirtServer Settings File for details.
-a <user> –adduser <user> Registers a user with the specified name on VirtServer. VirtServer will then ask you to specify a user password. The password cannot be an empty string. You need to have at least one user to connect to your VirtServer from the ReadyAPI Virtualization panel.
-d <user> –deleteuser <user> Deletes (unregisters) the specified user. You do not need a user password to do this.
-e <user> –edituser <user> Changes the password of the specified user. After you send the command, VirtServer will ask you to specify a new password.
-h –help Displays information on available command-line arguments.
-u –listusers Lists all users registered on VirtServer.
-x –deactivatelicense Deactivates your current VirtServer license. Applies to legacy ProtectionLS licensing which is retiring, please refer to VirtServer CLI instead of the startup arguments for licensing commands.
Note: Upstart commands will not work when VirtServer is configured for OIDC. Users must be added to the OIDC Provider (Okta) with the appropriate group membership before logging in to VirtServer using PKCE or Device Login, to get added to the instance. To find out more about this, please refer to this topic.


Here are some examples of how you can work with VirtServer via command line:

Deactivate a license

The following command deactivates the VirtServer license:

VirtServer- -x

After you execute this command line, VirtServer will ask you to confirm that you want to deactivate the license.

Add a new user

The following command will add a JohnSmith user to your VirtServer instance:

VirtServer- -a JohnSmith

After running this command line, you will need to specify the user password.

Edit user data

The following command line edits the password of the JohnSmith user. The command must reference to an existing user:

VirtServer- -e JohnSmith

After you run this command, VirtServer will ask you to specify a new password.

See Also

Admin Tasks
Command-Line Interface Utility

Highlight search results