Advanced Options for Migration Jobs

Audience

Any user of the Migration App.

Context

For each migration job, you have the option to configure various advanced settings, including Empty Folders, Sanitization, Unattended Mode, Confluence, and more. These are all available from the Migration Details Page.

Accessing Advanced Options

On the Migration Details Page, in the left column, click on the arrow next to Advanced Options to open the drop-down menu.

On the drop-down menu, select any item to confirm its configuration or make changes to suit your preferences for this migration job.

If a migration job is currently running a command, you may not modify any of the Advanced Options. You must wait until the command has completed before configuring these settings for the job.

Confirming Advanced Option Settings

All Advanced Option settings are displayed in the right column of the Migration Details page for each job, under Other Details.

Drilling Down into Advanced Options

Setting Sanitize Preferences

Sanitizing is the function of renaming files and folders to map to Egnyte naming conventions. After every scan of the source, the migration details page will provide details on any unsupported or conflicting file names. During sanitizing, all unsupported characters are replaced with an underscore, which will allow them to be migrated. If you opt not to sanitize these files, they cannot be migrated to Egnyte..

By default, you are offered the option to sanitize every time you run a migration command (Migrate Data or True-Up Data).

Alternatively, you can set your preferences for a given migration job to always sanitize on the source, always sanitize on the fly, never sanitize, or just keep it Ad Hoc.

1. Click on Sanitize to view the dialog box for this feature.
   
   
   
   
2. Choosing Always - On the Source means that any unsupported characters in filenames will be changed on the Source to an underscore before migrating.
3. Choosing to Always - On-the-Fly means that unsupported characters in filenames will be changed during migration and nothing will be changed on the source.
4. Choosing Never will skip sanitizing altogether.
5. If you elect to keep the default setting of Ad Hoc, the UI will prompt you to make a choice every time you run a command.
6. Once you have made your selections in the modal, click Save.

For more information about the Sanitize command, see Understanding the Sanitize Command in Migration App.

Setting Empty Folders Preferences

In Migration App, empty folders can be automatically created on the destination as the final step of every Migrate Data metacommand. Note that an empty folder is not actually "migrated" but rather "created," as it’s simply writing a directory path on Egnyte.

By default, you are offered options for empty folders every time you run a migration command (Migrate Data or True-Up Data).

If you prefer, you can set use Advanced Options to specify that Empty Folders will Always or Never be included in migration metacommands.

For more information about the Empty Folders functionality, you may wish to read this helpdesk article: Migrating Empty Folders with Migration App.

Controlling Skip Scan Period Preferences

To eliminate unnecessary steps and time, Migration App has a default Skip Scan Period of 8 hours. This means that if a scan was completed within the previous 8 hours, when you initiate a metacommand it will not automatically scan the source again. Instead, a dialog box will prompt you to confirm if you want to scan the source again.

As an alternative, you can use Advanced Options to set your preferences for this feature.

1. Click on Skip Scan Period to open the dialog box.
   
   
   
   
2. From the dropdown, select the threshold you prefer for this migration job. Note that setting the period for 0 hours will disable the Skip Scan feature and the job will include a scan with every metacommand.
3. Click Save.

For more information, see Understanding the Skip Scan Period in Migration App.

Setting File Type Exclusions

By default, Egnyte will not accept some file types. You may wish to exclude certain file types from a given migration job, and Advanced Options allows you to do this.

1. Click on Excluded File Types to view the dialog box for this feature.
   
   
   
   
2. Type in any number of file extensions that you want to exclude. You can change this at any time in the future.
3. Click Save.

For more detailed information, read Excluding File Types in a Migration Job. You may also want to familiarize yourself with this article for unsupported characters and excluded file types that are fundamentally incompatible with Egnyte.

Controlling Confluence Mode

Jobs are considered in conflict if they share the same destination with one or more existing migration jobs. When jobs are in conflict, you may not proceed to migrate data until the Confluence feature has been enabled for the jobs. In such cases, you will receive an error message indicating that Confluence needs to be enabled.

1. To enable this feature, click on Confluence under Advanced Options to view the controls.
   
   
   
   
2. Simply click the ON button to Enable Confluence and click Save.

For more information about Confluence Mode, see Using Confluence to Resolve Conflicting Jobs in Migration App.

Setting Unattended Mode Preferences

When a migration job has Unattended Mode enabled, it automatically runs True-Ups for the job at set intervals. This will continue indefinitely or until Unattended Mode is disabled for the job. 

By default, Unattended mode is disabled. If you wish to activate it for a job, follow these simple steps.

1. Click on Unattended to view the dialog box for this feature.
   
   
   
   
2. Under Unattended Mode, click the toggle to Enable Unattended Mode. Note that you must have completed at least one Data Migration command for the job. Until then you cannot enable Unattended Mode for that job.
3. Next you will be offered the option to select the Threshold for running True-Ups in Unattended Mode. The default threshold is two days but you can change it to anywhere from one to 14 days.
   
   
   
   

   It is important to understand that the threshold is based on when the previous True-Up finished. If the previous command finished on Monday at 3am and you have the threshold set at for 4 days, the next True-Up will begin on Friday around 3am.

4. Click Save.

For more detailed information, see Unattended Mode in Migration App.

Setting Symbolic Link Preferences

Symbolic links are links in a file system that contain a path to another object. By default, Migration App recognizes but does not follow or migrate the content in symbolic links.

After completing a Scan of the migration job, you may ascertain whether Symbolic Links appear in the source data by looking at the 13th column in the Migration Report summary page.

If you want a given Migration Job to follow and migrate content from symbolic links, you can control this under Advanced Options.

1. Click on Symbolic Links on the Advanced Options dropdown menu.
2. Click ON to Enable data migration from symbolic links.
3. Click Save.
   
   
   

For more information, see Enabling Migration of Symbolic Links in Migration App.

Questions? Feature Requests? Other Feedback?

If you have feature suggestions or requests, feel free to submit them here, and make sure you mention Migration App in the text.

For more complex requests that would benefit from providing screenshots or other attachments, you may submit them to support@egnyte.com. Be sure to include Migration App in the email title. Our Support team will push your comments to the Product team for consideration.