Parameters 2023.5 to 2024.1 Single Server Upgrade Guide for Docker

In this article, we provide step-by-step instructions to upgrade qTest Parameters from 2023.5 to 2024.1 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 Parameters 2024.1 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:

If you want to upgrade to qTest Parameters 2024.1 on the same machine with other applications, e.g. qTest Manager, on Docker environment, follow this article Manager 2024.1 to 2024.4 Single Server Upgrade Guide for Docker.

Shutdown your Previous Deployment

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

Download Deployment Package

Download docker-deployment-4.18 package.

$ wget <ENTER DOWNLOAD LINK HERE>

Extract the package

$ tar -zxf <DOWNLOADED PACKAGE FILE NAME>

Access to docker-deployment-4.18 directory

$ cd docker-deployment-4.18

Configure qTest Parameters

Choose one of the below options to configure qTest Parameters:

Copy configuration of all applications in your previous docker deployment to the /profiles directory of docker-deployment-4.16 package.

$ cp -r /path/to/docker-deployment-4.16/profiles/ .

Above command will copy the old configuration file at /docker-deployment-4.16/profiles/default.in to /docker-deployment-4.18/profiles/default.in
Next, open the file at /path/to/docker-deployment-4.16/profiles/default.in, locate and change the version value to 4.18, as below:

version = "4.18"

Use ./configure command and specify parameters application that you want to configure.

For HTTP

$ ./configure --parameters-url "http://<public IP address of current machine>:<qTest Parameters port>" --parameters-http "<qTest Parameters port>" --cluster "<IP of Postgres docker server>"

For HTTPS

$ ./configure --ssl-key "<SSL Key>" --ssl-cert "<SSL Cert>" --ssl-ca "<SSL Ca>" --parameters-url "https://<public IP address of current machine>:<qTest Parameters https port>" --parameters-https "<qTest Parameters https port>" --cluster "<IP of Postgres docker server>"

Upgrade qTest Parameters

Execute the command below to upgrade qTest Parameters:

$ ./upgrade

Start Deployment Process

Next, start the deployment process by executing startup script which will download application images and qTest Parameters components to the Docker container. It may take a while to complete depending on your network connection.

$ ./startup

When it's done, you can access qTest Parameters and verify the new version.

Set up qTest Applications

Refer to Configure qTest Applications to complete the remaining steps to activate your account.

Troubleshooting

If the steps above are not successful, perform the following steps to rollback to qTest Parameters 2023.5 (previous version with Docker deployment package 4.16) (docker, images, parameters, parameterslb).

Restore backup data

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

# ./restore

Start qTest Parameters 2023.5

# ./startup

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