Insights 1.21.3 to 1.21.5 Single Server Upgrade Guide for Docker


In this article, we provide step-by-step instructions to upgrade qTest Insights 1.21.3 to qTest Insights 1.21.5 on a single CentOS/ Ubuntu machine using Docker. Please read the instructions thoroughly before starting your installations.

To request assistance with upgrading or obtain the self-upgrade links, complete the Upgrade Request Form and reference the OnPremise Upgrades Guide.

Note: If you are performing a fresh install, use the OnPremise New Install Form and reference the OnPremise Install Guide.

Before You Begin

  • qTest Insights 1.21.5 only works with qTest Manager 9.6.1 or later.

Read the following:

Note: if you want to upgrade to qTest Insights 1.21.5 on the same machine with other applications, e.g. qTest Manager, on Docker environment, follow this article Manager 9.5.3 to 9.6.1 Single Server Upgrade Guide for Docker. 

Upgrade qTest Insights

Shutdown and Backup your Current Deployment

  1. Open the Terminal.
  2. Access the directory where you've extracted the docker deployment package of qTest Insights 1.21.3, shut it down, and create a backup.
    $ ./shutdown
    $ ./backup

Download the Deployment Package

  1. Download docker-deployment-4.8 package.
  2. Extract the package.
  3. Access the docker-deployment-4.8 directory.
    $ cd docker-deployment-4.8

Configure qTest Insights

Choose one of the two options below to configure qTest Insights:

  1. To keep all applications in your previous deployment from being upgradedoverride the /profiles directory of docker-deployment-4.8 with the directory of docker-deployment-4.7
    $ cp -r /<path to your docker-deployment-4.7 package>/docker-deloyment-4.7/profiles/ /<path to your docker-deployment-4.8 package>/docker-deloyment-4.8/profiles/
    • Above command will copy the old configuration file at /docker-deployment-4.7/profiles/ to /docker-deployment-4.8/profiles/
    • Next, open the file at /path/to/docker-deployment-4.8/profiles/default.inlocate and ensure the version value of 4.8, is as below:
      version = "4.8"
  2. Another option is to use ./configure command and specify the Insights application that you want to configure.
    • For HTTP:
      $ ./configure --insights-url "http://<IP of current machine>:<insights port>" --insights-http "<insights port>--cluster "<IP address of qTest machine>"
    • For HTTPS:
      $ ./configure --ssl-key "<SSL Key>" --ssl-cert "<SSL Cert>" --ssl-ca "<SSL Ca>" --insights-url "https://<IP of current machine>:<insights https port>" --insights-https "<insights https port>--cluster "<IP address of qTest machine>"


Upgrading will keep all current data of upgraded applications.

 $ ./upgrade

Start the Deployment Process

  1. Start the deployment process by executing a startup script which will download application images and qTest Insights components to the Docker container. 
    Note: It may take a while to complete depending on your network connection.
    $ ./startup
  2. When it's done, you can access qTest Insights and verify the new version.
Powered by Zendesk