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 の認証情報を含める必要があります。

接続文字列のフォーマット方法は、以下により異なります。

• バッキング データベースに配置したクラスターのタイプ

• 使用するプロトコル、そして

• 使用する認証方法。

レプリカセット

シャーディングされたクラスター

データベースの バッキング インスタンス に レプリカセット を使用する場合、接続 string には、すべてのレプリカセット メンバーのホスト名または 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 をエスケープします。これにより、Kerberos のユーザー プリンシパル username@REALM.EXAMPLE.COM は username% 40 REALM.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 の新機能: マネージャー 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 をエスケープします。これにより、Kerberos のユーザー プリンシパル username@REALM.EXAMPLE.COM は username% 40 REALM.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 にすべてのシャードを含めます。ポート番号を省略すると、MongoDB 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 をエスケープします。これにより、Kerberos のユーザー プリンシパル username@REALM.EXAMPLE.COM は username% 40 REALM.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 の新機能: マネージャー 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 をエスケープします。これにより、Kerberos のユーザー プリンシパル username@REALM.EXAMPLE.COM は username% 40 REALM.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

型: string

default: /var/log/mongodb-mms-automation/backup-agent.log

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

automation.default.certificateAuthorityFile

型: string

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

automation.default.dataRoot

型: string

default: /data

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

automation.default.downloadBase

型: string

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

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

automation.default.monitoringAgentLogFile

型: string

default: /var/log/mongodb-mms-automation/monitoring-agent.log

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

mms.agentCentralUrl

型: string

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

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

重要

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

以下に例を挙げます。

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

バックアップ

mms.alerts.BackupAgentConfCallFailure.maximumFailedConfCalls

タイプ: 整数

default: 10

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

mms.alerts.OutsideSpaceUsedThreshold.maximumSpaceUsedPercent

タイプ: 整数

default: 85

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

mms.backupCentralUrl

型: string

レガシー バックアップエージェントまたは MongoDB エージェントによるバックアップ データの送信に使用される MongoDB Ops Manager アプリケーションの FQDN。

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

重要

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

以下に例を挙げます。

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

mms.backup.journal.heads

タイプ: ブール値

デフォルト: False

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

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

mms.backup.minimumOplogWindowHours

型: float

default: 3

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

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

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

診断アーカイブ

mms.admin.diagnostics.archiveDocCountLimit

タイプ: 整数

default: 10000

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

mms.admin.diagnostics.archiveDocSizeLimit

タイプ: 整数

default: 7

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

mms.admin.diagnostics.archiveDocAgeLimit

タイプ: 整数

default: 7

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

mms.automation.diagnostics.lastAgentStatusDocAgeLimit

タイプ: 整数

default: 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

default: 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

default: 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

default: /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の値を使用します。

重要

Ops Manager Application に 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 を使用できます。

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

HSTS の配置方法については、HTTP Strict Transport Security、RFC 6797、hstspreload.org を参照してください。

SNMP

サードパーティ統合

ユーザー認証

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

default: com.xgen.svc.mms.svc.user.UserSvcDb

認証資格情報を MongoDB 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

型: string

Ops Manager Application の FQDN とポート番号。

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

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

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

重要

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

以下に例を挙げます。

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

mms.https.PEMKeyFile

型: string

Ops Manager Application の有効な証明書と秘密キーが含まれる PEM ファイルへの絶対パス。Ops Manager Application が HTTPS を使用して Ops Manager Application、エージェント、および Web インターフェイス間の接続を暗号化する場合は、PEM ファイルが必要です。

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

HTTPS PEM Key File に対応します。

mms.https.PEMKeyFilePassword

型: string

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

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

mms.https.ClientCertificateMode

型: string

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

• none

• agents_only

• required

Client Certificate Mode に対応します。

mms.https.CAFile

型: string

次の場合に必須:

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

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

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

受け入れ可能なクライアント証明書のリストを含むプライベート認証局ファイルのファイルシステムの場所を指定します。Ops Manager Application は、このファイルに記述された証明書を持つクライアントからの 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 に指定します。Ops Manager と MongoDB エージェントの構成が完了したら、false に設定します。

重要

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

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

mms.http.bindhostname

型: string

default: 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	クライアントが Host HTTP リクエスト ヘッダーで要求した元のホスト。
X-Forwarded-Proto	HTTP リクエストの実行に使用されるプロトコル。
X-Forwarded-Server	プロキシ サーバーのホスト名。
X-Proxied-Https	リクエストの HTTPS ステータス。

詳細については、「高可用性 Ops Manager アプリケーションの構成」を参照してください。

Load Balancer Remote IP Header に対応します。

mms.minimumTLSVersion

型: string

default: TLSv1.2

クライアントが MongoDB Ops Manager に接続するために必要な TLS バージョンを指定します。このプロパティは、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 に対応します。