Upgrading to jExperience 2.2.1
Note: If you are currently using jExperience 2.2.0.x1, it is recommended to upgrade to jExperience 2.5.0 (or above) directly.
Before upgrading jExperience or jCustomer, please make sure to review this page on the Academy containing upgrade recommendations.
Install jExperience 2.2.1 module and start it.
Get jExperience from the the Jahia store and install it from the administration / Modules and extensions panel.
Or download and install the new version directly from the Modules and extensions panel if the store is available.
jExperience-2.2.1 requires Jahia 220.127.116.11+ and jCustomer 1.5.6+.
In case you are updating from jExperience 2.1.x, 2.0.x or 1.12.x (1.12.0-1.12.3) please ensure you are using jCustomer 1.5.6+. The instructions to upgrade jCustomer are provided under "Upgrading to jCustomer 1.5.6". If you are already using jCustomer 1.5.6+, you just need to execute the following steps:
- Upload and start jExperience 2.2.1 module as you would do for any other module.
- Remove all previous jExperience versions
Starting with Jahia 18.104.22.168, Jahia is checking if upgrading the module introduces changes in its definition. If such changes are detected, the default Jahia behavior will be to reject a module upgrade.
jExperience comes with its own migration mechanism to handle changes in definitions, when updating jExperience via Jahia's module manager, it is therefore safe to ignore definition checks via the UI, unselecting "Validate module definitions", or via the API using the "ignoreChecks" boolean.