linux mongodb 配置文件,MongoDB配置文件详解

[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: #日志级别，默认0,1-5均会包含debug信息

quiet: #安静，true时将会减少日志的输出量

traceAllExceptions: #打印异常详细信息

syslogFacility: #启用syslog指定用于登录时信息到syslog Facility水平，前提是

path: #日志路径

logAppend: #追加日志还是新建日志

logRotate: rename|reopen #日志轮询。默认值rename；reopen前提为 logAppend: true

destination: #日志输出目的地，可为file或syslog，不指定会输出到标准输出

timeStampFormat: #日志时间戳格式，有 ctime,Iso869-utc,iso8691-local

component: #为不同的组件指定各自的日志信息级别

accessControl:

verbosity:

command:

verbosity:

~~~

### B `storage`存储引擎相关参数

~~~yaml

storage:

dbPath: #数据存储目录

indexBuildRetry: #构件索引时mongod意外关闭，启动是否重建索引，默认true

repairPath: #在repair期间临时数据目录

journal:

enabled: #journal日志是否持久存储，通常用于数据故障恢复，建议开启

commitIntervalMs: #mongod日志刷新值，范围1-500毫秒，默认100，不建议修改

directoryPerDB: #是否将不同的数据存储在不同的目录中，需为dbPath子目录

syncPeriodSecs: #fsync操作将数据flush到磁盘的时间间隔，默认为60秒，不建议修改

engine: #存储引擎类型,3.2前默认 mmapv1，3.2后默认WiredTiger

wiredTiger: #存储引擎配置

engineConfig:

cacheSizeGB: #最大缓存大小

journalCompressor: #日志压缩算法，可选值有 none，snappy(默认)，zlib

directoryForIndexes: #是否将索引和集合数据分别存储在dbPath单独的目录中

collectionConfig:

blockCompressor: #collection数据压缩算法，可选none, snappy，zlib

indexConfig:

prefixCompression: #是否对索引数据使用前缀压缩。可有效减少索引数据的内存使用量。

~~~

### C `processManagement`进程相关参数

~~~yaml

processManagement:

fork: #是否以守护进程运行，默认false

pidFilePath: #将mongod进程ID写入指定文件，默认不会创建

~~~

### D `net`网络相关参数

~~~xml

net:

prot: #监听端口，默认27017

bindIp: #绑定IP，如果此值是“0.0.0.0”则绑定所有接口

maxIncomingConnections: #进程允许的最大连接数，上限是系统阈值(ulimit)

wireObjectCheck: #当客户端写入数据时，是否检查数据的有效性(BSON),有效的数据才执行

ipv6: #是否支持多实例之间使用ipv6

http: #http配置

enabled:

JSONEnabled:

RESTInterfaceEnabled:

ssl: #https配置

sslOnNormalPorts:

mode:

PEMKeyFile:

PEMKeyPassword:

clusterFile:

clusterPassword:

CAFile:

CRLFile:

allowConnectionsWithoutCertificates:

allowInvalidCertificates:

allowInvalidHostnames:

disabledProtocols:

FIPSMode:

compression:

compressors:

~~~

### E `security`安全相关参数

~~~yaml

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:

~~~

### F `operationProfiling`慢查询相关参数：

~~~yaml

operationProfiling:

slowOpThresholdMs: #“慢查询”的时间阈值，单位毫秒(默认100ms)

mode: #数据库profiler级别，可选值“off|slowOp|all”

#数据库profiling会影响性能，建议只在性能调试阶段开启,mongod会把慢查询记录到日志中

~~~

### G `replication`副本集相关参数：

~~~yaml

replication:

oplogSizeMB: #replication操作日志的最大尺寸，如果太小则全量同步

replSetName: #副本集名称，副本集中所有的mongod实例都必须有相同的名字

secondaryIndexPrefetch: #副本集中的secondary,从oplog中应用变更操作前,会先把索引加载到内存

enalbeMajorityReadConcern: #允许readConcern的级别为“majority”

~~~

### H `sharding`分片相关参数：

~~~yaml

sharding:

clusterRole: #在sharding集群中的角色。configsvr(27019)|shardsvr(27018)

archiveMovedChunks: #当chunks迁移后，是否归档并保存这些chunks在dbPath/movechunk目录下

~~~

### I `setParameter`自定义变量：

~~~yaml

setParameter:

:

:

enableLocalhostAuthBypass: false #栗子

~~~

### J `auditLog`审计相关参数：

~~~yaml

auditLog:

destination: #指定审计记录的输出方式，有syslog|console|file

format: #输出格式，有JSON 和 BSON

path: #如果输入为文件，那么指定文件完整路径及文件名

filter: #过滤器，可限制审计系统记录的操作类型

~~~