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

在 Ubuntu 上安装 MongoDB Enterprise Edition

使用本教程安装MongoDB 9.0 使用apt包管理器的Ubuntu Linux LTS(长期支持)版本上的 Enterprise 版。

MongoDB Enterprise版可在部分平台上使用,并包含对安全和监控相关功能的支持。

本教程将安装 MongoDB 9.0 企业版。要安装其他版本的 MongoDB Enterprise,请使用此页面左上角的版本下拉菜单选择该版本的文档。

MongoDB 9.0 企业版支持 x86 _6464 架构上的以下 位 Ubuntu LTS(长期支持)版本:

  • 26.04 LTS (“Resulate”)

  • 24.04 LTS (“Noble”)

  • 22.04 LTS (“Jammy”)

MongoDB 仅支持这些平台的 64 位版本。要确定您的主机当前正在运行的 Ubuntu 版本,请在主机的终端上运行以下命令:

cat /etc/lsb-release

MongoDB 9.0 Ubuntu 上的 Enterprise 版还支持部分平台上的ARM 64架构。

更多信息,请参阅平台支持。

对于支持 Ubuntu 16.04 POWER/PPC64LE 的 MongoDB Enterprise 早期版本:

由于 Ubuntu 16.04 for POWER 上的 glibc 软件包的旧版本中存在锁定省略错误,因此在运行 MongoDB 之前,必须将 glibc 软件包至少升级到 glibc 2.23-0ubuntu5。由于随机内存损坏,使用较早版本的 glibc 软件包的系统会出现数据库服务器崩溃和行为不当的情况,并且不适合 MongoDB 的生产部署。

在生产环境中部署MongoDB之前,请参阅《自管理部署的生产说明》文档,了解性能注意事项和配置建议。

要在Ubuntu系统上安装MongoDB Enterprise,这些说明将使用由MongoDB Inc.维护和支持的官方mongodb-enterprise包。官方 mongodb-enterprise包始终包含最新版本的MongoDB ,并且可以从其专用存储库中获取。

重要

Ubuntu提供的 mongodb 包不是由MongoDB Inc. 维护的,并且与官方的 mongodb-enterprise 包冲突。如果您已经在Ubuntu系统上安装了 mongodb 包,则必须先卸载 mongodb 包,然后才能继续执行这些说明。

有关官方软件包的完整列表,请参阅MongoDB Enterprise Edition 软件包。

按照以下步骤使用 apt 软件包管理器来安装 MongoDB Enterprise 版。

1

从终端安装 gnupg 和 curl(如果尚未安装):

sudo apt-get install gnupg curl

要导入 MongoDB 公共 GPG 密钥,请运行以下命令:

curl -fsSL https://pgp.mongodb.com/server-9.asc | \
sudo gpg -o /usr/share/keyrings/mongodb-server-9.gpg \
--dearmor
2

为您的 Ubuntu 版本创建列表文件 /etc/apt/sources.list.d/mongodb-enterprise-9.0.list。

为Ubuntu 26.04 (Resulate) 创建列表文件:

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-9.gpg ] https://repo.mongodb.com/apt/ubuntu resolute/mongodb-enterprise/9.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise-9.0.list
3

发出以下命令以重新加载本地软件包数据库:

sudo apt-get update
4

要安装最新稳定版本,请运行以下命令:

sudo apt-get install -y mongodb-enterprise

注意

您还可以安装使用系统 OpenSSL 的 MongoDB Shell。在安装此版本的 MongoDB Shell 之前,必须先在系统上安装 OpenSSL。

您可以安装所有 MongoDB Enterprise 包以及使用系统 OpenSSL 的 MongoDB Shell,而无需先删除 MongoDB Shell。例如:

sudo apt-get install -y mongodb-enterprise mongodb-mongosh-shared-openssl11

以下示例会删除 MongoDB Shell,然后安装使用系统 OpenSSL 1.1 的 MongoDB Shell:

sudo apt-get remove -y mongodb-mongosh && sudo apt-get install -y
mongodb-mongosh-shared-openssl11

以下示例会删除 MongoDB Shell,然后安装使用系统 OpenSSL 3 的 MongoDB Shell:

sudo apt-get remove -y mongodb-mongosh && sudo apt-get install -y
mongodb-mongosh-shared-openssl3

您还可以选择要安装的 MongoDB 软件包。

下面的示例安装了 MongoDB Enterprise Edition和工具,以及使用系统内 OpenSSL 1.1 的 MongoDB Shell:

sudo apt-get install -y mongodb-enterprise-database
mongodb-enterprise-tools mongodb-mongosh-shared-openssl11

下面的示例安装了 MongoDB Enterprise 版和各种工具,以及使用系统 OpenSSL 3 的 MongoDB Shell:

sudo apt-get install -y mongodb-enterprise-database
mongodb-enterprise-tools mongodb-mongosh-shared-openssl3

在 Ubuntu 中安装 MongoDB 时,如需对过程中遇到的错误进行故障排查,请参阅故障排查指南。

默认情况下,MongoDB 实例存储:

  • 其数据文件于 /var/lib/mongodb

  • 其日志文件于 /var/log/mongodb

如果使用包管理器进行安装,则会在安装过程中创建这些默认目录。

如果您通过下载 tarball 手动安装,请使用 mkdir -p <directory> 或 sudo mkdir -p <directory> 创建目录,具体取决于将运行MongoDB 的用户。有关 mkdir 和 sudo 的信息,请参阅 Linux 手册页。

默认情况下,MongoDB 使用 mongodb 用户账户运行。如果更改运行 MongoDB 进程的用户,还必须修改 /var/lib/mongodb 和 /var/log/mongodb 目录,以赋予该用户访问这些目录的权限。

要指定不同的日志文件目录和数据文件目录,请编辑 /etc/mongod.conf 中的 systemLog.path 和 storage.dbPath 设置。确保运行 MongoDB 的用户有访问这些目录的权限。

大多数类 Unix 操作系统都会限制进程可以使用的系统资源。这些限制可能会对MongoDB操作产生负面影响,应该进行调整。有关平台的建议设置,请参阅自管理部署的 UNIX ulimit 设置。

注意

如果打开文件数的 ulimit 值低于 64000,MongoDB 会生成初创企业警告。

请按照以下步骤在系统上运行MongoDB Enterprise版。这些说明假定您使用的是Ubuntu提供的官方 mongodb-enterprise包,而不是非官方的 mongodb包,并且您使用的是默认设置。

初始化系统

要运行和管理mongod进程,请使用操作系统的内置初始化系统。最新版本的Linux使用 systemd,它使用 systemctl 命令,而旧版本的Linux使用 System V init,它使用 service 命令。

如果您不确定您的平台使用的是哪个初始化系统,请运行以下 命令:

ps --no-headers -o comm 1

然后根据结果选择下面合适的标签页:

  • systemd - 选择下方的 systemd (systemctl) 标签页。

  • init - 选择下方的 System V Init (service) 标签页。

1

您可以通过发出以下命令来启动 mongod 进程:

sudo systemctl start mongod

如果收到类似下方的错误(在启动 mongod 时):

Failed to start mongod.service: Unit mongod.service not found.

首先运行以下命令:

sudo systemctl daemon-reload

然后再次运行上面的启动命令。

2
sudo systemctl status mongod

您可以通过选择执行以下命令,来确保 MongoDB 将在系统 重新启动后启动:

sudo systemctl enable mongod
3

您可以根据需要,通过发出以下命令来停止 mongod 进程:

sudo systemctl stop mongod
4

您可以通过发出以下命令来重启 mongod 进程:

sudo systemctl restart mongod

通过观察 /var/log/mongodb/mongod.log 文件中的输出,可以跟踪错误或重要消息的进程状态。

5

在与mongod 相同的托管上启动 mongosh 会话。您可以运行不带任何命令行选项的 mongosh,以连接到使用默认端口27017运行在本地主机上的 mongod。

mongosh

有关使用 mongosh 连接的更多信息,例如连接到在不同托管和/或端口上运行的mongod实例,请参阅mongosh文档。

为了帮助您开始使用MongoDB, MongoDB提供了各种驾驶员版本的入门指南。有关驾驶员文档,请参阅开始使用MongoDB进行开发。

升级MongoDB Enterprise版时,请确保使用官方软件包。为每个组件指定相同的版本,如以下示例所示:

VERSION=${VERSION} sudo apt-get install -y \
mongodb-enterprise=${VERSION} \
mongodb-enterprise-server=${VERSION} \
mongodb-enterprise-mongos=${VERSION} \
mongodb-enterprise-tools=${VERSION} \
--allow-downgrades --allow-change-held-packages

默认情况下,MongoDB 会以将 bindIp 设为 127.0.0.1 来启动,从而绑定到本地主机网络接口。这意味着 mongod 只能接受来自同一计算机上运行的客户端的连接。远程客户端无法连接到 mongod,且 mongod 无法初始化副本集,除非将此值设为有效的网络接口。

该值可通过以下任一方式配置:

  • 在 MongoDB 配置文件中使用 bindIp,或

  • 通过命令行参数 --bind_ip

警告

将实例绑定到可公开访问的 IP 地址之前,必须保护集群免遭未经授权的访问。有关安全建议的完整列表,请参阅自管理部署的安全清单。至少应考虑启用身份验证和强化网络基础设施。

有关配置bindIp的详细信息,请参阅自托管部署中的IP绑定。

MongoDB Enterprise 版可从其专用存储库获取,并包含以下官方支持的包:

包名称
说明

mongodb-enterprise

自动安装下列组件包的 metapackage。

mongodb-enterprise-database

自动安装下列组件包的 metapackage:

mongodb-mongosh

包含MongoDB Shell (mongosh)。

mongodb-shared-openssl*

包含MongoDB Shell ,该 Shell 使用计算机上已安装的 OpenSSL 版本 ( mongosh )。

mongodb-enterprise-tools

自动安装下列组件包的 metapackage: