Versions Compared


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

Table of Contents


Important Pre-requisites to check before upgrade to

  • Proceed with this upgrade ONLY IF your current QMetry version is v8.6.0 Build 2 or above. To check : Go to QMetry > About section.

Below are the steps to be followed to upgrade your existing QMetry installation :

Step 1 : Download Required Files

  • Please write to QMetry Support by sending an Email at,  to get the latest version of QMetry Upgrade Installer.

  • Download the to your QMetry Application Server once you receive it.

Step 2 : IMPORTANT : Backup your existing QMetry Database

Take the backup of your existing “qmetry” database. You can replace username, password, location of backup file (currently default /opt). Replace x with the mysql docker name seen in the output of command : docker ps

  • Syntax : docker exec qmetry_rds_1 sh -c 'exec mysqldump -uroot -p<password> --triggers --routines --hex-blob --single-transaction --lock-tables --no-create-db qmetry' > /opt/qmetry_backup_<date>.sql

  • For example: docker exec qmetry_rds_1 sh -c 'exec mysqldump -uroot -pqmetry --triggers --routines --hex-blob --single-transaction --lock-tables --no-create-db qmetry' > /opt/qmetry_backup_2020-01-01.sql

Verify that your database has been backed up properly and is available for later use in case of any emergency.


Step 3 : Run the QMetry Upgrade

1. Check the running containers using the following command. The dockers must be running to ensure a successful upgrade.

  • docker ps
  • If the dockers are not running, start them using the below commands (replace container names according to the application container name seen in command above)
    • docker start qmetry_rds_1
    • docker start qmetry_app_1

2. Go to the directory where the file is downloaded.

3. Copy file inside the docker container using the following command (replace x with the application container name seen in command above and the upgrade zip received) :

  • command : docker cp qmetry_app_1:/opt
    • Note: Your current tomcat installed path in docker container would be /home/qmetry/QMetry.

4. Log into docker container, using the following command (replace x with the application container name seen in command : docker ps )

  • command : docker exec -it qmetry_app_1 bash

5. Go to /opt directory where the file is copied using command

  • cd /opt

6. Unzip the file under the /opt directory separate from your current installation path /home/qmetry/QMetry

  • unzip QMetry8612

7. Go to QMetry directory:

  • cd QMetry8612QMetry8613

8. Give permission to file through the following command

  • chmod +x

9. Enter the following command and then pass the parameters mentioned
  • sh -x

10. Utility will confirm if you want to upgrade, type Yes, and then specify the path of existing QMetry installation.

OptionsTypeDefault ValueComments/ Example
Do you want to upgrade the Existing version of QMetry?Mandatory


type - yes

Specify path of existing version of QMetry


type - /home/qmetry/QMetry

Wait for the process to complete.

11. Exit from docker container once the process is completed, use the following command:

  • exit

Step 4 :Additional Tomcat and MySQL Configuration (Mandatory)

QMetry is installed with a default configuration of minimum and maximum heap memory utilization. You should modify these settings depending on your hardware configuration. Refer Additional Configuration for more details.

Step 5 : Restart QMetry and MySQL Docker Container

  • Check the running containers using the following command:
    • docker ps
  • Restart both docker containers using below commands (Note : QMetry DB docker container name changes from qmetry85_mysql_1 to qmetry_rds_1 )
    • docker stop qmetry_app_1 qmetry_rds_1
    • docker start qmetry_rds_1
    • docker start qmetry_app_1
  • Note : In case you have configured Redis Caching for QMetry installed on same server OR a separate server - connect to that server and run the below commands :
    • To view existing containers : docker ps
    • Replace the container name seen in above command : docker exec -it container-name redis-cli FLUSHALL

Step 6 : Installing / Upgrading Jira add-on for Integration of QMetry and Jira.


QMetry VersionJira-addon version required
On, or above
On or above
On or above