* Update docs to explicitly state supported upgrade version * Update docs/setup/upgrade.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>
113 lines
3.9 KiB
Text
113 lines
3.9 KiB
Text
[[upgrade]]
|
||
== Upgrade {kib}
|
||
|
||
Depending on the {kib} version you're upgrading from, the upgrade process to {version}
|
||
varies. The following upgrades are supported:
|
||
|
||
* Between minor versions
|
||
* From 5.6 to 6.8
|
||
* From 6.8 to {prev-major-version}
|
||
* From {prev-major-version} to {version}
|
||
ifeval::[ "{version}" != "{minor-version}.0" ]
|
||
* From any version since {minor-version}.0 to {version}
|
||
endif::[]
|
||
|
||
The following table shows the recommended upgrade paths to {version}.
|
||
|
||
[cols="<1,3",options="header",]
|
||
|====
|
||
|Upgrade from
|
||
|Recommended upgrade path to {version}
|
||
|
||
ifeval::[ "{version}" != "{minor-version}.0" ]
|
||
|A previous {minor-version} version (e.g., {minor-version}.0)
|
||
|Upgrade to {version}
|
||
endif::[]
|
||
|
||
|{prev-major-version}
|
||
|Upgrade to {version}
|
||
|
||
|7.0–7.7
|
||
a|
|
||
. Upgrade to {prev-major-version}
|
||
. Upgrade to {version}
|
||
|
||
|6.8
|
||
a|
|
||
. Upgrade to {prev-major-version}
|
||
. Upgrade to {version}
|
||
|
||
|6.0–6.7
|
||
a|
|
||
|
||
. Upgrade to 6.8
|
||
. Upgrade to {prev-major-version}
|
||
. Upgrade to {version}
|
||
|====
|
||
|
||
[WARNING]
|
||
====
|
||
The upgrade path from 6.8 to 7.0 is *not* supported.
|
||
====
|
||
|
||
[float]
|
||
[[upgrade-before-you-begin]]
|
||
=== Before you begin
|
||
|
||
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>>.
|
||
|
||
Before you upgrade {kib}:
|
||
|
||
* Consult the <<breaking-changes,breaking changes>>.
|
||
* 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.
|
||
* Before you upgrade production servers, test the upgrades in a dev environment.
|
||
* See <<preventing-migration-failures, preventing migration failures>> for common reasons upgrades fail and how to prevent these.
|
||
* If you are using custom plugins, check that a compatible version is
|
||
available.
|
||
* 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.
|
||
|
||
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.
|
||
|
||
For a comprehensive overview of the upgrade process, refer to
|
||
*{stack-ref}/upgrading-elastic-stack.html[Upgrading the Elastic Stack]*.
|
||
|
||
[float]
|
||
[[upgrade-5x-earlier]]
|
||
=== 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
|
||
{stack-ref}/upgrading-elastic-stack.html#oss-stack-upgrade[Upgrading the Elastic Stack].
|
||
|
||
When your reindex is complete, follow the <<upgrade-standard, Standard upgrade>>
|
||
instructions.
|
||
|
||
[float]
|
||
[[upgrade-6x]]
|
||
=== Upgrade from 6.x
|
||
|
||
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
|
||
Assistant to prepare for your upgrade to 7.0.
|
||
|
||
TIP: The ability to import {kib} 6.x saved searches, visualizations, and
|
||
dashboards is supported.
|
||
|
||
[float]
|
||
[[upgrade-67]]
|
||
=== 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]
|
||
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>>.
|
||
|
||
|
||
include::upgrade/upgrade-standard.asciidoc[]
|
||
|
||
include::upgrade/upgrade-migrations.asciidoc[]
|