In this article, we provide instructions for installing qTest Sessions 4.2.1 on a CentOS/ Ubuntu machine using Docker, as well as how to connect it to qTest Manager 9.3 on a different machine.
If you want to deploy qTest Sessions 4.2.1 and qTest Manager 9.3 on the same machine using Docker, read this article Manager 9.3 Single Server Installation Guide for Docker.
To request installation assistance or to obtain the links to self-install, please click here to fill out the On-Premise New Install Form.
Before You Begin
- qTest Manager 9.3 is deployed and running in a separate machine.
- qTest Sessions 4.2.1 only works with qTest Manager 9.3 or later.
- 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:
Download Docker-Deployment 4.6 Package
$ wget <ENTER DOWNLOAD LINK HERE>
Extract the Package
$ tar -zxf <DOWNLOADED PACKAGE FILE NAME>
Access the Extracted Package Directory
$ cd <EXTRACTED PACKAGE DIRECTORY>
Configure the Applications
$ ./configure --apps "sessions sessionslb"
Configure to Deploy HTTP
If you are going to deploy qTest Sessions with HTTP.
$ ./configure --sessions-url "http://<Public IP address of current machine>:<sessions port>" --sessions-http "<sessions port>" --cluster "<IP of postgres docker server>"
Configure to Deploy HTTPS
If you are going to deploy qTest Sessions with HTTPS.
$ ./configure --ssl-key "<SSL Key>" --ssl-cert "<SSL Cert>" --ssl-ca "<SSL Ca>" --sessions-url "https://<Public IP of current machine>:<sessions https port>" --sessions-https "<sessions https port>" --cluster "<IP of postgres docker server>"
Start the Deployment Process
The script will download the application images to the Docker. It may take a couple of hours depending on your network connection.
Once the installation is complete, access qTest Manager via your browser and start to configure qTest Manager and qTest Sessions.
Set up qTest Applications
Please follow this guide: Configure qTest Applications to complete the remaining steps to activate your account.