[james-project] 03/03: JAMES-3771 Add upgrade instructions for elasticsearch migration to Opensearch

[rc...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

rcordier pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/james-project.git

commit a78fed6d3a3f79e34c6b8f6b14c2486419b77b2d
Author: Rene Cordier <rc...@linagora.com>
AuthorDate: Mon Aug 1 15:26:53 2022 +0700

    JAMES-3771 Add upgrade instructions for elasticsearch migration to Opensearch
---
 upgrade-instructions.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/upgrade-instructions.md b/upgrade-instructions.md
index 1e02f2f8b3..cceef7ae3b 100644
--- a/upgrade-instructions.md
+++ b/upgrade-instructions.md
@@ -18,6 +18,25 @@ Change list:
 
 - [Adding authorized_users column to user table](#adding-authorized_users-column-to-user-table)
 - [Migration to Cassandra driver 4](#migration-to-cassandra-driver-4)
+- [Migration to OpenSearch](#migration-to-opensearch)
+
+### Migration to OpenSearch
+
+Date: 01/08/2022
+
+Concerned products: Distributed James, Cassandra James
+
+ElasticSearch v7 being EOL and upper versions being moved to a non-OSI compliant license (java clients included),
+it's been decided to migrate to OpenSearch that is a fork of ElasticSearch 7.10 and using Apache v2 license.
+
+You should migrate your ElasticSearch servers from version 7 to OpenSearch 2.1 before upgrading James.
+
+Users can either perform a migration of their data from version 7 to OpenSearch (documentation
+[here](https://opensearch.org/docs/latest/upgrade-to/upgrade-to/)) or might start from an empty
+Opensearch v2.1 cluster and [reindex data](https://github.com/apache/james-project/blob/master/src/site/markdown/server/manage-webadmin.md#reindexing-all-mails).
+
+Keep in mind as well that the group listeners related to ElasticSearch changed names.
+You would need to manually delete the bindings from the event queues in RabbitMQ before restarting James.
 
 ### Migration to Cassandra driver 4
 


---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@james.apache.org
For additional commands, e-mail: notifications-help@james.apache.org