A master-eligible node is an Elasticsearch node assigned the master role. It is eligible to vote when the cluster elects a master and can become the elected master, but assigning the role does not make it the master immediately. A cluster has only one active master at a time. section 14.6 section 14.6.1
The active master handles cluster-wide work: allocating shards, managing indexes, and maintaining cluster state. Master-eligible nodes support this role by communicating with the master, detecting its loss, and starting an election when needed. section 14.6.1 section 14.6.2
Master-eligible nodes matter in three cluster decisions:
- Electing a replacement master when a cluster first forms or the current master dies. section 14.6.2
- Providing the quorum that the master consults for master elections and cluster-state updates. section 14.6.3 section 14.6.4
- Reducing split-brain risk by deploying at least three master-eligible nodes. section 14.6.5 section 14.7
Minimum number of master-eligible nodes = (number of master-eligible nodes / 2) + 1
A quorum is a majority of master-eligible nodes. The cluster forms it automatically; for eight eligible nodes, the displayed rule yields five nodes. section 14.6.4
Configure a dedicated master-eligible node
For a busy cluster, isolate cluster-management work on dedicated master-eligible nodes. Set the node role to master so the node is not overloaded with data or ingest work; use at least three dedicated master-eligible nodes as a rule of thumb. section 14.6.6 section 14.7
node.roles: [ master ]
This configuration assigns the master role, making the node eligible to participate in master elections and serve as a dedicated master. section 14.6.6
Keep master-eligible nodes available and responsive. If the master is considered unavailable, eligible nodes elect a replacement; a failed cluster-state publication can also trigger a new election. Dedicated masters help prevent cluster operations from slowing or stalling under heavy indexing or search load. section 14.6.3 section 15.3.1 section 14.6.6
