mongodb 配置文件
本文档是在mongodb为3.4下编写的，仅作为参考，详细内容请参考：https://docs.mongodb.com/manual/reference/configuration-options/#configuration-file
一.说明
配置mongodb有两种方式，一种是通过mongod和mongos两个命令；另外一种方式就是配置文件的方式。因为更容易去管理，所以后者更受大家的青睐。
二. 配置文件格式
mongodb 配置文件采用的YAML格式;
例如：
systemLog:
destination: file
path: "/var/log/mongodb/mongod.log"
logAppend: true
storage:
journal:
enabled: true
processManagement:
fork: true
net:
bindIp: 127.0.0.1
port: 27017
setParameter:
enableLocalhostAuthBypass: false
三 使用配置文件
通过mongod和mongos命令去执行配置文件，这里要使用他们的一个选项--config（这里是两个横线,具体查看 > mongod --help）或者-f(--config的简写)
例如：
mongod --config D:/mongodb/mongod.conf mongos --config D:/mongodb/mongos.conf
或
mongod -f D:/mongodb/mongod.conf mongos -f D:/mongodb/mongos.conf
四 配置文件的核心选项
1. systemLog 选项
systemLog:
verbosity: <int>
quiet: <boolean>
traceAllExceptions: <boolean>
syslogFacility: <string>
path: <string>
logAppend: <boolean>
logRotate: <string>
destination: <string>
timeStampFormat: <string>
component:
accessControl:
verbosity: <int>
command:
verbosity: <int>
systemLog.traceAllExceptions
类型：boolean
作用: 为调试打印详细信息，用于支持相关的故障排除。
systemLog.syslogFacility
类型：string
默认值：user
作用：将mongodb使用日志记录到系统日志中，如果要使用这个选项，必须开启--sysylog选项
systemLog.path
类型:string
作用：指定日志文件的目录
syetemLog.logAppend
类型：boolean
默认值：False
作用：当mongod或mongos重启时，如果为true，将日志追加到原来日志文件内容末尾；如果为false，将创建一个新的日志文件
systemLog.destination
类型：string
作用：指定日志文件的路径，如果设置了这个值，必须指定systemLog.path.如果没有设置，日志会标准的输出到后台
systemLog.timeStampFormat
类型：string
默认值：iso8601-local
作用：为日志添加时间戳。
| 值 | 描述 |
| ctime | 显示时间戳格式为：Wed Dec 31 18:17:54.811. |
| iso8601-utc | 安装iso-8601-utc格式显示：1970-01-01T00:00:00.000Z |
| iso8601-local | 按照iso8601-local格式显示：1969-12-31T19:00:00.000-0500 |
processMangement 选项
processManagement: fork: <boolean> pidFilePath: <string>
processMangement.fork
类型：Boolean
默认值：False
作用：在前台启动Mongodb进程，如果Session窗口关闭，Mongodb进程也随之停止。不过Mongodb同时还提供了一种后台Daemon方式启动，只需要加上一个"--fork"参数即可，值得注意的是，用到了"--fork"参数就必须启用"--logpath"参数。如下所示：
[root@localhost mongodb]# ./bin/mongod --dbpath=data/db --fork --fork has to be used with --logpath [root@localhost mongodb]# ./bin/mongod --dbpath=data/db --fork --logpath=log/mongodb.log all output going to: /opt/mongodb/log/mongodb.log forked process: 3300
daemon方式启动的fork参数也可以配置配置文件中，如下所示：
port=27017 dbpath=data/db logpath=log/mongodb.log logappend=true fork=true
net 选项
net:
port: <int>
bindIp: <string>
maxIncomingConnections: <int>
wireObjectCheck: <boolean>
ipv6: <boolean>
unixDomainSocket:
enabled: <boolean>
pathPrefix: <string>
filePermissions: <int>
http:
enabled: <boolean>
JSONPEnabled: <boolean>
RESTInterfaceEnabled: <boolean>
ssl:
sslOnNormalPorts: <boolean> # deprecated since 2.6
mode: <string>
PEMKeyFile: <string>
PEMKeyPassword: <string>
clusterFile: <string>
clusterPassword: <string>
CAFile: <string>
CRLFile: <string>
allowConnectionsWithoutCertificates: <boolean>
allowInvalidCertificates: <boolean>
allowInvalidHostnames: <boolean>
disabledProtocols: <string>
FIPSMode: <boolean>
compression:
compressors: <string>
net.port
类型:integer
默认值：27017
作用：设置mongodb的监听TCP端口
net.bindIp
类型：string
作用:设置mongodb服务器监听ip地址，默认是127.0.0.1；如果监听多个ip地址，使用逗号隔开
net.maxIncomingConnections
类型：integer
默认值：65536
作用:最大并发链接数
net.ipv6
类型：boolean
默认值：false
作用：开启或关闭支持ipv6地址；
security 选项
security:
keyFile: <string>
clusterAuthMode: <string>
authorization: <string>
transitionToAuth: <boolean>
javascriptEnabled: <boolean>
redactClientLogData: <boolean>
sasl:
hostName: <string>
serviceName: <string>
saslauthdSocketPath: <string>
enableEncryption: <boolean>
encryptionCipherMode: <string>
encryptionKeyFile: <string>
kmip:
keyIdentifier: <string>
rotateMasterKey: <boolean>
serverName: <string>
port: <string>
clientCertificateFile: <string>
clientCertificatePassword: <string>
serverCAFile: <string>
ldap:
servers: <string>
bind:
method: <string>
saslMechanisms: <string>
queryUser: <string>
queryPassword: <string>
useOSDefaults: <boolean>
transportSecurity: <string>
timeoutMS: <int>
userToDNMapping: <string>
authz:
queryTemplate: <string>
....查看mongodb手册 #security选项
setParameter 选项
设置mongodb参数，查看参数列表
采用YAML语言格式
setParameter: <parameter1>: <value1> <parameter2>: <value2>
storage 选项
storage:
dbPath: <string>
indexBuildRetry: <boolean>
repairPath: <string>
journal:
enabled: <boolean>
commitIntervalMs: <num>
directoryPerDB: <boolean>
syncPeriodSecs: <int>
engine: <string>
mmapv1:
preallocDataFiles: <boolean>
nsSize: <int>
quota:
enforced: <boolean>
maxFilesPerDB: <int>
smallFiles: <boolean>
journal:
debugFlags: <int>
commitIntervalMs: <num>
wiredTiger:
engineConfig:
cacheSizeGB: <number>
journalCompressor: <string>
directoryForIndexes: <boolean>
collectionConfig:
blockCompressor: <string>
indexConfig:
prefixCompression: <boolean>
inMemory:
engineConfig:
inMemorySizeGB: <number>
storage.dbPath
类型:string
默认值：/data/db(linux和macOS系统) ，\data\db(window系统)
作用：设置数据存储文件目录
storage.indexBuildRetry
类型:boolean
默认值：true
作用:开启或关闭是否在mongod下次启动重建不完整的索引。
注：在in-memory存储引擎下不可用
storage.repairPath
类型:string
默认值：在dbpath下的A _tmp_repairDatabase_<num> 文件目录
作用:为进行恢复操作指定目录
注意:仅仅在MMAPv1存储引擎下可用
storage.journal.enabled
类型:boolean
默认值：true(64-bit系统）；false（32-bit系统）
作用：开启和关闭journal，为了保证数据文件的有效性和可恢复性；在设置了dbpath之后有效
注：在in-memory存储引擎下不可用
storage.directoryPerDB
类型:boolean
默认值:false
作用：当为true，mongodb为每个数据库建立一个单独的路径，这个路径是在dbpath下创建的；每次创建需要重启服务器
注：在in-memory存储引擎下不可用
storage.engine
默认值：wiredTiger
作用:这是数据存储引擎
| 值 | 描述 |
| MMAPV1 | MMAPCV1 storage engine |
| wiredTiger | WiredTiger Storage Engine. |
| inMemory | In-Memory Storage Engine. |
storage.mmapv1 选项
storage:
mmapv1:
preallocDataFiles: <boolean>
nsSize: <int>
quota:
enforced: <boolean>
maxFilesPerDB: <int>
smallFiles: <boolean>
journal:
debugFlags: <int>
commitIntervalMs: <num>
storage.mmapv1.preallocDataFiles
类型:boolean
默认值：true
作用:开启或关闭数据文件的预分配；
storage.mmapv1.quota.enforced
类型:boolean
默认值：false
作用：开启或关闭每个数据库中的数据文件个数的限额；默认是每个数据库最多有8个数据文件，通过调整storage.mmapv1.quota.maxFilesPerDB
storage.mmapv1.quota.maxFilesPerDB
类型：integer
默认值：8
作用:设置每个数据库中数据文件的限制个数；
storage.wiredTiger 选项
storage:
wiredTiger:
engineConfig:
cacheSizeGB: <number>
journalCompressor: <string>
directoryForIndexes: <boolean>
collectionConfig:
blockCompressor: <string>
indexConfig:
prefixCompression: <boolean>
storage.wiredTiger.engineConfig.cacheSizeGB
类型:float
作用：设置缓存大小，从3.4版本开始，内存的50%-1GB 和256MB的最大值
storage.wriedTiger.engineConfig.journalCompressor
默认值：snappy
作用：设置journal压缩方式；可选项：none/snappy/zlib
storage.inmemory 选项
storage:
inMemory:
engineConfig:
inMemorySizeGB: <number>
storage.inmemory.engineConfig.inMemorySizeGB
类型：float
默认值：物理内存的50%-1GB
作用：设置缓冲区大小；
opeartionProfiling 选项
operationProfiling: slowOpThresholdMs: <int> mode: <string>
opeartionProfiling.slowOpThresholdMs
类型:integer
默认值：100
作用：设置区分慢查询的一个阈值，比如100，当查询速度大于100ms，记录到日志中
operationProfiling.mode
类型：string
默认值：off
replication 选项
replication: oplogSizeMB: <int> replSetName: <string> secondaryIndexPrefetch: <string> enableMajorityReadConcern: <boolean>
replication.oplogSizeMB
类型:integer
作用：设置复制日志文件的大小；
sharding 选项
sharding: clusterRole: <string> archiveMovedChunks: <boolean>
sharding.clusterRole
类型:string
作用:设置分片集群中的角色；
| 值 | 描述 |
| configsvr | 作为配置服务器，默认端口27019 |
| shardsvr | 作为一个分片，默认端口27018 |
auditLog 选项 （MongoDB Enterprise可用）
auditLog: destination: <string> format: <string> path: <string> filter: <string>
auditLog.destination
类型：string
作用:审计日志位置；
| 值 | 描述 |
| syslog | JSON文件格式输出在系统日志中，window系统中不可用 |
| console | JSON格式输出 |
| file | 输出到文件 |
auditLog.format
类型:string
作用:设置设计日志输出格式；可用值：JSON/BSON
auditLog.path
类型:string
作用:设计日志输出文件路径
类型:string
作用:审计日志过滤器
格式：{ <field1>: <expression1>, ... }
