In this article, we provide step-by-step instructions for an example configuration to upgrade qTest Manager from 9.1.5 to 9.3 on multiple CentOS/Ubuntu machines using Docker. Please read the instructions thoroughly before starting your installations.
Before You Begin
Read the following:
To upgrade qTest Manager from a version older than 9.1.5, please use our old Docker deployment packages.
The example image below demonstrates how to configure qTest Manager with a load balancer for 4 machines:
- Machine 1: considered as a cluster, hosts qTest Manager's prerequisite apps:
- Machine 2: hosts qTest Manager 9.1.5 (qtest)
- Machine 3: hosts qTest Manager 9.1.5 (qtest)
- Machine 4: hosts qTest Manager's load balancer (qtestlb)
Note: The cluster machine must open 2 ports:
How to Upgrade Machine 2 and 3
Repeat all of the steps below for Machine 2 and 3 where you have installed qTest Manager 9.1.5 (qtest). No changes need to be made on Machine 1 and Machine 4 (qtestlb) servers in this example configuration.
IMPORTANT: Make sure to upgrade your Docker Deployment on each machine where it is currently installed. This article provides a sample configuration only.
Uninstall your Current Deployment
If your qTest Manager is set up as a Linux Daemon on this server, you should stop it first. If not, you can skip this step.
systemctl stop qtest
- Access the directory where you've extracted the docker deployment package of qTest Manager 9.1.5 (docker-deployment-4.5), shut it down and create a backup.
$ ./shutdown $ ./backup $ ./uninstall
- Download the Docker-Deployment-4.6 Package.
Note: This package supports the upgrade of qTest Manager from version 9.1.5 to 9.3
$ wget <ENTER DOWNLOAD LINK HERE>
- Extract the package.
$ tar -zxf docker-deployment-4.6.tar.gz
- Access Docker-Deployment-x.x Directory.
$ cd docker-deployment-4.6
Configure qTest Manager
You have 3 options:
- To keep all applications in your previous deployment from being upgraded, override the /profiles directory of docker-deployment-4.6 with the directory of docker-deployment-4.5
$ cp -r /<path to your docker-deployment-4.5 package>/docker-deloyment-4.5/profiles/ /<path to your docker-deployment-4.6 package>/docker-deloyment-4.6/
- 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>"
Upgrade qTest Manager
Upgrading will keep all of the current data for upgraded applications.
Deploy qTest Manager
- Execute this command to initially set up and start the application.
The script will download the application images and qTest components to the Docker. It may take couple of hours depending on your network connection
- Open your web browser, and access qTest Manager using the URL specified above.
- Validate if qTest Manager has started successfully.
- Execute these commands to 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 the directory where you've extracted the docker deployment package of qTest Manager 9.1.5 (docker-deployment-4.5)
- If your qTest Manager is set up as a Linux Daemon on this server, you should stop it first. If not, you can skip this step.
$ systemctl stop qtest
- Shut down qTest Manager.
- Start the service. You may need to wait a few minutes for qTest Manager to be available.
$ systemctl start qtest