1. Installing and Running VirtServer

Applies to VirtServer 3.20.0, last modified on May 16, 2024

To use VirtServer, you need to install it, create (register) at least one user on it, and activate the license.

1. Install VirtServer

To install VirtServer, simply run its installer and follow the instructions you see on the screen. See VirtServer Installation.

2. Run VirtServer

To start the VirtServer process, simply run the following file:

  • On Windows: <VirtServer directory>\bin\VirtServer.exe

  • On Linux: <VirtServer directory/bin/VirtServer

  • Platform Independent/macOS: <VirtServer directory/bin/virtserver.sh:

    If you installed VirtServer with root permissions, then run it with root permissions, or specify the location of the VirtServer settings file (virt-server.yml) manually in the command line.

3. Create a user

You will need the user name and password to control VirtServer from ReadyAPI Virtualization. You need to create the user only once. There is no need to do this every time you launch VirtServer.

In version 3.1.0 and later

  • If you start VirtServer for the first time after installation or upgrade from an earlier version but have no users created in VirtServer, it will create a default user with administrator rights for you:

    User name: defaultUser

    Password: svp4ever

    You can then log in to the VirtServer web interface or use the command line to create more users.

    The latter option does not allow creating admin users.
  • If you upgrade to 3.1.0 from an earlier version and your VirtServer instance already has users, all the existing users will be given administrator rights.

  • If you start VirtServer for the first time after installation, it will ask you to specify the user name and password. Just follow the instructions you will see on the screen.

  • If you have a registered user, you can create an additional user. To do this, run VirtServer and specify the -a argument in the command line:

    • On Windows: <VirtServer directory>/bin/virtserver.bat -a userName:password

    • On Linux: <VirtServer directory>/bin/virtserver.sh -a userName:password

    • Platform Independent/macOS: <VirtServer directory/bin/virtserver.sh -a userName:password

Tip: If you do not specify the password, VirtServer will ask for it before creating a user.

We recommend that you create a user for each person working with VirtServer.

In VirtServer 1.5.0 and earlier, you have a user created by default:

User name: defaultUser

Password: svp4ever

You can configure the password in the VirtServer settings file (virt-server.yml) file.

4. Install a VirtServer license

If you run VirtServer for the first time, then it will ask you to install a license. Just follow the instructions outlined here.


See Also

ReadyAPI Virtualization

Highlight search results