This is an automated email from the ASF dual-hosted git repository.
shuber pushed a commit to branch opensearch-persistence
in repository https://gitbox.apache.org/repos/asf/unomi.git
The following commit(s) were added to refs/heads/opensearch-persistence by this
push:
new 591dd9d92 - Remove Claude config file - Update documentation to
indicate support for OpenSearch 3 instead of 2
591dd9d92 is described below
commit 591dd9d92535ad4e3417ebca18d6b09426552b08
Author: Serge Huber <[email protected]>
AuthorDate: Mon Oct 13 17:31:20 2025 +0200
- Remove Claude config file
- Update documentation to indicate support for OpenSearch 3 instead of 2
---
.claude/settings.local.json | 19 -------------------
manual/src/main/asciidoc/5-min-quickstart.adoc | 4 ++--
manual/src/main/asciidoc/building-and-deploying.adoc | 2 +-
manual/src/main/asciidoc/configuration.adoc | 11 +++++------
manual/src/main/asciidoc/getting-started.adoc | 2 +-
manual/src/main/asciidoc/whats-new.adoc | 4 ++--
manual/src/main/asciidoc/writing-plugins.adoc | 2 +-
7 files changed, 12 insertions(+), 32 deletions(-)
diff --git a/.claude/settings.local.json b/.claude/settings.local.json
deleted file mode 100644
index 53f18984e..000000000
--- a/.claude/settings.local.json
+++ /dev/null
@@ -1,19 +0,0 @@
-{
- "permissions": {
- "allow": [
- "Bash(chmod:*)",
- "Read(//private/tmp/unomi-3-dev-analysis/**)",
- "Read(//tmp/unomi-3-dev-analysis/persistence-opensearch/core/**)",
- "Read(//tmp/unomi-3-dev-analysis/**)",
- "Bash(find:*)",
- "Bash(grep:*)",
- "WebFetch(domain:unomi.apache.org)",
- "Bash(./generate-manual.sh:*)",
- "WebSearch",
- "WebFetch(domain:docs.opensearch.org)",
- "mcp__ide__getDiagnostics"
- ],
- "deny": [],
- "ask": []
- }
-}
\ No newline at end of file
diff --git a/manual/src/main/asciidoc/5-min-quickstart.adoc
b/manual/src/main/asciidoc/5-min-quickstart.adoc
index 3dba61cff..54be7772f 100644
--- a/manual/src/main/asciidoc/5-min-quickstart.adoc
+++ b/manual/src/main/asciidoc/5-min-quickstart.adoc
@@ -51,7 +51,7 @@ services:
version: '3.8'
services:
opensearch-node1:
- image: opensearchproject/opensearch:2.18.0
+ image: opensearchproject/opensearch:3
environment:
- cluster.name=opensearch-cluster
- node.name=opensearch-node1
@@ -115,7 +115,7 @@ cluster.name: contextElasticSearch
1) Install JDK 11 as described above
-2) Download OpenSearch here: https://opensearch.org/downloads.html (please
*make sure* you use version 2.18.0)
+2) Download OpenSearch here: https://opensearch.org/downloads.html (please
*make sure* you use version 3.x)
3) Uncompress it and change the `config/opensearch.yml` to include the
following config:
diff --git a/manual/src/main/asciidoc/building-and-deploying.adoc
b/manual/src/main/asciidoc/building-and-deploying.adoc
index 7dc472cef..65ab82a34 100644
--- a/manual/src/main/asciidoc/building-and-deploying.adoc
+++ b/manual/src/main/asciidoc/building-and-deploying.adoc
@@ -100,7 +100,7 @@ The recommended way to run OpenSearch is using Docker
Compose:
version: '3.8'
services:
opensearch-node1:
- image: opensearchproject/opensearch:2.18.0
+ image: opensearchproject/opensearch:3
environment:
- cluster.name=opensearch-cluster
- node.name=opensearch-node1
diff --git a/manual/src/main/asciidoc/configuration.adoc
b/manual/src/main/asciidoc/configuration.adoc
index db77dd078..3ddcf62e8 100644
--- a/manual/src/main/asciidoc/configuration.adoc
+++ b/manual/src/main/asciidoc/configuration.adoc
@@ -93,7 +93,7 @@ org.apache.unomi.opensearch.cluster.name=opensearch-cluster
# Note: the port number must be repeated for each host.
org.apache.unomi.opensearch.addresses=localhost:9200
-# OpenSearch security settings (required by default since OpenSearch 2.0)
+# OpenSearch security settings (required by default since OpenSearch 3)
org.apache.unomi.opensearch.ssl.enable=true
org.apache.unomi.opensearch.username=admin
org.apache.unomi.opensearch.password=${env:OPENSEARCH_INITIAL_ADMIN_PASSWORD:-admin}
@@ -112,11 +112,10 @@ To select which search engine to use, you can:
Note: The `UNOMI_AUTO_START` environment variable accepts any start features
configuration name defined in the `org.apache.unomi.start.cfg` file. You can
use the predefined "elasticsearch" or "opensearch" configurations, or specify a
custom configuration name if you have created one.
-Note: When using OpenSearch 2.18:
-- Security is enabled by default and requires SSL/TLS
-- The default admin username is 'admin'
-- The initial admin password can be set via OPENSEARCH_INITIAL_ADMIN_PASSWORD
environment variable
-- You might see log messages about "QueryGroup _id can't be null". This is a
known issue that doesn't affect functionality and is being tracked at:
https://github.com/opensearch-project/OpenSearch/issues/16874
+Note: When using OpenSearch 3.x:
+ - Security is enabled by default and requires SSL/TLS
+ - The default admin username is 'admin'
+ - The initial admin password can be set via OPENSEARCH_INITIAL_ADMIN_PASSWORD
environment variable
=== Secured events configuration
diff --git a/manual/src/main/asciidoc/getting-started.adoc
b/manual/src/main/asciidoc/getting-started.adoc
index 9990e2132..3f59a7ea9 100644
--- a/manual/src/main/asciidoc/getting-started.adoc
+++ b/manual/src/main/asciidoc/getting-started.adoc
@@ -36,7 +36,7 @@ them at your own risks.
Apache Unomi supports two search engine backends:
* *ElasticSearch*: Version 7.17.5 is supported starting with Unomi 2.0.0
-* *OpenSearch*: Version 2.18.0 is supported
+* *OpenSearch*: Version 3.x is supported
It is highly recommended to use the versions specified in the documentation.
When in doubt, consult the Apache Unomi community
for the latest compatibility information.
diff --git a/manual/src/main/asciidoc/whats-new.adoc
b/manual/src/main/asciidoc/whats-new.adoc
index c79a6036d..eba3439f1 100644
--- a/manual/src/main/asciidoc/whats-new.adoc
+++ b/manual/src/main/asciidoc/whats-new.adoc
@@ -30,9 +30,9 @@ This upgrade also brings support for Java 17.
==== OpenSearch Support
-Starting with version 2.7.0, Apache Unomi now officially supports OpenSearch
2.18.0 as an alternative to Elasticsearch. This addition gives users more
flexibility in choosing their search engine backend. Key features include:
+Starting with version 3.0.0, Apache Unomi now officially supports OpenSearch 3
as an alternative to Elasticsearch. This addition gives users more flexibility
in choosing their search engine backend. Key features include:
-- Full support for OpenSearch 2.18.0
+- Full support for OpenSearch 3
- Seamless integration with existing Unomi features
- Support for security features enabled by default in OpenSearch
- Compatible with both standalone and Docker deployments
diff --git a/manual/src/main/asciidoc/writing-plugins.adoc
b/manual/src/main/asciidoc/writing-plugins.adoc
index 34a9e8b45..2848a4cab 100644
--- a/manual/src/main/asciidoc/writing-plugins.adoc
+++ b/manual/src/main/asciidoc/writing-plugins.adoc
@@ -767,7 +767,7 @@ OSGi Service Registration for OpenSearch (opensearch
bundle's blueprint.xml):
elasticsearch:
image: docker.elastic.co/elasticsearch/elasticsearch:7.17.9
opensearch:
- image: opensearchproject/opensearch:2.18.0
+ image: opensearchproject/opensearch:3
```
4. Deployment
