Insights 1.11.2 to 1.12.2 Single Server Upgrade Guide for Windows

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 Windows Machine

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


C:\[path_to_OLD_qtestctl]>net stop qtest


2. Remove unused services 

Extract the package and access the directory "qtestctl" and run following command 

 nssm stop QASProjectModule-Updater
nssm remove QASProjectModule-Updater
nssm stop QASTestCycle-Updater
nssm remove QASTestCycle-Updater

 Make sure there is NO qTest or qTest Insight service is running on this machine


3. Download and extract new package for qTest Insights 1.12.2


4. Modify the configure file 

Access the directory "qtestctl" of the new package, open the file \qtestctl\qtest.config, modify following section only.  


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>



5. Install and Start

Open the console on your machine (run as Administrator role), change the current path to qtestctl directory and follow steps:

5.1 Execute this command to initially set up the application

 C:\[path_to_qtestctl]>qtestctl.bat start

5.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.


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

5.4 Execute this command to run qTest Manager as a Windows service


5.5 Start the Windows service

 C:\[path_to_qtestctl]>net start qtest


6. Migrate data from Insights 1.11.2 to Insights 1.12.2

6.1 Stop Insights 1.12.2 before performing data migration

 C:\[path_to_NEW_qtestctl]>net stop qtest


6.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 



6.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


7. Start Insights 1.12.2

Start Insights 1.12.2

 C:\[path_to_qtestctl]>net 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