Page History
...
Table of Contents | ||||
---|---|---|---|---|
|
General procedure
...
What to update
Anchor | ||||
---|---|---|---|---|
|
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).
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|
Anchor | ||||
---|---|---|---|---|
|
With Magnolia 5.7 we have removed a few modules which ere not bundled but 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
Jira | ||||||||
---|---|---|---|---|---|---|---|---|
|
Webdav
Note |
---|
You must remove the |
Tomcat 9.0.8
If you are using Tomcat: We moved to Tomcat 9.0.8.
3rd-party libraries
Jackrabbit 2.16.1
If you want to run Magnolia on Java 8 or 9, 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 →
→Artifact resource link rangeHigherVersion 5.6 groupId info.magnolia.bundle artifactId magnolia-bundle-parent label $version renderType display_only resourceType POM
→ 5.7Artifact resource link rangeHigherVersion 5.7 groupId info.magnolia.bundle artifactId magnolia-bundle-parent label $version renderType display_only resourceType POM - 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
...
The magnolia.properties
file
...
Code Pro | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
...
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).
Expand | ||||||
---|---|---|---|---|---|---|
| ||||||
|
...
With Magnolia 5.7 we have removed a few modules which ere not bundled but 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
Jira | ||||||||
---|---|---|---|---|---|---|---|---|
|
Webdav
Note |
---|
You must remove the |
...
Magnolia 5.7 can be run on Java 8, 9 or 10. The minimum Java version required stays at 8. We also took the opportunity to numerous 3rd-party libraries.
You should you replace all the 3rd-party libraries listed below. We list the new version which you should add.xxx
Tomcat 9.0.8
We moved to Tomcat 9.0.8.
Jackrabbit 2.16.1
If you want to run Magnolia on Java 8 or 9, 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
...