This document guides migrating from previous versions to the latest Release6.3.4.2 version.
Prerequisites for Migration
Before initiating the migration process, ensure that the following prerequisites are met:
Supporting Application Configurations
-
Upgrade Infrastructure (Optional)
Ensure that the applications and the operating system support the upgraded amount of RAM and have sufficient space on the new SSD for optimal performance.
-
Upgrade Database Version
Upgrade the database to the below-mentioned versions for software performance and security. The previous versions of MySQL are no longer supported.
- Upgrade MySQL Version to 8.0.4x or higher. For more information, refer to
Upgrading AWS MySQL 5.7 to 8.0.x- Note: The same process applies when upgrading MySQL from 8.0.3x to 8.0.4x.
- Upgrade MariaDB Version to 10.6.x or 10.11.x.
Pre Upgradation
Take Database Backup
Ensure a comprehensive backup of the Database (MySQL or MariaDB) is taken.
For more information, OvalEdgeDB Backup Process
Table Row Count Validation
Validate the row count of all database entities to confirm the success of the migration process.
Detailed instructions are available in the DB Migration Checklist
Upgrade or Install ElasticSearch
Upgrade ElasticSearch to 7.17.x for improved search capabilities within the OvalEdge. Refer to the document for more information.
Installing Elasticsearch on Container Systems
Application Backups
Before commencing the migration, execute the following backup and validation procedures:
Database Backup
Before starting the migration, ensure a comprehensive backup of the Database (MySQL or MariaDB) is taken.
Image Backup
Backing up the image ensures that if the primary image becomes corrupted or lost during migration, it can be rolled back to the previous state if needed.
Helm Charts Backup
Helm charts contain the configuration details necessary to deploy and manage applications within Kubernetes clusters. Backing up these charts ensures the deployment environment is protected in case of any issues during migration.
System Settings Backup
Take the backup of the system settings table from the OvalEdge database in XLSX format to ensure the configured default settings are available to reflect in the new version.
For detailed instructions on taking table backups to CSV/XLSX, refer to the MySQL Table Backup to CSV/XLSX Guide
Migration Process
For Container-based systems, the migration process involves updating the YAML (value.yaml) properties by replacing the older image name with a new one and uploading lineage and CSP jars if they are read from EFS. Refer to the document for more information EFS Volume Mount with Access point.
Note: Lineage and csp-lib jars should be placed in third-party jars mounted on the EFS service, as referred to in the EFS Mount document.
Governance App Configurations
These configurations are crucial to redirect users to governance-related applications using email or direct links. Refer to the document to configure the Governance application. Governance App Configuration
Configure One Pod at a Time
It's crucial to emphasize bringing one pod at a time.
As shown in the screenshot below, the job pod should be set to zero during deployment.
The jobdeployment.yaml & uideployment.yaml file should contain the below parameters as comments, as shown in the screenshot, until the migration process is complete.
Note: Post Migration, uncomment the above parameters and restart the deployment.
Post Migration Checks
Tables & Row Count Validation
Conduct a thorough verification of Tables & data row counts in the post-migration environment.
Ensure that the actual counts match the pre-upgradation counts to identify and rectify any discrepancies. This will serve as a key indicator of a successful migration.
The SQL scripts can be used to validate row and table counts.
Download the scripts from the following S3 link: Tables and Row Count Validation Scripts.
Verify Application
Verify that the latest enhancements and features are successfully deployed in the application post-migration.
Copyright © 2025, OvalEdge LLC, Peachtree Corners, GA USA.