Audience

Any user of the Migration App.

This product is currently in Beta. We invite any Customers interested in joining the Beta program to engage Egnyte Professional Services for consideration.

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

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

What Migration App Can Migrate

Category

Details

Data Size

Recommended <5TB per Migration Job

While Migration App doesn't impose a limit on migration jobs, we recommend parsing jobs into smaller subsets. So if the source folder for migration is more than 5TB, we recommend you split the migration into several smaller jobs, where each job migrates a subset of the data (<5TB) from your network share.

Number of files and folders (objects)

Recommended <5 Million Objects

While there is no limitation imposed by Migration App, we suggest migrating in smaller batches. So if the source folder for migration has more than 5 Million objects (a combination of files and sub-folders), we recommend that you split the migration into several smaller jobs, where each migrates a subset of the files and folders (< 5 Million) from your network share.

Migrate Permissions

Migration App allows you to migrate permissions from your 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 your plan 

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

Supported Folder Size

50,000 files/sub-folders per folder

This is not a Migration App limitation, but is dictated by Egnyte for all domains. If you have a folder with more than 50,000 files or sub-folders, split the parent folder into smaller folders with less than 50,000 immediate children.

Maximum Length of Filename

245 bytes (245 characters)

This is not a Migration App limitation, but is dictated by Egnyte for all domains. Files with 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 is not a Migration App limitation, but is dictated by Egnyte for all domains.

Supported Migration Source

Windows Server 2008 and later

Support for Data True-ups

Once you have migrated your data to Egnyte, you can subsequently run migrations to true-up 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. 

 

What Migration App Cannot Migrate

Category

Details

Workaround/Alternatives

Data from other cloud platforms

No

Migration App is limited to migrating from on-premises sources. This tool does not support migration from other cloud platforms such as Box, Dropbox, AWS or Google Cloud Service.

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

No

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 you migrate the permissions, they should be managed in the cloud moving forward.

Apply permissions directly in the cloud.

Migrate Users and Groups

No

Note that before Migrating Permissions with Migration App, users must already be created on your 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 without a Last Modified Time or a Last Modified Time in the future

No

Migration App cannot migrate these files, however they will be detected during the scan command.

Change the last modified time to a current time or time in the past before migrating them to the cloud.

Empty folders on the source

No

Manually create empty folders on Egnyte cloud domain.

Files or folders that have been vaulted

No

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

 

 

Project Milestones & Migration Set Up

Milestones

Approximate Duration

1. Set up your Egnyte domain.

1 Day

2. Configure Users and Groups in your Egnyte domain.

1 Day

3. Enable Migration App on the domain

Currently this is a manual process and can take up to 2 business days.

4. Set up whitelisting on your 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 your migration plan for how you'll break up the Migration into migration jobs of <5TB/<5M objects.

1 Day

8. Perform Migration.

Varies depending on amount of data

9. Cut over users to the Egnyte cloud.

1 Day



Migration Prerequisites 

Requirements

Details

Customer Domain

Must be a valid Egnyte domain not in trial phase

On-Premises Host Machine Specifications

4 CPUs, 8 GB RAM

Windows OS versions: Windows 10, Windows Server 2008, 2012, 2012R2, 2016, 2019

Domain Credentials

Admin credentials required to register the Migration Agent.

Can also use Role-based assignment to Power Users

Firewall Rules

Whitelist the following URLs for outbound access

https://<your-cloud>.egnyte.com:443

https://io-us.egnyte.com:443 (US datacenters)

https://io-eu.egnyte.com:443 (EU datacenters)

https://prod-logg8.egnyte-internal.com:443

https://migration-wss.egnyte.com/ws/connect

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)