Content Matrix 9.7 - Public Folder Edition User Guide

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, 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

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.

Using Proxies, Load Balancing or Alternate Access Mappings

Question

How does Metalogix Content Matrix deal with environments that use proxies, load balancing and/or alternate access mappings (AAM)?

Answer

Metalogix Content Matrix Console should not run into any issues with these three things. Metalogix Content Matrix uses the Metalogix Extensions Web Service (MEWS), which deploys over a whole farm and functions identically to a regular SharePoint web service. SharePoint web service's get the benefits of IIS redirection, proxy pushing, and anything else that SharePoint can utilize, such as Alternate Access Mappings (AAM). Since the Metalogix Extensions Web Service acts the same as a SharePoint web service it also gets all of these benefits.

In the case for load balanced environments the Metalogix Extensions Web Service would need to be deployed through the target side SharePoint farm. When the Web Service is installed it automatically gets deployed to all the SharePoint instances within that farm, as a SharePoint solution. Once the Web Service is installed on the target server, then load balancing should no longer be an issue.

There are, however, some cases where proxy settings may not work correctly by default. In these cases it is possible to set some specific proxy settings for the specified connection. Please see the Configuring Proxy Settings page for more details.

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.  

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