MongoDB Ops Manager は、MongoDB Ops Manager Application Database にグローバルに構成設定を保存するだけでなく、各サーバーにローカルに構成設定を保存します。グローバル設定はすべての Ops Manager サーバーに適用されます。ローカル設定は、それが構成されているサーバーに適用されます。サーバー上のローカル設定は、グローバル設定を上書きします。
ローカル設定は、サーバーの conf-mms.properties ファイルを通じて構成します。各サーバーの conf-mms.properties には、Ops Manager Application データベースにアクセスするための接続文字列と認証設定が含まれている必要があります。conf-mms.properties ファイルには、そのサーバーに固有のグローバル設定のオーバーライドも含まれます。
conf-mms.properties ファイルのロケーションは、以下の表に示すように、Ops Manager のインストール方法によって異なります。
インストール方法 | ロケーション conf-mms.properties |
|---|---|
|
|
|
|
ユーザー インターフェースによる初期設定のバイパス
最初のアカウントを作成した後、初期設定ウィザードをスキップして、 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設定必要性必須
なし
必須
必須
必須
必須
必須
必須
必須
必須
必須
任意
任意
任意
任意
任意
任意
任意
注意
任意とマークされたフィールドにはデフォルト値があります。これらを変更する場合は、設定と新しい値を指定できます。
例
以下の値はその例です。Ops Manager のインストールに適した値を代入します。この参照で指定されるその他の設定を追加することもできます。
最小限の機能で Ops Manager インストールを構成するには、次の設定を
conf-mms.propertiesに追加します。mms.ignoreInitialUiSetup=truemongo.mongoUri=mongodb://db1.example.com:27017,db2.example.com:27017,db3.example.com:27017mms.centralUrl=http://localhost:8080mms.fromEmailAddr=example@example.commms.replyToEmailAddr=example@example.commms.adminEmailAddr=example@example.commms.mail.transport=smtpmms.mail.hostname=mail.example.commms.mail.port=465
すべてのクラスターの表示
mms.allclusters.onlyMembershipタイプ: ブール値
デフォルト: False
すべてのクラスターの表示に、Ops Manager 管理者が属する配置のみを表示するか(値を
trueに設定)、管理者がアクセスできる配置のみを表示するか(値をfalseに設定)を決定します。
アプリケーション データベース接続
以下の設定は Ops Manager Application Database への Ops Manager 接続を構成します。この設定は、各 Ops Manager サーバーのconf-mms.propertiesファイルで構成する必要があります。 認証情報を暗号化するには、「ユーザー認証情報の暗号化」を参照してください。
mongo.mongoUri 設定は、MongoDB Ops Manager の構成の一部であり、アプリケーションデータベースへの接続を担当します。アプリケーションデータベースをレプリカセットとして配置する場合は、`mongo.mongoUri` を、レプリカセットのすべてのノードか、またはレプリカセットの `DNS` シードリストのいずれかを含む接続文字列に設定します:
mongo.mongoUri=mongodb://mongod1.example.com:40000,mongod2.example.com:40000,mongod3.example.com:40000アプリケーションデータベースが認証を使用している場合、接続文字列には、データベースが使用する認証メカニズムの認証情報も含まれている必要があります。配置タイプ、プロトコル、認証方法に一致する接続文字列の形式を見つけるには、mongo.mongoUriのセレクターを使用してください。
mongo.mongoUri型: string
MongoDB Ops Manager Application Database にアクセスするために使用される接続文字列。該当する場合、接続文字列には、MongoDB Ops Manager Application Database 上で使用される
authentication mechanismの認証情報を含める必要があります。接続文字列のフォーマット方法は、以下により異なります。
バッキング データベースに配置したクラスターのタイプ
使用するプロトコル、そして
使用する認証方法。
注意
必要な MongoDB ロール
バッキング データベースを認証する MongoDB ユーザーは、次のロールを持っている必要があります。
clusterAdminそうでなく、データベースがシャーディングされたクラスターである場合、clusterMonitor
mongo.encryptedCredentialsタイプ: ブール値
mongo.mongoUriで暗号化された認証情報を使用するには、Ops Manager credentialstool で認証情報を暗号化し、それらをmongo.mongoUri設定に入力し、以下のようにこの設定をtrueにします。mongo.encryptedCredentials=true
Ops Manager Application Database への Kerberos 認証
mms.kerberos.keyTab型: string
Kerberos を使用する場合は必須です。プリンシパルのキータブ ファイルへの絶対パス。
mms.kerberos.keyTab=/path/to/mms.keytab
mms.kerberos.principal型: string
Kerberos を使用する場合は必須です。 MongoDB での認証に使用されるプリンシパル。 これは
mongo.mongoUriとまったく同じユーザーである必要があります。mms.kerberos.principal=mms/mmsweb.example.com@EXAMPLE.COM
jvm.java.security.krb5.conf型: string
任意。代替の Kerberos 設定ファイルへのパス。 値は JVM の
java.security.krb5.confに設定されます。jvm.java.security.krb5.conf=/etc/conf/krb5.conf
Ops Manager アプリケーションデータベースへの OIDC 認証
MongoDB Ops Manager とバックアップデーモンは、このページに記載されている既存の認証メカニズムに加えて、MongoDB Ops Manager アプリケーションデータベース に OIDC を使用して認証できます。MongoDB Ops Manager は、スタートアップ時に conf-mms.properties からこれらの設定を読み込みます。これらの設定のいずれかを変更すると、Ops Manager を再起動する必要があります。バックアップデーモンはスタートアップ時に同じ conf-mms.properties ファイルを読み取るため、バックアップデーモンも再起動してください。
これらの設定は conf-mms.properties 内のすべての mongo.* 設定接続にグローバルに適用されます。したがって、これらの接続はすべて同じ OIDC 構成を共有します。
mms.oidcEnabledタイプ: ブール値
デフォルト: false
MongoDB Ops Manager とバックアップデーモンから MongoDB Ops Manager アプリケーションデータベースへの`OIDC` 認証を有効化します。既存の認証メカニズムに加えて、OIDC 認証が利用可能です。これを有効にしても、他の構成済みのメカニズムが無効になることはありません。
mongo.oidcEnabled=true
mms.oidcMethod型: string
MongoDB Ops Manager が OIDC を使用して MongoDB Ops Manager アプリケーションデータベースへの認証を行うためのトークン取得方法。このオプションを次のいずれかの値に設定してください。
callback: Keycloak、Okta、Azure などのカスタム IdP に対してクライアント認証情報フローを使用します。azure: Azure のワークロードアイデンティティに対して、組み込み環境認証を使用します。gcp: GCP のワークロード ID に対して組み込み環境認証を使用します。k8s: Kubernetes ワークロードアイデンティの場合は、組み込み環境認証を使用します。
azure、gcp、k8sメソッドの場合、MongoDB ドライバーは環境からワークロードアイデンティティトークンを取得し、クライアント シークレットを必要としません。mongo.oidcMethod=callback
mms.oidcTokenUri型: string
IdP のトークンエンドポイントとなる接続されたデバイスURL。MongoDB Ops Manager は、クライアント認証情報フローを使用してアクセストークンをリクエストするために、このエンドポイントとなる接続されたデバイスを使用します。
mms.oidcMethodがcallbackの場合に必要です。azure、gcp、k8sメソッドには使用されません。mongo.oidcTokenUri=https://idp.example.com/realms/prod/protocol/openid-connect/token
mms.oidcClientId型: string
アクセス トークンをリクエストする際に、MongoDB Ops Manager が IdP に提示するクライアント識別子。
mms.oidcMethodがcallbackの場合に必要です。azureメソッドの場合は、オプションでこれをユーザー割り当てマネージド ID のクライアント ID に設定できます。省略すると、Ops Manager はシステム割り当てマネージド ID を使用します。gcpまたはk8sメソッドには使用されません。mongo.oidcClientId=ops-manager-appdb
mms.oidcClientSecret型: string
アクセス トークンのリクエスト時に MongoDB Ops Manager が IdP に提示するクライアント シークレット。
mms.oidcMethodがcallbackの場合に必要です。これらのメソッドではクライアントシークレットが必要ないため、azure、gcp、k8sメソッドには使用されません。mongo.oidcClientSecret=<client-secret>
mms.oidcScope型: string
クライアント認証情報フローを使用してアクセス トークンを取得する際に、MongoDB Ops Manager が IdP からリクエストする OAuth2 スコープ。
mms.oidcMethodがcallbackの場合にのみ使用されます。azure、gcp、k8sメソッドには使用されません。mongo.oidcScope=openid
mms.oidcTokenResource型: string
環境からワークロード ID トークンを取得する際に MongoDB Ops Manager がリクエストするオーディエンスまたはリソース識別子。この値は、ターゲット MongoDB 配置の
oidcIdentityProviders設定でこの IdP に設定されているaudienceと一致する必要があります。mms.oidcMethodがazureまたはgcpの場合に必要です。callbackまたはk8sメソッドには使用されません。mongo.oidcTokenResource=https://my-mongodb-audience
重要
MongoDB Ops Manager は、MongoDB Ops Manager アプリケーションデータベースの OIDC 構成を conf-mms.properties を介してのみ公開します。管理インターフェースには、この設定のための UI は含まれていません。
アプリケーション データベースへの TLS/SSL 接続
mongo.sslタイプ: ブール値
trueに設定すると、Ops Manager Application データベースへの TLS 接続が有効になります。
mongodb.ssl.PEMKeyFile型: string
X509 証明書と秘密キーを含む PEM ファイルの名前。MongoDB インスタンスが
--tlsCAFileオプションまたはnet.tls.CAFile設定で実行中の場合に必須です。その証明書の
Extended Key UsageフィールドにTLS Web client authenticationが含まれている必要があります。MONGODB-X509認証メカニズムを使用して認証する場合は、mongoUri接続文字列にユーザー名としてこれを入力します。
オートメーション デフォルト パス
automation.default.backupAgentLogFile型: string
デフォルト:
/var/log/mongodb-mms-automation/backup-agent.logLinux/macOS 上のバックアップ ログのデフォルト パス。
automation.default.downloadBase型: string
デフォルト: /var/lib/mongodb-mms-automation
Linux/macOS 上のオートメーションによって管理される配置のモニタリング、バックアップ、および MongoDB バイナリのデフォルト パス。
automation.default.monitoringAgentLogFile型: string
デフォルト:
/var/log/mongodb-mms-automation/monitoring-agent.logLinux/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.backup.d2s3.transfer.numWorkersタイプ: 整数
デフォルト: 2
これは、Direct to S3 バックアップを使用してスナップショットブロックを S3 に直接アップロードする際に MongoDB Agent が使用する並列アップロードワーカーの数を設定します。MongoDB Ops Manager は、各バックアップでこの値を MongoDB Agent に渡します。MongoDB Agent は、独自のローカル構成からこの値を読み取りません。
このプロパティを設定すると、MongoDB Agent はその正確な作業者数を使用し、自動チューニングをスキップします。未設定のままにする場合、MongoDB Agent はホストの CPU とメモリに基づいてワーカー数を決定します。また、バックアップジョブごとにこの値を上書きすることもできます。S3 への直接バックアップを有効化する方法を学ぶには、「MongoDB Ops Manager の S3 への直接バックアップ」をご覧ください。
mms.backup.d2s3.transfer.maxNumUnitOfWorkBlocksタイプ: 整数
デフォルト: 100
これは、MongoDB AgentがS3への並列アップロードのためにスナップショットファイルを分裂する際の、Direct to S3 バックアップアップロードパスの作業単位あたりの最大ブロック数を設定します。
このプロパティが設定されていない場合、MongoDB Agentはワークユニットあたり100ブロックという組み込みのデフォルト値にフォールバックします。Direct to S3 バックアップを有効にする方法については、「Ops ManagerのDirect to S3 バックアップ」をご覧ください。
mms.backup.groom.failedDeleteRetryDelayHoursタイプ: 整数
デフォルト: 24
groom ジョブが削除できなかった S3 オブジェクト(オブジェクトがまだオブジェクトロック保持期間内にあるためなど)の削除を再試行する前に、バックアップデーモンが待機する時間数。
この値を
0以下に設定した場合、Ops Manager は警告をログに記録し、デフォルト値を使用します。Ops Manager がキューに入った削除処理を破棄することはありません。オブジェクトストアが30回の再試行後も削除を拒否する場合、バックアップデーモンは読み取りとオブジェクトの名前を示すエラーをログに記録します。
バックアップ スナップショット
backup.fileSystemSnapshotStore.gzip.compressionLevelタイプ: 整数
デフォルト: 6
Ops Manager がファイル システム ベースのスナップショットをどの程度圧縮するかを決定します。レベルの範囲は
0から9です。0では圧縮は提供されません。19では、スナップショットの圧縮速度が犠牲になり、圧縮の度合いが高まります。レベル1では、スナップショットの圧縮率は最低となりますが、速度は最も速くなります。レベル9では、スナップショットが最も圧縮されますが、速度は最も遅くなります。
注意
File System Store Gzip Compression Level を変更すると、新しいスナップショットにのみ影響します。既存のスナップショットの圧縮レベルには影響しません。
brs.restore.digest.method型: string
Default: SHA1
復元アーカイブ ファイルの SHA1 チェックサム値を生成するかどうかを指定します。
使用可能な値は
SHA1またはNONEです。
brs.snapshotSchedule.intervalタイプ: 整数
デフォルト: 24
連続する 2 つのスナップショット間の時間を時間単位で指定します。
指定できる値は次のとおりです。
6、8、12、または24
brs.snapshotSchedule.retention.baseタイプ: 整数
デフォルト: 2
間隔スナップショットを保存する日数を指定します。 許容値は、
brs.snapshotSchedule.intervalの値によって異なります。許容値
<
242、3、4、または5。=
242,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30.対応:
.Base Retention of Snapshots
brs.snapshotSchedule.retention.dailyタイプ: 整数
デフォルト: 0
日次スナップショットを保存する日数を指定します。
指定できる値は次のとおりです。
0,3,4,5,6,7,15,30,60,90,120,180or360対応:
.Daily Retention of Snapshots
brs.snapshotSchedule.retention.monthlyタイプ: 整数
デフォルト: 1
月次スナップショットを保存する月数を指定します。
指定できる値は次のとおりです。
0,1,2,3,4,5,6,7,8,9,10,11,12,13,18,24,36,48,60,72, and84
brs.snapshotSchedule.retention.weeklyタイプ: 整数
デフォルト: 2
週単位のスナップショットを保存する週数を指定します。
指定できる値は次のとおりです。
0,1,2,3,4,5,6,7,8,12,16,20,24, and52対応:
.Weekly Retention of Snapshots
brs.pitWindowInHoursタイプ: 整数
デフォルト: 24
特定の時点(PIT)から復元できる期間(時間単位)。
対応:
.PIT Window
backup.kmip.server.host型: string
デフォルト: なし
KMIP サーバーのホスト名を指定します。
MongoDB 4.2.1 以降(および 4.0.14)、カンマ区切りリストで複数の KMIPサーバーを指定できます。
重要
4.0.14 または 4.2.1 より前のバージョンのMongoDBでは、Ops Manager は、KMIPサーバーのホスト名のリストにある最初のKMIPホスト名のみを使用します。
mms.backup.snapshot.maxSumFileForWorkersMBタイプ: 整数
デフォルト: 2048
スナップショットを取得するときに同時に保存されるファイルの最大累積サイズ(メガバイト単位)を設定します。
クエリ可能なスナップショット構成
brs.queryable.connecttimeoutタイプ: 整数
デフォルト: 30
タイムアウトする前にクエリ可能なスナップショット
mongodインスタンスへの接続を待機する秒数。対応:
Mongo .Connection Timeout
brs.queryable.lruCacheCapacityMBタイプ: 整数
デフォルト: 512
グローバル スナップショット キャッシュ用に JVM ヒープから割り当てるサイズ(メガバイト単位)。 グローバル スナップショット キャッシュは、クエリ可能なスナップショットへの同じスナップショットデータに対する繰り返しのクエリを最適化します。
重要
MongoDB では、MongoDB サポートから変更の指示がない限り、この値を変更することはお勧めしません。
brs.queryable.mounttimeoutタイプ: 整数
デフォルト: 60
タイムアウトする前に、クエリ可能なスナップショットが準備されるまで待機する秒数。
対応:
.Queryable Startup Timeout
brs.queryable.pem.pwd型: string
Proxy Server PEM Fileが暗号化されている場合は必須です。注意
Proxy Server PEM File Passwordを更新した後、変更を有効にするために Web サーバーを再起動します。
brs.queryable.pem型: string
クエリ可能なスナップショットを使用する場合は必須です。1 つ以上の信頼できる証明書と関連する秘密キーの完全な証明書チェーンを含む PEM ファイル。
Proxy Server PEM File次の制限があります。この PEM ファイルは、MongoDB Ops Manager への`HTTPS`接続に使用されるものとは異なる必要があります( `
mms.https.PEMKeyFile` )。この PEM ファイルでは、512 ビットを超えるキー長を使用する必要があります。2048 ビット RSA キーの使用が推奨されます。
この PEM ファイルでは、
sha256など、sha1よりも強力なメッセージ ダイジェストを使用する必要があります。
注意
Proxy Server PEM Fileを更新した後、変更を有効にするために Web サーバーを再起動します。
brs.queryable.proxyPortタイプ: 整数
デフォルト: 25999
クエリ可能なバックアップ ホストのポート。
注意
Proxy Server Portを更新した後、変更を有効にするために Web サーバーを再起動します。
brs.queryable.tls.disabledProtocols型: string
Default: SSLv2Hello,SSLv3,TLSv1,TLSv1.1,TLSv1.3
クエリ可能なスナップショットと復元に対して無効になっている TLS プロトコル バージョン。
brs.queryable.tls.disabledCiphers型: string
Default: TLS_DHE_RSA_WITH_AES_128_CBC_SHA,TLS_DHE_RSA_WITH_AES_128_CBC_SHA256,TLS_DHE_RSA_WITH_AES_128_GCM_SHA256,TLS_DHE_RSA_WITH_AES_256_CBC_SHA,TLS_DHE_RSA_WITH_AES_256_CBC_SHA256,TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
クライアントがクエリ可能なバックアップ ホストに接続するときに MongoDB Ops Manager インスタンスが受け入れられない TLS 暗号スイートのリスト。TLS 暗号スイート名は、カンマ区切りリストとして、エントリ間に空白を入れずに指定します。
診断アーカイブ
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.fromEmailAddr型: string
MongoDB Ops Manager アラートなどの一般的なメールを送信するために使用されるメール アドレス。メール アドレスにエイリアスを含めることができます。
mms.fromEmailAddr=mms-alerts@example.com
mms.adminEmailAddr型: string
MongoDB Ops Manager 管理者のメール アドレス。このアドレスには、MongoDB Ops Manager の問題に関連するメールが送信されます。
mms.emailDaoClass型: string
デフォルト:
SIMPLE_MAILER使用する電メール インターフェース。
この設定は、ユーザー インターフェイスと構成ファイルで、異なる方法でラベル付けされます。
送信方法構成設定(mms.emailDaoClass)Amazon Web Services SES
AWS_MAILERSMTPSIMPLE_MAILERこれを SMTP メール サーバーに設定する場合は、以下を設定する必要があります。
これを AWS Simple Email Service に設定する場合は、以下を設定する必要があります。
SMTP メール サーバー
条件付き。 mms.emailDaoClass を SIMPLE_MAILER に設定すると、次の設定が表示されます。
AWS Simple Email Service
条件付き。 mms.emailDaoClass を AWS_MAILER に設定すると、次の設定が表示されます。
aws.ses.endpoint型: string
デフォルト:
https://email.us-east-1.amazonaws.com送信API エンドポイントを 設定します Amazon Web ServicesSES 用の。
HTTP Proxy
http.proxy.portタイプ: 整数
ホストに接続したいポートを指定します。プロキシを使用するには、
Proxy PortとProxy Hostの両方を指定する必要があります。
Kubernetes Setup
kubernetes.templates.credentialsFilePath型: string
MongoDB Ops Managerプロジェクト内の オブジェクト を作成または更新するためのKubernetes secret としての プログラマティックAPIキー を含む YAMLファイルへのパス。このファイルはYAML形式で、
/mongodb-ops-manager/ディレクトリに保存する必要があります。このファイルはKubernetes Secret Setupに対応します。apiVersion: v1kind: Secretmetadata: name: organization-secret namespace: mongodbstringData: user: ${publicKey} publicApiKey: ${privateKey}
kubernetes.templates.projectFilePath型: string
Ops Manager プロジェクトへのリンクに使用する ConfigMap を含む YAML ファイルへのパス。このファイルは YAML 形式で、
/mongodb-ops-manager/ディレクトリに保存する必要があります。また、Kubernetes ConfigMap Setupに対応しています。
MongoDB バージョン管理
automation.versions.source型: string
デフォルト:
remoteMongoDB インストーラのバイナリのソースを表します。
automation.versions.sourceに指定できる値と、値を設定するために存在する必要がある条件は次のとおりです。値条件remoteMongoDB Ops Manager とエージェントはインターネットにアクセスできます。
hybridOps マネージャーはインターネットにアクセスできますが、エージェントはアクセスできません。Ops Manager は、MongoDB バイナリをインターネットからダウンロードします。エージェントは、Ops Manager からバイナリをダウンロードします。
localOps Manager もエージェントもインターネットにアクセスできません。MongoDB Ops Manager 管理者は、配置構築でインターネット アクセスを制限する」で説明されているように、バージョンマニフェストと MongoDB バイナリを Ops Manager ホストにアップロードする必要があります。
automation.versions.download.baseUrl型: string
デフォルト: downloads.mongodb.com、ダウンロードする.mongodb.org,fastdl.mongodb.org,opsmanager.mongodb.com
MongoDB バイナリを取得するための HTTP(S) エンドポイント。エンドポイントとなる接続されたデバイスが HTTPS エンドポイントとなる接続されたデバイスの場合、
httpsCAFileで指定された証明機関ファイルを使用して証明書が検証されます。automation.versions.download.baseUrlが設定されていない場合、MongoDB は MongoDB バイナリ用のデフォルトのリモート 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 SourceLocalモードで実行するように設定すると、バックアップデーモンもこのディレクトリから MongoDB バイナリにアクセスします。詳細については、「配置構築でインターネット アクセスを制限する」を参照してください。
mongodb.release.autoDownloadタイプ: ブール値
デフォルト: True
バックアップデーモンが必要とするバージョンの MongoDB を、バックアップデーモンが自動的にインストールするかどうかを示すフラグ。
trueデーモンはインターネット経由で MongoDB Inc. からバイナリを取得します。
falseバックアップデーモンはインターネットにアクセスできないため、Ops Manager 管理者は、バックアップデーモンが必要とする MongoDB リリースのすべてのアーカイブ バージョンを手動でダウンロードして抽出する必要があります。管理者は、抽出したバイナリを Ops Manager ホスト上の
Versions Directoryに配置する必要があります。警告
Ops Manager がローカル モードで実行されている場合は、
falseに設定します。
mongodb.release.autoDownload.enterpriseタイプ: ブール値
バックアップデーモンが必要とするバージョンの MongoDB の エンタープライズ エディションを、バックアップデーモンが自動的にインストールするかどうかを示すフラグ。
mongodb.release.autoDownloadをtrueに設定する必要があります。警告
Linux ホストでMongoDB Enterpriseを実行する場合は、MongoDB をインストールする前に、各ホストに一連の依存関係を手動でインストールする必要があります。 MongoDB マニュアルには、依存関係をインストールするための適切なコマンドが記載されています。
「配置構築でインターネット アクセスを制限する」を参照してください。
mongodb.release.modulePreference型: string
バックアップに MongoDB Community バイナリを使用するか、エンタープライズ バイナリを使用するかを指定します。
指定できる値は次のとおりです。
enterprisePreferredenterpriseRequiredcommunityRequired
enterpriseRequiredまたはcommunityRequiredが選択されると、Ops Manager はバックアップにそれらのバイナリのみを使用します。enterprisePreferredを選択すると、Ops Manager は、使用可能な場合はエンタープライズ バイナリを使用し、使用できない場合はコミュニティ バイナリを使用します。注意
enterpriseRequiredを選択した場合、mongodb.release.autoDownload.enterpriseをtrueに設定するか、エンタープライズ バイナリをローカル モードでautomation.versions.directoryに手動で配置する必要があります。警告
enterpriseRequiredまたはcommunityRequiredのいずれかが選択されている場合、バックアップは失敗しますが、automation.versions.directoryに必要なバイナリが含まれていません。
MongoDB の使用法
mms.mongoDbUsage.defaultUsageType型: string
デフォルト:
PRODUCTION_SERVERこの Ops Manager インスタンスが管理するすべてのエンタープライズ プロセスの、デフォルトの MongoDB Enterprise サーバー タイプ。
構成ファイルで、このパラメーターを次のいずれかの値に設定します。
PRODUCTION_SERVERTEST_SERVERDEV_SERVERRAM_POOLRAM_POOL_TESTBACKING_DATABASE
MongoDB Ops Manager は、ホストする、そのプロジェクト、およびその組織でサーバーの種類が指定されていない場合にのみ、この値を使用します。特定のホストのサーバーの種類を設定するには、MongoDB 使用ページを使用します。MongoDB Ops Manager は、各ホストするもの自身のサーバータイプを基準として使用状況のレポートを作成します。
次の表には、サーバーの種類ごとの環境の目的とライセンス要件が記述されています。この表では、上記の構成ファイルの値ではなく、MongoDB Ops Manager UI に表示されるサーバーの種類ラベルが使用されます。
サーバーの意図環境目的ライセンス要件本番環境サーバー
社内または社外のエンド ユーザー向けにアプリケーションをホストします。
エンド ユーザーが環境を使用する可能性がある場合、その環境は本番環境として機能します。これは、その環境がテスト、品質保証、評価、または開発機能のいずれを提供していても、適用されます。
サーバーごとに 1 つのライセンス
テスト/QAサーバー
このタイプの環境は、次の目的で使用できます。
- テスト
- アプリケーションを実行して、設計どおり、期待どおりに動作することを確認します。プラットフォーム構成は、コンピューティング、ネットワーク、ストレージ機能において、本番環境のパフォーマンスが低いバージョンとなることがあります。
- システム品質の保証
- 本番環境をシミュレートするように構成されたデータ、ハードウェア、ソフトウェアの組み合わせに対してアプリケーションを検証します。プラットフォーム構成は、コンピューティング、ネットワーク、およびストレージ機能の点で、小規模の本番環境でなくてはなりません。
- ステージ
- パフォーマンス テストやリリース候補の承認を含む本番環境をシミュレートします。プラットフォーム構成は、コンピューティング、ネットワーク、およびストレージ機能において本番環境と同じでなくてはなりません。
サーバーごとに 1 つのライセンス
開発サーバー
アプリケーションの設計、コーディング、デバッグ、またはそれらの組み合わせが進行中のホスト。アプリケーションの現在の状態を別の環境に昇格できるかどうかを評価するために使用されます。
なし
RAM プール
あらゆる環境の目的に合わせて、サーバーの自由な組み合わせを提供します。
任意の数のサーバーに対して 1 つのライセンス(これらのサーバー間で購入した RAM の合計 GB の最大数まで)。
バッキング データベース
MongoDB Ops Manager のバッキング データベースをホストします。このオプションを有効にするには、アプリケーション データベースのモニタリングを有効にします。
なし
モニタリング
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
フェイルオーバーのモニタリング
複数の MongoDB エージェントでモニタリング機能を有効にして、モニタリングの割り当てを分散し、フェイルオーバーを提供できます。MongoDB Ops Manager は、最大 100 の実行中の MongoDB エージェントにモニタリング割り当てを分散します。アクティブなモニタリング モニターを実行中の各 MongoDB エージェントは、MongoDB プロセスの異なるセットをモニタリングします。プロジェクトごとにアクティブなモニタリングを実行する 1 つの MongoDB Agent が、プライマリ モニターになります。プライマリ モニターはクラスターのステータスを MongoDB Ops Manager に報告します。MongoDB エージェントでモニタリングが有効または無効になると、MongoDB Ops Manager は割り当てを再度分散します。プライマリ モニターに障害が発生した場合、MongoDB Ops Managerは、アクティブなモニタリングを実行中の別の MongoDB エージェントを、プライマリ モニターとして割り当てます。
以下の設定は、MongoDB Ops Manager がモニタリングにアクセスできないかどうかを判断する間隔と、スタンバイ エージェントが MongoDB Ops Manager をポーリングしてモニタリング割り当てを受信するかどうかを判断する頻度を調整します。
Ops Manager 管理 API
mms.publicApi.accessListEnabledタイプ: ブール値
特定の API 呼び出しでは、リクエストがアクセス リスト内の IP アドレスから発信される必要があります。この要件をオフにするには、この設定を追加し、その値を
falseに設定します。
Prometheus
Prometheus を通じて取り込むことができるメトリクスを有効にするには、次の設定を構成する必要があります。これらの設定は、[Custom] タブで、Ops Manager Config ページ内の [Administration Console: General] タブでも構成できます。
これらの設定を構成した後、各インスタンスで Ops Manager を再起動する必要があります。再起動後、新しい Prometheus エンドポイントには、次の形式のURLでアクセスできます。
http(s)://<opsManagerUri>:<port>/metrics注意
Prometheus のメトリクス用にリスニング ポートを指定できます。Ops Manager が使用するポートは、デフォルトのものである必要はありません。HTTP 用には 8080、HTTPS 用には 8443 を使用できます。指定された Prometheus メトリクスのポートに対してネットワークが通信を許可していることを確認してください。
有効にした後、統計情報を収集する Ops Manager サーバーごとに、Prometheus で次のような新しいスクレイプ構成を構成する必要があります。
scrape_config
scrape_configs:
- job_name: 'opsmanager' static_configs: - targets: [<opsManagerHostname>:<port>]各サーバーのエンドポイントは、同じサーバーのメトリクスのみを提供することに注意してください。
prom.listening.enabledタイプ: ブール値
Prometheus へのアクセスを有効にするかどうかを指定するフラグ。Ops Manager Prometheus エンドポイントを有効にするには、値を
trueに設定します。省略された場合、デフォルトはfalseになります。
prom.listening.portタイプ: 数値
Ops Manager が Prometheus エンドポイントとなる接続されたデバイスへのリクエストを受け付けるポート。ポートは、MongoDB Ops Manager がすでにリッスンしているポートとは異なる必要があります。HTTP の場合は 8080、HTTPS の場合は 8443 です。すべてのサーバーは指定されたポートでリッスンします。したがって、すべてのサーバーでポートが開いていることを確認してください。各サーバーごとに異なるポートを指定したい場合は、ポートを指定するために代わりに
conf-mms.propertiesを使用してください。
プッシュ ライブ移行
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.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 はログイン ページにバージョン番号を表示しません。
非均一メモリ アクセス (NUMA)
mongodb.disable.numaタイプ: ブール値
ヘッドデータベースの NUMA を無効にするには、次の値を使用してカスタム設定の変更手順に従います。
Key
mongodb.disable.numaValue
trueNUMA の詳細については、MongoDB プロダクション ノートの「MongoDB と NUMA ハードウェア」を参照してください。
重要
バックアップデーモンが有効になっている各 MongoDB Ops Manager インスタンスには、
numactlサービスがインストールされている必要があります。numactlがインストールされておらず、この設定がtrueに設定されている場合、バックアップジョブは失敗します。MongoDB Ops Managerは任意のバックアップジョブを暗号化できます。 ヘッドデータベース の代わりに バックアップカーソル を使用してバックアップジョブを暗号化します。詳細については、「バックアップデーモンサービス 」を参照してください。
Data Explorer
次の設定は、Ops Manager の Data Explorer 機能の使用を制御します。
mms.featureFlag.dataExplorer型: string
デフォルト:
controlledOps Manager の Data Explorer 機能の利用をグローバルに制御します。デフォルト値
controlledは、明示的にenabledまたはdisabledに変更するまで維持されます。disabledに設定している場合、ユーザーはどのプロジェクトでも Data Explorer にアクセスできません。この設定は、プロジェクトレベルの Data Explorer 設定を上書きします。値説明controlled(デフォルト)管理者は、組織ごとまたはプロジェクトごとに Data Explorer を有効または無効にできます。
enabledData Explorer は、すべての組織およびプロジェクトでグローバルに利用可能です。
disabledData Explorer はグローバルに無効になっています。ユーザーはどのプロジェクトでも Data Explorer にアクセスできません。
Tip
この設定を追加する方法については、「カスタム設定の変更」を参照してください。
サードパーティ統合
Datadog 統合
datadog.api.url型: string
デフォルト:
https://api.datadoghq.com/api/v1MongoDB Ops Manager が Datadog API にアクセスするために使用する URL 。
Datadog をローカルに配置している場合は、このカスタム パラメータを有効にします。これを、導入環境に適した値に設定します。
Tip
この設定を追加する方法については、「カスタム設定の変更」を参照してください。
Opsgenie Integration
opsgenie.api.url型: string
デフォルト:
https://api.opsgenie.com/v2/alertsMongoDB Ops Manager がヨーロッパ諸国で Ops Genie API にアクセスするために使用する URL。
MongoDB Ops Manager インスタンスがヨーロッパで実行される場合は、このカスタム パラメータを有効にします。次に、その値を
https://api.eu.opsgenie.com/v2/alertsに設定します。詳細については、Opsgenie Alert ドキュメント を参照してください。
Tip
この設定を追加する方法については、「カスタム設定の変更」を参照してください。
Twilio の統合
SMS または 2FA コードでアラート通知を受け取るには、Twilio のアカウントが必要です。
twilio.account.sid型: string
Twilio のアカウントID。
ユーザー認証
mms.email.validation型: string
デフォルト: false
MongoDB Ops Manager でユーザー名をメールアドレスにする必要があるかどうかを決定します。
値説明false(デフォルト)ユーザー名はメールアドレスである必要はありません。
looseユーザー名には、
@記号とそれに続くピリオドを含める必要があります。strictユーザー名は、厳格なメールアドレス検証の正規表現に準拠する必要があります。
strictに設定されている場合、MongoDB 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は有効ではありません。
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
UserSvcLdapSAMLUserSvcSaml
MongoDB Ops Manager Application Databaseによる認証
mms.password.maxDaysInactiveBeforeAccountLockタイプ: 数値
MongoDB Ops Manager がアカウントをロックするまでに MongoDB Ops Manager のウェブサイトにアクセスしない最大日数。
mms.password.maxFailedAttemptsBeforeAccountLockタイプ: 数値
アカウントがロックされるまでにログインに失敗した回数。ロックされたアカウントのロックを解除できるのは、MongoDB Ops Manager 管理者だけです。
mms.login.ratelimit.attemptsAllowedタイプ: 数値
特定の IP アドレスのユーザーがタイムアウト期間中に試行できるログインの数。この設定は
Login Attempts Timeout Periodと一緒に構成する必要があります。
mms.login.ratelimit.lockedPeriodMinutesタイプ: 数値
この設定では、次の項目を指定します。
ログイン試行回数が多すぎるかどうかを判断するために使用される期間 (分単位)。
ログインを再開する前にアカウントがロックされる期間。
この設定は
Login Attempts Allowed Before Timeoutと一緒に構成する必要があります。重要
ドロップダウン メニューには、この設定で使用可能な値のみがリストされます。 ドロップダウンにリストされていない値を
conf-mms.propertiesファイルまたはローカル データベースに設定しようとすると、 MongoDB Ops Managerインスタンスの再起動時にエラーが発生します。
mms.user.invitationOnlyタイプ: ブール値
true の場合、新しいユーザーは招待によってのみ登録できます。招待状には、登録リンクを表示する URL が記載されています。false の場合、新しいユーザーは MongoDB Ops Manager URL があれば登録できます。
mms.user.bypassInviteForExistingUsersタイプ: ブール値
デフォルト: False
このチェックボックスは、
mms.userSvcClassをUserSvcDbに設定すると表示されます。値結果true招待なしで、既存のユーザーを任意の組織またはプロジェクトに追加できます。
MongoDB Ops Manager は保留中の招待をすべて削除して無効にします。
新規ユーザーは引き続き招待を受け、招待を受け入れなければなりません。
false- すべてのユーザーは引き続き招待を受け、招待を受け入れなければなりません。
LDAP による認証
これらの設定により、MongoDB Ops Manager は認証に LDAP サーバーを使用するように構成されます。LDAP 認証を使用する場合、MongoDB Ops Manager にログインするには、ユーザーが LDAP グループに属している必要があります。MongoDB Ops Manager ユーザー ロールごとに LDAP グループを作成する必要があります。
開始設定 mms.ldap.global.role 指定された LDAP グループのメンバーに MongoDB Ops Manager グローバル ロールを割り当てます。LDAP User Group設定で指定された LDAP 属性で使用される形式を使用してグループを指定します。 ;;区切り記号を使用して、複数のグループを指定できます。デフォルトの区切り記号を変更するには、mms.ldap.group.separator 設定を使用します。各 MongoDB Ops Manager グローバル ロールは、配置内のすべての MongoDB Ops Manager プロジェクト へのアクセス権レベルを提供します。特定のグループにアクセスを許可するには、グループ レベルのロールを使用します。
mms.ldap.global.role.automationAdmin型: string
MongoDB Ops Manager で、 グローバル オートメーション管理者ロール を持つノードが含まれる LDAP グループ。設定で指定された LDAP
LDAP User Group属性で使用される形式を使用してプロジェクトを指定します。複数のプロジェクトを区切り文字;;で指定できます。デフォルトの区切り文字を変更するには、mms.ldap.project.separator設定を使用します。mms.ldap.global.role.automationAdmin=CN\=MMS-AutomationAdmin,OU\=MMS,OU\=acme Groups,DC\=acme,DC\=example,DC\=com各 MongoDB Ops Manager グローバル ロールは、配置内のすべての MongoDB Ops Manager プロジェクト へのアクセス権レベルを提供します。特定のプロジェクトへのアクセスを提供するには、グループ レベルのロールを使用します。
mms.ldap.global.role.backupAdmin型: string
MongoDB Ops Manager でグローバル バックアップ管理者ロールを持つノードが含まれる LDAP グループ。
mms.ldap.global.role.backupAdmin=CN\=MMS-BackupAdmin,OU\=MMS,OU\=acme Groups,DC\=acme,DC\=example,DC\=com
mms.ldap.global.role.monitoringAdmin型: string
MongoDB Ops Manager で グローバル モニタリング管理者ロールを持つノードが含まれる LDAP グループ。
mms.ldap.global.role.monitoringAdmin=CN\=MMS-MonitoringAdmin,OU\=MMS,OU\=acme Groups,DC\=acme,DC\=example,DC\=com
mms.ldap.global.role.owner型: string
MongoDB Ops Manager 配置に対する完全な権限と、すべての MongoDB Ops Manager プロジェクト への完全なアクセスおよびすべての管理権限を含む LDAP グループ。指定された LDAP グループ内のユーザーには、MongoDB Ops Manager で グローバル所有者 ロールが付与されます。設定で指定された LDAP
LDAP User Group属性で使用される形式を使用してプロジェクトを指定します。mms.ldap.global.role.owner=CN\=MMSGlobalOwner,OU\=MMS,OU\=acme Groups,DC\=acme,DC\=example,DC\=com
mms.ldap.global.role.readOnly型: string
MongoDB Ops Manager でグローバル読み取り専用ロールを持つメンバーの LDAP グループ。
mms.ldap.global.role.readOnly=CN\=MMS-ReadOnly,OU\=MMS,OU\=acme Groups,DC\=acme,DC\=example,DC\=com
mms.ldap.global.role.userAdmin型: string
MongoDB Ops Manager でグローバル ユーザー管理者ロールを持つメンバーの LDAP グループ。
mms.ldap.global.role.userAdmin=CN\=MMS-UserAdmin,OU\=MMS,OU\=acme Groups,DC\=acme,DC\=example,DC\=com
mms.ldap.group.baseDn型: string
デフォルト:
LDAP User Base Dn値MongoDB Ops Manager がグループを検索するために使用する基本識別名 (DN)。空白のままにすると、この設定はデフォルト値を使用します。
mms.ldap.group.baseDn=OU\=groups,DC\=acme,DC\=com
mms.ldap.group.member型: string
ユーザー識別名(DN)を含むグループ エントリのフィールド。一般的に、 groupOfNames または groupOfUniqueNamesオブジェクトクラスが使用されます。
mms.ldap.group.member=member
mms.ldap.group.separator型: string
デフォルト:
;;LDAP の区切り文字を設定するには、次の値を使用してカスタム設定の変更手順を行います。
Key
mms.ldap.group.separatorValue
<desired-separator>各グローバル ロールの値は、区切られたプロジェクトのリストを受け取ります。
"dbas,sysadmins"グループ値に区切り文字が含まれている場合は、区切り文字を別の値に設定する必要があります。
例
グループ値が
"CN\=foo,DN\=bar"で、区切り文字が,の場合、MongoDB Ops Manager は"CN\=foo,DN\=bar"を 1 つのグループの説明としてではなく、2 つの要素として解析します。
mms.ldap.referral型: string
LDAP field used to set how to handle referrals. Accepts two values:
ignore: 紹介を無視します。follow: 紹介を自動的にフォローします。
mms.ldap.ssl.CAFile型: string
PEM 形式の 1 つ以上の信頼できる証明書を含むファイル。LDAPS を使用しており、サーバーが既知の証明機関からのものではない証明書を使用している場合は、この設定を使用します。
mms.ldap.ssl.CAFile=/opt/CA.pem
mms.ldap.ssl.PEMKeyFile型: string
クライアント証明書と秘密キーを含むファイル。お使いの TLS LDAP サーバーでクライアント証明書が必要な場合は、この設定を使用します。
mms.ldap.ssl.PEMKeyFile=/opt/keyFile.pem
mms.ldap.ssl.PEMKeyFilePassword型: string
LDAP SSL PEM Key Fileのパスワード。PEMKeyFileが暗号化されている場合、この設定を使用します。mms.ldap.ssl.PEMKeyFilePassword=<password>
mms.ldap.user.baseDn型: string
MongoDB Ops Manager がユーザーを検索するために使用する基本識別名 (DN)。
=記号を\でエスケープします。mms.ldap.user.baseDn=DC\=acme,DC\=example,DC\=com
mms.ldap.user.email型: string
Default:
mailper RFC2256LDAP user attribute that contains the user's email address. After successful LDAP authentication, Ops Manager synchronizes the specified LDAP attribute with the email address from the Ops Manager user record.
mms.ldap.user.email=mail
mms.ldap.user.firstName型: string
Default:
givenNameper RFC2256LDAP user attribute that contains the user's first name. After successful LDAP authentication, Ops Manager synchronizes the specified LDAP attribute with the first name from the Ops Manager user record.
mms.ldap.user.firstName=givenName
mms.ldap.user.group型: string
ユーザーが属する LDAP グループのリストを含む LDAP ユーザー属性。LDAP 属性では、コモン ネーム(
cn)や識別名(dn)など、任意の形式を使用してプロジェクトを一覧表示できます。この構成ファイル内のプロジェクトを指定するすべての MongoDB Ops Manager 設定は、選択した形式と一致する必要があります。重要
MongoDB Ops Manager では
mms.ldap.user.groupが非推奨になりました。mms.ldap.group.memberを使用します。次の値を指定する場合
mms.ldap.user.groupとmms.ldap.group.memberの両方で、MongoDB Ops Manager はmms.ldap.group.memberを使用し、mms.ldap.user.groupを無視します。mms.ldap.user.groupただし、MongoDB Ops Manager はネストされた LDAP グループ内のユーザーのメンバーシップを認識しません。
mms.ldap.user.group=memberOf
mms.ldap.user.lastName型: string
Default:
surnameper RFC2256ユーザーの姓を含む LDAP ユーザー属性。LDAP 認証が成功すると、MongoDB Ops Manager は指定された LDAP 属性を MongoDB Ops Manager ユーザー レコードの姓と同期します。
mms.ldap.user.lastName=sn
mms.ldap.user.searchAttribute型: string
LDAP 検索に使用される LDAP フィールド。これは通常、ユーザー名またはメールアドレスです。このフィールドの値は、MongoDB Ops Manager のユーザー名としても使用されます。
mms.ldap.user.searchAttribute=<myAccountName>
SAML による認証
mms.saml.idp.uri型: string
シングル サインオンを調整するために使用する IdP( IdP )の URI 。これは、 EntityId または IdP 発行者と呼ばれることもあります。
mms.saml.slo.url型: string
URL of the Single Logout endpoint that Ops Manager calls when a user attempts to log out. If set, when a user attempts to log out of Ops Manager, they log out of your IdP. If left blank, logging out of Ops Manager doesn't log the user out of their IdP session.
mms.saml.ssl.PEMKeyFile型: string
Absolute path to the PEM file for the certificate that the SP uses to sign requests, containing both the private and public key. If this is left blank, Ops Manager doesn't sign SAML auth requests to the IdP and you can't encrypt SAML assertions.
mms.saml.encrypted.assertionsタイプ: ブール値
IdP がMongoDB Ops MongoDB Ops ManagerManagerに送信するアサーションを暗号化するかどうかを示すフラグ。
mms.saml.signedAssertionsタイプ: ブール値
デフォルト:
trueIdP が MongoDB Ops Manager に送信するアサーションに署名するかどうかを示すフラグ。
重要
アサーションまたはレスポンスのいずれかが署名されていることを確認します。 アサーションまたは応答のいずれかが署名されていない場合、構成は検証に失敗し、 MongoDB Ops Managerはエラーを返します。MongoDB Ops Manager
mms.saml.signedMessagesタイプ: ブール値
デフォルト:
trueIdP が MongoDB Ops Manager に送信する応答に署名するかどうかを示すフラグ。
重要
アサーションまたはレスポンスのいずれかが署名されていることを確認します。 アサーションまたは応答のいずれかが署名されていない場合、構成は検証に失敗し、 MongoDB Ops Managerはエラーを返します。MongoDB Ops Manager
mms.saml.signature.algorithm型: string
IdP との間で送受信される署名を暗号化するアルゴリズム。
次のいずれかの完全な W3.org を使用する必要があります署名アルゴリズム値は、次のとおりです。
http://www.w3.org/2001/04/xmldsig-more#rsa-sha1http://www.w3.org/2000/09/xmldsig#dsa-sha1http://www.w3.org/2001/04/xmldsig-more#rsa-sha256http://www.w3.org/2001/04/xmldsig-more#rsa-sha384http://www.w3.org/2001/04/xmldsig-more#rsa-sha512
重要
単純なstring値ではなく、完全なW3.org署名アルゴリズムURLを指定する必要があります。単純な string 値を使用すると、
rsa-sha256など、IdP は署名を正しく検証できないため、MongoDB Ops Manager はunauthorizedエラーを返します。例:
mms.saml.signature.algorithm=http://www.w3.org/2001/04/xmldsig-more#rsa-sha256
mms.saml.global.role.owner型: string
SAML グループ ノード属性内のグループ。このグループのノードには、この配置に対してすべてのグループへの完全なアクセス権およびすべての管理権限を含む、完全な権限が付与されます。
mms.saml.global.role.automationAdmin型: string
SAML グループ ノード属性内のグループ。このグループのノードには
Global Automation Adminロールが付与されます。
mms.saml.global.role.backupAdmin型: string
SAML グループ ノード属性内のグループ。このグループのノードには
Global Backup Adminロールが付与されます。
mms.saml.global.role.monitoringAdmin型: string
SAML グループ ノード属性内のグループ。このグループのノードには
Global Monitoring Adminロールが付与されます。
mms.saml.global.role.userAdmin型: string
SAML グループ ノード属性内のグループ。このグループのノードには
Global User Adminロールが付与されます。
mms.saml.global.role.readOnly型: string
SAML グループ ノード属性内のグループ。このグループのノードには
Global Read Onlyロールが付与されます。
OIDC による認証
MongoDB Ops Manager を構成して、外部 IdP を介したユーザー認証に OIDC を使用できます。完全な設定手順については、OIDC 認証のための MongoDB Ops Manager ユーザーの構成。 を参照してください。
mms.oidc.customCaCertificate型: string
MongoDB Ops Manager がユーザーの IdP に接続する際に信頼する必要がある PEM エンコードされた認証機関の証明書または証明書のセット。IdP が自己署名またはプライベートな証明書の認証機関を使用している場合は、この設定を使用します。複数の証明書を連結できます。
mms.oidc.pkce.enabledタイプ: ブール値
デフォルト: true
承認コード フローでの PKCE を有効化します。MongoDB Ops Manager は、デフォルトでこの設定を有効にします。この設定は、お使いの IdP が機密クライアント向けの PKCE をサポートしていない場合にのみ無効にしてください。
mms.oidc.sp.baseUrl型: string
OIDC サービス プロバイダーのベース URLこの値を設定しない場合、MongoDB Ops Manager は
mms.centralUrlを使用します。MongoDB Ops Managerにアクセスするために別のURLが必要な場合は、この設定を使用します。
mms.oidc.global.role.owner型: string
IdP グループのノードに
Global Ownerロールが割り当てられているカンマ区切りリスト。グローバル オーナーには、すべての管理権限を含む、この配置に対する完全な権限が付与されます。
mms.oidc.global.role.automationAdmin型: string
IdP グループのノードに
Global Automation Adminロールが割り当てられているカンマ区切りリスト。
mms.oidc.global.role.backupAdmin型: string
IdP グループのノードに
Global Backup Adminロールが割り当てられているカンマ区切りリスト。
mms.oidc.global.role.monitoringAdmin型: string
IdP グループのノードに
Global Monitoring Adminロールが割り当てられているカンマ区切りリスト。
mms.oidc.global.role.userAdmin型: string
IdP グループのノードに
Global User Adminロールが割り当てられているカンマ区切りリスト。
mms.oidc.global.role.readOnly型: string
IdP グループのノードに
Global Read Onlyロールが割り当てられているカンマ区切りリスト。
多要素認証(MFA)
mms.multiFactorAuth.level型: string
デフォルト: オフ
2 要素認証の「レベル」を設定します。
設定説明OFF2要素認証を無効にします。MongoDB Ops Manager は 2 要素認証を使用しません。
OPTIONALユーザーは、MongoDB Ops Managerアカウントに 2 要素認証を設定することを選択できます。
REQUIRED_FOR_GLOBAL_ROLESグローバル ロールを持つユーザーは、2 要素認証を設定する必要があります。2 要素認証は、他のすべてのユーザーにとっては任意です。
REQUIREDすべてのユーザーは、MongoDB Ops Manager アカウントに 2 要素認証を設定する必要があります。
MongoDB Ops Manager の配置のセキュリティのために、2 要素認証を推奨します。
警告
構成ファイルを通じて
mms.multiFactorAuth.levelを有効にする場合は、構成ファイルを更新する前にまずユーザー アカウントを作成する必要があります。そうしないと、MongoDB Ops Manager にログインできません。注意
Twilio 統合を有効にする場合 (任意)、MongoDB Ops Manager サーバーが
twilio.comドメインにアクセスできることを確認します。
mms.multiFactorAuth.allowResetタイプ: ブール値
デフォルト: False
trueの場合、MongoDB Ops Manager では、パスワードをリセットするのと同様の方法で、ユーザーがメールを介して 2 要素認証設定をリセットできます。2 要素認証をリセットするには、ユーザーは以下を行う必要があります。
ユーザーアカウントに関連付けられたアドレスでメールを受信できるようになります。
ユーザーアカウントのパスワードが分かっています。
APIユーザーが属する各MongoDB Ops Manager プロジェクトの エージェント キー を知っている。
mms.multiFactorAuth.issuer型: string
Google Authenticator が 2 要素認証を提供する場合、この文字列は Google Authenticator アプリの
issuerになります。空白のままにした場合、issuerは MongoDB Ops Manager インストールのドメイン名になります。
mms.multiFactorAuth.requireタイプ: ブール値
デフォルト: False
trueの場合、MongoDB Ops Manager は、ユーザーがログインしたり、アプリケーション内で特定の破壊的な操作を実行したりするために 2 要素認証を要求します。Twilio 統合を構成すると、ユーザーは Google Authenticator、SMS、または音声通話を介して 2 要素トークンを取得できます。それ以外の場合、2 要素認証を提供する唯一のメカニズムは Google Authenticator です。
reCaptcha とセッションの長さ
reCaptcha.enabled.registrationタイプ: ブール値
デフォルト: false
新しいユーザーが MongoDB Ops Manager の使用を登録するときに、reCaptcha 検証を使用して自分自身を検証することを望んでいることを示すインジケーター。
true新規ユーザーの登録時に reCaptcha の検証を要求するには、 を に設定します。この設定には reCaptcha アカウントが必要です。
reCaptcha.enabledタイプ: ブール値
デフォルト: false
ユーザーが MongoDB Ops Manager にログインするときに、reCaptcha 検証を使用して自分自身を検証する必要があることを示すインジケーター。
trueユーザーがログインするときに reCaptcha 検証を要求するには、 を に設定します。この設定には reCaptcha アカウントが必要です。
ReCaptcha Enabledに対応します。
mms.session.maxHoursタイプ: 数値
MongoDB Ops Manager ウェブサイトのセッションが期限切れになるまでの時間数。
注意
Session Max Hours アイドル時間だけでなく、MongoDB Ops Manager セッションの合計時間を反映します。Session Max Hours が経過すると、アクティブなセッションとアイドルなセッションの両方が期限切れになります。
ブラウザーのセッション クッキーのみを使用するには、この値を
0に設定します。
Web Server
mms.centralUrl型: string
Ops Manager Application の FQDN とポート番号。
8080以外のポートを使用するには、「Ops Manager のホスト名とポートの管理」を参照してください。mms.centralUrl=http://mms.example.com:8080URL to Access Ops Managerに対応します。重要
MongoDB Ops Manager アプリケーションに IPv6 アドレスを使用してアクセスする場合は、ポート番号と区別するために IPv6 アドレスを角括弧(
[ ])で囲む必要があります。以下に例を挙げます。
http://[2600:1f16:777:8700:93c2:b99c:a875:2b10]:8080
mms.https.PEMKeyFile型: string
Ops Manager Application の有効な証明書と秘密キーが含まれる PEM ファイルへの絶対パス。MongoDB Ops Manager アプリケーションが HTTPS を使用して、 MongoDB Ops Manager アプリケーション、エージェント、およびウェブ インターフェイス間の接続を暗号化する場合は、PEM ファイルが必要です。
MongoDB Ops Manager アプリケーションへの HTTPS アクセスのデフォルト ポートは、
<install_dir>/conf/mms.confファイルで設定されている8443です。このデフォルトを変更する場合は、mms.centralUrl設定で指定されているポートも変更する必要があります。
mms.https.PEMKeyFilePassword型: string
Password for the HTTPS PEM key file. You must include this setting if the PEM key file contains an encrypted private key.
mms.https.ClientCertificateMode型: string
MongoDB Ops Manager がクライアントに接続するときに、有効な TLS クライアント証明書を提示することを要求するかどうかを指定します。指定できる値は以下のとおりです。
noneagents_onlyrequired
これらの値では、大文字と小文字が区別されます。
mms.https.CAFile型: string
次の場合に必須:
プライベート証明機関を使用しています。
mms.https.ClientCertificateModeをagents_onlyまたはrequiredに設定します。TLS を有効にして MongoDB Ops Manager をハイブリッド モードで実行します。
受け入れ可能なクライアント証明書のリストを含むプライベート認証局ファイルのファイルシステムの場所を指定します。Ops Manager Application は、このファイルに記述された証明書を持つクライアントからの HTTPS リクエストを認証します。
mms.https.CAFile=/path/to/ca_file.pem
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
デフォルト: 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 に転送クライアントがホスト HTTP リクエスト ヘッダーで要求した元のホスト。
HTTP リクエストの実行に使用されるプロトコル。
プロキシ サーバーのホスト名。
リクエストの HTTPS ステータス。
詳細については、「高可用性 Ops Manager アプリケーションの構成」を参照してください。
mms.minimumTLSVersion型: string
デフォルト:
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.TLSVersionValue
<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 で使用されるサイファースイート名は、RFC 5246 の命名規約を尊守する必要があります。OpenSSL 命名規約は使用してはいけません。便利上、Ops Manager (オプスマネージャー) はスタートアップ時に、サポートされているすべてのサイファースイート名のリストをログに記録します。MongoDB Ops Manager が TLS サイファー スイート名を認識できない場合、次の警告がログに記録されます。
設定には、JDK が認識しないため無効にすべき暗号として以下が記載されています。エントリーのフォーマットと有効な暗号のリストを確認します。[unrecognized_cipher_name]
mms.disableCiphersを変更するには、次の値を使用してカスタム設定の変更手順に従います。Key
mms.disableCiphersValue
<ciphers>以下に例を挙げます。
TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA, TLS_DHE_RSA_WITH_AES_256_CBC_SHA256警告
mms.disableCiphersをカスタム値に設定すると、これらが無効にした暗号の 1 つ以上が再度有効になる可能性があります。