Prerequisites

1. Docker Host version 1.6+ has been installed on the machine where you are deploying qTest components. Ports 53 and 6783 on this machine need to be exposed if you are deploying with clustering model
   • For CentOS 7.X+ or Ubuntu 14.04+ machines: Docker requires a 64-bit installation and your kernel must be at least 3.10
   • Please follow these instructions to install Docker on your machine
2. Docker Client has been installed. You will need to execute the deployment shell scripts in this instruction using the tool
3. Docker Host is accessible using Docker Engine
4. Docker Host's configuration needs to satisfy qTest Insights' recommended hardware requirement

»Deploy qTest Insights components

»Configure qTest Insights

Deploy Insights components

Application name	Application code (You will need to pass the application codes to --apps parameter when deploying)
qTest Insights' Web Application	insights
qTest Insights' Load Balancer	insightslb
qTest Insights' Scheduler	insightsscheduler

 

1. Access to your machine where Docker Client has been installed using root or a user which has been added to docker user group
2. Download the qTest Insights package

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

3. After qTest Docker Deployment package has been downloaded, extract it

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

4. Access to the extracted directory

   $ cd docker-deployment-3.0
   

5. Configure the bundle before deploying
   • To deploy Insights components with default configurations, execute the following command with the --cluster pointing to a valid qTest's address

     $ ./configure --apps "insights insightslb insightsscheduler" --cluster "<address of qTest server>"      

   • Eg:

     $ ./configure --apps "insights insightslb insightsscheduler" --cluster "192.168.74.6"  

6. Make sure ports 53 and 6783 are open for both TCP and UDP on qTest's server
7. Start the deployment process

   $ ./startup
   

8. The script will download the Docker images and qTest Insights components to the Docker Host. It may take couple of hours depending on your network connection
9. After the deployment process completes, please access to qTest Insights via your browser to configure it following this instruction

Available parameters to configure the deployment

Parameter	Required	Default value	Description
cluster	Yes		IP address of qTest server that qTest Insights will connect to
ssl-key	No		In case you are using SSL connection, specify the path to the private key on the Docker Host
ssl-cert	No		In case you are using SSL connection, specify the path to the certification on the Docker Host
ssl-ca	No		Specify the path to the certification of the authority on the Docker Host
confdir	No	/etc/qasymphony	The directory on the Docker Host where different configurations are stored. It is recommended that you do not change the default value.
datadir	No	/var/lib/qasymphony	The directory on the Docker Host where data files such as database files and attachments are stored. It is recommended that you do not change the default value.
logdir	No	/var/log/qasymphony	The directory on the Docker Host log files are stored. It is recommended that you do not change the default value.
insights-http	No	9080	Define qTest Insights' http port
insights-https	No	9443	Define qTest Insights' https port

Configure qTest Insights

1. Login to your qTest using a site admin account. Access to site administration section
2. Select tab System Configuration
3. In Insights section, update qTest Insights URL.