OpenSearch/docs/reference/upgrade.asciidoc

82 lines
2.5 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

[[setup-upgrade]]
= Upgrade {es}
[partintro]
--
{es} can usually be upgraded using a <<rolling-upgrades,Rolling upgrade>>
process so upgrading does not interrupt service. Rolling upgrades are supported:
* Between minor versions
* From 5.6 to 6.8
* From 6.8 to {version}
The following table shows the recommended upgrade paths to {version}.
[cols="<1m,3",options="header",]
|====
|Upgrade from
|Recommended upgrade path to {version}
|7.07.5
|<<rolling-upgrades,Rolling upgrade>> to {version}
|6.8
|<<rolling-upgrades,Rolling upgrade>> to {version}
|6.06.7
a|
. https://www.elastic.co/guide/en/elasticsearch/reference/6.8/rolling-upgrades.html[Rolling upgrade] to 6.8
. <<rolling-upgrades,Rolling upgrade>> to {version}
|5.6
a|
. https://www.elastic.co/guide/en/elasticsearch/reference/6.8/rolling-upgrades.html[Rolling upgrade] to 6.8
. <<rolling-upgrades,Rolling upgrade>> to {version}
|5.05.5
a|
. https://www.elastic.co/guide/en/elasticsearch/reference/5.6/rolling-upgrades.html[Rolling upgrade] to 5.6
. https://www.elastic.co/guide/en/elasticsearch/reference/6.8/rolling-upgrades.html[Rolling upgrade] to 6.8
. <<rolling-upgrades,Rolling upgrade>> to {version}
|====
[WARNING]
====
The upgrade path from 6.8 to 7.0 is *not* supported (both full cluster restart and rolling upgrade).
====
To upgrade directly to {version} from 6.7 or earlier, you must shut down the
cluster, install {version}, and restart. For more information, see
<<restart-upgrade, Full cluster restart upgrade>>.
[WARNING]
====
In-place downgrades to earlier versions are *not* supported. To downgrade to an
earlier version, <<snapshots-restore-snapshot,restore a snapshot>> taken prior
to the version upgrade.
====
{es} can read indices created in the previous major version. If you
have indices created in 5.x or before, you must reindex or delete them
before upgrading to {version}. {es} nodes will fail to start if
incompatible indices are present. Snapshots of 5.x or earlier indices cannot be
restored to a 7.x cluster even if they were created by a 6.x cluster. For
information about upgrading old indices, see <<reindex-upgrade, Reindex to upgrade>>.
When upgrading to a new version of {es}, you need to upgrade each
of the products in your Elastic Stack. For more information, see the
{stack-ref}/upgrading-elastic-stack.html[Elastic Stack Installation and Upgrade Guide].
--
include::upgrade/rolling_upgrade.asciidoc[]
include::upgrade/cluster_restart.asciidoc[]
include::upgrade/reindex_upgrade.asciidoc[]