2016-10-25 03:41:32 +02:00
[[upgrade]]
2020-06-09 01:15:20 +02:00
== Upgrade {kib}
2019-04-01 20:28:43 +02:00
2019-10-14 21:42:29 +02:00
Depending on the {kib} version you're upgrading from, the upgrade process to 7.0
2020-06-09 01:15:20 +02:00
varies.
2019-11-14 21:53:54 +01:00
2019-10-14 21:42:29 +02:00
[float]
[[upgrade-before-you-begin]]
=== Before you begin
2016-10-25 18:24:24 +02:00
2021-01-26 15:35:28 +01:00
WARNING: {kib} automatically runs upgrade migrations when required. To roll back to an earlier version in case of an upgrade failure, you **must** have a backup snapshot available. Use <<snapshot-repositories, Snapshot and Restore>> to back up {kib} data by targeting the `.kibana*` indices. For more information see <<upgrade-migrations, upgrade migrations>>.
2019-10-14 21:42:29 +02:00
Before you upgrade {kib}:
2016-10-25 18:24:24 +02:00
2021-03-22 22:54:21 +01:00
* Consult the <<release-notes,breaking changes>>.
2021-01-26 15:35:28 +01:00
* Back up your data with <<snapshot-repositories, Snapshot and Restore>>. To roll back to an earlier version, you **must** have a snapshot of the `.kibana*` indices.
* Although not a requirement for rollbacks, we recommend taking a snapshot of all {kib} indices created by the plugins you use such as the `.reporting*` indices created by the reporting plugin.
2019-10-14 21:42:29 +02:00
* Before you upgrade production servers, test the upgrades in a dev environment.
2021-01-26 15:35:28 +01:00
* See <<preventing-migration-failures, preventing migration failures>> for common reasons upgrades fail and how to prevent these.
2019-10-14 21:42:29 +02:00
* If you are using custom plugins, check that a compatible version is
2020-06-09 01:15:20 +02:00
available.
2021-01-26 15:35:28 +01:00
* Shut down all {kib} instances. Running more than one {kib} version against
the same Elasticseach index is unsupported. Upgrading while older {kib}
instances are running can cause data loss or upgrade failures.
2016-10-25 18:24:24 +02:00
2020-06-09 01:15:20 +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
2019-10-14 21:42:29 +02:00
6.7 before you upgrade to 7.0.
2019-04-01 20:28:43 +02:00
2020-06-09 01:15:20 +02:00
For a comprehensive overview of the upgrade process, refer to
2019-10-14 21:42:29 +02:00
*{stack-ref}/upgrading-elastic-stack.html[Upgrading the Elastic Stack]*.
2019-04-01 20:28:43 +02:00
2019-04-09 18:23:42 +02:00
2019-04-01 20:28:43 +02:00
[float]
2019-10-14 21:42:29 +02:00
[[upgrade-5x-earlier]]
2020-06-09 01:15:20 +02:00
=== Upgrade 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
2019-10-14 21:42:29 +02:00
{stack-ref}/upgrading-elastic-stack.html#oss-stack-upgrade[Upgrading the Elastic Stack].
2020-06-09 01:15:20 +02:00
When your reindex is complete, follow the <<upgrade-standard, Standard upgrade>>
instructions.
2019-04-01 20:28:43 +02:00
[float]
2019-10-14 21:42:29 +02:00
[[upgrade-6x]]
2020-06-09 01:15:20 +02:00
=== Upgrade from 6.x
2016-10-25 18:24:24 +02:00
2020-06-09 01:15:20 +02:00
The recommended path is to upgrade to 6.8 before upgrading to 7.0. This makes it
easier to identify the required changes, and enables you to use the Upgrade
2019-10-14 21:42:29 +02:00
Assistant to prepare for your upgrade to 7.0.
2016-10-25 18:24:24 +02:00
2020-06-09 01:15:20 +02:00
TIP: The ability to import {kib} 6.x saved searches, visualizations, and
2019-10-14 21:42:29 +02:00
dashboards is supported.
2019-04-01 20:28:43 +02:00
[float]
2019-10-14 21:42:29 +02:00
[[upgrade-67]]
2020-06-09 01:15:20 +02:00
=== Upgrade 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]
2020-02-04 23:00:15 +01:00
To access the assistant, go to *Management > 7.0 Upgrade Assistant*.
2019-04-01 20:28:43 +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:42:29 +02:00
Assistant, <<upgrade-standard,upgrade to 7.0>>.
2019-04-01 20:28:43 +02:00
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[]