Menu

Manager 8.4.4 to 8.7.3 Load Balancing Upgrade Guide for Docker

To request assistance with upgrading or to obtain the links to self-upgrade, please click here to fill out the Upgrade Request Form.

In this guide we'll run you through upgrading qTest Manager from 8.4.4 to 8.7.3 on a multiple CentOS/Ubuntu machines. To upgrade qTest Manager from older version than 8.4.4, please use our old Docker deployment packages.

Example: Image below tries to demonstrate how to configure qTest Manager with load balancer for 4 machines:

  • Machine 1: considered as a cluster, hosts qTest Manager's prerequisite apps: redis, rabbitmq, postgres, poseidon
  • Machine 2: hosts qTest Manager 8.7.3 (qtest)
  • Machine 3: hosts qTest Manager 8.7.3 (qtest)
  • Machine 4: hosts qTest Manager's load balancer (qtestlb)

NOTE

  • cluster machine has to open 2 ports: 53 and 6783

op_diagrams1_docker.jpg

Upgrade Machine 2, 3

Please repeat all steps on Machine 2 and 3 that you have installed qTest Manager 8.4.4 (qtest). No change needed to make on Machine 1 and Machine 4 (qtestlb) servers.

1. Shutdown your current deployment

  • If you have set up qTest Manager as a Linux Daemon on this server, stop it first. Or else, you can skip this step
    $ systemctl stop qtest
    		
  • Access to the directory where you've extracted the docker deployment package of qTest Manager 8.4.4 (docker-deployment-4.0), shut it down and create a backup
    $ ./shutdown
    $ ./backup
    $ ./uninstall
    		

2. Download docker-deloyment-4.3 package

This package supports the upgrade of qTest Manager from version 8.4.4 qTest version 8.7.3

$ wget <ENTER DOWNLOAD LINK HERE>

3. Extract the package

$ tar -zxf docker-deployment-4.3.tar.gz

4. Access to docker-deployment-4.3 directory

$ cd docker-deployment-4.3

5. Configure

Choose either way:

  • To keep all applications in your previous deployment being upgraded, override the /profiles directory of docker-deployment-4.3 with that directory of docker-deployment-4.0
$ cp -r /<path to your docker-deployment-4.0 package>/docker-deployment-4.0/profiles/ .
  • OR use configure command if you want to specify each application to be upgraded (for HTTP)
$ ./configure --qtest-url "http://<IP of current machine>:<qtest port>" --qtest-http "<qtest port>"
  • OR use configure command if you want to specify each application to be upgraded (for HTTPS)
$ ./configure --ssl-key "<SSL Key>" --ssl-cert "<SSL Cert>" --ssl-ca "<SSL Ca>" --qtest-url "https://<IP of current machine>:<qtest https port>" --qtest-https "<qtest https port>"

6. Upgrade

Upgrading will keep all current data of upgraded applications.

$ ./upgrade

7. After the upgrading process finishes, start the deployment process

  • Execute this command to initially set up and start the application
    $ ./startup
    		

    The script will download the application images and qTest components to the Docker. It may take couple of hours depending on your network connection

  • After the above command completes successfully, set up qTest Manager as a Linux Daemon
    $ ./shutdown
    $ ./install
    		
  • Start the service. You may need to wait for few minutes for qTest Manager to be available
    $ systemctl start qtest
    		

Restart Machine 4

  • Access to the directory where you've extracted the docker deployment package of qTest Manager 8.4.4 (docker-deployment-4.0)
  • If you have set up qTest Manager as a Linux Daemon on this server, stop it first. Or else, you can skip this step
    $ systemctl stop qtest
    		
  • Shut down qTest Manager
    $ ./shutdown
    		
  • Set up qTest Manager as a Linux Daemon
    $ ./install
    		
  • Start the service. You may need to wait for few minutes for qTest Manager to be available
    $ systemctl start qtest
    		
Subscribe To Our Blog
Powered by Zendesk