Docs Menu

Docs HomeDevelop ApplicationsMongoDB Manual

replSetFreeze

On this page

  • Definition
  • Compatibility
  • Syntax
  • Behavior
replSetFreeze

The replSetFreeze command prevents a replica set member from seeking election for the specified number of seconds. Use this command in conjunction with the replSetStepDown command to make a different node in the replica set a primary.

Tip

In mongosh, this command can also be run through the rs.freeze() helper method.

Helper methods are convenient for mongosh users, but they may not return the same level of information as database commands. In cases where the convenience is not needed or the additional return fields are required, use the database command.

This command is available in deployments hosted in the following environments:

  • MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

Note

This command has limited support in M0, M2, M5, and M10 clusters. For more information, see Unsupported Commands.

The command has the following syntax:

db.runCommand(
{
replSetFreeze: <seconds>
}
)

If you want to unfreeze a replica set member before the specified number of seconds has elapsed, you can issue the command with a seconds value of 0:

db.runCommand(
{
replSetFreeze: 0
}
)

Restarting the mongod process also unfreezes a replica set member.

replSetFreeze is an administrative command, and you must issue it against the admin database.

←  replSetAbortPrimaryCatchUpreplSetGetConfig →