Menu

Insights 1.12.2 to 1.15.3 Single Server Upgrade Guide for Windows

Overview

In this article, we provide step-by-step instructions to upgrade qTest Insights 1.12.2 to qTest Insights 1.15.3 on a single Windows machine. Please read the instructions thoroughly before starting your installations.

To request assistance with upgrading or obtain the self-upgrade links, complete the Upgrade Request Form and reference the OnPremise Upgrades Guide.

Note: If you are performing a fresh install, use the OnPremise New Install Form and reference the OnPremise Install Guide.

Before You Begin

Upgrade qTest Insights from 1.12.2 to 1.15.3

Stop and Uninstall qTest Insights 1.12.2

C:\[path_to_OLD_qtestctl]>net stop qtest

C:\[path_to_OLD_qtestctl]>uninstall.bat

Download and Extract the New Package for qTest Insights 1.15.3

The download link will be provided to your by our Implementation Team.

NOTE:

  • If you plan to upgrade qTest Insights in the same server as other qTest application(s), e.g. qTest Manager, you do not need to re-download the package but use the one you have already downloaded 
  • To learn more about qtestctl, refer to this article qTest OnPremise - Technical detail about qtestctl

Modify the Config File 

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

Config Application List

  • If you are upgrading qTest Insights on a separate server, make sure there is 'insights' in the apps list.
    apps = ['insights']
  • If you are upgrading qTest Insights on the same server with other qTest application(s), e.g. qTest Manager, append insights to the app list.
    apps = ['manager', 'insights'] 

For Insights HTTP

...
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>'
}
}

 

For Insights HTTPS

...
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>'
}
}

Install and Start

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

  1. Execute this command to initially set up the application.
    C:\[path_to_qtestctl]>qtestctl.bat start
  2. The command will take control of the Command Prompt. Keep it running.
  3. Open your web browser, access to qTest Insights using its URL http://<Insights_host>:<Insights_http_port> to validate if it has started successfully.
  4. Go back to the Command Prompt and stop the running process (CTRL + C to terminate.)

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.

accessdenied.png

Set up Windows Service

To enable qTest Insights to automatically start when Windows starts, you need to install it as a Windows 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.

  1. Open a Command Prompt if you haven't done so, and navigate to C:\[path_to_qtestctl] folder.
  2. Execute the command below in your Command Prompt to install qTest Insights as a Windows service.
    C:\[path_to_qtestctl]>Install.bat
  3. Start the Windows service.
    C:\[path_to_qtestctl]>net start qtest

Migrate Data from Insights 1.12.2 to Insights 1.15.3

  1. Stop Insights 1.15.x before performing data migration.
    C:\[path_to_NEW_qtestctl]>net stop qtest
  2. Migrate Scheduler data.
  3. Copy data from directory \qtestctl\insights\build\insightsscheduler\Schedules of Insights 1.12.2 to a new location of Insights 1.15.3 at:
    \qtestctl\insights\build\insightsscheduler\Schedules
  4. Migrate web data.
  5. Under Root folder of Insights 1.12.2 \qtestctl\insights\build\tomcat\webapps\ROOT
    Copy following folders:
    • CustomReports
    • ExecutedReports
    • rdDataCache
    • rdDownload
    • SavedBookmarks
    • SavedDashboards
  6. Move the copied folders to a new location for Insights 1.15.3 at:
     \qtestctl\insights\build\tomcat\webapps\ROOT

 Start Insights 1.15.3

C:\[path_to_qtestctl]>net start qtest

qTest Insights is now upgraded to 1.15.3. You will want to access your qTest Insights instance via your web browser to verify if the upgrade process completes successfully. 

Subscribe To Our Blog
Powered by Zendesk