在 Ubuntu 上安装 MongoDB Enterprise Edition
注意
MongoDB Atlas
MongoDB Atlas是云中托管的 MongoDB 服务选项,无需安装开销,并提供免费入门套餐。
概述
使用本教程,利用 apt
软件包管理器即可在 Ubuntu Linux 的 LTS(长期支持)版本上安装 MongoDB 7.0 企业版。
MongoDB Enterprise 版可在部分平台上使用,并支持与安全和监控相关的多项功能。
MongoDB 版本
本教程将安装 MongoDB 7.0 Enterprise 版。要安装其他版本的 MongoDB Enterprise,请使用此页面左上角的版本下拉菜单选择该版本的文档。
考虑因素
平台支持
MongoDB 7.0 企业版支持以下 x86_64 架构 64 位 Ubuntu LTS(长期支持)版本:
22.04 LTS ("Jammy")
20.04 LTS ("Focal")
MongoDB 仅支持这些平台的 64 位版本。要确定您的主机当前正在运行的 Ubuntu 版本,请在主机的终端上运行以下命令:
cat /etc/lsb-release
Ubuntu 上的 MongoDB 7.0 Enterprise Edition 还支持某些平台上的 ARM64 架构。
更多信息,请参阅平台支持。
对于支持 Ubuntu 16.04 POWER/PPC64LE 的 MongoDB Enterprise 早期版本:
由于 Ubuntu 16.04 for POWER 上的 glibc
软件包的旧版本中存在锁定省略错误,因此在运行 MongoDB 之前,必须将 glibc
软件包至少升级到 glibc 2.23-0ubuntu5
。由于随机内存损坏,使用较早版本的 glibc
软件包的系统会出现数据库服务器崩溃和行为不当的情况,并且不适合 MongoDB 的生产部署。
生产说明
在生产环境部署 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 软件包。
安装 MongoDB Enterprise 版
按照以下步骤使用 apt
软件包管理器来安装 MongoDB Enterprise 版。
从终端安装 gnupg
和 curl
(如果尚未安装):
sudo apt-get install gnupg curl
要导入 MongoDB 公共 GPG 密钥,请运行以下命令:
curl -fsSL https://pgp.mongodb.com/server-7.0.asc | \ sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg \ --dearmor
安装 MongoDB Enterprise 软件包
安装 MongoDB Enterprise。
发出以下命令:
sudo apt-get install -y mongodb-enterprise
安装特定版本的 MongoDB Enterprise。
要安装特定版本,必须单独指定每个组件包以及版本号,如以下示例所示:
sudo apt-get install -y mongodb-enterprise=7.0.7 mongodb-enterprise-database=7.0.7 mongodb-enterprise-server=7.0.7 mongodb-mongosh=7.0.7 mongodb-enterprise-mongos=7.0.7 mongodb-enterprise-tools=7.0.7
如果您仅安装mongodb-enterprise=7.0.7
并且不包含组件包,则无论您指定哪个版本,都将安装每个 MongoDB 包的最新版本。
固定特定版本的 MongoDB Enterprise。
虽然您可以指定任意可用版本的 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 Enterprise 版
默认情况下,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 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) 标签页。
卸载 MongoDB
要从系统中完全删除 MongoDB,您必须删除 MongoDB 应用程序本身、配置文件以及任何包含 数据和日志的目录。以下部分将指导您完成所需的步骤。
警告
此过程将完全删除 MongoDB、其配置以及所有数据库。此过程不可逆,因此请确保在继续之前备份所有配置和数据。
停止 MongoDB。
通过发出以下命令来停止 mongod
进程:
sudo service mongod stop
更多信息
升级 MongoDB Enterprise 版
升级 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 Enterprise 版软件包
MongoDB Enterprise 版可从其专用存储库获取,并包含以下官方支持的包:
包名称 | 说明 | ||||||||
---|---|---|---|---|---|---|---|---|---|
mongodb-enterprise | 自动安装下列组件包的 metapackage 。 | ||||||||
mongodb-enterprise-database | 自动安装下列组件包的
| ||||||||
mongodb-mongosh | 包含 MongoDB Shell ( mongosh )。 | ||||||||
mongodb-shared-openssl* | 包含 MongoDB Shell,该 Shell 使用计算机上已安装的 OpenSSL 版本 ( mongosh )。 | ||||||||
mongodb-enterprise-tools | 自动安装下列组件包的
|