- Replication >
- Replica Set Tutorials >
- Replica Set Deployment Tutorials >
- Remove Members from Replica Set
Remove Members from Replica Set¶
To remove a member of a replica set use either of the following procedures.
Remove a Member Using rs.remove()
¶
Connect to the replica set’s current primary. To determine the current primary, use
db.isMaster()
while connected to any member of the replica set.Use
rs.remove()
in either of the following forms to remove a member:Shut down the
mongod
instance for the member you removed. To shut down the instance, connect using themongo
shell and thedb.shutdownServer()
method.
Remove a Member Using rs.reconfig()
¶
To remove a member you can manually edit the replica set configuration document, as described here.
Connect to the replica set’s current primary. To determine the current primary, use
db.isMaster()
while connected to any member of the replica set.Issue the
rs.conf()
method to view the current configuration document and determine the position in themembers
array of the member to remove:Example
mongod_C.example.net
is in position2
of the following configuration file:Assign the current configuration document to the variable
cfg
:Modify the
cfg
object to remove the member.Example
To remove
mongod_C.example.net:27017
use the following JavaScript operation:Overwrite the replica set configuration document with the new configuration by issuing the following:
As a result of
rs.reconfig()
the shell may disconnect while the replica set renegotiates which member is primary. The shell displays aDBClientCursor::init call() failed
error even though the command succeeds, and will automatically reconnected.To confirm the new configuration, issue
rs.conf()
.For the example above the output would be:
Shut down the
mongod
instance for the member you removed. To shut down the instance, connect using themongo
shell and thedb.shutdownServer()
method.