Skip to content

Commit d666ddc

Browse files
authored
Clarify snapshot docs on archive indices (#88417)
Should remove confusion what to do with old archive indices.
1 parent 6e4cb3d commit d666ddc

File tree

3 files changed

+6
-21
lines changed

3 files changed

+6
-21
lines changed

docs/reference/snapshot-restore/cluster-index-compat.asciidoc

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,5 @@ h| Index creation version | 6.8 | 7.0–7.1 | 7.2–{prev-major-last
88
| 6.8 | {yes-icon} | {no-icon} | {yes-icon} | {no-icon} | {yes-icon}footnote:archive[]
99
| 7.0–7.1 | {no-icon} | {yes-icon} | {yes-icon} | {yes-icon} | {yes-icon}
1010
| 7.2–{prev-major-last} | {no-icon} | {no-icon} | {yes-icon} | {yes-icon} | {yes-icon}
11-
| 8.0–8.2 | {no-icon} | {no-icon} | {no-icon} | {yes-icon} | {yes-icon}
12-
| 8.3–{minor-version} | {no-icon} | {no-icon} | {no-icon} | {yes-icon} | {yes-icon}
11+
| 8.0–{minor-version} | {no-icon} | {no-icon} | {no-icon} | {yes-icon} | {yes-icon}
1312
|====

docs/reference/snapshot-restore/index.asciidoc

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -113,8 +113,6 @@ any restored indices must be compatible.
113113
[[snapshot-cluster-compatibility]]
114114
=== Snapshot version compatibility
115115

116-
include::snapshot-vers-compat.asciidoc[]
117-
118116
You can't restore a snapshot to an earlier version of {es}. For example, you
119117
can't restore a snapshot taken in 7.6.0 to a cluster running 7.5.0.
120118

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

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

157155
As a workaround, you can first restore the index to another cluster running the
158156
latest version of {es} that's compatible with both the index and your current

docs/reference/snapshot-restore/snapshot-vers-compat.asciidoc

Lines changed: 0 additions & 12 deletions
This file was deleted.

0 commit comments

Comments
 (0)