From c2f2f8c51a14219ff597881e236066378fe9b7e0 Mon Sep 17 00:00:00 2001 From: James Rodewig <40268737+jrodewig@users.noreply.github.com> Date: Wed, 15 Sep 2021 11:09:30 -0400 Subject: [PATCH 1/4] [DOCS] Add deprecation docs for fractional byte size values We deprecated fractional byte size values in 6.2 with PR #27702 However, we didn't add a related item to the 6.2 deprecation docs. This adds the missing item to the 7.15 deprecation docs. Relates to #53927. --- docs/reference/migration/index.asciidoc | 2 + .../reference/migration/migrate_7_15.asciidoc | 74 +++++++++++++++++++ 2 files changed, 76 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..052ae9a9a2c49 --- /dev/null +++ b/docs/reference/migration/migrate_7_15.asciidoc @@ -0,0 +1,74 @@ +[[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[] +[discrete] +[[breaking_715_settings_deprecations]] +==== Settings deprecations + +[[deprecate-fractional-byte-settings]] +.Fractional byte size values are deprecated. +[%collapsible] +==== +*Details* + +In 6.2, we deprecated support for fractional byte size values, such as `23.5pb`. +In 8.0, {es} will reject fractional byte size values for: + +* Cluster settings +* Index settings +* Cluster state metadata, such as an {ilm-init} policy, that support byte size +values + +*Impact* + +To avoid deprecation warnings, discontinue use of fractional byte size values in +your configurations. Update any existing configurations to use whole values. +==== +// end::notable-breaking-changes[] From 376b3d2a25063eadae29c12172f13d6b886b53dc 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/4] 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 052ae9a9a2c49..906af96ea7d6d 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 e1add175f78e2f01fd0e327c643f8d8677f6efa8 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/4] 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 51ebbfa332852256b088875c39f2b101c9f6220b Mon Sep 17 00:00:00 2001 From: James Rodewig <40268737+jrodewig@users.noreply.github.com> Date: Thu, 16 Sep 2021 12:58:54 -0400 Subject: [PATCH 4/4] remove 8.0 removal bit --- docs/reference/migration/migrate_7_15.asciidoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/reference/migration/migrate_7_15.asciidoc b/docs/reference/migration/migrate_7_15.asciidoc index f96b450f917fb..e8f973ed4c8b6 100644 --- a/docs/reference/migration/migrate_7_15.asciidoc +++ b/docs/reference/migration/migrate_7_15.asciidoc @@ -79,8 +79,8 @@ another store type. [%collapsible] ==== *Details* + -In 6.2, we deprecated support for fractional byte size values, such as `23.5pb`. -In 8.0, {es} will reject fractional byte size values for: +In 6.2, we deprecated support for fractional byte size values, such as `23.5pb`, +in: * Cluster settings * Index settings