Magento Commerce, Magento Commerce Cloud, and Magento Open Source 2.4.0 will be released in the coming months. For Magento Commerce 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 Magento Commerce Cloud, Elasticsearch is already required.
Failing to install/configure Elasticsearch 6/7 before trying to upgrade could cause serious problems with Magento. Please note that service upgrades on Magento Cloud 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 Elasticsearch provides superior search capabilities as well as catalog performance optimizations.
Affected products and versions:
- Magento Commerce v2.4.0
- Magento Open Source v2.4.0
Upgrading:
Search engine | Action |
MySQL | You must install Elasticsearch. See DevDocs Install and configure Elasticsearch. |
Elasticsearch (with no version listed) | You are using Elasticsearch 2 and must update to Elasticsearch 7 (preferred) or 6. See DevDocs Upgrading Elasticsearch and Configure Magento to use Elasticsearch for details. |
Elasticsearch 5 | Elasticsearch 5 has reached its End of Life and has been deprecated in Magento 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 Magento 2.4.0. |
Third-party extension | You are not required to install Elasticsearch. Magento recommends that you contact your search engine vendor to determine whether your extension is fully compatible with Magento 2.4.0. |
Installation:
When Magento Commerce 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. Refer to DevDocs Install and configure Elasticsearch.
By default, Magento 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 Magento 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.