Ops Manager 配置设置

通过用户界面绕过初始配置

如果要在创建第一个帐户后跳过初始设置向导，并编辑 conf-mms.properties 文件或使用 API 配置 Ops Manager，请更改以下设置。如果要自动部署 Ops Manager 实例，此设置会有所帮助。

mms.ignoreInitialUiSetup

类型：布尔值

将其设为 true 可允许充分使用 Ops Manager，而无需通过第一个用户帐户来完成初始设置向导。

警告

Ops Manager 会定期执行动态检查，以验证它是否具有所有必需的设置。如果其中一个或多个设置未包含在 conf-mms.properties 中，则 Ops Manager 将拒绝启动并列出日志文件中缺少的字段。

在启动 Ops Manager 之前，请将以下必需设置添加到 conf-mms.properties 以启用基本 Ops Manager 功能：

用户界面设置	conf-mms.properties 设置	必要性
URL to Access Ops Manager	mms.centralUrl	必需
无	mongo.mongoUri	必需
Client Certificate Mode	mms.https.ClientCertificateMode	必需
"From" Email Address	mms.fromEmailAddr	必需
"Reply To" Email Address	mms.replyToEmailAddr	必需
Admin Email Address	mms.adminEmailAddr	必需
Email Delivery Method Configuration	mms.emailDaoClass	必需
Transport	mms.mail.transport	必需
SMTP Server Hostname	mms.mail.hostname	必需
SMTP Server Port	mms.mail.port	必需
User Authentication Method	mms.userSvcClass	Optional
Snapshot Interval (Hours)	brs.snapshotSchedule.interval	Optional
Base Retention of Snapshots (in Days)	brs.snapshotSchedule.retention.base	Optional
Daily Retention of Snapshots (in Days)	brs.snapshotSchedule.retention.daily	Optional
Weekly Retention of Snapshots (in Weeks)	brs.snapshotSchedule.retention.weekly	Optional
Monthly Retention of Snapshots (in Months)	brs.snapshotSchedule.retention.monthly	Optional
Versions Directory	automation.versions.directory	Optional

注意

标记为“可选”的字段具有默认值。如果要更改它们，可以提供设置和新值。

例子

以下值是示例。替换适合 Ops Manager 安装的值。你可以添加本参考中指定的任何其他设置。

要配置具有最低功能的 Ops Manager 安装，请将以下设置添加到 conf-mms.properties：

mms.ignoreInitialUiSetup=true
mongo.mongoUri=mongodb://db1.example.com:27017,db2.example.com:27017,db3.example.com:27017
mms.centralUrl=http://localhost:8080
mms.fromEmailAddr=example@example.com
mms.replyToEmailAddr=example@example.com
mms.adminEmailAddr=example@example.com
mms.mail.transport=smtp
mms.mail.hostname=mail.example.com
mms.mail.port=465

所有集群视图

mms.allclusters.onlyMembership

类型：布尔值

默认值：False

确定“查看全部集群”是仅显示 Ops Manager 管理员所属的部署（将值设置为 true），还是管理员有权访问的部署（将值设置为 false）。

应用程序数据库连接

以下设置配置 Ops Manager 与 Ops Manager Application Database 的连接。必须在每个 Ops Manager 服务器上的 conf-mms.properties 文件中配置此设置。要加密身份验证信息，请参阅加密用户凭证。

mongo.mongoUri

类型：字符串

用于访问 Ops Manager Application Database 的连接字符串。如果适用，连接字符串必须包含 Ops Manager Application Database 上使用的 authentication mechanism 的身份验证凭证。

如何设置连接字符串的格式取决于：

• 为后端数据库部署的集群类型，

• 你使用的协议，以及

• 你使用的身份验证方法。

副本集

分片集群

如果将副本集用于数据库的后端实例，则连接字符串可能包含所有副本集成员的主机名或 DNS 种子列表的主机名。

标准分析器

DNS 种子列表

如果选择标准连接字符串，则请在 URI 中包含副本集的所有节点。如果省略端口号，Ops Manager 将为所有主机使用默认 27017 端口。

无

质询/响应

X.509 证书

LDAP

Kerberos

mongo.mongoUri=mongodb://mongod1.example.com:40000,mongod2.example.com:40000,mongod3.example.com:40000

将 MongoDB 用户名和密码添加到主机名之前。 按以下格式写入用户名和密码： <username>:<password>@

mongo.mongoUri=mongodb://mongodbuser1:password@mongod1.example.com:40000,mongod2.example.com:40000,mongod3.example.com:40000

注意

必要的 MongoDB 角色

对后端数据库进行身份验证的 MongoDB 用户必须具有以下角色：

• readWriteAnyDatabase

• dbAdminAnyDatabase

• clusterAdmin 如果数据库是分片集群，否则 clusterMonitor

您应该在 mongodb.ssl.PEMKeyFile 设置中指定的 PEM 文件中找到客户端证书。

• 将主题值从客户端证书作为 MongoDB 用户添加到主机之前。

• 将 authMechanism=MONGODB-X509 附加到指定端口。

mongo.mongoUri=mongodb://<new_mongodb_user>@mongod1.example.com:40000,mongod2.example.com:40000,mongod3.example.com:40000/?authMechanism=MONGODB-X509

• 将 MongoDB 用户名和密码按以下格式添加到主机名前：<username>:<password>@。

• 按以下格式将身份验证机制附加到端口： authMechanism=PLAIN&authSource=$external

mongo.mongoUri=mongodb://mongodbuser1:password@mongod1.example.com:40000,mongod2.example.com:40000,mongod3.example.com:40000/?authMechanism=PLAIN&authSource=$external

• 在主机名前面加上 Kerberos 用户主体。

  将 Kerberos UPN 以<username>@<KERBEROS REALM> 形式写入。使用经 URL 编码的表示形式对 UPN 进行转义。因此，username@REALM.EXAMPLE.COM 的 Kerberos 用户主体将变为 username%40REALM.EXAMPLE.COM。

• 按以下格式将身份验证机制附加到端口：authMechanism=GSSAPI。

mongo.mongoUri=mongodb://username%40REALM.EXAMPLE.COM@mongod1.example.com:40000,mongod2.example.com:40000,mongod3.example.com:40000/?authMechanism=GSSAPI

注意

修改 Kerberos 设置

要启用 Kerberos，请修改以下设置：

• jvm.java.security.krb5.conf

• jvm.java.security.krb5.kdc

• jvm.java.security.krb5.realm

• mms.kerberos.debug

• mms.kerberos.keyTab

• mms.kerberos.principal

注意

Ops Manager 不要求在 URI 中使用 replicaSet 选项。

Ops 版本中的新增功能：Manager 4.4.0

如果选择了 DNS 种子列表连接字符串，则请包含用于描述数据库的后端实例副本集的 DNS SRV 记录。该连接字符串使用 mongodb+srv: 协议，而不是 mongodb: 协议。

无

质询/响应

X.509 证书

LDAP

Kerberos

mongo.mongoUri=mongodb+srv://db.example.com:40000

将 MongoDB 用户名和密码添加到主机名之前。 按以下格式写入用户名和密码： <username>:<password>@

mongo.mongoUri=mongodb+srv:mongodbuser1:password@mongod.example.com:40000

注意

必要的 MongoDB 角色

对后端数据库进行身份验证的 MongoDB 用户必须具有以下角色：

• readWriteAnyDatabase

• dbAdminAnyDatabase

• clusterAdmin 如果数据库是分片集群，否则 clusterMonitor

您应该在 mongodb.ssl.PEMKeyFile 设置中指定的 PEM 文件中找到客户端证书。

• 将主题值从客户端证书作为 MongoDB 用户添加到主机之前。

• 将 authMechanism=MONGODB-X509 附加到指定端口。

mongo.mongoUri=mongodb+srv:<new_mongodb_user>@mongod.example.com:40000/?authMechanism=MONGODB-X509

• 将 MongoDB 用户名和密码按以下格式添加到主机名前：<username>:<password>@。

• 按以下格式将身份验证机制附加到端口： authMechanism=PLAIN&authSource=$external

mongo.mongoUri=mongodb+srv:mongodbuser1:password@mongod.example.com:40000/?authMechanism=PLAIN&authSource=$external

• 在主机名前面加上 Kerberos 用户主体。

  将 Kerberos UPN 以<username>@<KERBEROS REALM> 形式写入。使用经 URL 编码的表示形式对 UPN 进行转义。因此，username@REALM.EXAMPLE.COM 的 Kerberos 用户主体将变为 username%40REALM.EXAMPLE.COM。

• 按以下格式将身份验证机制附加到端口：authMechanism=GSSAPI。

mongo.mongoUri=mongodb+srv:username%40REALM.EXAMPLE.COM@mongod.example.com:40000/?authMechanism=GSSAPI

注意

修改 Kerberos 设置

要启用 Kerberos，请修改以下设置：

• jvm.java.security.krb5.conf

• jvm.java.security.krb5.kdc

• jvm.java.security.krb5.realm

• mms.kerberos.debug

• mms.kerberos.keyTab

• mms.kerberos.principal

此选项需要应用程序数据库的 DNS SRV 记录。DNS 条目使用 DNS 种子列表字符串格式。确保 Ops Manager 可以连接到此应用程序数据库。

提示

另请参阅：

DNS 种子列表连接格式。

如果使用分片集群作为数据库的后备实例，则连接字符串可能包含所有 mongos 路由器的主机名或 DNS 种子列表的主机名。

标准分析器

DNS 种子列表

如果选择标准连接字符串，请在 URI 中包含所有分片。如果省略端口号，Ops Manager 将为所有主机使用默认 27017 端口。

无

质询/响应

X.509 证书

LDAP

Kerberos

mongo.mongoUri=mongodb://mongos1.example.com:40000,mongos2.example.com:40000

将 MongoDB 用户名和密码添加到主机名之前。 按以下格式写入用户名和密码： <username>:<password>@

mongo.mongoUri=mongodb://mongodbuser1:password@mongos1.example.com:40000,mongos2.example.com:40000

注意

必要的 MongoDB 角色

对后端数据库进行身份验证的 MongoDB 用户必须具有以下角色：

• readWriteAnyDatabase

• dbAdminAnyDatabase

• clusterAdmin 如果数据库是分片集群，否则 clusterMonitor

您应该在 mongodb.ssl.PEMKeyFile 设置中指定的 PEM 文件中找到客户端证书。

• 将主题值从客户端证书作为 MongoDB 用户添加到主机之前。

• 将 authMechanism=MONGODB-X509 附加到指定端口。

mongo.mongoUri=mongodb://<new_mongodb_user>@mongos1.example.com:40000,mongos2.example.com:40000/?authMechanism=MONGODB-X509

• 将 MongoDB 用户名和密码按以下格式添加到主机名前：<username>:<password>@。

• 按以下格式将身份验证机制附加到端口： authMechanism=PLAIN&authSource=$external

mongo.mongoUri=mongodb://mongodbuser1:password@mongos1.example.com:40000,mongos2.example.com:40000/?authMechanism=PLAIN&authSource=$external

• 在主机名前面加上 Kerberos 用户主体。

  将 Kerberos UPN 以<username>@<KERBEROS REALM> 形式写入。使用经 URL 编码的表示形式对 UPN 进行转义。因此，username@REALM.EXAMPLE.COM 的 Kerberos 用户主体将变为 username%40REALM.EXAMPLE.COM。

• 按以下格式将身份验证机制附加到端口：authMechanism=GSSAPI。

mongo.mongoUri=mongodb://username%40REALM.EXAMPLE.COM@mongos1.example.com:40000,mongos2.example.com:40000/?authMechanism=GSSAPI

注意

修改 Kerberos 设置

要启用 Kerberos，请修改以下设置：

• jvm.java.security.krb5.conf

• jvm.java.security.krb5.kdc

• jvm.java.security.krb5.realm

• mms.kerberos.debug

• mms.kerberos.keyTab

• mms.kerberos.principal

注意

Ops Manager 不要求在 URI 中使用 replicaSet 选项。

Ops 版本中的新增功能：Manager 4.4.0

如果选择 DNS 种子列表连接字符串，请包含描述数据库的后备实例分片集群的 DNS SRV 记录。该连接字符串使用 mongodb+srv: 协议，而不是 mongodb: 协议。

无

质询/响应

X.509 证书

LDAP

Kerberos

mongo.mongoUri=mongodb+srv://db.example.com:40000

将 MongoDB 用户名和密码添加到主机名之前。 按以下格式写入用户名和密码： <username>:<password>@

mongo.mongoUri=mongodb+srv:mongodbuser1:password@mongos.example.com:40000

注意

必要的 MongoDB 角色

对后端数据库进行身份验证的 MongoDB 用户必须具有以下角色：

• readWriteAnyDatabase

• dbAdminAnyDatabase

• clusterAdmin 如果数据库是分片集群，否则 clusterMonitor

您应该在 mongodb.ssl.PEMKeyFile 设置中指定的 PEM 文件中找到客户端证书。

• 将主题值从客户端证书作为 MongoDB 用户添加到主机之前。

• 将 authMechanism=MONGODB-X509 附加到指定端口。

mongo.mongoUri=mongodb+srv:<new_mongodb_user>@mongos.example.com:40000/?authMechanism=MONGODB-X509

• 将 MongoDB 用户名和密码按以下格式添加到主机名前：<username>:<password>@。

• 按以下格式将身份验证机制附加到端口： authMechanism=PLAIN&authSource=$external

mongo.mongoUri=mongodb+srv:mongodbuser1:password@mongos.example.com:40000/?authMechanism=PLAIN&authSource=$external

• 在主机名前面加上 Kerberos 用户主体。

  将 Kerberos UPN 以<username>@<KERBEROS REALM> 形式写入。使用经 URL 编码的表示形式对 UPN 进行转义。因此，username@REALM.EXAMPLE.COM 的 Kerberos 用户主体将变为 username%40REALM.EXAMPLE.COM。

• 按以下格式将身份验证机制附加到端口：authMechanism=GSSAPI。

mongo.mongoUri=mongodb+srv:username%40REALM.EXAMPLE.COM@mongos.example.com:40000/?authMechanism=GSSAPI

注意

修改 Kerberos 设置

要启用 Kerberos，请修改以下设置：

• jvm.java.security.krb5.conf

• jvm.java.security.krb5.kdc

• jvm.java.security.krb5.realm

• mms.kerberos.debug

• mms.kerberos.keyTab

• mms.kerberos.principal

此选项需要应用程序数据库的 DNS SRV 记录。DNS 条目使用 DNS 种子列表字符串格式。确保 Ops Manager 可以连接到此应用程序数据库。

提示

另请参阅：

DNS 种子列表连接格式。

mongo.encryptedCredentials

类型：布尔值

要在 mongo.mongoUri 中使用加密凭证，请使用 Ops Manager credentialstool 对凭证进行加密，将其输入到 mongo.mongoUri 设置中，然后将其设置为 true：

mongo.encryptedCredentials=true

自动化默认路径

automation.default.backupAgentLogFile

类型：字符串

默认值：/var/log/mongodb-mms-automation/backup-agent.log

Linux/macOS 上备份日志的默认路径。

automation.default.certificateAuthorityFile

类型：字符串

Linux/macOS 上证书颁发机构文件的默认路径。

automation.default.dataRoot

类型：字符串

默认值：/data

自动化管理的 MongoDB 数据库的默认数据路径。

automation.default.downloadBase

类型：字符串

默认值：/var/lib/mongodb-mms-automation

Linux/macOS 上由自动化功能管理的部署的监控、备份和 MongoDB 二进制文件的默认路径。

automation.default.monitoringAgentLogFile

类型：字符串

默认值：/var/log/mongodb-mms-automation/monitoring-agent.log

Linux/macOS 上监控日志的默认路径。

mms.agentCentralUrl

类型：字符串

旧版监控代理或 MongoDB 助手用于推送监控数据的 Ops Manager 应用程序的 FQDN。

如果未设置，则使用 mms.centralUrl 的值。

重要

如果计划使用其 IPv6 地址访问 Ops Manager 应用程序，则必须将 IPv6 地址括在方括号（[ ]）中，以将其与其端口号分隔开。

例如：

http://[2600:1f16:777:8700:93c2:b99c:a875:2b10]:8080

备份

mms.alerts.BackupAgentConfCallFailure.maximumFailedConfCalls

类型：整型

默认值：10

如果备份遇到超过此次数的连续失败配置调用，则 Ops Manager 将触发以下全局警报：Backup has too many conf call failures

mms.alerts.OutsideSpaceUsedThreshold.maximumSpaceUsedPercent

类型：整型

默认值：85

如果块存储使用的磁盘总容量至少达到此百分比，Ops Manager 就会触发以下系统警报：Blockstore space used exceeds threshold。

mms.backupCentralUrl

类型：字符串

传统备份代理或 MongoDB 代理用来向其发送备份数据的 Ops Manager 应用程序的 FQDN 。

如果未设置，则使用 mms.centralUrl 的值。

重要

如果计划使用其 IPv6 地址访问 Ops Manager 应用程序，则必须将 IPv6 地址括在方括号（[ ]）中，以将其与其端口号分隔开。

例如：

http://[2600:1f16:777:8700:93c2:b99c:a875:2b10]:8080

mms.backup.journal.heads

类型：布尔值

默认值：False

这设置了头部数据库是否应使用日志。请参阅管理备份作业，为单个备份作业的头部数据库启用或禁用日志。

FCV 4.2 并在以后使用备份游标而不是头部数据库进行备份。

mms.backup.minimumOplogWindowHours

类型：浮点

默认值：3

这设置了 oplog 应记录的数据库操作的最小小时数。

部署的 oplog 需要足够大，以保存自上次快照以来的恢复数据。增加此值以使 Ops Manager 监控 oplog 容量。应将此值设置为达到或超过 brs.snapshotSchedule.interval 中的值。

如果将该值设置为小于 brs.snapshotSchedule.interval，则在最后一个快照和 oplog 结束之间可能会有间隔。这使得备份无法用于恢复。必须重新同步过时的备份作业才能将其用于恢复。

诊断存档

mms.admin.diagnostics.archiveDocCountLimit

类型：整型

默认值：10000

Ops Manager 应从操作日志中检索的最大条目数。

mms.admin.diagnostics.archiveDocSizeLimit

类型：整型

默认：7

Ops Manager 应从活动源中检索的最大数据天数。

mms.admin.diagnostics.archiveDocAgeLimit

类型：整型

默认：7

Ops Manager 应从活动源中检索的最大数据天数。

mms.automation.diagnostics.lastAgentStatusDocAgeLimit

类型：整型

默认：7

在诊断存档中添加 AutomationLastAgentStatus 的最后指定天数。

mms.automation.diagnostics.includeEmptyProcessConfigs

类型：布尔值

默认值：False

指示是否为诊断归档中具有非空进程数组的组添加 automationConfigs 的标志。

电子邮件

mms.fromEmailAddr

类型：字符串

用于发送常规电子邮件（如 Ops Manager 警报）的电子邮件地址。你可以在电子邮件地址中包含别名。

mms.fromEmailAddr=mms-alerts@example.com

对应 From Email Address。

mms.replyToEmailAddr

类型：字符串

用于回复常规电子邮件的电子邮件地址。

对应 Reply To Email Address。

mms.adminEmailAddr

类型：字符串

Ops Manager 管理员的电子邮件地址。此地址接收与 Ops Manager 问题相关的电子邮件。

对应 Admin Email Address。

mms.emailDaoClass

类型：字符串

默认值：SIMPLE_MAILER

要使用的电子邮件接口。

此设置以不同方式标记用户界面和配置文件。

发送方式	配置设置（mms.emailDaoClass）
AWS SES	AWS_MAILER
SMTP	SIMPLE_MAILER

如果将其设置为 SMTP 电子邮件服务器，则必须设置：

• mms.mail.transport

• mms.mail.hostname

• mms.mail.port

• mms.mail.username

• mms.mail.password

• mms.mail.tls

如果将此项目设为 AWS Simple Email Service，则必须设置：

• aws.ses.endpoint

• aws.accesskey

• aws.secretkey

对应 Email Delivery Method Configuration。

HTTP Proxy

http.proxy.host

类型：字符串

指定要连接的 HTTP 或 HTTPS 代理的主机名。

http.proxy.host=proxy.example.com

对应 Proxy Host。

http.proxy.port

类型：整型

指定要连接到主机的端口。要使用代理，必须同时指定 Proxy Port 和 Proxy Host。

对应 Proxy Port。

http.proxy.username

类型：字符串

如果代理要求进行身份验证，请使用此设置来指定用于连接到代理的用户名。

对应 Proxy Username。

http.proxy.password

类型：字符串

如果代理要求进行身份验证，请使用此设置来指定用于连接到代理的密码。

对应 Proxy Password。

http.proxy.nonProxyHosts

类型：字符串

指定以竖线字符分隔 (|) 的内部主机列表，以绕过已配置的传出代理。

*.foo.com|localhost

对应 Non Proxy Hosts。

MongoDB 版本管理

automation.versions.source

类型：字符串

默认值：remote

指示 MongoDB 安装程序二进制文件的来源。

automation.versions.source 的可接受值以及设置该值必须存在的条件是：

值	条件
remote	Ops Manager 和助手均可访问互联网。
hybrid	Ops Manager 可以访问互联网，但代理不能访问互联网。Ops Manager 从互联网下载 MongoDB 二进制文件；代理从 Ops Manager 下载二进制文件。
local	Ops Manager 和代理均无法访问互联网。Ops Manager 管理员必须将版本清单和 MongoDB 二进制文件上传到 Ops Manager 主机，如配置部署以限制互联网访问权限中所述。

对应 Installer Download Source。

automation.versions.download.baseUrl

类型：字符串

默认：mongodb.com，fastdl.mongodb.org

要从中获取 MongoDB 二进制文件的 HTTP(S) 端点。如果此端点为 HTTPS 端点，则会使用 httpsCAFile 指定的证书颁发机构文件来验证证书。如果未设置 automation.versions.download.baseUrl，则 mongodb 二进制文件的远程 URL 为 mongodb.com 和 fastdl.mongodb.org。

对应 Base URL。

automation.versions.download.baseUrl.allowOnlyAvailableBuilds

类型：布尔值

默认：真

设置为 true 时，Ops Manager 会将你可以指定的 MongoDB 版本限制为可用于部署的版本。

仅当将 automation.versions.download.baseUrl 设置为自定义值时，才会应用此设置。

automation.versions.directory

类型：字符串

默认值：/opt/mongodb/mms/mongodb-releases/

指定 Ops Manager 应用程序服务器上 Ops Manager 存储 MongoDB 二进制文件的目录。在部署上安装或更改 MongoDB 版本时，自动化会访问二进制文件。如果将 Version Manifest Source 设置为在 Local 模式下运行，则备份守护程序也会从该目录访问 MongoDB 二进制文件。有关详细信息，请参阅配置部署以限制互联网访问。

对应 Versions Directory。

mongodb.release.autoDownload

类型：布尔值

默认：真

指明备份守护程序是否会自动安装备份守护程序所需 MongoDB 版本的标志。

true	守护进程通过互联网从 MongoDB Inc. 检索二进制文件。
false	备份守护进程无法访问互联网，需要 Ops Manager 管理员手动下载并提取备份守护进程所需的 MongoDB 版本的每个存档版本。管理员必须将提取的二进制文件放入 Ops Manager 主机上的 Versions Directory 中。

警告

当 Ops Manager 以本地模式运行时，设置为 false。

对应 Backup Versions Auto Download。

mongodb.release.autoDownload.enterprise

类型：布尔值

指示备份守护程序是否自动安装备份守护程序所需的 MongoDB 企业版本的标志。需要将 mongodb.release.autoDownload 设置为 true。

警告

如果计划在 Linux 主机上运行 MongoDB Enterprise，则须在安装 MongoDB 之前手动向每个主机安装一组依赖项。MongoDB 手册提供了相应命令来安装这些依赖项。

请参阅配置部署以限制互联网访问。

对应 Backup Versions Auto Download Enterprise Builds

mongodb.release.modulePreference

类型：字符串

指定使用 MongoDB 社区版还是 Enterprise 版二进制文件进行备份。

接受的值为：

• enterprisePreferred

• enterpriseRequired

• communityRequired

选择 enterpriseRequired 或 communityRequired 时，Ops Manager 仅使用这些二进制文件进行备份。选择 enterprisePreferred 时，Ops Manager 将使用企业版二进制文件（如果可用）和社区版二进制文件（如果不可用）。

注意

选择 enterpriseRequired 时，必须将 mongodb.release.autoDownload.enterprise 设置为 true 或者在本地模式下手动将企业版二进制文件放入 automation.versions.directory 中。

警告

选择 enterpriseRequired 或 communityRequired，但 automation.versions.directory 不包含所需的二进制文件时，备份会失败。

对应 Required Module For Backup。

MongoDB 使用情况

mms.mongoDbUsage.defaultUsageType

类型：字符串

默认值：生产服务器

此 Ops Manager 管理的所有 Enterprise 进程的默认 MongoDB Enterprise 服务器类型。

下表显示了接受的服务器类型值，以及每个值所需的相应许可证数量：

服务器意图	环境目的	许可证要求
生产服务器	将应用程序托管给内部或外部最终用户。 如果最终用户可能使用某个环境，则该环境将用作生产环境。无论环境是否还提供测试、质量保证、评估或开发功能，这一点都适用。	每台服务器一个许可
测试/QA 服务器	这类环境可用于： 测试 测试您的应用程序，验证其是否按设计和预期运行。平台配置可能是计算、网络和存储功能方面性能较低的生产版本。 确保系统质量 使用一组配置用于模拟生产的数据、硬件和软件来验证您的应用程序。平台配置应是在计算、网络和存储能力方面比生产环境规模较小。 阶段 模拟生产环境，包括性能测试和发布候选批准。平台配置应反映生产的计算、网络和存储能力。	每台服务器一个许可
开发服务器	主机正在为您的应用程序进行设计、代码、调试或其中的某些组合。用于评估是否可以将应用程序的当前状态提升到另一个环境。	无
RAM 池	为任何环境目的提供服务器的任意组合。	一个许可证适用于任意数量的服务器，但不超过您在这些服务器上购买的总 GB RAM 的最大值。

后端数据库	托管 Ops Manager 后端数据库。启用应用程序数据库监控以启用此选项。	无

对应 Default Ops Manager MongoDB Server Type。

mms.mongoDbUsage.ui.enabled

类型：布尔值

如果设置为 true，则在 Ops Manager Admin 中启用 MongoDB 使用情况用户界面。

对应 MongoDB Usage UI。

mms.mongoDbUsage.collectData

类型：布尔值

默认值：False

如果设置为 true，则启用 MongoDB 使用情况数据的每日集合。

对应 MongoDB Usage Data Collection。

监控

mms.agentCentralUrl

类型：字符串

旧版监控代理或 MongoDB 助手用于推送监控数据的 Ops Manager 应用程序的 FQDN。

如果未设置，则使用 mms.centralUrl 的值。

重要

如果计划使用其 IPv6 地址访问 Ops Manager 应用程序，则必须将 IPv6 地址括在方括号（[ ]）中，以将其与其端口号分隔开。

例如：

http://[2600:1f16:777:8700:93c2:b99c:a875:2b10]:8080

Ops Manager 管理 API

mms.publicApi.whitelistEnabled

类型：布尔值

某些 API 调用要求请求源自访问列表中的 IP 地址。要关闭此要求，请添加此设置并将其值设为 false。

推送实时迁移

mms.pushLiveMigrations.mmsUi.centralUrl

类型：字符串

从 Ops Manager 实时迁移到 Atlas 的基本 URL，例如 https://cloud.mongodb.com。

mms.pushLiveMigrations.syncJobs.enabled

类型：布尔值

如果设为 true，则允许 Ops Manager 请求有关实时迁移流程的信息，例如：

• 可用作实时迁移源的可用项目与部署的列表。

• 已配置的可用迁移主机的列表，而这些主机有助于相应部署与项目中的实时迁移。

• 在 Atlas 中运行的实时迁移的当前状态。

Ops Manager 使用此信息来简化实时迁移进程。默认为 true。

mms.pushLiveMigrations.updateJob.intervalSeconds

类型：布尔值

同步刷新之间的重复间隔（以秒为单位）。Ops Manager 和 Atlas 之间的组织项目信息会定期同步。默认同步间隔为 60。Ops Manager 预计同步刷新会在 10 到 43200 秒（12 小时）的时间间隔内发生。如果同步刷新之间的实际间隔超过 43200 秒，或者在验证阶段同步刷新之间的实际间隔超过 1800 秒（30 分钟），则实时迁移到 Atlas 可能会停止、超时或失败。

注意

更新此设置后，重启 Web 服务器以使更改生效。

mms.pushLiveMigrations.updateJob.cooldownSeconds

类型：布尔值

组织项目的信息同步刷新之间的时间间隔（以秒为单位）。同步刷新之间的默认间隔为 10。Ops Manager 预计同步刷新会在 10 到 43200 秒（12 小时）的时间间隔内发生。如果连续同步之间的实际间隔超过 43200 秒，则实时迁移到 Atlas 可能会停止、超时或失败。

注意

更新此设置后，重启 Web 服务器以使更改生效。

mms.pushLiveMigrations.fetchJob.intervalSeconds

类型：布尔值

用于从 Atlas 同步实时迁移计划更新的重复间隔（以秒为单位）。该计划列出了 Atlas 迁移流程中的步骤。Ops Manager 会定期从 Atlas 检索当前计划以检查进度。如果没有此信息，Ops Manager 则不会将实时迁移流程推进到下一阶段。

默认同步间隔为 60。Ops Manager 预计同步刷新会在 10 到 43200 秒（12 小时）的时间间隔内发生。如果连续同步之间的实际间隔超过 43200 秒，则实时迁移到 Atlas 可能会停止、超时或失败。

注意

更新此设置后，重启 Web 服务器以使更改生效。

mms.automation.agentFeatures.migrationHosts.canManageDeployments

类型：布尔值

指示是否在用户界面 Projects（项目）下的 Add new deployment（添加新部署）视图中将实时迁移主机显示为可用代理。默认为 false。

安全性

mms.security.disableBrowserCaching

类型：布尔值

默认值：False

当为 true 时，Ops Manager 将所有 HTTP 响应设为不可缓存。

mms.security.hstsMaxAgeSeconds

类型：整型

默认值：0（可使用 HTTP 或 HTTPS。）

Ops Manager 限制浏览器连接使用 HTTPS 的时间长度（以秒为单位）。此值必须为正整数。值为 0 表示可以使用 HTTP 或 HTTPS。

提示

另请参阅：

要了解如何部署 HSTS，请参阅 HTTP 严格传输安全性、RFC 6797 和 hstspreload.org。

SNMP

第三方集成

用户身份认证

mms.email.validation

类型：字符串

默认：false

确定 Ops Manager 是否要求用户名必须是电子邮件地址。

值	说明
false	（默认）用户名不必为电子邮件地址。
loose	用户名必须包含一个 @ 符号，且后跟一个句点。
strict	用户名必须遵循严格的电子邮件地址验证正则表达式。

如果设置为 strict ，Ops Manager 将使用以下正则表达式来验证电子邮件地址是否符合 RFC-3696: 第 3 节中的要求

^[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*@(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$

例子

jane.smith@example.com 是有效的。jane.smith@ex@mple.com 是无效的。

对应 Username Validation。

mms.userSvcClass

类型：字符串

默认值：com.xgen.svc.mms.svc.user.UserSvcDb

选择将身份验证档案存储在 Ops Manager 应用程序数据库还是 LDAP 目录中。

接受的值为：

身份验证方法	接受的值
应用程序数据库	UserSvcDb 重要提示：在MongoDB Ops Manager 6.0 中，可接受的值为 com.xgen.svc.mms.svc.user.UserSvcDb。 如果使用这个旧的接受值，您的MongoDB Ops Manager实例将在预检查期间不会启动。
LDAP	com.xgen.svc.mms.svc.user.UserSvcLdap
SAML	com.xgen.svc.mms.svc.user.UserSvcSaml

对应 User Authentication Method。

Web Server

mms.centralUrl

类型：字符串

Ops Manager 应用程序的 FQDN 和端口号。

要使用 8080 以外的端口，请参阅管理 Ops Manager 主机名和端口。

mms.centralUrl=http://mms.example.com:8080

对应 URL to Access Ops Manager。

重要

如果计划使用其 IPv6 地址访问 Ops Manager 应用程序，则必须将 IPv6 地址括在方括号（[ ]）中，以将其与其端口号分隔开。

例如：

http://[2600:1f16:777:8700:93c2:b99c:a875:2b10]:8080

mms.https.PEMKeyFile

类型：字符串

包含 Ops Manager 应用程序的有效证书和私钥的 PEM 文件的绝对路径。如果 Ops Manager 应用程序使用 HTTPS 加密 Ops Manager 应用程序、代理和 Web 界面之间的连接，则需要 PEM 文件。

对 Ops Manager 应用程序进行 HTTPS 访问的默认端口为 8443，如 <install_dir>/conf/mms.conf 文件中设置的那样。如果更改此默认值，则还必须更改 mms.centralUrl 设置中指定的端口。

对应 HTTPS PEM Key File。

mms.https.PEMKeyFilePassword

类型：字符串

HTTPS PEM 密钥文件的密码。如果 PEM 密钥文件包含加密私钥，则须包含此设置。

对应 HTTPS PEM Key File Password。

mms.https.ClientCertificateMode

类型：字符串

指定 Ops Manager 是否要求客户端在连接到它时提供有效的 TLS/SSL 客户端证书。接受的值为：

• none

• agents_only

• required

对应 Client Certificate Mode。

mms.https.CAFile

类型：字符串

在以下情况下为必填项：

• 你正在使用私有证书颁发机构。

• 将 mms.https.ClientCertificateMode 设置为 agents_only 或 required。

• 您可以在已启用 TLS 的混合模式下运行 Ops Manager。

指定包含可接受客户端证书列表的专用证书颁发机构文件的文件系统位置。Ops Manager 应用程序对来自带有此文件中描述的证书的客户端的 HTTPS 请求进行身份验证。

mms.https.CAFile=/path/to/ca_file.pem

对应 CA File。

mms.https.dualConnectors

类型：布尔值

默认值：False

支持同时使用 HTTP 和 HTTPS 连接到 Ops Manager。

在升级 Ops Manager 和 MongoDB 助手以使用 TLS 时，可以临时使用此设置。为确保零停机时间，请设置为 true 并为 mms.http.bindhostname 提供一个值。配置 Ops Manager 和 MongoDB 助手后，设置为 false。

重要

当 mms.https.dualConnectors 为 true 时，可以使用不安全连接访问 Ops Manager。

将 mms.https.dualConnectors 设置为 false 以仅在将 MongoDB 助手更新为使用 TLS 连接后才允许安全连接。

mms.http.bindhostname

类型：字符串

默认值：127.0.0.1

MongoDB 助手可以使用 HTTP 连接到 Ops Manager 的主机名或 IP。

在升级 Ops Manager 和 MongoDB 助手以使用 TLS 时，可以临时使用此设置。要确保零停机时间，请设置一个值并将 mms.https.dualConnectors 设置为 true。配置 Ops Manager 和 MongoDB 助手后，删除该值。

mms.remoteIp.header

类型：字符串

如果您将负载均衡器与 Ops Manager 应用程序一起使用，请将其设为负载均衡器用于识别 Ops Manager 主机的原始客户端 IP 地址的 HTTP 标头字段。指定 Load Balancer Remote IP Header 时，不允许客户端直接连接到任何 Ops Manager 主机。位于 Ops Manager 主机前面的负载均衡器不得返回已缓存的内容。

设置 Load Balancer Remote IP Header 后，Ops Manager 将启用以下 HTTP 标头：

HTTP 标头	转发到 Ops Manager
X-Forwarded-Host	客户端在主机 HTTP 请求标头中请求的原始主机。
X-Forwarded-Proto	用于发出 HTTP 请求的协议。
X-Forwarded-Server	代理服务器的主机名。
X-Proxied-Https	请求的 HTTPS 状态。

要了解详细信息，请参阅配置高可用性 Ops Manager 应用程序。

对应 Load Balancer Remote IP Header。

mms.minimumTLSVersion

类型：字符串

默认值：TLSv1.2

指定客户端连接到 Ops Manager 所需的TLS版本。 此属性会影响所有客户端，例如用于连接到 Ops Manager Admin 接口的浏览器和用于连接到 REST API 的命令行工具，例如 curl。

介于 4.0.9 与 4.0.18 之间以及早于 4.2.13 和 4.4.0 的 Ops Manager 版本

Ops Manager 仅支持 TLSv1.2。如果将此值更改为 TLSv1.2 以外的任何值（包括空白值），则无法连接到此 Ops Manager。

Ops Manager 版本 4.0.0 到 4.0.8，4.0.18 或更高版本、4.2.13 或更高版本、4.4.0 或更高版本

Ops Manager 支持 TLSv1.0、TLSv1.1 和 TLSv1.2。

注意

TLSv1.2 要求连接客户端以满足以下最低要求：

• 浏览器支持 TLS 版本 1.2

• curl 7.34.0 及更高版本

• OpenSSL 1.0.1 及更高版本

要设置 minimum.TLSVersion，请按照以下值执行修改自定义设置的操作步骤：

Key	minimum.TLSVersion
Value	<tls-versions>

mms.disableCiphers

类型：字符串

Default: SSL_DHE_DSS_WITH_3DES_EDE_CBC_SHA, SSL_DHE_DSS_WITH_DES_CBC_SHA, SSL_DHE_RSA_EXPORT_WITH_DES40_CBC_SHA, SSL_DHE_RSA_WITH_3DES_EDE_CBC_SHA, SSL_DHE_RSA_WITH_DES_CBC_SHA, SSL_RSA_EXPORT_WITH_DES40_CBC_SHA, SSL_RSA_EXPORT_WITH_RC4_40_MD5, TLS_DHE_DSS_WITH_AES_128_CBC_SHA256, TLS_DHE_DSS_WITH_AES_128_CBC_SHA, TLS_DHE_DSS_WITH_AES_256_CBC_SHA256, TLS_DHE_DSS_WITH_AES_256_CBC_SHA, TLS_DHE_RSA_WITH_AES_128_CBC_SHA256, TLS_DHE_RSA_WITH_AES_128_CBC_SHA, TLS_DHE_RSA_WITH_AES_128_GCM_SHA256, TLS_DHE_RSA_WITH_AES_256_CBC_SHA256, TLS_DHE_RSA_WITH_AES_256_CBC_SHA, TLS_DHE_RSA_WITH_AES_256_GCM_SHA384, TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256, TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384

指定当客户端连接到 Ops Manager 应用程序和 API 时，Ops Manager 实例无法接受的 TLS 密码套件列表。将 TLS 密码套件名称指定为逗号分隔的列表，如以下示例所示。

重要

在 Ops Manager 中使用的密码套件名称必须遵循 RFC 5246 命名规则。请勿使用 OpenSSL 命名规则。为了方便起见，Ops Manager 在启动期间会记录所有支持的密码套件名称列表。如果 Ops Manager 无法识别 TLS 密码套件名称，则会记录以下警告：

配置将以下内容列为密码，应将其禁用，因为 JDK 无法识别它们。请检查条目格式和已启用密码列表。[unrecognized_cipher_name]

要更改 mms.disableCiphers，请按照修改自定义设置的步骤操作并使用以下值：

Key	mms.disableCiphers
Value	<ciphers> 例如： TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA, TLS_DHE_RSA_WITH_AES_256_CBC_SHA256

警告

将 mms.disableCiphers 设置为自定义值可能会重新启用其中一个或多个禁用的密码。

Webhook

mms.alerts.webhook.adminEndpoint

类型：字符串

对应 Webhook URL。

mms.alerts.webhook.adminSecret

类型：字符串

对应 Webhook Secret。