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 be installed in the server where you've installed qTest Database.

 sudo apt-get install postgresql95-server postgresql95-contrib 

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.