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 or Sitecore XP 9.3 Initial release before you continue.
    • For Sitecore XP 9.2 Initial release Sitecore XP 9.3 Initial release, do the following:
      1. Download and install the following hotfix to the Content Management/Standalone server:
        For Sitecore XP 9.2 Initial releaseSC Hotfix 391475-1 Sitecore Data Exchange Framework 3.0.1.zip.
        For Sitecore XP 9.3 Initial release SC Hotfix 426890-1 Sitecore Data Exchange Framework 4.0.0.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. If you need to proceed with the 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 - 4.0.0

April 21, 2020
September 02, 2020

Reference number:

390116, 390492