This page has moved to Adobe Experience League and will be redirected soon.
MySQL catalog search engine will be removed in Adobe Commerce 2.4.0
MySQL catalog search engine will be removed in Adobe Commerce 2.4.0
Adobe Commerce on-premises, Adobe Commerce on cloud infrastructure, and Magento Open Source 2.4.0 will be released in the coming months. For Adobe 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 Adobe 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 Adobe Commerce. Please note that service upgrades on Adobe 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:
- Adobe 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 End of Life and has been deprecated in Adobe 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 Adobe Commerce 2.4.0. |
Third-party extension |
You are not required to install Elasticsearch. Adobe Commerce recommends that you contact your search engine vendor to determine whether your extension is fully compatible with Adobe Commerce 2.4.0. |
Installation:
When Adobe 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, Adobe 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 Adobe 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.