Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

QMetry v8.6 introduces a brand new reporting module. In this guide, we will run you through upgrading QMetry Test Management Reports in your environment. These steps are to be followed on your QMetry Reports server hosted on the Linux machine.

...

  • You can generate a request on QMetry Support Portal,  to get the latest version of QMetry Reports.

  • Download the QMetryReports8711QMetryReports871.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

  • sudo su -
  • docker ps

If they are not seen running start them using the command : docker start qmetry-reports-db qmetry-reports

...

  • docker exec -it qmetry-reports bash
  • cd /opt
  • rm -rf QMetryReports87.zipQMetryReports87
  • exit

Step 4. Copy the QMetryReports8711QMetryReports871.zip into the docker container from server's /opt directory using the following commands and get into the container.

  • cd /opt
  • docker cp QMetryReports8711QMetryReports871.zip qmetry-reports:/opt
  • docker exec -it qmetry-reports bash

Step 5. Unzip the new reports upgrade zip QMetryReports8711.zip copied under docker's /opt directory and go to the unzipped folder.

  • cd /opt
  • unzip QMetryReports8711QMetryReports871.zip
  • cd QMetryReports8711 QMetryReports871

Step 6. Execute the Report Upgrade .jar file

...

Do you want to upgrade QMetry Reports (Y/N) type - Y
Enter QMetry Reports Installation Pathtype - /opt
  • Wait for the .jar to finish executing.
  • Type exit to exit the docker.

Step 8. Update Port from 8000 to 8080 (Post Upgrade Step)

  • cd /var/lib/docker/volumes/spark_report_spark-apps/_data
  • sh ConfigureSyncApp.sh 
  • You will be prompted for several options.
    • Hit `enter` repeatedly to skip all those and wait for the below options:
      • When prompted : Enter Port to Start SyncJob (Reports) - type 8080
      • When prompted : Do you want to Run Force Sync Now? (y/n) - type n
  • Wait for the script to finish executing.

Step 9 - Restart Reports Services

  • docker restart qmetry-reports-db qmetry-reports

Step 10. Configure Force Sync of Reports and Trigger a Sync (Post Upgrade Step)

  • Under Sync Data tab, setup the Report Data Sync from your reports server to QMetry Reporting. 
    • Report Server URL : This should be set to your report server domain URL followed by port 8080 as shown below. Ensure port 8080 is open on the reports server.
    • Click on Test to ensure successful connection and then hit "Test & Save".
    • Hit "Sync Data" to start Reports Data Sync.

...

Users can start using QMetry Reports when the sync is completed.

Depending on your data this process can take ~1 hour. Users can continue to use QMetry during this time.

If you are facing any issues during the upgrade process, write to us at qtmprofessional@qmetrysupport.atlassian.net. This will automatically open a ticket with our support team and help you to follow the progress.