Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Docs] Cleaning up the versions in the upgrade paths. Closes #116223 #116228

Merged
merged 2 commits into from
Oct 26, 2021
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
56 changes: 23 additions & 33 deletions docs/setup/upgrade.asciidoc
Original file line number Diff line number Diff line change
@@ -1,55 +1,45 @@
[[upgrade]]
== Upgrade {kib}

Depending on the {kib} version you're upgrading from, the upgrade process to {version}
varies. The following upgrades are supported:
You can always upgrade to the latest patch release or from one minor version
to another within the same major version series.

* 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::[]
For major version upgrades:

The following table shows the recommended upgrade paths to {version}.
. Upgrade to the last minor version released before the new major version.
. Use the Upgrade Assistant to determine what changes you need to make before the major version upgrade.
. When you've addressed all the critical issues, upgrade {es} and then upgrade {kib}.

IMPORTANT: You can upgrade to pre-release versions of 8.0 for testing,
but upgrading from a pre-release to the final GA version is not supported.
Pre-releases should only be used for testing in a temporary environment.

[discrete]
[[upgrade-paths]]
=== Recommended upgrade paths to 8.0

[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::[]
|Upgrading from
|Upgrade path

|{prev-major-version}
|Upgrade to {version}
|7.16
|Upgrade to 8.0

|7.0–7.7
|6.8–7.15
a|
. Upgrade to {prev-major-version}
. Upgrade to {version}

|6.8
a|
. Upgrade to {prev-major-version}
. Upgrade to {version}
. Upgrade to 7.16
. Upgrade to 8.0

|6.0–6.7
a|

. Upgrade to 6.8
. Upgrade to {prev-major-version}
. Upgrade to {version}
. Upgrade to 7.16
. Upgrade to 8.0
|====

[WARNING]
====
The upgrade path from 6.8 to 7.0 is *not* supported.
====

[float]
[[upgrade-before-you-begin]]
=== Before you begin
Expand Down