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
2. Uninstall JSVC tool
sudo apt-get remove jsvc
3. Download new package for qTest Insights 1.12.2
$ wget <ENTER DOWNLOAD LINK HERE>
4. Extract the package
$ tar -zxf qtestctl-3.5.2-linux-x64-full.tgz
5. Access to the package
6. Modify the configure file
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 */
host = '<IP address of Postgres server>'
port = <Postgres port>
user = ‘postgres’
pass = '<password of postgres user>'
qtest = '<qTest Manager database>'
session = '<Sessions database>'
/* application configurations */
//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 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
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.