The 5.7 branch of Magnolia reached End-of-Life on December 31, 2023, as specified in our End-of-life policy. This means the 5.7 branch is no longer maintained or supported. Please upgrade to the latest Magnolia release. By upgrading, you will get the latest release of Magnolia featuring significant improvements to the author and developer experience. For a successful upgrade, please consult our Magnolia 6.2 documentation. If you need help, please contact info@magnolia-cms.com.
Before starting the upgrade, please read the release notes for the version you are updating to and all intermediate versions, the general upgrade procedure and also check the Certified stack page. If migrating from Magnolia 4.4/4.5, please read migration documentation first. You can also contact us for migration support.
What to update
Adding new Magnolia modules - the privacy modules
If you have an Enterprise license - add the new Privacy modules which helps you to adapt your websites compliant with the General Data Protection Regulation (GDPR).
Removing outdated add-on modules
With Magnolia 5.7 we have removed a few modules which were not bundled but which were added as add-ons. We recommend to remove them.
Here is the list of the removed add-on modules:
- magnolia-jndi-1.0.2
- magnolia-module-newsletter-bundle-2.2
- magnolia-module-webdav-2.1.3
- magnolia-templating-samples-5.4.1
See also MGNLEE-533 - Getting issue details... STATUS .
Webdav
You must remove the magnolia-module-webdav
- since Jackrabbit 2.16 is not supporting webdav anymore.
The magnolia.properties
file
TODO:
When upgrading Magnolia - its is always worth to compare your magnolia.properties
file with the one coming from freshly released Magnolia bundles.
Between Magnolia 5.6.6 and Magnolia 5.7 - the magnolia.properties
file has not changed.
Below find the latest versions of the magnolia.properties
files of the Magnolia 5.7 series:
Magnolia CE / Magnolia EE Standard*
*) Magnolia CE and Magnolia EE Standard are using the samemagnolia.properties
file.Magnolia EE Pro
xxxTomcat 9.0.8
If you are using Tomcat - we have upgraded to Tomcat 9.0.8.
In case you are using another servlet container - have a look at the Certified stack.
3rd-party libraries
Jackrabbit 2.16.1
If you want to run Magnolia on Java 9 or 10, you must use Jackrabbit 2.16.1.
- jackrabbit-api-2.16.1
- jackrabbit-core-2.16.1
- jackrabbit-data-2.16.1
- jackrabbit-jcr-commons-2.16.1
- jackrabbit-spi-2.16.1
- jackrabbit-spi-commons-2.16.1
Vaadin 8.4.2
If you come from Magnolia 5.5.x or even lower, please read the instructions to upgrade to Magnolia 5.6.x concerning custom modules and the widget set too.
- vaadin-compatibility-aceeditor-1.0
- vaadin-compatibility-ckeditor-1.0
- vaadin-compatibility-client-8.4.2
- vaadin-compatibility-context-menu-1.0
- vaadin-compatibility-expandingtextarea-1.0
- vaadin-compatibility-server-8.4.2
- vaadin-compatibility-shared-8.4.2
- vaadin-compatibility-themes-8.4.2
- vaadin-compatibility-tokenfield-1.0
- vaadin-server-8.4.2
- vaadin-shared-8.4.2
- validation-api-1.1.0.Final
Other 3rd-party libraries
- commons-lang3-3.7
- freemarker-2.3.25-incubating
- groovy-all-2.4.3
- gson-2.2.2
- guice-4.2.0
- guice-multibindings-4.2.0
- jackson-databind-2.9.5
- jsoup-1.8.3
- mycila-guice-closeable-4.0
- mycila-guice-injection-4.0
- mycila-guice-jsr-4.0
- snakeyaml-1.21
- xercesImpl-2.12
How to update
Recommendations
Update to your latest minor release version first before upgrade to recent major release. A June 2018 example: a customer is considering an upgrade from 5.5.8 to 5.7. The correct sequence would be: 5.5.8 →
→ → 5.7- Update all external libraries required by the Magnolia release to which you intend to upgrade.
- Carefully look for "change" or "changes for ..." sections in the release notes since.
- Because the upgrade process takes time and is vulnerable to incidents, please minimize the risk by cleaning up your system, removing unused data, reindexing everything and doing a full backup first.
Updating manually
- Stop the application server.
- Extract the new Magnolia bundle.
- Replace JAR files in the
WEB-INF/lib
folder of your old Magnolia instances with new JARs from the bundle.
Note that Magnolia 5.7 updates numerous 3rd-party libraries - see Java 8, 9 and 10 runtime compatibility and library updates. - Remove any module JARs you had previously removed from your instances. Add any modules you might have added.
Note that we have removed a few modules from the add-ons. Some of them you must remove. See Removing outdated add-on modules. - Add new introduced modules - see Adding the privacy modules.
- Optional: Delete all indexes to give them a little boost. Delete the
index
folder under each workspace directory:repositories/magnolia/workspaces/<workspace>/index
. Indexes are recreated on startup, which might take a while depending on the size of your repository. - If you customized
magnolia.properties
files, compare the changes to the file in the new bundle. Properties may have been added and removed. - Read release notes for all intermediary versions for any additional update tasks.
- Restart the application server.
- Using your browser, go to the Magnolia instances and run the Web update.
Updating Maven managed webapps
...
Known issues
If you encounter problems, please check the Known issues page first.