Applies to ReadyAPI 3.3, last modified on July 03, 2020

Compatibility

The VirtServer version should match the version of ServiceV. We recommend using the same version of both, VirtServer and ServiceV.

To connect to VirtServer 3.1 and later using ServiceV, you need ReadyAPI 1.6 or later. Older versions won't be able to connect because they use a now-deprecated authorization method.
You cannot connect to VirtServer 3.0 and later by using ServiceV 2.8 or earlier if VirtServer’s compatibility mode is turned off. Update your ReadyAPI installation or turn the mode on.

Default approach

You work with VirtServers and virtual services from ServiceV. By default, ServiceV automatically searches for VirtServers available in your local network.

To view VirtServers it found, simply click the down button in the header of the ServiceV VirtServer panel. To connect to a VirtServer, simply select it in the drop-down list:

API testing with ReadyAPI: VirtServers found in local network

The default search works if the Use VirtServer discovery check box is selected.

Notes:

  • The search procedure finds only VirtServers that reside in your local network and that use the default port number (9090).

  • The VirtServer should be running when a search is being performed.

  • ServiceV prior to 3.0 does not find VirtServer 3.0 if the compatibility mode of the latter is turned off. Update the ReadyAPI installation or turn the mode on.

Specify connection properties manually

If the Use VirtServer discovery check box is clear, or if your VirtServer uses a non-default port, you have to add VirtServers to the list manually. To do this:

  • Click the button.

  • Specify the VirtServer parameters in the subsequent dialog:

    API testing with ReadyAPI: Adding VirtServer manually
    Parameter Value

    Server Name

    The name of the VirtServer in the list.

    Server URL

    The protocol, IP address and port of the computer where the desired VirtServer is installed.

    To connect to VirtServer 3.1 and later using ServiceV, you need ReadyAPI 1.6 or later. Older versions won't be able to connect because they use a now-deprecated authorization method.
    You cannot connect to VirtServer 3.0 and later by using ServiceV 2.8 or earlier if VirtServer’s compatibility mode is turned off. Update your ReadyAPI installation or turn the mode on.

Change VirtServer parameters

To change the name, address or port of a VirtServer:

  • Select the VirtServer in the list.

  • Click in the drop-down window and change the VirtServer's name, address and port in the subsequent dialog.

This works only for those VirtServers that you added manually. Auto-detected VirtServers cannot be modified.

Delete a VirtServer from the list

To delete a VirtServer from the list:

  • Select the VirtServer in the list.

  • Click in the drop-down window.

This works only for those VirtServers that you added manually. Auto-detected VirtServers cannot be deleted.

Specify a username and password

When you connect to the selected VirtServer, ReadyAPI asks you to specify the username and password:

API testing with ReadyAPI: Specifying the username and password to connect to VirtServer

Use the name and password of the user your admin has created (registered) for you on VirtServer.

Tip: All the users have the same permissions on VirtServer when connecting from ServiceV: they can connect to VirtServer and control virtual services.

ReadyAPI will remember the credentials you have specified and will not ask you to enter them again to connect to this VirtServer later unless your admin has enabled session timeouts. In this case, you will have to re-enter your credentials when your session expires.

Related topics

VirtServer Web Interface – Manage your VirtServer from the browser using the web interface.

Command-Line Interface Utility – Work with VirtServer using the command-line utility.

See Also

VirtServer Settings
User Tasks

Highlight search results