转【MongoDB 配置篇】MongoDB 配置文件详解
目录
MongoDB实例的运行离不开相应的参数配置，比如对数据库存放路径dbpath的配置，对于参数的配置，可以在命令行以选项的形式进行配置，也可以将配置信息列入配置文件进行配置。但是，使用配置文件将会使对mongod和mongos的管理变得更加容易，本篇将会对配置文件进行详细的讲解。
1 数据库环境
[mongod@strong ~]$ mongod --versiondb 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: <int>
quiet: <boolean>
traceAllExceptions: <boolean>
syslogFacility: <string>
path: <string>
logAppend: <boolean>
logRotate: <string>
destination: <string>
timeStampFormat: <string>
component:
accessControl:
verbosity: <int>
command:
verbosity: <int> # 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: <boolean> pidFilePath: <string> timeZoneInfo: <string>
2）说明
-
fork：默认值为false，设置为true，会激活守护进程在后台运行mongod或mongos进程；
-
pidFilePath：指定mongod或mongos写PID文件的路径，不指定该值，则不会创建PID文件；
3.3 cloud选项
1）选项
cloud:
monitoring:
free:
state: <string>
tags: <string>
2）说明
-
state：激活或禁用免费的MongoDB Cloud监控，该选项有以下三个值，分别为runtime、on和off，默认为runtime；在运行时可以通过db.enableFreeMonitoring()和db.disableFreeMonitoring()
-
tags：描述环境上下文的可选标记；
3.4 net选项
1）选项
net:
port: <int>
bindIp: <string>
bindIpAll: <boolean>
maxIncomingConnections: <int>
wireObjectCheck: <boolean>
ipv6: <boolean>
unixDomainSocket:
enabled: <boolean>
pathPrefix: <string>
filePermissions: <int>
tls:
certificateSelector: <string>
clusterCertificateSelector: <string>
mode: <string>
certificateKeyFile: <string>
certificateKeyFilePassword: <string>
clusterFile: <string>
clusterPassword: <string>
CAFile: <string>
clusterCAFile: <string>
CRLFile: <string>
allowConnectionsWithoutCertificates: <boolean>
allowInvalidCertificates: <boolean>
allowInvalidHostnames: <boolean>
disabledProtocols: <string>
FIPSMode: <boolean>
compression:
compressors: <string>
serviceExecutor: <string>
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: <string>
clusterAuthMode: <string>
authorization: <string>
transitionToAuth: <boolean>
javascriptEnabled: <boolean>
redactClientLogData: <boolean>
clusterIpSourceWhitelist:
- <string>
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>
clientCertificateSelector: <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>
2）说明
-
keyFile：存储共享密钥文件的路径，MongoDB实例使用它在分片集群或副本集中彼此进行身份验证；
-
clusterAuthMode：默认值为keyFile；
3.6 setParameter选项
1）选项
setParameter: <parameter1>: <value1> <parameter2>: <value2>
2）说明
设置MongoDB服务器的参数；
3.7 storage选项
1）选项
storage:
dbPath: <string>
indexBuildRetry: <boolean>
journal:
enabled: <boolean>
commitIntervalMs: <num>
directoryPerDB: <boolean>
syncPeriodSecs: <int>
engine: <string>
wiredTiger:
engineConfig:
cacheSizeGB: <number>
journalCompressor: <string>
directoryForIndexes: <boolean>
collectionConfig:
blockCompressor: <string>
indexConfig:
prefixCompression: <boolean>
inMemory:
engineConfig:
inMemorySizeGB: <number>
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: <string> slowOpThresholdMs: <int> slowOpSampleRate: <double>
2）说明
-
mode：默认为off，指定应该分析哪些操作，分析器级别有如下几种，分别为off、slowOp和all；
-
slowOpThresholdMs：默认值为100；
-
slowOpSampleRate：默认值为1.0；
3.9 replication选项
1）选项
replication: oplogSizeMB: <int> replSetName: <string> secondaryIndexPrefetch: <string> enableMajorityReadConcern: <boolean>
2）说明
-
oplogSizeMB：复制操作日志的最大大小，以M为单位，默认情况下，mongod进程基于最大可用空间创建oplog，对于64位系统，oplog通常占可用磁盘空间的5%；
-
replSetName：副本集的名称；
-
enableMajorityReadConcern：默认为true，在PSA架构中，可以禁用该选项以缓解存储缓存的压力；
3.10 sharding选项
1）选项
sharding: clusterRole: <string> archiveMovedChunks: <boolean>
2）说明
-
clusterRole：设置在分片集群中mongod实例的角色，有以下值可供选择，分别为configsvr和shardsvr；
3.11 auditLog选项
1）选项
auditLog: destination: <string> format: <string> path: <string> filter: <string>
2）说明
企业版选项，用于审计；
3.12 snmp选项
1）选项
snmp: disabled: <boolean> subagent: <boolean> master: <boolean>
2）说明
-
disabled：默认值为false，禁用SNMP对mongod的访问；