将 8.2 分片集群升级到 8.3

禁用负载均衡器

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

sh.stopBalancer()

sh.getBalancerState()

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

升级配置服务器

1. 升级从节点(secondary node from replica set)副本集的从节点，一次一个。

   1. 关闭从节点实例。

      要关闭 mongod 进程，请使用 mongosh 连接到集群节点，并运行以下命令：

      db.adminCommand( { shutdown: 1 } )

   2. 将 8.2 二进制文件替换为 8.3 二进制文件。

   3. 启动 8.3 二进制文件。

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

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

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

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

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

   4. 等待成员恢复到SECONDARY状态，然后再升级下一个从从节点(secondary node from replica set)成员。

      要检查成员状态，请在 mongosh 中发出 rs.status()。

2. 降级副本集主节点。

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

      rs.stepDown()

   2. 关闭降级主节点。

      当 rs.status() 显示主节点已降级，并且另一个节点已显示为 PRIMARY 状态时，关闭已降级的主节点。

      要关闭已降级的主节点，请使用 mongosh 连接到主节点，并运行以下命令：

      db.adminCommand( { shutdown: 1 } )

   3. 将mongod二进制文件替换为8.3二进制文件。

   4. 启动 8.3 二进制文件。

      使用 --configsvr、--replSet、--port 和 --bind_ip 选项启动 8.3。包括上一个部署使用的任何其他命令行选项：

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

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

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

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

升级分片

一次升级一个分片。

对于每个分片副本集：

1. 升级从节点(secondary node from replica set)副本集的从节点，一次一个。

   1. 关闭从节点实例。

      要关闭 mongod 进程，请使用 mongosh 连接到集群节点，并运行以下命令：

      db.adminCommand( { shutdown: 1 } )

   2. 将 8.2 二进制文件替换为 8.3 二进制文件。

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

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

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

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

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

   3. 等待成员恢复到SECONDARY状态，然后再升级下一个从从节点(secondary node from replica set)成员。

      要检查节点状态，请在 mongosh 中发出 rs.status()。

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

2. 降级副本集主节点。

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

   rs.stepDown()

3. 升级已降级的主节点。

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

   1. 关闭降级主节点。

      要关闭已降级的主节点，请使用 mongosh 连接到副本集节点，并运行以下命令：

      db.adminCommand( { shutdown: 1 } )

   2. 替换mongod二进制文件。 与8.3二进制文件一起使用。

   3. 启动 8.3 二进制文件。

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

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

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

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

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

升级mongos 实例

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

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

重新启用负载均衡器

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

sh.startBalancer()

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

启用向后不兼容的 8.3 功能

此时，您可以运行 8.3 二进制文件，而不会启用与 8.3 不兼容的 8.2 功能。

要启用这些 8.3 功能，请将特征兼容性版本(FCV)设立为 8.3。您还必须将 confirm设立为 true。

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

db.adminCommand( { setFeatureCompatibilityVersion: "8.3", confirm: true } )

设置 featureCompatibilityVersion (FCV) : "8.3 "replSetReconfig对每个分片隐式执行 ，以将term 字段添加到分片副本配置文档中。

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

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

当您将 setFeatureCompatibilityVersion设立为8.3 时， MongoDB会清理分片上存在的所有孤立文档。清理进程：

• 不阻止升级完成，并且

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