Menu

Manager 8.1.5 to 8.4.4 Cluster and Load Balancer Upgrade Guide for Windows

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
    1 - Upgrade
  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
    2 - Extract
  4. Configuration options: select Load Balancing
    3 - Config options
  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

    4 - Port
  6. Secured connection configuration
    5 - SSL
  7. Directory for attachments
    6 - Data dir
  8. Database configuration
    7 - DB config
  9. Integration database configuration
    8 - Poseidon config
  10. Cache configuration
    9 - Redis
  11. Message queue configuration
    10 - RabbitMQ
  12. Notification configuration: select Run as Notification server
    11 - Noti config
  13. After you have finished reviewing and modified qTest Manager's configuration, the installation wizard will start configuring the databases and qTest Manager service
    12 - Config qTest
  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
    13 - Complete

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
    1 - Upgrade
  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
    2 - Extract
  4. Configuration options: select Load Balancing
    3 - Config options
  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

    4 - Port
  6. Secured connection configuration
    5 - SSL
  7. Directory for attachments
    6 - Data dir
  8. Database configuration
    7 - DB config
  9. Integration database configuration
    8 - Poseidon config
  10. Cache configuration
    9 - Redis
  11. Message queue configuration
    10 - RabbitMQ
  12. Notification configuration: select Run as Application server and specify the URLs to connect to the Notification node
    10 - Noti config - AN
  13. After you have finished reviewing and modified qTest Manager's configuration, the installation wizard will start configuring the databases and qTest Manager service
    12 - Config qTest
  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
    13 - Complete

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.

Subscribe To Our Blog
Powered by Zendesk