2016-10-25 03:41:32 +02:00
|
|
|
[[upgrade]]
|
2019-04-03 20:50:47 +02:00
|
|
|
== Upgrading {kib}
|
|
|
|
|
2019-10-14 21:35:14 +02:00
|
|
|
Depending on the {kib} version you're upgrading from, the upgrade process to 7.0
|
2019-11-14 20:24:53 +01:00
|
|
|
varies.
|
|
|
|
|
|
|
|
NOTE: {kib} upgrades automatically when starting a new version, as described in
|
|
|
|
<<upgrade-migrations, this document>>.
|
|
|
|
Although you do not need to manually back up {kib} before upgrading, we recommend
|
|
|
|
that you have a backup on hand. You can use
|
|
|
|
<<snapshot-repositories, Snapshot and Restore>> to back up {kib}
|
|
|
|
data by targeting `.kibana*` indices. If you are using the Reporting plugin,
|
|
|
|
you can also target `.reporting*` indices.
|
2016-10-25 03:41:32 +02:00
|
|
|
|
2019-10-14 21:35:14 +02:00
|
|
|
[float]
|
|
|
|
[[upgrade-before-you-begin]]
|
|
|
|
=== Before you begin
|
2016-10-25 18:24:24 +02:00
|
|
|
|
2019-10-14 21:35:14 +02:00
|
|
|
Before you upgrade {kib}:
|
2016-10-25 18:24:24 +02:00
|
|
|
|
2019-10-14 21:35:14 +02:00
|
|
|
* Consult the <<breaking-changes,breaking changes>>.
|
|
|
|
* Before you upgrade production servers, test the upgrades in a dev environment.
|
2019-11-14 20:24:53 +01:00
|
|
|
* Back up your data with {es} {ref}/modules-snapshots.html[snapshots].
|
2019-10-14 21:35:14 +02:00
|
|
|
To roll back to an earlier version, you **must** have a backup of your data.
|
|
|
|
* If you are using custom plugins, check that a compatible version is
|
|
|
|
available.
|
|
|
|
* Shut down all {kib} nodes. Running more than one {kib} version against the
|
|
|
|
same Elasticseach index is unsupported. If you upgrade while older {kib} nodes are
|
|
|
|
running, the upgrade can fail.
|
2016-10-25 18:24:24 +02:00
|
|
|
|
2019-10-14 21:35:14 +02:00
|
|
|
To identify the changes you need to make to upgrade, and to enable you to
|
|
|
|
perform an Elasticsearch rolling upgrade with no downtime, you must upgrade to
|
|
|
|
6.7 before you upgrade to 7.0.
|
2019-04-03 20:50:47 +02:00
|
|
|
|
2019-10-14 21:35:14 +02:00
|
|
|
For a comprehensive overview of the upgrade process, refer to
|
|
|
|
*{stack-ref}/upgrading-elastic-stack.html[Upgrading the Elastic Stack]*.
|
2019-04-03 20:50:47 +02:00
|
|
|
|
|
|
|
[float]
|
2019-10-14 21:35:14 +02:00
|
|
|
[[upgrade-5x-earlier]]
|
|
|
|
=== Upgrading from 5.x or earlier
|
|
|
|
{es} can read indices created in the previous major version. Before you upgrade
|
|
|
|
to 7.0.0, you must reindex or delete any indices created in 5.x or earlier.
|
|
|
|
For more information, refer to
|
|
|
|
{stack-ref}/upgrading-elastic-stack.html#oss-stack-upgrade[Upgrading the Elastic Stack].
|
|
|
|
|
|
|
|
When your reindex is complete, follow the <<upgrade-standard, Standard upgrade>>
|
2019-04-03 20:50:47 +02:00
|
|
|
instructions.
|
|
|
|
|
|
|
|
[float]
|
2019-10-14 21:35:14 +02:00
|
|
|
[[upgrade-6x]]
|
|
|
|
=== Upgrading from 6.x
|
2016-10-25 18:24:24 +02:00
|
|
|
|
2020-02-04 23:00:15 +01:00
|
|
|
The recommended path is to upgrade to 6.8 before upgrading to 7.0. This makes it
|
2019-10-14 21:35:14 +02:00
|
|
|
easier to identify the required changes, and enables you to use the Upgrade
|
|
|
|
Assistant to prepare for your upgrade to 7.0.
|
2016-10-25 18:24:24 +02:00
|
|
|
|
2019-10-14 21:35:14 +02:00
|
|
|
TIP: The ability to import {kib} 6.x saved searches, visualizations, and
|
|
|
|
dashboards is supported.
|
2019-04-03 20:50:47 +02:00
|
|
|
|
|
|
|
[float]
|
2019-10-14 21:35:14 +02:00
|
|
|
[[upgrade-67]]
|
2020-02-04 23:00:15 +01:00
|
|
|
=== Upgrading from 6.8
|
|
|
|
To help you prepare for your upgrade to 7.0, 6.8 includes an https://www.elastic.co/guide/en/kibana/6.8/upgrade-assistant.html[Upgrade Assistant]
|
|
|
|
To access the assistant, go to *Management > 7.0 Upgrade Assistant*.
|
2019-04-03 20:50:47 +02:00
|
|
|
|
2020-02-04 23:00:15 +01:00
|
|
|
After you have addressed any issues that were identified by the Upgrade
|
2019-10-14 21:35:14 +02:00
|
|
|
Assistant, <<upgrade-standard,upgrade to 7.0>>.
|
2019-04-03 20:50:47 +02:00
|
|
|
|
|
|
|
|
|
|
|
include::upgrade/upgrade-standard.asciidoc[]
|
2018-11-14 00:38:10 +01:00
|
|
|
|
|
|
|
include::upgrade/upgrade-migrations.asciidoc[]
|
2019-04-03 20:50:47 +02:00
|
|
|
|