Docs Menu

Docs HomeDevelop ApplicationsMongoDB Manual

Replace a Replica Set Member

On this page

  • Operation
  • Example

If you need to change the hostname of a replica set member without changing the configuration of that member or the set, you can use the operation outlined in this tutorial. For example if you must re-provision systems or rename hosts, you can use this pattern to minimize the scope of that change.

To change the hostname for a replica set member modify the members[n].host field. The value of members[n]._id field will not change when you reconfigure the set.

See Replica Set Configuration and rs.reconfig() for more information.

Note

Any replica set configuration change can trigger the current primary to step down, which forces an election. During the election, the current shell session and clients connected to this replica set disconnect, which produces an error even when the operation succeeds.

To change the hostname to mongo2.example.net for the replica set member configured at members[0], issue the following sequence of commands:

cfg = rs.conf()
cfg.members[0].host = "mongo2.example.net"
rs.reconfig(cfg)
←  Remove Members from Replica SetMember Configuration Tutorials →

On this page