对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。

升级 Ops Manager

本教程介绍如何升级现有的 Ops Manager 安装。

警告

将托管数据库升级到MongoDB 4.4或更高版本

MongoDB Ops Manager 8.0 不支持MongoDB 4.2 及更早版本。 如果您使用的是MongoDB 4.2 或更早版本并想要升级到MongoDB Ops Manager 8.0,则必须至少升级到MongoDB 4.4。 如果未至少升级到MongoDB 4.4、 MongoDB Ops Manager未通过动态检查,因此无法启动。至少升级到MongoDB 4.4 后, 我们仍然建议您至少升级到MongoDB 6。0 然后再升级到MongoDB Ops Manager 8。0。

现有 Ops Manager 安装的版本决定了升级到 Ops Manager 6.0 或更高版本必须采取的升级路径。

重要

  • 如果您安装了MongoDB Ops Manager 6.0 或更高版本,并且有多个MongoDB Ops Manager主机指向同一应用程序数据库,则可以升级MongoDB Ops Manager ,而不会导致监控停机。 在此升级过程中, MongoDB Ops Manager进入称为升级模式的状态。 有关更多信息,请参阅升级模式。

  • 为确保升级成功,必须按照现有版本的升级路径执行必要的数据库迁移。

  • 为了保护您的数据,MongoDB Ops Manager 会拒绝启动从 1.8.x 和 2.0.x 版本直接升级到 6.0 或更高版本。

  • Ops Manager 不支持降级路径。

注意

MongoDB Ops Manager版本 6.0.x 及更高版本的所有升级都使用相同的过程。 要升级到更高版本,必须首先使用此过程升级到初始版本的最新可用补丁,然后再次使用此过程升级到下一个版本。 如果下表包含与给定版本的升级过程相关的其他信息,请首先查看。

重要

对于通过 Ops Manager 管理或监控的源部署,实时迁移(推送)已弃用或不受支持

  • 对于运行任何 MongoDB 6.0 及更高版本的源部署,通过 Ops Manager 管理或监控其中的部署时,实时迁移(推送)不受支持。

  • 对于运行任何 MongoDB 5.0 及更早版本的源部署,通过 Ops Manager 管理或监控其中的部署时,实时迁移(推送)已弃用。

  • 对于运行 MongoDB 6.0 及更高版本的源部署,通过 Cloud Manager 监控其中的部署时,支持实时迁移(推送)。要了解详情,请参阅将通过 Cloud Manager 监控的 MongoDB 集群实时迁移到 Atlas。

下表列出了所有版本的升级路径:

现有版本
升级路径

9.0 .x

使用MongoDB Ops Manager9.0 9.0此过程 从 .x 升级到 的最新可用补丁版本。

要学习;了解更多信息,请参阅MongoDB Ops Manager 9.0发布说明。

8.0 .x

从MongoDB Ops Manager 8.0.x 升级到 8.0 的最新可用补丁版本。 然后升级到最新可用版本的9.0 。 对这两次升级都使用此过程。

要学习;了解更多信息,请参阅MongoDB Ops Manager 8.0发布说明。

7.0 .x

从MongoDB Ops Manager 7.0.x 升级到 7.0 的最新可用补丁版本。 然后升级到最新可用版本的8.0 。 对这两次升级都使用此过程。

要学习;了解更多信息,请参阅MongoDB Ops Manager 7.0发布说明。

6.0 .x

从MongoDB Ops Manager 6.0.x 升级到 6.0 的最新可用补丁版本。 然后升级到最新可用版本的7.0 。 对这两次升级都使用此过程。

要学习;了解更多信息,请参阅MongoDB Ops Manager 6.0发布说明。

5.0 .x

从MongoDB Ops Manager 5.0.x 升级到 5.0 的最新可用补丁版本。 然后升级到最新可用版本的6.0 。 对这两个进程使用此过程。

要学习;了解更多信息,请参阅MongoDB Ops Manager 5.0发布说明。

4.4.x

从MongoDB Ops Manager 4.4.x 升级到 4.4 的最新可用补丁版本。 然后升级到最新可用版本的5.0 。 对这两个进程使用此过程。

重要提示: MongoDB Ops Manager 4.4.13 版本 修复了一个错误,该错误会在升级期间重新启用MongoDB Ops Manager实例以进行API写入。

要了解详情,请参阅:

4.2.x

从MongoDB Ops Manager 4.2.x 升级到 4.2 的最新可用补丁版本。 然后升级到最新可用版本的4.4 。 对这两个进程使用此过程。

升级到 4.2.24 之前的版本时,会无意中暂时禁用 TLS。先升级到 4.2.24 或更高版本可避免此问题。

要了解详情,请参阅:

4.0.x

使用v4.2 升级教程从MongoDB Ops Manager 4.0.x 升级到版本 4.2.24 或更高版本。 然后使用此过程升级到4的最新可用版本。 2 。

升级到 4.2.24 之前的版本时,会无意中暂时禁用 TLS。先升级到 4.2.24 或更高版本可避免此问题。

要了解详情,请参阅:

3.6.x

使用v4.0 升级教程从MongoDB Ops Manager 3.6.x 升级到版本 4.0.x。

3.4.x

使用v3.6 升级教程从MongoDB Ops Manager 3.4.x 升级到版本 3.6.x。

2.x 或更早版本

使用v3.4 升级教程从MongoDB Ops Manager 2.x 或更早版本升级。

警告

要保持现有设置和可用性,请在当前 Ops Manager 实例中备份以下内容:

  • conf-mms.properties 和gen.key文件复制到安全位置。 conf-mms.properties 存储MongoDB Ops Manager实例的设置。 gen.key提供了用于加密和解密 Ops Manager 后端后端数据库和用户凭证的详细信息。 在升级进程, MongoDB Ops Manager可能会删除这些文件。

作为额外的预防措施,您可以使用mongodump创建应用程序数据库的二进制导出。 应用程序数据库不存在正式支持的备份方法。 如果升级失败,请联系MongoDB支持部门,帮助修复MongoDB Ops Manager版本的问题。

在MongoDB Ops Manager从 7.0 升级到 8.0 之前,请查看以下注意事项:

MongoDB Ops Manager 8.0.0 后端数据库至少需要MongoDB6.0.0 MongoDB Ops Manager。

注意

Ops Manager 后端数据库的 MongoDB 版本不能高于 Ops Manager 版本。

如果 MongoDB Ops Manager 托管 MongoDB 工具,则在升级 Ops Manager 时,Ops Manager 会自动升级工具版本。

如果以本地模式运行 MongoDB Ops Manager 8.0.x,则必须将 mongosh 和 MongoDB Database Tools TGZ 包的最新版本下载并安装到 数据库工具兼容性表中列出的 versions 目录。

“下载”页面仅提供最新的 Database Tools 版本。要下载兼容版本,请参阅 已存档版本。

  • 删除对 RedHat Enterprise Linux 7 的 Ops Manager 支持。

  • 删除 Ops Manager 对 SUSE Linux Enterprise Server 12 的支持。

  • 删除对 Ubuntu 20.04LTS 操作管理器的支持。

重要

  • 放弃 Ops Manager 对 Amazon Linux v2 LTS 的支持。

  • 放弃 Ops Manager 对 Debian 11 的支持。

  • 删除支持MongoDB 4.2及更早版本的自动化、监控和备份的支持。 MongoDB Ops Manager只能管理运行MongoDB 4.4 或更高版本的数据库。

重要

  • 弃用支持MongoDB 5.0及更早版本的自动化、监控和备份的支持。

您的服务器必须满足 Ops Manager 系统要求。

警告

可能出现生产故障

如果您未能配置以下内容,您的 Ops Manager 实例可能会在生产中故障:

  • Ops Manager 主机符合 Ops Manager 系统要求。

  • MongoDB 根据 MongoDB 手册中的生产说明进行托管。Ops Manager 中的 MongoDB 实例包括:

    • Ops Manager 应用程序数据库,

    • 每个块存储。

在开始升级进程之前,确保所有承载数据的节点都在运行。 要确定副本集的状态,请运行replSetGetStatus 。

如果后端数据库运行 MMAPv1 storage engine ,则升级过程将失败。 MongoDB Ops Manager会提示您将这些后端数据库的storage engine升级到WiredTiger 。

您必须对执行升级的服务器具有管理员权限。

要下载该软件,请单击客户下载页面上提供的下载链接。MongoDB 会向其客户提供该页面的 URL。

  • 如果无法访问此链接,请访问下载页面以获取 Ops Manager 软件的最新评估版。

  • 如果您需要早期版本的MongoDB Ops Manager软件,请访问发布存档。

如果计划以本地模式运行 Ops Manager,请将 MongoDB 软件下载到您的版本库目录中。所需软件包括:

在升级 Ops Manager 之前,确保:

  • 为 MongoDB Ops Manager 提供服务的托管的平台与 9.0 兼容。

  • 管理 MongoDB 部署的 MongoDB 代理与 Ops Manager 9.0 兼容。

  • 为 Ops Manager 助手提供服务的主机平台与助手兼容。

  • 如果您使用BI Connector ,请将MongoDB升级到6.0或更高版本。

如果您升级了 MongoDB 助手主机的平台,则在升级 Ops Manager 之前升级 MongoDB 助手。

注意

在 MongoDB Ops Manager 9.0 中,BI Connector 默认对新部署禁用。BI Connector 已于 30 年 2026 月 日停止服务,但现有的 BI Connector 实例在 MongoDB Ops Manager 中仍然可用且可管理。MongoDB 建议改用 SQL 接口。

注意

高可用应用程序的升级模式

如果安装了 Ops Manager 4.2 或更高版本,且有多个 Ops Manager 主机指向同一应用程序数据库,则可以升级 Ops Manager,而不会导致监控停机。在此升级过程中,Ops Manager 进入名为升级模式的状态。该模式可在整个升级过程中获得以下优势:

  • 警报和监控运行

  • Ops Manager 实例会保持活动状态

  • Ops Manager 应用程序可以以只读模式访问

  • 写入或删除数据的 Ops Manager API 被禁用

Ops Manager 实例会保持为升级模式,直到所有 Ops Manager 主机均已升级并重启。

您不应一次升级多于一台 Ops Manager 主机。

当 Ops Manager 进入升级模式时,备份守护程序会尝试自行停止。如果守护程序正在进行长时间备份作业,则此过程可能会失败。在这种情况下,执行以下操作之一:

  • 备份守护程序完成此作业后,立即重新启动第一个 Ops Manager 实例。

  • 手动停止备份守护程序。

手动停止备份守护程序:

  1. 登录第一个服务备份守护程序的主机。

  2. 发出以下命令:

    sudo service mongodb-mms-backup-daemon stop
  3. 确认已关闭备份守护程序:

    ps -ef | grep mongodb-mms-backup-daemon

    如果备份守护程序继续运行,请发出此命令:

    sudo /etc/init.d/mongodb-mms-backup-daemon stop
  4. 对所有其他备份守护进程主机重复步骤 2 到 3。

如果在高可用性配置中运行 Ops Manager 应用程序,则一次在一台 Ops Manager 主机上完成此过程。

使用此过程可在使用 deb 软件包安装的主机上升级 Ops Manager 应用程序:

1
  1. 打开您首选的浏览器并前往 MongoDB 下载中心。

  2. 从 Platforms(程序包)下拉菜单中,单击 Debian 12, 13 / Ubuntu 22.04, 24.04。

  3. 从 Packages 下拉菜单中,单击 DEB(对于 x86_64 架构)。

  4. 单击 Download(连接)。

    下载的软件包名为 mongodb-mms-<version>.x86_64.deb,其中 <version> 是版本号。

2

发出以下命令来停止 Ops Manager 应用程序:

sudo service mongodb-mms stop
3

注意

高可用 Ops Manager 应用程序的升级模式

如果您安装的 Ops Manager 6.0 有一个以上的 Ops Manager 托管指向同一个应用程序数据库,则此 Ops Manager 部署会以高可用性方式运行。升级高可用 Ops Manager 部署的一台 Ops Manager 托管后,该部署将进入升级模式。

  1. 在每个 Ops Manager 应用程序和备份守护程序主机上安装 .deb 包。发出以下命令,其中 <version> 是 .deb 包的版本:

    sudo dpkg -i mongodb-mms_<version>_x86_64.deb
  2. 当提示是否覆盖当前安装的 mms.conf 版本时,应输入 Y,替换现有文件。

  3. 如果您修改了 Ops Manager 使用的端口或 JVM 设置,则需要在升级 Ops Manager 后将这些更改重新应用到 mms.conf 文件。

    警告

    请勿向 mms.conf 文件中的 Java虚拟机(JVM)参数添加密码或秘密信息。Ops Manager 会将它们以纯文本形式显示在诊断存档中。

  4. 升级到 Ops Manager 6.0 时,Ops Manager 会提示您选择应使用哪个版本的 /opt/mongodb/mms/conf/conf-mms.properties 文件。为避免手动重新配置 Ops Manager,请选择当前文件。

4
sudo service mongodb-mms start

注意

在Ops Manager的高可用性实例中, Ops Manager服务初创企业会等待所有服务器升级后再启动。

重启后登录到已升级的 Ops Manager 主机。如果登录成功,则升级成功。

5

MongoDB Ops Manager保持升级模式,直到升级每个托管。对于高可用性配置,这意味着:

  • 在整个集群范围内完成升级之前,您的主机可能无法完全运行。如果首次托管升级的时间比预期长,请继续升级其他主机。

  • 不要停止或取消似乎停滞的进程,因为这可能会扰乱升级。

  • 当MongoDB Ops Manager将其所有服务器升级到相同版本时, MongoDB Ops Manager在初创企业期间生成的日志可能会在 Starting pre-flight checks 暂时暂停。

  • 对于多版本升级,请勿跳过主要版本。您必须将集群中的每个节点一次升级到每个主要发布的最后一个次要版本。示例,要从 6.0.26升级到 8.0.3,在每个节点上执行以下步骤:

    1. 停止节点(运行6.0.26)上的服务。

    2. 升级到 7.0.x 的最新次要版本。

    3. 在移动到下一个节点之前,启动升级后的托管。

    4. 对所有其他节点重复上述步骤。

    5. 重复此进程,将每个节点从 7.0.x升级到 8.0.3。

6

升级完成后,请登录您的 Ops Manager 实例。Ops Manager 显示一个横幅,上面写着 One or more agents are out of date。

单击 Update Software Components,然后确认更改。

重要

如果 Ops Manager 管理着您的 MongoDB 工具,工具版本则会随代理一起升级。

在 MongoDB Ops Manager 9.0 中,BI Connector 默认处于禁用状态。不要将 MongoDB Agent 更新过程理解为 MongoDB Ops Manager 将为新部署预配或更新 BI Connector 的声明。

动态检查输出或启动日志应包含类似 Unrecognized VM option 'UseParNewGC' 的错误。如果已编辑以下任何文件,则可能出现此错误:

  • /etc/rc.d/init.d/mongodb-mms

  • mms.conf

  • conf-mms.properties

从配置文件中删除 -XX:+UseParNewGC 以解决此问题。

根据 Linux 发行版和本地配置,Ops Manager 可能会替换您在升级时对配置文件所做的任何更改。在 Ops Manager 5.0 及更高版本中,如果您使用 RPM 包,则 Ops Manager 在升级时不再更新配置文件。如果新的 OPS Manager 版本需要配置文件的新属性,则必须在升级时将这些属性添加到文件。

升级时,更新 mongo.mongoUri 值以包括 MongoDB Java 驱动程序引入的新参数。默认情况下,此驱动程序启用可重试读取和可重试写入。 如果您设置自定义逻辑来重试读取和写入,则尝试可能需要很长时间。要禁用这些默认值,请在连接字符串中添加以下内容:

例子

mongodb://SERVER:PORT/?maxPoolSize=150&retryWrites=false&retryReads=false

此警告基于 Ops Manager 使用的 Guice 库显示。您可以放心地忽略此警告。