1. Home
  2. Jobs
  3. Advanced Fields – Source and Target Nodes

Advanced Fields – Source and Target Nodes

Advanced fields are settings for unusual use cases. Other than the fields for Exclude and Include Files in the Windows Drive or Share System, advanced fields may be left at the default values unless you are directed otherwise by Tervela Tech Support.  Some fields listed below will only be available for some systems and not for others.

Advanced Fields

INCLUDE FILE METADATA  If this checkbox is selected, Cloud FastPath will include semi-proprietary cloud file metadata such as descriptors in the transfer. While the metadata may be transferred, it may not be readable on the target platform.

INCLUDE SHARED FOLDERS  Includes folders in the file chooser that have been shared with you, but that are owned by another user in your corporate cloud account.  You must select this field on Dropbox target nodes if you are migrating to Team Folders.

IMPORTANT:  Do not select more than one account for transfer if Include Shared Folders is selected, as this can result in transferring an instance of the same folder for the owner and every sharee of the folder. That causes duplicate data on the target and excess byte charges for transferring the duplicate folders.

KEEP PARENT PERMISSIONS  If this box is selected, parent permissions on folders will be inherited by child items, even if the child item has reduced permissions. Note that this strategy can be useful if you are trying to minimize the number of ACLs that are applied to a given Microsoft subsite on OneDrive or Sharepoint Online.

Keep Existing Permissions Do not delete any permissions on the target when applying ACLs.

Limit Recursion Depth  This field will stop scanning the source data at the folder depth specified on account map runs only, and any deeper folders will be completely ignored in the map generation. It will not affect simulation or transfer runs. If you just want to report the shares are at the top levels of your data set and not list out shares in the mapping sheet that are ten levels down, this is a useful feature that will also shorten the overall scan time for your map generation. Enter a value of ‘1’ to only scan the top level of folders if you have selected the root of one account, or have selected several accounts in the job configuration.

LIST ALL PERMISSIONS  This field stores the permissions associated with every item – file and folder – in the job. Depending on the characteristics of the source and target, and how permissions are shared, the listings in the spreadsheet will be significantly less than this. For example, inherited permissions will not be listed unless there is something that either breaks or expands upon that inheritance. Default for this option is selected; Tervela recommends that you leave this option set at the default.

MAX CONCURRENT FILES DOWNLOAD  An index of how many files Cloud FastPath will deliver concurrently to the target. Cloud Fastpath will optimize this field for you; you may leave it at its current setting unless instructed otherwise by Tervela.

MAX CONCURRENT FILES UPLOAD  An index of how many files Cloud FastPath will send concurrently from the source. Cloud Fastpath will optimize this field for you; you may leave it at its current setting unless instructed otherwise by Tervela.

MODIFIED BEFORE / MODIFIED AFTER  If you enter a date in the Modified Before field, Cloud FastPath will only transfer files modified on or before this date.  If you enter a date in the Modified After field, CloudfastPath will only transfer files modified on or after this date.

This feature will filter out all folders from transfer that are ultimately empty when their child items are filtered out by the Modified filter. It will filter out empty folders regardless of whether the “Do not send empty folders” option is selected or not.

Do not send empty folders If this option is selected, empty folders will be listed as filtered in the transfer report and will not transfer. If there is a string of empty folders – e.g., /empty folder1/emptyfolder2/emptyfolder3 – the full tree will be filtered.

SELECT ALL SITES (SHAREPOINT)  Select this checkbox to move all SharePoint teamsites.

SHAREPOINT DOMAIN  This parameter is used to perform the NTLM handshake. Most SharePoint installations should leave this field blank.

SHAREPOINT WORKSTATION  Similar to Sharepoint Domain; used only for NTLM handshake. Most SharePoint installations should leave this field blank.

SHAREPOINT TEAM SITE  This is where you select the team site for the host named site collection that was specified for the ‘Hostname’ on the system. This is the only way to select the team site. Once you have all the other fields on the node and system specified, except for Source Folder, you should enumerate the team sites using the refresh button, and select which one you want to migrate.

SYNC FILE VERSIONS  Select this option if you want to migrate versions of files in the selected data set. Note that file versioning is only supported for newly migrated files to the target; you cannot transfer previous versions of a file that already exists on the target.

MAX FILE VERSIONS  This field displays if SYNC FILE VERSIONS is selected. Enter the max number of versions of files that you wish to transfer. Consult your cloud service provider for absolute max versions they support.

USE LAST MODIFIER AS UPLOADER  This option will write the last uploader from the source to the Last modifier metadata on the target.  Source last modifiers are mapped to Target last modifiers to accomplish this, so this option requires Account Mapping.  Note that if a Last Modifier user on the source has been deleted, they will be listed in the account mapping spreadsheet as a “Prior Collaborator.”  Prior Collaborators are best mapped to a target admin, in which case they will display as being last modified by the admin.

Content Scanning  If this option is selected, it will scan Microsoft .docx and .xlsx files and report out links embedded in these documents for other files. The locations of linked files are reported out in the simulation and transfer reports (See About Linked Files for additional information).This function may increase scan times on jobs.

Migrate Box Notes in Native Format  If this option is selected, Box Notes will be exported in native JSON format. If this option is not selected, Box Notes will be exported to .docx files. Default is unselected, meaning Box Notes will be exported to .docx files.

WINDOWS DRIVE OR SHARE ADVANCED FIELDS  Windows Drive or Share systems have several advanced fields that enable you to transfer files that are not transferred by default.

Benchmark Mode If this field is selected, when the job runs, CFP will generate 100 test data files on the source in a folder called ‘cfptest,’ which will be saved as a subdirectory in the source folder as selected by the file chooser. Aside from the top level folder selected in the file chooser, any additional files and folders selected will be ignored for transfer. The CFP-generated test files will be sent to the target, and when the job completes, the CFP-generated files and ‘cfptest’ folder will be deleted. This field is intended for performance testing.

Generic Folder Listing This field is used for drives such as Linux that may have duplicate folder and file names.

Copy Hidden Files this will copy hidden Windows system files such as .sys and .ini files. By default, CFP does not transfer these files as they are generally not of use beyond the source computer.  Use this option and the Copy System Files option with caution, particularly if these files may eventually be downloaded to another Windows computer.

Default Account Name Enter a default name that should appear, for mapping and reporting purposes, as the owner of folders where the true owner cannot be accessed by the Windows app’s installed user. For example, you may enter ‘CFP User’ or any other string in this field; it does not have to be a real user. ‘CFP User’ will then be designated as the owner of any folder that the Windows app cannot determine the owner due to permissions, and will be listed as a source owner in the users tab of the spreadsheet. You will need to map the ‘CFP User’ as you would any other user, and ‘CFP User’ will appear as the source owner in all analysis, simulation and transfer reporting. This field must be completed before generating the map.

Dereference Links  This option is selected by default. When selected, Cloud FastPath will follow the path of a symlink/shortcut to the file(s) it points to, and will transfer those files.

Do Not Scan Excluded Folders  If a folder is listed as an Excluded item, it will not be scanned. This can significantly speed up migrations if a large folder is excluded.

Domain Host  This field is used for Account Mapping only. It specifies a server within the domain to which file owners belong, and may be used in cases where the computer on which the source files reside is outside of the domain for the file owners.  You may leave this field blank unless instructed to complete it by Tervela Support.

Exclude Files  Enter a text string in conjunction with wildcard characters (*) to exclude files from transfer.  For example, if you do not want to send .docx files, enter *.docx in this field.  This field can be useful to exclude files that are generating permissions errors, either because the files are open by an application or because they have user-specific restricted access.  You must enter each excluded file type in a separate instance of the Exclude Files field. To create a new instance of the field, click on the (+) sign to the right of the field. The default Exclude Field excludes all .tmp files and files starting with the characters ~$ (which is also a temp filename notation).  If you want to exclude a folder, it is recommended that you only enter the folder name, without a preceding slash.  Note that exclude filters do not apply to the top level folders of the selected data set.  So if you have selected a folder /folderA, and you apply an exclude for ‘folder,’ /folderA will be transferred, but a subfolder /folderA/folderB will be excluded from transfer.

Copy System Files  this is another option that enables you to transfer Windows system files.

Include Files  Enter a text string in conjunction with wildcard characters to limit a transfer to only the files specified.  For example, if you enter sendme.* in this field, all files that have a filename whose root name is ‘sendme’ will be sent, but any other files will be ignored.

Zip Special MacOS Files on NTFS  checking this option will zip the data and resource fork files for legacy MacOS font s into zip files that are more readily transferrable and stable on non-Mac platforms such as cloud providers.  Consult cfp-support@tervela.com if you are interested in using this option.

Updated on September 20, 2019

Was this article helpful?

Related Articles

Leave a Comment