2014-04-01 12:28:08 -04:00
|
|
|
[[setup-upgrade]]
|
|
|
|
== Upgrading
|
|
|
|
|
2015-05-04 10:48:53 -04:00
|
|
|
[IMPORTANT]
|
2015-06-19 10:27:28 -04:00
|
|
|
===========================================
|
|
|
|
Before upgrading Elasticsearch:
|
2014-04-01 12:28:08 -04:00
|
|
|
|
2015-06-19 10:27:28 -04:00
|
|
|
* 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.
|
|
|
|
===========================================
|
2014-04-01 12:28:08 -04:00
|
|
|
|
2015-06-19 10:27:28 -04:00
|
|
|
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.
|
2014-04-01 12:28:08 -04:00
|
|
|
|
2015-06-19 10:27:28 -04:00
|
|
|
To determine whether a rolling upgrade is supported for your release, please
|
|
|
|
consult this table:
|
2014-04-01 12:28:08 -04:00
|
|
|
|
2015-06-19 10:27:28 -04:00
|
|
|
[cols="1<m,1<m,3",options="header",]
|
|
|
|
|=======================================================================
|
|
|
|
|Upgrade From |Upgrade To |Supported Upgrade Type
|
|
|
|
|0.90.x |1.x, 2.x |<<restart-upgrade,Full cluster restart>>
|
|
|
|
|< 0.90.7 |0.90.x |<<restart-upgrade,Full cluster restart>>
|
|
|
|
|>= 0.90.7 |0.90.x |<<rolling-upgrades,Rolling upgrade>>
|
|
|
|
|1.0.0 - 1.3.1 |1.x |<<rolling-upgrades,Rolling upgrade>> (if <<recovery,`indices.recovery.compress`>> set to `false`)
|
|
|
|
|>= 1.3.2 |1.x |<<rolling-upgrades,Rolling upgrade>>
|
|
|
|
|1.x |2.x |<<restart-upgrade,Full cluster restart>>
|
|
|
|
|=======================================================================
|
2014-04-01 12:28:08 -04:00
|
|
|
|
2015-07-08 19:32:38 -04:00
|
|
|
TIP: Take plugins into consideration as well when upgrading. For example, some plugins require a specific version of Elasticsearch to be installed.
|
|
|
|
|
2015-06-19 10:27:28 -04:00
|
|
|
include::backup.asciidoc[]
|
2014-04-01 12:28:08 -04:00
|
|
|
|
2015-06-19 10:27:28 -04:00
|
|
|
include::rolling_upgrade.asciidoc[]
|
2014-04-01 12:28:08 -04:00
|
|
|
|
2015-06-19 10:27:28 -04:00
|
|
|
include::cluster_restart.asciidoc[]
|