MongoDB配置文件

MongoDB配置文件选项介绍
Mongodb 新版配置文件详解
Configuration File Options手册

---

MongoDB配置文件

MongoDB有两种启动方式，一是默认启动，二是指定配置文件启动。

默认启动：

vim /etc/mongod.conf

service mongod start

指定配置文件启动：

monod -f /path/mongo.conf

mongod.conf配置文件

MongoDB的配置文件格式使用了YAML格式。
YAML维基百科，Yet Another Markup Language。强调以数据为中心，而不是标记语言为重点，用方向缩略语重命名。

/etc/mongod.conf 的几个大块：

systemLog:        #日志

storage:          #存储

processManagement:        #进程管理

net:        #网络

security:        #安全

operationProfiling:        #性能分析器

replication:        #主从复制

sharding:        #架构

setParameter:        #自定义变量

auditLog:        #检测日志

snmp:        #

systemLog

日志相关参数：

systemLog:
  verbosity:                 #日志级别，默认0,1-5均会包含debug信息
  quiet:                 #安静，true时mongod将会减少日志的输出量
  traceAllExceptions:         #打印异常详细信息
  syslogFacility:                  #指定用于登录时信息到syslog Facility水平，前提是启用syslog
  path:            #日志路径，默认情况下，MongoDB将覆盖现有的日志文件
  logAppend:         #mongod重启后，在现有日志后继续添加日志，否则备份当前日志，然后创建新日志
  logRotate: rename|reopen        #日志轮询，防止一个日志文件特别大。rename重命名日志文件，默认值；reopen使用Linuxrotate特性，关闭并重新打开日志文件，前提为logAppend: true
  destination:         #日志输出目的地，可为file或syslog，若不指定，则会输出到 std out
  timeStampFormat:         #指定日志格式的时间戳，有 ctime, Iso869-utc, iso8691-local
  component:            #为不同的组件指定各自的日志信息级别
      accessControl:
          verbosity: 
      command:
          verbosity: 

storage

存储引擎相关参数

storage:
  dbPath:         #mongodb进程存储数据目录，此配置进队此mongod进程有效，你使用配置文件开启的mongod就可以指定额外的数据目录
  indexBuildRetry:          #当构件索引时mongod意外关闭，那么在此启动是否重建索引，默认true
  repairPath:         #在repair期间使用此目录存储临时数据，repair结束后此目录下数据将被删除
  journal:        
      enabled:         #journal日志持久存储，journal日志用来数据恢复，通常用于故障恢复，建议开启
      commitIntervalMs:         #mongod日志刷新值，范围1-500毫秒，默认100，不建议修改
  directoryPerDB:          #是否将不同的数据存储在不同的目录中，dbPath子目录
  syncPeriodSecs:          #fsync操作将数据flush到磁盘的时间间隔，默认为60秒，不建议修改
  engine:          #存储引擎

  mmapv1:    #mmapv1存储引擎，3.2前默认
      preallocDataFiles:  
      nsSize: 
      quota:
          enforced: 
          maxFilesPerDB: 
      smallFiles: 
      journal:
          debugFlags: 
          commitIntervalMs: 
  wiredTiger:    #WiredTiger存储引擎，3.2后默认
      engineConfig:
          cacheSizeGB:     #最大缓存大小
          journalCompressor:     #日志压缩算法，可选值有 none，snappy(默认)，zlib
          directoryForIndexes:     #是否将索引和collections数据分别存储在dbPath单独的目录中
      collectionConfig:
          blockCompressor:     #collection数据压缩算法，可选none, snappy，zlib
      indexConfig:
          prefixCompression:     #是否对索引数据使用前缀压缩。对那些经过排序的值存储有很大帮助，可有效减少索引数据的内存使用量。
  inMemory:    #inMemory内存存储引擎，bate版
      engineConfig:
          inMemorySizeGB: 

processManagement

进程相关参数

processManagement:
  fork:         #是否以fork模式运行mongod进程，默认情况下，mongod不作为守护进程运行
  pidFilePath:         #将mongod进程ID写入指定文件，如未指定，将不会创建PID文件

net

网络相关参数

net:
  prot:     #监听端口，默认27017
  bindIp:     #绑定IP，如果此值是“0.0.0.0”则绑定所有接口
  maxIncomingConnections:     #mongod进程允许的最大连接数，如果此值超过系统配置的连接数阈值，将不会生效(ulimit)
  wireObjectCheck:     #当客户端写入数据时，检查数据的有效性（BSON）。如果数据格式不良，update,insert等操作将会被拒绝
  ipv6:     #是否支持多实例之间使用ipv6
  unixDomainSocker:    #适用于Unix系统
      enabled:    
      pathPrefix: 
      filePermissions: 
  http:    #
      enabled: 
      JSONEnabled: 
      RESTInterfaceEnabled: 
  ssl:
      sslOnNormalPorts: 
      mode: 
      PEMKeyFile: 
      PEMKeyPassword: 
      clusterFile: 
      clusterPassword: 
      CAFile: 
      CRLFile: 
      allowConnectionsWithoutCertificates: 
      allowInvalidCertificates: 
      allowInvalidHostnames: 
      disabledProtocols: 
      FIPSMode: 
  compression:
      compressors:   

security

安全相关参数

security:
  authorization: enabled    #MondoDB认证功能
  keyFile: /path/mongo.key    #MongoDB副本集节点身份验证密钥文件
  clusterAuthMode:     #集群members间的认证模式
  transitionToAuth: 
   javascriptEnabled:      #是否允许执行JavaScript脚本
   redactClientLogData: 
   sasl:
      hostName: 
      serviceName: 
      saslauthdSocketPath: 
   enableEncryption: 
   encryptionCipherMode: 
   encryptionKeyFile: 
   kmip:
      keyIdentifier: 
      rotateMasterKey: 
      serverName: 
      port: 
      clientCertificateFile: 
      clientCertificatePassword: 
      serverCAFile: 
   ldap:
      servers: 
      bind:
         method: 
         saslMechanism: 
         queryUser: 
         queryPassword: 
         useOSDefaults: 
      transportSecurity: 
      timeoutMS: 
      userToDNMapping: 
      authz:
         queryTemplate: 

operationProfiling

慢查询相关参数：

operationProfiling:
  slowOpThresholdMs:     #数据库profiler判定一个操作是“慢查询”的时间阈值，单位毫秒。mongod会把慢查询记录到日志中，默认100ms
  mode:     #数据库profiler级别，操作的性能信息将会被写入日志文件中，可选值“off”--关闭profiling，“slowOp”--只包包含慢操作，“all”--记录所有操作
  #数据库profiling会影响性能，建议只在性能调试阶段开启

replication

副本集：

replication:
  oplogSizeMB:     #replication操作日志的最大尺寸，如果太小，secondary将不能通过oplog来同步数据，只能全量同步
  replSetName:     #副本集名称，副本集中所有的mongod实例都必须有相同的名字，Sharding分布式下，不同的sharding应该使用不同的repSetName
  secondaryIndexPrefetch:     #副本集中的secondary，从oplog中应用变更操作之前，将会先把索引加载到内存
  enalbeMajorityReadConcern:     #允许readConcern的级别为“majority”

sharding

分片相关参数：

sharding:
  clusterRole:     #在sharding集群中，此mongod实例可选的角色。configsvr,默认监听27019端口 和 shardsvr,默认监听27018端口
  archiveMovedChunks:     #当chunks因为“负载均衡”而迁移到其他节点时，mongod是否将这些chunks归档，并保存在dbPath/movechunk目录下，mongod不会删除moveChunk下的文件

setParameter

自定义变量：

setParameter:
  : 
  : 
  enableLocalhostAuthBypass: false    #栗子

auditLog

审计相关参数：

auditLog:
  destination:     #指定审计记录的输出方式，有syslog, console, file
  format:     #输出格式，有JSON 和 BSON
  path:     #如果审计时间输入为文件，那么就需要指定文件完整路径及文件名
  filter:     #过滤器，可限制审计系统记录的操作类型，该选项需要一个表单的查询文档的字符串表示形式