51ºÚÁϲ»´òìÈ

DocumentationCommerceCommerce KB

MySQL catalog search engine will be removed in 51ºÚÁϲ»´òìÈ Commerce 2.4.0

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

CREATED FOR:

  • Admin

51ºÚÁϲ»´òìÈ Commerce on-premises, 51ºÚÁϲ»´òìÈ Commerce on cloud infrastructure, and Magento Open Source 2.4.0 will be released in the coming months. For 51ºÚÁϲ»´òìÈ 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 51ºÚÁϲ»´òìÈ 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 51ºÚÁϲ»´òìÈ Commerce. Please note that service upgrades on 51ºÚÁϲ»´òìÈ 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:

  • 51ºÚÁϲ»´òìÈ 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 51ºÚÁϲ»´òìÈ 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 51ºÚÁϲ»´òìÈ Commerce 2.4.0.
Third-party extension
You are not required to install Elasticsearch. 51ºÚÁϲ»´òìÈ Commerce recommends that you contact your search engine vendor to determine whether your extension is fully compatible with 51ºÚÁϲ»´òìÈ Commerce 2.4.0.

Installation:

When 51ºÚÁϲ»´òìÈ 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, 51ºÚÁϲ»´òìÈ 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 51ºÚÁϲ»´òìÈ 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