From 6301d96783975bebcf53d82f24420c5f2f1a4933 Mon Sep 17 00:00:00 2001 From: James Rodewig <40268737+jrodewig@users.noreply.github.com> Date: Wed, 15 Sep 2021 11:39:13 -0400 Subject: [PATCH 1/3] [DOCS] Add deprecation docs for obselete security settings We deprecated `accept_default_password` in 6.0 with PR #1665. However, we didn't add a related item to the 6.0 breaking changes docs. Similarly, we deprecated `xpack.security.authz.store.roles.index.cache.max_size` and `xpack.security.authz.store.roles.index.cache.ttl` in 5.2 with PR #4449 However, we didn't add a related item to the 5.2 breaking changes docs. This adds the missing items to the 7.15 deprecation docs. Relates to #40496. --- docs/reference/migration/index.asciidoc | 2 + .../reference/migration/migrate_7_15.asciidoc | 87 +++++++++++++++++++ 2 files changed, 89 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..a6668be49b839 --- /dev/null +++ b/docs/reference/migration/migrate_7_15.asciidoc @@ -0,0 +1,87 @@ +[[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_security_deprecations]] +==== Security deprecations + +[[deprecate-accept_default_password]] +.The `accept_default_password` setting is deprecated. +[%collapsible] +==== +*Details* + +In 6.0, we deprecated the `accept_default_password` cluster setting. We removed +support for default passwords in 6.0 but did not remove the setting for +backwards compatibility. In 8.0, we will remove the setting. + +*Impact* + +To avoid deprecation warnings, discontinue use of the setting. +==== + +[[deprecate-native-role-cache-settings]] +.Native role cache settings are deprecated. +[%collapsible] +==== +*Details* + +In 5.2, we deprecated the following cluster settings: + +* `xpack.security.authz.store.roles.index.cache.max_size` +* `xpack.security.authz.store.roles.index.cache.ttl` + +These native role cache settings have been unused since 5.2, but we did not +remove the settings for backwards compatibility. In 8.0, we will remove the +settings. + +*Impact* + +To avoid deprecation warnings, discontinue use of the settings. +==== +// end::notable-breaking-changes[] From da36d48c94ec79714bfa285003ae5ab053b0fe45 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/3] 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 a6668be49b839..3328d459b5435 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 7e8a03786a8c6bf3b5d8e4c6c03c37286c8dc33b 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/3] 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 <>. -* <> +* <> * <> * <> * <>