Browse Source

Clarify snapshot docs on archive indices (#88417)

Should remove confusion what to do with old archive indices.
Yannick Welsch 3 years ago
parent
commit
d666ddca1d

+ 1 - 2
docs/reference/snapshot-restore/cluster-index-compat.asciidoc

@@ -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}
 |====

+ 5 - 7
docs/reference/snapshot-restore/index.asciidoc

@@ -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.
 
@@ -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

+ 0 - 12
docs/reference/snapshot-restore/snapshot-vers-compat.asciidoc

@@ -1,12 +0,0 @@
-
-[cols="^,^,^,^,^"]
-|====
-| 4+^h| Cluster version
-h| Snapshot version         | 6.8        | 7.0–7.1    | 7.2–{prev-major-last} | 8.0–{minor-version}
-| 5.0–5.6                   | {yes-icon} | {no-icon}  | {no-icon}             | {no-icon}
-| 6.0–6.7                   | {yes-icon} | {yes-icon} | {yes-icon}            | {no-icon}
-| 6.8                       | {yes-icon} | {no-icon}  | {yes-icon}            | {no-icon}
-| 7.0–7.1                   | {no-icon}  | {yes-icon} | {yes-icon}            | {yes-icon}
-| 7.2–{prev-major-last}     | {no-icon}  | {no-icon}  | {yes-icon}            | {yes-icon}
-| 8.0–{minor-version}       | {no-icon}  | {no-icon}  | {no-icon}             | {yes-icon}
-|====