Current search engine not supported
The following error message indicates that the Adobe Commerce version you are upgrading from is configured to use a catalog search engine that is not supported in the version you are upgrading to:
Your current search engine, <Engine Name>, is not supported. You must install a supported search engine before upgrading. See the System Upgrade Guide for more information.
This error means one of the following conditions is true on the down-level version of Adobe Commerce:
- The search engine is set to MySQL.
- The search engine is set to a version of Elasticsearch that is no longer supported.
Use the following command to check the current search engine:
bin/magento config:show catalog/search/engine
The error occurs if the returned value is mysql, elasticsearch, or elasticsearch6.
| code language-bash |
|---|
|
| code language-bash |
|---|
|
<version> is the version of Magento you were running before the upgrade. For example, 2.3.5.Follow the guidelines described in the following sections to recover from an inconsistent state.
If your search engine is mysql
Before 2.4, MySQL was the default catalog search engine, but MySQL is no longer supported in this capacity. Now, you must install and configure Elasticsearch or OpenSearch as your search engine before upgrading to 2.4.
Use the following resources to help guide you through this process:
After you configure the search engine and reindex, you are ready to upgrade to 2.4.
If your search engine is elasticsearch
Elasticsearch 6 and earlier are no longer supported.
A value of elasticsearch indicates your down-level version of Adobe Commerce is configured to use Elasticsearch 2.x. This version of Elasticsearch is no longer supported.
You must perform the following tasks before upgrading to 2.4:
-
Update to a version of Elasticsearch that is supported by Commerce. Refer to Upgrading Elasticsearch for full instructions on backing up your data, detecting potential migration issues, and testing upgrades before deploying to production. Depending on your current version of Elasticsearch, a full cluster restart may or may not be required.
note note NOTE Elasticsearch requires JDK 1.8 or higher. See Install the Java Software Development Kit (JDK) to check which version of JDK is installed. -
Configure Elasticsearch and reindex.
After you configure the search engine and reindex, you are ready to upgrade to 2.4.