Menu

Launch 1.0 to 1.2 Single Server Upgrade Guide for Docker

Overview

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

f you want to deploy qTest Launch 1.2 and qTest Manager 9.1.5 on the same machine using Docker, check out this article Manager 9.0 to 9.1.5 Single Server Upgrade Guide for Docker.

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 Launch 1.2 only works with qTest Manager 9.1.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
  • For CentOS, you need to follow additional instructions to adjust Docker Storage Driver from overlay to device mapper.
  • For CentOS 7.X+ or Ubuntu 16.10 machines: Docker requires a 64-bit installation and your kernel must be at least 3.10 

Read the following:

 

Upgrade qTest Launch to 1.2

Shutdown the Previous Deployment

  1. Open the Terminal.
  2. Access the directory where you extracted the previous docker deployment package 4.4, shut it down and create a backup.
    $ ./shutdown

Download the Deployment Package

  1. Download docker-deployment-4.5 package
    $ wget <ENTER DOWNLOAD LINK HERE>
  2. Extract the package.
    $ tar -zxf <DOWNLOADED PACKAGE FILE NAME>
  3. Access the docker-deployment-4.5 directory.
    $ cd docker-deployment-4.5

Configure Launch

Configure applications

 $ ./configure --apps "launch launchlb"

Configure URL and port

If you are going to 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>"

If you are going to 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

2018-01-25_1328.png

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

You have finished upgrade qTest Launch.

Troubleshooting 

If the installation was not successful, perform the following steps to rollback to qTest Launch 1.0

  1. Start launch 1.0 server
    # cd /path/to/docker-deployment-4.4
    # ./startup
  2. When the process is complete, contact Customer Support to troubleshoot the issue with upgrading qTest Sessions.
Powered by Zendesk