- Replication >
- Replica Set Maintenance Tutorials >
- Rename a Replica Set
Rename a Replica Set¶
On this page
To rename a replica set, you must shut down all members of the replica
set, then configure each member’s local
database with the new
replica set name.
This procedure requires downtime.
Prerequisites¶
- Ensure your replica set is not sharded. The renaming procedure is for unsharded replica sets only.
- Before renaming a replica set, perform a full backup of your MongoDB deployment.
Procedure¶
1
Shut down replica set members.¶
Follow the procedure in Stop a Replica Set to confirm that replica set members are shut down.
Warning
This step requires downtime as all replica members will need to be shut down.
2
Rename the replica set.¶
Perform the following steps for each replica set member:
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.
- If using a configuration file, set
Start the replica set member on a different port without the
--replSet
option.Connect to the replica set member.
Update the replica set name in the local database with the following commands:
Shut down the replica set member.
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.
- If using a configuration file, ensure that