参考 > 发行说明 > MongoDB 4.2发行说明 > 将独立版本升级到4.2
以下步骤概述了将独立mongod
版本从4.0 升级
到4.2的过程。
重要
在尝试进行任何升级之前,请熟悉本文档的内容。
如果您需要有关升级到4.2的指导,则MongoDB提供主要版本升级服务,以确保平稳过渡而不会中断您的MongoDB应用程序。
升级时,请考虑以下事项:
要将现有的MongoDB部署升级到4.2,必须运行4.0系列发行版。
要从4.0系列之前的版本升级,必须连续升级主要版本,直到升级到4.0系列为止。例如,如果运行的是3.6系列,则必须先 升级到4.0, 然后才能升级到4.2。
在开始升级之前,请参阅MongoDB 4.2中的兼容性更改文档,以确保您的应用程序和部署与MongoDB 4.2兼容。开始升级之前,请解决部署中的不兼容性。
在升级MongoDB之前,请务必先在临时环境中测试应用程序,然后再将升级部署到生产环境中。
MongoDB 4.2删除了对不建议使用的MMAPv1存储引擎的支持。
如果您的4.0部署使用MMAPv1,则必须在升级到MongoDB 4.2之前将4.0部署更改为WiredTiger Storage Engine。有关详细信息,请参见将Standalone更改为WiredTiger。
在MongoDB 4.2中,mongod
和
mongos
进程将不会以MMAPv1特定配置选项开头
。如果指定了先前版本的运行WiredTiger的MongoDB,则会忽略MMAPv1配置选项。对于MongoDB 4.2,您必须从配置中删除它们。
4.0实例必须featureCompatibilityVersion
设置为4.0
。要检查featureCompatibilityVersion
:
该操作应返回包含的结果
。"featureCompatibilityVersion" : { "version" : "4.0" }
要设置或更新featureCompatibilityVersion
,请运行以下命令:
有关更多信息,请参见setFeatureCompatibilityVersion
。
此时,您可以运行4.2二进制文件,而没有与4.0不兼容的4.2 功能。
要启用这些4.2功能,请将功能兼容版本(FCV
)设置为4.2。
小费
启用这些向后不兼容的功能可能会使降级过程复杂化,因为在降级之前必须删除所有持久的向后不兼容的功能。
建议在升级后,允许您在不启用这些功能的情况下运行部署,并且要在预热期内确保降级的可能性最小。如果您确信降级的可能性很小,请启用这些功能。
setFeatureCompatibilityVersion
针对admin
数据库运行命令:
此命令必须执行对内部系统集合的写入。如果由于某种原因该命令未成功完成,则可以安全地重试该命令,因为该操作是幂等的。
TLS
选项替换不推荐使用的SSL
选项从MongoDB 4.2开始,MongoDB弃用mongod,mongos和mongo shell的SSL选项 以及相应的net.ssl Options配置文件选项。
为避免弃用消息,请TLS
对mongod,mongos和mongo shell使用新选项
。
mongod
和mongos
配置文件的选项,请参阅配置文件页面。tls
选项,请参阅
连接字符串页面。需要与MongoDB 3.6和4.0兼容的官方驱动程序,包括retryWrites=true
在连接字符串中的选项才能
为该连接启用可重试的写入。
与MongoDB 4.2兼容的官方驱动程序默认情况下启用可重试写入。升级到需要兼容重写的4.2兼容驱动程序的应用程序可以忽略该retryWrites=true
选项。应用升级到需要的4.2兼容的驱动程序
禁用重试写操作必须包括
retryWrites=false
连接的字符串中。