MongoDB配置文件详解 · linux运维

[TOC] ## 一配置文件说明 MongoDB有两种配置文件格式,分别是: [3.2版官方yaml配置文件选项参考](https://docs.mongodb.com/v3.2/reference/configuration-options) 1. 用`=`号的常规格式类似my.conf等常规配置的文件 2. yaml语法的新格式 mongodb3.x版本后就是要yaml语法格式的配置文件，下面是yaml配置文件格式如下：切记yaml只能使用空格，不支持tab键,切记 ### 配置举例 **配置文件** ```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 ``` **指定配置启动** ```sh mongod --config /etc/mongod.conf # 或者 mongod -f /etc/mongod.conf ``` ### 配置文件模块 mongod.conf配置文件分为如下几块内容: ``` systemLog: #日志模块相关参数 storage: #存储引擎相关参数 processManagement: #进程管理 net: #网络 security: #安全 operationProfiling: #性能分析器 replication: #主从复制配置 sharding: #分片集群配置 setParameter: #自定义变量 auditLog: #检测日志 snmp: # ``` ## 二详细配置部分 ### A `systemLog`日志相关参数 ~~~yaml systemLog: verbosity: <int> #日志级别，默认0,1-5均会包含debug信息 quiet: <bool> #安静，true时将会减少日志的输出量 traceAllExceptions: <bool> #打印异常详细信息 syslogFacility: <string> #启用syslog指定用于登录时信息到syslog Facility水平，前提是 path: <string> #日志路径 logAppend: <bool> #追加日志还是新建日志 logRotate: rename|reopen #日志轮询。默认值rename；reopen前提为 logAppend: true destination: <string> #日志输出目的地，可为file或syslog，不指定会输出到标准输出 timeStampFormat: <string> #日志时间戳格式，有 ctime,Iso869-utc,iso8691-local component: #为不同的组件指定各自的日志信息级别 accessControl: verbosity: <int> command: verbosity: <int> ~~~ ### B `storage`存储引擎相关参数 ~~~yaml storage: dbPath: <string> #数据存储目录 indexBuildRetry: <bool> #构件索引时mongod意外关闭，启动是否重建索引，默认true repairPath: <string> #在repair期间临时数据目录 journal: enabled: <boolean> #journal日志是否持久存储，通常用于数据故障恢复，建议开启 commitIntervalMs: <num> #mongod日志刷新值，范围1-500毫秒，默认100，不建议修改 directoryPerDB: <bool> #是否将不同的数据存储在不同的目录中，需为dbPath子目录 syncPeriodSecs: <int> #fsync操作将数据flush到磁盘的时间间隔，默认为60秒，不建议修改 engine: <string> #存储引擎类型,3.2前默认 mmapv1，3.2后默认WiredTiger wiredTiger: #存储引擎配置 engineConfig: cacheSizeGB: <number> #最大缓存大小 journalCompressor: <string> #日志压缩算法，可选值有 none，snappy(默认)，zlib directoryForIndexes: <bool> #是否将索引和集合数据分别存储在dbPath单独的目录中 collectionConfig: blockCompressor: <string> #collection数据压缩算法，可选none, snappy，zlib indexConfig: prefixCompression: <bool> #是否对索引数据使用前缀压缩。可有效减少索引数据的内存使用量。 ~~~ ### C `processManagement`进程相关参数 ~~~yaml processManagement: fork: <boolean> #是否以守护进程运行，默认false pidFilePath: <string> #将mongod进程ID写入指定文件，默认不会创建 ~~~ ### D `net`网络相关参数 ~~~xml net: prot: <int> #监听端口，默认27017 bindIp: <string> #绑定IP，如果此值是“0.0.0.0”则绑定所有接口 maxIncomingConnections: <int> #进程允许的最大连接数，上限是系统阈值(ulimit) wireObjectCheck: <boolean> #当客户端写入数据时，是否检查数据的有效性(BSON),有效的数据才执行 ipv6: <bool> #是否支持多实例之间使用ipv6 http: #http配置 enabled: <boolean> JSONEnabled: <boolean> RESTInterfaceEnabled: <boolean> ssl: #https配置 sslOnNormalPorts: <boolean> 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> ~~~ ### E `security`安全相关参数 ~~~yaml security: authorization: enabled #MondoDB认证功能 keyFile: /path/mongo.key #MongoDB副本集节点身份验证密钥文件 clusterAuthMode: <string> #集群members间的认证模式 transitionToAuth: <boolean> javascriptEnabled: <boolean> #是否允许执行JavaScript脚本 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> saslMechanism: <string> queryUser: <string> queryPassword: <string> useOSDefaults: <boolean> transportSecurity: <string> timeoutMS: <int> userToDNMapping: <string> authz: queryTemplate: <string> ~~~ ### F `operationProfiling`慢查询相关参数： ~~~yaml operationProfiling: slowOpThresholdMs: <int> #“慢查询”的时间阈值，单位毫秒(默认100ms) mode: <string> #数据库profiler级别，可选值“off|slowOp|all” #数据库profiling会影响性能，建议只在性能调试阶段开启,mongod会把慢查询记录到日志中 ~~~ ### G `replication`副本集相关参数： ~~~yaml replication: oplogSizeMB: <int> #replication操作日志的最大尺寸，如果太小则全量同步 replSetName: <string> #副本集名称，副本集中所有的mongod实例都必须有相同的名字 secondaryIndexPrefetch: <string> #副本集中的secondary,从oplog中应用变更操作前,会先把索引加载到内存 enalbeMajorityReadConcern: <boolean> #允许readConcern的级别为“majority” ~~~ ### H `sharding`分片相关参数： ~~~yaml sharding: clusterRole: <string> #在sharding集群中的角色。configsvr(27019)|shardsvr(27018) archiveMovedChunks: <bool> #当chunks迁移后，是否归档并保存这些chunks在dbPath/movechunk目录下 ~~~ ### I `setParameter`自定义变量： ~~~yaml setParameter: <parameter1>: <value1> <parameter2>: <value2> enableLocalhostAuthBypass: false #栗子 ~~~ ### J `auditLog`审计相关参数： ~~~yaml auditLog: destination: <string> #指定审计记录的输出方式，有syslog|console|file format: <string> #输出格式，有JSON 和 BSON path: <string> #如果输入为文件，那么指定文件完整路径及文件名 filter: <string> #过滤器，可限制审计系统记录的操作类型 ~~~