- Reference >
- Advanced Options for MongoDB Deployments
Advanced Options for MongoDB Deployments¶
On this page
The following mongod and mongos configuration options are available through the Ops Manager Advanced Configuration Options field when you deploy MongoDB. You select advanced options when deploying:
The Ops Manager Advanced Configuration Options map to the MongoDB configuration options and parameters described as follows.
Limited to Listed Options
If a MongoDB option isn’t listed on this page, you may use setParameter to add the setting. Settings added in this way apply to MongoDB instances that Ops Manager manages when those instances start up.
Audit Log¶
| Ops Manager Interface | MongoDB Option |
|---|---|
| auditEncryptionKeyIdentifier | auditLog.auditEncryptionKeyIdentifier |
| compressionMode | auditLog.compressionMode |
| auditDestination | auditLog.destination |
| auditFilter | auditLog.filter |
| auditFormat | auditLog.format |
| localAuditKeyFile | auditLog.localAuditKeyFile |
| auditPath | auditLog.path |
You can add these audit log parameters with a setParameter
option in the Advanced Configuration Options section. To
learn more, see the step about setting these parameters in the
Deploy a Replica Set procedure.
To encrypt the audit log, before you start MongoDB instances that
Ops Manager manages, add the auditEncryptKeyWithKMIPGet and auditEncryptionHeaderMetadataFile parameters in the
Advanced Configuration Options section.
Basis Tech¶
| Ops Manager Interface | MongoDB Option |
|---|---|
| basisTechRootDirectory | basisTech.rootDirectory |
Kerberos¶
| Ops Manager Interface | MongoDB Option |
|---|---|
| kerberosKeytab | kerberos.keytab |
Net¶
| Ops Manager Interface | MongoDB Option |
|---|---|
| bind_ip | net.bindIp |
| httpinterface | net.http.enabled |
| ipv6 | net.ipv6 |
| jsonp | net.http.JSONPEnabled |
| maxConns | net.maxIncomingConnections |
| rest | net.http.RESTInterfaceEnabled |
| tlsClusterFile | net.tls.clusterFile |
| tlsClusterPassword | net.tls.clusterPassword |
| tlsCRLFile | net.tls.CRLFile |
| tlsDisabledProtocols | net.tls.disabledProtocols |
| tlsLogVersions | net.tls.logVersions |
Numactl¶
| Ops Manager Interface | MongoDB Option |
|---|---|
| numCores | numactl.numCores |
Operation Profiling¶
| Ops Manager Interface | MongoDB Option |
|---|---|
| profile | operationProfiling.mode |
| slowms | operationProfiling.slowOpThresholdMs |
| slowOpSampleRate | operationProfiling.slowOpSampleRate |
Process Management¶
| Ops Manager Interface | MongoDB Option |
|---|---|
| pidfilepath | processManagement.pidFilePath |
Replication¶
| Ops Manager Interface | MongoDB Option |
|---|---|
| enableMajorityReadConcern | replication.enableMajorityReadConcern |
| oplogSize | replication.oplogSizeMB |
Security¶
Warning
Ops Manager doesn’t support transitioning from local key encryption to KMIP server-based encryption.
| Ops Manager Interface | MongoDB Option |
|---|---|
| clusterAuthMode | security.clusterAuthMode |
| enableEncryption | security.enableEncryption |
| encryptionCipherMode | security.encryptionCipherMode |
| encryptionKeyFile | security.encryptionKeyFile |
| javascriptEnabled | security.javascriptEnabled |
| kmipClientCertificateFile | security.kmip.clientCertificateFile |
| kmipClientCertificatePassword | security.kmip.clientCertificatePassword |
| kmipKeyIdentifier | security.kmip.keyIdentifier |
| kmipPort | security.kmip.port |
| kmipServerCAFile | security.kmip.serverCAFile |
| kmipServerName | security.kmip.serverName |
| saslauthdSocketPath | security.sasl.saslauthdSocketPath |
| saslHostname | security.sasl.hostName |
Sharding¶
| Ops Manager Interface | MongoDB Option |
|---|---|
| autoSplit | sharding.autoSplit |
| chunkSize | sharding.chunkSize |
SNMP¶
Important
Ops Manager 6.0.0 deprecates SNMP alerts. Ops Manager 7.0.0 will not include SNMP alerts. To learn more about other alert options, see Third-Party Service Integrations.
| Ops Manager Interface | MongoDB Option |
|---|---|
| snmp-master | snmp.master |
| snmp-subagent | snmp.subagent |
Storage¶
| Ops Manager Interface | MongoDB Option |
|---|---|
| directoryperdb | storage.directoryPerDB |
| engine | storage.engine |
| inMemorySizeGB | storage.inMemory.engineConfig.inMemorySizeGB |
| journal | storage.journal.enabled |
| journalCommitInterval | storage.journal.commitIntervalMs |
| nssize | storage.nsSize |
| prealloc | storage.preallocDataFiles |
| quota | storage.quota.enforced |
| quotaFiles | storage.quota.maxFilesPerDB |
| repairpath | storage.repairPath |
| smallfiles | storage.smallFiles |
| syncdelay | storage.syncPeriodSecs |
| wiredTigerCacheSizeGB | storage.wiredTiger.engineConfig.cacheSizeGB |
| wiredTigerCollectionBlockCompressor | storage.wiredTiger.collectionConfig.blockCompressor |
| wiredTigerCollectionConfigString | storage.wiredTiger.collectionConfig.configString |
| wiredTigerDirectoryForIndexes | storage.wiredTiger.engineConfig.directoryForIndexes |
| wiredTigerEngineConfigString | storage.wiredTiger.engineConfig.configString |
| wiredTigerIndexConfigString | storage.wiredTiger.indexConfig.configString |
| wiredTigerIndexPrefixCompression | storage.wiredTiger.indexConfig.prefixCompression |
| wiredTigerJournalCompressor | storage.wiredTiger.engineConfig.journalCompressor |
| wiredTigerStatisticsLogDelaySecs | storage.wiredTiger.engineConfig.statisticsLogDelaySecs |
System Log¶
| Ops Manager Interface | MongoDB Option |
|---|---|
| logappend | systemLog.logAppend |
| logRotate | systemLog.logRotate |
| quiet | systemLog.quiet |
| syslogDestination | systemLog.destination |
| syslogFacility | systemLog.syslogFacility |
| timeStampFormat | systemLog.timeStampFormat |
| verbosity | systemLog.verbosity |
TLS¶
| Ops Manager Interface | MongoDB Option |
|---|---|
| tlsCertificateKeyFile | net.tls.certificateKeyFile |
| tlsCertificateKeyFilePassword | net.tls.certificateKeyFilePassword |
| tlsFIPSMode | net.tls.FIPSMode |
| tlsMode | net.tls.mode |
Set Parameter¶
Important
Ops Manager does not check to see if the parameters you provide are valid. Check the MongoDB Server Manual for accepted parameters and values.
| Ops Manager Interface | MongoDB Option |
|---|---|
| [setParameter] |
You can add any value from
Server Parameters as a
|
For supported MongoDB versions and MongoDB Agent versions, you can set
certain setParameter parameters without a rolling restart.
To determine whether you can set a setParameter parameter during
runtime or upon startup, retrieve details
on that parameter. For complex setParameter parameters, you must set
the parameter values in the same format as in the process configuration
file or in the --setParameter command line option.
Note
If you set the watchdogPeriodSeconds or ttlMonitorEnabled parameters, MongoDB Agent triggers a rolling restart.
If you delete or remove a parameter, MongoDB Agent keeps the parameter’s current value until you make another change to that parameter. To reset the parameter to its default value, you must manually set the value or trigger a rolling restart.
If you attempt to set a parameter that MongoDB Agent can’t set at startup,
MongoDB Agent triggers a rolling restart and fails to start up a
mongod instance.