Chat now with support
Chat with Support

Metalogix Content Matrix 8.9 - 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 Configuring Content Matrix for Distributed Migration Frequently Asked Questions About Us

Connecting to Atom Feed

Atom feed is a new syndication format that is supported by most of the social platforms. Atom feed has a very user-friendly xml structure which makes it easily adoptable for most applications. However, syndication technology in general is mainly created to provide another mechanism to deliver fresh content to end-users, which means that this connection type does not handle older content. For more information, see Known Limitations, below.

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

For supported versions of Atom feed, see Supported Source Systems.

Known Limitations

Feeds are governed by the source Content Management System (CMS). By default, most social CMS return only the most recent 25 items. Please check if any alternative connections are viable before connecting using this connection type.

After a connection has been made to the Atom Feed source, there are some scenarios where default limitations are placed on the connection. However, Blogs and Wikis Edition can sometimes work around these issues by editing the connection settings.

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.

Atom Feed connections do not support permissions or page/document version migration.

To connect to Atom Feed:

1.In the Metalogix Content Matrix Console ribbon, chose Connection > Connect to Atom Feed to display the Connect to Feed dialog.

BW Connect to Atom Feed

2.In the Server Address field, enter the URL to connect to Atom Feed.

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 different credentials  allows you to specify a set of User credentials to use when connecting to Atom Feed.  

If the Use different 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.In the Server Address field, enter the desired URL value to connect to Atom Feed.

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

Connecting to RSS Feed

Metalogix Content Matrix Console - Blogs and Wikis Edition can migrate content from RSS feeds into SharePoint. RSS feeds support incremental migrations.

NOTE:  All RSS feeds are supported.

Known Limitations

In addition to the same limitations as the Atom feed format, when migrating content from a RSS Feed connection (or a MetaWeblog connection), 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.

NOTE:  RSS Feed connections do not support permissions or page/document version migration.

To connect to RSS Feed:

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

BW Connect to Atom Feed

2.In the Server Address field, enter the full URL of the RSS feed you want to connect to.

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 different credentials  allows you to specify a set of User credentials to use when connecting to RSS Feed.  

If the Use different 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.

NOTE:  Some RSS feeds do not require any credentials for a connection, so the migrating user's basic information is enough. However, there may be some cases in which you will need a specific set of user credentials in order to create a connection.

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

3.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 Other Blogs

Metalogix Content Matrix Console - Blogs and Wikis Edition currently supports any blogs or Wikis that support MetaWeblog API via the XML-RPC protocol. This remote protocol is most likely available, but you should check with the blog platform's administrator to ensure that the remote protocol is available and enabled before use.

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.

MetaWeblog connections do not support permissions or page/document version migration.

After a connection has been made to the Other Blogs 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 other blogs:

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 MetaWeblog.

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 a blog.  

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.

Editing Connection Settings

After a connection to a source Blog or Wiki has been made in Metalogix Content Matrix, it is possible to edit some of the connection settings to specify the number of pages to fetch, the number of comments to fetch, etc. However, not all source connections have this set of options available to it. In the case of a Confluence source, this feature will open a keep-alive time dialog instead. There are no additional connection settings for any MediaWiki connections.

NOTE:  The Edit Settings option for the source connections are only available at the root source connection node. This option will not be available for a sub-site or page connection.

To edit connection settings:

1.In Explorer View, select the root source node of the blog or Wiki site.

2.Right-click and choose Edit Settings.

Depending on the source connection one of the following dialogs displays.

MetaWeblog Settings

Blogs and Wikis MetaWeblog Settings

·Number of recent posts to fetch - This field specifies the number of pages/posts to fetch when connecting to the source. By default most source Blog or RSS feed connections will only fetch the latest 25 posts. This setting will supersede the default setting (in most cases), and will try to return all of the results that exist, increase the specified limit.

·Batch size of posts to fetch per request - This field specifies the number of pages/posts to fetch from the source for each "call" that is made to the source connection. In some cases a source environment may have a limitation to only return a limited number of pages/posts each time a request call is made for them. This option will allow you to specify the number of pages/posts that should be returned per each call, up to the page/post limit that is specified above the Number of recent posts to fetch option. In some cases this option can have a potential impact on migration performance. This is because it would take longer to fetch 1000 pages/posts if they can only be returned 10 at a time, then if you try to return the results 150 at a time. However, there are some cases where fetching all of the results at once could also slow things down, since you would have to wait for all of the data to be fetched before anything could be done, and in large source environments this could cause other issues, including timeouts.

·Number of recent comments to fetch - This field specifies the number "comments" to try and fetch from the source. Metalogix Content Matrix will try to fetch all of the comments up to the number value that is set.

Confluence Settings

Blogs and Wikis Confluence Settings

·Enable connection keep-alive functionality -When this box is checked, the amount of time that the connection can remain open will be overridden.  

·Keep-alive frequency (milliseconds) - When the Enable connection keep-alive function is checked, you can specify the number of milliseconds that will pass before Metalogix Content Matrix will make calls back to the Confluence source, to try and keep the connection open and active.

 

Related Documents