MongoDB的「Linux」安装及基本使用

0. 写在前面

Linux：Ubuntu Kylin16.04
集群搭建方式：伪分布式
MongoDB：MongoDB3.2.7
部署方式：单机部署

1. 下载并安装MongoDB

官网下载

https://www.mongodb.com/try/download/community

选择Community Server下载即可

解压

root@node01:~$ tar -zxvf mongodb-linux-x86_64-ubuntu1604-4.2.8.tgz -C /usr/local

配置环境变量

root@node01:~$ vim ./.bashrc

添加如下内容

#MongoDB
export MONGODB_HOME=/usr/local/mongodb-3.2.7
export PATH=$PATH:$MONGODB_HOME/bin

记得source使环境变量生效

root@node01:~$ source ./.bashrc

查看版本号

root@node01:~$ mongo --version
MongoDB shell version: 3.2.7

2. 启动方式

2.1 直接启动

直接启动，配置参数在命令行中声明

提前创建MongoDB服务的数据存储目录和日志目录

root@node01:/usr/local/mongodb-3.2.7$ mkdir -p ./data/db
root@node01:/usr/local/mongodb-3.2.7$ mkdir -p ./log

命令行启动「--fork」

root@node01:/usr/local/mongodb-3.2.7$ mongod --dbpath data/db --logpath log/mongod.log --fork

停止服务使用「--shutdown」

root@node01:/usr/local/mongodb-3.2.7$ mongod --dbpath data/db --logpath log/mongod.log --shutdown

2.2 以「配置文件」方式启动

有两种方式

2.2.1 使用默认配置文件

默认配置文件是：/etc/mongod.conf

root@node01:/usr/local/mongodb-3.2.7$ mongod -f /etc/mongod.conf

2.2.2 自定义配置文件

#数据存储目录
mkdir -p /mongodb/single/data/db
#日志存储目录
mkdir -p /mongodb/single/log

新建并修改配置文件

vim /mongodb/single/mongod.conf

配置文件的内容如下：

systemLog:
  #MongoDB发送所有日志输出的目标指定为文件
  # #The path of the log file to which mongod or mongos should send all diagnostic logging information
  destination: file
  #mongod或mongos应向其发送所有诊断日志记录信息的日志文件的路径
  path: "/mongodb/single/log/mongod.log"
  #当mongos或mongod实例重新启动时，mongos或mongod会将新条目附加到现有日志文件的末尾。
  logAppend: true
storage:
  #mongod实例存储其数据的目录。storage.dbPath设置仅适用于mongod。
  ##The directory where the mongod instance stores its data.Default Value is "/data/db".
  dbPath: "/mongodb/single/data/db"
  journal:
    #启用或禁用持久性日志以确保数据文件保持有效和可恢复。
    enabled: true 
processManagement:
  #启用在后台运行mongos或mongod进程的守护进程模式。
  fork: true
net:
  #服务实例绑定的IP，默认是localhost
  bindIp: localhost
#bindIp
  #绑定的端口，默认是27017
  port: 27017

启动服务

root@node01:/usr/local/mongodb-3.2.7$ mongod --config /mongodb/single/mongod.conf
about to fork child process, waiting until server is ready for connections.
forked process: 3286
child process started successfully, parent exiting

强烈建议自己创建配置文件，使用第二种方式启动服务，本文讲述均以此种方式

查看服务进程

root@node01:/usr/local/mongodb-3.2.7$ ps -ef | grep mongod
root       3286     1  0 16:35 ?        00:00:23 /usr/local/mongodb-3.2.7/bin/mongod -f /mongodb/single/mongod.conf
root       3421  3086  0 17:30 pts/0    00:00:00 grep --color=auto mongod

3. 自定义配置文件启动MongoDB服务失败解决方法

报错信息

解决“Error parsing YAML config file: yaml-cpp: error at line 2, column 13: illegal map value”（安装服务）
try '/usr/local/mongodb-3.2.7/bin/mongod --help' for more information

检查配置文件是否写错
yaml格式问题

yaml前置芝士

YAML的基本语法规则

大小写敏感
使用缩进表示层级关系
缩进时不允许使用Tab键，只允许使用空格。(可以将你的ide的tab按键输出替换成4个空格)
缩进的空格数目不重要，只要相同层级的元素左侧对齐即可
'#'表示注释

第三小点尤为重要，不要使用Tab键实现缩进，请用空格实现缩进

YAML格式使用KV方式<key>: <value>表示，以空格作为缩进，若value存在，在之后的:后面，即value值的前面需要紧跟一个空格；如：destination: file

4. 基本使用

查看数据库/集合

> show dbs;
local  0.000GB

> use dbtest
> show collections

查找数据

> db.colltest.find()
{ "_id" : 11, "item" : "Pencil", "qty" : 50, "type" : "no.2" }
{ "_id" : ObjectId("6329f410665960c08e8943bf"), "_item" : "pen", "qty" : 20 }
{ "_id" : ObjectId("6329f410665960c08e8943c0"), "item" : "eraser", "qty" : 25 }

删除数据库

db.dropDatabase()

数据库操作

> db.help()
DB methods:
  db.adminCommand(nameOrDocument) - switches to 'admin' db, and runs command [ just calls db.runCommand(...) ]
  db.auth(username, password)
  db.cloneDatabase(fromhost)
  db.commandHelp(name) returns the help for the command
  db.copyDatabase(fromdb, todb, fromhost)
  db.createCollection(name, { size : ..., capped : ..., max : ... } )
  db.createUser(userDocument)
  db.currentOp() displays currently executing operations in the db
  db.dropDatabase()
  db.eval（) - deprecated
  db.fsyncLock() flush data to disk and lock server for backups
  db.fsyncUnlock() unlocks server following a db.fsyncLock()
  db.getCollection(cname) same as db['cname'] or db.cname
  db.getCollectionInfos([filter]) - returns a list that contains the names and options of the db's collections
  db.getCollectionNames()
  db.getLastError() - just returns the err msg string
  db.getLastErrorObj() - return full status object
  db.getLogComponents()
  db.getMongo() get the server connection object
  db.getMongo().setSlaveOk() allow queries on a replication slave server
  db.getName()
  db.getPrevError()
  db.getProfilingLevel() - deprecated
  db.getProfilingStatus() - returns if profiling is on and slow threshold
  db.getReplicationInfo()
  db.getSiblingDB(name) get the db at the same server as this one
  db.getWriteConcern() - returns the write concern used for any operations on this db, inherited from server object if set
  db.hostInfo() get details about the server's host
  db.isMaster() check replica primary status
  db.killOp(opid) kills the current operation in the db
  db.listCommands() lists all the db commands
  db.loadServerScripts() loads all the scripts in db.system.js
  db.logout()
  db.printCollectionStats()
  db.printReplicationInfo()
  db.printShardingStatus()
  db.printSlaveReplicationInfo()
  db.dropUser(username)
  db.repairDatabase()
  db.resetError()
  db.runCommand(cmdObj) run a database command.  if cmdObj is a string, turns it into { cmdObj : 1 }
  db.serverStatus()
  db.setLogLevel(level,<component>)
  db.setProfilingLevel(level,<slowms>) 0=off 1=slow 2=all
  db.setWriteConcern( <write concern doc> ) - sets the write concern for writes to the db
  db.unsetWriteConcern( <write concern doc> ) - unsets the write concern for writes to the db
  db.setVerboseShell(flag) display extra information in shell output
  db.shutdownServer()
  db.stats()
  db.version() current version of the server

停止关闭服务

停止服务的方式有两种：快速关闭和标准关闭，下面依次说明：（一）快速关闭方法（快速，简单，数据可能会出错）目标：通过系统的kill命令直接杀死进程：杀完要检查一下，避免有的没有杀掉。【补充】如果一旦是因为数据损坏，则需要进行如下操作（了解）： 1）删除lock文件：

rm -f /mongodb/single/data/db/*.lock

2）修复数据：

/usr/local/mongdb-3.2.7/bin/mongod --repair --dbpath=/mongodb/single/data/db

（二）标准的关闭方法（数据不容易出错，但麻烦）：目标：通过mongo客户端中的shutdownServer命令来关闭服务主要的操作

//客户端登录服务，注意，这里通过localhost登录，如果需要远程登录，必须先登录认证才行。
mongo --port 27017
//#切换到admin库
use admin
//关闭服务
db.shutdownServer()

需要使用admin数据库，官方说明如下：

db.shutdownServer()
Shuts down the current mongod or mongos process cleanly and safely.
This operation fails when the current database is not the admin database.
This command provides a wrapper around the shutdown command.

> db.shutdownServer()
server should be down...
2022-09-20T17:37:40.772+0800 I NETWORK  [thread1] trying reconnect to 127.0.0.1:27017 (127.0.0.1) failed
2022-09-20T17:37:40.773+0800 W NETWORK  [thread1] Failed to connect to 127.0.0.1:27017, reason: errno:111 Connection refused
2022-09-20T17:37:40.773+0800 I NETWORK  [thread1] reconnect 127.0.0.1:27017 (127.0.0.1) failed failed

注意：这里failed不是停止服务失败见下方MongoDB Community的论坛回答链接

https://www.mongodb.com/community/forums/t/db-shutdownserver-giving-connection-error/29333

There is no problem here. You shutdown the server. It is normal that the mongo cannot connect to the server, it is now down. Just exit the shell.

这里没有问题。你关闭了服务器。 mongo连接不上服务器是正常的，现在宕机了。只需退出外壳。

5. 参考

https://www.runoob.com/mongodb/mongodb-linux-install.html
https://www.runoob.com/w3cnote/yaml-intro.html

秒客网

MongoDB的「Linux」安装及基本使用