You can set up a cluster of Parasoft Virtualize servers to achieve horizontal scaling and fault tolerance. Horizontal scaling is commonly used to optimize performance testing and cloud-based infrastructures for continuous integration and continuous delivery. Fault tolerance is commonly used to increase uptime and/or facilitate disaster recovery for business-critical backend systems.

In this section


  • Two or more Virtualize servers. The servers must be the exact same version, including the same service pack (if applicable) and all should be licensed for Virtualize command line (virtualizecli)
  • Two or more servers to host two or more instances of Virtualize
  • A load balancer that supports source address affinity persistence
  • Access to a source control system

Load Balancer Configuration

Configure your load balancer to route loads to each Virtualize server. If you are using Parasoft CTP or any other tool that interacts with assets through the Virtualize REST API, you will need to perform the additional configuration outlined in the following sections.

The following instructions apply to any load balancer, but we are using F5 Local Traffic Manager (LTM) as an example in order to provide general guidelines on load balancer configuration.

Configuring Source Address Affinity Persistence

This section describes how to configure source affinity persistence for Parasoft CTP. The same principles can also be applied to configure other any other tool that interacts with assets through the Virtualize REST API.

Source address affinity persistence ensures that all calls from CTP are routed to the same node. Session affinity is sometimes called "sticky sessions."

Enable source address affinity persistence for the following ports:

  • 9080 - Virtualize default HTTP connector (Required)
  • 9443 - Virtualize default SSL connector (Required)
  • 2424 - Data Repository (Required if a Data Repository exists on this node)
  • 9617 – The built-in event monitor provider service (Active MQ)
  • 9618 – The built-in server hit statistics provider service
  • 9619 – The built-in JDBC provider service

With F5 Local Traffic Manager (LTM), source address affinity persistence is configured by enabling the Match Across Services and Match Across Virtual Servers options. You could, for example, use the default source_addr profile or create a custom profile to enable source address affinity persistence. The following table shows the settings and values for the default source_addr profile.

SettingDescription Default Value
NameDefines a unique name for the profile. Required.No default value
Persistence TypeDefines the type of persistence profile. Required.Source Address Affinity
Match Across ServicesIndicates that all persistent connections from a client IP address which go to the same virtual IP address should also go to the same node.Enabled
Match Across Virtual ServersIndicates that all persistent connections from the same client IP address should go to the same node.Enabled
Match Across PoolsIndicates that the LTM system can use any pool that contains this persistence entry.Disabled
TimeoutIndicates the number of seconds at which a persistence entry times out.180
MaskDefines the mask the LTM system should use before matching with an existing persistence entry.
Map ProxiesEnables or disables proxy mapping.Enabled

Using Priority-based Member Activation

Priority-based member activation ensures that all calls from any origin will go to the main machine first (if possible). To configure this, set the first machine as the highest priority. For example, the following is a sample pool configuration file from F5 documentation for Local Traffic Manager:

pool my_pool {
         lb_mode fastest
         min active members 2
member priority 3
member priority 3
member priority 3
member priority 2
member priority 2
member priority 2
member priority 1
member priority 1
member priority 1

Virtualize Configuration

Ensure that the load balancer is configured so that changes are propagated to only one node before configuring Virtualize for load balancing. 

  1. Share the VirtualAssets project and all of its associated content (.pmpdd, .pvadd, .pjcdd, VirtualAssets.xml, .git, etc.) across the cluster. We recommend using a git fetch command as a post commit trigger to synchronize sharing.
  2. Enable refreshing using native hooks or polling:
    • From the GUI: 
      1. Choose Window> Preference> General> Workspace from the Virtualize main menu.
      2. Enable the Refresh using native hooks or polling option and restart the server.
    • From the command line:
      1. Open the org.eclipse.core.resources.prefs file in the <INSTALL>/.metadata/.plugins/org.eclipse.core.runtime/.settings/ directory.
      2. Add the refresh.enabled=true property, e.g.:

      3. Restart the server.

  3. Add the following Java option to your startup command on all nodes in the cluster to put the server.

  4. Restart your servers.

Deployments in the Virtualize cluster will eventually synchronize. When a request deploy is sent, a single server processes the request and then returns a response. The file system will notify the other servers in the cluster to make the changes required for consistency. In some cases, this may take several seconds. As a result, there may be a brief time when some servers are not yet aware of a deployment that happened on another server.

Parasoft Data Repository Configuration

Parasoft Data Repositories, which are based on MongoDB, should be configured for clustering by identifying a primary Data Repository (the one that has the data you want replicated) and creating a replicate set. To do this, follow this procedure (taken and modified from the MongoDB documentation):

  1. Stop all of the Data Repositories you want to become part of the replica set.
  2. Start the primary repository server:

    ./bin/mongod --port 2424 --dbpath repositories

    If the "repositories" directory does not exist, you should create it.

  3. Connect to the mongo shell and create the admin database.

    ./bin/mongo --port 2424
    use admin
  4. Run the following command to create admin users:


    If the command fails because the user already exists, run the following command:

  5. Stop the primary mongo server.
  6. Create your key file. The following example shows the basic commands:

    openssl rand -base64 741 > mongodb-keyfile
    chmod 600 mongodb-keyfile
  7. Copy the key file to each member of the replica set.

  8. Start each member of the replica set with the following command:

    ./bin/mongod --replSet "rs0" --dbpath repositories --port 2424 --auth --keyFile <mongodb-keyfile>
  9. On the primary server, connect to the mongo shell and provide the password when prompted:

    ./bin/mongo localhost:2424/admin -u <admin_user> -p
  10. Run the following commands to verify authentication:

    use admin
    db.auth("<siteRootAdmin>", "<password>");

    The shell should return 1.

  11. Initiate the replica set with the following command:

  12.  Verify your replica set configuration with the following command:


    If the host for your primary server is incorrect, use the following commands to change the host:

    cfg = rs.conf()
    cfg.members[0].host = ""
  13.  For each secondary server, run the following command in the primary server's mongo shell:


Additional Information

  • CTP and Virtualize Desktop can modify live assets. When nodes communicate through the load balancers, CTP and Virtualize will treat the cluster as a single server. The name of the server sent to CTP (as configured in the Virtualize server or must be the same on all nodes.
  • Recording is not supported in a clustered environment. Recording should be performed on your staging infrastructure prior to asset promotion.
  • All AUT traffic is sent to the Load Balancer and filtered appropriately using the settings sticky sessions.
  • Ensure that changes are sent to only one server. The load balancer for the Virtualize servers should be configured to send configuration/‘change’ messages to a single node in the cluster. This should be done for the port (defaults are 9080/9443) and/or path (/axis2 SOAP or /soavirt/api/ REST) that handles ‘changes’ sent from the Virtualize desktop or CTP.
  • Ensure consistent behavior from stateful assets. The Virtualize Server load balancer must direct all traffic for a single session to a single node. 
  • Traffic for a stateful asset should only be sent to one node. Traffic should not be run in "first available" mode to ensure that multiple assets do not change the state multiple times.
  • If stateful assets are intended to hold their state across sessions, then the nodes need to store the state in a synchronized data source, i.e., a data repository. Be aware, however, that there will be latency between the data repository updates and subsequent requests for the updated information. 
  • No labels