2014-07-18 16:50:07 -04:00
|
|
|
[[breaking-changes]]
|
2021-01-13 14:23:45 -05:00
|
|
|
= Migration guide
|
2014-07-18 16:50:07 -04:00
|
|
|
|
|
|
|
|
[partintro]
|
|
|
|
|
--
|
2021-01-13 14:23:45 -05:00
|
|
|
This section describes the breaking changes and deprecations introduced in this release
|
|
|
|
|
and previous minor versions.
|
2014-07-18 16:50:07 -04:00
|
|
|
|
2021-01-13 14:23:45 -05:00
|
|
|
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>>.
|
2019-04-02 19:01:51 -04:00
|
|
|
For information about how to upgrade your cluster, see <<setup-upgrade>>.
|
2018-06-15 14:04:11 -04:00
|
|
|
|
2021-01-13 14:23:45 -05:00
|
|
|
* <<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>>
|
2020-08-31 11:25:57 -04:00
|
|
|
|
2014-07-18 16:50:07 -04:00
|
|
|
--
|
2019-03-22 19:37:03 -04:00
|
|
|
|
2020-08-31 11:25:57 -04:00
|
|
|
include::migrate_7_10.asciidoc[]
|
2020-06-18 13:54:23 -04:00
|
|
|
include::migrate_7_9.asciidoc[]
|
2020-03-28 14:33:37 -04:00
|
|
|
include::migrate_7_8.asciidoc[]
|
2020-01-30 20:32:37 -05:00
|
|
|
include::migrate_7_7.asciidoc[]
|
2019-10-28 14:57:20 -04:00
|
|
|
include::migrate_7_6.asciidoc[]
|
2019-10-23 21:52:22 -04:00
|
|
|
include::migrate_7_5.asciidoc[]
|
2019-08-23 18:09:32 -04:00
|
|
|
include::migrate_7_4.asciidoc[]
|
2019-07-10 03:35:45 -04:00
|
|
|
include::migrate_7_3.asciidoc[]
|
2019-05-02 18:36:31 -04:00
|
|
|
include::migrate_7_2.asciidoc[]
|
2019-03-22 19:37:03 -04:00
|
|
|
include::migrate_7_1.asciidoc[]
|
2017-08-16 15:12:44 -04:00
|
|
|
include::migrate_7_0.asciidoc[]
|
