HELP CENTER
Menu
Close
Video Training Center
Submit a Ticket

Manager 9.1.5 Load Balancing Installation Guide for Docker

  1. QASymphony Help Center
  2. qTest OnPremise Guides
  3. Summer 2018 OnPremise Release

To request assistance with upgrading or to obtain the links to self-upgrade, please click here to fill out the Upgrade Request Form.

In this guide we'll run you through installing qTest Manager 9.1.5 using Docker on separate CentOS/Ubuntu machines with a Load Balancer.

This article only demonstrates how to deploy load balancer for qTest Manager.

  • Check this article to deploy qTest Sessions with load balancing.

Before you begin

What does the docker-deployment-4.5 package include?

The qTest's docker-deployment-4.5 includes the 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 9.1.5 includes qtest and its prerequisite applications: postgres, qtestlb
  • qTest Session 4.2 includes session and its prerequisite applications: postgres, qtestlb
  • qTest Parameters 2.1.2 includes parameters and its prerequisite applications: mongodb, parameterslb
  • qTest Insights 1.16.7 includes insights and its prerequisite applications: postgres, insightslb, insightsetl
  • qTest Launch 1.2.0 includes launch and its prerequisite applications: postgres, launchlb
  • qTest Pulse 9.0.2 includes pulse and its prerequisite applications: mongodb, pulselb
  • qTest Scenario 2.0.3 includes pulse and its prerequisite applications: scenariolb

Install qTest Manager with Load Balancer

The sample image below tries to demonstrate how to configure qTest Manager with a load balancer for 4 machines:

  • Machine 1: considered as a cluster, deploy qTest Manager's prerequisite app: postgres, and the shared network drive to store attachments
  • Machine 2: deploy qTest Manager 9.1.5 (qtest)
  • Machine 3: deploy qTest Manager 9.1.5 (qtest)
  • Machine 4: deploy qTest Manager's load balancer (qtestlb)

NOTE:

  • Every machine in the cluster requires the following ports to be open: 53 and 6783

Deploy_model.png

 

Deployment Instructions

Access to each of 4 machine where Docker has been installed using root or a user which has been added to docker user group:

  • Repeat step 1, step 2, step 3 in all 4 machines,
  • Then configure each machine in sequence (Machine 1, 2, 3, 4)

NOTE:

  • Pre-requisite applications of qTest Manager should be deployed in a separated machine rather than in the same machine with qTest Manager (qtest)
  • The load balancer application (qtestlb) should be deployed after all other apps get deployed.

1. Download docker-deployment-4.5 package 

$ wget <ENTER DOWNLOAD LINK HERE>

2. Extract the package 

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

3. Access to the package directory (docker-deployment-4.5)

 $ cd docker-deployment-4.5

 

Machine 1 (the cluster)

Deploy postgres into Machine 1

  • Specify prerequisite apps: postgres 
    $ ./configure --apps "postgres"

Modify the Config File

Modify configure file to ensure the "datadir" variable point to a shared directory where all 4 machines are able to access.

$ vim profiles/default.in

Start the Deployment

$ ./startup

Set qTest Manager as a Linux Daemon

$ ./shutdown
$ ./install
$ systemctl start qtest

Machine 2

  • If you want to deploy the qTest Manager with HTTP, go to step 2.1, ignore 2.2
  • If you want to deploy the qTest Manager with HTTPS, go to step 2.2

2.1 Deploy qtest (qTest Manager 9.1.5) with HTTP into Machine 2:

  • qtest-url: IP of machine 4 (the load balancer)
  • qtest-http: qtest port of machine 4 (the load balancer)
  • cluster: IP of machine 1
  • apps: qtest
$ ./configure --qtest-url "http://<IP of machine 4>:<qtest port of machine 4>" --qtest-http "<qtest port of machine 4>" --cluster "<IP of machine1>" --apps "qtest"
  • Modify configure file to ensure the "datadir" variable point to a shared directory where all 4 machines are able to access.
$ vim profiles/default.in
  • Start the deployment
$ ./startup
  • After the above command completes successfully, set up qTest Manager as Linux Daemon and start the service
$ ./shutdown
$ ./install
$ systemctl start qtest

2.2 Deploy qtest (qTest Manager 9.1.5) with HTTPS into Machine 2:

  • Specify path to ssl-key, ssl-cert, ssl-ca
  • qtest-url: IP of machine 4
  • qtest-https: qtest https port of machine 4
  • cluster: IP of machine 1
  • apps: qtest
$ ./configure --ssl-key "<SSL Key>" --ssl-cert "<SSL Cert>" --ssl-ca "<SSL CA>" --qtest-url "https://<IP of machine 4>:<qtest https port of machine 4>" --qtest-https "<qtest https port of machine 4>" --cluster "<IP of  machine1>" --apps "qtest"
  • Modify configure file to ensure the "datadir" variable point to a shared directory where all 4 machines are able to access
$ vim profiles/default.in
  • Start the deployment
$ ./startup
  • After the above command completes successfully, set up qTest Manager as Linux Daemon and start the service
$ ./shutdown
$ ./install
$ systemctl start qtest

Machine 3

  • If you want to deploy the qTest Manager with HTTP, go to step 3.1, ignore 3.2
  • If you want to deploy the qTest Manager with HTTPS, go to step 3.2

3.1 Deploy qtest (qTest Manager 9.1.5) with HTTP into Machine 3:

  • qtest-url: IP of machine 4 (the load balancer)
  • qtest-http: qtest port of machine 4 (the load balancer)
  • cluster: IP of machine 1
  • apps : qtest
$ ./configure --qtest-url "http://<IP of machine 4>:<qtest port of machine 4>" --qtest-http "<qtest port of machine 4>" --cluster "<IP of Machine 1>" --apps "qtest"
  • Modify configure file to ensure the "datadir" variable point to a shared directory where all 4 machines are able to access
$ vim profiles/default.in
  • Start the deployment
$ ./startup
  • After the above command completes successfully, set up qTest Manager as Linux Daemon and start the service
$ ./shutdown
$ ./install
$ systemctl start qtest

3.2 Deploy qtest (qTest Manager 9.1.5) with HTTPS into Machine 3:

  • Specify path to ssl-key, ssl-cert, ssl-ca
  • qtest-url: IP of machine 4
  • qtest-https: qtest https port of machine 4
  • cluster: IP of machine 1
  • apps: qtest
$ ./configure --ssl-key "<SSL Key>" --ssl-cert "<SSL Cert>" --ssl-ca "<SSL CA>" --qtest-url "https://<IP of machine 4>:<qtest https port of machine 4>" --qtest-https "<qtest https port of machine 4>" --cluster "<IP of Machine1>" --apps "qtest"
  • Modify configure file to ensure the "datadir" variable point to a shared directory where all 4 machines are able to access
$ vim profiles/default.in
  • Start the deployment
$ ./startup
  • After the above command completes successfully, set up qTest Manager as Linux Daemon and start the service
$ ./shutdown
$ ./install
$ systemctl start qtest

Machine 4 (load balancer)

Deploy qtestlb into machine 4

  • If you want to deploy the qTest Manager with HTTP, go to step 4.1, ignore 4.2
  • If you want to deploy the qTest Manager with HTTPS, go to step 4.2

4.1 Deploy qtestlb with HTTP into Machine 4:

  • qtest-url: IP of machine 4 (the load balancer)
  • qtest-http: qtest port of machine 4 (the load balancer)
  • cluster: IP of machine 1
  • apps: qtestlb
$ ./configure --apps "qtestlb" --qtest-url "http://<IP of machine 4>:<qtest port of machine 4>" --qtest-http "<qtest port of machine 4>" --cluster "<IP of Machine 1>"
  • Modify configure file to ensure the "datadir" variable point to a shared directory where all 4 machines are able to access
$ vim profiles/default.in
  • Start the deployment
$ ./startup
  • After the above command completes successfully, set up qTest Manager as Linux Daemon and start the service
$ ./shutdown
$ ./install
$ systemctl start qtest

4.2 Deploy qtestlb with HTTPS into Machine 4:

  • Specify path to ssl-key, ssl-cert, ssl-ca
  • qtest-url: IP of machine 4
  • qtest-https: qtest https port of machine 4
  • cluster: IP of machine 1
  • apps: qtestlb
$ ./configure --apps "qtestlb" --ssl-key "<SSL Key>" --ssl-cert "<SSL Cert>" --ssl-ca "<SSL CA>" --qtest-url "https://<IP of machine 4>:<qtest https port of machine 4>" --qtest-https "<qtest https port of machine 4>" --cluster "<IP of Machine1>"
  • Modify configure file to ensure the "datadir" variable point to a shared directory where all 4 machines are able to access.
$ vim profiles/default.in
  • Start the deployment
$ ./startup
  • After the above command completes successfully, set up qTest Manager as Linux Daemon and start the service
$ ./shutdown
$ ./install
$ systemctl start qtest

Installation is now complete.

Access qTest Manager via machine 4 URL (http://<IP of machine4>:<qtest port>), then continue with following section to configure your site.

Set up qTest Manager

Refer to the article here to set up qTest Manager.

What's New

Top FAQs

Popular Topics

Powered by Zendesk