Insights 2024.2 to 2024.4 Single Server Upgrade Guide for Docker

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

Complete the OnPremises Technical Services Request form (opens in new tab) to request assistance or obtain self-installation links, whether you're upgrading or performing a fresh install.

qTest Insights 2024.4 only works with qTest Manager 2024.4 or later.
If you are upgrading qTest, it is highly recommended that you clear your qTest browser cache after receiving qTest 2024.4.

  • Windows: Ctrl+F5

  • Mac/Apple: Apple+R or Command+R

  • Linux: F5

Before You Begin

Read the following:

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 2024.2, shut it down, and create a backup.

    $ ./shutdown
    $ ./backup

Download the Deployment Package

  1. Download docker-deployment-4.18 package.

    2. $ wget <ENTER DOWNLOAD LINK HERE>

  2. Extract the package.

    3. $ tar -zxf <DOWNLOADED PACKAGE FILE NAME>

  3. Access the docker-deployment-4.18 directory.

    4. $ cd docker-deployment-4.18

Configure qTest Insights

Access to the directory where you've extracted the package, and run the ./configure command to deploy the package.

The command has to include URL & port of qTest Insights.

Configure to deploy HTTP

$ ./configure  --insights-url "http://<IP of current machine>:<insights port>" --insights-http "<insights port>" --cluster "<IP address of qTest machine>"

Configure to deploy HTTPS

$ ./configure --ssl-key "<SSL Key>" --ssl-cert "<SSL Cert>" --ssl-ca "<SSL Ca>" --insight-url "https://<IP of current machine>:<insights https port>" --insights-https "<insights https port>" --cluster "<IP address of qTest machine>"

Enhanced Security Whitelist Example:

  • qTest Manager domain: https://manager.qtest.com

  • qTest Insights domain: https://insights.qtest.com

  • You use a Confluence page to embed reports/dashboard, shareable URL dashboard, rapid dashboard: https://confluence.qtest.com

  • Whitelist domain: manager.qtest.com|insights.qtest.com|confluence.qtest.com or qtest.com

Configure to deploy with the Enhanced Security

$ ./configure --insights-security-csrf-trusted-source-pattern "<Whitelist domains>"

If you are configuring an external configuration, e.g. Confluence, then the Confluence URL should be whitelisted:

$ ./configure --insights-security-csrf-trusted-source-pattern "<qtest-manager-domain>[:port]|<qtest-insights-domain>[:port]|<confluence-domain>"

For example

$ ./configure --insights-security-csrf-trusted-source-pattern "qtest-manager.com|insights.com|confluence.atlassian.net"

Start the Deployment Process

  1. Start the deployment process by executing a start-up script which will download application images and qTest Insights components to the Docker container.

    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.