Insights 1.15.3 to Single Server Upgrade Guide for Docker


In this article, we provide step-by-step instructions to upgrade qTest Insights 1.15.3 to qTest Insights 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 only works with qTest Manager 9.1.5 or later.

Read the following:

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


Upgrade qTest Insights from 1.15.3 to

Shutdown and Backup your Current Deployment

Access the directory where you've extracted the docker deployment package of qTest Insights 1.15.3, shut it down and create a backup.

$ ./shutdown
$ ./backup

Download Docker package of qTest Insights

This package supports the upgrade of qTest Insights from version 1.15.3 to version


Extract the Package


Access the deployment directory

$ cd docker-deployment-4.5


Choose either way:

  • To keep all applications in your previous deployment being upgraded, override the /profiles directory of docker-deployment-4.5 with that directory of docker-deployment-4.4

$ cp -r /<path to your docker-deployment-4.4 package>/docker-deloyment-4.4/profiles/ .

  • After copying, please open file and remove insightscheduler (since 1.16.7, Insights discontinues the old scheduler, the new scheduler is packed inside the insightsetl)


  • OR use configure command if you want to specify each application to be upgraded (for HTTP)
 $ ./configure --insights-url "http://<IP of current machine>:<insights port>" --insights-http "<insights port>" --cluster "<IP address of qTest machine>"
  • 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>" --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 

 $ ./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.


Powered by Zendesk