MongoDB配置文件

2023年3月16日 250次阅读

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

storage

存储引擎相关参数

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

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

processManagement

进程相关参数

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

net

网络相关参数

net:
  prot: <int>    #监听端口，默认27017
  bindIp: <string>    #绑定IP，如果此值是“0.0.0.0”则绑定所有接口
  maxIncomingConnections: <int>    #mongod进程允许的最大连接数，如果此值超过系统配置的连接数阈值，将不会生效(ulimit)
  wireObjectCheck: <boolean>    #当客户端写入数据时，检查数据的有效性（BSON）。如果数据格式不良，update,insert等操作将会被拒绝
  ipv6: <boolean>    #是否支持多实例之间使用ipv6
  unixDomainSocker:    #适用于Unix系统
      enabled: <boolean>   
      pathPrefix: <string>
      filePermissions: <int>
  http:    #
      enabled: <boolean>
      JSONEnabled: <boolean>
      RESTInterfaceEnabled: <boolean>
  ssl:
      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>

security

安全相关参数

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>

operationProfiling

慢查询相关参数：

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

replication

副本集：

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

sharding

分片相关参数：

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

setParameter

自定义变量：

setParameter:
  <parameter1>: <value1>
  <parameter2>: <value2>
  enableLocalhostAuthBypass: false    #栗子

auditLog

审计相关参数：

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