首页 > 编程笔记 > MongoDB 阅读:4

MongoDB安装教程(Windows平台,图文并茂)

在 Windows 系统上安装 MongoDB,首先需要确定自己的 Windows 系统版本以及 MongoDB 社区版所支持的系统版本。这里使用的是 Windows 10 操作系统和 MongoDB 8.0.4 版本。

由于 MongoDB 6 版本之后不再默认安装 Mongo Shell,因此本节分为两部分,安装 MongoDB 和安装 MongoDB Shell。

安装MongoDB

在 Windows 平台下,MongoDB 提供了两种安装形式:直接运行 MSI 安装包和 msiexec.exe 命令行工具,默认直接安装 MSI 安装包,msiexec.exe 命令行形式更倾向于使用自动化无人值守形式部署的系统管理员。

1) 打开MongoDB官网的下载页面,地址为 https://www.mongodb.com/try/download/community。单击 Select Package 显示版本选择界面。在 Version 下拉列表中选择版本 8.0.4,在 Platform 下拉列表中选择 Windows X64 操作系统,安装包格式选择 msi,单击 Download 按钮,开始下载,如下图所示。


图 1 MongoDB下载页面

2) 下载完成之后,双击 .msi 安装包文件开始安装。在安装过程中会弹出安装向导界面,指导使用者安装 MongoDB 以及 MongoDB 的可视化工具 MongoDB Compass。安装包运行后,界面如下图所示:


图 2 开始安装MongoDB

3) 安装向导提示当前安装的 MongoDB 版本信息,如下图所示,单击 Next 按钮。


图 3 进入MongoDB安装向导

4) 接受当前的终端用户安装协议,选中同意协议的复选框(I accept the terms in the License Agreement),单击 Next 按钮,如下图所示。


图 4 MongoDB安装协议

5) 选择安装类型,MongoDB 支持完整安装和个性化安装。个性化安装方式支持选择所需要的安装组件,同时也支持自定义 MongoDB 的安装路径。官方推荐的是完整安装。对于初学者或对 MongoDB 使用不熟练的使用者,建议默认完整安装。此方式会将 MongoDB 安装在路径 C:\Program Files\MongoDB\Server\8.0 下。选择 Complete 安装类型后,单击 Next 按钮,如下图所示。


图 5 选择安装类型

6) 配置服务,从 4.0 版本开始,MongoDB 可以配置为一项 Windows 服务。在这个步骤中,可以选择将 MongoDB 作为 Windows 的一个系统服务,如下图所示。


图 6 配置MongoDB服务

在这个界面中,可以配置服务的名称,一般默认为 MongoDB,同时配置 MongoDB 的数据目录和日志目录。配置完成后,单击 Next 按钮。如果这里不将 MongoDB 配置为 Windows 的服务,可以手动启动,具体可以查看后面关于手动启动 MongoDB 实例的内容。

7) 安装可视化工具 MongoDB Compass。这里为可选项,既可以安装,也可以不安装。这里选中进行安装,单击 Next 按钮进入下一步,如下图所示。


图 7 选择安装可视化工具

8) 进入安装进程。上述所有配置完成,单击 Install 按钮进入安装进程,如下图所示:


图 8 进入安装进程

等待安装进程进行。整个过程可能会持续较长时间,与所使用的计算机配置有关,不同配置耗费的时间有所不同,耐心等待即可,如下图所示。


图 9 安装进行中

安装进程结束,完成 MongoDB 和 MongoDB Compass 的安装。单击 Finish 按钮,退出安装进程,如下图所示。


图 10 安装完成

如果将 MongoDB 作为服务安装,那么安装结束后,会自动开启服务。要查看 MongoDB 服务的状态,可以打开系统服务界面,按 Ctrl + Shift + Esc 组合键,打开任务管理器,切换到“服务”选项卡,或者直接通过 Windows 系统的搜索找到“服务”界面,在“服务”界面中找到 MongoDB 服务,查看服务是否正在运行。在服务名称上右击,可以选择开启或停止该服务,如下图所示。


图 11 “服务”界面

或者打开浏览器访问 https://localhost:27017,如下图所示:


图 12 在浏览器中访问MongoDB

同样,也可以通过命令查看 MongoDB 服务的状态,开启或停止 MongoDB 服务。命令如下:
#查看MongoDB服务的状态
sc query MongoDB
#停止MongoDB服务
net stop MongoDB
#开启MongoDB服务
net start MongoDB
执行结果如下图所示:


图 13 查看MongoDB服务的状态

如果不作为服务安装,那么需要手动启动 MongoDB 实例,这里需要用到 mongod 命令。该命令在 MongoDB 安装目录下的 bin 文件夹(D:\MongoDB\Server\8.0\bin)下。启动时,需要配置数据目录,例如 D:\MongoDB\data,如下图所示。


图 14 mongod启动服务

MongoDB 启动后,该数据目录会生成一些数据库文件,如下图所示:


图 15 MongoDB的data目录

在 bin 目录下,存在一些关键文件,如下图所示:


图 16 MongoDB的bin目录

其中,mongod.exe 用来启动 MongoDB 服务,mongos.exe 用来管理分片集群。

配置环境变量

为了方便使用 mongod 以及其他命令,可以将 MongoDB 的安装路径加入环境变量。在配置了环境变量后,以上命令就可以省略路径,只保留命令本身的名称。打开环境变量配置界面,检查是否已自动创建环境变量,如果没有,则进行手动创建。

首先创建 MONGO_HOM E的系统变量,如下图所示:


图 17 配置MongoDB环境变量

然后编辑环境变量 Path,在最后加入一行内容,内容为:
%MONGO_HOME%\bin
最终结果如下图所示:


图 18 环境变量

这样就完成了环境变量的配置。之后使用相关命令时,不需要再进入命令所在目录。

其他安装形式

除前面介绍的安装方式外,MongoDB 还支持使用命令行工具 msiexec.exe 来安装。这种安装形式一般用在无人值守自动部署中。

首先,打开 cmd 命令窗口,使用如下命令:
msiexec.exe /l*v mdbinstall.log /qb /i mongodb-windows-x86_64-8.0.4-signed.msi

默认安装路径为 C:\Program Files\MongoDB\Server\6.0\bin,可以使用 INSTALLLOCATION 配置项来修改安装路径:
msiexec.exe /l*v mdbinstall.log /qb /i mongodb-windows-x86_64-8.0.4-signed.msi
INSTALLLOCATION="C:\MongoDB\Server\6.0"

如果同步安装可视化工具,可以使用如下命令:
msiexec.exe /l*v mdbinstall.log /qb /i mongodb-windows-x86_64-8.0.4-signed.msi
SHOULD_INSTALL_COMPASS="0"

其他设置和操作与双击运行 .msi 安装包的形式相同。

除以上形式外,还支持 .zip 免安装形式。下载 .zip 文件后,解压到相应目录,根据以上操作配置环境变量即可。

安装MongoDB常见问题和注意事项

1) 服务无法启动

安装完成后,可能会出现服务无法启动的情况,如下图所示。


图 19 服务启动错误

首先检查是否存在 MongoDB 服务,如果存在,那么尝试手动启动;如果启动失败,那么先移除服务,再尝试手动添加服务;如果不存在 MongoDB 服务,可以手动添加 MongoDB 服务。

移除 MongoDB 服务的命令如下:
sc delete MongoDB

添加服务的命令如下:
mongod -install -f "C:\Program Files\MongoDB\Server\8.0\bin\mongod.cfg"
手动添加 MongoDB 服务后,参考前述关于手动启动或停止 MongoDB 服务的描述,使用界面或命令开启 MongoDB 服务。

2) 单点发行

MongoDB 的自动版本更新须在同一大版本下,例如 4.2.1 到 4.2.2 可以自动更新,但 4.0 到 4.2 这种全量更新,需要重新安装。

3) 平台支持

MongoDB 8.0 社区版目前支持以下版本的 64 位 Windows 操作系统:

4) 虚拟化

如果要使用 VirtualBox 在 Windows 系统上安装 MongoDB,则需要禁用 Hyper -V。

相关文章