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

Before you begin

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

• Your machine needs to satisfy qTest Manager's recommended hardware requirements
• Please follow these instructions back up your data prior to the upgrade process
• Upgrade your PostgreSQL DB server from v9.4 to v9.5 using these instructions.
• Upgrade your Java JDK to v8
• Prerequisite applications must be running prior to the upgrade process
  • PostgreSQL v9.5
  • RabbitMQ v3.5.4
  • Redis v2.8.19

Upgrade qTest Manager

Overview

In the load balancing model, there are one Notification node and multiple Application nodes. You will need to upgrade all of them first. After the upgrade process completes, restart them.

The upgrade process includes 3 steps as below:

1. Shut down the nodes
2. Upgrade the Notification node
3. Upgrade all of the Application nodes
4. Start the nodes

Shut down the nodes

Please to shut down all Application nodes first and then shut down the Notification node

Upgrade the Notification node

1. Download qTest Manager's installation package here
2. Once downloaded, double click on the installer to start the upgrade process. Click Next
   
3. The installer will starts extracting files. After it finishes extracting, you will be able to review your qTest Manager's configuration. You can edit any of them if needed
   
4. Configuration options: select Load Balancing
   
5. Web server ports

   You can change the currently used ports by selecting Use custom ports. Simply enter the port numbers for each of the 4 port types

   
6. Secured connection configuration
   
7. Directory for attachments
   
8. Database configuration
   
9. Integration database configuration
   
10. Cache configuration
    
11. Message queue configuration
    
12. Notification configuration: select Run as Notification server
    
13. After you have finished reviewing and modified qTest Manager's configuration, the installation wizard will start configuring the databases and qTest Manager service
    
14. After this process is done, you will be directed to the final information screen, where you can review all the installed components and their settings
    

Upgrade all of the Application nodes

You may have multiple Application nodes. Please repeat all of these below steps on all of the nodes

1. Download qTest Manager's installation package here
2. Once downloaded, double click on the installer to start the upgrade process. Click Next
   
3. The installer will starts extracting files. After it finishes extracting, you will be able to review your qTest Manager's configuration. You can edit any of them if needed
   
4. Configuration options: select Load Balancing
   
5. Web server ports

   You can change the currently used ports by selecting Use custom ports. Simply enter the port numbers for each of the 4 port types

   
6. Secured connection configuration
   
7. Directory for attachments
   
8. Database configuration
   
9. Integration database configuration
   
10. Cache configuration
    
11. Message queue configuration
    
12. Notification configuration: select Run as Application server and specify the URLs to connect to the Notification node
    
13. After you have finished reviewing and modified qTest Manager's configuration, the installation wizard will start configuring the databases and qTest Manager service
    
14. After this process is done, you will be directed to the final information screen, where you can review all the installed components and their settings
    

Restart the nodes

After the Notification node and all of the Application nodes have been upgraded, please restart all of them. Remember to restart the Notification node first, then restart the remaining nodes.