Chat now with support
Chat with Support

Metalogix Content Matrix 8.8 - SharePoint Edition User Guide

Introduction Entering the License Key Content Matrix Console End User Interface Enabling Advanced Mode Connecting to SharePoint 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 2010/2013/2016 Document IDs Changing a Job Configuration for Multiple Files SharePoint 2003 Version Migration Limitations SharePoint 2013 and 2016 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 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

Modern Team Site Options

If you initiated an SPO modern team site migration, select the Modern Team Site Options tab (in Simplified mode, Migration Options > Modern Team Site Options section).

Modern Team Site Options

Specify the Site Name, Group Email Address, and Privacy Settings as you would if you were creating a modern team site in SharePoint Online.

Modern Team Site Creation SHAREPOINT

NOTE:  The Office 365 group e-mail will be automatically generated with the same name as your team site.

MySite Options

If you initiated a MySite migration, select the MySite Options tab and specify the options described below.

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

MySite Options

NOTE: The Available MySites section of the MySite Options tab will only display MySite Site Collections that are using a MySite template (such as SPSPERS#0) and that the current user account has access to. Any MySites that do not meet these requirements will not be displayed. It is also possible that a MySite might not appear because it has run into a timeout issue, but if a Refresh is done for the server, the MySite may then be displayed.

Because language packs are not included in the migration action, the base language setting of the MySite being migrated must already be installed on the target environment. If it is not, an error message containing the language code of the missing language pack will be displayed.

To configure MySite Options:

1.From the MySite Target Web Application drop-down, select the Web application in the target environment into which you want to migrate the MySites.

NOTE: When selecting a web application to use for the migration be sure that the selected target web application contains the MySite host site collection (the site collection that hosts all the MySites). If it doesn't then you won't be able to link the user profile to the site collection. However, different managed paths under the same web application will link the user profiles.

2.For MySite Target Managed Path, select the managed path (which already exist on the target server) that you want to use for the MySite from the drop-down.

In most cases you can select between /sites/ and /my/personal/ for the path, provided these exist in your environment:

§Any sites pasted with the /sites/ option will be displayed as "[Server Name]/sites/[MySite Name]."

§Any sites pasted with the /my/personal/ option will be displayed as "[Server Name]/my/personal/[MySite Name]."

3.From the Available MySites panel, move the MySites you want to migrate to the MySites to Copy panel.  To remove a MySite from the copy action, move it from the MySites to Copy panel back to the Available MySites panel.  

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 higher 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 Including Powershell 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/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 higher.  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 higher, and want to preserve the values in the Document ID field that is enabled with the Document ID Service feature (which must be enabled at the Site Collection level), check the Preserve SharePoint Document IDs (Requires SharePoint Crawl) box.

NOTES:  

§SharePoint document IDs are slightly different from IDs on items and folders. These SharePoint Document IDs are part of a new feature beginning with SharePoint 2010.

§This check-box will only be enabled when migrating from a SharePoint 2010 or higher source

§Please see the Migrating with Document IDs  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 Including Powershell PDF document included in the installation ZIP file.  

Related Documents