Skip to content

Commit bb6b019

Browse files
committed
docs: draft ES8 install troubleshooting
1 parent e5beffa commit bb6b019

File tree

1 file changed

+26
-0
lines changed

1 file changed

+26
-0
lines changed

help/upgrade/prepare/prerequisites.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -88,6 +88,10 @@ OpenSearch requires JDK 1.8 or higher. See [Install the Java Software Developmen
8888

8989
Support for Elasticsearch 8.x was introduced in Adobe Commerce 2.4.6. The following instructions show an example of upgrading Elasticsearch from 7.x to 8.x:
9090

91+
>[!NOTE]
92+
>
93+
>In the upcoming 2.4.8 release, these steps won't be necessary because the Elasticsearch 8 module is included by default and you won't need to install it separately.
94+
9195
1. Upgrade the Elasticsearch 7.x server to 8.x and make sure that is is up and running. See the [Elasticsearch documentation](https://www.elastic.co/guide/en/elasticsearch/reference/current/install-elasticsearch.html).
9296

9397
1. Enable the `id_field_data` field by adding the following configuration to your `elasticsearch.yml` file and restarting the Elasticsearch 8.x service.
@@ -108,6 +112,28 @@ Support for Elasticsearch 8.x was introduced in Adobe Commerce 2.4.6. The follow
108112
composer require magento/module-elasticsearch-8 --update-with-all-dependencies
109113
```
110114

115+
If you encounter a dependency error for `psr/http-message`, click to expand the following troubleshooting section:
116+
117+
+++Troubleshooting
118+
119+
If you encounter dependency conflicts while installing Elasticsearch 8, particularly with `psr/http-message`, you can resolve this by following these steps:
120+
121+
1. First, require the Elasticsearch 8 module without updating other dependencies:
122+
123+
```bash
124+
composer require magento/module-elasticsearch-8 --no-update
125+
```
126+
127+
1. Then update the Elasticsearch 8 module and aws/aws-sdk-php packages:
128+
129+
```bash
130+
composer update magento/module-elasticsearch-8 aws/aws-sdk-php -W
131+
```
132+
133+
This approach works for 2.4.7-p4 with PHP 8.3. The issue occurs because `aws/aws-sdk-php` requires `psr/http-message >= 2.0`, which can cause conflicts. The above steps help resolve these dependency issues.
134+
135+
+++
136+
111137
1. Update your project components.
112138

113139
```bash

0 commit comments

Comments
 (0)