This topic describes the common causes of a migration failure that may occur when you use Data Online Migration to migrate data and related solutions.

If a migration job fails, you can go to the Data Online Migration console and view the list of files that fail to be migrated to analyze the causes of the failure and troubleshoot the issue. On the Migration Jobs page, find the failed job, click Manage in the Operation column, and then click Retry to migrate failed files.

The following sections describe the common causes of a migration failure and solutions:

Case 1: The "because downloader get inputstream failed" error message is displayed.

  • Problem description
    When you migrate data from Baidu Object Storage (BOS) to Alibaba Cloud Object Storage Service (OSS), the migration fails.
    • The following error message is displayed for the files that fail to be migrated.1
    • The following error message is recorded in the log file of BOS.1
  • Cause

    BOS enables traffic throttling on source data addresses due to a large number of requests.

  • Solution
    Contact the Baidu customer service to disable traffic throttling, or retry after you enable traffic throttling for the migration job.
    Important The following cloud service providers have enabled traffic throttling that may result in a migration failure:
    • BOS: You can contact the Baidu customer service to disable traffic throttling, or you can enable traffic throttling for the migration job.
    • Qiniu Cloud: Traffic and concurrency limits are set by Qiniu Cloud-Integrated CDN (FUSION) for test endpoints. We recommend that you migrate large amounts of data in batches or use accelerated domains.
    • UPYUN: UPYUN enables traffic throttling for scenarios in which you download large amounts of data. When you migrate large amounts of data, we recommend that you contact the UPYUN customer service to disable traffic throttling or use CDN.

Case 2: The "check size failed" error message is displayed.

  • Problem description
    When you migrate third-party data to OSS, the following error message is displayed for the files that fail to be migrated.2
  • Cause

    The last modification time of files at the source data address is later than the last modification time of files at the destination data address. A file verification error occurs if you update source files after these files have been migrated to the destination bucket.

  • Solution

    Migrate the updated source files.

Case 3: The "premature end of content-length delimited message body" error message is displayed.

  • Problem description
    When you migrate third-party data to OSS, the following error message is displayed for the files that fail to be migrated.3
  • Cause

    A connection that is used to send or receive data is closed by OSS. If the interval between two uploads exceeds 1 minute, the connection that is used to upload data is closed by OSS. Generally, the error is caused by network issues such as high network latency.

  • Solution

    Retry the migration job.

Case 4: The "check content-length failed" error message is displayed.

  • Problem description
    When you migrate third-party data to OSS, the following error message is displayed for the files that fail to be migrated.4
  • Cause

    The source and destination data addresses have files with the same name. The last modification time of the file at the destination data address is later than the last modification time of the file at the source data address. The file is ignored during the migration. However, an error may occur when the system checks the file after the migration job is complete.

  • Solution
    • If you need to migrate the file, you can retry the migration after you delete the file at the destination data address or modify the file name.
    • If you do not need to migrate the file, you can ignore the error.

Case 5: The "http status code 403" error message is displayed.

  • Problem description
    When you migrate data between OSS buckets, the following error message is displayed for the files that fail to be migrated.5
  • Cause

    Permissions are insufficient. When you create data addresses, you must use an account that has the read permissions on the source data address and the write permissions on the destination data address. After a migration job is started, an error occurs if you modify the permissions of the account or the access permissions of OSS buckets, such as modifying the policies for OSS buckets.

  • Solution

    Retry the migration after you restore the permissions of the account.

Case 6: The "The operation is not valid for the object's state" error message is displayed.

  • Problem description
    When you migrate data between OSS buckets, the following error message is displayed for the files that fail to be migrated.6
  • Cause

    Data Online Migration does not allow you to migrate objects whose storage class is Archive in OSS. The error occurs when the source contains such objects.

  • Solution
    • If you need to migrate objects whose storage class is Archive, retry the migration after you change the storage class to Standard.
    • If you do not need to migrate these objects, ignore this error.

Case 7: The "check usermeta failed" error message is displayed.

  • Problem description
    When you migrate data from BOS to OSS, the following error message is returned:
    check usermeta failed
  • Cause

    The HTTP header or user metadata of a file contains special characters that cannot be identified during the migration.

  • Solution
    • Retry the migration after you modify the HTTP header or user metadata of the file.
    • Manually migrate the file that fails to be migrated.

Case 8: The "It is timeout to check the data source, please make sure all the parameters are correct and retry later" error message is displayed.

  • Problem description

    When you migrate data from Apsara File Storage NAS (NAS) to OSS, the migration job enters the Invalid state. After you move the pointer over the 1 icon, the following error message is displayed: It is timeout to check the data source, please make sure all the parameters are correct and retry later.

  • Cause

    The IP address of the elastic network interface (ENI) used for migration cannot access the NAS file system in the virtual private cloud (VPC).

  • Solution

    Check whether access control or security groups are configured for the NAS file system. IP addresses used for migration are dynamic and random. You must authorize all IP addresses in the VPC to access the NAS file system.

Case 9: The "Requests specifying Server Side Encryption with AWS KMS managed keys must be made over a secure connection" error message is displayed.

  • Problem description
    When you migrate data from Amazon Simple Storage Service (Amazon S3) to OSS, the following error message is returned:
    Requests specifying Server Side Encryption with AWS KMS managed keys must be made over a secure connection.
  • Cause

    The error message indicates that the current connection is not secure.

  • Solution

    We recommend that you use an endpoint with HTTPS connections.

Case 10: The "UserDisable" error message is displayed.

  • Problem description

    When you migrate data between OSS buckets, the UserDisable error message is displayed for the files that fail to be migrated.

  • Cause

    Your account is disabled due to multiple possible reasons. For example, OSS is not activated for your account, or your account has overdue payments or security risks. In these cases, the UserDisable error occurs.

  • Solution

    Check whether OSS is activated for the account used to access the source and destination buckets and whether the account has overdue payments. You can also contact Alibaba Cloud OSS technical support to check whether the account is disabled.

Case 11: The "mgw.service.agent.sAddrPrefixInvalid" error message is displayed.

  • Problem description

    When you create a NAS data address, the data address enters the Invalid state. After you move the pointer over the 1 icon, the following error message is displayed: mgw.service.agent.sAddrPrefixInvalid.

  • Cause

    The prefix of the data address is invalid or no file is found at the data address.

  • Solution
    • Check whether the specified prefix is valid.
    • Make sure that at least one file is stored at the data address.

Case 12: The amounts of data at the source and destination data addresses greatly differ after migration.

  • Problem description

    When you migrate NAS files, the amount of data at the source data address is 5.8 TB, whereas the amount of data migrated to the destination data address is 11 TB. The amounts of data at the source and destination data addresses greatly differ.

  • Cause

    If symbolic links are found at the source data address, the files or directories to which the symbolic links point are migrated to the destination data address. However, the symbolic links are not migrated. This way, the actual amount of migrated data is larger than the estimated amount, and the migration progress is beyond 100%. The actual amount of migrated data prevails.

  • Solution

    Check whether the source contains symbolic links. If so, we recommend that you pause the migration job, process the symbolic links, and then create another migration job.

Case 13: A NAS data address is in the Creating state for more than half an hour.

  • Problem description

    When you create a NAS data address, the data address remains in the Creating state for more than half an hour.

  • Cause

    An error occurs when resources are allocated.

  • Solution

    We recommend that you delete the data address and create a data address again.

Case 14: The "mgw.service.agent.dMountNasFailed" error message is displayed.

  • Problem description

    When you create a NAS data address, the data address enters the Abnormal state. After you move the pointer over the 1 icon, the following error message is displayed: mgw.service.agent.dMountNasFailed.

  • Cause
    This error occurs due to the following possible reasons:
    • The IP address of the ENI used for migration cannot access the NAS file system in the VPC.
    • The prefix of the data address is invalid.
    • If the data that you want to migrate is in a shared folder on an Elastic Compute Service (ECS) instance, the Network File System (NFS) service is disabled or the shared folder on the ECS instance is not available.
  • Solution
    • Check whether access control or security groups are configured for the NAS file system. IP addresses used for migration are dynamic and random. You must authorize all IP addresses in the VPC to access the NAS file system.
    • Check whether the prefix of the data address is valid and whether the path of the shared folder is the same as the subdirectory that you specify for the data address.
    • Check whether the shared folder on the ECS instance is available and whether the NFS service is enabled.

Case 15: A migration job fails.

  • Problem description

    When you migrate data from an OSS bucket in the China (Shenzhen) region to an OSS bucket in the China (Hong Kong) region, the migration job enters the Failed state.

  • Cause

    The network connection between regions in the Chinese mainland and the China (Hong Kong) region is unstable. An error occurs when the network connection times out.

  • Solution

    Create a migration job again in another time period.