Skip to content

Commit 509507d

Browse files
author
Adam Locke
authored
Removing wording indicating that read-only index block is released automatically. (#62627)
1 parent e4e4aab commit 509507d

File tree

2 files changed

+9
-8
lines changed

2 files changed

+9
-8
lines changed

docs/reference/index-modules.asciidoc

+8-7
Original file line numberDiff line numberDiff line change
@@ -156,13 +156,14 @@ specific index module:
156156

157157
`index.blocks.read_only_allow_delete`::
158158

159-
Similar to `index.blocks.read_only`, but also allows deleting the index to
160-
make more resources available. The <<disk-allocator,disk-based shard
161-
allocator>> may add and remove this block automatically.
162-
163-
Deleting documents from an index to release resources - rather than deleting the index itself - can increase the index size over time. When `index.blocks.read_only_allow_delete` is set to `true`, deleting documents is not permitted. However, deleting the index itself releases the read-only index block and makes resources available almost immediately.
164-
165-
IMPORTANT: {es} adds and removes the read-only index block automatically when the disk utilization falls below the high watermark, controlled by <<cluster-routing-flood_stage,cluster.routing.allocation.disk.watermark.flood_stage>>.
159+
Similar to `index.blocks.read_only`, but also allows deleting the index to
160+
make more resources available.
161+
+
162+
Deleting documents from an index to release resources - rather than deleting
163+
the index itself - can increase the index size over time. When
164+
`index.blocks.read_only_allow_delete` is set to `true`, deleting documents is
165+
not permitted. However, deleting the index itself releases the read-only index
166+
block and makes resources available almost immediately.
166167

167168
`index.blocks.read`::
168169

docs/reference/modules/cluster/disk_allocator.asciidoc

+1-1
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ Controls the flood stage watermark, which defaults to 95%. {es} enforces a read-
4040
(`index.blocks.read_only_allow_delete`) on every index that has one or more
4141
shards allocated on the node, and that has at least one disk exceeding the flood
4242
stage. This setting is a last resort to prevent nodes from running out of disk space.
43-
The index block is automatically released when the disk utilization falls below
43+
The index block must be released manually when the disk utilization falls below
4444
the high watermark.
4545

4646
NOTE: You cannot mix the usage of percentage values and byte values within

0 commit comments

Comments
 (0)