Skip to content

Commit 9348907

Browse files
Fail start on obsolete indices documentation
Added breaking changes documentation for node start up obsolete indices detection. Issue elastic#27073
1 parent fdb6603 commit 9348907

File tree

2 files changed

+21
-0
lines changed

2 files changed

+21
-0
lines changed

docs/reference/migration/migrate_7_0.asciidoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@ See also <<release-highlights>> and <<es-release-notes>>.
2525
* <<breaking_70_snapshotstats_changes>>
2626
* <<breaking_70_restclient_changes>>
2727
* <<breaking_70_low_level_restclient_changes>>
28+
* <<breaking_70_node_start>>
2829

2930
[float]
3031
=== Indices created before 7.0
@@ -58,3 +59,4 @@ include::migrate_7_0/scripting.asciidoc[]
5859
include::migrate_7_0/snapshotstats.asciidoc[]
5960
include::migrate_7_0/restclient.asciidoc[]
6061
include::migrate_7_0/low_level_restclient.asciidoc[]
62+
include::migrate_7_0/node_start.asciidoc[]
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
[float]
2+
[[breaking_70_node_start]]
3+
=== Node start up
4+
5+
[float]
6+
==== Node start up detects and fails on obsolete indices
7+
To avoid importing obsolete dangling indices, node start up will fail in following two situations:
8+
9+
* Starting up a non-data node that has shard data (e.g. dedicated master node or coordinating-only node)
10+
* Starting up a non-data, non-master node that has index metadata.
11+
12+
This situation should only occur if the settings node.data or node.master have been changed. Following are the primary
13+
situations to be aware of:
14+
15+
* A node previously configured as node.data=true and node.master=true is changed to node.data=false
16+
* A node previously configured as node.data=false and node.master=true is changed to node.master=false
17+
* A node previously configured as node.data=true and node.master=false is changed to node.data=false and node.master=true
18+
19+
Beware that such changes done prior to the 7.0 upgrade could prevent starting nodes.

0 commit comments

Comments
 (0)