NetApp Data Migrator の既知の問題
既知の問題では、この製品のリリース版を正常に使用できない可能性がある問題点を指摘しています。これらの既知の問題点をよく読んでください。
構成
SID マッピング使用時のアクセス権限の不一致
NetApp Data Migratorは、SIDマッピングの使用時に `Missing ACE in target`エラーを報告する場合があります。このエラーは、ルートレベルでSIDマッピングが実行されなかったため、ソースシステムとターゲットシステム間でアクセス権限の不一致が発生したことを示しています。
次の2つのシナリオに示すように、SIDソースとターゲットのCSVマッピングを提供してください:
次の例に示すように、ソース Active Directory から削除されたユーザーまたはグループの SID を CSV マッピング シートに入力します:
| sid_source | sid_target |
|---|---|
S-1-5-21-2444020195-1862089444-1769087368-1000 |
S-1-5-21-3481156262-2863848796-4292454742-512 |
Active Directory のアクティブなユーザーまたはグループについては、CSV マッピングシートにユーザー名またはグループ名をすべて小文字で入力してください。次の例に示すように、ドメインプレフィックス(domain\username)を含めてください:
| sid_source | sid_target |
|---|---|
rootdomain\user1 |
rootdomain\user2 |
同一階層ディレクトリの一括移行に関する制限
一括移行機能を使用する場合、ソースディレクトリと宛先ディレクトリの階層構造において同じレベルにあるディレクトリに対して、複数の移行ジョブをまとめて作成することはできません。例えば、ソースと宛先で同じ共有操作を行う際に、同じ共有フォルダ内にある兄弟フォルダなどです。このようなディレクトリを単一の一括移行設定に含めようとすると、ジョブの作成が失敗します。
同じ階層にあるディレクトリについては、まとめて追加するのではなく、1つずつ移行ジョブを作成してください。
ディレクトリレベルの移行で継承された権限のスタンプ
ディレクトリレベルの移行では、選択したルートディレクトリの継承されたアクセス許可は、移行先には反映されません。NetApp Data Migrator はルートディレクトリに対して継承されたアクセス許可を適用しないため、継承に依存する子ディレクトリやファイルも、継承されたアクセス許可を受け取りません。
この問題は、ルートディレクトリから継承されたパーミッションの伝播にのみ影響します。NetApp Data Migrator は、移行中にファイルやディレクトリに直接設定された明示的なアクセス許可(継承されないアクセス許可)を正しく適用します。
移行が完了したら、移行先のルートディレクトリで、継承されたアクセス許可を手動で再適用またはリセットしてください。これにより、継承された適切なアクセス許可がすべての子ディレクトリとファイルに伝播されます。
NFSにおけるUIDとGIDマッピングの手動アップロードの検証
NFS 移行中に、UID および GID マッピング CSV ファイルに、宛先システムに存在しない数値のユーザー ID またはグループ ID が含まれている場合、NetApp Data Migrator は、これらの値をそのまま適用(記録)します。NetApp Data Migrator は、指定された UID または GID が移行先に存在するかどうかを検証せず、UI にエラーや警告を報告しません。これにより、所有権が誤っている状態でファイル移行が行われる可能性があります。正しい UID と GID のマッピングを指定する必要があります。
移行を開始する前に、マッピングCSVで指定されているすべてのUIDおよびGIDの値が、移行先システム上の有効な既存のユーザーおよびグループに対応していることを確認してください。移行中にNetApp Data Migratorが誤った所有権を適用しないように、移行先でユーザーとグループの存在を手動で確認してください。
移行の事前チェックで、誤った容量不足の警告が表示される
移行の事前チェック中に、移行先の空き容量が十分であっても、次のような警告が表示される場合があります:
Insufficient destination space for selected path. Do you still want to proceed with the migration?
これは、検出ステップをスキップし、NetApp Data Migrator が実際のデータセット サイズではなくブロック デバイス全体のサイズを読み取る汎用コマンドを使用する場合に発生する可能性があります。
移行を実行する前に、検出を実行してください。これにより、ディスク使用状況情報が事前チェック操作で利用可能であることが保証されます。それでも警告が表示される場合:
-
検出が完了したことを確認します。
-
宛先ボリュームに十分な空き容量があることを手動で確認してください。
-
十分な空き容量があれば、安心してデータ移行を進めることができます。
レポート
ExcelでCOCレポートファイルに誤った権限が表示される
Microsoft ExcelでChain of Custody(CoC)レポートのCSVファイルを開くと、ファイルまたはフォルダーのアクセス許可が実際の値ではなく、#NAME?(例:-rwxrwxrwx)と表示される場合があります。
これは、Excelが特定の権限文字列(「-」または「=」で始まるもの)を誤って数式として扱い、表示エラーを引き起こすために発生します。CSVファイル自体は正しく、これは表示上の問題にすぎません。
ファイルとフォルダの正しいアクセス許可を確認するには、以下のいずれかのアプリケーションを使用してCSVファイルを開いてください:
-
Google Sheets
-
Apple Numbers
-
オンライン CSV ビューア
-
テキストエディタ(Notepad++など)
ネットワークの問題により一括検出ジョブが失敗した場合、エラーメッセージは表示されません。
一括検出ジョブ中にホストまたは宛先サーバーがダウンした場合、NetApp Data Migratorはエラーメッセージを表示しない場合があります。これは、ジョブがまだ正常に実行されているという印象を与える可能性があります。
検出ジョブは30秒ごとに更新されます。ファイル数、ディレクトリ数、またはデータサイズが更新されない場合は、ネットワークの問題が発生している可能性があります。
-
ネットワーク接続を確認してください:
-
ワーカーVMのターミナルを開きます。
-
宛先サーバーのIPアドレスにpingを実行します。
応答がない場合、宛先に到達できない可能性があります。
-
-
ネットワークインターフェイスを復元します:
-
SSH を使用して宛先サーバーに接続します:
ssh <destination_IP> -
インターフェース名を確認します。例:eth0:
ipconfig -
ネットワークインターフェイスをオンラインに戻します:
ifup <interface_name>
-
-
必要に応じて、ソースサーバーに対しても手順1と手順2を繰り返してください。
Windows ワーカーでユーザーを切り替えることができません
Windows ワーカー上で別のユーザーアカウントに切り替えると、既存のネットワーク接続が原因で失敗する可能性があります。これにより、ファイルサーバーへのアクセスが妨げられる可能性があります。
-
Windowsワーカー上でコマンドプロンプトを開き、以下のコマンドを実行して、以前の接続を削除します:
net usenet use <IP address> /delete -
新しいユーザーアカウントに切り替えて、ファイルサーバーにアクセスします。
検証
ファイル数が一致していても、移行後にファイルサイズが異なる場合があります
データ移行が完了すると、ファイル総数は正しくなりますが、一部のファイルのサイズは元のソースファイルと異なる場合があります。これは、ネットワークが中断された場合や、ファイル転送中にサーバーに問題が発生した場合に起こり得ます。
-
移行COCレポートを確認し、エラーとしてマークされたファイルを特定してください。
-
エラーが解消されるまで、移行処理を再実行してください。
ワークフロー
ジョブが20分以上一時停止または停止しました
ネットワーク接続の問題、送信元または送信先のボリュームの安定性の問題、あるいはその両方が見られる場合は、介入が必要になる可能性があります。ジョブは一時停止状態または実行状態になっている可能性があり、目に見える進捗状況は表示されません。これは、送信元または送信先のサービスが停止した場合、あるいはワーカーサービスがダウンした場合に発生する可能性があります。
-
送信元と送信先を確認してください。
オフラインになっている場合は、再起動して接続を復元してください。
-
ワーカーのステータスを確認してください。
ワーカーがオフラインの場合は、SSHを使用してVMに接続し、次のコマンドを実行します:
systemctl restart datamigrator-worker.service -
VMをリブートします:
問題が解決しない場合は、ワーカー VM を再起動してください。
エラーが発生すると、ジョブの実行ステータスが分かりにくくなる
一部の移行ジョブの実行中にエラーが発生し、「完了」または「エラー」のステータスが表示されます。これは、移行ジョブの実行ステータスを解釈する際に混乱を招く可能性があります。
ステータス定義:
-
完了:ジョブの実行は終了しましたが、エラーが含まれている可能性があります。
-
エラー:重大な問題によりジョブの実行が失敗しました。
ジョブ実行結果を確認するには、ジョブ実行の詳細を確認してエラーがないか調べてください。特にステータスが「完了」の場合は注意が必要です。この問題を解決するまでは、ステータスラベルだけに頼らないでください。