09. Sessions 3.0.1 to 3.0.9 Single Server Upgrade Guide for Docker

In this guide we'll run you through upgrading qTest Sessions from 3.0.1 or 3.0.2 or 3.0.3 or 3.0.4 to 3.0.9 on a CentOS/Ubuntu machine using Docker.

Before you begin 

  • You will need docker-deployment-4.0 package to perform the upgrade.
  • qTest Sessions 3.0.9 works with qTest Manager 8.4.4 and later. So make sure qTest Manager 8.4.4 is installed and running in a separate machine.


Upgrade qTest Sessions to 3.0.9

1. Shutdown your current deployment

Access to the directory where you've extracted the docker deployment package 3.0, shut it down and create a backup.

 $ ./shutdown
$ ./backup


2. Download docker-deloyment-4.0 package 

 $ wget https://qtest-storage.s3.amazonaws.com/docker/deployment/docker-deployment-4.0.tar.gz 


3. Extract the package 

$ tar -zxf docker-deployment-4.0.tar.gz  


4. Access to docker-deployment-4.0 directory

 $ cd docker-deployment-4.0


5. Configure

Choose either way:

5.1 To keep all applications in your previous deployment being upgraded, override the /profiles directory of docker-deployment-4.0 with that directory of docker-deployment-3.0

$ cp -r /<path to your docker-deployment-3.0 package>/docker-deloyment-3.0/profiles/ .

That command will copy the old configuration file /docker-deployment-3.0/profiles/default.in to/docker-deployment-4.0/profiles/default.in

Open the file /path/to/docker-deployment-4.0/profiles/default.in, locate and update the version value to 3.0.9, as below:

 version = "3.0.9"

5.2 OR use configure command if you want to specify each application to be upgraded (for HTTP)

 $ ./configure --sessions-url "http://<IP of current machine>:<qTest Sessions port>" --sessions-http "<qTest Sessions port>"

5.3 OR use configure command if you want to specify each application to be upgraded (for HTTPS)

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


6. Migrate database from Postgres 9.4 to Postgres 9.5

 $ ./migrateDBFrom9.4To9.5


7. Upgrade

Upgrading will keep all current data of upgraded applications.

 $ ./upgrade


8. After the upgrading process finishes, start the deployment process 

 $ ./startup

The script will download the application images and qTest Sessions components to the Docker. It may take couple of hours depending on your network connection. When it's done, you an access to qTest Sessions and verify the new version is running.