Manager 8.4.4 to 8.7.3 Single Server 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 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



3. Extract the package

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


4. Access docker-deployment-x.x 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-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>"

6. Upgrade

Upgrading will keep all current data of upgraded applications.

 $ ./upgrade


8. 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

  • 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
Powered by Zendesk