Edit

Share via

Troubleshoot migration of records

  • Article

Applies to: Dynamics 365 Contact Center—embedded, Dynamics 365 Contact Center—standalone, and Dynamics 365 Customer Service

To troubleshoot any issues that you might face during migration, check the log files as follows:

  • When you import data into the target organization, if you see yellow warning symbols, then check the following logs in the Configuration Migration tool:

    • Login_ErrorLog.log: Provides information about any issues you had when you signed in to the organization using the Configuration Management tool.
    • DataMigrationUtility.log: Provides information about the tasks performed using the tool during the last migration.
    • ImportDataDetail.log: Provides information about the data imported by the tool in the last data import.

    More information: Troubleshoot configuration data migration issues using log files

    Yellow warnings that indicate errors during data import.

  • If the logs contain network errors, then repeat the import process.

    Here's an example:

    Time: 11:46:09 PM
Error: There was no endpoint listening at `https://www.contoso.com/XRMServices/2011/Organization.svc/web?SDKClientVersion=9.2.46.5279` that could accept the message. This is often caused by an incorrect address or SOAP action. See InnerException, if present, for more details.
Stack Trace: Service stack trace:

Revert unmanaged records

If you see a difference in the migrated records between the source and target organizations, then you must delete the unmanaged entity records and repeat the migration process. In the target organization, perform the following steps:

  1. For queues, revert the entities in the reverse order of the serial number (S.No column) that's listed in the migration article at Migrate configuration for record queues. Migrate the entities in this order:

    1. Assignment Configuration Step
    2. Assignment Configuration
    3. Decision ruleset
    4. Decision contract
    5. Queue

  2. For workstreams, revert the entities in the reverse order of their serial number (S.No column) that's listed in the migration article at Migrate configuration for record workstreams. Migrate the entities in this order:

    1. Workstream capacity profile
    2. Routing configuration step
    3. Routing configuration
    4. Decision ruleset
    5. Decision contract
    6. Workstream

    For intake rules, revert the entities in the reverse order of their serial number (S.No column) that's listed in the migration article at Migrate configuration for intake rules. Migrate the entities in this order:

    1. Master Entity Routing Configuration
    2. Decision ruleset
    3. Decision contract

Next steps

  1. Migrate queues
  2. Migrate intake rules
  3. Migrate workstreams

Create a schema to export configuration data
Overview of data migration for records
Use FetchXML query to filter records
Migrate configuration data for records
Verify migration of records
Migrate configuration data for live chat
Migrate configuration data for voice channel