You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Nov 19, 2024. It is now read-only.
Copy file name to clipboardExpand all lines: src/_includes/layout/page-header.html
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -21,7 +21,7 @@
21
21
22
22
{% if page.url contains "guides/v2.4/comp-mgr/" %}
23
23
<divclass="message-banner">
24
-
You must install and configure Elasticsearch 6.x or 7.x before upgrading to {{ site.data.var.ee }} or {{ site.data.var.ce }} 2.4.0. See <ahref="{{ page.baseurl }}/comp-mgr/prereq/prereq-elasticsearch.html">Check the catalog search engine</a> for details.
24
+
You must install and configure Elasticsearch 7.6.x before upgrading to {{ site.data.var.ee }} or {{ site.data.var.ce }} 2.4.0. See <ahref="{{ page.baseurl }}/comp-mgr/prereq/prereq-elasticsearch.html">Check the catalog search engine</a> for details.
Copy file name to clipboardExpand all lines: src/guides/v2.4/comp-mgr/prereq/prereq-elasticsearch.md
+11-25Lines changed: 11 additions & 25 deletions
Original file line number
Diff line number
Diff line change
@@ -9,47 +9,33 @@ Before you upgrade from Magento 2.3.x to Magento 2.4, you must check whether you
9
9
10
10
You can use the CLI or the Admin to determine your catalog search engine:
11
11
12
-
* Enter the `bin/magento config:show catalog/search/engine` command. The command returns a value of `mysql`, `elasticsearch` (which indicates Elasticsearch 2 is configured), `elasticsearch5`, `elasticsearch6`, `elasticsearch7`, or a custom value, indicating you have installed a third-party search engine.
12
+
- Enter the `bin/magento config:show catalog/search/engine` command. The command returns a value of `mysql`, `elasticsearch` (which indicates Elasticsearch 2 is configured), `elasticsearch5`, `elasticsearch6`, `elasticsearch7`, or a custom value, indicating you have installed a third-party search engine.
13
13
14
-
* From the Admin, check the value of the **Stores** > Settings > **Configuration** > **Catalog** > **Catalog** > **Catalog Search** > **Search Engine** field.
14
+
- From the Admin, check the value of the **Stores** > Settings > **Configuration** > **Catalog** > **Catalog** > **Catalog Search** > **Search Engine** field.
15
15
16
-
The following sections describe what actions you must take before upgrading to Magento 2.4.
16
+
The following sections describe what actions you must take before upgrading to Magento 2.4.0.
17
17
18
18
## MySQL
19
19
20
-
Magento 2.4 does not support MySQL as a catalog search engine. You must install and configure Elasticsearch 7.x or 6.x before upgrading. Use the following resources to help guide you through this process:
20
+
Magento 2.4 does not support MySQL as a catalog search engine. You must install and configure Elasticsearch 7.6.x before upgrading. Use the following resources to help guide you through this process:
21
21
22
-
*[Install and configure Elasticsearch]({{site.baseurl}}/guides/v2.3/config-guide/elasticsearch/es-overview.html)
* Configure Elasticsearch to work with [nginx]({{site.baseurl}}/guides/v2.3/config-guide/elasticsearch/es-config-nginx.html) or [Apache]({{site.baseurl}}/guides/v2.3/config-guide/elasticsearch/es-config-apache.html)
25
-
*[Configure Magento to use Elasticsearch]({{site.baseurl}}/guides/v2.3/config-guide/elasticsearch/configure-magento.html) and reindex
22
+
-[Install and configure Elasticsearch]({{ page.baseurl }}/config-guide/elasticsearch/es-overview.html)
- Configure Elasticsearch to work with [nginx]({{ page.baseurl}}/config-guide/elasticsearch/es-config-nginx.html) or [Apache]({{ page.baseurl }}/config-guide/elasticsearch/es-config-apache.html)
25
+
-[Configure Magento to use Elasticsearch]({{ page.baseurl }}/config-guide/elasticsearch/configure-magento.html) and reindex
26
26
27
27
Some third-party catalog search engines run on top of Magento's search engine. Contact your vendor to determine whether you need to update your extension.
28
28
29
-
## Elasticsearch 2
29
+
## Elasticsearch
30
30
31
-
Magento does not support Elasticsearch 2. You must update to a more recent version. Elasticsearch 7 is recommended.
31
+
You must install and configure Elasticsearch 7.6.x before upgrading to Magento 2.4.0. Magento does not support Elasticsearch 2.x, 5.x, and 6.x.
32
32
33
33
Refer to [Upgrading Elasticsearch](https://www.elastic.co/guide/en/elasticsearch/reference/current/setup-upgrade.html) 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.
34
34
35
35
{:.bs-callout-info}
36
36
Elasticsearch requires JDK 1.8 or higher. See [Install the Java Software Development Kit (JDK)]({{page.baseurl}}/install-gde/prereq/elasticsearch.html#prereq-java) to check which version of JDK is installed.
37
37
38
-
[Configure Magento to use Elasticsearch]({{site.baseurl}}/guides/v2.3/config-guide/elasticsearch/configure-magento.html) describes the tasks you must perform after updating Elasticsearch 2 to a supported version.
39
-
40
-
## Elasticsearch 5
41
-
42
-
Elasticsearch 5 has reached its [End of Life](https://www.elastic.co/support/eol), and Magento support for Elasticsearch 5 has been deprecated.
43
-
44
-
Although you can upgrade to Magento 2.4 without updating Elasticsearch 5, Magento recommends that you update to Elasticsearch 7.
45
-
46
-
Refer to [Upgrading Elasticsearch](https://www.elastic.co/guide/en/elasticsearch/reference/current/setup-upgrade.html) 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.
47
-
48
-
[Configure Magento to use Elasticsearch]({{site.baseurl}}/guides/v2.3/config-guide/elasticsearch/configure-magento.html) describes the tasks you must perform after updating Elasticsearch 5.
49
-
50
-
## Elasticsearch 6 or 7
51
-
52
-
If you are using Elasticsearch 6 or 7 as your catalog search engine, you are not required to perform any additional steps before upgrading to Magento 2.4.
38
+
[Configure Magento to use Elasticsearch]({{ page.baseurl }}/config-guide/elasticsearch/configure-magento.html) describes the tasks you must perform after updating Elasticsearch 2 to a supported version.
Copy file name to clipboardExpand all lines: src/guides/v2.4/config-guide/elasticsearch/es-overview.md
+1-5Lines changed: 1 addition & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -8,18 +8,16 @@ functional_areas:
8
8
- Setup
9
9
---
10
10
11
-
As of version 2.4.0, Magento requires [Elasticsearch][] to be the catalog search engine. Refer to the following topics for details about installing Elasticsearch and initial configuration:
11
+
As of version 2.4, Magento requires [Elasticsearch][] to be the catalog search engine. Refer to the following topics for details about installing Elasticsearch and initial configuration:
12
12
13
13
*[Elasticsearch prerequisites][]
14
14
*[Configure nginx and Elasticsearch][]
15
15
*[Configure Apache and Elasticsearch][]
16
-
*[Setup Wizard installation][]
17
16
*[Install the Magento software][] (command line interface)
18
17
19
18
After you install and integrate Elasticsearch with Magento, you might need to perform additional maintenance:
20
19
21
20
*[Configure Elasticsearch stopwords][]
22
-
*[Change the Elasticsearch Client][]
23
21
*[Configure Magento to use Elasticsearch][]
24
22
25
23
## Additional resources {#es-resources}
@@ -34,6 +32,4 @@ For additional information, see the [Elasticsearch documentation][]
34
32
[Elasticsearch]: https://www.elastic.co
35
33
[Configure Magento to use Elasticsearch]: {{page.baseurl}}/config-guide/elasticsearch/configure-magento.html
Copy file name to clipboardExpand all lines: src/guides/v2.4/install-gde/system-requirements-tech.md
+4-11Lines changed: 4 additions & 11 deletions
Original file line number
Diff line number
Diff line change
@@ -77,16 +77,10 @@ For more information, see [Required PHP settings][].
77
77
78
78
## Elasticsearch
79
79
80
-
*As of Magento 2.4.0, MySQL is no longer used for search. You must use [Elasticsearch]({{page.baseurl}}/install-gde/prereq/elasticsearch.html). The following Elasticsearch versions are supported:
80
+
As of Magento 2.4.0, MySQL is no longer used for search. You must use [Elasticsearch]({{page.baseurl}}/install-gde/prereq/elasticsearch.html). Magento supports Elasticsearch 7.6.x.
81
81
82
-
* Elasticsearch 7.x
83
-
84
-
* Elasticsearch 6.x (6.8 or higher is recommended)
85
-
86
-
{:.bs-callout-warning}
87
-
Magento no longer provides support for Elasticsearch [2.x and 5.x][] as they are End of Life.
88
-
89
-
Follow the instructions in [Change Elasticsearch Module][].
82
+
{:.bs-callout-warning}
83
+
Magento no longer supports Elasticsearch [2.x, 5.x, and 6.x][].
90
84
91
85
## SSL
92
86
@@ -153,7 +147,6 @@ There is a known issue with `xdebug` that can affect Magento installations or ac
Copy file name to clipboardExpand all lines: src/guides/v2.4/release-notes/backward-incompatible-changes/index.md
+4-15Lines changed: 4 additions & 15 deletions
Original file line number
Diff line number
Diff line change
@@ -9,26 +9,15 @@ This page highlights backward incompatible changes between releases that have a
9
9
10
10
### Elasticsearch
11
11
12
-
In Magento 2.4.0, we removed support for two deprecated catalog search engines:
12
+
MySQL is no longer used for search. You must use [Elasticsearch]({{page.baseurl}}/install-gde/prereq/elasticsearch.html).
13
13
14
-
- MySQL
15
-
- Elasticsearch 2.x
14
+
You must [install and configure]{{ page.baseurl }}/install-gde/prereq/elasticsearch.html) Elasticsearch 7.6.x before upgrading to Magento 2.4.0. New installations require a connection to Elasticsearch to complete.
16
15
17
-
Merchants must [install and configure]{{ page.baseurl }}/install-gde/prereq/elasticsearch.html) a supported version of Elasticsearch before they upgrade to Magento 2.4.0. New installations require a connection to Elasticsearch to complete.
18
-
19
-
{:.bs-calllout-warning}
20
-
If you attempt to upgrade Magento before installing and configuring a supported search engine, Magento could go into an inconsistent state and the Admin will become inaccessible.
21
-
22
-
The following Elasticsearch versions are supported:
23
-
24
-
- Elasticsearch 7.x
25
-
- Elasticsearch 6.x (6.8 or higher is recommended)
16
+
{:.bs-callout-warning}
17
+
Magento does not support Elasticsearch 2.x, 5.x, and 6.x. If you attempt to upgrade Magento before installing and configuring a supported search engine, Magento could go into an inconsistent state and the Admin will become inaccessible.
26
18
27
19
Extension developers must update any module that depends on the unsupported search engines.
28
20
29
-
{:.bs-callout-warning}
30
-
Magento no longer provides support for Elasticsearch [2.x and 5.x](https://www.elastic.co/support/eol) as they are End of Life. If you are using ES2, follow the instructions in [Change Elasticsearch Module]({{ page.baseurl }}/config-guide/elasticsearch/es-downgrade.html) before upgrading.
31
-
32
21
The changes with removing values from the `system.xml` file require eliminating ES2 support from the Admin UI. Other API classes were removed to clean up the code when we deprecated ES2 and ES5 in Magento 2.3.5.
33
22
34
23
The following modules have been refactored to use the `ElasticSearchResultApplier` class and avoid usage of `CatalogSearch` and `SearchResultApplier`, which was based on MySQL:
0 commit comments