在 Windows 上安装 MongoDB Enterprise 版
在此页面上
Overview
使用本教程安装 MongoDB 8.0使用默认安装向导在 Windows 上安装 Enterprise Edition。
MongoDB Enterprise Edition 可在特定平台上使用,并支持与安全和监控相关的多项功能。
MongoDB 版本
本教程将安装 MongoDB 8.0 企业版。要安装其他版本的 MongoDB Enterprise,请使用此页面左上角的版本下拉菜单选择该版本的文档。
安装方法
本教程使用默认 MSI 安装向导在 Windows 上安装 MongoDB。要使用 msiexec.exe
命令行工具安装 MongoDB,请参阅 使用 msiexec.exe 安装 MongoDB。msiexec.exe
工具对于希望使用自动化功能以无人值守的方式部署 MongoDB 的系统管理员非常有用。
Considerations
MongoDB Shell、 mongosh
MongoDB Shell ( mongosh) 不会随 MongoDB Server 一起安装。您需按照 mongosh 安装说明单独下载和安装 mongosh。
平台支持
MongoDB 8.0 Enterprise Edition 支持以下采用 x86_64 架构的 64 位 Windows 版本:
Windows Server 2022
Windows Server 2019
Windows 11
MongoDB 仅支持这些平台的 64 位版本。
有关更多信息,请参阅平台支持。
注意
适用于 Linux 的 Windows 子系统 (WSL) 不支持 MongoDB。要在 Linux 上运行 MongoDB,请使用受支持的 Linux 系统。
虚拟化
Oracle 为运行 Hyper-V 的 Windows 主机上的 VirtualBox 提供实验性支持。但是,Microsoft 不支持在 Hyper-V 上使用 VirtualBox。
Disable Hyper-V if you want to install MongoDB on Windows using VirtualBox.
生产说明
在生产环境中部署 MongoDB 之前,请参阅自管理部署的生产注意事项文档,其中提供了有关生产环境中 MongoDB 部署的性能注意事项和配置建议。
Full Time Diagnostic Data Capture
MongoDB 记录诊断数据以帮助排除故障。有关详细信息,请参阅全时诊断数据采集。
在 Windows 上,要收集磁盘、CPU 和内存等系统数据,FTDC 需要以下群组的 Microsoft 访问权限:
性能监控用户
Performance Log Users
如果运行 mongod
和 mongos
的用户不是管理员,请将其添加到这些群组中以记录 FTDC 数据。有关更多信息,请参阅此处的 Microsoft 文档。
安装 MongoDB Enterprise 版
步骤
按照以下步骤使用 Windows 安装向导安装 MongoDB Enterprise Edition。安装过程会同时安装 MongoDB 的二进制文件和默认配置文件 <install
directory>\bin\mongod.cfg
。
按照 MongoDB Enterprise 版安装向导进行操作。
该向导将引导您完成 MongoDB 和 MongoDB Compass 的安装。
- Choose Setup Type
- 您可以选择Complete(建议大多数用户使用)或Custom安装类型。Complete 安装选项会将 MongoDB 和 MongoDB 工具安装到默认位置。Custom 安装选项允许指定安装哪些可执行文件以及安装位置。
- Service Configuration
从 MongoDB 4.0 开始,您可在安装过程中将 MongoDB 设为 Windows 服务,或只安装二进制文件。
从 MongoDB 4.0 开始,您可以在安装过程中将 MongoDB 安装并配置为 Windows 服务,MongoDB 服务在安装成功后启动。
选择 Install MongoD as a Service 。
请选择其中一个选项:
Run the service as Network Service user (默认)
这是 Windows 内置的 Windows 用户帐户。
Run the service as a local or domain user
对于现有的本地用户帐户,请为 Account Domain 指定一个时间段(即
.
),并为用户指定 Account Name 和 Account Password。对于现有的域用户,请为此用户指定 Account Domain、Account Name 和 Account Password。
Service Name指定服务名称。默认名称是
MongoDB
。如果您已有指定名称的服务,则必须选择其他名称。Data Directory指定与
--dbpath
相对应的数据目录。如果该目录不存在,安装程序将创建目录,并为服务用户设置目录访问权限。Log Directory指定与
--logpath
相对应的日志目录。如果该目录不存在,安装程序将创建目录,并为服务用户设置目录访问权限。
如果选择不将 MongoDB 配置为 Windows 服务,请取消选中Install MongoD as a Service 。
- Install MongoDB Compass
- 可选。要让向导安装 MongoDB Compass,请选择 Install MongoDB Compass(默认)。
准备就绪后,单击 Install(安装)。
如果您将 MongoDB 安装为 Windows 服务
MongoDB 服务在安装成功后启动。使用配置文件 <install directory>\bin\mongod.cfg
配置 MongoDB 实例。
如果尚未执行此操作,请按 mongosh 安装说明下载和安装 MongoDB Shell (mongosh)。
请务必在安装过程中将 mongosh.exe
二进制文件的路径添加到 PATH
环境变量中。
打开新的 Command Interpreter,然后输入 mongosh.exe
以连接 MongoDB。
有关使用 mongosh.exe 连接到 mongod
(例如连接在其他主机和/或端口上运行的 MongoDB 实例)的更多信息,请参阅连接到部署。
有关 CRUD(创建、读取、更新、删除)操作的信息,请参阅:
如果未将 MongoDB 安装为 Windows 服务
如果仅安装可执行文件而未将 MongoDB 安装为 Windows 服务,那么您必须手动启动 MongoDB 实例。
请参阅从命令解释器启动 MongoDB Enterprise Edition ,了解如何启动 MongoDB 实例。
从命令解释器启动 MongoDB Enterprise Edition
Create database directory.
Create the data directory where MongoDB stores data. MongoDB's default data directory path is the absolute path \data\db
on the drive from which you start MongoDB.
从 Command Interpreter 创建数据目录:
cd C:\ md "\data\db"
启动您的 MongoDB 数据库。
要启动 MongoDB,请运行 mongod.exe
。
"C:\Program Files\MongoDB\Server\8.0\bin\mongod.exe" --dbpath="c:\data\db"
The --dbpath
option points to your database directory.
如果 MongoDB 数据库服务器运行正常,则Command Interpreter显示:
[initandlisten] waiting for connections
重要
根据 Windows 主机上的 Windows Defender 防火墙设置,Windows 可能会显示一个 Security Alert 对话框,提示阻塞 C:\Program Files\MongoDB\Server\8.0\bin\mongod.exe
的“某些功能”在网络上进行通信。要解决此问题,请执行以下操作:
单击 Private Networks, such as my home or work network(连接)。
单击 Allow access(连接)。
要了解有关安全和 MongoDB 的更多信息,请参阅安全文档。
Connect to MongoDB.
如果尚未执行此操作,请按 mongosh 安装说明下载和安装 MongoDB Shell (mongosh)。
请务必在安装过程中将 mongosh.exe
二进制文件的路径添加到 PATH
环境变量中。
打开新的 Command Interpreter,然后输入 mongosh.exe
以连接 MongoDB。
有关使用 mongosh.exe 连接到 mongod
(例如连接在其他主机和/或端口上运行的 MongoDB 实例)的更多信息,请参阅连接到部署。
有关 CRUD(创建、读取、更新、删除)操作的信息,请参阅:
以 Windows 服务的形式启动 MongoDB Enterprise
您可以在安装过程中将 MongoDB 安装并配置为 Windows Service,MongoDB 服务在安装成功后启动。
To start/restart the MongoDB service, use the Services console:
在“服务”控制台中,找到 MongoDB 服务。
右键单击 MongoDB 服务,然后单击Start Start (启动)。
您还可以通过命令行手动管理该服务。要通过命令行启动 MongoDB 服务,请以 Administrator 身份打开 Windows 命令提示符/解释器 (cmd.exe
),然后运行以下命令:
连接到 MongoDB Server。
如果尚未执行此操作,请按 mongosh 安装说明下载和安装 MongoDB Shell (mongosh)。
请务必在安装过程中将 mongosh.exe
二进制文件的路径添加到 PATH
环境变量中。
打开新的 Command Interpreter,然后输入 mongosh.exe
以连接 MongoDB。
停止 MongoDB Enterprise 版作为 Windows 服务
要停止/暂停 MongoDB 服务,请使用“服务”控制台:
在“服务”控制台中,找到 MongoDB 服务。
右键单击 MongoDB 服务,然后单击 Stop(停止)(或 Pause(暂停))。
您还可以通过命令行管理该服务。要通过命令行停止 MongoDB 服务,请以 Administrator 身份打开 Windows 命令提示符/解释器 (cmd.exe
),然后运行以下命令:
net stop MongoDB
删除作为 Windows 服务的 MongoDB Enterprise 版
要删除 MongoDB 服务,请先使用“服务”控制台停止该服务。然后以 Administrator 的身份打开 Windows 命令提示符/解释器 (cmd.exe
),并运行以下命令:
sc.exe delete MongoDB
其他注意事项
默认绑定本地主机
默认情况下,MongoDB 会以将 bindIp
设为 127.0.0.1
来启动,从而绑定到本地主机网络接口。这意味着 mongod.exe
只能接受来自同一计算机上运行的客户端的连接。远程客户端无法连接到 mongod.exe
,且 mongod.exe
无法初始化副本集,除非将此值设为有效的网络接口。
该值可通过以下任一方式配置:
警告
将实例绑定到可公开访问的 IP 地址之前,必须保护集群免遭未经授权的访问。有关安全建议的完整列表,请参阅自管理部署的安全清单。至少应考虑启用身份验证和强化网络基础设施。
有关配置bindIp
的详细信息,请参阅自托管部署中的IP绑定。
Point Releases and .msi
如果使用 Windows 安装程序 (.msi
) 安装 MongoDB,则 .msi
会在其版本系列中自动升级(例如 7.2.1 至 7.2.2)。
升级完整版本系列(例如6.0 至 7.0)需要全新安装。
将 MongoDB 二进制文件路径添加到系统 PATH 中
已向本教程中的所有命令行示例提供 MongoDB 二进制文件的绝对路径。您可将 C:\Program
Files\MongoDB\Server\8.0\bin
添加到系统 PATH
,然后省略 MongoDB 二进制文件的完整路径。