Important

You are browsing upcoming documentation for version 5.1 of OroCommerce, OroCRM, and OroPlatform, scheduled for release in March 2023. Read version 5.0 (the latest LTS version) of the Oro documentation 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