翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
DataSync タスクの問題のトラブルシューティング
以下の情報は、 AWS DataSync タスクとタスク実行に関する問題のトラブルシューティングに役立ちます。これには、タスクのセットアップの問題や、タスク実行が停止する、データが正常に転送されないといった問題が含まれます。
エラー: Invalid SyncOption value. Option: TransferMode,PreserveDeletedFiles, Value: ALL,REMOVE.
このエラーは、DataSync タスクを作成または編集しているときに、[すべてのデータを転送する] オプションを選択し、[削除されたファイルを保持する] オプションを選択解除したときに発生します。
すべてのデータを転送すると、DataSync は送信先の場所をスキャンしないため、何を削除すればよいかわかりません。
タスク実行が EniNotFound というエラーで失敗する
このエラーは、仮想プライベートクラウド (VPC) のタスクのネットワークインターフェイスのいずれかを削除した場合に発生します。タスクがスケジュールされているかキューに入っている場合、データの転送に必要なネットワークインターフェイスがないと、タスクは失敗します。
実行するアクション
この問題に対処するには、次のオプションがあります。
-
タスクを手動で再起動します。これを行うと、DataSync はタスクの実行に必要な、不足しているネットワークインターフェイスをすべて作成します。
-
VPC のリソースをクリーンアップする必要がある場合は、まだ使用している DataSync タスクに関連するネットワークインターフェイスを削除しないようにしてください。
タスクに割り当てられたネットワークインターフェイスを表示するには、次のいずれかを実行します。
-
DescribeTask オペレーションを使用します。ネットワークインターフェイスは、
SourceNetworkInterfaceArnsおよびDestinationNetworkInterfaceArnsレスポンス要素で表示できます。 -
Amazon EC2 コンソールで、タスク ID (
task-f012345678abcdef0など) を検索してネットワークインターフェイスを見つけます。
-
-
タスクを自動実行しないことを検討してください。これには、タスクのキューイングまたはスケジューリング (DataSync またはカスタムオートメーションによる) の無効化が含まれる場合があります。
タスク実行が Cannot allocate memory というエラーで失敗する
DataSync タスクが Cannot allocate memory というエラーで失敗した場合、いくつかの原因が考えられます。
実行するアクション
問題が解消されるまで、次のことを試してください。
-
転送にエージェントが関連している場合は、そのエージェントが仮想マシン (VM) または Amazon EC2 インスタンスの要件を満たしていることを確認します。
-
フィルターを使用して転送を複数のタスクに分割します。1 つの DataSync タスクで処理できる数よりも多くのファイルまたはオブジェクトを転送しようとしている可能性があります。
-
それでも問題が解決しない場合は、サポートにお問い合わせください
。
FSx for ONTAP ファイルシステムでタスクが Input/Output error で失敗する
FSx for ONTAP ファイルシステムでデータを転送するときに DataSync タスクが Input/Output error で失敗した場合、次の 1 つまたは複数の問題が原因である可能性があります。
FSx for ONTAP ボリュームが最大ファイル容量に達した
このエラーは、ボリュームで使用可能な inode またはファイルポインタの数を使い果たした場合に発生します。
実行するアクション
まず、ボリュームの最大ファイル容量を表示します。次に、inode の数を増やすか、ストレージ容量を増やすことで、ボリュームのファイル容量を増やします。詳細については、「ONTAP User Guide」の「Increasing a volume's maximum file capacity」を参照してください。
FSx for ONTAP ボリュームの使用可能なストレージ容量が不足している
このエラーは、ボリュームに使用可能なストレージ容量がない場合に発生します。
実行するアクション
まず、ボリュームの使用可能なストレージ容量を決定します。次に、ボリュームのストレージ容量を増やします。詳細については、「ONTAP User Guide」の「Increasing a volume's storage capacity」を参照してください。
注記
必要に応じてボリュームのストレージ容量を自動的に増やすには、「ONTAP User Guide」の「Using volume autosizing」を参照してください。
FSx for ONTAP ディレクトリが、各ディレクトリに保存できるファイルの最大数に達した
このエラーは、各ディレクトリに保存できるファイルの最大数に達したときに発生します。
実行するアクション
最大ディレクトリサイズを増やして、より大きなディレクトリをサポートできるようにします。詳細については、「AWS 規範ガイダンス」の「Best practices for using the NetApp ONTAP maximum directory size」を参照してください。
DataSync タスク実行で読み取りと書き込みの同時実行が多すぎて、ファイルシステムのスループットキャパシティの大部分を消費する
このエラーは、DataSync タスク実行がファイルシステムの使用可能なスループットキャパシティを過度に消費している場合に発生します。
実行するアクション
まず、次の方法を使用して、タスク実行がファイルシステムのスループットキャパシティを過剰に消費していたかどうかを判断します。
-
使用可能な CloudWatch メトリクスを使用して、ファイルシステムのパフォーマンスをモニタリングします。詳細については、「ONTAP User Guide」の「Monitoring file system metrics in the Amazon FSx console」を参照してください。
-
Amazon FSx コンソールでファイルシステムをモニタリングし、ファイルサーバーのパフォーマンスに関する警告がないか確認します。詳細については、「ONTAP User Guide」の「Use performance warnings to improve file system performance」を参照してください。
次に、以下のいずれかを実行して、タスクがファイルシステムの使用可能なスループットキャパシティをすべて使用しないようにします。
-
タスク実行の帯域幅制限を、FSx for ONTAP ファイルシステムのプロビジョニングされたスループットキャパシティよりも小さい量に設定します。詳細については、「AWS DataSync タスクへの帯域幅制限の設定」を参照してください。
-
ファイルシステムのプロビジョニングされたスループットキャパシティを増やします。詳細については、「ONTAP User Guide」の「Updating throughput capacity」を参照してください。
FSx for ONTAP ファイルシステムの Connection Reset by peer または Host is down メッセージでタスクが失敗する
FSx for ONTAP ファイルシステムでデータを転送するときに DataSync タスクが Connection Reset by peer または Host is
down メッセージで失敗した場合、次の 1 つまたは複数の問題が原因である可能性があります。
タスク実行中に、ファイルシステムの SMB サーバーが再起動または切断されました。
-
タスク実行中に、ファイルシステムがプライマリサーバーからセカンダリサーバー (および IP アドレス) にフェイルオーバーしました。DataSync は、タスク実行中のセカンダリ IP アドレスへのフェイルオーバーをサポートしていません。
FSx for ONTAP ファイルシステムは、次のイベントの発生時にセカンダリサーバーおよび IP アドレスにフェイルオーバーします。
プライマリサーバーが使用できなくなったとき。
プライマリサーバーのアベイラビリティーゾーンが使用できなくなったとき (マルチ AZ ファイルシステムの場合)。
ユーザーが開始したスループットキャパシティの変更中。
ファイルシステムの定期メンテナンス期間中。
詳細については、「ONTAP User Guide」の「Failover process for FSx for ONTAP」を参照してください。
実行するアクション
タスクを再起動します。
タスク実行のステータスが [起動中] になっているが、何も起きていないように見える
DataSync タスクは [起動中] のステータスで停止することがあります。これは通常、エージェントの電源がオフになっているか、ネットワーク接続が切断されているためです。
実行するアクション
エージェントのステータスがオンラインであることを確認します。エージェントが オフライン の場合は、エージェントの電源が入っていることを確認します。
エージェントの電源がオンでもタスクが引き続き 起動中のステータスのままである場合は、エージェントと AWSの間でネットワーク接続の問題が発生している可能性が高いです。ネットワーク接続をテストする方法については、「エージェントと DataSync サービスとの接続の検証」を参照してください。
それでもこの問題が解決しない場合は、「エージェントがどのような状況なのかがわかりません。サポートを受けることはできますか?」を参照してください。
タスク実行が [準備中] ステータスのまま止まっているように見える
DataSync 転送タスクが [準備中] のステータスである時間は、転送元と転送先のデータ量、およびそれらのストレージシステムのパフォーマンスによって異なります。
タスクを開始すると、DataSync は再帰的なディレクトリのリストアップを実行して、送信元と送信先あるすべてのファイル、オブジェクト、ディレクトリ、メタデータを検出します。DataSync はこれらのリストを使用してストレージシステム間の違いを識別し、何をコピーするかを決定します。このプロセスには数分または数時間かかることがあります。
実行するアクション
必要な操作はありません。タスクのステータスが [転送中] に変わるまで待機してください。それでもステータスが変わらない場合は、AWS サポート センター
転送が終了する前にタスク実行が停止した
DataSync タスクの実行が早期に停止する場合は、タスクの設定に、 AWS アカウントで無効になっている AWS リージョン が含まれている可能性があります。
実行するアクション
タスクを再度実行するには、次の手順を実行します。
-
タスクのリージョンのオプトインステータスをチェックし、有効になっていることを確認します。
-
再度タスクを開始します。
Google Cloud Storage バケットから転送するとタスク実行が失敗する
DataSync は Amazon S3 API を使用して Google Cloud Storage と通信するため、オブジェクトタグをコピーしようとすると DataSync 転送が失敗する可能性がある制限があります。問題に関連する次のメッセージが CloudWatch ログに表示されます。
[WARN] Failed to read metadata for file /your-bucket/your-object: S3 Get Object Tagging Failed: proceeding without tagging
これを防ぐには、転送タスクの設定時に [オブジェクトのタグをコピーする] オプションの選択を解除します。
タスク実行のタイムスタンプに不一致がある
DataSync コンソールまたは Amazon CloudWatch Logs を確認したときに、DataSync タスク実行の開始時刻と終了時刻が、他のモニタリングツールに表示されるタイムスタンプと一致していないことがあります。これは、他のツールとは異なり、コンソールと CloudWatch ログでは、タスク実行が起動中またはキューに登録中の状態にある時間が考慮されるためです。
DataSync コンソールまたは CloudWatch ログと以下の場所の実行タイムスタンプを比較すると、この不一致に気付くことがあります。
-
転送に関係するファイルシステムのログ
-
DataSync が書き込みを行った Amazon S3 オブジェクトの最終更新日
-
DataSync エージェントからのネットワークトラフィック
-
Amazon EventBridge イベント
タスク実行が NoMem エラーで失敗する
転送しようとしているデータセットは、DataSync には大きすぎる可能性があります。このエラーが表示された場合は、AWS サポート センター
タスク実行が FsNfsIdMappingEnabled エラーで失敗する
DataSync は NFSv4 ID マッピングをサポートしていません。これを回避するには、NFSv3 を使用するように NFS の場所を設定します。
オブジェクトが Azure Blob Storage への転送に失敗し、user metadata key エラーが表示された
S3 バケットから Azure Blob Storage に転送を行うと、次のエラーが表示される場合があります。
[ERROR] Failed to transfer file/user-metadata/file1: Azure Blob user metadata key must be a CSharp identifier
これは、 に、有効な C# 識別子を使用していないユーザーメタデータが含まれていることを示します。詳細については、Microsoft のドキュメント/user-metadata/file1
送信先ロケーションに /.aws-datasync フォルダがある
DataSync は、データ転送を容易にするために、送信先のロケーションに /.aws-datasync というフォルダを作成します。
DataSync は通常、転送後にこのフォルダを削除しますが、削除されていない可能性もあります。
実行するアクション
実行中のタスク実行がそのロケーションにコピーされていない限り、このフォルダをいつでも削除することができます。
SMB を使用してロケーション間でシンボリックリンクを転送できない
タスク実行が終了したときに、次のエラーが表示されます。
Transfer and verification completed. Selected files transferred except for files skipped due to errors. If no skipped files are listed in Cloud Watch Logs, please contact AWS Support for further assistance.
SMB ストレージシステム (SMB ファイルサーバーや Amazon FSx for Windows File Server ファイルシステムなど) 間で転送する場合、CloudWatch ログに次の警告とエラーが表示される場合があります。
[WARN] Failed to read metadata for file /appraiser/symlink: No data available [ERROR] Failed to read metadata for directory /appraiser/symlink: No data available
実行するアクション
DataSync は、これらのロケーションタイプ間で転送する場合、シンボリックリンク (またはハードリンク) の転送をサポートしていません。詳細については、「AWS DataSyncによってコピーされたリンクとディレクトリ」を参照してください。
タスクレポートエラー
タスクレポートで DataSync 転送を監視しようとすると、次のいずれかのエラーが発生する可能性があります。
| エラーメッセージ | 回避方法 |
|---|---|
|
|
なし。DataSync は 4,096 バイトを超えるパスが含まれるファイルを転送できません。 詳細については、「ストレージシステム、ファイル、オブジェクトの制限事項」を参照してください。 |
|
|
DataSync IAM ロールに、S3 バケットにタスクレポートをアップロードするための適切な許可があることを確認します。 |
|
|
CloudWatch のログをチェックして、タスク実行が失敗した理由を特定します。 |