Docs Home → MongoDB Manual
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.
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, issue the following sequence of
|cfg = rs.conf()
|cfg.members.host = "mongo2.example.net"