replSetReconfig

全局写关注

从 MongoDB 5.0 开始，在尝试使用更改隐式默认写关注的配置重新配置副本集之前，您必须显式设置全局默认写关注。要设置全局默认写关注，请使用 setDefaultRWConcern 命令。

term 副本配置字段

term 字段是由主副本集节点设置的。如果在 replSetReconfig 操作中进行显式设置，主节点将忽略 term 字段。

重新配置可以一次添加或删除不超过一个投票节点

replSetReconfig 默认情况下，允许一次添加或删除不超过 1voting 个节点。例如，新配置最多可以对集群 membership 进行以下更改之一：

• 添加新的投票副本集节点。

• 删除现有的投票副本集成员。

• 修改现有副本集节点的 votes。

要添加或删除多个投票成员，请发出一系列 replSetReconfig 操作，每次添加或删除一个成员。

发出 force 重新配置将立即安装新配置，即使它添加或删除多个投票节点。force 重新配置可能会导致意外行为，例如，回滚 "majority" 提交的写入操作。

重新配置一直等到大多数节点安装副本配置

replSetReconfig 等待大多数投票副本集成员安装新的副本配置，才会返回成功。投票成员是任何 members[n].votes 为 1 的副本集成员，包括仲裁节点。

副本集节点通过心跳传播其副本配置。每当节点发现具有更高 version 和 term 的配置时，它就会安装新配置。重新配置过程具有两个不同的“等待”阶段：

1）等待提交当前配置，再安装新配置。

“当前”配置是指在发出 replSetReconfig 时主节点使用的副本配置。

在以下情况下，将提交配置：

• 大多数投票副本集节点都安装了当前配置，并且

• 所有在先前配置中以 "majority" 提交的写入也已复制到当前配置中的多数。

通常，当前配置已安装在大多数投票副本集节点上。不过，以前配置中的大多数提交的写入可能不会在当前配置中全部提交。Delayed节点或 lagging behind主节点的节点可能会增加在该阶段所花的时间。

如果发出的操作具有 maxTimeMS 限制，并且 该操作在等待时超过该限制，该操作将返回错误并丢弃新配置。该限制是累积性的，在进入下一阶段后不会进行重置。

2）等待新配置中的大多数投票成员安装新配置。

“新”配置是指为 replSetReconfig 指定的副本配置。

主节点安装并开始使用新的副本配置，再将配置传播给其余副本集节点。该操作只需等待多数投票成员安装新配置，而无需等待提交新配置。

如果发出的操作具有 maxTimeMS 限制，并且操作在等待时超过该限制，则操作将返回错误，但会继续使用和传播新配置。

无论以前配置的提交状态如何，发出 force 重新配置将立即安装新配置。force 重新配置可能会导致意外行为，例如，回滚 "majority" 提交的写入操作。

要检查当前副本配置的提交状态，请在副本集主节点使用 commitmentStatus 参数发出 replSetGetConfig。

对副本集中新的投票节点的自动重新配置

从 MongoDB 5.0 开始，新添加的从节点在未达到 SECONDARY 状态之前将不被计为投票节点，并且无法被选为主节点。

When a new voting node is added to a replica set, replSetReconfig will internally add a newlyAdded field to the node's configuration. Nodes with the newlyAdded field do not count towards the current number of voting nodes. When initial sync completes and the node reaches SECONDARY state, the newlyAdded field is automatically removed.

访问控制

To run the command on deployments that enforce access control, the user must have replSetConfigure privilege action on the cluster resource. The clusterManager built-in role, available in the admin database, provides the required privileges for this command.

锁定行为

replSetReconfig 获取特殊的独占锁，防止同时发生多个 replSetReconfig 操作。

混合版本的副本集

可用性

A majority of the set's members must be operational for the changes to propagate properly.

replSetReconfig can trigger the current primary to step down in some situations. Primary step-down triggers an 选举 to select a new 主节点:

• When the new primary steps up, it increments the term field to distinguish configuration changes made on the new primary from changes made on the previous primary.

• When the primary steps down, it no longer closes all client connections; however, writes that were in progress are killed. For details, see 行为.

假设采用默认 replica configuration settings（副本配置设置），那么集群选举新的主节点之前的平均时间通常不应超过 12 秒。这包括将主节点标记为不可用以及召集和完成选举所需的时间。您可以通过修改 settings.electionTimeoutMillis 复制配置选项来调整该时间段。网络延迟等因素可能会延长副本集选举完成所需的时间，这反过来又会影响集群在没有主节点的情况下运行的时间。这些因素取决于具体集群架构。

在选举进程期间，集群不能接受写操作，直到选举出新的主节点。

您的应用程序连接逻辑应包括对自动故障转移和后续选举的容忍度。MongoDB 驱动程序可检测到主节点丢失，并一次性自动重试某些写入操作，从而为自动故障转移和选举提供额外的内置处理功能：

兼容的驱动程序将默认启用可重试写入

要进一步降低对生产集群的潜在影响，请仅在计划维护期间重新配置。

{ force: true }

删除成员后，删除传出连接

Using replSetReconfig to remove a replica set member does not automatically drop open outgoing connections from other replica set members to the removed member.

默认情况下，副本集节点等待 5 分钟，然后再删除到删除的节点的连接。在分片副本集中，您可以使用 ShardingTaskExecutorPoolHostTimeoutMS 服务器参数修改该超时。

要立即删除从副本集到已删除成员的所有传出连接，请对副本集的每个剩余成员运行 dropConnections 管理命令：

db.adminCommand(
  {
    "dropConnections" : 1,
    "hostAndPort" : [
      "<hostname>:<port>"
    ]
  }
)

将 <hostname> 和 <port> 替换为已删除成员的值。

节点优先级和投票

• priority 大于 0 的节点不能有 0votes。

• 非投票（即 votes 是 0) 节点的 priority 必须为 0。