DocumentationCommerceUpgrade Guide

Migrating to OpenSearch

Last update: Thu Jun 15 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Experienced
  • Admin
  • Developer

OpenSearch is an open source fork of Elasticsearch 7.10.2 that was created after Elasticsearch’s licensing change.

As of 2.4.4, 2.4.3-p2, and 2.3.7-p3, Adobe Commerce and Magento Open Source support OpenSearch. On-premises installations continue to support Elasticsearch, although it is no longer supported for Adobe Commerce on cloud infrastructure. Starting with version 2.4.6 OpenSearch has its own module and fields in the Admin configuration settings.

Migration path

The steps to migrate to OpenSearch are simple and largely follow the steps for Elasticsearch configuration. These steps assume that Adobe Commerce is the only application using the search engine. In cases where multiple applications use the search engine, follow the official migration guide Moving from open source Elasticsearch to OpenSearch.

  1. Ensure that your installation meets the search engine prerequisites.

  2. Place the site in Maintenance Mode.

  3. Optionally uninstall Elasticsearch.

  4. Install OpenSearch.

  5. Configure the search engine and perform related tasks, such as flushing the cache and reindexing the catalog search index.

No further configuration value changes are necessary.

83a60e0e-8849-4685-a8cd-c129ecd795ea