MongoDB的安装1、在Windows系统上安装MongoDB1.1、安装MongoDB1.2、配置环境变量1.3、其他安装形式1.4、常见问题和注意事项1.4.1、服务无法启动1.4.2、单点发行1.4.3、平台支持1.4.4、虚拟化2、在Linux系统上安装MongoDB2.1、使用yum方式安装MongoDB2.2、卸载MongoDB2.3、使用其他方式安装MongoDB2.4、常见错误和注意事项2.4.1、允许访问cgroup2.4.2、系统ulimit值2.4.3、以yum方式安装MongoDB的自动更新问题1、在Windows系统上安装MongoDB在Windows系统上安装MongoDB首先需要确定自己的Windows系统版本以及MongoDB社区版所支持的系统版本。这里使用的是Windows 10操作系统和MongoDB8.0.4版本。由于MongoDB 6版本之后不再默认安装Mongo Shell因此本节分为两部分安装MongoDB和安装MongoDB Shell。1.1、安装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按钮开始下载如图所示。步骤2下载完成之后双击.msi安装包文件开始安装。在安装过程中会弹出安装向导界面指导使用者安装MongoDB以及MongoDB的可视化工具MongoDBCompass。安装包运行后界面如图所示。步骤3安装向导提示当前安装的MongoDB版本信息如图所示单击Next按钮。步骤4接受当前的终端用户安装协议选中同意协议的复选框(I accept the terms in the LicenseAgreement)单击Next按钮如图所示。步骤5选择安装类型MongoDB支持完整安装和个性化安装。个性化安装方式支持选择所需要的安装组件同时也支持自定义MongoDB的安装路径。官方推荐的是完整安装。对于初学者或对MongoDB使用不熟练的使用者建议默认完整安装。此方式会将MongoDB安装在路径C:\Program Files\MongoDB\Server\8.0下。选择Complete安装类型后单击Next按钮如图所示。步骤6配置服务从4.0版本开始MongoDB可以配置为一项Windows服务。在这个步骤中可以选择将MongoDB作为Windows的一个系统服务如图所示。在这个界面中可以配置服务的名称一般默认为MongoDB同时配置MongoDB的数据目录和日志目录。配置完成后单击Next按钮。如果这里不将MongoDB配置为Windows的服务可以手动启动具体可以查看后面关于手动启动MongoDB实例的内容。步骤7安装可视化工具MongoDB Compass。这里为可选项既可以安装也可以不安装。这里选中进行安装单击Next按钮进入下一步如图所示。步骤8进入安装进程。上述所有配置完成单击Install按钮进入安装进程如图所示。步骤9等待安装进程进行。整个过程可能会持续较长时间与所使用的计算机配置有关不同配置耗费的时间有所不同耐心等待即可如图所示。步骤10安装进程结束完成MongoDB和MongoDB Compass的安装。单击Finish按钮退出安装进程如图所示。如果将MongoDB作为服务安装那么安装结束后会自动开启服务。要查看MongoDB服务的状态可以打开系统服务界面按Ctrl Shift Esc组合键打开任务管理器切换到“服务”选项卡或者直接通过Windows系统的搜索找到“服务”界面在“服务”界面中找到MongoDB服务查看服务是否正在运行。在服务名称上右击可以选择开启或停止该服务如图所示。或者打开浏览器访问https://localhost:27017如图所示。同样也可以通过命令查看MongoDB服务的状态开启或停止MongoDB服务。命令如下#查看MongoDB服务的状态sc query MongoDB#停止MongoDB服务net stop MongoDB#开启MongoDB服务net start MongoDB执行结果如图所示。如果不作为服务安装那么需要手动启动MongoDB实例这里需要用到mongod命令。该命令在MongoDB安装目录下的bin文件夹(D:\MongoDB\Server\8.0\bin)下。启动时需要配置数据目录例如D:\MongoDB\data如图所示。MongoDB启动后该数据目录会生成一些数据库文件如图所示。在bin目录下存在一些关键文件如图所示。其中mongod.exe用来启动MongoDB服务mongos.exe用来管理分片集群。1.2、配置环境变量为了方便使用mongod以及其他命令可以将MongoDB的安装路径加入环境变量。在配置了环境变量后以上命令就可以省略路径只保留命令本身的名称。打开环境变量配置界面检查是否已自动创建环境变量如果没有则进行手动创建。首先创建MONGO_HOME的系统变量如图所示。然后编辑环境变量Path在最后加入一行内容内容为%MONGO_HOME%\bin最终结果如图所示。这样就完成了环境变量的配置。之后使用相关命令时不需要再进入命令所在目录。1.3、其他安装形式除前面介绍的安装方式外MongoDB还支持使用命令行工具msiexec.exe来安装。这种安装形式一般用在无人值守自动部署中。首先打开cmd命令窗口使用如下命令msiexec.exe /l*v mdbinstall.log /qb /i mongodb-windows-x86_64-8.0.4-signed.msi默认安装路径为C:\ProgramFiles\MongoDB\Server\6.0\bin可以使用INSTALLLOCATION配置项来修改安装路径msiexec.exe /l*v mdbinstall.log /qb /i mongodb-windows-x86_64-8.0.4-signed.msiINSTALLLOCATIONC:\MongoDB\Server\6.0如果同步安装可视化工具可以使用如下命令msiexec.exe /l*v mdbinstall.log /qb /i mongodb-windows-x86_64-8.0.4-signed.msiSHOULD_INSTALL_COMPASS0其他设置和操作与双击运行.msi安装包的形式相同。除以上形式外还支持.zip免安装形式。下载.zip文件后解压到相应目录根据以上操作配置环境变量即可。1.4、常见问题和注意事项1.4.1、服务无法启动安装完成后可能会出现服务无法启动的情况如图所示。首先检查是否存在MongoDB服务如果存在那么尝试手动启动如果启动失败那么先移除服务再尝试手动添加服务如果不存在MongoDB服务可以手动添加MongoDB服务。移除MongoDB服务的命令如下sc delete MongoDB添加服务的命令如下mongod-install-fC:\Program Files\MongoDB\Server\8.0\bin\mongod.cfg手动添加MongoDB服务后参考前述关于手动启动或停止MongoDB服务的描述使用界面或命令开启MongoDB服务。1.4.2、单点发行MongoDB的自动版本更新须在同一大版本下例如4.2.1到4.2.2可以自动更新但4.0到4.2这种全量更新需要重新安装。1.4.3、平台支持MongoDB 8.0社区版目前支持以下版本的64位Windows操作系统Windows Server 2019Windows Server 2016Windows 7/10/111.4.4、虚拟化如果要使用VirtualBox在Windows系统上安装MongoDB则需要禁用Hyper-V。2、在Linux系统上安装MongoDBMongoDB官网提供了多个Linux版本操作系统的安装指南例如Red Hat、CentOS、Ubuntu、Debian和SUSE等版本的操作系统。限于篇幅这里不再一一描述。可到官网进行查看地址为https://www.mongodb.com/docs/manual/administration/install-on-linux/。Red Hat是商业版的Linux系统与CentOS基本相似所以它们的安装方式以及支持的MongoDB版本基本类似。下面以CentOS 7为例讲解MongoDB的安装方法。此安装教程同样适用于Red Hat Enterprise Linux 7(RHEL7)、Oracle Linux、Rocky Linux和AlmaLinux。与在Windows系统上安装MongoDB一样这里选择的MongoDB版本为8.0.4该数据库版本支持的操 作系统版本如下RHEL(Red Hat Enterprise Linux)CentOSOracle LinuxRocky LinuxAlmaLinux 9(Starting in MongoDB 8.0.4)AlmaLinux 82.1、使用yum方式安装MongoDB在CentOS系统上安装MongoDB有多种方式可以直接使用在线yum方式安装无须提前下载安装包也可以直接到https://repo.mongodb.org/yum/redhat/页面下载rpm文件安装或者在官网https://www.mongodb.com/try/download/community页面下载tgz文件进行安装。下面演示如何使用yum方式进行在线安装。首先创建repo文件文件目录为/etc/yum.repos.d/mongodb-org-8.0.repo文件内容如下[mongodb-org-8.0]nameMongoDB Repositorybaseurlhttps://repo.mongodb.org/yum/redhat/7/mongodb-org/8.0/x86_64/gpgcheck1enabled1gpgkeyhttps://www.mongodb.org/static/pgp/server-8.0.ascrepo文件内容如图所示。如果使用的是Red Hat Enterprise Linux 8那么baseurl需要换成https://repo.mongodb.org/yum/redhat/8/mongodb-org/8.0 x86_64/以此类推。创建完成后执行安装命令如下所示sudoyuminstall-ymongodb-org结果如图所示。如果要指定MongoDB 6.0下的某个版本可以执行如下语句sudoyuminstall-ymongodb-org-6.0.10 mongodb-org-database-6.0.10 mongodb-org-server-6.0.10 mongodb-org-mongos-6.0.10 mongodb-org-tools-6.0.10结果如图所示。默认情况下MongoDB使用mongod的Linux系统用户账户使用如下默认的数据目录和日志目录安装过程中会自动创建上述目录。/var/lib/mongo(the data directory)/var/log/mongodb(the log directory)如果要修改该目录可以修改mongod.conf文件的配置。storage.dbPath配置数据目录例如/some/data/directory。systemLog.path配置日志目录例如/some/log/directory/mongod.log。创建完成后确保当前登录系统的用户账号有权限操作这些文件和目录如果没有的话可以使用如下命令配置sudochown-Rmongod:mongod /some/data/directory安装完成后要运行和管理mongod进程需要使用操作系统的内置初始化系统启动或停止该进程。新版本的Linux使用systemd使用命令systemctl​而旧版本的Linux使用System V init使用命令service​这里的CentOS 7使用的是sysemctl。如果无法确定应该使用哪个命令请在Linux下运行以下命令来确定ps--no-headers-ocomm1如果结果为systemd则使用systemctl命令如果结果为init则使用service命令。作者执行命令的结果如图所示。确定命令后使用命令开启MongoDB服务。命令如下sudosystemctl start mongod验证MongoDB是否已成功启动。通过以下命令进行检查sudosystemctl status mongod执行结果如图所示。从图中可以看到MongoDB当前的状态、启动的时间、配置文件的目录以及启动服务所使用的sh命令脚本文件。如果希望MongoDB随操作系统自动重启可以使用如下命令sudosystemctlenablemongod停止MongoDB服务可以使用如下命令sudosystemctl stop mongod重新启动MongoDB可以使用如下命令sudosystemctl restart mongodMongoDB启动后会生成相关的日志文件此文件可用来跟踪错误或重要消息的进程状态日志文件目录为/var/log/mongodb/mongod.log。完成以上操作后确保MongoDB处于开启状态开始使用mongosh连接数据库。与Windows不同Linux下会直接安装mongosh脚本而不需要再次手动安装。Mongosh脚本工具命令为mongosh执行结果如图所示。至此就可以使用数据库命令操作数据库了。例如显示当前的数据库如图所示。2.2、卸载MongoDB要从系统中完全删除MongoDB必须删除MongoDB应用程序本身、配置文件以及包含以下内容的任何目录、数据和日志。本小节内容将指导读者完成必要的步骤。下面的卸载过程将完全删除MongoDB及其配置和所有数据库。此过程是不可逆的因此在继续操作之前请确保备份所有的配置和数据。1停止MongoDB停止mongod服务可以通过以下命令完成sudoservicemongod stop2删除包删除以前安装的所有MongoDB包sudoyum erase$(rpm-qa|grepmongodb-org)3删除数据目录删除MongoDB数据库和日志文件sudorm-r/var/log/mongodbsudorm-r/var/lib/mongo2.3、使用其他方式安装MongoDBMongoDB同样支持以tgz压缩包形式进行安装。首先使用如下命令安装依赖包sudoyuminstalllibcurl openssl xz-libs然后到官网下载tgz压缩包下载完成后解压缩命令如下tar-zxvfmongodb-linux-*-8.0.4.tgz将MongoDB的bin目录配置到环境变量的Path中。支持如下两种方式复制MongoDB的bin目录下的文件到path变量中已配置的某一路径中例如sudo cp/path/to/the/mongodb-directory/bin/* /usr/local/bin/。在MongoDB的bin目录和path变量中已配置的某一路径之间创建系统链接映射例如sudo ln -s/path/to/the/mongodb-directory/bin/*/usr/local/bin/。这种方式安装的MongoDB的默认数据目录和日志目录与yum方式一样。首先创建目录sudomkdir-p/var/lib/mongosudomkdir-p/var/log/mongodb因为MongoDB默认使用的系统用户为mongod所以同样需要为group为mongod、用户名为mongod的用户进行目录授权sudochown-Rmongod:mongod /var/lib/mongosudochown-Rmongod:mongod /var/log/mongodb如果不使用默认目录则修改方式与yum方式相同。2.4、常见错误和注意事项2.4.1、允许访问cgroup当前的SELinux策略不允许MongoDB进程访问/sys/fs/cgroup这样MongoDB就无法确定系统上的可用内存。如果你打算强制运行SELinux则需要进行以下调整。首先确保你的系统已安装软件包checkpolicysudoyuminstallcheckpolicy其次创建自定义策略文件mongodb_cgroup_memory.teMongoDB进程现在能够以SELinux模式强制访问文件了。2.4.2、系统ulimit值大多数类UNIX系统会限制进程所使用的系统资源数MongoDB 4.4之后这个值低于64 000会影响MongoDB系统的运行这个数值建议设置到64 000。2.4.3、以yum方式安装MongoDB的自动更新问题以yum方式安装的MongoDB会自动更新如果想要关闭自动更新功能可以修改/etc/yum.conf在文件中加入如下内容