Upgrading

edit

Before upgrading Elasticsearch:

  • Consult the 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 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:

Upgrade From Upgrade To Supported Upgrade Type

0.90.x

2.x

Full cluster restart

1.x

2.x

Full cluster restart

2.x

2.y

Rolling upgrade (where `y > x `)

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.