Rename a Replica Set

Shut down replica set members.

Follow the procedure in Stop a Replica Set to confirm that replica set members are shut down.

Rename the replica set.

Perform the following steps for each replica set member:

1. Start the replica set member on a different port without the --replSet option.

2. Update the replica set name.

   • If using a configuration file, set replication.replSetName to the new name.

   • If using the mongod startup command with the --replSet option, note down the new replica set name for use in step f.

3. Connect to the replica set member.

4. Update the replica set name in the local database with the following commands:

   /* Set `newId` to the new replica set name */
   var newId = '<new replica set name>'
   var doc = db.getSiblingDB("local").system.replset.findOne()
   var oldId = doc._id
   doc._id = newId
   db.getSiblingDB("local").system.replset.insertOne(doc)
   db.getSiblingDB("local").system.replset.deleteOne({_id: oldId})

5. Shut down the replica set member.

   Note

   Ops Manager

   If you are using Ops Manager, you must stop Ops Manager from managing the replica set before you shut down the replica set member. For more information on this procedure, see Remove a Process from Ops Management

6. Start the replica set member on its original port.

   • If using a configuration file, ensure that replication.replSetName is set to the new replica set name.

   • If using the mongod startup command with the --replSet option, pass the new name of the replica set to the --replSet option.