Skip to content

Commit eaa652b

Browse files
Fail start on obsolete indices documentation
Improved documentation on when nodes will refuse to start up. Issue elastic#27073
1 parent e768136 commit eaa652b

File tree

3 files changed

+17
-21
lines changed

3 files changed

+17
-21
lines changed

docs/reference/migration/migrate_7_0.asciidoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +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_start>>
29+
* <<breaking_70_node_changes>>
3030

3131
[float]
3232
=== Indices created before 7.0
@@ -61,4 +61,4 @@ include::migrate_7_0/snapshotstats.asciidoc[]
6161
include::migrate_7_0/restclient.asciidoc[]
6262
include::migrate_7_0/low_level_restclient.asciidoc[]
6363
include::migrate_7_0/logging.asciidoc[]
64-
include::migrate_7_0/node_start.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.

docs/reference/migration/migrate_7_0/node_start.asciidoc

Lines changed: 0 additions & 19 deletions
This file was deleted.

0 commit comments

Comments
 (0)