Skip to content

Commit ff7620f

Browse files
Fail start on obsolete indices documentation (#37786)
Added breaking changes documentation for node start up obsolete indices detection. Issue #27073
1 parent 4710a74 commit ff7620f

File tree

2 files changed

+17
-0
lines changed

2 files changed

+17
-0
lines changed

docs/reference/migration/migrate_7_0.asciidoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,7 @@ See also <<release-highlights>> and <<es-release-notes>>.
2626
* <<breaking_70_restclient_changes>>
2727
* <<breaking_70_low_level_restclient_changes>>
2828
* <<breaking_70_logging_changes>>
29+
* <<breaking_70_node_changes>>
2930

3031
[float]
3132
=== Indices created before 7.0
@@ -60,3 +61,4 @@ include::migrate_7_0/snapshotstats.asciidoc[]
6061
include::migrate_7_0/restclient.asciidoc[]
6162
include::migrate_7_0/low_level_restclient.asciidoc[]
6263
include::migrate_7_0/logging.asciidoc[]
64+
include::migrate_7_0/node.asciidoc[]
Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
[float]
2+
[[breaking_70_node_changes]]
3+
=== Node start up
4+
5+
[float]
6+
==== Nodes with left-behind data or metadata refuse to start
7+
Repurposing an existing node by changing node.master or node.data to false can leave lingering on-disk metadata and
8+
data around, which will not be accessible by the node's new role. Beside storing non-accessible data, this can lead
9+
to situations where dangling indices are imported even though the node might not be able to host any shards, leading
10+
to a red cluster health. To avoid this,
11+
12+
* nodes with on-disk shard data and node.data set to false will refuse to start
13+
* nodes with on-disk index/shard data and both node.master and node.data set to false will refuse to start
14+
15+
Beware that such role changes done prior to the 7.0 upgrade could prevent node start up in 7.0.

0 commit comments

Comments
 (0)