Content Matrix 9.10 - File Share Edition

Permissions Options

With respect to SharePoint migrations, it is important to keep in mind that there are three different aspects of permissions to be considered:

·Roles - These are also known as permission levels, and are a collection or rights that can be assigned. In SharePoint it is possible to create custom permission levels (or custom roles).

·Securable Objects - These are basically permissions or rights that can be assigned to an object in SharePoint. Only users or groups that have the same level of permissions or higher can access the content holding these permissions.

·Principals - These are permission roles that are assigned to a user or group. In order for a user or group to have access to a securable object, they would need to have the same permission rights or higher as the permissions on the object. Users can also have access to secured object if they are a part of a group that has access through its assigned permission level.

Content Matrix can migrate the Principals, but is currently unable to migrate SharePoint Roles or Securable Objects.

In the migration process Content Matrix does not actually create any permissions, but instead it maps the roles between the File Share source and the SharePoint target using its Permissions Mapping dialog. Any permissions that are not included in permissions mapping will not be migrated to the SharePoint target environment.

NOTE:  If you want to use a custom role on the target you must add it to the target before migrating permissions. However, this does not guarantee that it will be used. If another role on the target has a closer match with the permission from the source, it will be used instead.

To configure Permissions Options:

1.To enable all user and permissions migration options, including the ability to edit users and any user mappings that have been configured, check the Migrate users using explicit user mappings box.

2.If you want to explicitly map source users to users in the target SharePoint object, click [Edit Users] and follow the instructions for Mapping Users.

3.If you want to explicitly  map source file system permissions to target SharePoint permissions:

a)Check the Migrate permissions using explicit permission mapping box, and:

b) Select the applicable option.  Use the information in the following table for guidance.

c)Click [Edit Permissions] and follow the instructions for Mapping Permissions.

4.If you want Content Matrix to compare permissions on the source with the available permission levels on the target and automatically map permissions that are not explicitly mapped, check the Migrate permissions auto-mappings box.  Permissions will be mapped as follows:

Mapping Users

You can set user and group mappings for migrating content when you click the [Edit Users] button from the Permissions Options tab. This allows you  to preserve authorship metadata as well as help integrate the File Share users with the SharePoint permissions model. In some cases, it is possible for users to be automatically imported into the SharePoint environment, however, this is only possible if the File Share source and the target SharePoint environment are working from the same Active Directory (AD). If this is not the case, then users would need to be mapped into SharePoint user accounts on the target, and these accounts must already exist in order for them to be mapped from the source.

NOTE:  If the Author or Editor of any file to be migrated is Builtin\Administrators or BuiltIn\Users, you must explicitly map the account to a user account in SharePoint for permissions to be applied on the target. (There is no SharePoint equivalent to a BuiltIn account, so if it is not explicitly mapped it will not be recognized as a valid user and permissions will not be applied.)

All user mappings are globally set, so once a mapping is created it will always be used unless removed.

NOTE:  Mappings are saved as separate .MLM files, and the mappings are specific to the particular mapping dialog (Field Types, Users, or Permissions.) they were saved from.

To map users:

NOTE: Content Matrix supports many-to-one (n:1) user mappings between source and target.

1.From the File drop-down at the top of the Active Directory Principal to SharePoint Principal Mappings dialog, choose the appropriate option.  Use the information in the following table for guidance.

2.Use the information in the following table to determine the appropriate action to take.

NOTE:  You can Filter items in each window to narrow displayed lists.

The mappings you create will display in the bottom window.  (Note that you can also Unmap individually-selected mappings in the bottom window or or Clear all mappings from the bottom window.

3.Click [OK] once all desired mappings have been made and return to the Configuration Options dialog.

Mapping Permissions

You can map File Share roles into SharePoint permissions when you click the [Edit Permissions] button from the Permissions Options tab.  Any Allow Rights or Deny Rights permissions on the source can be mapped to SharePoint permissions on the target, provided the user or group with the permissions has been mapped and exists in the SharePoint environment. Content Matrix does not create any SharePoint permission levels, and can only map roles into existing permissions.

Role mapping (permissions mapping) is only available if user mapping is enabled.

NOTE:  Mappings are saved as separate .MLM files, and the mappings are specific to the particular mapping dialog (Field Types, Users, or Permissions.) they were saved from.

To map permissions:

NOTE: Content Matrix supports many-to-one permissions mappings between source and target.

1.From the File drop-down at the top of the File System Rights to SharePoint Role Mappings dialog, choose the appropriate option.  Use the information in the following table for guidance.

2.Map source roles to SharePoint permissions as follows:

·From the left (File System) window, select the Item(s) that you want to map.

·From the right (SharePoint) window, select an available Item).

·Click the Map icon.

NOTE:  You can Filter items in each window to narrow displayed lists.

The mappings you create will display in the bottom window.  (Note that you can also Unmap individually-selected mappings in the bottom window or Clear all mappings from the bottom window.

3.Click [OK] once all desired mappings have been made.

Target Hierarchy Options

The Target Hierarchy Options tab lets you specify the hierarchical structure of migrated content on the target SharePoint environment.  

To configure Target Hierarchy - Subsite options:

NOTE:  This option is only available when migrating File Share content as a SharePoint site.

1.If you want to migrate source content into SharePoint sub-sites based on the source File Share's folder structure, select Migrate files to sub-site based on Source directory structure.

NOTE: If you also want Content Matrix to use the configured permissions migration settings that have been set in the Permissions Options tab, check the Copy permissions (based on configuration in Permissions tab) box.

2.For Set new site template, select from the list of available SharePoint site templates from the drop-down.

NOTE: If the target hierarchy is being configured as a separate action (that is, via the Paste Hierarchy option), you will also have the option to enable the Use Import Pipeline option. For a full migration, these options are available as either Folder Options or File Options.

To configure Target Hierarchy - Document Library options:

1.For Migrate to Sub-Folders, select how you want File Share content to be migrated into sub-folders in a SharePoint document library.  Use the information in the following table for guidance.

2.If you want Content Matrix to truncate long folder paths or names to avoid migration errors when the SharePoint character limitation (255)  is exceeded:

a)Make sure the Truncate long path is checked.

b)If different than the default (200), enter a Max Length Before Overflow value, which determines the folder path length that when reached, will trigger the overflow logic processing.  You may adjust this value, but make sure it does not exceed 255.

c)If different than the default (5) enter an Overflow Folder Name Length value, which determines the number of characters (from the first position) that will be used from each source folder name to construct the folder name in the Overflow.  You may adjust this value, but make sure it does not exceed 255.

3.For Document Library - Set document library name from:, select which SharePoint document libraries the source contents (files and folders) will be migrated into on the target SharePoint instance.  Use the information in the following table for guidance.

NOTE:  These options are only available when migrating content as a SharePoint site or document library.

4.For Migrate to Document Set, select how you want to  migrate File System content into SharePoint Document Sets.  Use the information in the following table for guidance.

NOTES:  

·When connected to SharePoint Online, if you have chosen to Use Import Pipeline, these options are disabled because it is not supported. See Objects and Actions Supported Using the Import Pipeline.

·Please see Microsoft's Document Sets planning page for more basic details on document sets.