QMetry Reports Online Upgrade Document for Linux
Overview
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.
Steps to upgrade existing QMetry Reports to the latest version
Upgrade Steps
Step 1: Download Required Files
Get the latest version of QMetry Upgrade Installer from the QMetry Support Portal.
Download the QMetryReportsUpgrade.zip file on your report server's /opt directory once you receive the report upgrade package.
Step 2. Check the container name using the following command.
sudo su
docker ps -a --format "table {{.ID}}\t{{.Names}}\t{{.Image}}"
Step 3. Go to Upgrade Script.
Go to the folder where QMetryReportsUpgrade.zip was downloaded
cd /opt
Unzip QMetryReportsUpgrade.zip
unzip QMetryReportsUpgrade.zip
Go to the QMetryReportsUpgrade folder
cd QMetryReportsUpgrade/
Step 4. Modifying the container name
If the QMetry Reports container name is different from qmetry-reports, then perform the following steps; otherwise, skip this step.
Open the file – upgrade.sh in edit mode
vi upgrade.sh
Update the file for the changed value with the respective name of the container
Press i to change the file mode to insert
Update the variable value in the upgrade.sh files as per the existing docker name in system, which is fetched in Step# 2.
OLD_CONTAINER_NAME=<existing docker container's name>
Press Esc, and type:wq to save the changes
Step 5. Permit to upgrade.sh file through the following commands.
chmod +x upgrade.sh
sh upgrade.sh
The next question during the upgrade process will be as follows.
Options | Allowed Values | Default Value | Recommended Value |
|---|---|---|---|
Do you want to make an online installation (Y/N)? | Y, y, N, n | Y | Enter "Y" to begin the online upgrade. |
Step 6. While running the script it will ask for verifying the QMetry App Database and QMetry Reports Database connection configurations that were in place earlier and take the next step accordingly.
Press “y” – If the database configurations shown are correct and modifications are not required in that.
Press “n” – If the database configurations shown are incorrect and modifications are required in that area.
You will be asked to enter the new configuration details.
Press “e” – If you don't want to continue the upgrade process and want to exit.
If you have pressed “y” or “n” then in that case after pressing an option, you will be asked to enter the number of CPU's and Memory to allocate.
Once that is entered, wait for the script execution to complete.
Depending on your data this process can take time as it will be performing full QMetry Data Sync. Users can continue to use QMetry Application during this time. But QMetry custom reports remain inaccessible when the syncing is in progress.
If you are facing any issues during the upgrade process, kindly generate a support ticket on Support Portal for assistance.