Installing Service Virtualization on Windows

This section explains how to install Service Virtualization using the installation wizard.

If you are upgrading from a previous version of Service Virtualization, make sure to first review the upgrade information in Upgrade and Migration.

For command line installation, see Command Line Installation.

Install Service Virtualization

  1. Make sure to review the prerequisites for installation. For details, see System Requirements.

    Note: If you do not have a supported database server installed, you can install the Microsoft SQL Server Express during installation. It is included in the Service Virtualization installation package.

  2. Insert the Service Virtualization installation DVD into your drive, or navigate to the installation folder and run autorun.exe. The Welcome screen displays the following options:

    • Install Service Virtualization Server 4.20
    • Install Service Virtualization Designer 4.20
    • Install AutoPass License Server

    • Install SQL Server® 2014 Express


    Service Virtualization Server: A valid product license is required to start the application. The installation wizard installs a 30-day trial license. After successful server installation, see Server Licensing for the additional steps required for license installation.


    • For details, refer to the AutoPass License Server documentation, included with the Service Virtualization installation files.
    • The Service Virtualization installation package contains the AutoPass License Server distribution for 64-bit Windows and Linux in the dat\prerequisites\AutoPass License Server 10 folder.
    • For details about working with the AutoPass License Server in Service Virtualization, see the Service Virtualization User Guide or the Service Virtualization Help Center (

    SQL Server:

    • Installation of Microsoft® SQL Server® 2014 Express is required only if no other supported database is available for the Service Virtualization installation.

    • SQL Server must be installed by an admin user, or by a user with the following user rights:

      • Backup files and directories (SeBackupPrivilege)

      • Debug Programs (SeDebugPrivilege)

      • Manage auditing and security log (SeSecurityPrivilege)

      Details can be found at

    • To run the installation, you must have Administrator access rights.

  3. Select an option to start the installation.

    You will be prompted to install all required prerequisites that are not yet installed. Follow the installation wizard instructions to install the product. For details on installation wizard options, see Installation Wizard Options.

The Server and Designer installation processes generate log files, which are saved in the following locations:

  • Server: %ALLUSERSPROFILE%\Micro Focus\Service Virtualization Server\logs\ServiceVirtualizationServer.installation.log

  • Designer: %APPDATA%\Micro Focus\Service Virtualization Designer\logs\ServiceVirtualizationDesigner.installation.log

Installation Wizard Options

This section describes the options available when installing Service Virtualization Designer and the Service Virtualization Server:

  • Installation destination folder. On the Custom Setup page, you can change the installation destination folder using the Browse button.
  • Database configuration. On the Database Setup page, enter the required values. If the database does not exist, the installation wizard creates it with the name you specify.

    Caution: Each Designer and Server installation requires its own dedicated database that is not shared with any other Designer or Server. If multiple Service Virtualization instances use the same database, data loss and unexpected behavior may occur.

    Name Description
    Database Type

    Select the MS SQL Server, Oracle, or PostgreSQL database.

    If you are upgrading: Custom functions are executed directly on the database layer. If your existing virtual services contain custom functions, changing the database provider can render them non-functional.

    For more information on custom functions, see the Service Virtualization User Guide or the Service Virtualization Help Center (

    Data Source

    The data source part of the connection string.

    Basic syntax:

    MSSQL: server\instance,port

    host/servicename, host:port/servicename, or host/servicename:port

    This works for SERVICE_NAME and not for SID. If you want to connect using SID, you must use the connection string. For example:


    PostgreSQL: server
    Default: localhost\SQLExpress_SV
    • If you are working with the full SQL Server version, you can exclude the instance name to use the default instance.

    • If you are working with SQL Server Express, you must specify the exact database instance name.

    • If you are working with Oracle and have problems connecting, you can use SQLPlus to verify if you are able to connect to the Oracle database by opening a command window and typing: sqlplus user/pwd@server:port/serviceName
    • If you are working with PostgreSQL and have problems connecting, use the psql utility or the pgAdmin GUI tool to verify your credentials.

    Database Name

    The database name.

    For MS SQL Server or PostgreSQL only.


    Optional: Additional database connection properties. The properties you specify are appended to the connection string after the server and instance parameters.

    For example:

    • Use Encrypt='true' to use an SSL connection to the database server.
    • Use Proxy User Id=pUserId;Proxy Password=pPassword to specify proxy authentication for connection to an Oracle server.

    For MS SQL Server or PostgreSQL only.

    If the Create option is selected:

    • Creates the database during product installation.
    • Recreates the database if it already exists.
    • Removes the database when the product is uninstalled.

    If you clear the Create checkbox:

    • Uses the existing database.
    • Drops all user objects in the specified database to prepare a clean database for the application.


    • For Service Virtualization Server: To maintain your data, make sure to run the Backup and Restore options provided by Service Virtualization.

      • During Server upgrade: The Backup and Restore options are provided later in this installation wizard.
      • During Server reinstall: Manually run the Backup and Restore options described in Server Backup and Restore.
    • To install the product successfully, the database user must have the proper privileges.

      • If you select the option to create the database automatically during installation, the database user must have sufficient privileges to create the database—the SQL server roles dbcreator and public, and the database role db_owner.
      • For the PostgreSQL database, the CREATEDB role is required.
      • If you are using an existing database, the database user must have sufficient privileges to create the database schema—the SQL server role public and the database role db_owner.
    Authentication The database server authentication type.

    The database server authentication user.

    For SQL authentication only.


    The database server authentication password.

    For SQL authentication only.

    Test Connection Tests the database connection.
    Connection String View or modify the complete database connection string.
  • Additional installation options:

    Name Description
    Performance Monitor Remote Access To create a new user with privileges to remotely read the performance monitor, select Create performance monitor user. This account can be used for remote access to the application’s performance monitor counters. For details on the Service Virtualization performance counters, see the Service Virtualization User Guide or the Service Virtualization Help Center (
    Server Encryption

    Enable server configuration encryption. Encrypts all passwords, certificates, and other sensitive configuration data stored in the embedded or standalone Service Virtualization Server, using a user-defined password.

    For more details on encryption, see Password Encryption.

    Management Endpoint

    For Server installation:

    Enable authentication for Server management endpoint:

    • Encrypts the communication between the Service Virtualization Server and clients using TLS/SSL security.
    • Requires user credentials to access the secured server.

    HTTPS port: The port number of the management endpoint. Leave the default port number 6085, or enter another available port number between 1 and 65535.

    For more details on server authentication, see Server Authentication.

    Note: Working with a secured Service Virtualization Server is not supported for integrations with some older versions of Service Test or LoadRunner.

    For Designer installation:

    Enable authentication for management endpoint of Designer's embedded server:

    • Encrypts the communication between the Designer's embedded server and clients using TLS/SSL security.
    • Requires user credentials to access the secured server.

    Note: The port number of the management endpoint of the Designer's embedded server can be set in the file %ALLUSERSPROFILE%\Micro Focus\Service Virtualization Designer\DesignerSharedConfiguration.xml. This file is created when the Designer is started for the first time.

    The following options are available when installing the Service Virtualization Server only:
    Service Virtualization Management Configures the port for the Service Virtualization Management Interface. The Management Interface uses HTTPS communication. The default port is 6086. For details on working with the Management Interface, see the Service Virtualization User Guide or the Service Virtualization Help Center (

    Allow everyone to use the Management Endpoint and SVM (unsecure)  

    Enables every authenticated user to access and use the Service Virtualization Server's Management Endpoint and Service Virtualization Management.

    Leave this check box blank (default) to enable only members of the local system's Administrators group to access and use these features.


    • This option takes effect only if Service Virtualization user groups do not yet exist. The installer does not modify existing user group settings.

    • You can modify the list of authenticated users after installation by modifying the Service Virtualization user groups. For details, see Service Virtualization User Groups.

    Windows Services

    Installs the following:

    • The Windows service that starts the Service Virtualization Server with each computer startup. You can also run the Server as a standalone console application.
    • The Windows service that starts the Service Virtualization Management interface.

    Accept the default log on to use the local system account, or enter a different user account.

  • HTTPS Server Certificate options:

    Service Virtualization requires a certificate with a private key for the Server Management endpoint (if secured), the default HTTPS Gateway agent, and as Certificate Authority for generating certificates in the default HTTP Proxy agent.

    Select an option to either import a certificate or for Service Virtualization to generate a new self-signed certificate during installation.

    Generate new self-signed certificate Service Virtualization generates a self-signed certificate. To use a trusted certificate, import one generated by your certificate authority.
    Import from .p12 file

    The file must be a valid .p12 file with a public and private key pair.

    Filename: Specify the full path and name of the .p12 file.

    Password for encryption of private key on file system

    Enter a password.

    Default: changeit

Back to top

Changing database configuration properties

You can change the values for all database properties that were specified while installing Server or Designer. For example, you can change the data source and authentication.

To modify database configuration properties:

Run ConfigTool.exe db-setProperties command, followed by the properties to modify.

ConfigTool.exe db-setProperties ["server"|"designer"] [dbType] [datasource] [properties] [dbName] ["WinAuth"|"SqlAuth"] ?[username] ?[password]

where: ["server"|"designer"] specifies the configuration to change (select one). The remaining items are described in Installation Wizard Options.

Example 1. The following example updates the Server database properties to an Oracle database that uses SQL authentication with the specified user name and password.

ConfigTool.exe db-setProperties server oracle "" "" SqlAuth MyName MyPassword

Example 2. The following example updates the Designer database properties to a local MS SQL database instance named my_designer that uses Windows authentication.

ConfigTool.exe db-setProperties designer mssql localhost\SQLExpress_SV "" "my_designer" WinAuth

Back to top