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 single CentOS/Ubuntu machine using Docker. To upgrade qTest Manager from older version than 8.4.4, please use our old Docker deployment packages.
1. Uninstall 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 to 8.7.3
$ wget <ENTER DOWNLOAD LINK HERE>
3. Extract the package
$ tar -zxf docker-deployment-4.3.tar.gz
4. Access docker-deployment-x.x directory
$ cd docker-deployment-4.3
Choose either way:
- To keep all applications in your previous deployment being upgraded, override the /profiles directory of docker-deployment-x4.3 with that directory of docker-deployment-4.0
$ cp -r /<path to your docker-deployment-4.0 package>/docker-deloyment-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>"
Upgrading will keep all current data of upgraded applications.
8. After the upgrading process finishes, start the deployment process
- 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, access to qTest Manager using the URL specified above validate if it 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