Skip to content

Commit 1bbd571

Browse files
committed
Add warning about restart migration
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 90d8d7b commit 1bbd571

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 (as is the default
297+
in the cold tier), then when the node hosting it is shut down, allocation will immediately
298+
try to relocate the index to a new node in order to maximize availability. For fully mounted
299+
indices this will result in the new node downloading the entire index snapshot from
300+
the cloud repository, which might be expensive especially during rolling restarts. 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)