Goal
- Learn what has changed in Magnolia 5 and prepare for the migration.
- Understand Magnolia 5 and the migration process.
- Know where to find documentation and where to ask for help.
What has changed in Magnolia 5
Before you migrate to 5:
Learn the new dialog definition structure.
- Learn about Digital Asset Management (DAM) which replaces the DMS. See Concept - Migration from DMS to DAM.
Learn about the new JCR mixin node types which replace metadata stored in subnodes. See Concept - MetaData as mixin.
- Learn about content apps which replace the Data module.
- Learn about the new jBPM workflow engine which replaces the OpenWFE engine.
- Learn about changes to group IDs and module names so you can update dependencies in your project POM.
- Update to Tomcat 7.0.47+ to avoid MGNLUI-2426 - Getting issue details... STATUS
Prepare
Before you start the migration tasks, do some preparation:
- Update to the latest maintenance release in the 4.5.x branch. You are already on 4.5 so this is a standard update.
- Clean up your project:
- Remove any deprecated code that is left over from 4.4.
- Review your configuration. Use the extends mechanism where possible.
- Release and deploy this version into your migration environment.
- Activate everything. You should have no running workitems in the repository.
- Create a small website that is a representative sample of all your templates as explained in 2. Prepare and analyze. Keep this repository in a safe place. The easiest way is to copy the
/<CATALINA_HOME>/webapps/<contextPath>/repositoriesfolder. You can restore the repository from the copy if the migration goes wrong.
Analyze
Analyze how your project will be impacted by the changes that happened between 4.5 and 5. It is possible that you don't need to add migration tasks to your version handler react to all the changes. For example, if you didn't have a custom workflow definition before then the default 4-eye jBPM workflow that ships with Magnolia 5 will work fine.