QMetry Reports Upgrade (without Docker)

Owned by Mrunalini Potnis
Jul 29, 2019
2 min read

In this guide, we'll run you through upgrading QMetry Reports manually. These steps are to be followed on your QMetry Reports server hosted on linux machine.

Pre-requisites - If QMetry is running on https, QMetry Reports should also run on https protocol.

Here are the steps

Step 1. Download Required Files

  • Please write to QMetry Support by sending an Email at qtmprofessional@qmetrysupport.atlassian.net, to get the latest version of QMetry reports and report upgrader utility.

  • Download the QMetryReport_Upgrader_v8.x.x.zip and QMetryReport.zip file on your report server's /opt directory once you receive the report upgrade package.

Step 2. Remove two folders if already created and Create two new Folders in /opt directory of your reports server if they do not already exist, by executing below commands;

  • sudo su
  • rm -rf /opt/Updated
  • rm -rf /opt/Backup
  • mkdir /opt/Updated
  • mkdir /opt/Backup

Step 3. Copy the QMetryReport.zip under /opt directory to /opt/Updated directory.

  • cp /opt/QMetryReport.zip /opt/Updated/

Step 4. Getting files from QMetryReports.zip

  • cd /opt/Updated/
  • Delete ROOT.zip if it already exists : rm -rf ROOT.zip
  • unzip QMetryReport.zip
  • cd QMetryReport
  • unzip ROOT.zip
  • cp -R ROOT /opt/Updated/

Step 5 : Go to bin folder of tomcat and stop the tomcat of the report server. Run the following commands

  • cd /opt/tomcat/bin/
  • sudo sh shutdown.sh

Step 6. We have copied QMetryReport_Upgrader_v8.x.x.zip under /opt directory. Extract this zip file using unzip command and move QMetryReport_Upgrader_v8.x.x.jar to /opt

  • unzip QMetryReport_Upgrader_v8.x.x.zip
  • cd QMetryReport_Upgrader_v8.x.x
  • cp QMetryReport_Upgrader_v8.x.x.jar /opt

Note: Make sure Updated folder should be at same level where you have copied the QMetryReport_Upgrader_v8.x.x.jar file. The Folder structure under /opt should be like this after executing command cd /opt 

  • Backup
  • Updated
  • QMetryReport_Upgrader_v8.x.x.jar

Step 7. Now, go to the /opt directory where you have kept QMetryReport_Upgrader_v8.x.x.jar file and run reporting server upgrade utility using commands

  • cd /opt
  • java -jar QMetryReport_Upgrader_v8.x.x.jar

Step 8. Upon executing the QMetryReport_Upgrader_v8.x.x.jar with above commands, you will be asked below questions:

  • Do you want to upgrade QMetry Report? – Y
  • Enter QMetry Report Path. Provide full path of tomcat up to ROOT (/opt/tomcat/webapps/ROOT/) 

Step 9. Once the utility finishes runinng, go to webapps folder of tomcat and give access (775) to ROOT folder using below command

  • chmod -R 777 /opt/tomcat/webapps/ROOT/

Step 10. Now, start the tomcat service using below command:

  • cd /opt/tomcat/bin
  • sh startup.sh

Verify that the reports are accessible in QMetry to confirm the upgrade.