Docs 菜单
Docs 主页
/
数据库手册
/ / / /

在 Ubuntu 上安装 MongoDB Enterprise Edition

重要

MongoDB 8.2 是最新的次要发布。从MongoDB 8.2 开始,次要版本可用于特定使用案例的本地部署部署(MongoDB Community和 Enterprise)。有关更多信息,请参阅 MongoDB版本控制。

要安装支持本地部署使用的最新MongoDB版本,请参阅安装说明。

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

MongoDB Enterprise Edition 可在特定平台上使用,并支持与安全和监控相关的多项功能。

本教程将安装MongoDB 8.2企业版。要安装不同版本的MongoDB Enterprise,请使用此页面左侧 Self-Managed Deployments 下的版本下拉列表选择该版本的文档。

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

  • 24.04 LTS ("Noble")

  • 22.04 LTS ("Jammy")

  • 20.04 LTS ("Focal")

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

cat /etc/lsb-release

MongoDB 8.2 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 之前,请参阅自管理部署的生产注意事项文档,其中提供了有关生产环境中 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

从终端安装 gnupgcurl(如果尚未安装):

sudo apt-get install gnupg curl

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

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

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

为 Ubuntu 24.04 (Noble) 创建列表文件:

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

为Ubuntu 22.04 (Jammy) 创建列表文件:

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

为Ubuntu 20.04 (Focal) 创建列表文件。

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

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

sudo apt-get update
4

要安装最新版本的MongoDB Enterprise Server,请运行以下命令:

sudo apt-get install --only-upgrade mongodb-enterprise

要安装特定版本,必须单独指定每个组件包以及版本号,如以下示例所示:

sudo apt-get install -y mongodb-enterprise=8.2.0 mongodb-enterprise-database=8.2.0 mongodb-enterprise-server=8.2.0 mongodb-mongosh mongodb-enterprise-mongos=8.2.0 mongodb-enterprise-tools=8.2.0

如果您仅安装mongodb-enterprise=8.2.0并且不包含组件包,则无论您指定哪个版本,都将安装每个 MongoDB 包的最新版本。

虽然您可以指定任意可用版本的 MongoDB,但当新版本可用时,apt-get 仍会升级这些软件包。要防止意外升级,可固定软件包。要将 MongoDB 版本固定为当前安装的版本,请发出以下命令序列:

echo "mongodb-enterprise hold" | sudo dpkg --set-selections
echo "mongodb-enterprise-server hold" | sudo dpkg --set-selections
echo "mongodb-enterprise-database hold" | sudo dpkg --set-selections
echo "mongodb-mongosh hold" | sudo dpkg --set-selections
echo "mongodb-enterprise-mongos hold" | sudo dpkg --set-selections
echo "mongodb-enterprise-tools hold" | sudo dpkg --set-selections

注意

您还可以安装使用系统 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 的用户。(有关 mkdirsudo 的信息,请参见您的 linux 手册页。)

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

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

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

注意

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

按照以下步骤在系统上运行 MongoDB Enterprise Edition。这些说明假定您使用的是官方 mongodb-enterprise 软件包,而不是由 Ubuntu 提供的非官方 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 开发。

1

发出以下命令启动 mongod

sudo service mongod start
2

请验证 mongod 进程是否已成功启动:

sudo service mongod status

您还可以在日志文件中查看 mongod 进程的当前状态,默认情况下位于:/var/log/mongodb/mongod.log。正在运行的 mongod 实例将表明它已准备好使用以下行进行连接:

[initandlisten] waiting for connections on port 27017

3

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

sudo service mongod stop
4

发出以下命令重新启动 mongod

sudo service mongod restart
5

在与 mongod 相同的主机上启动 mongosh 会话。您可以在不使用任何命令行选项的情况下运行 mongosh,从而连接在本地主机上运行且默认端口号为 27017 的 mongod

mongosh

如需进一步了解使用 mongosh 进行连接(例如连接在其他主机和/或端口上运行的 mongod 实例),请参阅 mongosh 文档。

为了帮助您开始使用 MongoDB,MongoDB 提供了各种驱动程序版本的入门指南。关于驱动程序文档,请参阅 开始使用 MongoDB 开发。

要从系统中完全删除 MongoDB,您必须删除 MongoDB 应用程序本身、配置文件以及任何包含 数据和日志的目录。以下部分将指导您完成所需的步骤。

警告

此过程将完全删除 MongoDB、其配置以及所有数据库。此过程不可逆,因此请确保在继续之前备份所有配置和数据。

1

通过发出以下命令来停止 mongod 进程:

sudo service mongod stop
2

删除您之前安装的所有 MongoDB 包。

sudo apt-get purge mongodb-enterprise*
3

删除 MongoDB 数据库和日志文件。

sudo rm -r /var/log/mongodb
sudo rm -r /var/lib/mongodb

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

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-enterprise-server

包含 mongod 守护进程以及关联的配置和初始化脚本。

mongodb-enterprise-mongos

包含 mongos 守护程序。

mongodb-enterprise-cryptd

包含 mongocryptd 二进制文件

mongodb-mongosh

包含 MongoDB Shell (mongosh)。

mongodb-shared-openssl*

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

mongodb-enterprise-tools

自动安装下列组件包的 metapackage

包名称
说明

mongodb-database-tools

mongodb-enterprise-database-tools-extra

包含以下 MongoDB 支持工具:

后退

使用 .tgz Tarball 进行安装

在此页面上