Upgrade to Bloomreach Experience Manager 14

This section contains documentation to guide you in upgrading your project from Bloomreach Experience Manager 13 to Bloomreach Experience Manager 14.

Bloomreach Experience Manager applies Semantic Versioning for its releases, which implies that backwards incompatible changes can be made between major versions. Such changes force you to apply a number of changes to your Bloomreach Experience Manager product, which are described in this section of the documentation.

Because the upgrade to v14 requires some impactful changes as result of the major overhaul of the security model and configuration, you must first read the general introduction to Bloomreach Experience Manager upgrades, and especially follow the described general upgrade process precisely. Please do not try to skip or shortcut any of these steps!

Next, please study the page listing the relevant changes between version 13 and 14, providing information on the rationale behind the changes. We expect that understanding this background will help you comprehend and apply the necessary changes successfully. Then, you should be ready to actualy start upgrading your project, following the described steps needed for upgrading to v14.

Also note that the step Prepare Bloomreach Experience Manager v13 Project for Upgrade to v14, can (and best should) be done as prerequisite before following the general instructions and process.

For upgrading to version 14, by far the most invasive changes are the result of the Security Configuration overhaul. A description and rationale of this can be found at Security Configuration Overhaul.