重命名自管理副本集

重命名自管理副本集

本页内容

先决条件

步骤

要重命名副本集，您必须关闭副本集的所有成员，然后配置每个成员的local 数据库使用新的副本集名称。

此过程需要停机。

先决条件

确保您的副本集不是分片。重命名过程仅适用于非分片副本集。
在重命名副本集之前，请执行您的 MongoDB 部署的完整备份.
当启用认证时，请确保您的用户角色在每个成员的 local 数据库中的 system.replset 集合上具有 find、insert 和 remove 权限。
提示
您可以通过使用 rolesInfo 命令并设置 showPrivileges 和 showBuiltinRoles 字段都为 true 来查看角色的权限。

过程

1

关闭副本集成员。

按照停止副本集中的步骤进行操作，以确认副本集成员已关闭。

警告

此步骤需要停机，因为所有副本集成员都需要关闭。

2

重命名副本集。

为每个副本集成员执行以下步骤

在不使用 --replSet 选项的情况下，在另一个端口上启动副本集成员。
更新副本集名称。
- 如果使用配置文件，将 replication.replSetName 设置为新名称。
- 如果使用带有 mongod 启动命令和 --replSet 选项，记录新的副本集名称以供步骤 f 使用。
连接到副本集成员。

使用以下命令在 local 数据库中更新副本集名称

/* 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})

关闭副本集成员。
注意
运维管理器
如果您使用运维管理器，在关闭副本集成员之前，必须停止运维管理器对副本集的管理。有关此过程的更多信息，请参阅从运维管理中移除进程
在原始端口上启动副本集成员。
- 如果使用配置文件，请确保 replication.replSetName 设置为新副本集名称。
- 如果使用带有 mongod 启动命令和 --replSet 选项，将副本集的新名称传递给 --replSet 选项。