AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

既存のMongoDBプロセスをMongoDB Ops Managerに追加する

MongoDB Ops Managerは、既存のMongoDB配置を監視と管理に追加するためのウィザードを提供します。 ウィザードは を操作するプロンプトを表示します。

Considerations

一意の名前

配置にはプロジェクト内で一意の名前が必要です。

重要

同じプロジェクト内のレプリカセット、シャーディングされたクラスター、およびシャード名は一意である必要があります。 配置名を一意のものにしないと、バックアップ スナップショットが中断されます。

MongoDB 構成オプション

オートメーションはすべての MongoDB オプションをサポートしていないため、インポートが失敗する可能性があります。 詳しくは、「 MongoDB 設定とオートメーション サポート 」を参照してください。

TLS

TLS を有効にする場合、MongoDB プロセスを提供するホストの FQDN は、そのホスト上の TLS 証明書の SAN と一致する必要があります。

重要

中間者攻撃を防ぐため、TLS証明書のスコープは可能な限り狭くしてください。1つの TLS 証明書を多くの SAN で使用したり、各ホストでワイルドカード TLS 証明書を使用したりすることは可能ですが、推奨されません。詳細を学ぶには、RFC 2818、セクション 3.1。を参照してください。

ご希望のホスト名

次の場合は、優先ホスト名を設定します。

  • MongoDB プロセスにアクセスするために、特定のホスト名、FQDN、IPv4 アドレス、または IPv6 アドレスを要求します。

  • 複数のエイリアスを持つホストに使用するホスト名を指定する必要があります。

詳しくは、プロジェクト設定のPreferred Hostnames設定を参照してください。

以前に削除されたホストの復元

MongoDB Ops Manager からホストを完全に削除せず、そのホストを復元する場合は、削除されたMongoDBプロセスを再インポートできます。

Ops Manager からホストを完全に削除した場合は、再インポートする前にそのホストを復元してください。削除されたホストを検索するには、Global Owner ロールが必要です。

削除されたホストを見つけて復元するには、次の手順に従います。

  1. Deploymentビューに移動します。

  2. Moreメニューから [ Deleted Hosts ] をクリックします。

  3. ホストを復元するには、 を選択します。

ホストを復元した後、既存のプロセス手順をインポートできます。

注意

ホストが Deleted Hosts リストに表示されない場合は、すぐにプロセスを再インポートできます。

Windows MongoDB Services の管理

Windows サービスとして実行される既存の MongoDB プロセスをオートメーションに追加する場合、オートメーションは次のようになります。

  • 既存のサービスを停止して無効にします

  • 新しいサービスを作成して開始します

ソースクラスターと宛先クラスターの認証情報

MongoDB Ops Manager プロジェクトで、その配置に対して MongoDB 認証設定が有効になっている場合、インポートする MongoDB 配置はプロジェクトの認証メカニズムをサポートしている必要があります。

実行中のプロセスがなく、認証が有効になっていない新しい宛先プロジェクトにインポートすることをお勧めします。

ソースクラスターが認証を使用しており、宛先のMongoDB Ops Managerプロジェクトに既存の管理されているプロセスがない場合、 MongoDB Ops Managerは宛先プロジェクトで認証を有効にし、ソースクラスターから既存のキーファイルをインポートし、そのキーファイルを使用してユーザーを認証します。は、インポート プロセスを実行します。

ソースクラスターと宛先のMongoDB Ops Managerプロジェクトの両方が認証を使用し、プロジェクトに プロセスがある場合、 MongoDB Ops Managerはインポート プロセス中に宛先プロジェクトの既存の認証設定を使用しようとします。 インポート プロセスを成功させるには、ソースクラスターと MongoDB Ops Manager 宛先プロジェクトの認証情報が同じである必要があります。

インポートが成功することを確認するには、インポートプロセスを開始する前に、ソースクラスターにMongoDB Ops Manager宛先プロジェクトの認証情報を追加します。 詳しくは、「レプリカセットのキーのローテーション 」または「 シャーディングされたクラスターのキーのローテーション 」を参照してください。

認証のユースケース

MongoDB 配置で認証が必要な場合は、監視用に MongoDB Ops Manager に配置を追加するときに、必要な認証情報を提供する必要があります。

  • 配置でオートメーションを使用せずに、バックアップ、モニタリング、またはその両方が使用されていた場合は、MongoDB Agent に更新する前に認証情報が であった、それらの認証情報を見つけることができます。

  • 配置でオートメーションを使用せず、バックアップとモニタリングのいずれかを使用する場合、次のようにします。

    1. MongoDB 配置の認証情報を作成します。 詳細については、「モニタリング用の MongoDB Agent に必要なアクセス権 」および「 バックアップ用の MongoDB Agent に必要なアクセス権 」を参照してください。

    2. MongoDB Ops Managerプロセスを追加した後、それらの関数に付与した認証情報をMongoDB に追加します。詳細については、「モニタリング用の認証情報の追加 」および「 バックアップ用の認証情報の追加 」を参照してください。

  • 配置でオートメーションを使用する場合、 MongoDB Ops ManagerはMongoDB Agentからの認証情報を使用します。 レガシーバックアップとモニタリング エージェントから認証情報を削除できます。 MongoDB Agent は、オートメーション、バックアップ、モニタリング機能にこれらの認証情報を使用します。

  • 配置でオートメーションが使用されるが、インポートする前にオートメーションが使用されなかった場合は、インポートしたデータベース プロセスに mms-automation ユーザーを追加し、ユーザーの認証情報をMongoDB Ops Managerに追加します。

詳細については、「オートメーション用の認証情報の追加 」を参照してください。

インポート時のオートメーションと更新されたセキュリティ設定

MongoDB配置をオートメーションに追加すると、 MongoDB Ops ManagerプロジェクトとMongoDB配置のセキュリティ設定に影響する可能性があります。

  • オートメーションにより、 プロジェクト セキュリティ設定 が有効になります。 MongoDB配置に認証が必要であるが、 MongoDB Ops Managerプロジェクトで認証設定が有効になっていない場合、 MongoDB配置をオートメーションに追加すると、 MongoDB Ops Managerはプロジェクトのセキュリティ設定を、新しくインポートされた配置のセキュリティ設定に更新します。

    インポート プロセスでは、 MongoDB Ops Managerプロジェクトのセキュリティ設定が現在無効になっている場合にのみ更新されます。 インポートプロセスによって、プロジェクトのセキュリティ設定が無効になったり、有効な認証メカニズムが変更されたりすることはありません。

  • オートメーションは MongoDB ユーザーとロール をインポートします。 次のステートメントは、 MongoDB配置に認証が必要な場合、またはMongoDB Ops Managerプロジェクトで認証設定が有効になっている状況に適用されます。

    MongoDB配置にユーザーまたはユーザー定義のロールが含まれている場合は、 MongoDB Ops Managerがこれらのユーザーとロールをインポートして管理することを選択できます。 インポートされたユーザーとロールは、 MongoDB Ops Managerプロジェクト内のすべての管理対象配置に対して Synced です。

    • プロジェクトのEnforce Consistent Set 値をYes に設定すると、 は、インポートされてMongoDB Ops Manager MongoDBいない ユーザーとロールを 配置から削除します。

    • プロジェクトの Enforce Consistent Set 値を No に設定すると、 MongoDB Ops Managerはプロジェクトにインポートされていないユーザーとロールの管理を停止します。 これらのユーザーとロールは MongoDB 配置に残ります。 これらのユーザーとロールを管理するには、MongoDB 配置に直接接続する必要があります。

    MongoDB Ops Manager プロジェクトで特定のユーザーとロールを管理しないでください。変更を確認して配置する前に、 Authentication & UsersページとAuthentication & Rolesページを使用してインポート中にこれらのユーザーとロールを削除してください。 詳細については、「 MongoDB ユーザーの管理または非管理 」を参照してください。

    インポートされたMongoDB配置で、admin データベースにすでに mms-backup-agent ユーザーと mms-monitoring-agent ユーザーがすでにある場合、インポート プロセスはこれらのユーザーのロールを、 MongoDB Ops Managerプロジェクトで設定されている mms-backup-agent ユーザーと mms-monitoring-agent ユーザーのロールで上書きします。 。

  • オートメーションは、 プロジェクト 内のすべての配置に適用されます。 プロジェクトによって管理されるすべてのユーザーとロールを含む、プロジェクトの更新されたセキュリティ設定は、インポートされた 配置を含むプロジェクト内のMongoDB Ops Manager すべてのMongoDB 配置に適用されます。

    MongoDB Ops Managerが、インポートされたMongoDB配置を含む、プロジェクト内のすべての配置を新しい設定で再起動します。 インポート後は、プロジェクト内のすべての配置で再起動時にMongoDB Ops Managerの自動化キーファイルが使用されます。

    インポートする配置では、宛先プロジェクトの既存のプロセスと同じキーファイルを使用する必要があります。そうしないと、インポート プロセスが続行されない可能性があります。 詳細については、 「ソースクラスターと宛先クラスターの認証情報」 を参照してください。

    プロジェクト内の既存の配置でインポートされたプロセスとは異なるセキュリティ プロファイルが必要な場合は、ソース MongoDB 配置をインポートできる新しいプロジェクトを作成します。

インポートされたユーザーの例

次の例は、 MongoDB配置で認証が必要な場合、またはMongoDB Ops Managerプロジェクトで認証設定が有効になっている状況に適用されます。

MongoDBユーザーとカスタムロールをインポートした場合、 MongoDB Ops ManagerプロジェクトがMongoDB配置の管理を開始すると、Enforce Consistent Set の値に関係なく、次の状況が発生します。

  • MongoDB Ops Managerプロジェクトは、認証を有効にし、インポートされたユーザーとロールを管理し、新しいユーザーとロールをすべての管理対象配置に同期します。

  • MongoDB 配置のアクセス制御が有効になっており、認証が必要です。 MongoDB配置には、 MongoDB Ops Managerプロジェクトが管理するすべてのユーザーとロールがあります。 これらのユーザーとロールでは、Synced Yesは に設定されています。

MongoDBユーザーとカスタムロールをインポートしない場合、 MongoDB Ops ManagerプロジェクトがMongoDB配置の管理を開始すると、次の状況が発生します。

Enforce Consistent SetがYesに設定されている場合 :

  • MongoDB Ops Managerプロジェクトでは認証が有効になっており、管理されているユーザーとロールは変更されません。

  • MongoDB 配置のアクセス制御が有効になっており、認証が必要です。

  • MongoDB Ops Manager は、インポートされていない MongoDB ユーザーとロールを配置から削除します。

  • MongoDB配置には、 MongoDB Ops Managerプロジェクトが管理するすべてのユーザーとロールがあります。 これらのユーザーとロールでは、Synced Yesは に設定されています。

Enforce Consistent SetがNoに設定されている場合 :

  • MongoDB Ops Managerプロジェクトでは認証が有効になっており、ユーザーやロールなどのセキュリティ設定は変更されません。

  • MongoDB 配置のアクセス制御が有効になっており、認証が必要です。

  • インポートされていない MongoDB ユーザーとロールは、MongoDB 配置に残ります。

  • MongoDB配置には、 MongoDB Ops Managerプロジェクトによって管理されるすべてのユーザーとロールが含まれます。 これらのユーザーとロールでは、Synced Yesは に設定されています。

前提条件

  • 配置でmongodがサービスとして有効になっている場合、オートメーションではなく、再起動時にsystemd がmongodを起動する競合状態が発生する可能性があります。この問題を防ぐには、配置をオートメーションに追加する前に、mongodサービスが無効になっていることを確認します。

    1. mongodサービスが有効になっているかどうかを確認します。

      sudo systemctl is-enabled mongod.service

    2. サービスが有効になっている場合は、無効にします。

      sudo systemctl disable mongod.service

  • MongoDB Ops Managerプロジェクトで認証設定が有効になっていないが、MongoDB プロセスで認証が必要な場合は、適切なロールを持つMongoDB Agent MongoDB Ops Managerプロジェクトの ユーザーを追加します。インポート プロセスに、ユーザーに必要なロールが表示されます。 追加されたユーザーは、プロジェクトの MongoDB Agent ユーザーになります。

  • MongoDB Ops Managerプロジェクトで認証設定が有効になっている場合は、 MongoDB Ops ManagerプロジェクトのMongoDB AgentユーザーをMongoDBプロセスに追加します。

    • MongoDB Agent ユーザーを検索するには、 Deploymentsをクリックし、次にSecurityをクリックし、次にUsersをクリックします。

    • MongoDB Ops Manager プロジェクトの MongoDB Agent ユーザーのパスワードを見つけるには、次のいずれかの方法を使用します。

      「 MongoDB プロセスの追加 」手順の手順に従って、UI でウィザードを起動します。 Do you want to add automation to this deployment?と表示されるモーダルに到達したら以下の操作を行います。

      1. Add Automation and Configure Authentication を選択します。

      2. [Show Password] をクリックします。

    • mongosh では、db.createUser() メソッドを使用してMongoDB Ops ManagerプロジェクトのMongoDB Agent ユーザーをMongoDBプロセスに追加します。例、 MongoDB Ops Managerプロジェクトが ユーザー名/パスワード認証を使用する場合は、次のコマンドを実行して、インポートするMongoDBデプロイの adminデータベースに mms-automation ユーザーを追加します。

      db.getSiblingDB("admin").createUser(  {    user: "mms-automation",    pwd: "<password>",    roles: [      'clusterAdmin',      'dbAdminAnyDatabase',      'readWriteAnyDatabase',      'userAdminAnyDatabase',      'restore',      'backup',      'directShardOperations'  // Required for sharded clusters    ]  })

      シャーディングされたクラスターのオートメーションには directShardOperations ロールを指定する必要があります。このロールにより、オートメーションエージェントは、既存のクラスターへのシャードの追加など、シャードへの直接アクセスを必要とするメンテナンス操作を実行できます。シャーディングされていない配置（スタンドアロンまたはレプリカセット）では、このロールを省略できます。

  • MongoDB Ops Managerの下にクラスターを追加すると、 MongoDB Ops Managerは自動的に ログローテーションを有効にします。これにより、mongod または mongos ログの既存の logRotate 構成と競合する可能性があります。 この衝突を防ぐには、次の操作を行います。

  • インポートプロセスでは、ソースクラスターと宛先クラスターで認証情報とキーファイルが同じである必要があります。 詳細については、 「ソースクラスターと宛先クラスターの認証情報」 を参照してください。

  • プライマリ・セカンダリ・アービタ（PSA）レプリカセットをインポートする場合、インポートするレプリカセットのキーファイルの内容は、Ops Managerが移行先のプロジェクトでマネージドしているキーファイルと一致している必要があります。そうでない場合、認証エラーが発生し、アービタノードのインポートプロセスは失敗します。

    この問題を回避するには、レプリカセットをインポートする前にアービタを除き、インポートが完了した後にアービタを再度追加します。

  • 既存の レプリカセット をMongoDB Ops Managerに正常にインポートするには、 インスタンスが正常である必要があります。

重要

シャーディングされたクラスターを追加する場合は、 を使用して、すべてのシャードでこのユーザーを作成する必要があります。mongosつまり、mongosを使用してクラスター全体のユーザーとして、および各シャードのシャードローカルユーザーとして、両方のユーザーを作成します。

手順

MongoDB プロセスの追加

既存のMongoDBプロセスをMongoDB Ops Managerに追加するには、次の手順に従います。

1
プロジェクトの Deployment ページに移動します。

  1. まだ表示されていない場合は、目的のプロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。

  2. まだ表示されていない場合は、ナビゲーション バーの Projects メニューから目的のプロジェクトを選択します。

  3. まだ表示されていない場合は、サイドバーの [Deployment] をクリックします。

2
[Add をクリックし、Existing MongoDB Deployment を選択します。
3
配置を追加するには、プロンプトに従ってください。

配置への認証資格情報の追加

配置をインポートしたプロジェクトで認証が有効になっている場合は、既存のMongoDBプロセスをMongoDB Ops Managerに追加した後、新しい配置の認証情報を追加する必要があります。 新しい配置にオートメーション、モニタリング、またはバックアップの認証情報を追加する必要がある状況については、「認証のユースケース」を参照してください。

Atlas にライブ移行する配置を追加する場合は、モニタリングのみに配置（およびその認証情報）を追加する必要があります。

使用する認証メカニズムを選択します。

オートメーションの認証情報の追加

オートメーションを使用するが、 MongoDB Ops Managerにインポートする前には使用していなかった配置の認証情報を追加するには、次の手順に従います。

1
MongoDB Agent ユーザーをデータベースに追加します。

MongoDB Agent ユーザーは、MongoDB データベースの自動化タスクを実行します。 この MongoDB ユーザーに適切な特権があることを確認します。

2
Security Settings ダイアログに移動します。

  1. まだ表示されていない場合は、目的のプロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。

  2. まだ表示されていない場合は、ナビゲーション バーの Projects メニューから目的のプロジェクトを選択します。

  3. まだ表示されていない場合は、サイドバーの [Deployment] をクリックします。

  1. [Security] タブをクリックします。

  2. [Settings] タブをクリックします。

  3. 次のいずれかのアクションを実行します。

    • このプロジェクトで初めて TLS 、認証、または承認設定を構成する場合は、[ Get Started] をクリックします。

    • このプロジェクトの TLS 認証または承認設定をすでに構成している場合は、[Edit] をクリックします。

3
[Edit Credentials] をクリックします。
4
Configure Ops Manager Agentsページが表示されるまで、[] モーダルを処理します。
5
適切な認証情報を追加します。
設定
値

MongoDB Agent Username

MongoDB Agent のユーザー名を入力します。

MongoDB Agent Password

MongoDB Agent ユーザー名 のパスワードを入力します。

モニタリングの認証情報の追加

オートメーションを使用せず、モニタリングを使用する配置の認証情報を追加するには、次の手順に従います。

1
Monitoring Settings ダイアログに移動します。

  1. まだ表示されていない場合は、目的のプロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。

  2. まだ表示されていない場合は、ナビゲーション バーの Projects メニューから目的のプロジェクトを選択します。

  3. まだ表示されていない場合は、サイドバーの [Deployment] をクリックします。

  1. をクリックしますをクリックし、モニタリング設定を表示する配置の横にある [ Monitoring Settings ] をクリックします。
2
[Credentials] をクリックします。
3
適切な認証情報を追加します。
設定
値

Monitoring Username

監視ユーザー名を入力します。

Monitoring Password

監視ユーザー名用のパスワードを入力します。

バックアップの認証情報の追加

オートメーションを使用せず、バックアップを使用する配置の認証情報を追加するには、次の手順に従います。

1
プロジェクトの Continuous Backup ページに移動します。

  1. まだ表示されていない場合は、目的のプロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。

  2. まだ表示されていない場合は、ナビゲーション バーの Project メニューから目的のプロジェクトを選択します。

  3. サイドバーの Continuous Backup をクリックします。

2
配置で をクリックし、Edit Credentials をクリックします。
3
適切な認証情報を追加します。
設定
値

Backup Username

バックアップ ユーザー名を入力します。

Backup Password

バックアップ ユーザー名のパスワードを入力します。

戻る
MongoDBエージェントの使用
次へ
モニター対象プロセスを追加する
このページを評価

項目一覧