To request installation assistance or to obtain the links to self-install, please click here to fill out the New Install Form.
In this guide we'll run you through installing qTest Insights 1.15.3 on a CentOS/Ubuntu Machine
Before you Begin
Follow this article Getting Started with qTest OnPremise 9.0 - Spring 2018 to get an overview of qTest OnPremise deployment
Make sure postgresql5-contrib is installed in the server where you've installed your qTest Database.
sudo apt-get install postgresql95-server postgresql95-contrib
Important: qTest applications requires the username of 'postgres' to complete the installation. This 'postgres' user must also have Superuser rights.
Install qTest Insights 1.15.3
1. Execute following command to update and upgrade system packages
# apt-get update -y && apt-get upgrade -y
2. Download qTest Insights package
Note:
- If you are installing qTest Insights in the same server with other qTest application, e.g. qTest Manager, then you do not need to re-download this installation package but use the one you have downloaded when you installed qTest Manager
- To learn more about qtestctl, refer to this article qTest OnPremise - Technical detail about qtestctl
$ wget <ENTER DOWNLOAD LINK HERE>
3. Extract the package
$ tar -zxf qtestctl-4.0-linux-x64-full.tgz
4. Access to the package
cd qtestctl/
5. Modify the configure file
vim qtest.config
Open the file \qtestctl\qtest.config , modify following section only
5.1 Config application list
5.1.1 If you are installing qTest Insights on a separate server, make sure there is 'insights' in apps list
apps = ['insights']
5.1.2 If you are installing qTest Insights on the same server with other qTest application(s), e.g. qTest Manager, append insights to the app list.
apps = ['manager', 'insights']
5.2 For Insights HTTP
apps = [‘insights’]
...
external {
postgres {
host = '<IP address of Postgres server>'
port = <Postgres port>
auth {
user = ‘postgres’
pass = '<password of postgres user>'
}
db {
qtest = '<qTest Manager database>'
session = '<Sessions database>'
}
}
}
...
/* application configurations */
Insights {
//Insights HTTP Port, make sure the port is not being used by other application
httpport = <qTest Insights port>
//Insights Admin Port, make sure the port is not being used by other application
adminport = <qTest Insights admin port>
...
scheduler {
...
//Scheduler host (same machine with Insights)
server = '<qTest Insights server>'
}
}
5.3 For Insights HTTPS
apps = [‘insights’]
...
external {
postgres {
host = '<IP address of Postgres server>'
port = <Postgres port>
auth {
user = ‘postgres’
pass = '<password of postgres user>'
}
db {
qtest = '<qTest Manager database>'
session = '<Sessions database>'
}
}
}
...
/* common configurations */
common {
ssl {
enabled = true
cert = "<path to certificate file>"
key = "<path to private key file>"
pass = "<passphrase of the private key>"
strict = false
}
}
/* application configurations */
Insights {
//Insights HTTP Port, make sure the port is not being used by other application
httpport = 8081
//Insights Admin Port, make sure the port is not being used by other application
adminport = 8007
ssl {
enabled = common.ssl.enabled
port = <qTest Insights https port>
cert = common.ssl.cert
key = common.ssl.key
pass = common.ssl.pass
}
...
scheduler {
...
//Scheduler host (same machine with Insights)
server = '<qTest Insights server>' //127.0.0.1
}
}
6. Install & Start
Open the console on your machine (run as Administrator role), change the current path to qtestctl directory and follow steps:
6.1 Execute this command to initially set up the application
$ ./qtestctl --offline start
Once you see this message, qTest Insights has been started.
6.2 The command will take control of the Command Prompt. Keep it running. Open your web browser, access to qTest Insights using its URL http://<Insights_host>:<Insights_http_port> to validate if it has started successfully.
HINT: Open http://<Insights_host>:<Insights_http_port>, if you get the message "Access denied. Please login again through qTest", that means Insights has started successfully.
6.3 Go back to the Command Prompt and stop the running process (CTRL + C to terminate)
Set up Linux Daemon
6.4 Execute this command to run qTest Manager as a OS service
Note: If you install qTest Insights in the same machine with other qTest application(s), you only need to execute below command once and only once when you finished installing ALL the applications in this server. Refer to this article to learn more about installing qtest service.
Open a terminal, and navigate to path\to\qtestctl folder
Execute below command in your terminal to install qTest Insights as a Linux daemon
$ ./install
6.5 Start the OS service
$ systemctl start qtest
To check if the service is up, use command
$ systemctl status qtest
That's everything and you now have qTest Insights being installed and started.
Now, you need to connect it to your qTest Manager, access to your qTest Insights and follow steps in the section "Set up qTest Insights"
Set up qTest Insights
Access your Administration page
Under System Configuration page, scroll to section MISCELLANEOUS and enter qTest URL into the field qTest server's Domain.
Scroll to Insights section and enter Parameters URL
http://<IP of the machine where you installed qTest Insights>:<Insights port which you've specified in the config file>
Test Connection and save the configuration.
That's it! You now can access qTest Insights via its option in 9box icon
NOTE
In order for the Insights Scheduler (it is to send scheduled report to your email) to work properly, make sure that you do configure your Email Server in qTest Manager's System Configuration page.