Skip to main content
Version: 2024.4

Special Aspects for OpenSearch

Basically OpenSearch worker works as described in the optimized architecture.

Installation

OpenSearch

To work properly Pimcore requires the OpenSearch client, install them with: composer require pimcore/opensearch-client.

Index Configuration

OpenSearch provides a couple of additional configuration options for the index to utilize OpenSearch features. See Configuration Details for more information.

Reindexing Mode

It is possible that OpenSearch cannot update the mapping, e.g. if data types of attributes change on the fly. For this case, a reindex is necessary. If it is necessary, a native ES reindex is executed automatically during bin/console ecommerce:indexservice:bootstrap --create-or-update-index-structure.

While reindex is executed, no updates are written to the OpenSearch index. The changes remain in store table and are transferred to index during next execution of bin/console ecommerce:indexservice:process-update-queue after reindex is finished.

All queries that take place during reindex go to the old index. As soon the reindex is finished, the current index is switched to the newly created index and the old index is deleted.
As a result, during reindex the results delivered by Product Lists can contain old data.

To manually start a reindex, following command can be used: bin/console ecommerce:indexservice:search-index-sync reindex.

Indexing of Classification Store Attributes

With OpenSearch it is possible to index all attributes of Classification Store data without defining an attribute for each single classification store key.

For details see Filter Classification Store in Filter Service documentation.

Synonyms

Pimcore provides an out-of-the box integration for synonyms in OpenSearch. See Synonyms for details.