在 Red Hat 或 CentOS 上安装 MongoDB Enterprise Edition

在此页面上

概述

注意事项
安装 MongoDB Enterprise 版
运行 MongoDB Enterprise 版
卸载 MongoDB
更多信息

注意

MongoDB 阿特拉斯

MongoDB Atlas 是在云中托管的 MongoDB 服务选项，无需安装开销，并提供免费套餐，可以立即开始使用。

概述

使用本教程，利用yum经理即可在 Red Hat Enterprise Linux、CentOS Linux 或 Oracle Linux [1]上安装 MongoDB 6.0 Enterprise Edition。

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

MongoDB 版本

本教程安装的是 MongoDB 6.0 Enterprise 版。要安装不同版本的 MongoDB Enterprise，使用此页面左上角的版本下拉菜单以选择该版本的文档。

注意事项

平台支持

注意

EOL 通知

MongoDB5 。0 Enterprise 版删除了对 6x86 _ 上的 RHEL /CentOS/Oracle 的支持64
MongoDB Enterprise 版删除了版本 4.0 和 5.0 之间对RHEL 7/CentOS/Oracle PPC64LE的支持。但是，5.0.X 版本支持这些架构。

MongoDB 6.0 Enterprise 版支持 x86_64 架构上的以下 64 位 版本的 Red Hat Enterprise Linux (RHEL)、CentOS Linux、Oracle Linux [1] 、Rocky Linux 和 AlmaLinux [2] ：

RHEL / CentOS / Oracle / Rocky / AlmaLinux 9（从 MongoDB 6.0.4 开始）
RHEL / CentOS / Oracle / Rocky / Alma 8
RHEL / CentOS / Oracle 7

MongoDB 6.0 企业版还支持 RHEL /CentOS/Oracle/Rocky/AlmaLinux 8 上的 ARM64 架构。

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

[1]	(1, 2) MongoDB 仅支持运行 Red Hat Compatible Kernel (RHCK) 的 Oracle Linux。MongoDB 不支持 Unbreakable Enterprise Kernel (UEK)。

[2]	针对 RHEL 版本 8.0+ 发布的 MongoDB 本地部署产品，与 Rocky Linux 版本 8.0+ 和 AlmaLinux 版本 8.0+ 兼容并受支持（前提是这些发行版能满足其承诺，提供完整的 RHEL 兼容性）。

生产说明

在生产环境部署 MongoDB 之前，请考虑生产环境说明文档，其中提供了有关生产环境中 MongoDB 部署的性能注意事项和配置建议。

安装 MongoDB Enterprise 版

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

配置存储库。

创建/etc/yum.repos.d/mongodb-enterprise-6.0.repo文件，以便使用 yum 直接安装 MongoDB Enterprise：

[mongodb-enterprise-6.0]
name=MongoDB Enterprise Repository
baseurl=https://repo.mongodb.com/yum/redhat/9/mongodb-enterprise/6.0/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://pgp.mongodb.com/server-6.0.asc

[mongodb-enterprise-6.0]
name=MongoDB Enterprise Repository
baseurl=https://repo.mongodb.com/yum/redhat/8/mongodb-enterprise/6.0/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://pgp.mongodb.com/server-6.0.asc

[mongodb-enterprise-6.0]
name=MongoDB Enterprise Repository
baseurl=https://repo.mongodb.com/yum/redhat/7/mongodb-enterprise/6.0/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://pgp.mongodb.com/server-6.0.asc

注意

如果此目录中有以前安装的 MongoDB 中的mongodb-enterprise.repo文件，则应将其删除。使用上面的mongodb-enterprise-6.0.repo文件安装 MongoDB 6.0。

此外，也可直接从 MongoDB 存储库下载 .rpm 文件。下载会按 Red Hat/CentOS 版本进行组织（例如9），然后是按 MongoDB 发布版本（例如6.0），接着是按架构（例如x86_64）。

在 MongoDB 5.0 之前，奇数 MongoDB 发布版本（例如 4.3）为开发版本。从 MongoDB 5.1 开始，MongoDB 每季度进行快速发布。有关快速发布版本与长期支持版本之间区别的更多信息，请参阅 MongoDB 版本控制。

安装 MongoDB 软件包。

要安装最新稳定版本的 MongoDB Enterprise 6 。 0 ，发出以下命令：

sudo yum install -y mongodb-enterprise

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

sudo yum install -y mongodb-enterprise-6.0.16 mongodb-enterprise-database-6.0.16 mongodb-enterprise-server-6.0.16 mongodb-enterprise-mongos-6.0.16 mongodb-enterprise-tools-6.0.16

注意

虽然您可以指定任意可用版本的 MongoDB Enterprise，但当有新版本可用时，yum 仍会升级这些软件包。要防止意外升级，请将以下 exclude 指令添加到 /etc/yum.conf 文件中以锁定软件包：

exclude=mongodb-enterprise,mongodb-enterprise-database,mongodb-enterprise-server,mongodb-enterprise-shell,mongodb-enterprise-mongos,mongodb-enterprise-tools

注意

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

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

sudo yum install -y mongodb-enterprise mongodb-mongosh-shared-openssl11

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

sudo yum remove -y mongodb-mongosh && sudo yum install -y
mongodb-mongosh-shared-openssl11

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

sudo yum remove -y mongodb-mongosh && sudo yum install -y
mongodb-mongosh-shared-openssl3

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

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

sudo yum install -y mongodb-enterprise-database
mongodb-enterprise-tools mongodb-mongosh-shared-openssl11

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

sudo yum install -y mongodb-enterprise-database
mongodb-enterprise-tools mongodb-mongosh-shared-openssl3

运行 MongoDB Enterprise 版

先决条件

ulimit

大多数类 Unix 操作系统都会对每个进程可以使用的系统资源进行限制。这些限制可能会对 MongoDB 操作产生负面影响，应进行适当调整。有关您平台的建议设置，请参阅 UNIX ulimit 设置。

注意

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

目录路径

使用默认目录

默认情况下，MongoDB 使用 mongod 用户帐户运行，并且使用以下默认目录：

/var/lib/mongo （数据目录）
/var/log/mongodb （日志目录）

软件包管理器在安装过程中创建默认目录。所有者和群组名称是mongod。

使用非默认目录

要使用除默认目录外的数据目录和/或日志目录：

创建新目录。
编辑配置文件 /etc/mongod.conf 并相应修改以下字段：
- storage.dbPath 指定新的数据目录路径（例如/some/data/directory）
- systemLog.path 以指定新的日志文件路径（例如 /some/log/directory/mongod.log）
确保运行 MongoDB 的用户有权访问这些目录：
```
sudo chown -R mongod:mongod <directory>
```
如果更改运行 MongoDB 进程的用户，必须赋予新用户访问这些目录的权限。
如果强制执行，请配置 SELinux。请参阅配置 SELinux。

配置 SELinux

从 MongoDB 5.0 开始，一个新的 SELinux 策略可用于安装 MongoDB：

使用 .rpm 安装程序。
使用默认配置设置。
在 RHEL7 或 RHEL8 上运行。

使用 LDAP 身份验证安装 MongoDB Enterprise 时，必须额外实施以下 SELinux 策略：

对于通过操作系统库使用 LDAP 身份验证的部署，MongoDB 必须有权访问 tcontext=system_u:object_r:ldap_port_t:s0 LDAP 端口。您可以通过运行 setsebool -P authlogin_nsswitch_use_ldap 1 来启用访问权限。
对于通过 saslauthd 使用 LDAP 身份验证的部署，必须通过运行 sudo setsebool -P daemons_enable_cluster_mode 1 来启用集群模式。

如果您的安装不符合这些要求，请参阅 .tgz 软件包的 SELinux 说明。

注意

如果您的 MongoDB 部署对以下任何设置项使用了自定义设置：

您无法使用 MongoDB 提供的 SELinux 策略。备选方法是创建一个自定义 SELinux 策略，但编写不当的自定义策略可能降低安全性或导致 mongod 实例无法运行。

安装 SELinux 策略

确保您已安装以下软件包：
- git
- make
- checkpolicy
- policycoreutils
- selinux-policy-devel
```
sudo yum install git make checkpolicy policycoreutils selinux-policy-devel
```

下载策略存储库。

git clone https://github.com/mongodb/mongodb-selinux

构建策略。
```
cd mongodb-selinux
make
```
应用该策略。
```
sudo make install
```

重要

向后不兼容的功能

从 MongoDB 5.1 开始，您必须在先前克隆 SELinux 策略的目录运行以下命令，然后才能降级到 MongoDB 的早期版本：

sudo make uninstall

SELinux 政策注意事项

SELinux 策略旨在与标准 MongoDB .rpm 软件包安装产生的配置配合使用。请参阅标准安装假设，了解详情。
SELinux 策略专为 mongod 服务器而设计。它不应用于其他 MongoDB 守护进程或工具，例如：
SELinux 项目提供的引用策略包含 mongodb_admin 宏。MongoDB SELinux 策略不包含这个宏。unconfined_t 域中的管理员可以管理 mongod。
要卸载策略，请转至您保存策略存储库的目录并运行：
```
sudo make uninstall
```

步骤

请按照以下步骤在您的系统上运行 MongoDB Enterprise Edition。参照这些操作说明的前提是您在使用默认设置。

初始化系统

要运行和管理 mongod 进程，需使用操作系统内置的初始化系统。较新版本的 Linux 倾向于使用 systemd（它会使用 systemctl 命令），而较旧版本的 Linux 倾向于使用 System V init（它使用 service 命令）。

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

ps --no-headers -o comm 1

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

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

启动 MongoDB。

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

sudo systemctl start mongod

如果收到类似下方的错误（在启动 mongod 时）：

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

首先运行以下命令：

sudo systemctl daemon-reload

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

验证 MongoDB 是否已成功启动。

您可以通过发出以下命令来验证 mongod 进程已成功启动：

sudo systemctl status mongod

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

sudo systemctl enable mongod

停止 MongoDB。

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

sudo systemctl stop mongod

重启 MongoDB。

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

sudo systemctl restart mongod

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

开始使用 MongoDB。

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

mongosh

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

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

启动 MongoDB。

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

sudo service mongod start

验证 MongoDB 是否已成功启动

您可以通过检查位于/var/log/mongodb/mongod.log的日志文件的内容是否有一行以下内容来验证mongod进程已成功启动：

[initandlisten] waiting for connections on port <port>

其中， <port>是在/etc/mongod.conf （默认为27017 ）中配置的端口。

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

sudo chkconfig mongod on

停止 MongoDB。

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

sudo service mongod stop

重启 MongoDB。

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

sudo service mongod restart

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

开始使用 MongoDB。

mongosh

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

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

卸载 MongoDB

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

警告

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

停止 MongoDB。

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

sudo service mongod stop

删除包。

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

sudo yum erase $(rpm -qa | grep mongodb-enterprise)

删除数据目录。

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

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

警告

在绑定到非本地主机（例如可公开访问）IP 地址之前，请确保您已保护集群免受未经授权的访问。有关安全建议的完整列表，请参阅安全检查清单。至少应考虑启用身份验证和强化网络基础设施。

有关配置 bindIp 的更多信息，请参阅 IP 绑定。

MongoDB Enterprise 版软件包

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 数据库工具： `mongodump` `mongorestore` `bsondump` `mongoimport` `mongoexport` `mongostat` `mongotop` `mongofiles`
`mongodb-enterprise-database-tools-extra`	包含以下 MongoDB 支持工具： `mongoldap` `mongokerberos` `install_compass` 脚本 `mongodecrypt` 二进制文件

后退

在 Linux 上安装

来年

使用 .tgz Tarball 进行安装

注意

MongoDB 阿特拉斯

概述

MongoDB 版本

注意事项

平台支持

注意

EOL 通知

生产说明

安装 MongoDB Enterprise 版

配置存储库。

注意

安装 MongoDB 软件包。

注意

注意

运行 MongoDB Enterprise 版

先决条件

ulimit

注意

目录路径

使用默认目录

使用非默认目录

配置 SELinux

注意

安装 SELinux 策略

重要

向后不兼容的功能

SELinux 政策注意事项

步骤

启动 MongoDB。

验证 MongoDB 是否已成功启动。

停止 MongoDB。

重启 MongoDB。

开始使用 MongoDB。

启动 MongoDB。

验证 MongoDB 是否已成功启动

停止 MongoDB。

重启 MongoDB。

开始使用 MongoDB。

卸载 MongoDB

警告

停止 MongoDB。

删除包。

删除数据目录。

更多信息

默认绑定本地主机

警告

MongoDB Enterprise 版软件包