Sessions 4.0.2 to 4.1 Load Balancer Upgrade Guide for Windows


In this article, we provide instructions to upgrade qTest Sessions 4.0.2 to 4.1 on a load balancing environment, where multiple instances of qTest Sessions were installed, and each instance is running on its own Windows server. Please read the instructions thoroughly before starting your installations.

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.

Before You Begin

  • qTest Sessions 4.1 only works with qTest Manager 9.0 or later.

Read the following:

NOTE: This diagram is one example of how to deploy qTest OnPremise with the load balancing model. More information and examples are provided in the Selecting your OS and Deployment Model article.


Upgrade qTest Sessions

In the Load Balancing model, there are multiple application nodes (qTest Sessions Server #2 and qTest Sessions Server #3 in the above diagram). You will need to upgrade each node.

Upgrading an application node will follow the same set of instructions as upgrading qTest Sessions on a single server. Please follow these instructions.

Verify Connectivity

This step is to ensure qTest Manager is able to connect to qTest Sessions through the qTest Sessions Load Balancer.

  1. Login to qTest Manager using the Site Administrator account.
  2. Navigate to the Site Administration page.
  3. Select the System Configurations tab.
  4. In the Miscellaneous section, enter the qTest Manager URL.
      • http://[qTest_Manager_IPAddress]:[Port] if you installed qTest Manager without an SSL certificate. OR
      • https://[qTest_Manager_IPAddress]:[Port] if you installed qTest Manager with an SSL certificate.
  5. In the QTEST EXPLORER | SESSIONS section, ensure the value of qTest Explorer | Sessions URL field is set to the public IP address of qTest Sessions Load Balancer, as in this screenshot.
  6. Select Test Connection and wait for qTest Manager to display the message "Connected to server successfully."
  7. Save.
  8. Now you can access qTest Sessions and verify the new version.


Powered by Zendesk