使用.tgz Tarball 在 Red Hat 或 CentOS 上安装 MongoDB Enterprise

在本页面

• Overview

• Considerations

• 安装 MongoDB 企业版

• 运行 MongoDB 企业版

• Additional Information

Overview

使用本教程，可以使用下载的.tgz tarball 在 Red Hat Enterprise Linux，CentOS Linux 或 Oracle Linux [1]上手动安装 MongoDB 3.6 Enterprise Edition。

MongoDB 企业版在某些平台上可用，并且包含对与安全性和监视有关的多种功能的支持。

MongoDB Version

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

Installation Method

如本文档所述，虽然可以通过下载的.tgz tarball 手动安装 MongoDB，但建议尽可能使用系统上的yum软件包 Management 器来安装 MongoDB。使用程序包 Management 器会自动安装所有必需的依赖项，并提供示例mongod.conf文件来帮助您入门，并简化以后的升级和维护任务。

➤有关说明，请参见使用 yum Package Manager 安装 MongoDB。

Considerations

Platform Support

EOL Notice

• MongoDB 3.6.17 企业版在s390x上删除了对 RHEL/CentOS/Oracle 7 的支持

• MongoDB 3.6.14 企业版在s390x上删除了对 RHEL/CentOS/Oracle 6 的支持

MongoDB 3.6 Enterprise Edition 支持x86_64体系结构上的 Red Hat Enterprise Linux(RHEL)，CentOS Linux 和 Oracle Linux [1]的以下 64 位 版本：

• RHEL/CentOS/Oracle 8(从 MongoDB Enterprise 3.6.17 开始)

• RHEL/CentOS/Oracle 7

• RHEL/CentOS/Oracle 6

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

RHEL/CentOS/Oracle 上的 MongoDB 3.6 企业版还支持某些平台上的PPC64LE体系结构。

有关更多信息，请参见Supported Platforms。

Production Notes

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

安装 MongoDB 企业版

Prerequisites

使用以下命令安装 MongoDB Enterprise .tgz tarball 所需的依赖项：

sudo yum install cyrus-sasl cyrus-sasl-gssapi cyrus-sasl-plain krb5-libs libcurl lm_sensors-libs net-snmp net-snmp-agent-libs openldap openssl tcp_wrappers-libs

sudo yum install cyrus-sasl cyrus-sasl-gssapi cyrus-sasl-plain krb5-libs libcurl net-snmp net-snmp-libs openldap openssl

Procedure

请按照以下步骤从.tgz手动安装 MongoDB 企业版。

下载 MongoDB Enterprise .tar.gzzipfile。

安装必需的必备软件包之后，请从MongoDB 下载中心下载适用于您系统的 MongoDB Enterprise tarball。

从下载的存档中提取文件。

例如，从系统 Shell 程序中，您可以使用tar命令提取：

tar -zxvf mongodb-linux-*-3.6.19.tgz

确保二进制文件位于 PATH 环境变量中列出的目录中。

MongoDB 二进制文件位于 tarball 的bin/目录中。您可以：

• 将二进制文件复制到PATH变量中列出的目录中，例如/usr/local/bin(使用适当的安装目录更新/path/to/the/mongodb-directory/)

sudo cp /path/to/the/mongodb-directory/bin/* /usr/local/bin/

• 从PATH变量中列出的目录(例如/usr/local/bin)创建指向二进制文件的符号链接(使用适当的安装目录更新/path/to/the/mongodb-directory/)：

sudo ln -s  /path/to/the/mongodb-directory/bin/* /usr/local/bin/

运行 MongoDB 企业版

Prerequisites

ulimit

大多数类 Unixos 都限制了会话可能使用的系统资源。这些限制可能会对 MongoDB 的运行产生负面影响。有关更多信息，请参见UNIX ulimit 设置。

Directory Paths

使用默认目录

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

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

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

• ➤如果您是通过程序包 Management 器安装的，

  • 将创建默认目录，并将这些目录的所有者和组设置为mongod。

• ➤如果通过下载压缩包进行安装，

  • 未创建默认的 MongoDB 目录。要创建 MongoDB 数据和日志目录：

sudo mkdir -p /var/lib/mongo
sudo mkdir -p /var/log/mongodb

默认情况下，MongoDB 使用mongod用户帐户运行。创建后，将这些目录的所有者和组设置为mongod：

sudo chown -R mongod:mongod <directory>

使用非默认目录

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

• 创建一个或多个新目录。

• 编辑配置文件/etc/mongod.conf，并相应地修改以下字段：

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

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

• 确保运行 MongoDB 的用户有权访问一个或多个目录：

sudo chown -R mongod:mongod <directory>

如果您更改运行 MongoDB 进程的用户，则必须向新用户授予对这些目录的访问权限。

• 如果强制配置 SELinux。参见Configure SELinux。

Configure SELinux

当前的 SELinux 策略不允许 MongoDB 进程访问/sys/fs/cgroup，这是确定系统上可用内存所必需的。如果打算以enforcing模式运行 SELinux，则需要对 SELinux 策略进行以下调整：

• 确保您的系统已安装checkpolicy软件包：

sudo yum install checkpolicy

• 创建一个自定义策略文件mongodb_cgroup_memory.te：

cat > mongodb_cgroup_memory.te <<EOF
module mongodb_cgroup_memory 1.0;

require {
    type cgroup_t;
    type mongod_t;
    class dir search;
    class file { getattr open read };
}

#============= mongod_t ==============
allow mongod_t cgroup_t:dir search;
allow mongod_t cgroup_t:file { getattr open read };
EOF

• 创建完成后，通过运行以下三个命令来编译并加载自定义策略模块：

checkmodule -M -m -o mongodb_cgroup_memory.mod mongodb_cgroup_memory.te
semodule_package -o mongodb_cgroup_memory.pp -m mongodb_cgroup_memory.mod
sudo semodule -i mongodb_cgroup_memory.pp

现在，将 SELinux 设置为enforcing，MongoDB 进程就可以访问正确的文件。

非默认 MongoDB 目录路径

• 更新 SELinux 策略以允许mongod服务使用新目录：

semanage fcontext -a -t <type> </some/MongoDB/directory.*>

在适当的地方指定以下类型之一：

• mongod_var_lib_t用于数据目录

• mongod_log_t用于日志文件目录

• mongod_var_run_t用于 pid 文件目录

• 为新目录更新 SELinux 用户策略：

chcon -Rv -u system_u -t <type> </some/MongoDB/directory>

在适当的地方指定以下类型之一：

• mongod_var_lib_t用于数据目录

• mongod_log_t用于日志目录

• mongod_var_run_t用于 pid 文件目录

• 将更新的 SELinux 策略应用于目录：

restorecon -R -v </some/MongoDB/directory>

For examples:

• 如果使用非默认的 MongoDB 数据路径/mongodb/data：

semanage fcontext -a -t mongod_var_lib_t '/mongodb/data.*'
chcon -Rv -u system_u -t mongod_var_lib_t '/mongodb/data'
restorecon -R -v '/mongodb/data'

• 如果使用非默认的 MongoDB 日志目录/mongodb/log(例如，日志文件路径为/mongodb/log/mongod.log)：

semanage fcontext -a -t mongod_log_t '/mongodb/log.*'
chcon -Rv -u system_u -t mongod_log_t '/mongodb/log'
restorecon -R -v '/mongodb/log'

非默认 MongoDB 端口

semanage port -a -t mongod_port_t -p tcp <portnumber>

可选。禁止 FTDC 警告

当前的 SELinux 策略不允许 MongoDB 进程打开并为Diagnostic Parameters(FTDC)读取/proc/net/netstat。这样，审核日志可能包含许多有关无法访问此路径的消息。

要跟踪建议的修复程序，请参阅https://github.com/fedora-selinux/selinux-policy-contrib/pull/79。

(可选)作为临时解决方案，您可以手动调整 SELinux 策略：

• 确保您的系统已安装checkpolicy软件包：

sudo yum install checkpolicy

• 创建一个自定义策略文件mongodb_proc_net.te：

cat > mongodb_proc_net.te <<EOF
module mongodb_proc_net 1.0;

require {
    type proc_net_t;
    type mongod_t;
    class file { open read };
}

#============= mongod_t ==============
allow mongod_t proc_net_t:file { open read };
EOF

• 创建完成后，通过运行以下三个命令来编译并加载自定义策略模块：

checkmodule -M -m -o mongodb_proc_net.mod mongodb_proc_net.te
semodule_package -o mongodb_proc_net.pp -m mongodb_proc_net.mod
semodule -i mongodb_proc_net.pp

Procedure

请按照以下步骤在系统上运行 MongoDB 企业版。这些说明假定您使用的是默认设置。

创建数据和日志目录。

创建一个目录，MongoDB 实例将在该目录中存储其数据。例如：

sudo mkdir -p /var/lib/mongo

创建一个目录，MongoDB 实例将在该目录中存储其日志。例如：

sudo mkdir -p /var/log/mongodb

启动 MongoDB 进程的用户必须具有对这些目录的读写权限。例如，如果您打算自己运行 MongoDB：

sudo chown `whoami` /var/lib/mongo     # Or substitute another user
sudo chown `whoami` /var/log/mongodb   # Or substitute another user

Run MongoDB.

要运行 MongoDB，请在系统提示符下运行mongod进程。

mongod --dbpath /var/lib/mongo --logpath /var/log/mongodb/mongod.log --fork

有关命令行选项--dbpath和--logpath的详细信息，请参见Options。

确认 MongoDB 已成功启动。

通过检查日志文件/var/log/mongodb/mongod.log中以下行的进程输出，验证 MongoDB 是否已成功启动：

[initandlisten] waiting for connections on port 27017

您可能会在过程输出中看到非严重警告。只要您看到上面显示的日志行，就可以在对 MongoDB 进行初始评估时安全地忽略这些警告。

开始使用 MongoDB。

在与mongod相同的主机上启动mongo shell。您可以在没有任何命令行选项的情况下运行mongo shell，以使用默认端口 27017 连接到在 localhost 上运行的mongod：

mongo

有关使用mongo shell 连接的更多信息，例如连接到在不同主机和/或端口上运行的mongod实例，请参见Mongo 壳牌。

为了帮助您开始使用 MongoDB，MongoDB 提供了各种驱动程序版本的入门指南。有关可用版本，请参见Getting Started。

Additional Information

默认情况下，localhost 绑定

默认情况下，MongoDB 在bindIp设置为127.0.0.1的情况下启动，该绑定到 localhost 网络接口。这意味着mongod仅可以接受来自同一计算机上运行的 Client 端的连接。远程 Client 端将无法连接到mongod，并且mongod将无法初始化replica set，除非将此值设置为有效的网络接口。

可以配置此值：

• 在带有bindIp的 MongoDB 配置文件中，或者

• 通过命令行参数--bind_ip

有关配置bindIp的更多信息，请参见MongoDB 配置强化。