在Red Hat或CentOS上安装MongoDB社区版
概述
使用本教程安装MongoDB 8.0社区版在Red Hat Enterprise Linux、CentOS Linux或Oracle Linux [1]上使用yum
软件包管理器。
MongoDB版本
本教程安装MongoDB 8.0社区版。要安装MongoDB的不同版本社区,请使用页面右上角的版本下拉菜单选择该版本的文档。
注意事项
平台支持
MongoDB 8.0 社区版支持以下内容64位版本的 Red Hat Enterprise Linux (RHEL)、CentOS Linux、Oracle Linux [1]、Rocky Linux 和 AlmaLinux [2],在x86_64 架构上
RHEL / CentOS Stream / Oracle / Rocky / AlmaLinux 9
RHEL / CentOS Stream / Oracle / Rocky / AlmaLinux 8
MongoDB 只支持这些平台的 64 位版本。
MongoDB 8.0 社区版在 RHEL / CentOS / Oracle / Rocky / AlmaLinux 上也支持在选定平台上的 ARM64 架构。
有关更多信息,请参阅平台支持。
[1] | (1, 2) MongoDB 只支持运行 Red Hat 兼容内核 (RHCK) 的 Oracle Linux。MongoDB 不支持 Unbreakable Enterprise Kernel (UEK)。 |
[2] | RHEL 8.0+ 版本发布的 MongoDB 本地产品与 Rocky Linux 8.0+ 和 AlmaLinux 8.0+ 兼容,并在这些分发版满足提供完整 RHEL 兼容性的义务的情况下获得支持。 |
生产注意事项
在生产环境中部署MongoDB之前,请考虑阅读自托管部署的生产注意事项文档,该文档提供了生产MongoDB部署的性能考虑因素和配置建议。
安装MongoDB社区版
按照以下步骤安装MongoDB社区使用yum
包管理器进行安装。
配置仓库。
创建一个/etc/yum.repos.d/mongodb-org-8.0.repo
文件,以便您可以直接使用yum
安装MongoDB
[mongodb-org-8.0] name=MongoDB Repository baseurl=https://repo.mongodb.org/yum/redhat/9/mongodb-org/8.0/x86_64/ gpgcheck=1 enabled=1 gpgkey=https://pgp.mongodb.com/server-8.0.asc
[mongodb-org-8.0] name=MongoDB Repository baseurl=https://repo.mongodb.org/yum/redhat/8/mongodb-org/8.0/x86_64/ gpgcheck=1 enabled=1 gpgkey=https://pgp.mongodb.com/server-8.0.asc
您也可以直接从MongoDB仓库下载根据Red Hat / CentOS版本(例如 9
),然后是MongoDB 发布版本(例如 8.0
),然后是架构(例如 x86_64
)组织。
在MongoDB 5.0之前,奇数版本的MongoDB发布版本,如4.3
,是开发版本。从MongoDB 5.1开始,MongoDB有季度快速发布。有关快速发布和长期支持发布之间的差异的信息,请参阅MongoDB版本。
安装MongoDB社区服务器。
要安装MongoDB的最新稳定版本,请执行以下命令
sudo yum install -y mongodb-org
或者,要安装特定版本的MongoDB,可以单独指定每个组件包,并将版本号追加到包名后,如下例所示
sudo yum install -y mongodb-org-8.0.0 mongodb-org-database-8.0.0 mongodb-org-server-8.0.0 mongodb-mongosh mongodb-org-mongos-8.0.0 mongodb-org-tools-8.0.0
注意
yum
在可用新版本时会自动升级软件包。如果您想阻止MongoDB升级,请通过在您的/etc/yum.conf
文件中添加以下exclude
指令来锁定软件包
exclude=mongodb-org,mongodb-org-database,mongodb-org-server,mongodb-mongosh,mongodb-org-mongos,mongodb-org-tools
运行MongoDB社区版
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。
配置 SELinux
从MongoDB 5.0版本开始,MongoDB安装可用一个新的SELinux策略,适用于使用.rpm安装程序的情况。
使用
.rpm
安装程序。使用默认配置设置。
运行在RHEL7或更高版本上。
如果您的安装不符合这些要求,请参阅.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版本开始,在降级到更早版本的MongoDB之前,您必须从之前克隆SELinux策略的目录中运行以下命令
sudo make uninstall
SELinux策略考虑事项
操作步骤
按照以下步骤运行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是否已成功启动。
您可以通过以下命令来验证 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
会话。您可以通过不使用任何命令行选项来连接到运行在本地的 mongod
,默认端口为 27017。
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。
在同一台主机上启动一个与 mongod
相同的 mongosh
会话。您可以通过不使用任何命令行选项来连接到运行在本地的 mongod
,默认端口为 27017。
mongosh
有关使用 mongosh
连接的更多信息,例如连接到运行在不同主机和/或端口的 mongod
实例,请参阅 mongosh 文档。
为了帮助您开始使用 MongoDB,MongoDB 提供了各种驱动版本的 入门指南。有关驱动文档,请参阅 开始使用 MongoDB 开发。
卸载MongoDB社区版
要完全从系统中删除MongoDB,您必须删除MongoDB应用程序本身、配置文件以及包含数据和日志的任何目录。以下部分将指导您完成必要的步骤。
警告
此过程将完全删除MongoDB、其配置和所有数据库。此过程不可逆,因此在继续之前,请确保所有配置和数据都已备份。
附加信息
默认绑定到localhost
默认情况下,MongoDB启动时将bindIp
设置为127.0.0.1
,这会将本地主机网络接口绑定。这意味着mongod
只能接受同一台机器上运行的客户端的连接。远程客户端将无法连接到mongod
,并且除非将此值设置为有效的网络接口,否则mongod
将无法初始化一个副本集。
此值可以通过以下方式配置:
在MongoDB配置文件中使用
bindIp
,或者通过命令行参数
--bind_ip
警告
在将您的实例绑定到公开可访问的IP地址之前,您必须通过未经授权的访问来保护您的集群。有关安全建议的完整列表,请参阅自管理部署的安全清单。至少,请考虑启用身份验证和强化网络基础设施。
有关配置bindIp
的更多信息,请参阅自管理部署中的IP绑定。
MongoDB社区版软件包
MongoDB社区版可通过其专用存储库获取,并包含以下官方支持的软件包
软件包名称 | 描述 | ||||||
---|---|---|---|---|---|---|---|
mongodb-org | 一个 metapackage ,会自动安装以下列出的组件包。 | ||||||
mongodb-org-database | |||||||
mongodb-mongosh | 包含MongoDB Shell( mongosh )。 | ||||||
mongodb-org-tools | 一个
|