Introducing Dragonfly Cloud! Learn More

Question: How does MongoDB failover to secondary?


MongoDB, a popular NoSQL database, uses replica sets to ensure high availability and data redundancy. A replica set is a group of mongod instances that maintain the same data set. Failover is a critical feature in MongoDB's replica sets, ensuring that the database remains available even when the primary node goes down. Here's how MongoDB handles failover to a secondary node:

Automatic Failover Process

  1. Election of a New Primary: When the current primary server becomes unavailable, the remaining secondary members hold an election to choose a new primary from amongst themselves.
  2. Criteria for Election: The election process considers factors like replication lag, network latency, and member priority settings. The member with the most up-to-date data, highest priority, and lowest ping time usually wins the election.
  3. Transition: Once a new primary is elected, it begins to accept write operations. Clients connected to the old primary automatically reconnect to the new one, assuming they're configured to connect to the replica set rather than a specific instance.

Code Example for Configuring Replica Set

While you don't need to manually code anything for MongoDB to handle failover (as it's managed automatically by MongoDB's internal processes), here's an example of how you might initiate a replica set configuration which is foundational for enabling automatic failover:

// Initiate a replica set with three members rs.initiate({ _id: 'rs0', members: [ { _id: 0, host: '' }, { _id: 1, host: '' }, { _id: 2, host: '' } ] })

This JavaScript snippet is meant to be run in the MongoDB shell. It initializes a replica set named rs0 with three members. Replace the host values with your actual MongoDB instance addresses.

Best Practices for Smooth Failovers

  • Set Appropriate Priority Levels: Adjust the priority settings of each replica set member to influence which nodes are more likely to be elected as primary.
  • Monitor Replication Lag: Keep an eye on replication lag using MongoDB monitoring tools. Large lags can delay failovers or result in elections that choose less ideal primaries.
  • Maintain Odd Number of Voting Members: An odd number of voting members helps prevent split-brain scenarios and ensures elections can resolve cleanly without a tie.

In conclusion, MongoDB's failover mechanism is designed to provide high availability through automatic elections within a replica set. Proper configuration and monitoring of your MongoDB environment are key to ensuring that failovers occur smoothly and swiftly when necessary.

Was this content helpful?

White Paper

Free System Design on AWS E-Book

Download this early release of O'Reilly's latest cloud infrastructure e-book: System Design on AWS.

Free System Design on AWS E-Book

Start building today 

Dragonfly is fully compatible with the Redis ecosystem and requires no code changes to implement.