In this guide we'll run you through installing qTest Insights 1.11.2 on a Windows Machine
Before you begin
Before you install qTest Insights 1.11.2, make sure following things are done:
- Your machine needs to satisfy qTest's recommended hardware requirements
- qTest Manager 8.4.4 has been deployed
- qTest Sessions 3.0.9 has been deployed
- Access to the server where you install qTest Manager's Database, connect to your Manager database and create a schema for Insights as following instructions:
Connect qTest DB using postgres user
C:\Program Files\PostgreSQL\9.5\bin>psql -h [Your_Postgres_server_address] -U postgres -W [Your_qTest_DBName]
Password for user postgres: //enter your password here
Create Insights schema (use the schema name "insights")
create schema insights;
Install qTest Insights 1.11.2
1. Download qTest Insights installation package
Download qtestctl-3.0 package here
2. Extract the package
Extract the package, access the directory "qtestctl"
3. Modify the configure file
Open the file \qtestctl\qtest.config file, modify following section only
apps = [‘insights’]
...
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>'
}
}
...
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>
}
4. Install and Start
Open the console on your machine (run as Administrator role), change the current path to qtestctl directory and run following command to let Insights run as service
C:\[path_to_qtestctl]>install.bat
Start
C:\[path_to_qtestctl]>qtestctl.bat start
That's everything and you now have qTest Insights being installed and started.
NOTE:
For some reason, if you want to stop the server. Open CMD (Run as Administrator role)
C:\[path_to_qtestctl]>qtestctl.bat stop
For some reason, you want to uninstall qTest Insights. Open CMD (Run as Administrator role)
C:\[path_to_qtestctl]>uninstall.bat
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 Insights 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.
