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:
- Shut down the nodes
- Upgrade the Notification node
- Upgrade all of the Application nodes
- 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
- Download qTest Manager's installation package here
- Once downloaded, double click on the installer to start the upgrade process. Click Next
- 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
- Configuration options: select Load Balancing
- 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
- Secured connection configuration
- Directory for attachments
- Database configuration
- Integration database configuration
- Cache configuration
- Message queue configuration
- Notification configuration: select Run as Notification server
- After you have finished reviewing and modified qTest Manager's configuration, the installation wizard will start configuring the databases and qTest Manager service
- 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
- Download qTest Manager's installation package here
- Once downloaded, double click on the installer to start the upgrade process. Click Next
- 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
- Configuration options: select Load Balancing
- 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
- Secured connection configuration
- Directory for attachments
- Database configuration
- Integration database configuration
- Cache configuration
- Message queue configuration
- Notification configuration: select Run as Application server and specify the URLs to connect to the Notification node
- After you have finished reviewing and modified qTest Manager's configuration, the installation wizard will start configuring the databases and qTest Manager service
- 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.