Page History

...

• Update to the latest minor release version first before 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 is: 5.5.8 → 

  Artifact resource link
  rangeHigherVersion 5.6 groupId info.magnolia.bundle artifactId magnolia-bundle-parent label $version renderType display_only resourceType POM

   → 

  Artifact resource link
  rangeHigherVersion 5.7 groupId info.magnolia.bundle artifactId magnolia-bundle-parent label $version renderType display_only resourceType POM

   → 5.7

• Update all external libraries required by the Magnolia release to which you intend to upgrade.
• Because the upgrade process takes time and is vulnerable to incidents, we recommend you minimize the risk by cleaning up your system, removing unused data, reindexing everything and doing a full backup first.

Updating manually

1. Stop the application server.
2. Extract the new Magnolia bundle.
3. 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.
4. Remove any module JARs you had previously removed from your instances. Add any modules you may have previously added.
    We have removed several add-on modules. You must also remove some. See Remove outdated add-on modules.
5. Add new Magnolia modules. See Add the privacy modules.
6. Optional: Delete all indexes to give them a 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.
7. If you customized your magnolia.properties files, compare the changes to the file in the new bundle. Properties may have been added or removed.
8. Read the release notes for all intermediate versions for any additional update tasks.
9. Restart the application server.
10. In your browser, go to the Magnolia instances and run the web update.

...

1. .

Updating Maven managed webapps

...