Description

When using xDB Data Migration tool 3.0.0 - 4.0.0, 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). The following message can be found 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)

Solution

To resolve the issue:

• For Sitecore XP 9.0.0–9.1.1, upgrade the instance to Sitecore XP 9.2 or Sitecore XP 9.3 before you continue.
• For Sitecore XP 9.2 and Sitecore XP 9.3, do the following:
  1. Download and install the hotfix compatible with your product version on the Content Management/Standalone server:
     • For Sitecore XP 9.2: SC Hotfix 391475-1 Sitecore Data Exchange Framework 3.0.1.zip
     • For Sitecore XP 9.3: SC Hotfix 426890-1 Sitecore Data Exchange Framework 4.0.0.zip
     The hotfix allows configuring xConnect connection timeouts and introduces the 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 the xConnect exceptions are raised, navigate to each of the following items and select the Proceed On Exception check box in each of them:
     • [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.