Chat now with support
Chat with Support

Metalogix Content Matrix 8.9 - SharePoint Edition User Guide

Introduction Entering the License Key Content Matrix Console End User Interface Enabling Advanced Mode Connecting to SharePoint Migrating to O365 Using the Azure Pipeline/SPO Containers Preparing for a Migration How Content Matrix Handles Various SharePoint Components Initiating a Migration Configuring Copying Options Saving or Running a Migration Action Copying SharePoint Objects as a Separate Action Self-Service Migration Incremental Migration Log Files 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 and Self-Service Migration Frequently Asked Questions
DB_Owner Permission Migrating with the Fabulous 40 Templates Item Count Discrepancies Keyboard Shortcuts License Key Troubleshooting Determining the Status of a Migration Running in the Background MySite and User Profile Migration Issues Optimal Setup for Best Performance Using Proxies, Load Balancing or Alternate Access Mappings Troubleshooting the Extensions Web Service Installing the Extensions Web Service on Specific Systems Extensions Web Service Installation Files Using Older Versions of the Extensions Web Service Preserving IDs when Migrating a Custom List as a Folder Migrating JavaScript Migrating Site Variations Migrating with SharePoint Document IDs Changing a Job Configuration for Multiple Files SharePoint 2003 Version Migration Limitations SharePoint 2013 and Later Site Collection Creation Issue Job List Database fails to Load After Upgrade Customized Wiki Page Web Part Zones Not Being Migrated Preserving SharePoint List Item IDs with a CSOM Connection Type Retrying Failed Document Copies to O365 CSOM Connections Migrating Content When the Source Custom List Template is Missing Are SharePoint Online Migrations Throttled? What to Expect when Migrating with StoragePoint on the Target Migration Error Message 'There was an Error Reading from the Pipe: The Pipe has been Ended (109, 0xd6)' How do I Remove Items from My Azure Blob Storage Account? Azure Batches Getting Stuck "Error, the batch will be resubmitted" Message Displays When Using Azure Item Count at Target is Increased When Migrating Using the Azure Pipeline Custom Lists with Versioning Enabled Not Being Migrated When Using the Azure Pipeline Supported Nintex Actions for SPO Migration "Insufficient Credentials" Message Connecting to Modern Team Site Using Web Browser Authentication Error Making a Browser-Based Connection with PowerShell Console Open
About Us

Site Options

If you initiated a migration for a Site Collection or site, complete the Site Options tab (in Simplified mode, Migration Options > Site Options section ) as described below.

Simplified UI icon

Unless otherwise noted, if you are using Simplified mode and an option is not available for selection, the default value that displays in Advanced mode will automatically be applied.  If you want to change the value of the option, click [Advanced Mode] and switch to the Advanced mode interface.

Site Options

NOTE:  If you are copying OneNote Notebooks as part of a site-level migration, thee are some pre-requisites to consider.  See How OneNote Notebooks are Migrated for details.

To configure Site Options:

1.If you are using Advanced mode, initiated a copy at the site level, and want to change the Site Template:

§Select the Change Template box, and

§Select a site template from the drop-down.

NOTE:  This option is not available if you chose to Paste Site Collection or Paste MySites, as the template is selected as one of the Site Collection options.  

2.If you are using Advanced mode and want to rename the site at the target:

§Select the Rename Site option, and

§Enter a New Site Name and New Site Title.

NOTE: The Name is the internal name of the site and cannot include any spaces.  The Title is the display name.

3.If you want to copy all child sites that are under the site or server node being migrated, select Copy Child Sites (recursively).

NOTE:  If you select this option, migration options specified for the parent site will apply to child sites as well.

4.If you are using Advanced mode and want to Copy Content Types, make sure that this box is checked.

NOTE:  When this box is checked, all content types will be copied from the source to the target. You can also copy selected content types as a separate action.

5.If you want to Copy Navigation and (Tree View Settings), select this option.

See also How Navigation is Migrated.

NOTE:  When this option is selected, the settings for the navigation will be copied, not the actual navigation.

6.If you are using Advanced mode and chose to Copy Navigation and Tree View Settings and want to also change the navigation items themselves, check the Copy Navigation Links and Headings box then select the appropriate option.  Use the information in the following table for guidance.

 

Connection icon

When the source connection uses a local or OM, MEWS, or DB adapter and the target connection uses a CSOM adapter, the Quick Launch and Top Navigation Bar options are both migrated, and their related radio buttons on the Site Options tab are disabled.

If you want to copy ….

Select…

both the global navigation and the quick launch navigation.

Copy both the quick launch and the top navigation bar.

Only the quick launch (but not the global navigation)

Only copy the quick launch.

Only the global navigation (but not the quick launch)

Only copy the top navigation bar.

NOTE: It is highly recommended that you select the Link Correction option in the General Options tab, to enable link correction for navigation links.

7.If you want to Copy Site Features, select this option, then select the appropriate option.  Use the information in the following table for guidance.

NOTE: In order for a theme to be properly preserved in a migration, it must exist (be manually installed) on the target server before migration.  See How Site Features are Migrated for more detail.  This option is disabled when migrating from a SharePoint 2003 (SPS 2003 or WSS 2.0) source into a SharePoint 2010 or later target.

If you want to ….

Select…

·preserve any existing features on the target side that are already active, and

·add and activate the features from the source to this list.

Preserve Default Features (on Target).

NOTE: Both the pre-existing features and the features being copied from the source, should be active on the target after migration.

clear any features that are already active on the target before any features are copied over from the source

Clear Default Features (on Target).

NOTE:  Any features on the target that are already active will be stopped and removed, and the features from the source will be copied over and activated to match the source side.

8.If you are using Advanced mode and want to Preserve Themes, check this box then select the appropriate option.  Use the information in the following table for guidance.

NOTE:  In order for a theme to be properly preserved in a migration, it must exist (be manually installed) on the target server before migration.  See also How Site Themes are Preserved

If you want to copy …

Select …

all of the existing source themes over to the target, even if they are not currently in use

Copy All Themes.

the currently used theme on the source over to the target.

Copy Current Theme only.

9.If you are migrating from SharePoint 2003 to SharePoint 2007 or 2010 and want to Copy Portal Listings, select this option.

NOTE:  This option displays only if you are migrating from SharePoint 2003.

10.If you are using Advanced mode and want to Preserve Master Page, check this box.

NOTE:  By default, if the source and target connections are the same version of SharePoint, Metalogix Content Matrix will use the same Master Page on the target, as it exists on the source. If the source side Master Page doesn't exist on the target, the target side will then be set to use its default Master Page.  See also How Master Pages are Migrated

11.If you are migrating from SharePoint 2007 to SharePoint 2010 and want to Preserve 2007 Look and Feel, check this box.  

If the Preserve Themes check box is also checked, any theme that is being used on the source will be preserved instead.

12.If you are using Advanced mode and want to copy any files, folders, and sub-folders from the root of a site to the root of the target site. (for example, if some content (files/folders) has been deployed to the root of the source site) check the Copy Other Root Files/Folders box.

13.If you are using Advanced mode and chose to Copy Other Root Files/Folders and also want to copy any "Uncustomized" or ghosted files that exist on the root of the site, check the Copy Uncustomized Files (Ghosted Files) box.

NOTE:  Ghosted files are files that are not stored in the content database but are read from a definition file instead, and in this case these definition files are stored on the root of the site. These are generally template files. If this option is not selected, Metalogix Content Matrix will instead skip these files when migrating content.  See also How Ghosted and Un-Ghosted Pages are Migrated.

14.If you are using Advanced mode and are going to migrate content using the Azure SPO Migration Pipeline (which provides higher migration speeds compared to non-Azure migration actions) check the Use Azure/SPO Container Office 365 Upload box.

NOTE:  Enable this option only if you are certain that the target environment is set up to use the Azure pipeline.

One of two methods will be used to migrate using the Azure SPO Migration Pipeline:

§If you have not manually set up and configured your own Azure containers, Metalogix Content Matrix will use Azure Shared Containers, which requires that the content (and its manifest) be encrypted.  Therefore, to use this method, the Encrypt Azure/SPO Container Jobs box must also be checked.

§If you have manually set up and configured your own Azure containers, Metalogix Content Matrix will continue to use the manual configuration method until it no longer detects the changes made for the manual setup.  (When using this method, Encrypt Azure/SPO Container jobs, which will encrypt both data and associated manifest) is optional.

For information about manually setting up and configuring Azure containers, see the Metalogix Content Matrix Performance Optimization Guide PDF document included in the installation ZIP file.  

List Content Options

If you want to copy lists as part of the migration, select the List Content Options tab (in Simplified mode, Migration Options > List Content Options section ) and select the applicable options.

Simplified UI icon

Unless otherwise noted, if you are using Simplified mode and an option is not available for selection, the default value that displays in Advanced mode will automatically be applied.  If you want to change the value of the option, click [Advanced Mode] and switch to the Advanced mode interface.

List Options

NOTE:  Depending on the level at which the migration was initiated, and whether you are migrating to a SharePoint on premises or Online  target, options may vary.

Migrating Large Files

Metalogix Content Matrix can migrate large files up to the maximum size supported by the SharePoint version on the target.  

Connection icon

The migration of large files is supported for a Local or Remote (MEWS) Object Model, CSOM, or SharePoint Database (DB) source connection and a SharePoint 2016/2019/SharePoint Online CSOM target connection.

 

If Metalogix Content Matrix encounters a file over a certain size threshold (200 MB by default), it migrates the file in chunks (of 100 MB by default).

IMPORTANT:  If a large file is being migrated in chunks and you cancel the migration before the entire file has been migrated, the file will be incomplete on the target and will remain in a checked out state.  You will need to re-migrate any affected file(s).

To configure List Content Options:

1.If you initiated a site collection or site level migration, make sure the Copy (all) Lists (and Libraries) option is selected.

2.If you are using Advanced Mode, initiated the migration of a single list, and want to rename the list at the target:

a)Check the Rename List box.

b)Click the [...] button to display the Rename List dialog.

c)Enter the new list name and/or the list title.

Rename List

3.If you are using Advanced mode and want folders and sub-folders to be copied recursively, down through any existing levels of a site, list, or item copy operation, make sure the Copy Subfolders recursively box is checked.

NOTE:  Make sure this box is checked if you are migrating OneNote Notebooks.  See How OneNote Notebooks are Migrated for prerequisites and special considerations.

4.If you want Form pages that have been customized using SharePoint Designer (SPD) to be migrated, make sure the Copy Customized Form Pages box is checked.

NOTE: When selected, this option will force Copy Web Parts on Form Pages option to be selected on the Web Parts Options tab, because web parts must be copied if migrating Form page customizations. See How Customized Form Pages are Migrated for requirements and limitations.

5.If you are using Advanced mode and want to Copy List Items and Documents, make sure this box is checked.

NOTES:  

§This option does not apply if you initiated a migration at the item level.

§This option must be selected if you want to migrate Document Sets.

6.For lists and libraries that have versioning enabled, if you want to Copy Versions for Items and Documents, select the appropriate option.  Use the information in the following table for guidance.

NOTE:  The option you select also applies for snapshots (versions) of any Document Sets being migrated.

If you want to copy ….

Then …

all existing versions of an item or document

select Copy all Versions.

a specified number of versions of an item or document

·select Copy [number] most recent Versions, and

·select the number of versions you want to keep.

NOTE:  This number includes both major and minor versions.

NOTE:  For more information and limitations, see Document and Item Version Limitations.

7.If you are using Advanced mode and want content types to be applied to SharePoint lists, libraries, and items during a migration:

a)Check the Apply new content types during copy box.

b)Follow the instructions in the topic Applying Content Types Lists and Libraries.

8.If you are using Advanced mode and want libraries, folders, or document libraries to be migrated as a SharePoint document set:

a)Check the Apply new document sets during copy box.

b)Follow the instructions in the topic Applying Document Sets to Libraries, Folders, or Documents.

NOTE:  Metalogix Content Matrix automatically migrates existing document sets in SharePoint 2010 and later.  See How Document Sets are Migrated for requirements and limitations.

9.If you are using Advanced mode, are migrating within the same version of SharePoint, and want any un-ghosted Publishing pages  from the source to be ghosted on the target, check the Reattach Publishing Page Layouts box.

NOTES:  

§If you are migrating to a different version of SharePoint, this option will be checked and disabled as Publishing pages will always be re-ghosted on the target

§For more information on this option, see How Ghosted and Un-Ghosted Pages are Migrated.

10.If you want to preserve IDs for any folders and items in SharePoint lists, so each item and folder will have the same ID on the target as it does on the source, make sure the Preserve IDs on items/folders in Lists on the target option is selected.

NOTES:

§If this option is not selected then SharePoint will assign an item ID automatically.

§This option is used for Incremental Migrations, and does not apply to Document Libraries.

§For more information on incremental copying and preserving IDs, see Preserving SharePoint List IDs with a CSOM Connection Type.

11.If you want to Preserve IDs on items/folders in Document Libraries (in Simplified mode, Preserve IDs for Library Content), select this option.

NOTES:  

§This option is used for an Incremental Migration and only includes SharePoint Document Libraries, not Lists.

§This option is different from the Preserve SharePoint Document IDs option..  For more information on this feature, please contact Quest Support.

12.If you want Metalogix Content Matrix to disable the normal document parsing methods for SharePoint in order to fetch all of the metadata properties for files:

§if you are using Advanced mode, check the Disable SharePoint Document Parsing box.

§If you are using Simplified mode, de-select the Scan Office Docs for Additional Metadata option.

NOTES:

§This option is only required in some very specific cases. In some cases customer document parser may be used on the source SharePoint instance, or there may be some heavily customized metadata creation that can affect a normal migration. These cases are usually determined by a special error message when migrating documents ("Unable to update the information in the Microsoft Office document").

§This option affects all items within the scope of the migration. If the Preserve Configuration Options (in the Settings tab of the ribbon) are enabled, this option will need to be turned off for any subsequent migrations if you no longer want the SharePoint document parsing methods to be disabled.

CAUTION:  Disabling the SharePoint document parsing methods can potentially cause issues if migrating InfoPath forms.

13.If you are using Advanced mode, are migrating from SharePoint 2010 or later, and want to preserve the values in the Document ID field that is enabled with the Document ID Service feature (which must be activated at the Site Collection level on the target), check the Preserve SharePoint Document IDs (Requires SharePoint Crawl) box.

NOTES:  

§If you select this option and the Document ID Service feature is not activated on the target site collection, a warning message will display informing you that you will not be able to use this option.  If you enable the feature after initiating the migration, you will need to refresh the connections before continuing.

§Please see the Migrating with Document IDs FAQ for more details on the differences between the item and folder IDs (in the ID field) and Document IDs (in the Document ID field).

14.If you want to migrate to a SharePoint Online target using the Azure SPO Migration Pipeline, select the applicable option:

§Use SharePoint Online Migration API (if using Simplified mode)

§Use Azure/SPO Container Office 365 Upload box (if using Advanced Mode)

NOTE:  Enable this option only if you are certain that the target environment is set up to use the Azure pipeline.

One of two methods will be used to migrate using the Azure SPO Migration Pipeline:

§If you have not manually set up and configured your own Azure containers, Metalogix Content Matrix will use Azure Shared Containers, which requires that the content (and its manifest) be encrypted.  Therefore, to use this method, the Encrypt Azure/SPO Container Jobs box must also be checked.

§If you have manually set up and configured your own Azure containers, Metalogix Content Matrix will continue to use the manual configuration method until it no longer detects the changes made for the manual setup.  (When using this method, Encrypt Azure/SPO Container jobs, which will encrypt both data and associated manifest) is optional.

For information about manually setting up and configuring Azure containers, see the Metalogix Content Matrix Performance Optimization Guide PDF document included in the installation ZIP file.  

Applying Content Types to Lists and Libraries

Metalogix Content Matrix can apply content types to SharePoint lists and libraries, and can also map items in lists to the newly applied content types (or map new items in a list to an existing content type).

Advanced Mode Icon These options are only available when Advanced Mode is enabled.

This option can be useful when migrating a list and applying a new content type to that list and its items. Another example would be if items are being copied from the source site to a different existing list on the target, and a different content type needs to be applied to those items.

When the [...] button is clicked from the List Content Options tab , one of the following dialogs displays:

· Apply Content Types to Lists (if migrating a site)  

Apply Content Types to Lists

NOTE:  Any existing mappings display in the bottom section of the dialog.

OR

·Content Type Application Options dialog (if migrating a list or items).

Content Type Application Options

To apply content types to a list or library:

1.In the dialog's top section, use the explorer tree view window to navigate to, and select, the list or library that the content type(s) will be applied to.,

2.Either:

§ click the Apply Content Types to Selected List button at the top of the dialog. to display the Content Type Application Options dialog.

OR

§use the Apply Content Types via Rule option to display the List Filter Conditions window, and apply filter expressions.  

Note that the left From the left (Content types on target site) window lists all of the available content types that exist on the target SharePoint instance.

Content Type Application Options

4.From Content types on target site window,  select all the desired content types you want to be applied to the selected list, and move them to the right (Content types to apply) window.

5.Select any of the remaining options that you want to apply.  Use the information in the following table for guidance

If you want to ...

Then ...

map a content type column on the source to a column on the target, as the new content type column

A.Check the Map source data to new content type columns box.

B.Click the [...].] button to display the Edit Column Mappings dialog.

C.Continue with the procedure for Mapping Columns.

map items from the source into a new content type on the target based one or more specified filters

A.Check the Map source data to new content type columns box.

B.Click the [...] button to display the Map Items to Content Types dialog.

C.Continue with the procedure for Mapping Items to Content Types.

NOTE:  This option is available only when migrating Exchange folders (not individual items).

change the default content type  for the target list or library

A.Check the Change default content type box

B.Select a content type from the drop-down.

NOTE:  When you check this box, the Add unmapped items to the default content type is automatically enabled and checked.

Mapping Items to Content Types

You can specify content types for target items when you click the [...] button from the Content Type Application Options dialog.

To map items to content types:

PF Map Items to Content Types

1.Select the content type, and click [Edit Conditions] to display the List Items and Documents Where filter dialog.

2.Select the filter(s) you want to apply as you would when Applying Filter Expressions.

NOTE:  If you select [Clear Condition], all conditions that are currently applied to that content type will be cleared.

3.Once all filters have been set, click [OK] to return to the Content Type Application Options dialog.

Related Documents