Launch 1.6.14 to 2023.5 Single Server Upgrade Guide Docker

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

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

To request assistance with installation or obtain the self-install links, complete the OnPremises New Install Form.

If you are not performing a fresh install and are upgrading, use the Upgrade Request Form.

If you are upgrading qTest, it is highly recommended that you clear your qTest browser cache after receiving qTest 2023.5.

  • Windows: Ctrl+F5

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

  • Linux: F5

Before You Begin

Read the following:

  • qTest Launch 2023.5 only works with qTest Manager 2023.5 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.0 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 1.6.14 to 2023.5

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 1.6.14 (with Docker deployment package 4.16).

  1. Start Launch 1.6.14 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.