Docker Update Manager 7.7.3 to 8.1 and Sessions 2.2.7 to 3.0


  1. Docker Host version 1.6+ has been installed on the machine where you are deploying qTest components. Ports 53 and 6783 on this machine need to be exposed if you are deploying with clustering model
    • For CentOS 7.X+ or Ubuntu 14.04+ machines: Docker requires a 64-bit installation and your kernel must be at least 3.10
    • Please follow these instructions to install Docker on your machine
  2. Docker Client has been installed. You will need to execute the deployment shell scripts in these instructions using the tool
  3. Docker Host is accessible using Docker Client
  4. Docker Host's configurations needs to satisfy qTest's recommended hardware requirements

Post Upgrade

  • Important! Please make sure you have a JIRA administrator upgrade the qTest plugin for JIRA(the previous version is deprecated).

Before you begin

  • Download qTest Docker Deployment version 3.0. This package supports the upgrade of qTest from version 7.7.3 qTest version 8.1.x
  • If you are using qTest version which is older than 7.7.3, you will need to use qTest Docker Deployment version 2.2 to upgrade your qTest to 7.7.3 following this instruction. Then use qTest Docker Deployment version 3.0 to upgrade your qTest to 8.1.x
  • If you are using non-Docker deployment and want to upgrade qTest with Docker, you will need to use qTest Docker Deployment version 2.2 to upgrade your qTest to 7.7.3 following this instruction. Then use qTest Docker Deployment version 3.0 to upgrade your qTest to 8.1.x
  • Before starting the upgrade process, please make sure to backup your data. Please see these instructions

Upgrade process


  • If your qTest components were deployed on multiple Docker hosts, upgrade the one where MySQL was deployed first, and then repeat all steps with the other ones
  • If qTest was previously deployed with load balancing model, it is required that you upgrade the Docker hosts in the same order as when you deployed them
  • In case MySQL and PostgreSQL were deployed on different Docker hosts, when you upgrade the Docker host with MySQL, the other Docker host with Postgres needs to be running
  1. Access your Docker host through a user which was added to the Docker user group. This does not need to be the root user of Docker
  2. Given that qTest was configured in a directory named docker-deployment-2.2, access this directory and shut it down then create a backup:
    $ cd docker-deployment-2.2 
    $ ./shutdown
    $ ./backup		
  3. After you have downloaded qTest Docker Deployment version 3.0, extract it using the command below. After this is extracted, access to docker-deployment-3.0
    $ wget 
  4. $ tar -zxf docker-deployment-3.0.tar.gz 
    $ cd docker-deployment-3.0
  5. Copy profiles folder from docker-deployment-2.2 to docker-deployment-3.0
    $ cp -r /opt/docker-deployment-2.2/profiles .
  6. Upgrade the Docker host
    $ ./upgrade 
    This will upgrade the deployment from 2.x to 3.x.
    The servers will be taken down during upgrade.
    Do you want to continue? [y/N] y
    Shutting down the cluster...
    Upgrading configuration...
    Checking for newer version...
    Congratulation! You're running the latest version of qTest
  7. Start the Docker host
    $ ./startup

Add Insights 2.0(License must include Insights)

  We will need to update your qTest configuration to include the insights insightslb and insightsscheduler components.

  1. From the root of your docker-deployment-3.0 directory we will edit the configuration file :
    $ cd /opt/qTest/docker-deployment-3.0/profiles 
    $ cp
    $ vim
  2. If you previously used Insights 1.0 replace qmap qmapweb qmaplb with insights insightslb insightsscheduler, if you did not use Insights 1.0 simply append insights insightslb insightsscheduler to the end of your apps configuration as shown in the example below(your apps configuration may differ based on your license).
  3. apps='redis rabbitmq postgres qtest qtestlb sessions sessionslb insights insightslb insightsscheduler'
  4. Now we need to run the configure script to apply the configuration updates, do not supply any arguments to the script.
    $ cd /opt/qTest/docker-deployment-3.0
  5. $ ./configure
    Configuring services...
    Generating 'default' configuration file...
    Old 'default' configuration file found
    Delete the old file without making backup
  6. Now use the shutdown and startup scripts to restart qTest
    $ ./shutdown
    $ ./startup		
  7. Configure qTest Insights

    1. Login to your qTest using a site admin account. Access to site administration section
    2. Select tab System Configuration
    3. In Insights section, update qTest Insights URL

  8. Once you have successfully saved your Insights URL you can now navigate back to one of your qTest projects on the main portal.  
  9. To access Sessions or Insights please see the new navigation menu on the top right corner of the screen.

Powered by Zendesk