【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的访问；