Insights 1.11.2 to 1.12.2 Single Server Upgrade Guide for Linux (non-Docker)

To request assistance with upgrading or to obtain the links to self-upgrade, please click here to fill out the Upgrade Request Form.

In this guide we'll run you through upgrading qTest Insights 1.11.2 to Insights 1.12.2 on a Linux Machine (non-Docker)

Before you begin

Before you upgrade qTest Insights 1.11.2 to 1.12.2, make sure following things are done:

  • qTest Manager has been upgraded to 8.7.3
  • qTest Sessions has been upgraded to 4.0.2


Upgrade qTest Insights from 1.11.2 to 1.12.2


1. Stop and uninstall qTest Insights 1.11.2

Access the current directory "qtestctl" where you've installed Insights 1.11.2

$ ./qtestctl stop
$ ./uninstall 


2. Uninstall JSVC tool

 sudo apt-get remove jsvc 



3. Download new package for qTest Insights 1.12.2 


4. Extract the package  

 $ tar -zxf qtestctl-3.5.2-linux-x64-full.tgz 

5. Access to the package 

 cd qtestctl/ 

6. Modify the configure file 

 vim qtest.config 

Open the file \qtestctl\qtest.config, modify following section only.  

apps = [‘insights’]
/* external tool configurations. these are used as shared configurations to construct applications below */
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>'


7. Install and Start

7.1 Execute this command to initially set up the application

 $ ./qtestctl --offline start

Once you see this message, qTest Insights has been started.


7.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>, ify you get the message "Access denied. Please login again through qTest", that means Insights has started successfully.


7.3 Go back to the Command Prompt and stop the running process (CTRL + C to terminate)

7.4 Execute this command to run qTest Manager as a OS Service

 $ ./install

7.5 Start the OS service

 $ systemctl start qtest

To check if the service is up, use command

 $ systemctl status qtest


8. Migrate data from Insights 1.11.2 to Insights 1.12.2

8.1 Stop Insights 1.12.2 before performing data migration

 $ systemctl stop qtest


8.2 Migrate Scheduler data

Copy data from directory \qtestctl\insights\build\insightsscheduler\Schedules of Insights 1.11.2

to new location of Insights 1.12.2 at 



8.3 Migrate web data

Under Root folder of Insights 1.11.2 \qtestctl\insights\build\tomcat\webapps\ROOT

copy following folders 


to new location of Insights 1.12.2 at \qtestctl\insights\build\tomcat\webapps\ROOT


9. Start Insights 1.12.2

Start Insights 1.12.2

 $ systemctl start qtest


That's everything and you now have qTest Insights being upgraded to 1.12.2. You want to access to your qTest Insights instance via browser to verify if the upgrade process completes successfully, then you may want to unintall qTest Insights 1.11.2.

Powered by Zendesk