Chat now with support
Chat with Support

Metalogix Content Matrix 9.2 - SharePoint Edition User Guide

Introduction Entering the License Key Metalogix Content Matrix Console End User Interface Enabling Advanced Mode Connecting to SharePoint Migrating to SharePoint Online Using the Import Pipeline Preparing for a Migration How Content Matrix Handles Various SharePoint Components
How Team Sites are Migrated to SharePoint Online and SharePoint 2019 How Master Pages are Migrated How List Template Galleries Are Migrated How Content Types are Migrated Document Version and Checked Out File Limitations How Ghosted and Un-Ghosted Pages are Migrated How Records Centers are Migrated to SharePoint Online Using the Import Pipeline How Document Sets are Migrated How Navigation is Migrated How MySites are Migrated How Managed Metadata, Terms, and Term Stores are Migrated How "Share With" Metadata is Migrated to SharePoint Online Using the Import Pipeline How Web Parts are Migrated How Site Themes are Preserved How Site Features Are Migrated How Users and Permissions are Migrated How BCS/BDC Data is Migrated How OneNote Notebooks are Migrated How Customized Form Pages are Migrated How InfoPath Forms are Migrated How SharePoint Workflows are Migrated How Nintex Workflows and Forms are Migrated How Link Correction Works
Initiating a Migration Configuring Copying Options Saving or Running a Migration Job Copying SharePoint Objects as a Separate Action Incremental Migration Using PowerShell with Content Matrix
Configuring PowerShell for Use with Content Matrix
Registering Metalogix Command DLL Files Adding PowerShell Snap-Ins for the Application Framework Content Matrix PowerShell Commandlet List
Metalogix.System.Commands Metalogix.SharePoint.Commands Metalogix.Jobs.Reporting.Commands Metalogix.SharePoint.Migration.Commands
Modifying Content Matrix Configuration and Settings Configuring Content Matrix for Distributed Migration Frequently Asked Questions About Us

How Content Matrix Handles Objects Not Supported for Migrations Using the Import Pipeline

By default, when Import Pipeline migration is enabled:

·If a library contains both supported and unsupported objects:

§for optimal performance, supported objects will be migrated first using the Import Pipeline, then unsupported objects will be migrated using CSOM


§objects that are unsupported will be identified as such in the log file.

NOTE: You have the option of overriding the default behavior so that if a library contains both supported and unsupported objects, the entire library will migrate using CSOM.  To do this, change the value of the  key AllowPartialPipelineMigration in the configuration variable file EnvironmentSettings.xml from true to false.

·If a file exceeds the size specified for the key SupportFileSizeInMBUsingMigrationPipeline in the configuration variable file EnvironmentSettings.xml, it will be migrated in chunks using CSOM.

CSOM Migration Limitation

When a CSOM connection is used, while item IDs for other types of lists can be preserved, library document IDs (and by extension, lookup columns, which rely on these IDs)  are not preserved on the target.  Document ID preservation is only supported for objects migrated using the Import Pipeline.

See also Preserving SharePoint List Item IDs with a CSOM Connection Type.

Migrating individual Lists/Libraries Created from Third Party Custom List Templates Using the Import Pipeline

If you want to migrate lists created using a third party custom list template and the Base Template ID is not available in the ListTemplateTypes, do the following:

1.Navigate to ApplicationSettings.xml, located by default in the folder <Drive>\Users\<USER>\AppData\Roaming\Metalogix\Metalogix Content Matrix Console - SharePoint Edition.

2.Open ApplicationSettings.xml in a text editor.

3.Navigate to the ListNamesToIncludeForAzure entry. The default code block is shown below.


4.In the Value element, insert the internal names of the lists and document libraries to be included for Azure migration.

If multiple lists and libraries are provided, they must be separated by the '|' character, as shown below.


5.Save and close ApplicationSettings.xml.

How Content Matrix Determines Import Pipeline Migration Batch Sizes

When migrating using the Import Pipeline, the EnvironmentSettings.xml file includes configurable thresholds for batch sizes in both number of items (200 by default) and size (1000 MB by default).  Content Matrix determines the size of a batch to upload to SPO when the lower threshold is met.

For example:

·If a library has 20 documents, each of which is 100 MB, Content Matrix will use the size threshold and will create two batches of 1000 MB.

·If a library has 1000 documents, each of which is 1KB, Content Matrix will use the item threshold and will create five batches of 200 items.

NOTE:  If more than one version of an item is being migrated, Content Matrix will count each version as a separate item when determining batch size.

Refer to the topic Configuring Settings for Migrations Using the Import Pipeline for  information on changing batch sizes.

Preparing for a Migration

Metalogix Content Matrix offers a number of tools to help you locate and organize data and in preparation for your  migration.  You can:

·Search for SharePoint sites, lists, folders, and/or items/documents that meet criteria you specify

·Preview documents

·Create SharePoint objects

·Delete SharePoint objects

·Compare SharePoint objects on source and target

·Check links

·View StoragePoint details

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating