elasticsearch/docs/reference/migration/index.asciidoc
Yang Wang 1e4732e4a9
Deprecate the behaviour of implicitly disabling file/native realm (#69320)
As a precursor for #50892, this PR deprecate the behaviour of file and/or
native realm being implicitly disabled when there are other explicitly
configured realms.

With this change, the recommend way of disabling file/native realm is to
explicitly set enabled to false, e.g.:

xpack.security.authc.realms.file.default_file.enabled: false

This PR ensures that a warning is generated whenever file and/or native realm
is implicitly disabled.

This change also brings a question about the order parameter. Currently, the
order parameter is mandatory in 8.0 and gets a warning message if it is missing
in 7.x. However, it makes sense to not specify the order parameter if the realm
is disabled. So I also updated the order parameter related code to do just
that.
2021-03-15 16:56:07 +11:00

61 lines
2.4 KiB
Text

[[breaking-changes]]
= Migration guide
[partintro]
--
This section describes the breaking changes and deprecations introduced in this release
and previous minor versions.
As {es} introduces new features and improves existing ones,
the changes sometimes make older settings, APIs, and parameters obsolete.
The obsolete functionality is typically deprecated in a minor release and
removed in the subsequent major release.
This enables applications to continue working unchanged across most minor version upgrades.
Breaking changes introduced in minor releases are generally limited to critical security fixes
and bug fixes that correct unintended behavior.
To get the most out of {es} and facilitate future upgrades, we strongly encourage migrating
away from using deprecated functionality as soon as possible.
To give you insight into what deprecated features you're using, {es}:
- Returns a `Warn` HTTP header whenever you submit a request that uses deprecated functionality.
- <<deprecation-logging, Logs deprecation warnings>> when deprecated functionality is used.
- <<migration-api-deprecation, Provides a deprecation info API>> that scans a cluster's configuration
and mappings for deprecated functionality.
For more information about {minor-version},
see the <<release-highlights>> and <<es-release-notes>>.
For information about how to upgrade your cluster, see <<setup-upgrade>>.
* <<breaking-changes-7.13,Migrating to 7.13>>
* <<breaking-changes-7.12,Migrating to 7.12>>
* <<breaking-changes-7.11,Migrating to 7.11>>
* <<breaking-changes-7.10,Migrating to 7.10>>
* <<breaking-changes-7.9,Migrating to 7.9>>
* <<breaking-changes-7.8,Migrating to 7.8>>
* <<breaking-changes-7.7,Migrating to 7.7>>
* <<breaking-changes-7.6,Migrating to 7.6>>
* <<breaking-changes-7.5,Migrating to 7.5>>
* <<breaking-changes-7.4,Migrating to 7.4>>
* <<breaking-changes-7.3,Migrating to 7.3>>
* <<breaking-changes-7.2,Migrating to 7.2>>
* <<breaking-changes-7.1,Migrating to 7.1>>
* <<breaking-changes-7.0,Migrating to 7.0>>
--
include::migrate_7_13.asciidoc[]
include::migrate_7_12.asciidoc[]
include::migrate_7_11.asciidoc[]
include::migrate_7_10.asciidoc[]
include::migrate_7_9.asciidoc[]
include::migrate_7_8.asciidoc[]
include::migrate_7_7.asciidoc[]
include::migrate_7_6.asciidoc[]
include::migrate_7_5.asciidoc[]
include::migrate_7_4.asciidoc[]
include::migrate_7_3.asciidoc[]
include::migrate_7_2.asciidoc[]
include::migrate_7_1.asciidoc[]
include::migrate_7_0.asciidoc[]