QMetry App Upgrade Document for Linux (from QMetry v8.16.0.1 and above)

Overview

This document is intended for users currently using QMetry v8.16.0.1 or later and provides step-by-step instructions to upgrade the QMetry Test Management application to version v8.29.x on a Linux-based server.

Prerequisites

Before upgrading, ensure the following:

  • Your current QMetry version is v8.16.0.1 or above. To check: Log in to QMetry and check the About section.

  • MySQL version of QMetry Reports and QMetry Application is 8.4.8.

  • Internet connection is enabled on the server.

Upgrading QMetry from v8.16.0.1 and above to the Latest Version

To upgrade QMetry to the latest version, perform the following steps:

Step1: Important: Backup your Existing QMetry Database

To backup your existing QMetry database, perform the following steps:

  1. Create a backup of the "qmetry" database. The backup is saved in /opt by default.

  2. Run the following command to update the username, password, and location of the backup file:

     docker exec qmetryapp_db sh -c 'exec mysqldump -uroot -p<password> --triggers --routines --hex-blob --single-transaction --lock-tables --no-create-db qmetry' > /opt/qmetry_backup_<date>.sql
    Example 24. 
    docker exec qmetryapp_db sh -c 'exec mysqldump -uroot -pqmetry --triggers --routines --hex-blob --single-transaction --lock-tables --no-create-db qmetry' > /opt/qmetry_backup_2021-01-01.sql



  3. Verify that the database is backed up and is available.

Step 2: Downloading the Upgrade Files

Download the required files by performing the following steps:

  1. Get the latest version of QMetry Upgrade Installer from the QMetry Support Portal.

  2. Download QMetry_Linux_Installer.zip to the QMetry Application Server on the host machine.

Step 3: Running the QMetry Upgrade

To run QMetry Upgrade, perform the following steps:

  1. List the running containers using the following command:

    docker ps

    If Docker is not running, use the following command to start it:

    docker start qmetry_app_1

    Note

    Replace the container names with the appropriate application names as specified in the previous command.

    Ensure your applicationDB is up and running.

  2. Unzip the file.

    unzip QMetry_Linux_Installer.zip
  3. Go to the QMetry directory:

    cd QMetry_Linux_Installer
  4. Grant execution permissions to the upgrade script:

    chmod +x upgrade.sh
  5. Execute the upgrade script:

    ./upgrade.sh
  6. Confirm to upgrade.

    Table 30. Upgrade  QMetry

    Options

    Type

    Default Value

    Comments/ Example

    Do you want to make an online upgrade (Y/N)?

    Mandatory

    -

    type - Y/N



  7. QMetry Upgrade Menu

    QMetry_Upgrade_Menu.png

    Type 2 to upgrade App.

  8. Type 0 to exit the installer.

Step 4: Installing or Upgrading QMetry Jira Add-on

Download the correct Jira add-on version that matches your QMetry version. Refer to the table below to find the compatible Jira add-on version based on your QMetry version.

Table 31. Install or Upgrade QMetry Jira Add-on

QMetry Version

Jira-addon version required

8.29.x

v2.4.6_jira10 (Jira Version 10x), 2.4.6 (Jira Version 11x)

8.28.x

v2.4.5_jira10 (Jira Version 10x), 2.4.5 (Jira Version 11x)

8.27.x

2.4.3_jira10 (Jira Version 10x), 2.4.3 (Jira Version 11x)

8.26.x

2.4.2_jira10 (Jira Version 10x), 2.4.2 (Jira Version 11x)



In case you have not installed the QMetry Jira Integration app for integration, follow the Steps to install and configure the QMetry Jira Integration app if it is not installed.Install & Configure QMetry's Jira Integration App

If you encounter any issues during the upgrade, please submit a support ticket on the Support Portal.

Publication date: