MongoDB Ops Manager または Cloud Manager によって監視されているレプリカセットをライブ移行(プッシュ)(6.0.17より前のMongoDB)
Atlasは、 Cloud ManagerまたはMongoDB Ops Managerがソース レプリカセット クラスターを監視する場合、移行サービスがこのクラスターをAtlasクラスターにプッシュするライブ移行を容易にします。 Atlas は、アプリケーションが Atlas の宛先クラスターに切り替わるまで、宛先クラスターをソースクラスターと同期させます。
次の手順のカットオ―バーのステップに到達したら、ソースクラスターへの書き込みを停止します。 アプリケーション インスタンスを停止してから、Atlas クラスターを向くように設定し、再起動します。
制限事項
M0
(無料階層)またはM2/M5
共有クラスターをレガシーライブ移行(プッシュ)の宛先ターゲットとして選択することはできません。 (無料階層)または 共有クラスターから有料クラスターにデータを移行するには、「M0
M2/M5
クラスターの変更 」を参照してください。レガシーライブ移行(プッシュ)を使用して、 時系列コレクションを含むソースクラスターを移行することはできません。
BI Connector for Atlas が有効になっている Atlas 宛先クラスターへの、レガシーライブ移行(プッシュ)は使用できません。
Ops Manager を ローカルモードで使用している場合、レガシーライブ移行(プッシュ)を使用して Atlas 宛先クラスターに移行することはできません。
ライブ移行中は、Atlas はホスト アラートを無効にします。
ソースクラスターと宛先クラスターがMongoDB6.0.17 + または7.0.13 + を実行中している場合は、この手順を使用して Atlas にライブ移行できます。
シャーディングされたシャーディングされたクラスターをライブ移行 するには、ソースのシャーディングされたシャーディングされたクラスターを6.0.17 + または7.0.13 + にアップグレードし、その後、このライブ移行手順を使用して Atlas にライブ移行します。
VPC ピアリングとプライベートエンドポイントのサポート
次の表は、Atlas にライブ移行するソース レプリカセット クラスターと宛先レプリカセット クラスターのVPC ピアリングとプライベートエンドポイントの現在のサポート ステータスを示しています。
クラウドプロバイダー | VPC ピアリング | プライベートエンドポイント |
---|---|---|
Azure | ||
Amazon Web Services | ||
Google Cloud |
、 、またはVPCAzure Amazon Web Servicesでライブ移行を使用してGoogle Cloud Platform ピアリングを有効にするには、次の手順に従います。
移行ホストと宛先の Atlas クラスターの間にVPC ピアリング接続を構成します。
Azure 、 Amazon Web Services 、またはGoogle Cloud Platformでライブ移行を使用してプライベートエンドポイントを有効にするには、次の手順に従います。
移行ホストと宛先の Atlas クラスターの間にプライベートエンドポイントを構成します。
注意
プライベートエンドポイントは、単一のクラウドプロバイダーと単一のリージョン内に配置されたレプリカセットのライブ移行でのみサポートされます。 シャーディングされたクラスター、マルチリージョンクラスター、マルチクラウドクラスターは、プライベートエンドポイントを介したライブ移行をサポートしていません。
必要なアクセス権
データをライブ移行するには、Atlas への Organization Owner
アクセス権が必要です。
前提条件
Cloud Managerまたは Ops Manager から Atlas へのレガシーライブ移行を開始する前に、
サポートされている移行パスを使用すると、 MongoDB のソースクラスターから4.2 Atlas のクラスターに移行できますが、この手順を使用する前に、ソースクラスターをMongoDB5.0 以降にアップグレードすることを強くお勧めします。
Atlas 組織を作成し、作成した組織内にプロジェクトを作成します。
このプロジェクトにクラスターを配置します。
アプリケーションを実行するすべてのクライアント サーバーからクラスターに接続します。
MongoDB 4.4以前のバージョンから MongoDB 5.0以降のバージョンを実行する Atlas クラスターに移行する場合は、コレクションからgeoHaystack インデックスをすべて削除します。
ライブ移行プロセス中に、Atlas はdbStatsを使用して MongoDB データベースの統計情報を収集できることを検証します。 クラスターにライブ移行する前に、 でソースクラスターの Atlasプロジェクト 設定 を確認するか、 でソースクラスターのプロジェクト設定を確認して、オプションCloud Manager MongoDB Ops Manager{9Collect Database Specific Statistics が有効になっていることを確認します。このオプションはCloud ManagerまたはMongoDB Ops Managerではデフォルトで有効になっており、移行プロセスが検証に合格するように有効のままにする必要があります。
Cloud ManagerまたはMongoDB Ops Managerのソースクラスターで、次の項目を準備します。
でMongoDB Ops Manager 移行ホスト をプロビジョニングするか、 で 移行ホストCloud Manager をプロビジョニングします。
または IPの管理者から次の外部Cloud ManagerMongoDB Ops Manager アドレスを取得します。
MongoDB Ops Manager から移行する場合、MongoDB Ops Manager インスタンスの外部 IP アドレスまたはCIDRブロック。 Cloud Manager から移行する場合、Atlas はこれらのアドレスを自動的に取得します。
IPまたは 内のプロビジョニングされた移行ホストの外部 アドレスまたは CIDRCloud Manager MongoDB Ops Managerブロック。
ソースクラスターへの接続に使用するユーザー名とパスワード。
ソースクラスターがカスタム ルート認証局でTLS / SSLを使用する場合、ホストが証明書を読み取れるようにするには、ソースクラスターのCAファイルを移行ホストに追加します。
同じクラウドプロバイダーで、宛先クラスターと同じリージョンで、各移行ホストと宛先の Atlas クラスターの間にVPC ピアリング接続またはプライベートエンドポイントを構成することを検討してください。
注意
VPC ピアリングまたはプライベートエンドポイントを使用しない場合、ライブ移行プロセスは、ライブ移行手順の一環として Atlas プロジェクトのIP アクセス リストに追加したパブリック IP アドレスを使用して実行されます。
ライブ移行ワークフロー
このセクションでは、ワークフローの概要を説明します。 詳細な手順については、「 MongoDB Ops ManagerまたはCloud ManagerからAtlasにレプリカセットを移行する手順 」を参照してください。
ライブ移行ワークフローのステージは次のとおりです。
ステージ 1: Atlas とのリンク。 Atlas のアカウント、組織、プロジェクトを作成した後に、Atlas でこのステップを実行します。このプロジェクトに専用クラスターを配置した。と は、そのノードに接続できます。
Atlas で、 Organization Settings ページに移動します。
まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーション バーのOrganizationsメニュー
[Organizations] メニューの横にある [Organization Settings] アイコンをクリックします。
[ Organization Settings ]ページが表示されます。
サイドバーの Live Migration をクリックします。
[ Atlas へのライブ移行 ]ページが表示されます。
Migrate from Ops Manager or Cloud Managerを選択し、ライブ移行ウィザードを開始します。
を使用して から 移行するMongoDB CommunityMongoDB Ops Manager 場合は、MongoDB Ops Manager 移行契約 に同意してください。
から移行する場合は、 MongoDB Ops Managerインスタンスの外部IP アドレスをMongoDB Ops ManagerAtlas アクセス リストに入力します。Cloud Manager から移行する場合は、この手順をスキップします。
ステージ 2: 移行ホスト をプロビジョニングします。
でMongoDB Ops Manager 移行ホスト をプロビジョニングするか、 で 移行ホストCloud Manager をプロビジョニングします。移行ホストは専用のMongoDB Agentを実行し、 Cloud ManagerまたはMongoDB Ops ManagerからAtlasへのライブ移行プロセスを調整します。
注意
以前に または を使用していなかったソースMongoDB 配置を移行する場合は、MongoDB Ops Manager Cloud Manager既存のMongoDB プロセスをMongoDB Ops Manager に追加するか、既存のMongoDB プロセスをCloud Manager に追加します。
または Live Migration: Connect to Atlas組織の ページのCloud Manager MongoDB Ops Manager[0}]Settings セクションで、[2} を選択し、Connect to AtlasAtlas で作成したトークンリンクを貼り付けます。詳細については、「 Atlasのライブ移行の MongoDB Ops ManagerためにAtlas への接続 」または「 のライブ移行のためのCloud Manager Atlas の接続 」を参照してください。
ステージ 3: 移行を開始 します。 Atlas で、ウィザードの手順に従ってライブ移行プロセスを開始します。
移行パスとサポートされているプラットフォーム
Cloud ManagerまたはMongoDB Ops ManagerからAtlasへのライブ移行は、移行ホストをプロビジョニングできるすべてのプラットフォームでサポートされています。 移行ホストをプロビジョニングできるサポート対象のプラットフォームの完全なリストについては、「 Cloud Manager のCloud Manager の前提条件Cloud Manager 」または「MongoDB Ops Manager の前提 MongoDB Ops Manager」を参照してください。
Windows または macOS ベースの配置から Atlas にデータをライブ移行する場合は、サポートされているプラットフォームのいずれかに移行ホストをプロビジョニングする必要があります。
Atlas ライブ移行(プッシュ)は、次の移行パスをサポートしています。
Source Replica Set MongoDB Version | Destination Atlas Replica Set MongoDB Version |
---|---|
4.2 | 6.0 |
4.4 | 6.0 |
5.0 | 6.0 |
MongoDB Ops ManagerまたはCloud Managerからのライブ移行のためのネットワーク アクセス
Cloud ManagerまたはMongoDB Ops Managerのサービス管理者に問い合わせて、次のコンポーネントの外部IPアドレスを取得します。
のソースクラスターの外部IP アドレスMongoDB Ops Manager
MongoDB Ops Manager から移行する場合、Atlas のライブ移行サービスには、ソースクラスター配置の MongoDB Ops Manager インスタンスの外部 IP アドレスまたは外部CIDRブロックが必要です。 このアドレスは、単一のMongoDB Ops Managerインスタンスから、またはソース配置で複数のMongoDB Ops Manager Ops Manager インスタンスが使用されている場合は、 MongoDB Ops ManagerインスタンスがAtlasにアクセスするために使用するゲートウェイからの である可能性があります。
ライブ移行サービスは、トークンリンク の生成時にこの外部 IP アドレスを使用します。 トークンリンク は、string Cloud ManagerまたはMongoDB Ops Manager Atlasの配置から のクラスターへのライブ移行中に、 または から に接続するために必要な情報を含むCloud Manager MongoDB Ops ManagerAtlasです。
またはIP の移行ホストの外部 アドレスMongoDB Ops ManagerCloud Manager
ライブ移行手順を開始する前に、移行ホストの IP アドレスまたはCIDRブロックをプロジェクトのIP アクセス リストに追加します。 Atlas は、プロジェクトのアクセス リストにエントリを持つホストからのみ、宛先クラスターへの接続を許可します。
移行前の検証
ライブ移行手順を開始する前に、Atlas はソースクラスターと宛先クラスターの検証チェックを実行します。
ソースクラスターはレプリカセットである。
ソースクラスターがスタンドアロンの場合は、 でスタンドアロンの ノードを 変換 するか、 MongoDBのスタンドアロンのMongoDB Ops ManagerMongoDBCloud Manager ノードを単一ノードのレプリカセットに 変換Atlas し、このセクションの手順を使用して にライブ移行します。
ソースクラスターを使用すると、 Cloud ManagerまたはMongoDB Ops Managerでプロジェクトのデータベース統計を収集できます。 これにより、Atlas はライブ移行プロセス中に MongoDB データベースの統計情報を収集できます。 オプションCollect Database Specific Statistics が有効になっていることを確認するには、 のソースクラスターのCloud Manager プロジェクト設定 を確認するか、 のソースクラスター のプロジェクト設定MongoDB Ops Manager を確認します。
宛先 Atlas クラスターはレプリカセットであり、BI Connector for Atlas が有効になっていません。
移行ホストのセキュリティ要件
プッシュ タイプのライブ移行の場合、移行ホストをプロビジョニング、保護、実行する必要があります。 移行ホストは、Atlas クラスターとの送信通信のみを暗号化します。
Atlas セキュリティの詳細については、 Atlas セキュリティのホワイトペーパーを参照してください。
インデックス キーの制限
お使いの MongoDB 配置に、インデックス キー制限を超えるキーを持つインデックスが含まれている場合は、ライブ移行を開始する前に、インデックスを変更して、大きすぎるキーが含まれないようにします。
Considerations
ネットワークの暗号化
プッシュライブ移行中に、ソースクラスターが自身のデータに対して TLS 暗号化を使用しない場合、ソースクラスターから移行ホストへのトラフィックは暗号化されませんが、移行ホストから Atlas へのトラフィックは暗号化されます。 これが受け入れられるかどうかを、プッシュ ライブ移行手順を開始する前に判断してください。
データベースユーザーとロール
ソースクラスターが認証を使用しない場合、Atlas でユーザーを作成する必要があります。Atlas では認証無しの実行がサポートされないためです。
Atlas は、いかなるユーザー データーまたはロール データも宛先クラスターに移行しません。
ソースクラスターが認証を強制する場合は、移行する前に、宛先の Atlas クラスターのアプリケーションで使用される適切な認証メカニズムを再作成する必要があります。 次の表は、Atlas での認証メカニズムとその構成方法を示しています。
認証メカニズム | 構成方法 |
---|---|
SCRAM | |
LDAP | |
Amazon Web Services KMS 、 Azure Key Vault、 Google Cloud Platform KMS |
宛先クラスターの構成
宛先クラスターについては、次の点を考慮してください。
Atlas の宛先クラスターは、RAM、CPU、およびストレージの点でソースとなる配置と同じかそれを上回る必要があります。移行プロセスと予想されるワークロードの両方に対応できるように、適切なサイズの宛先クラスターをプロビジョニングするか、宛先クラスターをより処理能力、帯域幅、またはディスク IO のある階層にスケールアップします。
移行のパフォーマンスを最大化するには、宛先クラスターに少なくとも 1 つの M40 クラスターを使用してください。大規模なデータセットを移行する場合は、6000 IOPS 以上のディスクを搭載した M80 クラスターを使用してください。
移行プロセスの実行中に宛先 Atlas クラスターのサイズを一時的に増やすことも選択できます。
アプリケーションのワークロードを Atlas のクラスターに移行したら、コストを最小限に抑えるために宛先クラスターのさらなるパフォーマンス調整とサイズ設定に関するサポートを受けるため、サポートにお問い合わせください 。
予期しないサイズ変更を避けるため、宛先クラスターでオートスケーリングを無効にします。詳細については、「クラスターの管理」を参照してください。
oplog コレクションの無制限の増加を防ぎ、ライブ移行のラグ ウィンドウが oplog レプリケーション ラグ ウィンドウの範囲内に収まるようにするには、ライブ移行プロセスの実行中に十分な固定値の oplog サイズ を設定します。
詳しくは以下を参照してください。
これらの推奨事項に従っていてもパフォーマンスの問題が見られる場合は、サポートにお問い合わせください 。
宛先 Atlas クラスターはレプリカセットである必要があります。
M0
(無料階層)またはM2/M5
共有階層クラスターをライブ移行の宛先ターゲットとして選択することはできません。Atlas ライブ移行の実行中は、
featureCompatibilityVersion
フラグを変更しないでください。
宛先クラスターでワークロードを避ける
宛先クラスターでは、ライブ移行プロセスと重複しない名前空間で実行されうるワークロードを含め、いかなるワークロードも実行しないでください。このアクションにより、ライブ移行プロセス中に発生する可能性のあるロックの競合やパフォーマンスの低下を回避できます。
同じ宛先クラスターに対して、複数の移行を同時に実行しないでください。
ライブ移行プロセスの同期中は、アプリケーションの宛先クラスターへのカットオーバーのプロセスを開始しないでください。
クラウドバックアップを避ける
Atlas は、ライブ移行中に宛先クラスターのオンデマンド クラウドバックアップのスナップショットの取得を停止します。このページに記載されているライブ移行手順のカットオーバーのステップが完了すると、Atlas はバックアップ ポリシーに基づいてクラウドバックアップのスナップショットの取得を再開します。
名前空間の変更を避ける
移行プロセスの実行中は、renameCollection
コマンドの使用や、$out
集計ステージを含む集計パイプラインの実行など、名前空間の変更を行わないでください。
選挙を避ける
ライブ移行プロセスは、ソースクラスターまたは宛先クラスターで一時的にネットワークの中断が発生したり、選挙が行われても、移行が継続されるように最善を尽くします。ただし、これらのイベントによりライブ移行プロセスが失敗する可能性があります。ライブ移行プロセスが自動的に回復しない場合は、最初からやり直してください。
ステージング環境と本番環境
次の手順を 2 回実行することを検討してください。 最初に 、 Perform the Cutoverステップで停止する部分的な移行を実行します。 これにより、最新の Atlas ベースのステージング クラスターが作成され、MongoDB 向けの Atlas クラスターをサポートする最新のドライバー バージョンを使用して、アプリケーションの動作とパフォーマンスをテストできます。
アプリケーションをテストした後、別の Atlas クラスターを使用して完全な移行手順を実行し、Atlas ベースの本番環境を作成します。
MongoDB Community からの移行
を使用して AtlasMongoDB Communityから にMongoDB Ops ManagerMongoDB Ops Manager 移行 する場合は、 ライブ移行手順 の最初のステップとして 移行契約 を受け入れる必要があります。
お使いのクラスターを移行する
重要
ライブ移行手順の実行中は、レプリカセット ノードの削除やmongod
ランタイム設定( featureCompatibilityVersion
など)の変更など、ソースクラスター構成を変更しないでください。
手順
Atlas で、Organization Settings ページに移動します。
まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーション バーのOrganizationsメニュー
[Organizations] メニューの横にある [Organization Settings] アイコンをクリックします。
[ Organization Settings ]ページが表示されます。
Live Migration to Atlas ページに移動します。
サイドバーの Live Migration をクリックします。
[ Atlas へのライブ移行 ]ページが表示されます。
移行プロセスを開始します。
[Migrate from Ops Manager or Cloud Manager] をクリックします。
I'm Ready to Startをクリックし、 MongoDB Communityを使用して から 移行する 場合は、MongoDB Ops Manager Ops Manager License Agreementをクリックして読み取りと受け入れを行います。ライブ移行ウィザードの外部で契約を読み取るには、「 MongoDB Ops Managerの移行契約 」を参照してください。
Atlas には、プロセスの進め方を示すライブ移行ウィザードが表示されます。 このプロセスは、ソースクラスターのデータを新しい宛先クラスターにプッシュします。 ウィザードの手順を完了したら、お使いのアプリケーションが新しいクラスターに向くよう設定できます。
Atlas とのリンク。
[ Generate Link-Tokenをクリックします。 Atlasにトークンリンクを生成するためのページが表示されます。
から移行する場合は、外部 MongoDB Ops ManagerIPアドレスまたは インスタンスの CIDR ブロックを入力して、トークンリンクに埋め込まれた キーのアクセスMongoDB Ops ManagerAPI リストに追加します。これにより、 MongoDB Ops Managerはプロジェクトとクラスターの情報をAtlasに送信できます。 MongoDB Ops Managerは、このステップではMongoDBデータベースに保存されているデータを送信しません。 たとえば、
23.248.95.14
と入力します。Cloud Manager から移行する場合は、この手順をスキップします。
生成されたトークンリンクを含むページを表示するには、 Nextをクリックします。
トークンリンクをコピーし、安全な場所に保存します。 Atlas はトークンリンクの内容を表示しません。 また、Atlas はトークンリンクを生成した後、そのトークンを表示しません。 公開共有しないでください。
注意
1 つの固有のトークンリンクを使用して、1 つのCloud ManagerまたはMongoDB Ops Manager組織内のすべてのプロジェクトをAtlasにライブ移行します。
[Done] をクリックします。
トークンリンクをMongoDB Ops ManagerまたはCloud Managerに貼り付けます。
Cloud ManagerまたはMongoDB Ops Managerで組織にアクセスします。
MongoDB Ops ManagerまたはCloud Managerを開き、 Atlasにライブ移行するプロジェクトのクラスターを含む組織に移動します。
左側のナビゲーションパネルで [Settings] をクリックします。
Live Migration: Connect to Atlasセクションで、 Connect to Atlasをクリックします。 Connect to Atlasダイアログ ボックスが開きます。
ライブ移行ウィザードの前のステップで生成したトークンリンクを貼り付け、 Connect to Atlasをクリックします。 Cloud ManagerまたはMongoDB Ops Managerは、 Atlasへの接続を確立します。 必要に応じて、 Refreshボタンを使用して更新内容を Atlas に送信します。 詳細については、「 Atlasのライブ移行の MongoDB Ops ManagerためにAtlas への接続 」または「 のライブ移行のためのCloud Manager Atlas の接続 」を参照してください。
宛先 Atlas クラスターを作成します。
まだ作成していない場合は、Atlas で宛先クラスターを作成します。 「前提条件 」を参照してください。
宛先クラスターから移行を開始します。
[Select Target Cluster from Projects] をクリックします。
GoAtlas宛先の クラスターのプロジェクトに し、宛先クラスターを見つけます。
をクリックします移行を開始するには、ドロップダウン リストから [ Migrate Data to this Clusterを選択します。 Migrate Data to This Clusterページが開きます。
[ Migrate from Ops Manager or Cloud Managerをクリックし、次のようにフィールドに入力します。
まだ選択されていない場合は、 Cloud ManagerまたはMongoDB Ops Managerでソース プロジェクトを選択します。
移行を処理するための移行ホストを選択します。
IP アドレス アクセス リストを確認し、移行ホストの外部 IP アドレスがこのリストに含まれていることを確認します。 追加されていない場合は、ここで追加します。
クリック Set Network Access for Host
クリック + Add IP Address
ライブ移行ウィザードに戻ります。 ドロップダウンからソースクラスタを選択し、 の下でMigrate data to this clusterを選択します。 。
ドロップダウンからソースクラスターを選択します。
Cloud ManagerまたはMongoDB Ops 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 ピアリングとプライベートエンドポイントのサポート 」を参照してください。注意
プライベートエンドポイントは、単一のクラウドプロバイダーと単一のリージョン内に配置されたレプリカセットのライブ移行でのみサポートされます。 シャーディングされたクラスター、マルチリージョンクラスター、マルチクラウドクラスターは、プライベートエンドポイントを介したライブ移行をサポートしていません。
[ Validateをクリックします。 検証プロセスでは、移行ホストがアクセス可能であることを確認し、次の検証チェックを実行して、Atlas へのライブ移行を開始できることを確認します。
次の検証チェックを利用するには 、 のMongoDB Agent MongoDB Ops ManagerMongoDB Agent をアップグレードする か、 の を 最新バージョンにアップグレードします。MongoDB AgentCloud Managerライブ移行プロセスが、ソースクラスターが MongoDB Ops Manager 用の12.0.11.7606より前のバージョンの MongoDB Agent を実行していることを検出した場合、または12は します。 5 。 0 。 7713 Cloud Manager の場合、MongoDB Agent をアップグレードすることを提案するバナー警告が表示されます。
ライブ移行中に次の検証チェックが実行されます。
移行ホストは宛先クラスターに接続できます。
ソースクラスターがカスタム ルート認証局(CA)でTLS / SSLを使用する場合、移行ホストはTLS / SSLを使用してソースクラスターにアクセスできます。
データベースユーザーの認証情報が有効です。 この検証チェックは、 Cloud ManagerまたはMongoDB Ops Managerのオートメーションでソースクラスターの自動化を一時停止しているが、モニタリングエージェントでソースクラスターを引き続き監視している場合にのみ実行されます。
バージョン 5.0.9 より前のMongoDB Ops Managerから移行する場合、ライブ移行プロセスは、データサイズに基づいて宛先クラスターに十分なディスク領域があることを検証します。 Cloud ManagerまたはMongoDB Ops Manager 5.0.9 以降から移行する場合、移行プロセスは、圧縮されたデータのストレージ サイズに基づいて、宛先クラスターに十分なディスク領域があることを検証します。 データとストレージ サイズの詳細については、 dbStats を参照してください。
検証に失敗した場合は、移行ホスト、外部 IP アドレスまたはCIDRブロックの有効性、およびトークンリンクを確認します。 また、データベースユーザーの認証情報、 TLS / SSL証明書、宛先クラスターのディスク ストレージ サイズの量も確認します。
検証に成功した場合は、[ Next ] をクリックします。 Migrate from Ops Manager or Cloud Managerページが表示されます。
カットオーバーを実行します。
Atlas は、ソースクラスターと宛先クラスターがほぼ同期していることを検出すると、延長可能な 120 時間(5 日)のタイマーを開始してライブ移行手順のカットオーバーのステージを開始します。120 時間が経過すると、Atlas はソースクラスターとの同期を停止します。<time> left to cut over タイマーの下の Extend time をクリックすると、残り時間を 24 時間延長できます。
移行の有効期限が迫っている場合、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.
Atlas クラスターへの MongoDB データの移行を完了するには、 Your migration is almost complete!ページで次の手順を実行します。
Atlas クラスターを指すように準備します。 新しい接続文字列をコピーして、更新し、アプリケーションが宛先のAtlasクラスターに向くよう設定します。
アプリケーションを停止します。 このアクションにより、ソースクラスターでこれ以上の書込み (write) が発生しなくなります。
optime ギャップが 0 になるまで待ちます。カウンターがゼロに達すると、ソースクラスターと宛先クラスターは同期されます。
移行プロセスを完了するには、 Cut Overをクリックします。
ライブ移行進行状況バーでCancelをクリックすると、Atlas はソースクラスターからの書込みの同期を停止します。 移行されたすべてのデータは、Atlas クラスターに残ります。
Atlas による移行プロセスを完了するには、 Cut Overを再度クリックします。
Atlas が宛先クラスターを構成し、使用する準備が整うまで待ちます。 小規模なクラスターの場合、この時間は3 - 5分です。 大規模なクラスターの場合、クラスターのサイズと構成に応じて、この時間は最大10分以上長くなる可能性があります。
カットオーバー プロセスが少なくとも12時間進行している場合、Atlas は移行プロセスを確認するか、サポートに連絡することを提案するメールを送信します。
Atlas の宛先クラスターへの書込みをリダイレクトする準備ができたら、次の手順に従います。
宛先クラスターの接続文字列を使用してアプリケーションに接続します。
アプリケーションが宛先の Atlas クラスターで動作していることを確認します。
宛先クラスターのデータを確認します。
宛先クラスターへの書込みを再開します。
Atlas は、プロセスを完了するために次のアクションを実行します。
MongoDB ライブ移行サーバーのサブネットを宛先クラスターの IP アクセスリストから削除する。
ライブ移行で宛先クラスターへのデータのインポートに使用したデータベースユーザーを削除します。
移行プロセスを完了としてマークします。
プッシュ ライブ移行 API
ライブ移行手順に関連付けられたタスクを実行するには、「プッシュ ライブ移行 API 」を参照してください。
移行サポート
ライブ移行プロセスのいずれかの段階で移行が失敗した場合、Atlas は移行結果を確認するためのリンクを記載したメールで通知を行います。
このドキュメントで説明されている範囲外で移行のサポートに関して質問がある場合、または移行中にエラーが発生した場合は、Atlas UI からサポートをリクエストしてください。
サポートチケットを提出するには:
Atlas で、Project Support ページに移動します。
まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
Projects メニューの横にある Options メニューをクリックし、 Project Support をクリックします。
プロジェクト サポートページが表示されます。
サポートをリクエストします。
[Request Support] をクリックします。
Issue Category の場合は
Help with live migration
を選択します。Priority には、お問い合わせの優先度を選択します。ご質問の場合は、
Medium Priority
を選択してください。移行に失敗した場合は、High Priority
を選択してください。Request Summary には、
Live Migration
を要約に含めてください。More details には、ご質問または移行エラーに関するその他の詳細も含めてください。
Request Support ボタンをクリックして、フォームを送信します。
プッシュ ライブ移行 CLI コマンド
Atlas CLI を使用してクラスターを移行するには、次の手順を実行します。
トークンリンクの作成または削除
検証ジョブを作成または表示する
移行ジョブを作成または表示する
カットオーバーの実行
ライブ移行手順の他のステップには、Cloud Manager UI または Atlas UI を使用する必要があります。 詳細については、ライブ移行ワークフロー を参照してください。
Atlas CLI を使用してクラスターを移行する前に、移行前の検証を完了してください。
注意
Atlas CLI コマンドを実行する前に、次の操作を行う必要があります。
トークンリンクの作成または削除
Atlas CLI を使用して新しいトークンリンクを作成するには、次のコマンドを実行します。
atlas liveMigrations link create [options]
Atlas CLI を使用して指定したトークンリンクを削除するには、次のコマンドを実行します。
atlas liveMigrations link delete [options]
前のコマンドの構文とパラメータの詳細については、 Atlas CLIドキュメントの「 Atlas liveMigrations link create 」および「 Atlas liveMigrations link delete 」を参照してください。
MongoDB Ops Managerから移行する場合は、外部IPアドレスをリクエストし、それをトークンリンクで指定します。 詳細については、MongoDB Ops Manager ドキュメントの「外部 IP アドレスの要求」を参照してください。
検証ジョブの作成と表示
Atlas CLI を使用して新しい検証リクエストを作成するには、次のコマンドを実行します。
atlas liveMigrations validation create [options]
Atlas CLI を使用して指定した検証リクエストの詳細を返すには、次のコマンドを実行します。
atlas liveMigrations validation describe [options]
前のコマンドの構文とパラメータについて詳しくは、Atlas CLIドキュメントの「 Atlas liveMigrations validation create and Atlas liveMigrations validation describe 」を参照してください。
Atlas が検証する内容については、このページのMigrate Your ClusterセクションのValidateのドットを参照してください。
移行ジョブの作成と表示
Atlas CLI を使用して新しい移行ジョブを 1 つ作成するには、次のコマンドを実行します。
atlas liveMigrations create [options]
Atlas CLI を使用して、指定した移行ジョブの詳細を返すには、次のコマンドを実行します。
atlas liveMigrations describe [options]
前のコマンドの構文とパラメーターについて詳しくは、 Atlas CLIドキュメントのAtlas liveMigration createおよびAtlas liveMigrations describe を参照してください。
カットオーバーの実行
Atlas CLI を使用してライブ移行のカットオーバーを開始するには、次のコマンドを実行します。
atlas liveMigrations cutover [options]
コマンド構文とパラメータの詳細については、 Atlas CLIドキュメントのAtlas liveMigrations カットオーバー を参照してください。
カットオーバーが完了すると、Atlas はライブ移行プロセスを完了し、ソースクラスターとの同期を停止します。 詳しくは、このページのMigrate Your Clusterセクションを参照してください。