StoragePoint 6.0 - Reference Guide

Folders and Files to Catalog Settings

1.To Include or exclude particular folders from within an endpoint, click Click to Configure Folders.

a.Select whether to exclude or include folders from being cataloged.

b.Select folders by placing a check in the box. Selecting a child folder if the parent is already selected is not necessary. Selecting a parent folder will uncheck any child folders, but the child folders will be included in the selection.

c.Click Uncheck All to clear any checkmarks and start over.

d.Path(s) can also be entered manually by using the Enter in Textbox option. Changes made during textbox entry will only be reflected on the tree view if the path is valid.

OR

e.Use a search pattern to catalog only folders that meet a specific pattern. Use a backslash and asterisk (\*\) for each level beneath the root where the named folder would be found. See the screenshot above for an example. Click Validate & Calculate to show how many folders will be cataloged.

2.To exclude files by property information, select the date for the corresponding filter type – Created Before, Last Modified Before, or Last Accessed Before, and/or enter a numeric value for the File Size Greater Than filter.

3.To include or exclude particular files or file types, select the corresponding radio button and enter the information separated by commas in the provided text box.

Large Files and File Share Librarian

File Share Librarian will catalog files greater than the web application upload threshold, but Large File Upload must be enabled on General Settings.

File Share Options

1.Check the Clean-up item names before import into SharePoint? checkbox to have Metalogix StoragePoint check for and remove invalid characters or character sequences from file or folder names.  Please refer to Microsoft's guidance on acceptable characters in SharePoint farms.

2.Check the Promote folder permissions to SharePoint containers? checkbox to have Metalogix StoragePoint  promote the effective permissions on file share folders to the containers (i.e. sites, lists, and folders) it creates in SharePoint. The mapping of permissions is as follows:

a.Users in file system with Full Control are mapped to “Owner”

b.Users in file system with Write access are mapped to “Contributor”

c.Users in file system with Read access are mapped to “Reader”

Truncation

The Truncate feature allows the reduction/truncation of the folder or file names as necessary in order to catalog content to SharePoint. This is done by specifying the max folder name and max file name when the longest UNC Path is greater than 259 characters. The  feature allows customization of the folder name size, file name size and truncation character replacement. Truncation can be done for only Files or only Folders or both. Truncation is applied at the most granular level of the file share to be cataloged. It will begin with file names, and then parent folders, as necessary, progressing further up in the hierarchy to accomplish a suitable URL.

1.Enter a number for the max Name length for each folder that will be created in SharePoint. The minimum is 5.

2.Enter a number for the max Name length for each file that will be cataloged. The minimum is 10.

3.Choose One option to apply the truncation:

·Files and Folders .- this option will truncate file and folder names

·Files.-this option will truncate only file names

·Folders.-this option will truncate only folder names

4.(Advanced Truncation Options (optional) Enter a valid character to represent that folder or file has been truncated. This character will be inside the file or folder name. The default is = ’_’ (underscore).

·Site collection names and sub site names never truncate if the scope is Web Application or Content Database.

·Sub site names never truncate if the scope is site collection.

·Beginning at the most granular level, truncation stops once a suitable URL length is reached and no more file or folder names will be truncated.

·If 2 files have the same name after truncation, one of the file names is reduced by 2 characters and ‘_#’ is added to the file. For example:

Suggested Truncation Sizes

Running the librarian timer job with ‘Simulate and Log Issues’ box checked allows the algorithm to suggest folder and file name changes based on what could not be cataloged.  The results of the librarian timer job will provide a recommended max file name length and/or a max folder name length for the librarian settings. The feature searches the most granular folder and files in the fileshare structure and reduces by 1 character at a time, until total size of names < Max Url allowed.

Suggestion Truncation Example:

All files and folders in the diagram below need to be cataloged. The max folder name length = 40 and max file name length = 40 with scope = web application and Max Url = 226 characters. The results of running the librarian timer job with ‘Simulate and log issues’ checked would be the following. Red =  folders and files not cataloged, Green= Folders and Files cataloged.

The summary will return suggested limits for max file name length and max folder name length, in order to have all content cataloged. The following shows that 15 is the recommended folder name and file name length in order to make sure that all content is cataloged successfully.

This truncation suggestion may be found even on successful timer jobs. Be sure to check the entire Librarian Log for details.