From dbcafd7f1d6ed658437895a7489ed37fe29973c0 Mon Sep 17 00:00:00 2001 From: James Rodewig <40268737+jrodewig@users.noreply.github.com> Date: Wed, 15 Sep 2021 12:54:32 -0400 Subject: [PATCH 1/6] [DOCS] Add deprecation docs for 6.x and earlier indices In 8.0, Elasticsearch will not start in the presence of indices created in 6.x or earlier versions. This adds a related item to the 7.15 deprecation docs. Relates to #37510 --- docs/reference/migration/index.asciidoc | 2 + .../reference/migration/migrate_7_15.asciidoc | 73 +++++++++++++++++++ 2 files changed, 75 insertions(+) create mode 100644 docs/reference/migration/migrate_7_15.asciidoc diff --git a/docs/reference/migration/index.asciidoc b/docs/reference/migration/index.asciidoc index c053aa0c059a8..f4ec4cb275e27 100644 --- a/docs/reference/migration/index.asciidoc +++ b/docs/reference/migration/index.asciidoc @@ -28,6 +28,7 @@ For more information about {minor-version}, see the <> and <>. For information about how to upgrade your cluster, see <>. +* <> * <> * <> * <> @@ -46,6 +47,7 @@ For information about how to upgrade your cluster, see <>. -- +include::migrate_7_15.asciidoc[] include::migrate_7_14.asciidoc[] include::migrate_7_13.asciidoc[] include::migrate_7_12.asciidoc[] diff --git a/docs/reference/migration/migrate_7_15.asciidoc b/docs/reference/migration/migrate_7_15.asciidoc new file mode 100644 index 0000000000000..6811b703577a4 --- /dev/null +++ b/docs/reference/migration/migrate_7_15.asciidoc @@ -0,0 +1,73 @@ +[[breaking-changes-7.15]] +== Migrating to 7.15 +++++ +7.15 +++++ + +This section discusses the changes that you need to be aware of when migrating +your application to {es} 7.15. + +See also <> and <>. + +//// +//NOTE: The notable-breaking-changes tagged regions are re-used in the +//Installation and Upgrade Guide + +[discrete] +[[breaking-changes-7.15]] +=== Breaking changes + +The following changes in {es} 7.15 might affect your applications +and prevent them from operating normally. +Before upgrading to 7.15, review these changes and take the described steps +to mitigate the impact. + +NOTE: Breaking changes introduced in minor versions are +normally limited to security and bug fixes. +Significant changes in behavior are deprecated in a minor release and +the old behavior is supported until the next major release. +To find out if you are using any deprecated functionality, +enable <>. + +// tag::notable-breaking-changes[] +// end::notable-breaking-changes[] +//// + +[discrete] +[[deprecated-7.15]] +=== Deprecations + +The following functionality has been deprecated in {es} 7.15 and will be removed +in 8.0. While this won't have an immediate impact on your applications, we +strongly encourage you take the described steps to update your code after +upgrading to 7.15. + +NOTE: Significant changes in behavior are deprecated in a minor release and the +old behavior is supported until the next major release. To find out if you are +using any deprecated functionality, enable <>. + +// tag::notable-breaking-changes[] +[[deprecate-6x-indices]] +.Indices created in Elasticsearch 6.x and earlier versions are deprecated. +[%collapsible] +==== +*Details* + +In 8.x, {es} will only read indices created in version 7.0 or above. An 8.x node +will not start in the presence of indices created in 6.x or earlier versions of +{es}. + +*Impact* + +Before upgrading to an 8.x version, reindex any index or data stream created in +6.x or earlier versions with {es} 7.x. If you no longer need the index or data +stream, delete it instead. + +You can use the get index API to check the {es} version in which an index +was created. + +[source,console] +---- +GET *,-.*?human=true&filter_path=**.settings.index.version.created_string +---- +==== +// end::notable-breaking-changes[] From 4c2b6d816665c28763a8b708ca44a73ef4e5cca2 Mon Sep 17 00:00:00 2001 From: James Rodewig <40268737+jrodewig@users.noreply.github.com> Date: Wed, 15 Sep 2021 16:05:44 -0400 Subject: [PATCH 2/6] Fix xref --- docs/reference/migration/index.asciidoc | 2 +- docs/reference/migration/migrate_7_15.asciidoc | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/reference/migration/index.asciidoc b/docs/reference/migration/index.asciidoc index f4ec4cb275e27..21793cedb4c2f 100644 --- a/docs/reference/migration/index.asciidoc +++ b/docs/reference/migration/index.asciidoc @@ -28,7 +28,7 @@ For more information about {minor-version}, see the <> and <>. For information about how to upgrade your cluster, see <>. -* <> +* <> * <> * <> * <> diff --git a/docs/reference/migration/migrate_7_15.asciidoc b/docs/reference/migration/migrate_7_15.asciidoc index 6811b703577a4..8c6681a1f3c24 100644 --- a/docs/reference/migration/migrate_7_15.asciidoc +++ b/docs/reference/migration/migrate_7_15.asciidoc @@ -1,4 +1,4 @@ -[[breaking-changes-7.15]] +[[migrating-7.15]] == Migrating to 7.15 ++++ 7.15 From 7d66f0b617640b4464bf2f3e54126be364e3ea05 Mon Sep 17 00:00:00 2001 From: James Rodewig <40268737+jrodewig@users.noreply.github.com> Date: Wed, 15 Sep 2021 16:16:08 -0400 Subject: [PATCH 3/6] Fix xref --- docs/reference/migration/index.asciidoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/migration/index.asciidoc b/docs/reference/migration/index.asciidoc index 21793cedb4c2f..19f86f43089d6 100644 --- a/docs/reference/migration/index.asciidoc +++ b/docs/reference/migration/index.asciidoc @@ -28,7 +28,7 @@ For more information about {minor-version}, see the <> and <>. For information about how to upgrade your cluster, see <>. -* <> +* <> * <> * <> * <> From 028e6ff02a764804dbf72d5691a6fc6c8a3ba24a Mon Sep 17 00:00:00 2001 From: James Rodewig <40268737+jrodewig@users.noreply.github.com> Date: Thu, 16 Sep 2021 16:28:06 -0400 Subject: [PATCH 4/6] Remove data stream refs --- docs/reference/migration/migrate_7_15.asciidoc | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/reference/migration/migrate_7_15.asciidoc b/docs/reference/migration/migrate_7_15.asciidoc index 8c6681a1f3c24..79cdf3c9ac6ae 100644 --- a/docs/reference/migration/migrate_7_15.asciidoc +++ b/docs/reference/migration/migrate_7_15.asciidoc @@ -58,9 +58,8 @@ will not start in the presence of indices created in 6.x or earlier versions of {es}. *Impact* + -Before upgrading to an 8.x version, reindex any index or data stream created in -6.x or earlier versions with {es} 7.x. If you no longer need the index or data -stream, delete it instead. +Before upgrading to an 8.x version, reindex any index created in 6.x or earlier +versions with {es} 7.x. If you no longer need the index, delete it instead. You can use the get index API to check the {es} version in which an index was created. From b29dca2f8a1b9d5b04cebb1e07dd7bd98c0974fd Mon Sep 17 00:00:00 2001 From: James Rodewig <40268737+jrodewig@users.noreply.github.com> Date: Thu, 16 Sep 2021 16:56:38 -0400 Subject: [PATCH 5/6] Fix merge conflict --- docs/reference/migration/migrate_7_15.asciidoc | 3 --- 1 file changed, 3 deletions(-) diff --git a/docs/reference/migration/migrate_7_15.asciidoc b/docs/reference/migration/migrate_7_15.asciidoc index ab5a78ffc142f..753899131dba5 100644 --- a/docs/reference/migration/migrate_7_15.asciidoc +++ b/docs/reference/migration/migrate_7_15.asciidoc @@ -9,12 +9,9 @@ your application to {es} 7.15. See also <> and <>. -<<<<<<< HEAD -======= * <> * <> ->>>>>>> upstream/7.x //// //NOTE: The notable-breaking-changes tagged regions are re-used in the //Installation and Upgrade Guide From 03fd50f2516f4aa84c2e8cab40d5d59bf2ec9ba7 Mon Sep 17 00:00:00 2001 From: James Rodewig <40268737+jrodewig@users.noreply.github.com> Date: Thu, 16 Sep 2021 16:57:09 -0400 Subject: [PATCH 6/6] Fix whitespace --- docs/reference/migration/migrate_7_15.asciidoc | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/reference/migration/migrate_7_15.asciidoc b/docs/reference/migration/migrate_7_15.asciidoc index 753899131dba5..8d41521f41ef2 100644 --- a/docs/reference/migration/migrate_7_15.asciidoc +++ b/docs/reference/migration/migrate_7_15.asciidoc @@ -63,11 +63,13 @@ logging>>. In 8.x, {es} will only read indices created in version 7.0 or above. An 8.x node will not start in the presence of indices created in 6.x or earlier versions of {es}. + *Impact* + Before upgrading to an 8.x version, reindex any index created in 6.x or earlier versions with {es} 7.x. If you no longer need the index, delete it instead. You can use the get index API to check the {es} version in which an index was created. + [source,console] ---- GET *,-.*?human=true&filter_path=**.settings.index.version.created_string