2014-07-19 04:50:07 +08:00
|
|
|
[[breaking-changes]]
|
2021-02-04 08:14:42 +08:00
|
|
|
= Migration guide
|
2014-07-19 04:50:07 +08:00
|
|
|
|
2019-04-03 07:01:51 +08:00
|
|
|
This section discusses the changes that you need to be aware of to migrate
|
|
|
|
your application to {version}. For more information about what's new in this
|
|
|
|
release, see the <<release-highlights>> and <<es-release-notes>>.
|
2014-07-19 04:50:07 +08:00
|
|
|
|
2022-02-08 01:26:24 +08:00
|
|
|
As {es} introduces new features and improves existing ones, the changes
|
|
|
|
sometimes make older settings, APIs, and parameters obsolete. We typically
|
|
|
|
deprecate obsolete functionality as part of a release. If possible, we support
|
|
|
|
the deprecated functionality for several subsequent releases before removing it.
|
|
|
|
This enables applications to continue working unchanged while you prepare to
|
|
|
|
migrate away from the deprecated functionality.
|
|
|
|
|
|
|
|
To get the most out of {es} and facilitate future upgrades, we strongly
|
|
|
|
encourage migrating away from using deprecated functionality as soon as
|
|
|
|
possible.
|
2021-01-15 01:14:48 +08:00
|
|
|
|
|
|
|
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>>.
|
2021-10-05 20:52:11 +08:00
|
|
|
For information about how to upgrade your cluster, see <<setup-upgrade>>.
|
2018-06-16 02:04:11 +08:00
|
|
|
|
2022-05-20 07:18:14 +08:00
|
|
|
* <<migrating-8.1,Migrating to 8.2>>
|
2021-11-09 16:52:06 +08:00
|
|
|
* <<migrating-8.1,Migrating to 8.1>>
|
2021-02-04 08:14:42 +08:00
|
|
|
* <<migrating-8.0,Migrating to 8.0>>
|
2019-02-09 07:48:42 +08:00
|
|
|
|
2022-05-20 07:18:14 +08:00
|
|
|
include::migrate_8_2.asciidoc[]
|
2021-11-09 16:52:06 +08:00
|
|
|
include::migrate_8_1.asciidoc[]
|
2019-02-09 07:48:42 +08:00
|
|
|
include::migrate_8_0.asciidoc[]
|