Upgrading Magento 1.9.4.5 to OpenMage 20.x: A Comprehensive Guide
Magento is an e-commerce platform that powers many online stores worldwide. If you’re running Magento 1.9.4.5, it’s crucial to upgrade to a newer version like OpenMage 20.x for better performance and security features.
Understanding the Migration Process
The OpenMage team provides detailed migration guides on their official website (Migration Guide - OpenMage) and GitHub repository (OpenMage/magento-lts on GitHub). However, the process can be complex if you’re not familiar with version control systems like Composer.
You’ve already completed several steps:
- Downloaded the OpenMage 20.x zip file
- Extracted it into your existing Magento 1.9.4.5 root folder
- Updated your PHP version to 8.0
- Modified your plugins and custom theme to be compatible with PHP 8.0
While these steps have successfully migrated your site, there are still some important considerations we need to address.
Removed Modules in OpenMage 20.x
Between Magento 1.9.4.5 and OpenMage 20.x, several modules were removed or deprecated. These include:
Mage_BackupMage_CompilerMage_GoogleBaseMage_PageCacheMage_XmlconnectPhoenix_Moneybookers
You mentioned that these modules are still active in your installation because you only overwrote the files and folders. This means they haven’t been properly removed from your system.
Removing Deprecated Modules Manually
To ensure a clean upgrade, you need to remove these deprecated modules manually:
- Navigate to the
app/code/coredirectory of your Magento installation. - Locate the folders corresponding to the deprecated modules (e.g.,
Mage_Backup, etc.). - Delete these folders.
You can use this command in the terminal to delete them all at once:
find app/code/core -type d -name 'Mage_*' | xargs rm -r
Be careful when using this command, as it will remove all folders starting with Mage_. Always ensure you have a backup of your installation before performing any deletions.
Identifying Other Removed Modules
To understand if there are other removed modules in OpenMage 20.x that you need to address:
- Visit the OpenMage GitHub repository.
- Check the “Breaking Changes” and “Deprecated Features” sections of the CHANGELOG.md file.
These files document all changes between versions, including removed modules and features.
Conclusion
Upgrading from Magento 1.9.4.5 to OpenMage 20.x is a significant step that requires careful planning and execution. Remember:
- Always backup your installation before making any modifications
- Carefully review the migration guides provided by OpenMage
- Manually remove deprecated modules to ensure a clean upgrade
If you encounter any issues during the process, don’t hesitate to reach out to the OpenMage community for further assistance.
For more advanced Magento development tips and best practices, visit our blog at LaravelCompany.