Insights 1.21.5 to Single Server Upgrade Guide for Docker


In this article, we provide step-by-step instructions to upgrade qTest Insights 1.21.5 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.7.1 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.6.1 to 9.7.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.5, shut it down, and create a backup.
    $ ./shutdown
    $ ./backup

Download the Deployment Package

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

Configure qTest Insights

To keep all applications in your previous deployment from being upgradedoverride the /profiles directory of docker-deployment-4.9 with the directory of docker-deployment-4.8

$ cp -r /<path to your docker-deployment-4.8 package>/docker-deloyment-4.8/profiles/ /<path to your docker-deployment-4.9 package>/docker-deloyment-4.9/profiles/
    • Above command will copy the old configuration file at /docker-deployment-4.8/profiles/ to /docker-deployment-4.9/profiles/
    • Next, open the file at /path/to/docker-deployment-4.9/profiles/default.inlocate and ensure the version value of 4.9, is as below:
      version = "4.9"

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