@@ -59,7 +59,9 @@ GET _cluster/allocation/explain?filter_path=index,node_allocation_decisions.node
59
59
A shard can become unassigned for several reasons. The following tips outline the
60
60
most common causes and their solutions.
61
61
62
- **Re-enable shard allocation**
62
+ [discrete]
63
+ [[fix-cluster-status-reenable-allocation]]
64
+ ===== Re-enable shard allocation
63
65
64
66
You typically disable allocation during a <<restart-cluster,restart>> or other
65
67
cluster maintenance. If you forgot to re-enable allocation afterward, {es} will
@@ -76,7 +78,9 @@ PUT _cluster/settings
76
78
}
77
79
----
78
80
79
- **Recover lost nodes**
81
+ [discrete]
82
+ [[fix-cluster-status-recover-nodes]]
83
+ ===== Recover lost nodes
80
84
81
85
Shards often become unassigned when a data node leaves the cluster. This can
82
86
occur for several reasons, ranging from connectivity issues to hardware failure.
@@ -94,7 +98,9 @@ asynchronously in the background.
94
98
POST _cluster/reroute?metric=none
95
99
----
96
100
97
- **Fix allocation settings**
101
+ [discrete]
102
+ [[fix-cluster-status-allocation-settings]]
103
+ ===== Fix allocation settings
98
104
99
105
Misconfigured allocation settings can result in an unassigned primary shard.
100
106
These settings include:
@@ -117,7 +123,9 @@ GET _cluster/settings?flat_settings=true&include_defaults=true
117
123
You can change the settings using the <<indices-update-settings,update index
118
124
settings>> and <<cluster-update-settings,cluster update settings>> APIs.
119
125
120
- **Allocate or reduce replicas**
126
+ [discrete]
127
+ [[fix-cluster-status-allocation-replicas]]
128
+ ===== Allocate or reduce replicas
121
129
122
130
To protect against hardware failure, {es} will not assign a replica to the same
123
131
node as its primary shard. If no other data nodes are available to host the
@@ -138,7 +146,10 @@ PUT _settings
138
146
----
139
147
// TEST[s/^/PUT my-index\n/]
140
148
141
- **Free up or increase disk space**
149
+
150
+ [discrete]
151
+ [[fix-cluster-status-disk-space]]
152
+ ===== Free up or increase disk space
142
153
143
154
{es} uses a <<disk-based-shard-allocation,low disk watermark>> to ensure data
144
155
nodes have enough disk space for incoming shards. By default, {es} does not
@@ -194,13 +205,17 @@ PUT _cluster/settings
194
205
----
195
206
// TEST[s/"30gb"/null/]
196
207
197
- **Reduce JVM memory pressure**
208
+ [discrete]
209
+ [[fix-cluster-status-jvm]]
210
+ ===== Reduce JVM memory pressure
198
211
199
212
Shard allocation requires JVM heap memory. High JVM memory pressure can trigger
200
213
<<circuit-breaker,circuit breakers>> that stop allocation and leave shards
201
214
unassigned. See <<high-jvm-memory-pressure>>.
202
215
203
- **Recover data for a lost primary shard**
216
+ [discrete]
217
+ [[fix-cluster-status-restore]]
218
+ ===== Recover data for a lost primary shard
204
219
205
220
If a node containing a primary shard is lost, {es} can typically replace it
206
221
using a replica on another node. If you can't recover the node and replicas
0 commit comments