将5.0分片集群降级到4.4
在尝试降级之前,请熟悉本文档的内容。
降级路径
重要:
在升级或降级副本集之前,请确保所有副本集成员都在运行。如果您不这样做,在开始所有成员之前,升级或降级将不会完成。
如果您需要从5.0降级,请降级到4.4的最新补丁版本。
MongoDB仅支持单版本降级。您不能降级到当前版本后多个版本的版本。您可以将5.0系列降级为4.4系列部署,但是,不支持将4.4系列部署进一步降级为4.2系列部署。
创建备份
可选但推荐。创建数据库的备份。
先决条件
要从5.0降级到4.4,您必须删除持续存在的不兼容功能和/或更新不兼容的配置设置。这些包括:
1.集群默认读写问题
MongoDB 5.0更改了集群范围读写问题默认值,降级到MongoDB 4.4可能会更改这些默认值。在降级之前,考虑手动配置集群的默认读写问题:
- 要手动配置集群的read或writeconcern的默认值,请使用
setDefaultRWConcern
命令。 - 如果群集包含仲裁器,并且您之前已禁用“多数”读取关注以防止在某些情况下出现缓存压力,则可能需要配置--enableMajorityReadConcern false或replication。enableMajorityReadConcern:如果降级,则返回false。
2.带有.
或$
字符的文档字段
MongoDB 5.0增加了对在文档字段名称中包含.
或$
字符的支持。在降级到MongoDB 4.4之前,您必须删除任何包含.
或$
字符的字段名的文档。
3.精简格式时区数据文件
MongoDB 5.0支持超薄格式时区数据文件。如果在部署中使用超薄格式的时区数据文件,如使用--timeZoneInfo
命令行选项或processManagement.timeZoneInfo
配置文件设置提供给MongoDB的那样,则必须降级到MongoDB 4.4.7或更高版本,或者恢复时区数据文件以使用以前的非超薄格式数据文件。
4.重新分片
在尝试任何降级过程之前,请确保所有重新分片操作都已成功完成。如果最近的重新分片操作因主故障转移而失败,您必须先运行cleanupReshardCollection
命令,然后才能降级分片集群的featureCompatibilityVersion
。
如果您在降级分片集群featureCompatibilityVersion
时仍在运行重新分片操作,则分片操作将中止。
5.降级功能兼容性版本(fCV)
首先,验证以下内容
确保没有进行初始同步。在初始同步进行时,Running
setFeatureCompatibilityVersion
命令将导致初始同步重新启动。确保没有节点在其副本集配置中包含
newlyAdded
字段。在分片集群中的每个节点上运行以下命令来验证这一点:use local db.system.replset.find( { "members.newlyAdded" : { $exists : true } } );
newlyAdded
字段仅在初始同步期间和之后不久出现在节点的副本集配置文档中。确保没有副本集成员处于
ROLLBACK
或RECOVERING
状态。
接下来,要降级分片集群featureCompatibilityVersion
:
将mongo shell连接到
mongos
实例。降级
featureCompatibilityVersion
为"4.4"
db.adminCommand({setFeatureCompatibilityVersion: "4.4"})
setFeatureCompatibilityVersion
命令执行对内部系统集合的写入,并且是幂等的。如果由于某种原因命令没有成功完成,请在mongos
实例上重试该命令。笔记:
- 当
setFeatureCompatibilityVersion
分片集群上运行时,使用ConflictingOperationInProgress
块迁移、拆分和合并可能会失败。 - 如果
setFeatureCompatibilityVersion
失败并出现ManualInterventionRequired
错误,并且集群最近经历了因选择而失败的分片操作,则您必须运行cleanupReshardCollection
命令,然后再次尝试setFeatureCompatibilityVersion
。
- 当
为了确保分片集群的所有成员都反映更新的
featureCompatibilityVersion
,请连接到每个碎片副本集成员和每个配置服务器副本集成员,并检查featureCompatibilityVersion
:提示:
db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
所有成员都应返回一个结果,其中包括:
"featureCompatibilityVersion" : { "version" : "4.4" }
如果任何成员返回
"5.0"``featureCompatibilityVersion
等待成员反映"4.4"
版本,然后再继续。笔记:
仲裁员不会复制
admin.system.version
集合。因此,仲裁员总是有一个与二进制文件降级版本相等的功能兼容性版本,无论副本集的FCV值如何。例如,MongoDB 5.0集群中的仲裁器的FCV值为4.4。
有关返回的featureCompatibilityVersion值的详细信息,请参阅 Get FeatureCompatibilityVersion.
6.删除fCV 5.0持久功能
只有当fCV被设置为"5.0"
时,以下步骤才是必要的。
删除所有与4.4不兼容的持久5.0功能。这些包括:
时间序列集合
删除所有时间序列集合。
运行时审计过滤器管理
通过在节点的配置文件中将
auditLog.runtimeConfiguration
设置为false
,禁用运行时审计过滤器管理。
7.删除5.0功能
删除所有使用5.0功能的持久功能。这些包括但不限于:
- 如果任何视图定义包括5.0运算符,例如
$dateAdd
或$sampleRate
,则必须将其删除。有关完整列表,请参阅新聚合运算符。
程序
降级分片集群
警告:
在继续下调程序之前,请确保所有成员,包括分片集群中的延迟副本集成员,反映先决条件更改。也就是说,在降级之前,检查
featureCompatibilityVersion
并删除每个节点的不兼容功能。
1、下载最新的4.4二进制文件。
使用软件包管理器或手动下载,获取4.4系列的最新版本。如果使用软件包管理器,请为4.4二进制文件添加一个新存储库,然后执行实际的降级过程。
重要:
在升级或降级副本集之前,请确保所有副本集成员都在运行。如果您不这样做,在开始所有成员之前,升级或降级将不会完成。
如果您需要从5.0降级,请降级到4.4的最新补丁版本。
2、停用平衡器。
连接mongosh
到分片集群中的mongos
实例,以及runshsh.stopBalancer()
禁用平衡器:
sh.stopBalancer()
笔记:
如果迁移正在进行中,系统将在停止平衡器之前完成正在进行的迁移。您可以runsh
sh.isBalancerRunning()
来检查平衡器的当前状态。
要验证平衡器是否已禁用,请运行sh.getBalancerState()
),如果平衡器被禁用,则返回false:
sh.getBalancerState()
有关禁用平衡器的更多信息,请参阅禁用平衡器。
3、降级mongos
实例。
降级二进制文件并重新启动。
4、降级每个碎片,一次一个。
一次降级一个碎片。
A. 一次降级碎片的辅助成员:
在mongosh中运行以下命令以执行干净关闭,或参阅 Stop
mongod
进程以了解安全终止mongod进程的其他方法:db.adminCommand( { shutdown: 1 } )
将5.0二进制文件替换为4.4二进制文件并重新启动。
在降级下一个次要成员之前,等待成员恢复到
SECONDARY
状态。要查看会员的状态,请连接mongosh
到shard和runrsrs.status()
方法。重复对每个辅助成员降级。
B.降级碎片仲裁器(如果有的话)。
如果副本集不包括仲裁器,请跳过此步骤。
在
mongosh
中运行以下命令以执行干净关闭,或参阅 Stopmongod
进程以了解安全终止mongod
进程的其他方法:db.adminCommand( { shutdown: 1 } )
删除仲裁者数据目录的内容。Thestorage
storage.dbPath
配置设置或--dbpath
命令行选项指定arbitermongod的数据目录。rm -rf /path/to/mongodb/datafiles/*
将5.0二进制文件替换为4.4二进制文件并重新启动。
等待成员恢复到
ARBITER
状态。要查看会员的状态,请连接mongosh
成员和runrsrs.status()
方法。
C. 降级分片的主
向下阶下复制集主集。连接
mongosh
进入初选,并使用rs.stepDown()
下级初选,并强制选举新初选:rs.stepDown()
-
rs.status()
当状态显示初选已下台,而另一名成员已处于
PRIMARY
状态时,请继续。 从
mongosh
彻底关闭降级主进程,或参考停止mongod
进程以了解安全终止mongod
进程的其他方法:db.adminCommand( { shutdown: 1 } )
将5.0二进制文件替换为4.4二进制文件并重新启动。
对剩余的碎片重复。
5、降级配置服务器。
A. 一次降级配置服务器副本集(CSRS)的辅助成员:
在
mongosh
中运行以下命令以执行干净关闭,或参阅 Stopmongod
进程以了解安全终止mongod
进程的其他方法:db.adminCommand( { shutdown: 1 } )
将5.0二进制文件替换为4.4二进制文件并重新启动。
在降级下一个次要成员之前,等待成员恢复到
SECONDARY
状态。要查看会员的状态,请连接mongosh
到shard和runrsrs.status()
方法。重复对每个辅助成员降级。
B. 逐步降低配置服务器主服务器。
连接
mongosh
进入初选,并使用rs.stepDown()
下级初选,并强制选举新初选:rs.stepDown()
-
rs.status()
当状态显示初选已下台,而另一名成员已处于
PRIMARY
状态时,请继续。 从
mongosh
彻底关闭降级主进程,或参考停止mongod
进程以了解安全终止mongod
进程的其他方法:db.adminCommand( { shutdown: 1 } )
将5.0二进制文件替换为4.4二进制文件并重新启动。
6、重新启用平衡器
分片集群组件的降级完成后,连接mongosh
给一个mongos
,然后重新启用平衡器。
sh.startBalancer()
这个mongosh
方法sh.startBalancer()
还允许对分片集群进行自动分割。