In this article, we provide step-by-step instructions to upgrade qTest Manager from 9.1.5 to 9.3 on a single CentOS/Ubuntu machine using Docker machine. 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.
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/profiles/
Note: after copying, please open file default.in and remove "insightscheduler" from the "apps=" line
- 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 a 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