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

在 Red Hat 或 CentOS 上安装 MongoDB Enterprise Edition

Use this tutorial to install MongoDB 9.0 Enterprise Edition on Red Hat Enterprise Linux, CentOS Linux, or Oracle Linux [1] using the YUM package manager.

MongoDB Enterprise Edition is available on select platforms and contains support for features related to security and monitoring.

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

MongoDB 9.0 Enterprise Edition supports the following 64-bit versions of Red Hat Enterprise Linux (RHEL), CentOS Linux, Oracle Linux [1], Rocky Linux, and AlmaLinux [2] on x86_64 architecture:

  • RHEL / CentOS Stream / Oracle / Rocky / AlmaLinux 10

  • RHEL / CentOS Stream / Oracle / Rocky / AlmaLinux 9

  • RHEL / CentOS Stream / Oracle / Rocky / AlmaLinux 8

MongoDB 仅支持这些平台的 64 位版本。

MongoDB 9.0RHEL / CentOS / Oracle / Rocky / Alma Linux 上的企业版还支持部分平台上的 ARM64架构。

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

[1](1, 2) MongoDB only supports Oracle Linux running the Red Hat Compatible Kernel (RHCK). MongoDB does not support the Unbreakable Enterprise Kernel (UEK).

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

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

按照以下步骤使用 YUM包管理器安装MongoDB Enterprise版。

1

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

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

注意

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

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

2

要安装最新稳定版 MongoDB Enterprise 9.0,请执行以下命令:

sudo yum install -y mongodb-enterprise

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

sudo yum install -y mongodb-enterprise-9.0.0 mongodb-enterprise-database-9.0.0 mongodb-enterprise-server-9.0.0 mongodb-mongosh mongodb-enterprise-mongos-9.0.0 mongodb-enterprise-tools-9.0.0

注意

虽然您可以指定任意可用版本的 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 Shell无法启动并出现以下错误,请使用上述命令安装 mongodb-mongosh-shared-openssl3包:

mongosh: OpenSSL configuration error: ...:error:030000A9:digital
envelope routines:alg_module_init:unknown
option:../deps/openssl/openssl/crypto/evp/evp_cnf.c:61:name=rh-allow-sha1-signatures,
value=yes

该错误会影响 RHEL 9+ 和Amazon Linux 2023 等衍生产品。

您还可以选择要安装的 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

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

注意

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

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

  • /var/lib/mongo (数据目录)

  • /var/log/mongodb (日志目录)

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

要使用默认目录以外的数据目录或日志目录,请执行以下操作:

  1. 创建新目录。

  2. 编辑配置文件 /etc/mongod.conf 并相应修改以下字段:

    • storage.dbPath 以指定新的数据目录路径,例如 /some/data/directory

    • systemLog.path 以指定新的日志文件路径,例如 /some/log/directory/mongod.log

  3. 确保运行 MongoDB 的用户有权访问这些目录:

    sudo chown -R mongod:mongod <directory>

    如果更改运行 MongoDB 进程的用户,必须赋予新用户访问这些目录的权限。

  4. Configure SELinux if enforced. See Configure SELinux.

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

  • 使用 .rpm 安装程序。

  • 使用默认配置设置。

  • 在 RHEL7 或更高版本上运行。

注意

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

您无法使用MongoDB提供的 SELinux 策略。另一种方法是创建自定义 SELinux 策略,但编写不当的自定义策略可能会降低安全性,或者可能会阻止 mongod 实例运行。

  1. 确保您已安装以下软件包:

    • git

    • make

    • checkpolicy

    • policycoreutils

    • selinux-policy-devel

    sudo yum install git make checkpolicy policycoreutils selinux-policy-devel
  2. 下载策略存储库。

    git clone https://github.com/mongodb/mongodb-selinux
  3. 构建策略。

    cd mongodb-selinux
    make
  4. 应用该策略。

    sudo make install

重要

向后不兼容的功能

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

sudo make uninstall
  • 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) 标签页。

1

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

sudo systemctl start mongod

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

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

首先运行以下命令:

sudo systemctl daemon-reload

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

2

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

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

Start a mongosh session on the same host machine as the mongod. You can run mongosh without any command-line options to connect to a mongod that is running on your localhost with default port 27017.

mongosh

For more information on connecting using mongosh, such as to connect to a mongod instance running on a different host and/or port, see the mongosh documentation.

To help you start using MongoDB, MongoDB provides Getting Started Guides in various driver editions. For the driver documentation, see Start Developing with MongoDB.

默认情况下,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

Contains the MongoDB Shell (mongosh).

mongodb-shared-openssl*

Contains the MongoDB Shell that uses the OpenSSL version already installed on your computer (mongosh).

mongodb-enterprise-tools

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