Skip to content

Commit c0b13c7

Browse files
committed
Add warning about restart migration (#116769)
We have gotten more than one SDH due to customers not understanding why restarts involving fully-mounted indices can pull a lot of data from the snapshot tier, so it may help to be more explicit about why this happens and how it can be avoided.
1 parent 0c4b256 commit c0b13c7

File tree

1 file changed

+10
-2
lines changed

1 file changed

+10
-2
lines changed

docs/reference/searchable-snapshots/index.asciidoc

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -176,10 +176,10 @@ nodes that have a shared cache.
176176
====
177177
Manually mounting snapshots captured by an Index Lifecycle Management ({ilm-init}) policy can
178178
interfere with {ilm-init}'s automatic management. This may lead to issues such as data loss
179-
or complications with snapshot handling.
179+
or complications with snapshot handling.
180180
181181
For optimal results, allow {ilm-init} to manage
182-
snapshots automatically.
182+
snapshots automatically.
183183
184184
<<ilm-searchable-snapshot,Learn more about {ilm-init} snapshot management>>.
185185
====
@@ -293,6 +293,14 @@ repository. If you wish to search data across multiple regions, configure
293293
multiple clusters and use <<modules-cross-cluster-search,{ccs}>> or
294294
<<xpack-ccr,{ccr}>> instead of {search-snaps}.
295295

296+
It's worth noting that if a searchable snapshot index has no replicas, then when the node
297+
hosting it is shut down, allocation will immediately try to relocate the index to a new node
298+
in order to maximize availability. For fully mounted indices this will result in the new node
299+
downloading the entire index snapshot from the cloud repository. Under a rolling cluster restart,
300+
this may happen multiple times for each searchable snapshot index. Temporarily
301+
disabling allocation during planned node restart will prevent this, as described in
302+
the <<restart-cluster-rolling,cluster restart procedure>>.
303+
296304
[discrete]
297305
[[back-up-restore-searchable-snapshots]]
298306
=== Back up and restore {search-snaps}

0 commit comments

Comments
 (0)