From 34068f01bd7e31856519c4dda0b1e9bd3153c647 Mon Sep 17 00:00:00 2001 From: aetter Date: Wed, 1 Sep 2021 16:29:19 -0700 Subject: [PATCH] Add note about enabling compatibility setting during upgrade --- _clients/agents-and-ingestion-tools/index.md | 6 ++++++ _upgrade-to/upgrade-to.md | 6 ++++++ 2 files changed, 12 insertions(+) diff --git a/_clients/agents-and-ingestion-tools/index.md b/_clients/agents-and-ingestion-tools/index.md index 7b9ca7fb..ed326279 100644 --- a/_clients/agents-and-ingestion-tools/index.md +++ b/_clients/agents-and-ingestion-tools/index.md @@ -27,6 +27,12 @@ PUT _cluster/settings } ``` +[Just like any other setting]({{site.url}}{{site.baseurl}}/opensearch/configuration/), the alternative is to add the following line to `opensearch.yml` on each node and then restart the node: + +```yml +compatibility.override_main_response_version: true +``` + ## Downloads diff --git a/_upgrade-to/upgrade-to.md b/_upgrade-to/upgrade-to.md index 1fed63f3..a415b621 100644 --- a/_upgrade-to/upgrade-to.md +++ b/_upgrade-to/upgrade-to.md @@ -144,6 +144,12 @@ If you are upgrading an Open Distro for Elasticsearch cluster, we recommend firs 1. Port your settings from `elasticsearch.yml` to `opensearch.yml`. Most settings use the same names. At a minimum, specify `cluster.name`, `node.name`, `discovery.seed_hosts`, and `cluster.initial_master_nodes`. + 1. (Optional) If you're actively connecting to the cluster with legacy clients that check for a particular version number, such as Logstash OSS, add a [compatibility setting]({{site.url}}{{site.baseurl}}/clients/agents-and-ingestion-tools/) to `opensearch.yml`: + + ```yml + compatibility.override_main_response_version: true + ``` + 1. (Optional) Add your certificates to your `config` directory, add them to `opensearch.yml`, and initialize the security plugin. 1. Start OpenSearch on the node (rolling) or all nodes (cluster restart).