From a4b37bf7fe7d286e0284a9cffdd6bafa8a27eccc Mon Sep 17 00:00:00 2001 From: Ali Beyad Date: Thu, 30 Mar 2017 13:08:41 -0400 Subject: [PATCH] [DOCS] Multiple clusters connected to the same repository (#23807) --- docs/reference/modules/snapshots.asciidoc | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/reference/modules/snapshots.asciidoc b/docs/reference/modules/snapshots.asciidoc index 3593acb61b3..94138dbdb0f 100644 --- a/docs/reference/modules/snapshots.asciidoc +++ b/docs/reference/modules/snapshots.asciidoc @@ -16,6 +16,19 @@ a 2.x cluster and use <> to rebuild the index in a 5.x cluster. This is as time consuming as restoring from archival copies of the original data. +Note: If a repository is connected to a 2.x cluster, and you want to connect +a 5.x cluster to the same repository, you will have to either first set the 2.x +repository to `readonly` mode (see below for details on `readonly` mode) or create +the 5.x repository in `readonly` mode. A 5.x cluster will update the repository +to conform to 5.x specific formats, which will mean that any new snapshots written +via the 2.x cluster will not be visible to the 5.x cluster, and vice versa. +In fact, as a general rule, only one cluster should connect to the same repository +location with write access; all other clusters connected to the same repository +should be set to `readonly` mode. While setting all but one repositories to +`readonly` should work with multiple clusters differing by one major version, +it is not a supported configuration. + + [float] === Repositories