将分片集群升级到5.0
在升级到MongoDB 5.0之前，请熟悉本文档的内容，包括彻底审查先决条件。
以下步骤概述了将碎片成员的mongod从4.4版本升级到5.0的过程。
如果您需要升级到5.0的指导，MongoDB专业服务提供主要版本升级支持，以帮助确保顺利过渡到MongoDB应用程序而不中断。
升级建议和核对清单
升级时，请考虑以下几点：
升级版本路径
要将现有的MongoDB部署升级到5.0，您必须运行4.4系列版本。
要从4.4系列之前的版本升级，您必须先后升级主要版本，直到升级到4.4系列。例如，如果您运行的是4.2系列，则必须先升级到4.4，然后才能升级到5.0。
检查驱动程序兼容性
在升级MongoDB之前，请检查您是否使用的是与MongoDB 5.0兼容的驱动程序。咨询驱动程序文档供您的特定驱动程序验证与MongoDB 5.0的兼容性。
在不兼容驱动程序上运行的升级部署可能会遇到意外或未定义的行为。
准备工作
在开始升级之前，请参阅MongoDB 5.0中的兼容性更改文档，以确保您的应用程序和部署与MongoDB 5.0兼容。在开始升级之前，解决部署中的不兼容性。
在升级MongoDB之前，在将升级部署到生产环境之前，请务必在分期环境中测试您的应用程序。
降级注意事项
一旦升级到5.0，如果您需要降级，我们建议您降级到4.4的最新补丁版本。
先决条件
确保 TTL 配置有效
确保TTL配置有效。升级之前，请删除或更正expireAfterSeconds设置为NaN的所有TTL索引。在MongoDB 5.0和更高版本中，将expireAfterSeconds设置为NaN与将expireAfterSeconds设置为0具有相同的效果。有关详细信息，请参见 TTL expireAfterSecondsBehavior When Set to NaN.
所有成员版本
要将分片集群升级到5.0，集群的所有成员必须至少是4.4版本。升级过程检查集群的所有组件，如果任何组件运行的版本早于4.4，则会发出警告。
确认清洁关机
在升级分片集群的成员之前，请确认该成员已完全关闭。
功能兼容性版本
4.4分片集群必须将featureCompatibilityVersion设置为"4.4"
为了确保分片集群的所有成员都将featureCompatibilityVersion设置为"4.4"连接到每个碎片副本集成员和每个配置服务器副本集成员，并检查featureCompatibilityVersion：
提示：
db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
所有成员都应返回一个包含"featureCompatibilityVersion" : { "version" : "4.4" }的结果。
要设置或更新featureCompatibilityVersion，请在mongos上运行以下命令：
db.adminCommand( { setFeatureCompatibilityVersion: "4.4" } )
有关更多信息，请参阅setFeatureCompatibilityVersion。
副本集成员状态
对于分片和配置服务器，请确保没有副本集成员处于ROLLBACK或RECOVERING状态。
备份config数据库
可选但推荐。作为预防措施，在升级分片集群之前，请先备份config数据库。
下载5.0 二进制文件
使用软件包管理器
如果您从MongoDB apt、yum、dnf或zypper存储库安装了MongoDB，则应使用软件包管理器升级到5.0。
按照Linux系统的相应5.0安装说明进行操作。这将涉及为新版本添加一个存储库，然后执行实际的升级过程。
手动下载5.0二进制文件
如果您尚未使用软件包管理器安装MongoDB，您可以手动从MongoDB下载中心。
有关更多信息，请参阅5.0安装说明。
升级流程
1、停用平衡器。
连接mongosh到分片集群中的mongos实例，以及runshsh.stopBalancer()禁用平衡器：
sh.stopBalancer()
笔记：
如果迁移正在进行中，系统将在停止平衡器之前完成正在进行的迁移。您可以runsh
sh.isBalancerRunning()来检查平衡器的当前状态。
要验证平衡器是否已禁用，请运行sh.getBalancerState()），如果平衡器被禁用，则返回false：
sh.getBalancerState()
有关禁用平衡器的更多信息，请参阅禁用平衡器。
2、升级配置服务器。
一次升级一个副本的从成员：
关闭从
mongod实例，并将4.4二进制文件替换为5.0二进制文件。使用
--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>包括适合您部署的任何其他设置。
等待成员恢复到
SECONDARY状态，然后再升级下一个次要成员。要检查成员的状态，请在mongosh。对每个辅助成员重复。
逐步关闭副本集主副本。
连接
mongosh进入初选，并使用rs.stepDown()下级初选，并强制选举新初选：rs.stepDown()当
rs.status()显示主制文件已下台，而另一个成员已处于PRIMARY状态时，请关闭降级主制，并将mongod二进制文件替换为5.0二进制文件。使用
--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>包括适合您部署的任何其他配置。
3、升级分片
一次升级一个分片。
对于每个碎片副本集：
一次升级一个副本的辅助成员：
关闭
mongod实例，并将4.4二进制文件替换为5.0二进制文件。使用
--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>包括适合您部署的任何其他配置。
等待成员恢复到
SECONDARY状态，然后再升级下一个次要成员。要检查成员的状态，您可以在mongosh。对每个辅助成员重复。
逐步关闭副本集主副本。
连接
mongosh进入初选，并使用rs.stepDown()下级初选，并强制选举新初选：rs.stepDown()当
rs.status()显示初选已下台，而其他成员已处于PRIMARY状态时，请升级降级初选：关闭降级主制文件，并将
mongod二进制文件替换为5.0二进制文件。使用
--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>包括适合您部署的任何其他配置。
4、升级
mongos实例。将每个
mongos实例替换为5.0二进制文件并重新启动。包括适合您部署的任何其他配置。笔记：
当分片集群成员在不同主机上运行或远程客户端连接到分片集群时，必须指定
--bind_ip选项。有关更多信息，请参阅Localhost绑定兼容性更改。mongos --configdb csReplSet/<rsconfigsver1:port1>,<rsconfigsver2:port2>,<rsconfigsver3:port3> --bind_ip localhost,<ip address>5、重新启用平衡器。
使用
mongosh，连接到集群中的mongos和runshsh.startBalancer()以重新启用平衡器：sh.startBalancer()从MongoDB 6.1开始，不执行自动分割块。这是因为平衡了政策的改进。自动拆分命令仍然存在，但不执行操作。有关详细信息，请参阅平衡策略更改。
在6.1之前的MongoDB版本中，
sh.startBalancer()还支持分片集群的自动拆分。如果您不希望在启用平衡器时启用自动拆分，您还必须运行
sh.disableAutoSplit()。有关重新启用平衡器的更多信息，请参阅启用平衡器。
6、启用向后不兼容的5.0功能。
此时，您可以在没有与4.4不兼容的5.0功能的情况下运行5.0二进制文件。
要启用这些5.0功能，请将功能兼容性版本（
FCV）设置为5.0。提示：
启用这些向后不兼容的功能可能会使降级过程复杂化，因为在降级之前，您必须删除任何持续存在的向后不兼容的功能。
建议在升级后，在烧毁期间允许您的部署在不启用这些功能的情况下运行，以确保降级的可能性最小。当您确信降级的可能性很小时，请启用这些功能。
在
mongos实例上，在admin数据库中运行setFeatureCompatibilityVersion命令：db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } )设置功能兼容性版本（fCV）：“5.0”隐式地在每个碎片上执行areplSetReconfig，将
term字段添加到碎片副本配置文档和块中，直到新配置传播到大多数副本集成员。此命令必须对内部系统集合执行写入。如果由于任何原因命令未能成功完成，您可以安全地在
mongos上重试该命令，因为操作是幂等的。笔记：
当
setFeatureCompatibilityVersion分片集群上运行时，块迁移、拆分和合并可能会因ConflictingOperationInProgress而失败。当您将
setFeatureCompatibilityVersion设置为5.0时，碎片上存在的任何孤儿文档都将被清理。清洁过程：- 不会阻止升级完成，并且
- 费率有限。要减轻孤儿文档清理期间性能的潜在影响，请参阅范围删除性能调整。
笔记：
其他考虑因素
当尝试连接功能兼容性版本（fCV）大于
mongos的mongod实例时，mongos二进制文件将崩溃。例如，您无法将MongoDB 4.4版本的mongos连接到fCV设置为5.0的5.0分片集群。但是，您可以将MongoDB 4.4版本的mongos连接到fCV设置为4.4的5.0分片集群。其他升级程序
- 要升级独立设备，请参阅将独立升级到5.0。
- 要升级副本集，请参阅将副本集升级到5.0。