From fc50e17753f170dde1a022afba3da5676d4deec9 Mon Sep 17 00:00:00 2001 From: gadekishore <50092970+gadekishore@users.noreply.github.com> Date: Tue, 25 Aug 2020 09:41:04 +1000 Subject: [PATCH] updated shard limit doc (#56496) * updated shard limit doc As the documentation was not so clear. I have updated saying this limit includes open indices with unassigned primaries and replicas count towards the limit. * [DOCS] Incorporated edits. Co-authored-by: Deb Adair --- docs/reference/modules/cluster/misc.asciidoc | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/reference/modules/cluster/misc.asciidoc b/docs/reference/modules/cluster/misc.asciidoc index 0b969a552c3c4..ae8c31318d449 100644 --- a/docs/reference/modules/cluster/misc.asciidoc +++ b/docs/reference/modules/cluster/misc.asciidoc @@ -45,20 +45,20 @@ either the limit is increased as described below, or some indices are <> or <> to bring the number of shards below the limit. -Replicas count towards this limit, but closed indexes do not. An index with 5 -primary shards and 2 replicas will be counted as 15 shards. Any closed index -is counted as 0, no matter how many shards and replicas it contains. +The cluster shard limit defaults to 1,000 shards per data node. +Both primary and replica shards of all open indices count toward the limit, +including unassigned shards. +For example, an open index with 5 primary shards and 2 replicas counts as 15 shards. +Closed indices do not contribute to the shard count. -The limit defaults to 1,000 shards per data node, and can be dynamically -adjusted using the following property: +You can dynamically adjust the cluster shard limit with the following property: `cluster.max_shards_per_node`:: Controls the number of shards allowed in the cluster per data node. -For example, a 3-node cluster with the default setting would allow 3,000 shards -total, across all open indexes. If the above setting is changed to 500, then -the cluster would allow 1,500 shards total. +With the default setting, a 3-node cluster allows 3,000 shards total, across all open indexes. +If you reduce the limit to 500, the cluster would allow 1,500 shards total. NOTE: If there are no data nodes in the cluster, the limit will not be enforced. This allows the creation of indices during cluster creation if dedicated master