xDB Migration process throws an exception about a canceled task

  • When using the xDB Data Migration tool, Sitecore analytics data might fail to migrate from Sitecore XP 8.x to Sitecore XP 9.x with an unhandled exception. The issue occurs if xConnect does not respond within a certain time (more than 30 seconds by default). You can find the following exception in the log records:

    An error occurred while sending the request. (pipeline: Process Single Contact from MongoDB Pipeline, pipeline step: Add Contact Model to xConnect Batch, pipeline step identifier: 46ebebbf-250f-4bc2-a5f2-e4a64b58e561)
    A task was canceled. (pipeline: Process Single Contact from MongoDB Pipeline, pipeline step: Add Contact Model to xConnect Batch, pipeline step identifier: 46ebebbf-250f-4bc2-a5f2-e4a64b58e561)
  • To resolve this issue, consider the following options:
    • For Sitecore XP from 9.0 Initial release to 9.1 Update-1, upgrade the instance to Sitecore XP 9.2 Initial release before you continue.
    • For Sitecore XP 9.2 Initial release, do the following:
      1. Download and install the following hotfix to the CM/Standalone server:
        SC Hotfix 391475-1 Sitecore Data Exchange Framework 3.0.1.zip.
        The hotfix allows configuring xConnect connection timeouts and introduces a new exception handling.
      2. Increase the xConnect connection timeout by navigating to [your tenant]/Endpoints/Providers/xConnect/xConnect Client Endpoint and setting the value in the Collection Service Timeout field to more than 30, for example 100.
      3. To proceed with migration when xConnect exceptions are raised navigate to each of the following items and in each of them select the Proceed On Exception check box:
        • [your tenant]/Pipelines/MongoDB Contacts to xConnect Migration Pipelines/Process Single Contact from MongoDB Pipeline/Add Contact Model to xConnect Batch
        • [your tenant]/Pipelines/MongoDB Contacts to xConnect Migration Pipelines/Process Single Device from MongoDB Pipeline/Add Device Profile Model to xConnect Batch
        • [your tenant]/Pipelines/MongoDB Contacts to xConnect Migration Pipelines/Process Single Interaction from MongoDB Pipeline/Add Interaction Model to xConnect Batch
        • [your tenant]/Pipelines/MongoDB Contacts to xConnect Migration Pipelines/Read Contacts from MongoDB Pipeline/Submit Remaining Operations in xConnect Batch
        Important: If the exception occurs when submitting a batch, the data is not processed again.

Applies to:

xDB Data Migration Tool 3.0.0

April 21, 2020
April 22, 2020

Reference number:

390116, 390492