Important

You are browsing documentation for version 5.1 of OroCommerce, supported until March 2026. Read the documentation for version 6.0 (the latest LTS version) to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Upgrade Website Index to Elasticsearch >=8.4, <9.0 

You have only one option to perform the upgrade: via full reindexation.

Keep in mind that the previous OroCommerce versions (5.0 and below) have different structure for flat object fields, so full indexation is required in order to fill the data in the correct format.

Full Reindexation 

This option is suitable for upgrades from all previous versions.

Search index upgrade is part of the application upgrade. So, once you have turned on maintenance mode through app/console lexik:maintenance:lock --env=prod, you need to perform the following actions:

  1. Stop old Elasticsearch

  2. Modify credentials for search engine configuration in the corresponding environment variables

  3. Start the Elasticsearch 8.* service.

Proceed with the standard upgrade procedure.

Note 

If you are skipping search indexation during the upgrade or keeping all the indices during the Elasticsearch upgrade then you have to recreate indices and trigger full indexation manually:

php bin/console oro:website-elasticsearch:create-website-indexes --env=prod
php bin/console oro:website-search:reindex --env=prod --scheduled

Hint

See the Indexation process documentation for more details on synchronous and asynchronous (scheduled) indexation.