To request installation assistance or to obtain the links to self-install, please click here to fill out the New Install Form.
In this article, we'll run you through installing qTest Sessions 4.0.2 on a separate CentOS/ Ubuntu machine using Docker and then connect it to qTest Manager 8.7 on different machine.
Note: if you want to deploy qTest Sessions 4.0.2 and qTest Manager 8.7 on the same machine, check out this article Manager 8.7.3 Single Server Installation Guide for Docker.
Before you begin
Before you install qTest Sessions 4.0.2, make sure following things are done:
- qTest Manager has been deployed using Docker (in a separated machine)
- 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 device mapper.
- For CentOS 7.X+ or Ubuntu 16.10 machines: Docker requires a 64-bit installation and your kernel must be at least 3.10
Installing qTest Sessions 4.0.2
1. Download package
Download docker deployment package
$ wget <ENTER DOWNLOAD LINK HERE>
Extract the package
$ tar -zxf <DOWNLOADED PACKAGE FILE NAME>
Access to extracted package directory
$ cd <EXTRACTED PACKAGE DIRECTORY>
2. Configure applications
$ ./configure --apps "sessions sessionslb"
3. Configure URL and port
3.1 If you are going to deploy qTest Sessions with HTTP
$ ./configure --sessions-url "http://<IP of current machine>:<sessions port>" --sessions-http "<sessions port>" --cluster "<IP of postgres docker server>"
3.2 If you are going to deploy qTest Sessions with HTTPS
$ ./configure --ssl-key "<SSL Key>" --ssl-cert "<SSL Cert>" --ssl-ca "<SSL Ca>" --sessions-url "https://<IP of current machine>:<sessions https port>" --sessions-https "<sessions https port>" --cluster "<IP of postgres docker server>"
4. Start the deployment process
The script will download the application images 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 and setup for qTest Sessions.
5. Configure qTest Manager
5.1 Login to qTest Manager using administrator account then access to Administration page.
5.2 Go to SYSTEM CONFIGURATIONS page.
5.3 Next, navigate to MISCELLANAOUS section then enter the URL of qTest Manager into qTest server's domain field. Note: if qTest Manager is not running on port 80, you have to specify the port number in the URL.
6.4 Now you can access to qTest Sessions via qTest Manager's nine-box icon
You have finished installing qTest Sessions on its own server.