Chat now with support
Chat with Support

Metalogix Content Matrix 9.4 - SharePoint Edition User Guide

Introduction Activating the License Key Selecting the SQL Database You Want to Connect to Content Matrix Console End User Interface Enabling Advanced Mode Connecting and Migrating Account Requirements Multilingual Support Connecting to SharePoint Preparing for a Migration How Content Matrix Handles Various SharePoint Components
How Team Sites are Migrated to Modern Team Sites How SharePoint Sites are Migrated to Modern Communication Sites How MySites are Migrated How "Share With" Metadata is Migrated to SharePoint Online Using the Import Pipeline How Records Centers are Migrated to SharePoint Online Using the Import Pipeline 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 Document Sets are Migrated How Navigation is Migrated How Classic Web Parts are Migrated How Site Themes are Preserved How Site Features Are Migrated How Managed Metadata is 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 Metalogix StoragePoint Content is Migrated How Link Correction Works
Initiating a Migration Configuring Copying Options Saving or Running a Migration Job Copying SharePoint Objects as a Separate Action Converting Classic Pages to Modern Pages After a Migration Configuring Hub Sites Incremental Migration Using PowerShell with Content Matrix
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

Activating the License Key Silently

Navigation:  Frequently Asked Questions >

Activating The License Key Silenty

Question

I would like to activate my license outside of the Content Matrix Console.  Is that possible?

Answer

You can activate your Content Matrix license using PowerShell.  Follow the steps below.

NOTE:  This method can only be used for online activations.

1.Open the Content Matrix PowerShell Console.

2.Run the following cmdlet, which includes specifying the Content Matrix Console Edition for which you want to activate the license.

if (Get-Command Set-MetalogixJobPrerequisites -ErrorAction SilentlyContinue){ Set-MetalogixJobPrerequisites -Value "Content Matrix Console - <Edition_name>" }

 

NOTE:  Valid values for <Edition Name> are SharePoint Edition, eRoom Edition, Public Folder Edition.  If you license covers more than one Edition, it is only necessary to activate one.  The license activation will automatically be applied to any other Edition for which you are licensed.

3.Run the Set-MetalogixLicense cmdlet.  Note that additional parameters are required if a proxy server is used.

Without proxy server:

Set-MetalogixLicense -Key "<license_key>"

 

With proxy server:

Set-MetalogixLicense -Key "<license_key>" -ServerUrl "<proxy_server_IP_addres>" -Port "<proxy_port_number>" -UserName "<user_account>" -Password "<password>"

 

NOTE:  When entering the license key, include hyphens.

License Key Troubleshooting

Navigation:  Frequently Asked Questions >

License Key Troubleshooting

Question

I have been unable to get Metalogix Content Matrix to recognize my license key. When I copy and paste it into the box, I get a "the specified license key is invalid" error.

Answer

Here are some things to check:

·Make sure that the license covers the product edition.  (For example, if you are licensed for SharePoint Edition and Public Folder Edition and try to activate the license for eRoom Edition, the invalid error will display.)

·Confirm that the license you are installing is for the correct application versions of Metalogix Content Matrix. Contact Quest to verify that it is.

·When performing an offline key activation, make sure to enter the long key in its entirety, including the "=" symbol at the end of it.

·Verify that you have write privileges to the registry. The installer will fail if the registry is locked. In some cases there may be a group policy that is preventing the user from adding the key in the registry, despite the user having the correct permissions.

·Some versions of Windows will automatically block write access to the registry under the user account, even if that account has write access to the registry. In this case you can go to the application installation folder, right click on the application .exe file, and choose 'Run as Administrator'. Then re-enter the license key.

Determining the Status of a Migration Running in the Background

Navigation:  Frequently Asked Questions >

Determining the Status of a Migration Running in the Background

Question

Is there a way to determine what the status is for a migration that is running in the background?

Answer

Yes, this can be done. This is more of a workaround method that should achieve the same results.

For this method to work users must create a new batch file for the job list, and store it in a commonly accessible area on the file system. Give this job list the same name as the one that is, or will be, running in the background. After the main job is running in the background, the new job file can be opened in any users instance of Metalogix Content Matrix. When the new job is opened, users will be given a snapshot view of the job in progress (this is not a real-time update).

For example, let's say that a job file called "Big Job" is running in the background, and another user wants to determine the progress for this job. They would create a new Job file, and call it "Big Job" to match the existing (running) job and then place that file in a commonly accessible area on the file system. Next, they would open this new job file (the copy) in their instance of Metalogix Content Matrix. This should give the user a snapshot view of the original "Big Job" migration, in process, as it continues to run in the background.

Users can use this method to quickly determine how far along the migration is, and it's status.

MySite and User Profile Migration Issues

Navigation:  Frequently Asked Questions >

MySite and User Profile Migration Issues

Question

I am having issues migrating MySites, more specifically the User Profiles that are associated with MySites. What could be causing this issue, and is there a solution for it?

Answer

In most cases Metalogix Content Matrix can migrate MySites along with the User Profile data, however, there are cases in which this data may have trouble migrating across.

MySites can use one of four possible naming conventions in the MySite host, and these naming conventions can affect how MySite and User Profile data can be returned. These naming conventions are:

·Domain_Username - This naming convention requires that the MySite name needs to be specified as the same name for the user who it belongs to. The Domain_Username format is used to name the MySite. For example if user User_1 had a MySite, the MySite would be named User_1.

·Unknown - The naming convention for this type is an unknown format. As a result all Metalogix Content Matrix can return is the information we get from the SharePoint Object Model (OM). This format is returned if end users have modified the naming convention to a custom format. This is usually the naming convention that causes the most issues.

·Username_CollisionsDomain - This naming convention uses a User name format (and not a Domain_Username format). When migrating MySites, Metalogix Content Matrix will use the Domain_Username format if a MySite with the User name (under the User name format) already exists.

·Username_CollisionError - This naming convention will be used if the Username_CollisionsDomain format is being used and an exception is thrown because a site with the same user name already exists.

In the case of the Unknown naming format, Metalogix Content Matrix may not be able to preserve the naming convention, in which case the migration of the MySite should fail.

In this type of situation there is a workaround method that users can use. Instead of migrating the MySite as a MySite, you can migrate it as a regular SharePoint site collection (to any target location). Once this is done you can then manually link the User Profile to the appropriate site collection or site.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating