【MongoDB 配置篇】MongoDB 配置文件详解
目录
1 数据库环境
2 配置文件
2.1 配置文件格式
2.2 配置文件的使用
3 配置文件核心选项
3.1 systemLog选项
3.2 processManagement选项
3.3 cloud选项
3.4 net选项
3.5 security选项
3.6 setParameter选项
3.7 storage选项
3.8 operationProfiling选项
3.9 replication选项
3.10 sharding选项
3.11 auditLog选项
3.12 snmp选项
MongoDB实例的运行离不开相应的参数配置，比如对数据库存放路径dbpath的配置，对于参数的配置，可以在命令行以选项的形式进行配置，也可以将配置信息列入配置文件进行配置。但是，使用配置文件将会使对mongod和mongos的管理变得更加容易，本篇将会对配置文件进行详细的讲解。
1 数据库环境
[mongod@strong ~]$ mongod --version
db version v4.2.0
git version: a4b751dcf51dd249c5865812b390cfd1c0129c30
OpenSSL version: OpenSSL 1.0.1e-fips 11 Feb 2013
allocator: tcmalloc
modules: none
build environment:
distmod: rhel62
distarch: x86_64
target_arch: x86_64
2 配置文件
2.1 配置文件格式
MongoDB配置文件使用YAML的格式。
2.2 配置文件的使用
对于配置文件的使用，在mongod或mongos中指定--config或-f选项。
1）指定--config选项
[mongod@strong ~]$ mongod --config /etc/mongo.cnf
2）指定-f选项
[mongod@strong ~]$ mongod -f /etc/mongo.cnf
3 配置文件核心选项
3.1 systemLog选项
1）选项
systemLog:
verbosity:
quiet:
traceAllExceptions:
syslogFacility:
path:
logAppend:
logRotate:
destination:
timeStampFormat:
component:
accessControl:
verbosity:
command:
verbosity:
# COMMENT additional component verbosity settings omitted for brevity
2）说明
verbosity：默认为0，值范围为0-5，用于输出日志信息的级别，值越大，输出的信息越多；
quiet：mongod或mongos运行的模式，在该模式下限制输出的信息，不推荐使用该模式；
traceAllExceptions：打印详细信息以便进行调试；
path：日志文件的路径，mongod或mongos会将所有诊断日志信息发送到该位置，而不是标准输出或主机的syslog上；
logAppend：默认为false，若设为true，当mongod或mongos实例启动时，会将新的条目追加到已存在的日志文件，否则，mongod会备份已存在的日志，并创建新的日志文件；
destination：指定日志输出的目的地，具体值为file或syslog，若设置为file，需指定path，该选项未指定，则将所有日志输出到标准输出；
timeStampFormat：日志信息中的时间格式，默认为iso8601-local，该选项有三个值，分别为ctime、iso8601-utc和iso8601-local；
3.2 processManagement选项
1）选项
processManagement:
fork:
pidFilePath:
timeZoneInfo:
2）说明
fork：默认值为false，设置为true，会激活守护进程在后台运行mongod或mongos进程；
pidFilePath：指定mongod或mongos写PID文件的路径，不指定该值，则不会创建PID文件；
3.3 cloud选项
1）选项
cloud:
monitoring:
free:
state:
tags:
2）说明
state：激活或禁用免费的MongoDB Cloud监控，该选项有以下三个值，分别为runtime、on和off，默认为runtime；在运行时可以通过db.enableFreeMonitoring()和db.disableFreeMonitoring()
tags：描述环境上下文的可选标记；
3.4 net选项
1）选项
net:
port:
bindIp:
bindIpAll:
maxIncomingConnections:
wireObjectCheck:
ipv6:
unixDomainSocket:
enabled:
pathPrefix:
filePermissions:
tls:
certificateSelector:
clusterCertificateSelector:
mode:
certificateKeyFile:
certificateKeyFilePassword:
clusterFile:
clusterPassword:
CAFile:
clusterCAFile:
CRLFile:
allowConnectionsWithoutCertificates:
allowInvalidCertificates:
allowInvalidHostnames:
disabledProtocols:
FIPSMode:
compression:
compressors:
serviceExecutor:
2）说明
port：MongoDB实例监听客户端连接的TCP端口，对于mongod或mongos实例，默认端口为27017，对于分片成员，默认端口为27018，对于配置服务器成员，默认端口为27019；
bindIp：默认值为localhost。主机名、IP地址或Unix套接字，mongod或mongos在其上监听客户端的连接，绑定多个地址，以逗号分隔，若绑定所有IPv4地址，可输入0.0.0.0；
bindIpAll：默认值为false，设置为true，mongod或mongos实例将会绑定所有IPv4地址；
maxIncomingConnections：默认值为65536，mongod或mongos接收的最大连接数；
3.5 security选项
1）选项
security:
keyFile:
clusterAuthMode:
authorization:
transitionToAuth:
javascriptEnabled:
redactClientLogData:
clusterIpSourceWhitelist:
-
sasl:
hostName:
serviceName:
saslauthdSocketPath:
enableEncryption:
encryptionCipherMode:
encryptionKeyFile:
kmip:
keyIdentifier:
rotateMasterKey:
serverName:
port:
clientCertificateFile:
clientCertificatePassword:
clientCertificateSelector:
serverCAFile:
ldap:
servers:
bind:
method:
saslMechanisms:
queryUser:
queryPassword:
useOSDefaults:
transportSecurity:
timeoutMS:
userToDNMapping:
authz:
queryTemplate:
2）说明
keyFile：存储共享密钥文件的路径，MongoDB实例使用它在分片集群或副本集中彼此进行身份验证；
clusterAuthMode：默认值为keyFile；
3.6 setParameter选项
1）选项
setParameter:
2）说明
设置MongoDB服务器的参数；
3.7 storage选项
1）选项
storage:
dbPath:
indexBuildRetry:
journal:
enabled:
commitIntervalMs:
directoryPerDB:
syncPeriodSecs:
engine:
wiredTiger:
engineConfig:
cacheSizeGB:
journalCompressor:
directoryForIndexes:
collectionConfig:
blockCompressor:
indexConfig:
prefixCompression:
inMemory:
engineConfig:
inMemorySizeGB:
2）说明
dbPath：默认值为/data/db，mongod实例存储数据的目录；
indexBuildRetry：默认值为true，指定mongod在下次启动时是否重建未完成的索引；
enabled：64位系统默认为true，32位系统默认为false，是否激活日志以确定数据文件仍然有效以及可进行恢复；
commitIntervalMs：默认值为100毫秒，取值范围为1-500毫秒；
directoryPerDB：默认值为false，设置为true，每个数据库使用单独的目录存储数据，目录位于dbPath目录之下；
syncPeriodSecs：默认值为60，MongoDB通过fsync操作将数据刷新到数据文件之前经过的时间；
engine：默认值为wireTiger，4.2版本之后，MMAPv1存储引擎将会被废弃；
cacheSizeGB：定义wireTiger将为所有数据使用的内部缓存的大小，索引构建消耗的内存与wireTiger缓存内存时分开的，从MongoDB 3.4开始，该值的范围可以从0.25GB到10000GB，可以是浮点数，默认值是50%*（ RAM - 1 GB ）或256MB；
journalCompressor：默认值为snappy，指定用于压缩wireTiger日志数据的压缩类型，压缩类型有以下几种，分别为none、snappy、zlib和sztd；
directoryForIndexes：默认为false，设置为true，mongod将索引和集合存储在data（dbPath）目录下的单独子目录中，即索引存放在名字为index的子目录中，集合数据存放在名字为collection的子目录中；
blockCompressor：默认为snappy，指定集合数据的默认压缩类型，有以下几种类型，分别为none、snappy、zlib和sztd；
prefixCompression：默认为true，启用或禁用索引数据的前缀压缩；
3.8 operationProfiling选项
1）选项
operationProfiling:
mode:
slowOpThresholdMs:
slowOpSampleRate:
2）说明
mode：默认为off，指定应该分析哪些操作，分析器级别有如下几种，分别为off、slowOp和all；
slowOpThresholdMs：默认值为100；
slowOpSampleRate：默认值为1.0；
3.9 replication选项
1）选项
replication:
oplogSizeMB:
replSetName:
secondaryIndexPrefetch:
enableMajorityReadConcern:
2）说明
oplogSizeMB：复制操作日志的最大大小，以M为单位，默认情况下，mongod进程基于最大可用空间创建oplog，对于64位系统，oplog通常占可用磁盘空间的5%；
replSetName：副本集的名称；
enableMajorityReadConcern：默认为true，在PSA架构中，可以禁用该选项以缓解存储缓存的压力；
3.10 sharding选项
1）选项
sharding:
clusterRole:
archiveMovedChunks:
2）说明
clusterRole：设置在分片集群中mongod实例的角色，有以下值可供选择，分别为configsvr和shardsvr；
3.11 auditLog选项
1）选项
auditLog:
destination:
format:
path:
filter:
2）说明
企业版选项，用于审计；
3.12 snmp选项
1）选项
snmp:
disabled:
subagent:
master:
2）说明
disabled：默认值为false，禁用SNMP对mongod的访问；