Manager 8.7.3 Load Balancer Installation Guide for Windows

To request assistance with upgrading or to obtain the links to self-upgrade, please click here to fill out the Upgrade Request Form.

In this guide, we will run you through step by step to install qTest Manager v8.7.3 on a multiple Windows machines. Please go through the guide below thoroughly before starting your installations.

Before you begin

Before you install qTest Manager, make sure following things are done:

  • Your machine needs to satisfy qTest Manager's recommended hardware requirements
  • Prerequisite applications must be installed and running prior to upgrading qTest
    • PostgreSQL v9.5
    • Erlang
    • RabbitMQ v3.5.4
    • Redis v2.8.19

Install Prerequisite Softwares

Please follow these instructions to install prerequisite app(s) as mentioned above.

Create qTest Database in PostgreSQL server

This step is to create a database name which will be used when you configure qTest Manager.

There are different ways to create a database in PostgreSQL. For Windows, you can use pgAdmin which is installed together with PostgreSQL server.

  1. Open pgAdmin
  2. Enter your username and password to connect to your PostgreSQL server
  3. On the left panel, right click on Databases folder and select New Database...
  4. Enter your database name and click OK
  5. Take note of the database name

Install qTest Manager with Load Balancing Model


In case your team size is large (more than 1000 total users or 250 concurrent users), please consider the load balancing model as below. Using the load balancing model, you will need to install and configure multiple qTest Manager application nodes on different servers using the same qTest Manager's installation package.


  • Server 1: Prerequisite applications, including Redis and RabbitMQ, are installed on this server
  • Server 2: PostgreSQL server
  • Server 3: qTest Manager application node
  • Server 4: another qTest Manager application node. You can add as many application nodes as you need for your team size. In this example, we have 2 application nodes
  • A shared network drive is configured on Server 1. It should be accessible from all Application nodes to store attachments and search index
  • All application nodes must use the same PostgreSQL database as you created above and RabbitMQ virtual host
  • You will need to configure the Application nodes with your Load Balancer. You can use any load balancing tools or services which are being used in your organization. We do not provide the instruction to configure the Load Balancer
  • Your team members can access to qTest Manager via the URL to the Application nodes as configured in the Load Balancer

Set up a shared network drive

You will need to create a directory under a shared network drive which is accessible from all application nodes. Please follow this instruction to set up a shared network drive using NFS.

Install an application node

Installing an application node is totally the same as installing qTest Manager in a single server. Please follow this instruction but ignore these 2 sections Create qTest Database in PostgreSQL server and Enable secure connection to qTest Manager in the article. You can add as many node as you need.

Configure the Load Balancer and Enable secure connection

You will need to use any proxy tools (such as HAProxy, nginx) which are available in your organization to configure the Load Balancer and enable SSL for qTest Manager. In this document, we do not provide instructions to configure the proxy tool.

After setting up the Load Balancer, your users can access to qTest Manager using the URL configured in the Load Balancer.




Powered by Zendesk