Navigation
This version of the documentation is archived and no longer supported.

Force a Member to Become Primary

Overview

You can force a replica set member to become primary by giving it a higher priority value than any other member in the set.

Optionally, you also can force a member never to become primary by setting its priority value to 0, which means the member can never seek election as primary. For more information, see Priority 0 Replica Set Members.

For more information on priorities, see priority.

Consideration

A majority of the configured members of a replica set must be available for a set to reconfigure a set or elect a primary. See Replica Set Elections for more information.

Procedures

Force a Member to be Primary by Setting its Priority High

This procedure assumes your current primary is m1.example.net and that you’d like to instead make m3.example.net primary. The procedure also assumes you have a three-member replica set with the configuration below. For more information on configurations, see Replica Set Configuration Use.

This procedure assumes this configuration:

{
    "_id" : "rs",
    "version" : 7,
    "members" : [
        {
            "_id" : 0,
            "host" : "m1.example.net:27017"
        },
        {
            "_id" : 1,
            "host" : "m2.example.net:27017"
        },
        {
            "_id" : 2,
            "host" : "m3.example.net:27017"
        }
    ]
}
  1. In a mongo shell connected to the primary, use the following sequence of operations to make m3.example.net the primary:

    cfg = rs.conf()
    cfg.members[0].priority = 0.5
    cfg.members[1].priority = 0.5
    cfg.members[2].priority = 1
    rs.reconfig(cfg)
    

    The last statement calls rs.reconfig() with the modified configuration document to configure m3.example.net to have a higher local.system.replset.members[n].priority value than the other mongod instances.

    The following sequence of events occur:

    • m3.example.net and m2.example.net sync with m1.example.net (typically within 10 seconds).
    • m1.example.net sees that it no longer has highest priority and, in most cases, steps down. m1.example.net does not step down if m3.example.net’s sync is far behind. In that case, m1.example.net waits until m3.example.net is within 10 seconds of its optime and then steps down. This minimizes the amount of time with no primary following failover.
    • The step down forces on election in which m3.example.net becomes primary based on its priority setting.
  2. Optionally, if m3.example.net is more than 10 seconds behind m1.example.net’s optime, and if you don’t need to have a primary designated within 10 seconds, you can force m1.example.net to step down by running:

    db.adminCommand({replSetStepDown: 86400, force: 1})
    

    This prevents m1.example.net from being primary for 86,400 seconds (24 hours), even if there is no other member that can become primary. When m3.example.net catches up with m1.example.net it will become primary.

    If you later want to make m1.example.net primary again while it waits for m3.example.net to catch up, issue the following command to make m1.example.net seek election again:

    rs.freeze()
    

    The rs.freeze() provides a wrapper around the replSetFreeze database command.

Force a Member to be Primary Using Database Commands

Changed in version 1.8.

Consider a replica set with the following members:

  • mdb0.example.net - the current primary.
  • mdb1.example.net - a secondary.
  • mdb2.example.net - a secondary .

To force a member to become primary use the following procedure:

  1. In a mongo shell, run rs.status() to ensure your replica set is running as expected.

  2. In a mongo shell connected to the mongod instance running on mdb2.example.net, freeze mdb2.example.net so that it does not attempt to become primary for 120 seconds.

    rs.freeze(120)
    
  3. In a mongo shell connected the mongod running on mdb0.example.net, step down this instance that the mongod is not eligible to become primary for 120 seconds:

    rs.stepDown(120)
    

    mdb1.example.net becomes primary.

    Note

    During the transition, there is a short window where the set does not have a primary.

For more information, consider the rs.freeze() and rs.stepDown() methods that wrap the replSetFreeze and replSetStepDown commands.