9.1.5 OnPremise Load Balancing Upgrade Guide for Windows Summer 2018


In this article, we provide step-by-step instructions to upgrade qTest components from 9.0 to 9.1.5 OnPremise on a load balancing environment, where qTest components are running on their own Windows server. Please read the instructions thoroughly before starting your upgrade.

To request assistance with upgrading or obtain the self-upgrade links, complete the Upgrade Request Form and reference the OnPremise Upgrades Guide.

Note: If you are performing a fresh install, use the OnPremise New Install Form and reference the OnPremise Install Guide.

About the Command Line Wizard

The qTest 9.1.5 Command Line Wizard is a command line interface application that allows you to configure basic settings for qTest applications in your purchase package. 

You should understand these Command Line Wizard characteristics before you begin:

  • For each step, the installer will prompt you for a specific input value. After you provide a value, the installer will validate the input. If the value is incorrect, or additional permissions are required, an explicit error message displays so it’s easy to know how the input value should be corrected.
    • Default values display in square brackets [ ]. To use the default value, simply hit the Enter key.
    • Input values for yes/no questions, should be 'y', 'yes','n', 'no' (ignore case sensitive.) Any value other than those listed will be treated as a 'no.'
  • To terminate the configuration at any time without completing it, press Ctrl+C.
    Hint: In the event you cannot start the Command Line Wizard again after terminating the configuration, backup then remove the qtest.config file. Retry to start the Command Line Wizard again.

Known Limitations

  • The Command Line Wizard and qtestctl do not support the character "$". Therefore, a password, username, or any other value that you would enter in a prompt should not contain "$." 
  • For Windows users, if you type "Ctrl-C" to terminate the wizard, there will be exceptions shown in the terminal before the wizard stops. You can ignore these exceptions. The configurations are still persisted successfully to the qtest.config file.

Before You Begin

Read the following:

Please note that the Command Line Wizard will prompt you for each installation instruction. You will need to perform action items and gather specific connection information before you begin the upgrade process. 

You will use the same configurations as in your 9.0 qtest.config file and can copy those to your new deployment package so they will be your default values in the 9.1.5 Command Line Wizard.

If you need to change your previous configurations, please review the application checklist provided here so you can see what information you will need.


Make sure the appropriate Ports for the prerequisite applications and qTest applications are open prior to any self/assisted upgrade. You should only open the HTTPS ports if you plan to serve SSL from the application.

Prerequisite Applications

Product  Port
PostgreSQL 5432
Network Drive 2049
MongoDB 27017

Linux non-Docker and Windows

Product HTTP Port HTTPS Port
Manager 8080 8443 
Sessions 9080 9443
Scenario 6080 4443
Insights 10080 10443
Parameters 5080 5080
Pulse 4080 4080
Launch 3080 3080

IMPORTANT: Suggested application ports are listed above, however you are allowed to use a port of your choosing for the qTest applications you install.

qTest Applications with a Load Balancing Model

Refer to this article to view different deployment model samples.

The sample below uses 5 servers.

  • 1 load balancing server for Manager
  • 3 application node servers
  • 1 database server 



  • Server 1Manager Load Balancer is a server that acts as a load balancer for the two qTest Manager servers. We will install and use nginx on this server for that purpose.
  • Server 2
    • qTest Manager application node which is an instance of qTest Manager deployed in a Windows server.
    • qTest Sessions application node which is an instance of qTest Sessions deployed in a Windows server.
    • NFS Client
  • Server 3:
    • qTest Manager application node which is an instance of qTest Manager deployed in a Windows server.
    • qTest Sessions application node which is an instance of qTest Sessions deployed in a Windows server.
    • NFS Client
  • Server 4:
    • qTest Insights application node.
    • qTest Parameters application node.
    • qTest Launch application node.
    • qTest Pulse application node.
  • Server 5: Prerequisite applications, including MongoDB and PostgreSQL and the Shared Network Drive
    • MongoDB: a database engine used to manage qTest Parameters and Pulse
    • PostgreSQL: a database engine used to manage qTest Manager, Sessions, Insights and Launch. All application nodes must use the same PostgreSQL database.
    • Shared Server: a server that hosts shared components that are required to run qTest Manager and Sessions. It should be accessible from all application nodes to store attachments and search index. 
      • NFS Server (Network File Systems): used to share directories and files with others over a network. We will use NFS to manage and share files created by qTest Manager and Sessions applications deployed on the 2 qTest Manager and qTest Sessions servers.
        • IPv4 Public IP: we will not use the public IP address since this server will not be exposed to the outside world
        • Private IP:


  • 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. Our sample uses nginx.
  • Your team members will access qTest Manager via the URL in the application nodes as configured in the Load Balancer.

Upgrade qTest Applications

In the Load Balancing model, there are multiple application nodes (qTest Manager and qTest Sessions on Server #2 and Server #3 in the above diagram). You will need to upgrade each server and take into consideration the applications installed on each server.

Upgrading an application node will follow the same set of instructions as upgrading qTest applications on a single server. Please follow these instructions to upgrade qTest application nodes on a Windows server.

Import qTest License

After the upgrade, you will need to manually copy the qTest License file from Manager 9.0 and then import it to 9.1.5. (These instructions are also covered in the Configure Manager article linked above.)

  1. Access your qTest Manager instance via your browser using the URL as specified in the qtest.config file.
  2. You will be redirected to the Licenses - Users tab in the Site Administration panel.
  3. Select the Import License File button.
  4. Browse to your license file located under the installation directory for qTest Manager v9.0:
    Example: <installation_dir>\manager\build\.tc\license.lic
  5. Your license file will import into qTest manager 9.1.5.


Powered by Zendesk