Page History
...
Table of Contents | ||||
---|---|---|---|---|
|
What to update
Anchor | ||||
---|---|---|---|---|
|
...
privacy modules
If you have an Enterprise license, add the new Privacy privacy modules that help you make your websites GDPR-compliant:.
...
Anchor | ||||
---|---|---|---|---|
|
With In Magnolia 5.7 we have removed a few modules that were not bundled but which were added as add-onsremoved several add-on modules (not bundled). We recommend you remove them too.
Here This is the list of the removed add-on modules removed:
- 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
...
WebDAV
You must remove the magnolia-module-webdav
...
module because Apache Jackrabbit 2.16
...
no longer supports WebDAV.
...
Check the magnolia.properties
file
...
Between Magnolia 5.6.6 and Magnolia 5.7
...
, the magnolia.properties
file has not changed.
Tip |
---|
When upgrading Magnolia - its , it is always worth to compare comparing your |
...
Todo |
---|
|
...
|
Below find are the latest versions of the magnolia.properties
files of for the Magnolia 5.7 series:
Artifact resource link | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
*) Magnolia CE and Magnolia EE Standard are using use the same magnolia.properties
file.
...
Code Pro | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
Apache Tomcat 9.0.8
If you are using use Apache Tomcat - : we have upgraded to Apache Tomcat 9.0.8.
In case If you are using use another servlet container - have a look at the Certified stack.
...
, check the certified stack for supported versions.
Anchor | ||||
---|---|---|---|---|
|
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 are migrating from Magnolia 5.5.x or even lower, please read the instructions for upgrading to upgrade to Magnolia 5.6.x concerning for custom modules and the widget set toowidgetset.
- 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
...
Include Page | ||||
---|---|---|---|---|
|
...
Other third-party libraries
- commons-lang3-3.7
- freemarker-2.3.25-incubating
- 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 the latest minor release version first before upgrade upgrading to the most recent major release.
A June 2018 example: a customer is considering an upgrade from 5.5.8 to 5.7. The correct upgrade sequence would beis: 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 we recommend you minimize the risk by cleaning up your system, removing unused data, reindexing everything and doing a full backup first.
...
- 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.
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 may have previously added.
We have removed a few modules from the several add-ons. Some of them you must remove. See Removing on modules. You must also remove some. See Remove outdated add-on modules. - Add new introduced modules - see Adding Magnolia modules. See Add 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 customized your
magnolia.properties
files, compare the changes to the file in the new bundle. Properties may have been added and or removed. - Read Read the release notes for all intermediary intermediate versions for any additional update tasks.
- Restart the application server.
- Using In your browser, go to the Magnolia instances and run the Web web update.
Updating Maven managed webapps
On In this section we assume that you use Maven to manage your (custom) webapp. How you do this depends on how you have organized your pom files.
...
The most typical use case is , that your custom webapp is based on one of Magnolias preconfigured webapps. The structure of the Maven project which is managing that manages your webapp could may look like this:
Code Pro | ||
---|---|---|
| ||
custom-ee/ ├── custom-ee-webapp │ ├── pom.xml │ └── src └── pom.xml |
...
Line 5: custom-ee/pom.xml
is the " parent pom file " of your custom webapp - this file is managing . This file manages the dependencies and its their versions.
Expand | |||||||||
---|---|---|---|---|---|---|---|---|---|
| |||||||||
|
Note that the " parent pom " (custom-ee/pom.xml) is managing manages all versions for Magnolia modules as well as for 3rdthird-party libraries.
It
...
imports info.magnolia.eebundle:magnolia-enterprise-bundle-parent
...
, which manages Magnolia Enterprise
...
module versions and imports the following:
info.magnolia.bundle:magnolia-bundle-parent
(which manages the versions of the - manages Magnolia CE modules) and module versions.info.magnolia.boms:magnolia-external-dependencies
(which manages the versions of the 3rd-party libraries) - manages third-party library versions.
If the pom files for your custom webapp are organized as shown in this example - , you must only need to change only one property. In the <properties>
section of your parent pom, change the version of the magnoliaBundleVersion
property:
...
Line 2: Set the magnoliaBundleVersion
to your required version. That 's is all you must need to change on in the pom files of your webapp.
Checking the Maven dependency tree
Whether Regardless of how your Maven project is shown as above or whether it is done in a different way, in any case:
...
organized, building the Maven dependency tree helps you
...
analyze the versions of all the Magnolia modules and all
...
the third-party libraries of your custom webapp.
Open a shell, go to the directory of your webapp and execute the Maven command for the dependency tree.:
Code Block |
---|
cd /Users/jdoe/dev/repo/custom-mgnl-webapps/custom-ee/custom-ee-webapp mvn dependency:tree |
...
If you encounter problems, please check check the Known issues page first.