sergehuber commented on code in PR #715: URL: https://github.com/apache/unomi/pull/715#discussion_r2427002078
########## manual/src/main/asciidoc/configuration.adoc: ########## @@ -68,20 +68,53 @@ org.apache.unomi.cluster.public.address=http://localhost:8181 org.apache.unomi.cluster.internal.address=https://localhost:9443 ---- -If you need to specify an ElasticSearch cluster name, or a host and port that are different than the default, -it is recommended to do this BEFORE you start the server for the first time, or you will loose all the data +If you need to specify a search engine configuration that is different than the default, +it is recommended to do this BEFORE you start the server for the first time, or you will lose all the data you have stored previously. -You can use the following properties for the ElasticSearch configuration +Apache Unomi supports both ElasticSearch and OpenSearch as search engine backends. Here are the configuration properties for each: + +For ElasticSearch: [source] ---- org.apache.unomi.elasticsearch.cluster.name=contextElasticSearch -# The elasticsearch.adresses may be a comma seperated list of host names and ports such as +# The elasticsearch.addresses may be a comma separated list of host names and ports such as # hostA:9200,hostB:9200 # Note: the port number must be repeated for each host. org.apache.unomi.elasticsearch.addresses=localhost:9200 ---- +For OpenSearch: +[source] +---- +org.apache.unomi.opensearch.cluster.name=opensearch-cluster +# The opensearch.addresses may be a comma separated list of host names and ports such as +# hostA:9200,hostB:9200 +# 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) +org.apache.unomi.opensearch.ssl.enable=true +org.apache.unomi.opensearch.username=admin +org.apache.unomi.opensearch.password=${env:OPENSEARCH_INITIAL_ADMIN_PASSWORD:-admin} +org.apache.unomi.opensearch.sslTrustAllCertificates=true +---- + +To select which search engine to use, you can: +1. Use the appropriate configuration properties above +2. When building from source, use the appropriate Maven profile: + * For ElasticSearch (default): no special profile needed + * For OpenSearch: add `-Duse.opensearch=true` to your Maven command Review Comment: I've clarified this part. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
