Docs 菜单
Docs 主页
/
MongoDB Manual
/ / / /

在 Ubuntu 上安装 MongoDB Enterprise Edition

在此页面上

  • Overview
  • Considerations
  • 安装 MongoDB Enterprise 版
  • 运行 MongoDB Enterprise 版
  • 卸载 MongoDB
  • 更多信息

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

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

本教程将安装MongoDB 8.0 Enterprise 版。要安装不同版本的MongoDB Enterprise,请使用此页面左上角的版本下拉菜单选择该版本的文档。

MongoDB8 。0 企业版支持64 x86 _ 架构上的以下 位64 Ubuntu LTS(长期支持)版本:

  • 24.04 LTS ("Noble")

  • 22.04 LTS (“Jammy”)

  • 20.04 LTS ("Focal")

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

cat /etc/lsb-release

MongoDB 8.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 之前,请参阅《自管理部署的生产说明》文档,其中提供了 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.0.list

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

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.com/apt/ubuntu noble/mongodb-enterprise/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise-8.0.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.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise-8.0.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.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise-8.0.list
3

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

sudo apt-get update
4

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

sudo apt-get install -y mongodb-enterprise

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

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

如果您仅安装mongodb-enterprise=8.0.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=6.0.7 sudo apt-get install -y \
mongodb-enterprise=${VERSION} \
mongodb-enterprise-server=${VERSION} \
mongodb-enterprise-mongos=${VERSION} \
mongodb-enterprise-tools=${VERSION}

默认情况下,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 进行安装