Ops Manager の構成設定

ユーザー インターフェースによる初期設定のバイパス

最初のアカウントを作成した後、初期設定ウィザードをスキップして、 conf-mms.properties　ファイルを編集するか、API を使用して Ops Manager を構成する場合は、次の設定を変更します。この設定は、Ops Manager インスタンスの配置を自動化する場合に役立ちます。

mms.ignoreInitialUiSetup

タイプ: ブール値

これを true に設定すると、最初のユーザー アカウントで初期設定ウィザードを完了する必要なく、Ops Manager を完全に使用できるようになります。

警告

Ops Manager は通常のプレフライト チェックを行い、必要な設定がすべて完了していることを確認します。これらの設定の 1 つ以上が conf-mms.properties に含まれていない場合、Ops Manager は起動を拒否し、ログファイルに欠落しているフィールドをリストします。

Ops Manager を起動する前に、基本的な Ops Manager 機能を有効にするために、次の必須設定を conf-mms.properties に追加します。

UI 設定	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	任意
Snapshot Interval (Hours)	brs.snapshotSchedule.interval	任意
Base Retention of Snapshots (in Days)	brs.snapshotSchedule.retention.base	任意
Daily Retention of Snapshots (in Days)	brs.snapshotSchedule.retention.daily	任意
Weekly Retention of Snapshots (in Weeks)	brs.snapshotSchedule.retention.weekly	任意
Monthly Retention of Snapshots (in Months)	brs.snapshotSchedule.retention.monthly	任意
Versions Directory	automation.versions.directory	任意

注意

任意とマークされたフィールドにはデフォルト値があります。これらを変更する場合は、設定と新しい値を指定できます。

例

以下の値はその例です。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 Application Database への Ops Manager 接続を構成します。この設定は、各 Ops Managerサーバーの conf-mms.propertiesファイルで構成する必要があります。認証情報を暗号化するには、「 ユーザー認証情報の暗号化 」を参照してください。

mongo.mongoUri

型: string

MongoDB Ops Manager Application Database にアクセスするために使用される接続文字列。該当する場合、接続文字列には、MongoDB 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>:{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-X 509 を追加します。

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

• ホスト名の前に <username> :<password> @ の形式で MongoDB のユーザー名とパスワードを付け加えます。

• 認証メカニズムを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 に レプリカセット オプションは必要ありません。

バージョン Ops の新機能: マネージャー 4.4.0

DNS シードリスト接続文字列を選択する場合は、データベースのバッキング インスタンス レプリカセットを記述する DNS SRV レコードを含めます。文字列は MongoDB: プロトコルではなく MongoDB+srv: プロトコルを使用します。

なし

挑戦と応答

x.509 証明書

LDAP

Kerberos

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

ホスト名の前に MongoDB のユーザー名とパスワードを付け加えます。 ユーザー名とパスワードを次の形式で書き込みます:<username> <password>:{password>@

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

注意

必要な MongoDB ロール

バッキング データベースを認証する MongoDB ユーザーは、次のロールを持っている必要があります。

• readWriteAnyDatabase

• dbAdminAnyDatabase

• clusterAdmin そうでなく、データベースがシャーディングされたクラスターである場合、 clusterMonitor

クライアント証明書は、mongodb.ssl.PEMKeyFile 設定で指定した PEM ファイル内にあります。

• ホストの前 に MongoDB ユーザーとしてのクライアント証明書 からの サブジェクト の値を追加します。

• 指定されたポートに authMechanism=MONGODB-X 509 を追加します。

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

• ホスト名の前に <username> :<password> @ の形式で MongoDB のユーザー名とパスワードを付け加えます。

• 認証メカニズムを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 がこのアプリケーションデータベースに接続できることを確認してください。

Tip

以下も参照してください。

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>:{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-X 509 を追加します。

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

• ホスト名の前に <username> :<password> @ の形式で MongoDB のユーザー名とパスワードを付け加えます。

• 認証メカニズムを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 に レプリカセット オプションは必要ありません。

バージョン Ops の新機能: マネージャー 4.4.0

DNSシードリスト接続ストリングを選択する場合は、データベースのバッキング インスタンスのシャーディングされたクラスターを記述する DNS SRV レコードを含めます。接続文字列は、mongodb: プロトコルではなく、mongodb+srv: プロトコルを使用します。

なし

挑戦と応答

x.509 証明書

LDAP

Kerberos

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

ホスト名の前に MongoDB のユーザー名とパスワードを付け加えます。 ユーザー名とパスワードを次の形式で書き込みます:<username> <password>:{password>@

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

注意

必要な MongoDB ロール

バッキング データベースを認証する MongoDB ユーザーは、次のロールを持っている必要があります。

• readWriteAnyDatabase

• dbAdminAnyDatabase

• clusterAdmin そうでなく、データベースがシャーディングされたクラスターである場合、 clusterMonitor

クライアント証明書は、mongodb.ssl.PEMKeyFile 設定で指定した PEM ファイル内にあります。

• ホストの前 に MongoDB ユーザーとしてのクライアント証明書 からの サブジェクト の値を追加します。

• 指定されたポートに authMechanism=MONGODB-X 509 を追加します。

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

• ホスト名の前に <username> :<password> @ の形式で MongoDB のユーザー名とパスワードを付け加えます。

• 認証メカニズムを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 がこのアプリケーションデータベースに接続できることを確認してください。

Tip

以下も参照してください。

DNS シードリスト接続形式

mongo.encryptedCredentials

タイプ: ブール値

mongo.mongoUri で暗号化された認証情報を使用するには、Ops Manager credentialstool で認証情報を暗号化し、それらを mongo.mongoUri 設定に入力し、以下のようにこの設定を true にします。

mongo.encryptedCredentials=true

オートメーション デフォルト パス

automation.default.backupAgentLogFile

型: string

デフォルト: /var/log/mongodb-mms-automation/backup-agent.log

Linux/macOS 上のバックアップ ログのデフォルト パス。

automation.default.certificateAuthorityFile

型: string

Linux/macOS 上の証明機関ファイルのデフォルト パス。

automation.default.dataRoot

型: string

デフォルト: /data

Automation が管理する MongoDB データベースのデフォルトのデータ パス。

automation.default.downloadBase

型: string

デフォルト: /var/lib/mongodb-mms-automation

Linux/macOS 上のオートメーションによって管理される配置のモニタリング、バックアップ、および MongoDB バイナリのデフォルト パス。

automation.default.monitoringAgentLogFile

型: string

デフォルト: /var/log/mongodb-mms-automation/monitoring-agent.log

Linux/macOS のモニタリング ログのデフォルト パス。

mms.agentCentralUrl

型: string

レガシーのモニタリングエージェントまたは MongoDB エージェントがモニタリング データをプッシュするのに使用する MongoDB Ops Manager アプリケーションの FQDN 。

設定されていない場合は、 mms.centralUrlの値を使用します。

重要

MongoDB Ops Manager アプリケーションに IPv6 アドレスを使用してアクセスする場合は、ポート番号と区別するために IPv6 アドレスを角括弧（[ ]）で囲む必要があります。

以下に例を挙げます。

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

バックアップ

mms.alerts.BackupAgentConfCallFailure.maximumFailedConfCalls

タイプ: 整数

デフォルト: 10

バックアップでこの回数を超える連続したテレカンの失敗が発生すると、MongoDB Ops Manager は次のグローバル アラートをトリガーします: Backup has too many conf call failures 。

mms.alerts.OutsideSpaceUsedThreshold.maximumSpaceUsedPercent

タイプ: 整数

デフォルト: 85

ブロックストアが合計ディスク容量のこのパーセンテージ以上を使用している場合、Ops Manager は次のシステムアラートをトリガーします。Blockstore space used exceeds threshold

mms.backupCentralUrl

型: string

従来のバックアップ エージェントまたは MongoDB エージェントがバックアップ データを送信するのに使用する MongoDB Ops Manager アプリケーションの FQDN 。

設定されていない場合は、 mms.centralUrlの値を使用します。

重要

MongoDB Ops Manager アプリケーションに IPv6 アドレスを使用してアクセスする場合は、ポート番号と区別するために IPv6 アドレスを角括弧（[ ]）で囲む必要があります。

以下に例を挙げます。

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

mms.backup.journal.heads

タイプ: ブール値

デフォルト: False

ヘッドデータベースがジャーナリングを使用するかどうかを設定します。単一のバックアップ ジョブのヘッド データベースに対するジャーナリングを有効または無効にするには、「バックアップ ジョブの管理」を参照してください。

FCV 4.2 以降では、ヘッドデータベース の代わりにバックアップカーソルをバックアップに使用します。

mms.backup.minimumOplogWindowHours

型: float

デフォルト: 3

これは、oplog が記録するデータベース操作の最小時間数を設定します。

配置の oplog は、最後のスナップショット以降のリカバリ データを保持できる十分な大きさでなくてはなりません。この値を増やして、Ops Manager に oplog 容量をモニターさせます。この値は、brs.snapshotSchedule.interval の値を満たすかそれを超えるように設定する必要があります。

値をbrs.snapshotSchedule.interval未満に設定すると、最後のスナップショットと oplog の終了の間に差が生じる可能性があります。 これにより、バックアップは復元に使用できなくなります。 古いバックアップジョブは、復元に使用する前に再同期する必要があります。

診断アーカイブ

mms.admin.diagnostics.archiveDocCountLimit

タイプ: 整数

デフォルト: 10000

MongoDB Ops Manager がアクティビティフィードから取得するエントリーの最大数。

mms.admin.diagnostics.archiveDocSizeLimit

タイプ: 整数

デフォルト: 7

MongoDB Ops Managerがアクティビティ フィードから取得するデータの最大日数。

mms.admin.diagnostics.archiveDocAgeLimit

タイプ: 整数

デフォルト: 7

MongoDB Ops Managerがアクティビティ フィードから取得するデータの最大日数。

mms.automation.diagnostics.lastAgentStatusDocAgeLimit

タイプ: 整数

デフォルト: 7

診断アーカイブの automationLastAgentStatus の最後に指定された日数を追加します。

mms.automation.diagnostics.includeEmptyProcessConfigs

タイプ: ブール値

デフォルト: False

プロセス配列が空でないグループのautomationConfigsを、診断アーカイブに追加するかどうかを示すフラグ。

メールアドレス

mms.fromEmailAddr

型: string

MongoDB Ops Manager アラートなどの一般的なメールを送信するために使用されるメール アドレス。メール アドレスにエイリアスを含めることができます。

mms.fromEmailAddr=mms-alerts@example.com

From Email Address に対応します。

mms.replyToEmailAddr

型: string

一般的なメールへの返信を送信するためのメール アドレス。

Reply To Email Address に対応します。

mms.adminEmailAddr

型: string

MongoDB Ops Manager 管理者のメール アドレス。このアドレスには、MongoDB Ops Manager の問題に関連するメールが送信されます。

Admin Email Address に対応します。

mms.emailDaoClass

型: string

デフォルト: SIMPLE_MAILER

使用する電メール インターフェース。

この設定は、ユーザー インターフェイスと構成ファイルで、異なる方法でラベル付けされます。

送信方法	構成設定（mms.emailDaoClass）
Amazon Web Services 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

型: string

接続したい HTTP または HTTPS プロキシのホスト名を指定します。

http.proxy.host=proxy.example.com

Proxy Host に対応します。

http.proxy.port

タイプ: 整数

ホストに接続したいポートを指定します。プロキシを使用するには、Proxy Port と Proxy Host の両方を指定する必要があります。

Proxy Port に対応します。

http.proxy.username

型: string

プロキシに認証が必要な場合は、この設定を使用してプロキシへの接続に使用するユーザー名を指定します。

Proxy Username に対応します。

http.proxy.password

型: string

プロキシに認証が必要な場合は、この設定を使用してプロキシへの接続に使用するパスワードを指定します。

Proxy Password に対応します。

http.proxy.nonProxyHosts

型: string

構成した送信プロキシをバイパスする内部ホストのパイプ区切り（ |）のリストを指定します。

*.foo.com|localhost

Non Proxy Hosts に対応します。

MongoDB バージョン管理

automation.versions.source

型: string

デフォルト: remote

MongoDB インストーラのバイナリのソースを表します。

automation.versions.sourceに指定できる値と、値を設定するために存在する必要がある条件は次のとおりです。

値	条件
remote	MongoDB Ops Manager とエージェントはインターネットにアクセスできます。
hybrid	Ops マネージャーはインターネットにアクセスできますが、エージェントはアクセスできません。Ops Manager は、MongoDB バイナリをインターネットからダウンロードします。エージェントは、Ops Manager からバイナリをダウンロードします。
local	Ops Manager もエージェントもインターネットにアクセスできません。MongoDB Ops Manager 管理者は、配置構築でインターネット アクセスを制限する」で説明されているように、バージョンマニフェストと MongoDB バイナリを Ops Manager ホストにアップロードする必要があります。

Installer Download Source に対応します。

automation.versions.download.baseUrl

型: string

デフォルト： 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

true に設定すると、Ops Manager は指定できる MongoDB バージョンを、配置で使用可能なバージョンに制限します。

この設定は、 automation.versions.download.baseUrlがカスタム値で設定されている場合にのみ適用されます。

automation.versions.directory

型: string

デフォルト: /opt/mongodb/mms/mongodb-releases/

Ops Manager が MongoDB バイナリを保存する Ops Manager アプリケーション サーバー上のディレクトリを指定します。オートメーションは、配置に MongoDB のバージョンをインストールまたは変更する際にバイナリにアクセスします。Version Manifest Source Local モードで実行するように設定すると、バックアップデーモンもこのディレクトリから MongoDB バイナリにアクセスします。詳細については、「配置構築でインターネット アクセスを制限する」を参照してください。

Versions Directory に対応します。

mongodb.release.autoDownload

タイプ: ブール値

デフォルト: True

バックアップデーモンが必要とするバージョンの 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

型: string

バックアップに MongoDB Community バイナリを使用するか、エンタープライズ バイナリを使用するかを指定します。

指定できる値は次のとおりです。

• 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

型: string

デフォルト: 本番環境サーバー

この Ops Manager インスタンスが管理するすべてのエンタープライズ プロセスの、デフォルトの MongoDB Enterprise サーバー タイプ。

次の表は、使用可能なサーバー タイプの値と、それぞれに必要なライセンスの数を示しています。

サーバーの意図	環境目的	ライセンス要件
本番環境サーバー	社内または社外のエンド ユーザー向けにアプリケーションをホストします。 エンド ユーザーが環境を使用する可能性がある場合、その環境は本番環境として機能します。これは、その環境がテスト、品質保証、評価、または開発機能のいずれを提供していても、適用されます。	サーバーごとに 1 つのライセンス
テスト/QAサーバー	このタイプの環境は、次の目的で使用できます。 テスト アプリケーションを実行して、設計どおり、期待どおりに動作することを確認します。プラットフォーム構成は、コンピューティング、ネットワーク、ストレージ機能において、本番環境のパフォーマンスが低いバージョンとなることがあります。 システム品質の保証 本番環境をシミュレートするように構成されたデータ、ハードウェア、ソフトウェアの組み合わせに対してアプリケーションを検証します。プラットフォーム構成は、コンピューティング、ネットワーク、およびストレージ機能の点で、小規模の本番環境でなくてはなりません。 ステージ パフォーマンス テストやリリース候補の承認を含む本番環境をシミュレートします。プラットフォーム構成は、コンピューティング、ネットワーク、およびストレージ機能において本番環境と同じでなくてはなりません。	サーバーごとに 1 つのライセンス
開発サーバー	アプリケーションの設計、コーディング、デバッグ、またはそれらの組み合わせが進行中のホスト。アプリケーションの現在の状態を別の環境に昇格できるかどうかを評価するために使用されます。	なし
RAM プール	あらゆる環境の目的に合わせて、サーバーの自由な組み合わせを提供します。	任意の数のサーバーに対して 1 つのライセンス（これらのサーバー間で購入した RAM の合計 GB の最大数まで）。

バッキング データベース	MongoDB Ops Manager のバッキング データベースをホストします。このオプションを有効にするには、アプリケーション データベースのモニタリングを有効にします。	なし

Default Ops Manager MongoDB Server Type に対応します。

mms.mongoDbUsage.ui.enabled

タイプ: ブール値

true に設定すると、Ops Manager Admin で MongoDB 使用状況 UI が有効になります。

MongoDB Usage UI に対応します。

mms.mongoDbUsage.collectData

タイプ: ブール値

デフォルト: False

true に設定すると、MongoDB 使用状況データの毎日のコレクションが有効になります。

MongoDB Usage Data Collection に対応します。

モニタリング

mms.agentCentralUrl

型: string

レガシーのモニタリングエージェントまたは MongoDB エージェントがモニタリング データをプッシュするのに使用する MongoDB Ops Manager アプリケーションの FQDN 。

設定されていない場合は、 mms.centralUrlの値を使用します。

重要

MongoDB Ops Manager アプリケーションに IPv6 アドレスを使用してアクセスする場合は、ポート番号と区別するために IPv6 アドレスを角括弧（[ ]）で囲む必要があります。

以下に例を挙げます。

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

Ops Manager 管理 API

mms.publicApi.whitelistEnabled

タイプ: ブール値

特定の API 呼び出しでは、アクセス リスト内の IP アドレスからリクエストが発信される必要があります。この要件をオフにするには、この設定を追加し、その値を false に設定します。

プッシュ ライブ移行

mms.pushLiveMigrations.mmsUi.centralUrl

型: string

MongoDB Ops Manager から Atlas へのライブ移行のベース URL（ https://cloud.mongodb.comなど）。

mms.pushLiveMigrations.syncJobs.enabled

タイプ: ブール値

true に設定すると、MongoDB Ops Manager で次のようなライブ移行プロセスに関する情報をリクエストできます。

• ライブ移行のソースとして使用できるプロジェクトと配置のリスト。

• それぞれの配置およびプロジェクトでライブ移行を円滑化できる、利用可能な構成済み移行ホストのリスト。

• Atlas でのライブ移行の現在の実行状況。

MongoDB Ops Manager はこの情報を使用して、ライブ移行プロセスを円滑化します。デフォルトは true です。

mms.pushLiveMigrations.updateJob.intervalSeconds

タイプ: ブール値

同期が更新される間の繰り返しの間隔（秒単位）。MongoDB Ops Manager と Atlas の間で組織のプロジェクト情報の同期が定期的に行われます。デフォルトの同期間隔は 60 です。MongoDB Ops Manager では、同期の更新が 10 ～ 43200 秒（12 時間）の間隔で発生すると想定されています。同期更新の実際の間隔が 43200 秒を超える場合、または検証フェーズ中の同期更新間の実際の間隔が 1800 秒（30 分）を超えると、Atlas へのライブ移行が停止したり、タイムアウトしたり、失敗したりすることがあります。

注意

この設定を更新した後、変更を有効にするためにウェブ サーバーを再起動します。

mms.pushLiveMigrations.updateJob.cooldownSeconds

タイプ: ブール値

組織のプロジェクトの情報同期リフレッシュの間隔（秒）。同期更新のデフォルトの間隔は 10です。MongoDB Ops Manager では、同期の更新が 10 ～ 43200 秒（12 時間）の間隔で発生すると想定されています。連続同期の実際の間隔が 43200 秒を超える場合、Atlas へのライブ移行が停止したり、タイムアウトしたり、失敗したりすることがあります。

注意

この設定を更新した後、変更を有効にするためにウェブ サーバーを再起動します。

mms.pushLiveMigrations.fetchJob.intervalSeconds

タイプ: ブール値

Atlas からのライブ移行プランの更新を同期するための繰り返しの間隔 （秒単位）。このプランには、Atlas の移行プロセスの手順が一覧表示されます。MongoDB Ops Manager は定期的に Atlas から現在のプランを取得して進捗状況を確認します。この情報がないと、MongoDB Ops Manager はライブ移行プロセスを次の段階に進めません。

デフォルトの同期間隔は 60 です。MongoDB Ops Manager では、同期の更新が 10 ～ 43200 秒（12 時間）の間隔で発生すると想定されています。連続同期の実際の間隔が 43200 秒を超える場合、Atlas へのライブ移行が停止したり、タイムアウトしたり、失敗したりすることがあります。

注意

この設定を更新した後、変更を有効にするためにウェブ サーバーを再起動します。

mms.automation.agentFeatures.migrationHosts.canManageDeployments

タイプ: ブール値

ユーザー インターフェイスのProjects の下の Add new deployment ビューにライブ移行ホストを使用可能なエージェントとして表示するかどうかを示します。デフォルトは false です。

セキュリティ

mms.security.disableBrowserCaching

タイプ: ブール値

デフォルト: False

true の場合、MongoDB Ops Manager はすべての HTTP 応答をキャッシュ不可にします。

mms.security.hstsMaxAgeSeconds

タイプ: 整数

デフォルト: 0（HTTP または HTTPS を使用できます。）

MongoDB Ops Manager が HTTPS を使用するブラウザ接続を制限する時間 （秒単位）。この値は正の整数である必要があります。値 0 は、HTTP または HTTPS を使用できることを意味します。

Tip

以下も参照してください。

HSTS を配置する方法については、「HTTP Strict Transport Security」、「RFC 6797」、および「hstspreload.org」を参照してください。

mms.security.show.om.version

タイプ: ブール値

デフォルト: True

false の場合、MongoDB Ops Manager はログイン ページにバージョン番号を表示しません。

サードパーティ統合

ユーザー認証

mms.email.validation

型: string

デフォルト: false

MongoDB Ops Manager でユーザー名をメールアドレスにする必要があるかどうかを決定します。

値	説明
false	（デフォルト）ユーザー名はメールアドレスである必要はありません。
loose	ユーザー名には、@ 記号とそれに続くピリオドを含める必要があります。
strict	ユーザー名は、厳格なメールアドレス検証の正規表現に準拠する必要があります。

strictに設定されている場合、MongoDB Ops Manager は次の正規表現を使用して、メールアドレスが3 RFC-3696 のセクション に記載されている要件に準拠していることを検証します。

^[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

型: string

デフォルト: UserSvcDb

認証資格情報を MongoDB Ops Manager アプリケーション データベースに保存するか、LDAP ディレクトリに保存するかを選択します。

指定できる値は次のとおりです。

認証方法	許容値
アプリケーション データベース	UserSvcDb 重要: MongoDB Ops Manager 6.0 では、許容値は com.xgen.svc.mms.svc.user.UserSvcDb です。 この古い許容値を使用すると、MongoDB Ops Managerインスタンスはプレフライト チェック中に起動しません。
LDAP	UserSvcLdap
SAML	UserSvcSaml

User Authentication Method に対応します。

Web Server

mms.centralUrl

型: string

MongoDB Ops Manager アプリケーションの FQDN とポート番号。

8080 以外のポートを使用するには、「Ops Manager のホスト名とポートの管理」を参照してください。

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

URL to Access Ops Manager に対応します。

重要

MongoDB Ops Manager アプリケーションに IPv6 アドレスを使用してアクセスする場合は、ポート番号と区別するために IPv6 アドレスを角括弧（[ ]）で囲む必要があります。

以下に例を挙げます。

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

mms.https.PEMKeyFile

型: string

MongoDB Ops Manager アプリケーションの有効な証明書とプライベート キーを含む PEM ファイルへの絶対パス。MongoDB Ops Manager アプリケーションが HTTPS を使用して、 MongoDB Ops Manager アプリケーション、エージェント、およびウェブ インターフェイス間の接続を暗号化する場合は、PEM ファイルが必要です。

MongoDB Ops Manager アプリケーションへの HTTPS アクセスのデフォルト ポートは、 <install_dir>/conf/mms.conf ファイルで設定されている 8443 です。このデフォルトを変更する場合は、mms.centralUrl 設定で指定されているポートも変更する必要があります。

HTTPS PEM Key File に対応します。

mms.https.PEMKeyFilePassword

型: string

HTTPS PEM キー ファイルのパスワード。PEMキー ファイルに暗号化された秘密キーが含まれている場合は、この設定を含める必要があります。

HTTPS PEM Key File Password に対応します。

mms.https.ClientCertificateMode

型: string

MongoDB Ops Manager に接続するときにクライアントが有効な TLS/SSL クライアント証明書を提示することを要求するかどうかを指定します。指定できる値は次のとおりです。

• none

• agents_only

• required

Client Certificate Mode に対応します。

mms.https.CAFile

型: string

次の場合に必須:

• プライベート証明機関を使用しています。

• mms.https.ClientCertificateMode を agents_only または required に設定します。

• TLS を有効にして MongoDB Ops Manager をハイブリッド モードで実行します。

受け入れ可能なクライアント証明書のリストを含むプライベート認証局ファイルのファイルシステムのロケーションを指定します。MongoDB Ops Manager アプリケーションは、このファイルに記述された証明書を持つクライアントからの HTTPS 要求を認証します。

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

CA File に対応します。

mms.https.dualConnectors

タイプ: ブール値

デフォルト: False

HTTP と HTTPS を同時に使用して MongoDB Ops Manager への接続を有効にします。

MongoDB Ops Manager と MongoDB エージェントを TLS を使用するようにアップグレードする間、この設定を一時的に使用できます。ダウンタイムをゼロにするには、 true に設定し、値を mms.http.bindhostname に指定します。MongoDB Ops Manager と MongoDB エージェントを構成した後、 false に設定します。

重要

mms.https.dualConnectorsが true の間、安全でない接続を使用して MongoDB Ops Manager にアクセスできます。

MongoDB エージェントをアップデートして TLS 接続を使用するようにした後でのみ、安全な接続を許可するには、 mms.https.dualConnectors を false に設定します。

mms.http.bindhostname

型: string

デフォルト: 127.0.0.1

MongoDB エージェントが HTTP を使用して MongoDB Ops Manager に接続できるホスト名または IP 。

MongoDB Ops Manager と MongoDB エージェントを TLS を使用するようにアップグレードする間、この設定を一時的に使用できます。ダウンタイムをゼロにするには、値を設定し、mms.https.dualConnectors を true に設定します。MongoDB Ops Manager と MongoDB エージェントを構成した後、値を削除します。

mms.remoteIp.header

型: string

ロード バランサーを MongoDB Ops Manager アプリケーションで使用する場合、ロード バランサーが MongoDB Ops Manager ホストに対して発信元クライアントの IP アドレスを識別するのに使用する HTTP ヘッダー フィールドにこれを設定します。Load Balancer Remote IP Header を指定すると、クライアントが MongoDB Ops Manager ホストに直接接続できなくなります。MongoDB Ops Manager ホストの前に配置されたロード バランサーは、キャッシュされたコンテンツを返してはなりません。

Load Balancer Remote IP Header が設定されると、MongoDB 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

型: string

デフォルト: TLSv1.2

クライアントが MongoDB Ops Manager に接続するために必要な TLS バージョンを指定します。このプロパティは、MongoDB Ops Manager Admin インターフェースへの接続に使用されるブラウザや、REST API への接続に使用される curl などのコマンドライン ツールなど、すべてのクライアントに影響します。

MongoDB Ops Manager バージョン 4.0.9 から 4.0.18 まで、および 4.2.13 と 4.4.0 以前

MongoDB Ops Manager はTLSv1.2 のみをサポートします。この値を TLSv1.2 以外の値（空白値を含む）に変更すると、この MongoDB Ops Manager に接続できなくなります。

MongoDB Ops Manager バージョン 4.0.0 から 4.0.8、4.0.18 またはそれ以降、4.2.13 またはそれ以降、4.4.0 またはそれ以降

MongoDB 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

型: string

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

クライアントが MongoDB Ops Manager アプリケーションおよび API に接続するときに MongoDB Ops Manager のインスタンスが受け入れることができない TLS 暗号スイートのリストを指定します。次の例のように、TLS 暗号スイート名をカンマ区切りのリストとして指定します。

重要

で使用される暗号スイート名に従う必要がありますMongoDB Ops Manager RFC5246 命名規則。OpenSSL の命名規則は使用しないでください。 便宜上、 MongoDB Ops Managerは起動時にサポートされているすべての暗号スイート名のリストをログに記録します。 MongoDB 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をカスタム値に設定すると、これらが無効にした暗号の 1 つ以上が再度有効になる可能性があります。

Webhook

mms.alerts.webhook.adminEndpoint

型: string

Webhook URL に対応します。

mms.alerts.webhook.adminSecret

型: string

Webhook Secret に対応します。