Menu

Manager 8.7.3 Single Server Installation Guide for Docker

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 8.7.3 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 requirements
  • 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.3 package?

The qTest's docker-deployment-4.3 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.7.3 includes qtest and its prerequisite applications: redis, rabbitmq, postgres
  • qTest Session 4.0.2 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 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.3 package

$ wget <ENTER DOWNLOAD LINK HERE>

2. Extract the package

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

3. Configure before deploying

$ cd docker-deployment-4.3
  • 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://:" --qtest-http "" --sessions-url "http://:" --sessions-http "" --insights-url "http://:" --insights-http "" --parameters-url "http://:" --parameters-http ""

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

$ ./configure --qtest-url "http://:" --qtest-http "" --sessions-url "http://:" --sessions-http ""

Scenario 3: Deploy only qTest Manager

$ ./configure --qtest-url "http://:" --qtest-http ""

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-cert "" --ssl-ca "" --qtest-url "https://:" --qtest-https "" --sessions-url "https://:" --sessions-https "" --insights-url "https://:" --insights-https "" --parameters-url "https://:" --parameters-https ""

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

$ ./configure --ssl-key "" --ssl-cert "" --ssl-ca "" --qtest-url "https://:" --qtest-https "" --sessions-url "https://:" --sessions-https ""

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

$ ./configure --ssl-key "" --ssl-cert "" --ssl-ca "" --qtest-url "https://:" --qtest-https ""

4. Start the deployment process

  • Execute this command to initially set up and start the application
    $ ./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

  • Open your web browser, access to qTest Manager using the URL specified above validate if it has started successfully
  • Execute these commands to set up qTest Manager as a Linux Daemon
    $ ./shutdown
    $ ./install
    		
  • Start the service. You may need to wait for few minutes for qTest Manager to be available
    $ systemctl start qtest
    		

Set up qTest Manager

Please follow this guide: Configure Manager to complete the remaining steps to activate your account.

Subscribe To Our Blog
Powered by Zendesk