将分片集群升级至 5.0

禁用负载均衡器。

将 mongosh 连接到分片集群中的 mongos 实例，然后运行 sh.stopBalancer() 以禁用负载均衡器：

sh.stopBalancer()

要验证是否禁用了负载均衡器，请运行 sh.getBalancerState()；如果已禁用负载均衡器，则会返回 false：

sh.getBalancerState()

有关禁用负载均衡器的更多信息，请参阅禁用负载均衡器。

升级配置服务器。

1. 逐个升级副本集的从节点成员：

   1. 关闭从节点 mongod 实例，并将 4.4 二进制文件替换为 5.0 二进制文件。

   2. 使用 --configsvr、--replSet 和 --port 选项启动 5.0 二进制文件。包括部署使用的任何其他选项。

      mongod --configsvr --replSet <replSetName> --port <port> --dbpath <path> --bind_ip localhost,<ip address>

      如果使用配置文件，请更新文件以指定 sharding.clusterRole: configsvr、replication.replSetName、net.port 和 net.bindIp，然后启动 5.0二进制：

      sharding:
         clusterRole: configsvr
      replication:
         replSetName: <string>
      net:
         port: <port>
         bindIp: localhost,<ip address>
      storage:
         dbpath: <path>

      包括适合您部署的任何其他设置。

   3. 等待成员恢复到 SECONDARY 状态，然后再升级下一个从节点成员。要检查成员状态，请在 mongosh 中发出 rs.status()。

      对每个从节点重复上述步骤。

2. 降级副本集主节点。

   1. 将 mongosh 连接到主节点，并使用 rs.stepDown() 降低主节点，强制选举新的主节点：

      rs.stepDown()

   2. 当 rs.status() 显示主节点已降级，并且另一个节点已显示为 PRIMARY 状态时，关闭降级的主节点，并将 mongod 二进制文件替换为 5.0 二进制文件。

   3. 使用 --configsvr、--replSet、--port 和 --bind_ip 选项启动 5.0 二进制文件。包括先前部署中使用的任何可选命令行选项：

      mongod --configsvr --replSet <replSetName> --port <port> --dbpath <path> --bind_ip localhost,<ip address>

      如果使用配置文件，请更新文件以指定 sharding.clusterRole: configsvr、replication.replSetName、net.port 和 net.bindIp，然后启动 5.0二进制：

      sharding:
         clusterRole: configsvr
      replication:
         replSetName: <string>
      net:
         port: <port>
         bindIp: localhost,<ip address>
      storage:
         dbpath: <path>

      包括适合您的部署的任何其他配置。

升级分片。

一次升级一个分片。

对于每个分片副本集：

1. 逐个升级副本集的从节点成员：

   1. 关闭 mongod 实例，并将 4.4 二进制文件替换为 5.0 二进制文件。

   2. 使用 --shardsvr、--replSet、--port 和 --bind_ip 选项启动 5.0 二进制文件。根据您的部署包含任何其他合适的命令行选项：

      mongod --shardsvr --replSet <replSetName> --port <port> --dbpath <path> --bind_ip localhost,<ip address>

      如果使用配置文件，请更新文件以包括 sharding.clusterRole: shardsvr、replication.replSetName、net.port 和 net.bindIp，然后启动 5.0 二进制文件：

      sharding:
         clusterRole: shardsvr
      replication:
         replSetName: <string>
      net:
         port: <port>
         bindIp: localhost,<ip address>
      storage:
         dbpath: <path>

      包括适合您的部署的任何其他配置。

   3. 等待成员恢复到 SECONDARY 状态，然后再升级下一个从节点成员。要检查节点状态，可以在 mongosh 中发出 rs.status()。

      对每个从节点重复上述步骤。

2. 降级副本集主节点。

   将 mongosh 连接到主节点，并使用 rs.stepDown() 降低主节点，强制选举新的主节点：

   rs.stepDown()

3. 当 rs.status() 显示主节点已降级，并且另一个成员已显示为 PRIMARY 状态时，升级已降级的主节点：

   1. 关闭降级主节点，并用 5.0 二进制文件替换mongod二进制文件。

   2. 使用 --shardsvr、--replSet、--port 和 --bind_ip 选项启动 5.0 二进制文件。根据您的部署包含任何其他合适的命令行选项：

      mongod --shardsvr --replSet <replSetName> --port <port> --dbpath <path> --bind_ip localhost,<ip address>

      如果使用配置文件，请更新文件以指定 sharding.clusterRole: shardsvr、replication.replSetName、net.port 和 net.bindIp，然后启动 5.0二进制：

      sharding:
         clusterRole: shardsvr
      replication:
         replSetName: <string>
      net:
         port: <port>
         bindIp: localhost,<ip address>
      storage:
         dbpath: <path>

      包括适合您的部署的任何其他配置。

mongos升级 实例。

将每个 mongos 实例替换为 5.0 二进制文件并重新启动。包括适合您部署的任何其他配置。

mongos --configdb csReplSet/<rsconfigsver1:port1>,<rsconfigsver2:port2>,<rsconfigsver3:port3> --bind_ip localhost,<ip address>

重新启用负载均衡器。

使用 mongosh 连接到集群中的 mongos，然后运行 sh.startBalancer() 重新启用负载均衡器：

sh.startBalancer()

从 MongoDB 6.0.3 开始，不再执行自动数据块分割。这是因为均衡策略的改进。自动分割命令仍然存在，但不执行操作。有关详细信息，请参阅均衡策略变更。

在 6.0.3 之前的 MongoDB 版本中，sh.startBalancer() 还支持分片集群的自动拆分。

如果您不希望在启用负载均衡器时启用自动分割，则还必须运行 sh.disableAutoSplit()。

有关重新启用负载均衡器的更多信息，请参阅启用负载均衡器。

启用向后不兼容的 5.0 功能。

此时，您可以运行 5.0 二进制文件，而不使用与 4.4 不兼容的 5.0 功能。

要启用这些 5.0 功能，请将功能兼容性版本 (fCV) 设置为 5.0。

在 mongos 实例中，在 admin 数据库中运行 setFeatureCompatibilityVersion 命令：

db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } )

设置featureCompatibilityVersion (fCV) : " 5 . 0 "会在每个分片上隐式执行replSetReconfig ，以将term字段添加到分片副本配置文档中。

直到新配置传播到大多数副本集成员后，该命令才会完成。

此命令必须执行对内部系统集合的写入。如果由于任何原因命令未能成功完成，您可以安全地在 mongos 上重试该命令，因为该操作是幂等的。

当您将 setFeatureCompatibilityVersion 设置为 5.0 时，分片上存在的所有孤立文档都将被清除。清除过程：

• 不阻止升级完成，并且

• 速率是否受到限制。要减轻清理孤立文档期间对性能的潜在影响，请参阅范围删除性能优化。