ÃÛ¶¹ÊÓƵ

DocumentationCommerceCommerce KB

MySQL catalog search engine will be removed in ÃÛ¶¹ÊÓƵ Commerce 2.4.0

Last update: Wed Nov 06 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Admin

ÃÛ¶¹ÊÓƵ Commerce on-premises, ÃÛ¶¹ÊÓƵ Commerce on cloud infrastructure, and Magento Open Source 2.4.0 will be released in the coming months. For ÃÛ¶¹ÊÓƵ Commerce on-premises and Magento Open Source version 2.4.0 Elasticsearch 6.x or 7.x will be a required component, and MySQL search engine will be removed. In ÃÛ¶¹ÊÓƵ Commerce on cloud infrastructure, Elasticsearch is already required.

WARNING
Failing to install/configure Elasticsearch 6/7 before trying to upgrade could cause serious problems with ÃÛ¶¹ÊÓƵ Commerce. Please note that service upgrades on ÃÛ¶¹ÊÓƵ Commerce on cloud infrastructure cannot be pushed to the production environment without 48 business hours’ notice to our infrastructure team. This is required as we need to ensure that we have an infrastructure support engineer available to update your configuration within a desired timeframe with minimal downtime to your production environment. So 48 hours prior to when your changes need to be on production submit a support ticket detailing your required service upgrade and stating the time when you want the upgrade process to start.

The reason for the removal of MySQL search engine is that Elasticsearch provides superior search capabilities as well as catalog performance optimizations.

Affected products and versions:

  • ÃÛ¶¹ÊÓƵ Commerce on-premises v2.4.0
  • Magento Open Source v2.4.0

Upgrading:

Search engine
Action
MySQL
You must install Elasticsearch. See Install and configure Elasticsearch in our developer documentation.
Elasticsearch (with no version listed)
You are using Elasticsearch 2 and must update to Elasticsearch 7 (preferred) or 6. See Upgrading Elasticsearch and Configure Commerce to use Elasticsearch in our developer documentation for details.
Elasticsearch 5
Elasticsearch 5 has reached its and has been deprecated in ÃÛ¶¹ÊÓƵ Commerce 2.4.0. Update to Elasticsearch 7 (preferred) or 6.
Elasticsearch 6 or 7
You are not required to perform any additional steps before upgrading to ÃÛ¶¹ÊÓƵ Commerce 2.4.0.
Third-party extension
You are not required to install Elasticsearch. ÃÛ¶¹ÊÓƵ Commerce recommends that you contact your search engine vendor to determine whether your extension is fully compatible with ÃÛ¶¹ÊÓƵ Commerce 2.4.0.

Installation:

When ÃÛ¶¹ÊÓƵ Commerce on-premises and Magento Open Source 2.4.0 is released, Elasticsearch will be a required component, so you must have an Elasticsearch host setup and configured prior to installing version 2.4.0. See Install and configure Elasticsearch in our developer documentation.

By default, ÃÛ¶¹ÊÓƵ Commerce search will use Elasticsearch 7 as the search engine and attempt to connect to a server at localhost:9200. Elasticsearch 6.x is also supported. If your configuration does not match the defaults, you can configure these settings using arguments passed to setup:install, in much the same way the database connection is configured.

For example, setup:install --elasticsearch-host=es.mystore.com

During installation the Elasticsearch connection will be checked, and installation will fail if ÃÛ¶¹ÊÓƵ Commerce is unable to connect to an Elasticsearch host. If this occurs, check that your Elasticsearch is up and running, and that you have supplied the correct connection parameters.

recommendation-more-help
8bd06ef0-b3d5-4137-b74e-d7b00485808a