MongoDB 6.0.17+ または 7.0.13+ のライブ移行(プッシュ) Cloud Manager によって監視されるクラスターから Atlas へ

Atlas で、Organization Settings ページに移動します。

1. まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーション バーのOrganizationsメニュー

2. [Organizations] メニューの横にある [Organization Settings] アイコンをクリックします。

   [ Organization Settings ]ページが表示されます。

Live Migration to Atlas ページに移動します。

サイドバーの Live Migration をクリックします。

[ Atlas へのライブ移行 ]ページが表示されます。

移行プロセスを開始します。

1. [Migrate from Ops Manager or Cloud Manager] をクリックします。

   注意

   UI ラベルにはMongoDB Ops Manager が記載されていますが、この手順では、AtlasMongoDB 6.0.17が監視するCloud Manager 配置 以降に移行できるのみです。

2. [I'm Ready to Start] をクリックします。

Atlas には、プロセスの進め方を示すライブ移行ウィザードが表示されます。 このプロセスは、ソースクラスターのデータを新しい宛先クラスターにプッシュします。 ウィザードの手順を完了したら、お使いのアプリケーションが新しいクラスターに向くよう設定できます。

Atlas とのリンク。

1. [ Generate Link-Tokenをクリックします。 Atlasにトークンリンクを生成するためのページが表示されます。

2. 生成されたトークンリンクを含むページを表示するには、 Nextをクリックします。

3. トークンリンクをコピーし、安全な場所に保存します。 Atlas はトークンリンクの内容を表示しません。 また、Atlas はトークンリンクを生成した後、そのトークンを表示しません。 公開共有しないでください。

   注意

   1 つの Cloud Manager 組織内のすべてのプロジェクトを Atlas にライブ移行するには、1 つの固有のトークンリンクを使用します。

4. [Done] をクリックします。

トークンリンクを Cloud Manager に貼り付けます。

1. Cloud Manager で組織にアクセスします。

   Cloud Manager を開き、Atlas にライブ移行するプロジェクトのクラスターが属する組織に移動します。

2. 左側のナビゲーションパネルで [Settings] をクリックします。

3. Live Migration: Connect to Atlasセクションで、 Connect to Atlasをクリックします。 Connect to Atlasダイアログ ボックスが開きます。

4. ライブ移行ウィザードの前のステップで生成したトークンリンクを貼り付け、 Connect to Atlasをクリックします。 Cloud Manager は Atlas への接続を確立します。 必要に応じて、 Refreshボタンを使用して更新内容を Atlas に送信します。

宛先 Atlas クラスターを作成します。

まだ作成していない場合は、Atlas で宛先クラスターを作成します。 「必要なアクセス権」 を参照してください。

宛先クラスターから移行を開始します。

1. [Select Target Cluster from Projects] をクリックします。

2. GoAtlas宛先の クラスターのプロジェクトに し、宛先クラスターを見つけます。

3. をクリックします移行を開始するには、ドロップダウン リストから [ Migrate Data to this Clusterを選択します。 Migrate Data to This Clusterページが開きます。

4. [Migrate from Ops Manager or Cloud Manager] をクリックします。

   注意

   UI ラベルにはMongoDB Ops Manager が記載されていますが、この手順では、AtlasMongoDB 6.0.17が監視するCloud Manager 配置 以降に移行できるのみです。

   次のように フィールドに入力します。

   • Cloud Manager でソース プロジェクトを選択します（まだ選択していない場合）。

   • ドロップダウンからソースクラスターを選択します。

   • レプリカセットをシャーディングされたクラスターに移行する場合、次の手順に従います。

     • コレクションをシャーディングする場合は、 Include sharding parametersのチェックマークをクリックし、シャーディングの例を使用してシャーディング構成 JSON を テキストボックスに貼り付けます。 後で参照したい場合に備えて、この構成を外部の ファイルに保存します。

       シャーディング構成 JSON は、シャーディングするコレクションとシャーディングに使用するキーを指定するshardingEntries配列を定義します。 MongoDB は、この配列に含めたコレクションのみをシャーディングします。 詳細については、「シャーディング 」を参照してください。

       シャーディング構成の指定を省略する場合は、クラスターを Atlas に移行した後に、宛先クラスターでコレクションをシャードできます。

     • シャーディング構成に加えて、指定されたシャーディングキーの互換性のあるインデックスがサービス内の宛先クラスターに存在する必要があります。

       Create supporting indexesのチェックマークをクリックすると、MongoDB が Atlas の宛先クラスターにサポートするシャードキー インデックスを自動的に作成するようになります。

   • 移行を処理するための移行ホストを選択します。

   • プライベートエンドポイントを使用していない場合は、IP アドレス アクセス リストを確認し、移行ホストの外部 IP アドレスがこのリストに含まれていることを確認します。 追加されていない場合は、ここで追加します。

     • クリック Set Network Access for Host

     • クリック + Add IP Address

     • ライブ移行ウィザードに戻ります。 ドロップダウンからソースクラスタを選択し、 の下でMigrate data to this clusterを選択します。 。

   • ドロップダウンからソースクラスターを選択します。

   • ソースクラスターが認証を強制する場合は、表示されたテキストボックスにユーザー名とパスワードを入力します。

     Atlas ライブ移行に必要なユーザー権限に関するガイダンスについては、 「移行元のクラスターのセキュリティ」 を参照してください。

   • Cloud Manager でソースクラスターのオートメーションを一時停止しても、モニタリングエージェントでソースクラスターを引き続き監視すると、 UsernameとPasswordが表示されます。 配置でユーザー認証が必要な場合は、これらのフィールドにユーザー名とパスワードを指定します。 認証情報を提供するデータベースユーザーは、管理データベースにおいて少なくともバックアップ ロールを持ち、 SCRAM-SHA- 1と SCRAM-SHA- 256の両方を使用して認証する必要があります。

   • ソースクラスターがTLS / SSLを使用する場合は、 Is encryption in transit enabled?ボタンを切り替えます。

   • ソースクラスターがTLS / SSLをカスタム ルート認証局（CA）で使用する場合は、移行ホストからCAファイルへのパスをコピーし、表示されたテキストボックスにこのパスを貼り付けます。 移行ホストが証明書を読み取れるようにするには、 ファイルが移行ホスト上に存在する必要があります。 Atlas は、証明書が存在し、読み取り可能であることを確認します。

   • 宛先クラスターに保持したいデータがある場合は、 Clear any existing data on your destination clusterオプションはオフのままにします。 ライブ移行サービスは検証中にドキュメントのサンプルをチェックし、重複する名前空間が見つかった場合は警告を発します。 既存のデータを削除する場合は、このオプションをオンにして、宛先クラスターの名前を入力します。

   • クラスターに接続するための接続を選択します。 Standard connectionは UI に常に使用可能なものとして表示されます。 ただし、他の接続オプションは、以前にクラスターの VPC ピアリング接続またはプライベートエンドポイントを設定した場合にのみ有効になります。 Atlas が VPC 接続またはプライベートエンドポイントが設定されていないことを検出した場合、これらのオプションはグレー表示されます。

     • VPC ピアリングまたはプライベートエンドポイントを使用していない場合は、 Standard connectionをクリックして、このステップのValidationステージに進みます。

     • 移行ホストと Atlas レプリカセットの間にVPC ピアリング接続を構成した場合、 VPC Peeringオプションは有効になります。 ライブ移行用の VPC ピアリングを使用して接続するには、 VPC Peeringをクリックします。 VPC Peeringオプションがグレー表示されている場合は、この手順を開始する前にVPC ピアリング接続を構成してください。 詳細については、「 VPC ピアリングとプライベートエンドポイントのサポート 」を参照してください。

     • 移行ホストと Atlas クラスターの間にプライベートエンドポイントを構成した場合、 Private Endpointオプションは有効になります。 Private Endpointをクリックしてプライベートエンドポイントに接続し、ドロップダウンから過去に構成されたプライベートエンドポイントを選択します。 AVAILABLE状態のプライベートエンドポイントのみが有効です。 Private Endpointオプションがグレー表示されている場合は、この手順を開始する前にプライベートエンドポイントを構成してください。 詳細については、「 VPC ピアリングとプライベートエンドポイントのサポート 」を参照してください。

       注意

       ソースクラスターと宛先クラスターが MongoDB 6.0.17以降を実行しているプッシュライブ移行の場合、プライベートエンドポイントは単一のクラウドプロバイダーと単一のリージョン内に配置されたクラスターでのみサポートされます。

   • [ Validateをクリックします。 検証プロセスでは、移行ホストがアクセス可能であることを確認し、次の検証チェックを実行して、Atlas へのライブ移行を開始できることを確認します。

     次の検証チェックを利用するには、Cloud Manager の MongoDB Agent を最新バージョンにアップグレードします。 ライブ移行中に次の検証チェックが実行されます。

     • 移行ホストは宛先クラスターに接続できます。

     • ソースクラスターがカスタム ルート認証局（CA）でTLS / SSLを使用する場合、移行ホストはTLS / SSLを使用してソースクラスターにアクセスできます。

     • データベースユーザーの認証情報が有効です。 この検証チェックは、Cloud Manager でソースクラスターのオートメーションを一時停止しているが、モニタリングエージェントでソースクラスターを引き続き監視している場合にのみ実行されます。

     • 移行プロセスでは、圧縮データのストレージ サイズに基づいて、宛先クラスターに十分なディスク領域があることを検証します。 データとストレージ サイズの詳細については、 dbStats を参照してください。

   • 検証に失敗した場合は、移行ホスト、外部 IP アドレスまたはCIDRブロックの有効性、およびトークンリンクを確認します。 また、データベースユーザーの認証情報、 TLS / SSL証明書、宛先クラスターのディスク ストレージ サイズの量も確認します。

   • 検証に成功した場合は、[ Next ] をクリックします。

移行を開始します。

1. ライブ移行プロセスで使用される移行ホスト、プロジェクト、クラスター、移行ホストが記載されているレポートを確認します。

2. [Start the Migration] をクリックします。

   移行プロセスが開始されると、Atlas UI に、宛先 Atlas クラスターの Migrating Data ウォークスルー画面が表示されます。 ウォークスルー画面は、宛先クラスターの移行プロセスが進行すると更新されます。移行プロセスには、次のものが含まれます。

   • ソースクラスター データへの新しい書込みを宛先クラスター データに適用します。

   • ソースクラスターから宛先クラスターへのデータのコピー。

   • 宛先クラスターで移行を終了します。

   移行プロセスの最終フェーズでは、ソースクラスターと宛先クラスター間の現在のラグを表すラグ タイム値が表示されます。

   ラグタイマーが 0 に近く、移行プロセスが追いつくと、Atlas はCutover to your destination clusterボタンをアクティブ化し、ソースクラスターと宛先クラスターが同期していることを示します。 次の手順に進みます。

カットオーバーを実行します。

カットオーバーは、アプリケーションの読み取りと書込みをソースクラスターから宛先クラスターに指示する 3 ステップのプロセスです。

Atlas は、ソースクラスターと宛先クラスターがほぼ同期していることを検出すると、延長可能な120時間（ 5日）のタイマーを開始してライブ移行手順のカットオーバーのステージを開始します。 120時間が経過すると、Atlas はソースクラスターとの同期を停止します。

移行プロセスのこのステージでは、カットオーバーに進むか、同期期間を延長してから、カットオーバーに進むことができます。

• I'm ready to cutoverをクリックすると、Atlas はカットオーバー プロセスを開始します。

• Extend Syncをクリックし、拡張同期が正常に完了すると、Atlas はソースクラスターと宛先クラスターが同期していることを確認します。 カットオーバー プロセスに進みます。 同期時間が経過した場合は、移行を再試行できます。

  移行の有効期限が迫っている場合、Atlas は次の例のようなメールを送信します。

  A migration to your Atlas cluster will expire in <number> hours!
  Navigate to your destination cluster to start the cutover process. If
  you don't take any action within <number> hours, the migration will be
  cancelled and you will need to start again. You can also extend the
  migration process if you need more time.

1. [ I'm ready to cutoverをクリックします。 アプリケーションのダウンタイムを最小限に抑えるために、3 ステップのカットオーバー プロセスを迅速に処理します。

2. [ Proceed to cutoverをクリックします。 3 ステップのカットオーバー プロセスが開始されます。

   1. ソースクラスターへの書き込みを停止します。 [ I confirm that I've stopped writes to my source clusterをクリックします。 続行するにはFinalize migrationをクリックします。

   2. Atlas が移行を完了するまで、数分待ちます。 Atlas は、プロセスを完了するために次のアクションを実行します。

      • MongoDB ライブ移行サーバーのサブネットを宛先クラスターの IP アクセスリストから削除する。

      • ライブ移行で宛先クラスターへのデータのインポートに使用したデータベースユーザーを削除します。

      カットオーバー プロセスが少なくとも12時間進行している場合、Atlas は移行プロセスを確認するか、サポートに連絡することを提案するメールを送信します。

   3. 移行が成功すると、 You have successfully migrated to Atlasページが表示されます。 Atlas には、同期された変更のステータス、アプリケーションのダウンタイム、移行プロセスの期間、コピーされた初期データの量、コピーされたコレクションの数が表示されます。

      • ドキュメント数を比較し、ハッシュを実行中、データが宛先クラスターに転送されていることを確認します。 詳しくは、 「 Cluster-to-Cluster Sync: データ転送の確認 」を参照してください。

      • [ Connect to your new clusterをクリックします。 Atlas は接続方法を選択できるConnect to Atlasページにリダイレクトします。

      • クラスターに接続したら、宛先クラスターへの書込みを再開します。