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 |
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) 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. |
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:
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.