Welcome to
Help Desk

Product Updates
Training
Support
Ideas Contact Support

Prerequisites for Using Migration App to Migrate from On-Premises Sources to Egnyte

Audience

Any user of the Migration App.

Migration App is Egnyte’s self-service data migration tool that enables users to easily move files, folders, and their associated permissions from an on-premises network share to the cloud. There are a few considerations for determining if Migration App is the right tool for the project. 

This article outlines Migration App capabilities, key considerations, and migration steps that will help users plan for their data migration. 

What Migration App Can Migrate

Category

Details

Data Size

Recommended <10TB per Migration Job

By default, Migration App imposes a size limit on migration jobs, but this will vary depending on the user's domain. Nonetheless, we recommend parsing jobs into smaller subsets. So if the source folder for migration contains more than 10TB, Egnyte recommends splitting the migration into several smaller jobs, where each job migrates a subset of the data (<10TB) from the network share.

Note that the users can run 3-4 migration jobs simultaneously from the same Agent.

For optimal performance, Egnyte recommends keeping migration jobs within a 5TB limit.

Number of files and folders (objects)

Recommended <15 Million Objects

By default, Migration App has a set limit on the number of objects in a job, although the limit depends on the specific domain. Nonetheless, Egnyte suggests organizing the jobs so that the users migrate in smaller batches. If the Source folder for a migration job has more than 15 million objects (a combination of files and sub-folders), Egnyte recommends that the migration be split into several smaller jobs, where each job migrates a subset of the files and folders (< 15 million) from the Source.

Migrate Permissions

Migration App allows migrating permissions from the network share.

This article outlines how permissions on the network share are translated to Egnyte Cloud permissions.

Supported Permission Model on source: WindowsNTFS

Supported File Types

See this article detailing Egnyte's standard supported file types.

Supported File Size

Maximum file size based on the plan 

This is not a Migration App limitation but depends on the plan. Check the plan details for more information.

Supported Folder Size

Maximum 50,000 immediate children per folder

This is not a Migration App limitation. This is a hard limit for all Egnyte domains. If a folder has more than 50,000 files or sub-folders, split the parent folder into smaller folders with less than 50,000 immediate children before trying to migrate it.

Maximum Length of Filename

245 bytes (245 characters)

This is not a Migration App limitation. It is dictated by Egnyte for all domains. Files with a title greater than 245 bytes will be skipped from migration. Please fix such file names before migration
A file path is structured in the following order: Drive letter, colon, backslash, name, followed by components separated by backslashes.
Example:
X:\Shared\Sales\Customers\ACME\ = 31 characters

Maximum Length of Folder Path

5000 bytes (characters)

This limitation is inherited from the Egnyte Cloud File System for all domains.

Supported Migration Source

Windows OS versions: Windows 11, Windows 10, Windows Server 2012, Windows Storage Server 2012, Windows Server 2012 R2, Windows Server 2016, Windows Storage Server 2016, Windows Server 2019, Windows Storage Server 2019

Support for Data True-Ups

Once the date is migrated to Egnyte, users can subsequently run True-Ups to sync any deltas between the source and Egnyte. That way, users can continue to collaborate and modify the original files while Migration App synchronizes these modifications with Egnyte cloud. 

Empty Folders

There is an option to create Empty Folders as part of any migration job.

Symbolic Links

There is an option to migrate content from Symbolic Links as part of any migration job.

 

What Migration App Cannot Migrate

Category

Details

Workaround/Alternatives

Data from other cloud storage platforms

Migration App is limited to migrating from on-premises sources or from directories that can be mapped to a Windows drive from a host server. This tool does not support migration from other cloud platforms such as Box, Dropbox, or SharePoint Online (SPO). 

Depending on the source, we have other migration capabilities that may be able to assist. For other source repositories, contact Professional Services.

Support for Permission True-ups

If permissions on the source folder for migration are constantly changing during or after migration, Migration App cannot capture the differences and migrate these delta changes to the cloud.

Once the permissions are migrated, they should be managed in the cloud moving forward.

Apply permissions directly in the cloud.

Migrate Users and Groups

Note that before Migrating Permissions with Migration App, users and groups must already be created on the Egnyte domain. 

This needs to be done separately prior to migrating permissions

Unsupported File Types

Database files (Exchange, QuickBooks, SQL, Oracle, MS Access)

Package Files (Mac specific files)

Resource forks

Alternative Data Streams

Refer to this article to learn more about unsupported file types.

No workaround.

Egnyte does not support migrating these file types to the cloud.

Files or folders that have been vaulted

Cannot be migrated when in vaulted state.

Unvault the file or folder on the Source before migrating to the cloud.

 

Project Milestones & Migration Set-Up

Milestones

Approximate Duration

1. Set up the Egnyte domain.

<1 Day

2. Configure Users and Groups in the Egnyte domain.

1-2 Days

3. Enable Migration App on the domain

The Migration app is enabled by default on all new plans, including trials. For certain legacy Connect plans, the app must be enabled upon request by completing this form.
As part of the self-enablement process, end users will be required to review the Migration App (MA) documentation and complete a few confirmations before gaining access. Once completed, the Migration App dashboard will become available to all admin users.

4. Set up whitelisting on the firewall. See below for Migration Prerequisites.

Minutes

5. Install Migration App CMM Agent 

Minutes

6. Run a test migration job of ~10MB with Migration App at least 1 week in advance of the planned Migration.

Minutes

7. Prepare the migration plan for breaking up the Migration into migration jobs of <10TB/<5M objects.

1 Day

8. Create Migration Jobs

Minutes

9. Run Initial Data Migration

Varies depending on the amount of data

10. Run True-Ups

Varies depending on the amount of data

11. Run Permissions Migrations

Varies depending on the number of permissions.

12. Cut over users to the Egnyte cloud

1 Day

Migration Prerequisites 

Requirements

Details

Customer Domain

Must be a valid Egnyte domain not in a trial phase.  Trial domains have very limited storage, which will lead to the failure of migration jobs. One exception may be Enterprise Trials, where there is a higher storage ceiling.

On-Premises Host Machine Specifications

Minimum:- CPU: 4 cores and RAM: 8 GB, 10 GB Disk Space

Recommended:- 8 cores, RAM: 32 GB, and 50 GB SSD

Note:

  • A machine provisioned with only 8GB RAM will rarely be able to install the Agent, as the host system will always consume a portion of memory. Minimum 10 GB available disk space.
  • The VM or physical server should be a dedicated resource for Migration and not be shared with other workloads while performing migration.

Minimum 10 GB available disk space.

Windows OS versions: Windows 11, Windows 10, Windows Server 2012, Windows Storage Server 2012, Windows Server 2012 R2, Windows Server 2016, Windows Storage Server 2016, Windows Server 2019, Windows Storage Server 2019

Domain Credentials

Admin credentials required to register the Migration Agent.

Can also use Role-based assignment to Power Users

Firewall Whitelisting

Users must whitelist several URLs for outbound access in order for Migration App to function properly. See Firewall Requirements.

Migration Source

Any source accessible to the Windows Host Server

Windows Domain Administrator Account

Required for scanning permissions and files on a network share (source for migration)

 

Questions? Feature Requests? Other Feedback?

For any feature requests or suggestions, feel free to submit them here, and make sure to mention Migration App in the text

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

 

 

Was this article helpful?
1 out of 1 found this helpful

For technical assistance, please contact us.