Installation & Integration
Migration from v2.x/v3.x

Installation

6min

Please ensure you have read the installation and integration guides before beginning the process. Upgrading from v2.x/v3.x requires manual steps to be taken by Klevu support to upgrade your account from XML indexing to JSON indexing.

Contact support to check if your account can be upgraded from XML indexing to JSON indexing.

It is not possible to install v2.x/v3.x and v4.x at the same time. Any attempt to install v4.x while v2.x/v3.x is installed will fail and display a warning message. i.e. running composer require klevu/module-m2-search before running composer remove "klevu/*" will fail.

In line with Magento's best practice, we recommend taking a backup of your database and enabling maintenance mode before making any changes to your Magento site.

All changes should be tested in a non-production environment first.

Read this guide before you begin this process

Step 1 - Remove v2.x/v3.x

Remove all previous Klevu modules via composer.

Shell


Step 2 - Add v4.x packages

Add the module via composer.

Shell


Step 3 - Update Magento

Enable modules, update the database, compile code, generate static content and clear caches.

Shell