2016-10-25 03:41:32 +02:00
|
|
|
[[upgrade]]
|
2019-04-01 20:28:43 +02:00
|
|
|
== Upgrading {kib}
|
|
|
|
|
2016-10-25 03:41:32 +02:00
|
|
|
|
2016-10-25 18:24:24 +02:00
|
|
|
[IMPORTANT]
|
|
|
|
===========================================
|
2019-04-01 20:28:43 +02:00
|
|
|
Before upgrading {kib}:
|
2016-10-25 18:24:24 +02:00
|
|
|
|
|
|
|
* Consult the <<breaking-changes,breaking changes>> docs.
|
|
|
|
* Test upgrades in a dev environment before upgrading your production servers.
|
2019-04-01 20:28:43 +02:00
|
|
|
* Backup your data using the {es} {ref}/modules-snapshots.html[snapshots] feature.
|
2016-10-25 18:24:24 +02:00
|
|
|
You **cannot roll back** to an earlier version unless you have a backup of
|
|
|
|
your data.
|
|
|
|
* If you are using custom plugins, check that a compatible version is
|
|
|
|
available.
|
|
|
|
===========================================
|
|
|
|
|
2019-04-01 20:28:43 +02:00
|
|
|
Depending on which version of {kib} you're upgrading from, the upgrade process to 7.0
|
|
|
|
will vary.
|
2016-10-25 18:24:24 +02:00
|
|
|
|
2019-04-01 20:28:43 +02:00
|
|
|
The recommended path is to upgrade to 6.7 before upgrading to 7.0.
|
|
|
|
This makes it easier to identify the changes you need to make to upgrade and enables
|
|
|
|
you to perform a rolling upgrade with no downtime.
|
|
|
|
|
|
|
|
Please see
|
|
|
|
*{stack-ref}/upgrading-elastic-stack.html[Upgrading the Elastic Stack]* for a
|
|
|
|
comprehensive overview of the upgrade process.
|
|
|
|
|
2019-04-09 18:23:42 +02:00
|
|
|
|
2019-04-01 20:28:43 +02:00
|
|
|
[float]
|
|
|
|
==== Upgrading from 5.x or earlier
|
|
|
|
{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 7.0.0.
|
|
|
|
See {stack-ref}/upgrading-elastic-stack.html#oss-stack-upgrade[Upgrading the Elastic Stack]
|
|
|
|
for more information.
|
|
|
|
|
|
|
|
Once your reindex is complete, you can follow the <<upgrade-standard, Standard upgrade>>
|
|
|
|
instructions.
|
|
|
|
|
|
|
|
[float]
|
|
|
|
==== Upgrading from 6.x
|
2016-10-25 18:24:24 +02:00
|
|
|
|
2019-04-01 20:28:43 +02:00
|
|
|
The recommended path is to upgrade to 6.7 before upgrading to 7.0. This makes it
|
|
|
|
easier to identify the required changes, and enables you to use the Upgrade Assistant
|
|
|
|
to prepare for your upgrade to 7.0 (see below).
|
2016-10-25 18:24:24 +02:00
|
|
|
|
2019-04-01 20:28:43 +02:00
|
|
|
*Note:* Saved searches, visualizations, and dashboards created in {kib} 6.x
|
|
|
|
can be generally imported into 7.x.
|
|
|
|
|
|
|
|
[float]
|
|
|
|
==== Upgrading from 6.7
|
|
|
|
6.7 includes an https://www.elastic.co/guide/en/kibana/6.7/upgrade-assistant.html[Upgrade Assistant]
|
|
|
|
to help you prepare for your upgrade to 7.0. To access the assistant, go to *Management > 7.0 Upgrade Assistant*.
|
|
|
|
|
|
|
|
After you have addressed any issues that were identified by the Upgrade Assistant,
|
|
|
|
<<upgrade-standard,upgrade to 7.0>>.
|
|
|
|
|
2019-04-09 18:23:42 +02:00
|
|
|
[float]
|
|
|
|
=== Known issues
|
|
|
|
|
|
|
|
[float]
|
|
|
|
==== "shard failed" error when viewing {beats} dashboards in {kib}
|
|
|
|
After upgrading to {es} 7.0, any indices created by {beats} 6.6 or older will not
|
|
|
|
work in {kib} dashboards until the `index.query.default_field` setting is added
|
|
|
|
to each index. Indices created in {beats} 6.7 or later are unaffected.
|
|
|
|
To add the setting to the index, you can use the 7.0
|
|
|
|
{kibana-ref}/upgrade-assistant.html[Upgrade Assistant], or
|
2019-04-09 19:42:02 +02:00
|
|
|
//{beats-ref}/upgrading.html#dashboard-shard-failed[
|
|
|
|
add the setting manually
|
|
|
|
//]
|
|
|
|
.
|
2019-04-09 18:23:42 +02:00
|
|
|
|
2019-04-01 20:28:43 +02:00
|
|
|
|
|
|
|
include::upgrade/upgrade-standard.asciidoc[]
|
2018-11-14 00:38:10 +01:00
|
|
|
|
|
|
|
include::upgrade/upgrade-migrations.asciidoc[]
|
2019-04-01 20:28:43 +02:00
|
|
|
|