Prerequisites
- 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
- Docker Client has been installed. You will need to execute the deployment shell scripts in this instruction using the tool
- Docker Host is accessible using Docker Engine
- 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 |
- Access to your machine where Docker Client has been installed using root or a user which has been added to docker user group
- Download the qTest Insights package
$ wget https://s3.amazonaws.com/qtest-storage/docker/deployment/docker-deployment-3.0.tar.gz
- After qTest Docker Deployment package has been downloaded, extract it
$ tar -zxf docker-deployment-3.0.tar.gz
- Access to the extracted directory
$ cd docker-deployment-3.0
- 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"
- To deploy Insights components with default configurations, execute the following command with the --cluster pointing to a valid qTest's address
- Make sure ports 53 and 6783 are open for both TCP and UDP on qTest's server
- Start the deployment process
$ ./startup
- 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
- 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
- Login to your qTest using a site admin account. Access to site administration section
- Select tab System Configuration
- In Insights section, update qTest Insights URL.