OpenSearch/docs/reference/setup/upgrade.asciidoc

37 lines
1.6 KiB
Plaintext

[[setup-upgrade]]
== Upgrading
[IMPORTANT]
===========================================
Before upgrading Elasticsearch:
* Consult the <<breaking-changes,breaking changes>> docs.
* Test upgrades in a dev environment before upgrading your production cluster.
* Always back up your data before upgrading. You cannot roll back to an earlier
version unless you have a <<backup,backup>> of your data.
===========================================
Elasticsearch can usually be upgraded using a rolling upgrade process,
resulting in no interruption of service. This section details how to perform
both rolling upgrades and upgrades with full cluster restarts.
To determine whether a rolling upgrade is supported for your release, please
consult this table:
[cols="1<m,1<m,3",options="header",]
|=======================================================================
|Upgrade From |Upgrade To |Supported Upgrade Type
|0.90.x |2.x |<<restart-upgrade,Full cluster restart>>
|1.x |2.x |<<restart-upgrade,Full cluster restart>>
|2.x |2.y |<<rolling-upgrades,Rolling upgrade>> (where `y > x `)
|2.x |3.x |<<restart-upgrade,Full cluster restart>>
|=======================================================================
TIP: Take plugins into consideration as well when upgrading. Most plugins will have to be upgraded alongside Elasticsearch, although some plugins accessed primarily through the browser (`_site` plugins) may continue to work given that API changes are compatible.
include::backup.asciidoc[]
include::rolling_upgrade.asciidoc[]
include::cluster_restart.asciidoc[]