...
Table of Contents | ||||||
---|---|---|---|---|---|---|
|
Steps to upgrade to MySQL v8.0.33 DB Container
Pre-requisites
Ensure that QMetry is not in use and that there are no ongoing operations or traffic on the QMetry.
...
Expand | ||
---|---|---|
| ||
Download the Container Image of QMetry DB Follow these steps on a machine where the internet is accessible so that the container images can be downloaded on it. → Steps to download the container image of the QMetry Database: 1. Execute the following command. Next, it will ask for container repository credentials. Enter the required credentials. If you do not have the credentials, please contact QMetry Support.
After entering container repository credentials, it will show the success message as shown below. 2. Execute the following commands to download and save QMetry Database container image.
3. Transfer the qmetrydb.tar file to the host server. Restore the Container Image of QMetry DB → Steps to restore the container image of the QMetry Database: 1. If you are using the "root" user for installation, then execute the following command. If the user is other than the "root" user, skip this step.
2. Navigate to the directory where the qmetrydb.tar file is placed. Then execute the following command.
3. Execute the following command to check whether the container images have been restored correctly or not.
|
Step 1. IMPORTANT: Backup your existing QMetry Database
Take the backup of your existing “qmetry” database. You can replace the username, password, location of the backup file (currently default /opt).
...
Go to the QMetry application server and execute the following commands:
docker stop <docker_name>
example: docker stop qmetry_app_1
...
Copy the QMetryDBUpgrade.zip file received from QMetry Support to the server where the QMetry DB container is located. Navigate to the directory where this file is kept and execute the following command.
unzip QMetryDBUpgrade.zip
The following process will create a backup of the data from the MySQL 5.7.28 container. Next, a new container for the database will be set up, running on MySQL v8.0.33. Finally, the backed-up data will be restored into the new MySQL v8.0.33 container.
Step 4. Execute the following commands.
cd QMetryDBUpgrade
sudo su
chmod +x upgradedb.sh
sh upgradedb.sh
Next, the installation process will prompt you with the following questions.
Options | Default Value | Description |
---|---|---|
Do you have QMetry's application container running on this machine? (Y/N) | Y | Mention “N” for 3-tier. |
Do you have QMetry's database container running on this machine? (Y/N) | Y | Mention “Y” for 3-tier. |
Enter the name of QMetry's database container | qmetry_rds_1 | Enter the QMetry Database container name. |
Enter current Database Host | - | Enter Database Host Public IP/DNS of QMetry application. |
Enter current Database Port | - | Enter Database Port of QMetry application. |
Enter current Database User | - | Enter Database username of QMetry application. |
Enter current Database Password | - | Enter Database password of QMetry application. |
Enter current Database Schema | - | Enter Database schema name of QMetry application. |
Note: This process may take time depending on the amount of data in the database.
Steps to upgrade QMetry to the latest version
Follow the document QMetry Upgrade Document (to latest version) to upgrade to the latest version.
Clean up data from MySQL 5.7.28 container
Refer to this section only after performing the steps mentioned in the Steps to upgrade to MySQL v8.0.33 DB Container and Steps to upgrade QMetry to the latest version sections above.
...
Cleanup Commands:
Execute the following commands on the server where the QMetry DB container is located.
docker rm qmetry_rds_1
docker volume rm $(docker volume ls -qf dangling=true)
docker image prune -af
If you are facing any issues during the upgrade process, kindly generate a support ticket on the Support Portal for assistance.
...