Skip to content

Commit

Permalink
Clarify snapshot docs on archive indices (#88417) (#88426)
Browse files Browse the repository at this point in the history
Should remove confusion what to do with old archive indices.
  • Loading branch information
ywelsch authored Jul 11, 2022
1 parent 6201e27 commit 8717f2f
Show file tree
Hide file tree
Showing 3 changed files with 6 additions and 21 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,5 @@ h| Index creation version | 6.8 | 7.0–7.1 | 7.2–{prev-major-last
| 6.8 | {yes-icon} | {no-icon} | {yes-icon} | {no-icon} | {yes-icon}footnote:archive[]
| 7.0–7.1 | {no-icon} | {yes-icon} | {yes-icon} | {yes-icon} | {yes-icon}
| 7.2–{prev-major-last} | {no-icon} | {no-icon} | {yes-icon} | {yes-icon} | {yes-icon}
| 8.0–8.2 | {no-icon} | {no-icon} | {no-icon} | {yes-icon} | {yes-icon}
| 8.3–{minor-version} | {no-icon} | {no-icon} | {no-icon} | {yes-icon} | {yes-icon}
| 8.0–{minor-version} | {no-icon} | {no-icon} | {no-icon} | {yes-icon} | {yes-icon}
|====
12 changes: 5 additions & 7 deletions docs/reference/snapshot-restore/index.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -113,8 +113,6 @@ any restored indices must be compatible.
[[snapshot-cluster-compatibility]]
=== Snapshot version compatibility

include::snapshot-vers-compat.asciidoc[]

You can't restore a snapshot to an earlier version of {es}. For example, you
can't restore a snapshot taken in 7.6.0 to a cluster running 7.5.0.

Expand Down Expand Up @@ -148,11 +146,11 @@ include::cluster-index-compat.asciidoc[]
You can't restore an index to an earlier version of {es}. For example, you can't
restore an index created in 7.6.0 to a cluster running 7.5.0.

A compatible snapshot can contain indices created in an incompatible version.
For example, a snapshot of a {prev-major-last} cluster can contain an index
created in 6.8. If you try to restore the 6.8 index to an {minor-version}
cluster, the restore attempt will fail. Keep this in mind if you take a snapshot
before upgrading a cluster.
A compatible snapshot can contain indices created in an older incompatible
version. For example, a snapshot of a {prev-major-last} cluster can contain an
index created in 6.8. Restoring the 6.8 index to an {minor-version} cluster
fails unless you can use the <<archive-indices,archive functionality>>. Keep
this in mind if you take a snapshot before upgrading a cluster.

As a workaround, you can first restore the index to another cluster running the
latest version of {es} that's compatible with both the index and your current
Expand Down
12 changes: 0 additions & 12 deletions docs/reference/snapshot-restore/snapshot-vers-compat.asciidoc

This file was deleted.

0 comments on commit 8717f2f

Please sign in to comment.