Overview
使用本教程安装 MongoDB 9.0 Amazon Linux 上的 Enterprise 版,使用apt软件包管理器。
MongoDB Enterprise版可在部分平台上使用,并包含对安全和监控相关功能的支持。
验证 Linux 发行版
您可以在命令行运行以下命令来验证正在运行的是哪个 Linux 发行版:
grep ^NAME /etc/*release
结果应该是 Amazon Linux 或 Amazon Linux AMI。如果使用不同的 Linux 发行版,请参阅适用于您平台的安装说明。
MongoDB 版本
本教程将安装 MongoDB 9.0 企业版。要安装其他版本的 MongoDB Enterprise,请使用此页面左上角的版本下拉菜单选择该版本的文档。
Considerations
平台支持
MongoDB 9.0 企业版支持 x86 _64 架构上的以下64 位 Amazon Linux发布:
- Amazon Linux 2023
MongoDB 仅支持此平台的 64 位版本。
MongoDB 9.0 Amazon Linux Enterprise 版还支持部分平台上的ARM 64架构。
更多信息,请参阅平台支持。
生产说明
在生产环境中部署MongoDB之前,请参阅《自管理部署的生产说明》文档,了解性能注意事项和配置建议。
安装 MongoDB Enterprise 版
按照以下步骤使用 apt 软件包管理器来安装 MongoDB Enterprise Edition 。 选择适合您 Amazon Linux 版本的标签页:
配置软件包管理系统 (yum)。
创建/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/amazon/2023/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 文件。下载量按Amazon Linux版本(例如 2023)、 MongoDB发布版本(例如 9.0)和架构(例如x86_64)进行组织。
要安装最新稳定版 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
运行 MongoDB Enterprise 版
ulimit 注意事项
大多数类 Unix 操作系统都会限制进程可以使用的系统资源。这些限制可能会对MongoDB操作产生负面影响,应该进行调整。有关平台的建议设置,请参阅自管理部署的 UNIX ulimit 设置。
注意
如果打开文件数的 ulimit 值低于 64000,MongoDB 会生成初创企业警告。
目录
默认情况下,MongoDB 实例存储:
其数据文件于
/var/lib/mongo其日志文件于
/var/log/mongodb
如果使用包管理器进行安装,则会在安装过程中创建这些默认目录。
如果您通过下载 tarball 手动安装,请使用 mkdir -p <directory> 或 sudo mkdir -p <directory> 创建目录,具体取决于将运行MongoDB 的用户。有关 mkdir 和 sudo 的信息,请参阅 Linux 手册页。
默认情况下,MongoDB 使用 mongod 用户账户运行。如果更改运行 MongoDB 进程的用户,还必须修改 /var/lib/mongo 和 /var/log/mongodb 目录,以赋予该用户访问这些目录的权限。
要指定不同的日志文件目录和数据文件目录,请编辑 /etc/mongod.conf 中的 systemLog.path 和 storage.dbPath 设置。确保运行 MongoDB 的用户有访问这些目录的权限。
步骤
请按照以下步骤运行 MongoDB Enterprise 版。以下说明假设您使用的是默认设置。
初始化系统
要运行和管理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。
在与mongod 相同的托管上启动 mongosh 会话。您可以运行不带任何命令行选项的 mongosh,以连接到使用默认端口27017运行在本地主机上的 mongod。
mongosh
有关使用 mongosh 连接的更多信息,例如连接到在不同托管和/或端口上运行的mongod实例,请参阅mongosh文档。
为了帮助您开始使用MongoDB, MongoDB提供了各种驾驶员版本的入门指南。有关驾驶员文档,请参阅开始使用MongoDB进行开发。
更多信息
默认绑定本地主机
默认情况下,MongoDB 会以将 bindIp 设为 127.0.0.1 来启动,从而绑定到本地主机网络接口。这意味着 mongod 只能接受来自同一计算机上运行的客户端的连接。远程客户端无法连接到 mongod,且 mongod 无法初始化副本集,除非将此值设为有效的网络接口。
该值可通过以下任一方式配置:
警告
将实例绑定到可公开访问的 IP 地址之前,必须保护集群免遭未经授权的访问。有关安全建议的完整列表,请参阅自管理部署的安全清单。至少应考虑启用身份验证和强化网络基础设施。
有关配置bindIp的详细信息,请参阅自托管部署中的IP绑定。
MongoDB Enterprise 版软件包
MongoDB Enterprise 版可从其专用存储库获取,并包含以下官方支持的包:
包名称 | 说明 |
|---|---|
| 自动安装下列组件包的 |
| 自动安装下列组件包的
|
| 包含MongoDB Shell ( |
| 包含MongoDB Shell ,该 Shell 使用计算机上已安装的 OpenSSL 版本 ( |
| 自动安装下列组件包的
|