02. Manager 8.4.4 Single Server Installation Guide for Docker

In this guide we'll run you through installing qTest Manager 8.4 with its additional applications on a single CentOS/ Ubuntu machine using Docker.

Before you begin

Before you install qTest Manager, make sure following things are done:

  • Your machine needs to satisfy qTest's recommended hardware requirement
  • 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 devicemapper.
  • For CentOS 7.X+ or Ubuntu 16.10 machines: Docker requires a 64-bit installation and your kernel must be at least 3.10 

What includes in docker-deployment-4.0 package?

The qTest's docker-deployment-4.0 includes following applications. Among those, qTest Manager is the required application, simply specify more application you want to deploy (eligible application is up to your license)

  • qTest Manager 8.4.4 includes qtest and its prerequisite applications: redis, rabbitmq, postgres
  • qTest Session 3.0.9 includes session and its prerequisite application: elasticsearch, redis, postgres
  • qTest Parameters 1.1 includes mongodb, parameters, parameterslb

 

Install qTest Manager and its additional applications

Access to your machine where Docker has been installed using root or a user which has been added to docker user group, then follow following steps.

1. Download docker-deloyment-4.0 package  

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

2. Extract the package 

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

 

3. Configure before deploying

Access to the directory where you've extracted the docker deloyment package (docker-deployment-4.0).

 $ cd docker-deployment-4.0
  • If you want to deploy the package with HTTP, go to step 3.1, ignore 3.2
  • If you want to deploy the package with HTTPS, go to step 3.2

3.1 Configure to deploy HTTP

Specify URL and http port of each application you want to deploy (qTest Manager is required)

Application name Append ./configure command with URL and http port of your apps
qTest Manager -qtest-url "[Manager URL]" --qtest-http "[qtest http port]"
qTest Session --sessions-url "[Session URL]" --sessions-http "[session http port]" 
qTest Insights --insights-url "[Insights URL]" --insights-http "[insights http port]"
qTest Parameters --parameter-url "[Parameter URL]" --parameter-http "[parameters http port]"

 

Scenario 1: Deploy qTest Manager with qTest Sessions, qTest Insights, and qTest Parameters. This is applicable for Elite package.

$ ./configure --qtest-url "http://<IP of current machine>:<qtest port>" --qtest-http "<qtest port>" --sessions-url "http://<IP of current machine>:<sessions port>" --sessions-http "<session port>" --insights-url "http://<IP of current machine>:<insights port>" --insights-http "<insights port>" --parameters-url "http://<IP of current machine>:<parameters port>" --parameters-http "<parameters port>"

 

Scenario 2: qTest Manager with qTest Sessions. This is applicable for Premium package.

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

 

Scenario 3: Deploy only qTest Manager

 $ ./configure --qtest-url "http://<IP Of current machine>:<qtest port>" --qtest-http "<qest port>"

3.2 Configure to deploy HTTPS

  • Specify path to ssl-key, ssl-cert, ssl-ca
  • Specify URL and https port of each application you want to deploy (qTest Manager is required). 
Application name Append ./configure command with URL and https port of your apps
qTest Manager -qtest-url "[Manager URL]" --qtest-https "[manager https port]"
qTest Sessions --sessions-url "[Session URL]" --sessions-https "[session https port]" 
qTest Insights --insights-url "[Insights URL]" --insights-https "[insights https port]"
qTest Parameters --parameter-url "[Parameter URL]" --parameter-https "[parameter https port]"

 

Scenario 1: Deploy qTest Manager with qTest Sessions, qTest Insights, and qTest Parameters. This is applicable for Elite package.

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

 

Scenario 2: qTest Manager with qTest Sessions. This is applicable for Premium package.

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

 

Scenario 3: Deploy only qTest Manager with default https port 443

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

 

4. Start the deployment process 

 $ ./startup

The script will download the application images and qTest components to the Docker. It may take couple of hours depending on your network connection.

Once the installation is complete, access to qTest Manager via your browser to begin setting up your site.

 

Set up qTest Manager

Refer to the article here to set up qTest Manager