QMetry Reports Upgrade

Owned by Mrunalini Potnis
Jul 29, 2019
2 min read

In this guide, we'll run you through upgrading QMetry Reports that have been installed over dockers. These steps are to be followed on your QMetry Reports server hosted on the 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. Check the running containers using the following command

  • docker ps

Step 3. Remove two folders if already created and Create two new Folders in /opt directory of qmetryreport84x_report_1 docker container using following commands: (Replace x as seen in the container name from the output of above command) 

  • docker exec qmetryreport84x_report_1 rm -rf /opt/Updated
  • docker exec qmetryreport84x_report_1 rm -rf /opt/Backup
  • docker exec qmetryreport84x_report_1 mkdir /opt/Updated
  • docker exec qmetryreport84x_report_1 mkdir /opt/Backup

Step 4. Copy QMetryReport.zip file inside the docker container using the following command : (Replace x as seen in the container name from the output of command : docker ps )

  • docker cp QMetryReport.zip qmetryreport84x_report_1:/opt/Updated
  • docker cp QMetryReport_Upgrader_v8.x.x.zip qmetryreport84x_report_1:/opt/

Step 5. Log into docker tomcat container, using the following command: (replace x as per the version seen in the docker ps command).

If ROOT.zip already exists under /opt/Updated/, first remove this file using the below commands. ROOT.zip will not exist during the first upgrade.

  • docker exec -it qmetryreport84x_report_1 bash
  • cd /opt/Updated/
  • rm -rf ROOT.zip
  • unzip QMetryReport.zip

Step 6. Extract ROOT.zip file using unzip command:

  • cd QMetryReport
  • unzip ROOT.zip
  • cp -R ROOT /opt/Updated/

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

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

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

  • cd /opt
  • unzip QMetryReport_Upgrader_v8.x.x.zip
  • 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 command cd /opt 
  • Backup
  • Updated
  • QMetryReport_Upgrader_v8.x.x.jar

Step 9. Now, go to the directory where you have kept QMetryReport_Upgrader_v8.x.x.jar file and run reporting server upgrade utility using command:

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

Step 10. 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 11. Once utility completes running, go to webapps folder of tomcat and give access (777) to below folders :

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

Step 12. Now, start the tomcat service using below command and exit the container:

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

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