[[breaking-changes]]
= Breaking changes

[partintro]
--
This section discusses the changes that you need to be aware of when migrating
your application from one version of Elasticsearch to another.

As a general rule:

* Migration between minor versions -- e.g. `5.x` to `5.y` -- can be
  performed by <<rolling-upgrades,upgrading one node at a time>>.

* Migration between consecutive major versions -- e.g. `2.x` to `5.x` --
  requires a <<restart-upgrade,full cluster restart>>.

* Migration between non-consecutive major versions -- e.g. `1.x` to `5.x` --
  is not supported.

See <<setup-upgrade>> for more info.
--
include::migrate_5_0.asciidoc[]

[[breaking-changes]]
= Breaking changes

[partintro]
--
This section discusses the changes that you need to be aware of when migrating
your application from one version of Elasticsearch to another.

As a general rule:

* Migration between minor versions -- e.g. `5.x` to `5.y` -- can be
  performed by <<rolling-upgrades,upgrading one node at a time>>.

* Migration between consecutive major versions -- e.g. `2.x` to `5.x` --
  requires a <<restart-upgrade,full cluster restart>>.

* Migration between non-consecutive major versions -- e.g. `1.x` to `5.x` --
  is not supported.

See <<setup-upgrade>> for more info.
--

include::migrate_5_1.asciidoc[]

include::migrate_5_0.asciidoc[]

Include 5.1 migration docs in migration docs
Include 5.1 migration docs in migration docs

The migration docs need to include a copy of the migration docs for all
versions.
