Chat now with support
Chat with Support

Metalogix Content Matrix 8.8 - Blogs and Wikis Edition User Guide

Introduction Entering the License Key Content Matrix Console End User Interface Source Blog and Wiki Structure Connecting to a Source Blog or Wiki Connecting to SharePoint Preparing for Your Migration Initiating a Migration Configuring Copying Options Saving or Running a Migration Action Running Link Correction as a Post-Migration Task 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.Blog.Commands
Modifying Content Matrix Configuration and Settings Frequently Asked Questions About Us

Creating a Google Service Account

In order to connect to Google Drive, you will need to enter the Service Email, Secret, and Private Key File field values into the Connect to Google Drive (Business) dialog box. These items make up the credentials of the service account required to authenticate with Google Drive. This section will review how to create the service account and grant access service account access to the required APIs.

To create a Google service account:

1.Login to the Google Developers console at https://console.developers.google.com/project.

2.Create a new project.

Google Create Project

3.Expand APIs & auth in the left hand pane and select APIs.

Google Project APIs

4.Turn on the following APIs:

·Drive API - For accessing drive content.

·Admin SDK - For assigning users list.

Google Enabled APIs

5.Select Credentials from the left pane.

Google Project Credentials

6.Under the OAuth section, click [Create new Client ID].

Google 0Auth

7.Select Service Account and then click [Create Client ID] to generate your Private Key Password.

Google Project Create Service Account

NOTE:   This is the key that you will enter in the Secret field when connecting to your Google Business Account in Metalogix Content Matrix.

8.Once you have recorded the Private Key password, click [Okay, got it].

Google Public Private Key Generated

You will now be directed to a list of service account information.

9.Copy and paste the Client ID number and the Email Address into a text document as they will be needed in the following steps.

Google Prject Client ID

NOTE:  The Client Id is required to grant service account access to the corresponding APIs.  The Email Address is the Service Email required when connecting to your Google Business Account in Metalogix Content Matrix

8.Generate a new P12 Key file by clicking [Generate new P12 key].

9.Save the file where you can easily find it, as you will need to browse for the file in the Private Key File section when connecting to your Google Business Account in Metalogix Content Matrix.

To grant a Google  Service Account Access to the required APIs:

1.Login to https://admin.google.com with an administrator user account.

2.Click on the Security application.

Google Project Security

3.Click [Show more] at the bottom and select Advanced Settings.

Google Project Advanced Settings

4.Select Manage API client access.

Google Project Manage API Client Access

5.Paste the Client ID you copied when you created the service account into the Client Name field.

6.Copy and paste the following scopes into the One or More API Scopes field: https://www.googleapis.com/auth/admin.directory.user.readonly and https://www.googleapis.com/auth/drive.readonly.

7.Click [Authorize].

Google Project Authorize

Connecting to MediaWiki

MediaWiki is a web base Wiki Content Management System (CMS). Metalogix Content Matrix Console - Blogs and Wikis Edition currently supports MediaWiki versions 1.12 and later.

Known Limitations

·When migrating pages from a MediaWiki source, pages will not migrate if any of the following characters are in the page title: { } [ ] ? / ^ < > #.

·MediaWiki redirect pages are neither displayed nor migrated because there is no equivalent concept that they can be mapped to in SharePoint.

To connect to MediaWiki:

1.In the Metalogix Content Matrix Console ribbon, choose Connection > Connect to MediaWiki to display the Connect to MediaWiki dialog.

BW Connect to MediaWiki

2.In the Server Address field, enter the  URL you want to use to connect to MediaWiki.

3.Select the appropriate Credentials option(s):

§Use default Windows credentials is only required if there is an extra layer of authentication on the web server. Enabling this check-box will pass the currently logged in user's Windows authentication credentials to the web server.

Currently, only Windows authentication is supported for this extra layer of user authentication at the web server level.

§Use MediaWiki credentials  allows you to specify a set of User credentials to use when connecting to a MediaWiki CMS.  

If the Use Mediawiki credentials box is not checked, no credentials will be used when trying to establish a connection unless the Use default Window credentials check-box is checked, in which case the logged in user's Windows credentials will be used instead.

If the Save password box is checked, the provided password will be encrypted and stored.

4.If a Proxy is being used in the Confluence environment, switch to the Proxy Settings tab and set any desired Proxy settings.

5.After the desired connection settings are made, click [OK] to add the connection.

Connecting to WordPress

Metalogix Content Matrix Console - Blogs and Wikis Edition connects to WordPress via the XML-RPC protocol. This remote protocol is available out-of-the-box with WordPress, but the administrator may need to enable remote access before use.

NOTE: This connection type is Hidden by default, and New connections can only be made if the Connect to WordPress button is available in the Ribbon menu. Please see Showing and Hiding Connection Adapter Buttons in the Ribbon Menu.

Known Limitation

After a connection has been made to the WordPress source, there are some scenarios where default limitations are placed on the connection. For example, in some cases, only 25 pages/posts can be fetched from the source by default. However, Metalogix Content Matrix can sometimes work around these issues by editing the connection settings.  For more information, see Editing Connection Settings.

To connect to WordPress:

1.In the Metalogix Content Matrix Console ribbon, select Connection > Connect to WordPress to display the Connect to WordPress dialog

BW Connect to WordPress

2.In the Server Address field, enter the desired URL value to connect to MetaWeblog.  

If you are using a hosted version of WordPress, you will need to change http:// to https://

NOTE:  If the suffix "//xmlrpc.php" is missing from the address, Metalogix Content Matrix will automatically append it.

3.Select the appropriate Credentials option(s):

§Use default Windows credentials is only required if there is an extra layer of authentication on the web server. Enabling this check-box will pass the currently logged in user's Windows authentication credentials to the web server.

Currently, only Windows authentication is supported for this extra layer of user authentication at the web server level.

§Use WordPress credentials  allows you to specify a set of User credentials to use when connecting to a blog.  

If the Use WordPress  credentials box is not checked, no credentials will be used when trying to establish a connection unless the Use default Window credentials check-box is checked, in which case the logged in user's Windows credentials will be used instead.

If the Save password box is checked, the provided password will be encrypted and stored.

4.If a Proxy is being used in the Confluence environment, switch to the Proxy Settings tab and set any desired Proxy settings.

5.After the desired connection settings are made, click [OK] to add the connection.

 

 

Connecting to Tellgent

Metalogix Content Matrix Console - Blogs and Wikis Edition connects to Telligent via the XML-RPC protocol. This remote service is available out-of-box with Telligent but the administrator may need to enable remote access before use.

Metalogix Content Matrix Console - Blogs and Wikis Edition currently supports any versions of Telligent that support the XML-RPC API.

Known Limitations

NOTE: When migrating content from an Atom Feed or MetaWeblog, you will be unable to migrate images that are included in the migrating content. The image migration will fail with a "403 Forbidden" message due to authentication issues with the API, even if the migrating user account has all required permissions. However, there are some cases in which the images will still migrate, but lose some their metadata.

There is a workaround method that can be used to help migrate images and all of their metadata. This workaround is to make the source blog accessible without authentication for the duration of the migration. This will allow the images to be accessed without encountering the authentication issue. Once the migration is complete, the authentication can be reinstated.

After a connection has been made to the Tellgent source, there are some scenarios where default limitations are placed on the connection. For example, in some cases, only 25 pages/posts can be fetched from the source by default. Sometimes Metalogix Content Matrix can work around these issues by editing the connection settings. For more information, see Editing Connection Settings.

To connect to Tellgent:

1.In the Metalogix Content Matrix Console ribbon, select Connection > Connect to MetaWeblog to display the Connect to MetaWeblog dialog

BW Connect to MetaWeblog

2.In the Server Address field, enter the desired URL value to connect to Tellgent.

NOTE:  If the suffix "//xmlrpc.php" is missing from the address, Metalogix Content Matrix will automatically append it.

3.Select the appropriate Credentials option(s):

§Use default Windows credentials is only required if there is an extra layer of authentication on the web server. Enabling this check-box will pass the currently logged in user's Windows authentication credentials to the web server.

Currently, only Windows authentication is supported for this extra layer of user authentication at the web server level.

§Use MetaWeblog credentials  allows you to specify a set of User credentials to use when connecting to Tellget.  

If the Use MetaWeblog  credentials box is not checked, no credentials will be used when trying to establish a connection unless the Use default Window credentials check-box is checked, in which case the logged in user's Windows credentials will be used instead.

If the Save password box is checked, the provided password will be encrypted and stored.

4.If a Proxy is being used in the blog environment, switch to the Proxy Settings tab and set any desired Proxy settings.

5.After the desired connection settings are made, click [OK] to add the connection.

Related Documents