Docs 菜单
Docs 主页
/
MongoDB Manual
/ /

将独立运行版升级至 5.0

在此页面上

  • 升级建议和清单
  • 先决条件
  • 下载 5.0 二进制文件
  • 升级进程
  • 其他升级程序

请熟读本文档的内容,包括彻底查看先决条件,然后再升级到 MongoDB 5.0。

以下步骤概述了从版本4升级独立运行 mongod的过程。 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 的兼容性。

在不兼容的驱动程序上运行的升级部署可能会遇到意外或未定义的行为。

警告

如果您的驱动程序使用在 v3.6 中已弃用的旧版操作码,请将驱动程序更新到使用受支持操作码的版本。 不再支持使用旧版操作码的驱动程序。

在开始升级之前,请参阅MongoDB 5.0 中的兼容性更改文档,以确保您的应用程序和部署与 MongoDB 5.0 兼容。在开始升级之前,请解决部署中的不兼容问题。

在升级 MongoDB 之前,请务必在临时环境中测试您的应用程序,然后再将升级部署到生产环境。

升级到5.0后,如果需要降级,我们建议降级到4.4的最新补丁版本。

在升级独立运行的 mongod 之前,请查看 5.0 性能注意事项,了解升级到 5.0 对性能的任何潜在影响。

确保 TTL 配置有效。升级之前,请删除或更正将 expireAfterSeconds 设置为 NaN 的任何 TTL 索引。在 MongoDB 5.0 及更高版本中,将 expireAfterSeconds 设置为 NaN 与将 expireAfterSeconds 设置为 0 具有相同的效果。如需了解详情,请参阅《设置为 NaN 时的 TTL expireAfterSeconds 行为》

升级前,请确认 mongod 实例已完全关闭

4.4 实例的 featureCompatibilityVersion 必须设置为 "4.4"。要查看 featureCompatibilityVersion

db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )

该操作返回的结果应包含 "featureCompatibilityVersion" : { "version" : "4.4" }

要设置或更新 featureCompatibilityVersion,请运行以下命令:

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

有关更多信息,请参阅 setFeatureCompatibilityVersion

在升级之前,请考虑将独立运行部署转换为副本集。副本集是 MongoDB 的推荐部署配置。

如果您从 MongoDB aptyumdnfzypper 存储库安装 MongoDB,则应使用包管理器升级到 5.0。

请按照适用于您的 Linux 系统的相应的 5.0 安装说明进行操作。这将涉及为新版本添加存储库,然后执行实际的升级过程。

如果您尚未使用包管理器安装 MongoDB,则可以从MongoDB 下载中心手动下载 MongoDB 二进制文件。

请参阅 5.0 安装说明了解更多信息。

警告

如果将现有的 MongoDB 实例升级到 MongoDB 5.0.15 ,并且在mongod.conf文件中设置了fork: true ,则该实例可能无法启动。

升级问题会影响所有使用.deb.rpm安装包的 MongoDB 实例。 使用 tarball ( .tgz ) 版本或其他软件包类型的安装不受影响。 有关详细信息,请参阅 SERVER-74345 。

要删除fork: true设置,请从系统终端运行以下命令:

systemctl stop mongod.service
sed -i.bak '/fork: true/d' /etc/mongod.conf
systemctl start mongod.service

删除设置后,第二个systemctl命令将启动升级后的实例。

1

关闭 mongod 实例。将现有二进制文件替换为 5.0 mongod 二进制文件。

使用 5.0mongod 重新启动部署。

2

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

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

提示

启用这些向后不兼容的功能可能会使降级过程变得复杂,因为在降级之前,您必须删除任何持续存在的向后不兼容的功能。

升级后,建议让部署在不启用这些功能的情况下稳定运行一段时间,以确保降级回老版本的可能性极小。当确信降级的可能性非常小时,请启用这些功能。

针对 admin 数据库运行 setFeatureCompatibilityVersion 命令:

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

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

注意

升级完成后,您可能会发现索引大小显着增加。要查看索引大小,请参阅dbStats.indexSize 。索引大小增加是因为索引键中存储了与时间窗口相关的数据。

如果升级后索引明显变大,而您希望减小索引大小,请联系您的 MongoDB 技术支持代表以讨论解决方案。

后退

MongoDB 5.0 中的兼容性更改

来年

将副本集升级至 5.0