Adjust Priority for Replica Set Member¶
priority settings of replica set members affect both the timing
and the outcome of elections for
primary. Higher-priority members are more likely to call elections, and
are more likely to win. Use this setting to ensure that some members are
more likely to become primary and that others can never become primary.
To modify priorities, you update the
array in the replica configuration object. The array index begins with
0. Do not confuse this index value with the value of the replica
members[n]._id field in the
The value of
priority can be any
floating point (i.e. decimal) number between
default value for the
priority field is
For arbiters, the default
priority value is
1; however, arbiters cannot
become primary regardless of the configured value.
Adjust priority settings during a scheduled maintenance window. Reconfiguring priority can force the current primary to step down, leading to an election. Before an election, the primary closes all open client connections.
rs.reconfig()shell method can force the current primary to step down, which causes an election. When the primary steps down, the
mongodcloses all client connections. While this typically takes 10-20 seconds, try to make these changes during scheduled maintenance periods.
- Avoid reconfiguring replica sets that contain members of different MongoDB versions as validation rules may differ across MongoDB versions.
Change each member’s priority value.¶
cfg.members.priority = 0.5 cfg.members.priority = 2 cfg.members.priority = 2
This sequence of operations modifies the value of
cfg to set the
priority for the first three members defined in the