Launch 2024.1 to 2024.4 Single Server Upgrade Guide Docker

In this article, we provide step-by-step instructions to upgrade upgrading to qTest Launch 2024.4 on a RHEL/ Ubuntu machine using Docker and then connect it to qTest Manager 2024.4 on a different machine. Please read the instructions thoroughly before starting your installations.

If you want to deploy qTest Launch 2024.4 and qTest Manager 2024.4 on the same machine using Docker, check out this article Manager 2024.1 to 2024.4 Single Server Upgrade Guide for Docker.

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.

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:

  • qTest Launch 2024.4 only works with qTest Manager 2024.4 or later.

  • qTest Manager has been deployed using Docker on a separate machine.

  • Docker 17.03 has been installed. Follow these instructions to install Docker on your machine if you have not done so already.

  • For RHEL, you need to follow additional instructions to Change Docker storage driver to avoid Overlay issue.

  • For RHEL 8.8 or Ubuntu 20.04-22.04 machines: Docker requires a 64-bit installation and your kernel must be at least 3.10.

Upgrade qTest Launch 2024.1 to 2024.4

Shutdown the Previous Deployment

  1. Open the Terminal.

  2. Access the directory where you extracted the previous docker deployment package 4.16, shut it down and create a backup.

    $ ./shutdown

Download the Deployment Package

  1. Download docker-deployment-4.18 package.

    $ wget <ENTER DOWNLOAD LINK HERE>

  2. Extract the package.

    $ tar -zxf <DOWNLOADED PACKAGE FILE NAME>

  3. Access the docker-deployment-4.18 directory.

    $ cd docker-deployment-4.18

Configure Applications

$ ./configure --apps "launch launchlb"

Configure URL and port

Deploy qTest Launch with HTTP

$ ./configure --launch-url "http://<public IP of current machine>:<launch port>" --launch-http "<launch port>" --cluster "<IP of postgres docker server>" --qtest-url "http://<qtest manager's domain or public IP address>:<qtest port>"

Deploy qTest Launch with HTTPS

$ ./configure --ssl-key "<SSL Key>" --ssl-cert "<SSL Cert>" --ssl-ca "<SSL Ca>" --launch-url "https://<public IP of current machine>:<launch https port>" --launch-https "<launch https port>" --cluster "<IP of postgres docker server>" --qtest-url "https://<qtest manager's domain or public IP address>:<qtest https port>"

Upgrade qTest Launch

Execute the command below to upgrade qTest Launch:

$ ./upgrade

Start the deployment process

$ ./startup
The script will download the application images to the Docker. It may take a couple of hours depending on your network connection.

Open your web browser, access qTest Launch using the URL specified above in the configure command to validate if it has started successfully.

Once the installation is complete, access qTest Manager via your browser and setup for qTest Launch.

You have finished upgrading qTest Launch.

Troubleshooting

If the installation was not successful, perform the following steps to rollback to qTest Launch 2024.1 (with Docker deployment package 4.16).

  1. Start Launch 2024.1 server.

    # cd /path/to/docker-deployment-4.16
# ./startup

  2. When the process is complete, contact Customer Support to troubleshoot the issue with upgrading qTest Launch.