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

ライブ移行のトラブルシューティング

重要

The feature described on this page is not currently supported on Atlas Infinite clusters during public preview. For the features supported in public preview, see Public Preview Availability.

ライブ移行プロセスが開始される前に、Atlas は検証チェックを実行して、必要なフォーム フィールドとパラメーターがすべて機能し、正しいことを確認します。いずれかのパラメータが無効な場合、Atlas はエラーを返し、ライブ移行は続行されません。

このセクションでは、一般的なライブ移行検証エラーについて説明し、エラーが発生した場合は確認する方法の提案を提供します。

エラー
修正

宛先で使用可能なディスク容量を増やす必要がある

移行中に一時的なデータの変化を考慮するには、宛先クラスターで使用可能なディスク容量が、ソースクラスターで消費されるディスク容量よりも大きくなければなりません。宛先クラスターが移行を処理できることを確認し、必要に応じて宛先クラスターのディスクサイズを増やします。

指定されたソースに到達できませんでした

ソースクラスターの IP アクセス リストに正しいサブネット範囲を追加したことを確認します。 ライブ移行モーダル ウィンドウに 4 つの必要なサブネット範囲があります。

  • 指定したホスト名がパブリック IP アドレスに解決されることを確認します。 コマンド プロンプトで、次のいずれかのコマンドを使用します。

    nslookup <hostname>
    ping <hostname>
  • プル型のライブ移行と互換性のないVPCピアリング接続 を使用していないことを確認します。

ホスト名を解決できませんでした

指定されたホスト名の IP アドレスが見つかりませんでした。 指定されたホスト名が正しくアクセスし、一般にアクセスできることを確認します。

ディスク ストレージ情報は使用できません

ライブ移行(プル)プロセスを実行するには、MongoDB ユーザーはソースクラスターの MongoDB インスタンスに対する 権限が必要です。 詳細については、 「ソースクラスターのセキュリティ」 を参照してください。

無効な SSL オプションが提供されました

ソースクラスターがTLS/SSL を使用する場合:

  • 接続文字列に tls=true パラメータが含まれていることを確認します。

  • ソースクラスターが非公開の認証局(CA)を使用している場合は、CAファイルの内容が完全であり、Upload CA fileフィールドに正しく貼り付けられていることを確認します。

ソースクラスターがTLS/SSL を使用しない場合:

  • 接続文字列に tls パラメータが存在しないことを確認します。

  • 接続文字列をチェックし、sslクエリ パラメータが存在しないことを確認します。 --ssl が接続文字列の一部である場合、クラスターには SSL 接続が必要です。

ソースはスタンドアロンであると考えられます

ソース配置は MongoDBレプリカセットである必要があります。 ソース配置が現在スタンドアロン ノードである場合は、ライブ移行(プル)を実行する前に、単一ノード レプリカセットに変換します。

ソースクラスターには時系列コレクションが含まれており、これはサポートされていません

Ensure that the source cluster doesn't contain time series collections, which aren't supported. To filter your databases on the source cluster and identify which collections with time series data have caused the error, use the listCollections command, as in the following example:

db.runCommand({ listCollections: 1, filter:{ type: "timeseries" }})

ユーザー名またはパスワードが正しくありません

Confirm your credentials in mongosh with the following commands:

use admin
db.getUser("<username>");

問題が解決されない場合は、MongoDB ユーザーのパスワードを更新してください。

提供された CA ファイルを処理できない

CA ファイルが完全で、ライブ移行(プル)モーダル ウィンドウに正しく貼り付けられていることを確認します。

ユーザーには、カットオーバー中に書き込みをブロックするために必要な権限がありません

Ensure the user has the following permissions: bypassWriteBlockingMode. Also, ensure the user has all the required roles to live migrate data.

コマンドを実行する権限のないユーザー

ライブ移行(プル)プロセスを実行するには、MongoDB ユーザーに十分なシステム特権が必要です。 詳細については、 「ソースクラスターのセキュリティ」 を参照してください。

次の問題が発生しました: 宛先クラスターからダミーのインデックスを削除できませんでした。クラスターへのパフォーマンスとストレージへの影響を防ぐには、_mongosync_dummy_shard_key_index のサフィックスを持つインデックスを手動で削除してください。

To find which collections still contain the dummy index, run the following query in mongosh:

db.adminCommand('listDatabases').databases
.filter(
d => !['admin', 'local', 'config'].includes(d.name)
)
.forEach(database => {
const currentDb = db.getSiblingDB(database.name);
currentDb.getCollectionNames().forEach(collName => {
const indexes =
currentDb.getCollection(collName).getIndexes();
const hasTargetIndex = indexes.some(
idx => idx.name.startsWith(
'_mongosync_dummy_shard_key_index'
)
);
if (hasTargetIndex) {
print(`${database.name}.${collName}`);
}
});
});