Content Matrix 9.11 - SharePoint Edition

Activating the License Key Silently

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, FileShare Edition and 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

Question

I have been unable to get 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 try to activate the license for Public Folder Edition, the invalid error will display.)

·Confirm that the license you are installing is for the correct application versions of Content Matrix. Contact Quest to verify that it is. (For example, license keys beginning with 823, 824, and 827 are not compatible with File Share Edition since its reintroduction in version 9.9.)

·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 plicy 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.

Access Denied Errors when Migrating to SharePoint Online

Question

When migrating to SharePoint Online, why do some objects fail to migrate and Access Denied errors are logged?

Answer

For migrations to SharePoint Online, custom scripts are necessary to create a number of objects on the target. As part of an H1 2024 update, Microsoft has disabled the ability to run custom scripts at the root site (site collection) level by default.

For a list of objects that Microsoft has identified as requiring custom scripts, refer to the the "Features affected when custom script is blocked" section in the Microsoft article Allow or prevent custom script - SharePoint in Microsoft 365 | Microsoft Learn.

NOTE: In addition to the list of objects provided by Microsoft, the Quest Content Matrix team has identified additional objects that require custom scripts for migration, which include:

·Access Request Settings

·Setting Group Association

·Publishing Features

In Content Matrix version 9.10.0.3, this issue was bypassed by allowing custom scripts for connection accounts that have Global Administrator or SharePoint Administrator privileges. To resolve this issue:

·Make sure that you have the latest version of Content Matrix Installed.

·Ideally, connect to the SharePoint Online target with an account that is a Global Administrator or SharePoint Administrator.

NOTE: If your only option is to use a Site Administrator account to connect to the target, ensure that a Global Administrator or SharePoint Administrator has allowed custom scripts for the target site collection(s) before performing the migration. (Be aware, however, that when custom scripts are set to Allowed for Site Administrators, the setting is returned to Blocked after 24 hours.)

Errors Connecting to SharePoint 2019 or SharePoint Server Subscription Edition in a FIPS-Enabled Environment

Question

Why am I getting an error when I try to connect to SharePoint 2019 or SharePoint Server Subscription Edition in a FIPS-enabled environment?

Answer

Content Matrix uses some assemblies for FIPS compliance that are not supported for certain SharePoint 2019 and SharePoint Server Subscription Edition connections.  

For a remote object model (MEWS) connection (displays for the top node) for SharePoint 2019:

Client found response content type of 'text/html; charset=utf-8', but expected 'text/xml'. The request failed with the error message: -- <!DOCTYPE html> <html>

For a local object model (OM) connection (displays at the item level for SharePoint 2019 and SharePoint Server Subscription Edition):

The type initializer for 'Microsoft.SharePoint.ApplicationRuntime.SPRequestModule' threw an exception

In addition, errors will display in Browser View and Items View.

The workaround for SharePoint 2019 is to connect using a SharePoint Database connection.  You will not, however, also be able to make an external server connection.  

For SharePoint Server Subscription Edition, you can connect using a database or remote object model (MEWS) connection.