Audience
Any user of the Migration App.
This product is currently in Limited Availability. We invite any Customers interested in using the product to engage Egnyte Professional Services, their Partner Account Manager or their Customer Success Manager to have it enabled for their domain.
Sections
Getting Started
The Agent
The Migration Dashboard
Creating a Migration Job
What Gets Migrated
True-Ups or Syncing
Sanitizing
Permissions
Speed, Bandwidth, and Throughput
Advanced Options and Advanced Mode
Troubleshooting
General Questions
Getting Started
Q: What does it mean that Migration App is in Limited Availability?
A: While it has already proven effective at migrating multiple PB (Yes! Petabytes!) of data for hundreds of customers, Migration App is not yet Generally Available (GA). The Limited Availability Program allows us to enable Migration App for a subset of Egnyte Professional Services customers and other more technical customers who wish to use the product while we continue to improve the feature set, supportability and scalability of the product.
Q: What types of domains can be enabled with Migration App?
A: There are various types of Egnyte domains, but Migration App cannot be enabled for all types.
- Trial domains: In general, Migration App should not be used by Trial Domains. Trial domains are ineligible due to the storage limitations imposed by the trial program. One exception may be for Enterprise Trials, which eliminate the storage limitations.
- Archive domains: Yes.
- Vanity domains: No. An example of a vanity domain is myfiles.companyname.com which is essentially an alias from your standard Egnyte domain companyname.egnyte.com. To use Migration App, you must have it enabled on your standard domain and run all your migrations there.
- FedRAMP Alias domains: Yes. Example: fedramp[mydomain].egnyte.com
- Egnytegov.com domains: No, however it is compatible with "FedRAMP alias domains." So instead of migrating to [mydomain].egnytegov.com, you instead use Migration App to copy data to fedramp[mydomain].egnyte.com
Q: How do I find Migration App once my domain has been granted access?
A: Admins can find Migration under the application selection menu on your domain interface. Select that to view the Migration Landing Page. If your domain has access to Migration App, you will see two blue buttons labeled On-Prem Migration. Click this to reach your Migration Dashboard.
Although only Admins can access Migration App by default, Power Users may also be granted access by exception. See Enabling Power Users to use Migration App.
Q: Once enabled, does Migration remain enabled for a domain permanently?
A: Yes.
Q: Why does clicking on Migration in the App Picker menu take me to a Landing Page instead of the Migration Dashboard?
A: Egnyte has a larger story to tell around Migration now, so we created a Landing Page to help guide customers through their Migration Journey. From the Landing Page, Migration App users just need to click one of the two blue buttons labeled On-Prem Migration to access their Migration Dashboard.
Q: Is there anything special I need to do if I was originally using the CMM Agent CLI tool, but now want to use Migration App?
A: Yes, check out this Helpdesk article for an important prerequisite.
Q: What are the firewall requirements for Migration App?
A: See Firewall Requirements for Migration App.
For more detailed setup information for Migration App, see the Product Guide.
Q: What do I need to know before I use Migration App?
A: See Getting Started with Migration App for everything you need to prepare yourself for success using Migration App.
The Agent
Q: How can I find my Agent ID?
A: See this Helpdesk article How do I Get the Cloud Migration Manager Agent ID?
Q: Why do I need to provide my Windows Login credentials to set up my Agent?
A: Migration App requires information to identify both the Source and the Destination. Your Windows Login defines the Source, so you need both the username and password for an identity that has access to network shares. The Destination is defined by the domain and the Admin’s username.
Q: Is the Agent Setup form case-sensitive?
A: Yes and no. Egnyte user name is not case-sensitive. But Windows AD user names are case-sensitive.
Q: What do I do if my Agent becomes disconnected from the Cloud?
A: See this Helpdesk article Reconnecting the Cloud Migration Manager Agent to the Cloud.
Q: Does it matter what version of Migration App Agent I have?
A: You should not have to worry about what version you are running. The Agent autonomously updates whenever a new version is available. It will wait to update until after your Agent has finished running any active Migration Jobs.
Occasionally, you may need to manually update your Agent. If so, ensure no Migration job commands are currently running. After the Agent updates, you will be able to keep running your existing Migration Jobs as before.
Q: How can I tell what version of the Agent I have running?
A: Navigate to your Migration Dashboard and click on an Agent in the left column. It will expand to provide more details, including the version number.
Q: Can I update the Migration App Agent when a Migration Job is running?
A: No. You need to be sure no jobs are running before you update the Agent. For more information, see this Helpdesk article.
Q: I had to change my Windows password, and now my Agent is running but doesn't seem to have access to any network shares.
A: If you change the user password for the Windows user associated with the Agent, you will need to change it on the Agent settings as well. You can follow the steps explained in Using Migration App to Migrate Content from a Network Share to change your password and restart the Agent.
Q: Can I install more than one Agent on my Windows host machine?
A: No. There's no reason why you'd need to. One Agent is all you need for a single Source, and one Source can support the creation of multiple Migration Jobs. However, we recommend you run no more than 3-4 Migration Jobs concurrently.
For more complex migration projects, you can use your Migration Dashboard to manage additional Sources, which would require separate Windows hosts, each with a different Agent installed.
The Migration Dashboard
Q: Why can't I see other Admins' migration jobs on the Migration Dashboard?
A: By design, Migration App aligns each migration job with the individual user who created it. As a result, you can only see the migration Agents and Jobs you created while logged in as a given user. For more complicated migration projects, many customers choose to create a single shared "Migration User," such as "Migration-Admin@domain.egnyte.com." This allows multiple admins to log in with these credentials to share a single Migration Dashboard for visibility into all migration activities.
However, if you want to have visibility into migration activities on your domain by other Admins, you can download the Migration List from the Migration Dashboard. This will provide information about every Agent and every Migration Job active for your domain. See Downloading the Migration List.
Q: How can I clean up my dashboard and remove Agents and Jobs that are no longer needed?
A: See this Helpdesk article.
Q: When would I see more than one Source on my dashboard?
A: The Migrations Dashboard allows for multiple Agents. However, only one can be installed per Windows host machine, so in most cases you will only have one Agent activated. The only time you would see multiple Agents would be when you are using the dashboard to run migrations from multiple Windows host machines. An example might be if you were running migrations from different physical offices. In this case, each host would have their own installed Agent running migrations from different locations to your Egnyte domain.
Q: How do I know what an Error or Status Code means?
A: See this Helpdesk article Migration App Status and Error Codes for a complete listing. This can be helpful in troubleshooting and if you need to request technical support.
Q: Where can I find Migration Reports?
A: On the Details page for any Migration Job, there’s a blue link in the upper right corner to Download report. Click on that to be redirected to the /Shared/Migrations folder on your Egnyte file server, where the report will be posted. From there, right-click on the CSV file to download it and open it in Excel.
You may also download a Migration List for your domain from the upper right corner of the Migration Dashboard. This will include migration jobs created by all users.
Creating a Migration Job
Q: Can I create a Migration Job where the Source is a mapped drive letter?
A: Yes. You can create a job where the Source is either a mapped drive letter, an absolute path or a UNC path. To determine a UNC path:
- Hold down the Windows key + R, type cmd and click OK.
- In the command window type net use then hit Enter/Return.
- Make a note of the required path, then type Exit, then hit Enter/Return.
Q: Can I create a Migration Job where the source data is on Azure Cloud?
A: Yes. You just need a Windows VM on Azure, and as long as the data is accessible as a mount point from that Windows VM. There can be some connectivity issues with this type of implementation, so we recommend creating smaller migration jobs and doing an initial proof of concept.
Q: When I create a Migration Job, how do I specify the Destination?
A: The Destination needs to be a valid Egnyte folder path. The Destination must be specified as /Shared/<filename> or /Private/username/<filename>. Migration App will create the folder named <filename> within the respective root folder. Folder names in the path cannot be empty, contain special characters ( * ? \ < > ), or start or end with a space, symbol or period.
For more information, see Selecting a Destination Folder Path.
Q: I just created a Migration Job but I'm getting an error “Unable to validate source path.” What should I do?
A: This occurs if the correct permissions for either the Source or the Destination aren’t in place. You need to authenticate the Agent as a User who has AD permissions to read from the Source, and you must also be an Egnyte Admin to access the Destination.
Q: Are there any special considerations for a Windows workstation mapped to a Mac for source data?
A: Yes. We've seen this work successfully, when the Mac is assigned a drive letter on a network. This requires the Mac OS be updated to at least High Sierra 10.13.
What Gets Migrated
Q: Are there any limits to the size of migration jobs with Migration App?
A: Yes. See Maximum Migration Job Size for detailed information.
Q: Does the Migration App migrate empty folders?
A: Yes! By default, you are offered the option to migrate empty folders with every Data Migration and True-Up command. However, you can also specify your preferences using Advanced Options. More information is available in this Helpdesk article.
Q: What do you mean by "Excluded files" and "Unsupported files and folders"?
A: See this Helpdesk article for more information.
Q: Is Migration App case-sensitive?
A: Yes. See this Helpdesk article for more information.
Q: Migration App failed to migrate some folders in the job. Why would that be?
A: There can be multiple reasons for folders not migrating.
If folders are empty and you didn't opt in for migrating empty folders, they will not be migrated.
Another reason might be that the user who registered the Agent doesn’t have the necessary permissions to view those folders.
There are also limitations to what Migration App can migrate. More information may be found in this Helpdesk article Filtered and Unsupported Objects with Migration App.
One edge case is when you have a folder on the Source that contains only unsupported files. In this case, none of the files will be migrated, nor will the folder be created on the Destination. And since this folder is not empty on the Source, it will not be created as part of the empty folder migration step. So, in the end, this folder will always be missing in Destination. There is no way presently to migrate it.
Q: Migration App failed to migrate some files. Why is that?
A: One common reason for files failing to migrate is that they may be currently in use. That's why we recommend running several True-Ups after the initial Data Migration and before the final Cutover. Remember that for the final Cutover, all users must be "hands-off" the original Source until cutting over to Egnyte.
More information may be found in this Helpdesk article Filtered and Unsupported Objects with Migration App.
Q: If I have folders with more than 50K immediate children, can they still be migrated? Is 50K a hard limit or just a suggested limit for performance reasons?
A: A maximum of 50K immediate child objects is a fixed limit of the Egnyte platform, not of Migration App. You will need to break your folders down into smaller subsets to use Egnyte.
See Best Practices for Creating an Egnyte Folder Structure.
Q: Can I use the Migration App to migrate additional content into folders on my Egnyte domain that already contains data?
A: Yes, you can. In fact, that's an excellent use case for Migration App. See the Helpdesk article Using Migration App to Sync Data to Existing Folders in Egnyte.
Q: Can I use Migration App to migrate from a Flash drive?
A: Yes. A flash drive (USB drive) works the same way as any local drive. It can be a bit slower when compared to an internal SSD, but you should still be able to create and operate jobs sourcing the connected drive.
True-Ups or Syncing
Q: Is a True-Up the same thing as a Sync?
A: Yes.
Q: How do I run a True-Up? What’s the difference between Migrating Data and running a True-Up?A: See Understanding Data Migration and True-Ups.
Q: If I run a True-up, does it create duplicates of what was already copied previously?
A: No. Running a True-Up simply updates the Destination to match the current state of the Source.
Sanitizing
Q: How do I run the Sanitize command?
A: Sanitize is not a standalone (atomic) command. It is now an optional component of Migrate Data and True-Up Data. By default, when you initiate a data migration command, you are provided a modal where you select whether you want to sanitize on the Source or On-the-Fly. More information may be found in the Helpdesk article Understanding Sanitation Options in Migration App.
Q: Does Migration App change long file path names when we run the Sanitize command?
A: No, it does not change file names or path names that are too long. These files and pathnames are merely flagged during Scan and can’t be migrated unless the user makes the necessary changes on the Source. For more information about Egnyte path limits, see the Helpdesk article Unsupported Characters and File Types.
Q: What does the Sanitize function do?
A: Sanitizing changes any unsupported characters in filenames to an underscore. This can be done in one of two ways:
- Sanitizing on the Source, where the unsupported characters are changed on the Source before migrating.
- Sanitizing On-the-Fly, where the characters are changed during migration and nothing is changed on the Source.
For more information about this, see this Helpdesk article.
Permissions
Q: How does Migration App migrate permissions?
A: See Permission Translation with Migration App.
Q: How long does it take to migrate permissions?
A: It can take a fair amount of time to migrate permissions. They are applied at approximately one per second.
Q: How do NTFS permissions translate to Egnyte permissions?
A: See this Helpdesk article Permission Translation with Migration App.
Q: Can I modify how permissions are mapped with Migration App?
A: No, not currently, although this is on our roadmap.
Q: Does Migration App migrate permissions at both the folder level and the file level?
A: Not exactly. Migration App migrates permissions for folders. The files contained therein inherit the parent folder's permissions.
Q: Are there any limitations for Migration App to migrate permissions?
A: Yes. All Users and Groups must already exist on Egnyte in order for permissions to migrate successfully. If any Users or Groups are missing, the Migration Report will provide insights into that.
Q: What happens if I run a permissions migration, but a needed User or Group has not yet been created on Egnyte?
A: The Migration Report provides a worksheet for both Missing Users and Missing Groups. Once you have created those Users and Groups on Egnyte, you may run Permissions Migration again. See this Helpdesk article Permission Translation with Migration App.
Q: Can I “sync” or True-Up permissions with Migration App?
A: Not exactly. In Migration App, Permissions Migration is an all-or-nothing command. So running it multiple times just replaces whatever was created previously. We recommend you run Permissions migration at the very end of a Migration Job, right before you cut over all your users from using the Source to using Egnyte.
Q: Why doesn't Migration App provide any progress information in the Status Bar while permissions are migrating?
A: Permissions migration involves three distinct steps, and each step takes some time. During the first and second steps no information is communicated through the Migration Dashboard to the user because it is all happening at a database level. Only once the permissions are being applied to the files on Egnyte (Step Three) does the progress bar show any movement.
Q: If I migrate content into Shared, but it has different permissions on the Source than those set on the Destination (Egnyte), which permissions prevail?
A: This is controlled by the Egnyte CFS (Cloud File System) at the domain level. It defaults to "keep source permissions" but can be changed in Settings.
Q: How does a Permissions Migration Simulation work?
A: Think of it as a dry-run to help you identify gaps where you still need to create users or groups on Egnyte in order for the permissions migration to be successful. See Permissions Migration Simulation with Migration App.
Speed, Bandwidth, and Throughput
Q: How can I estimate how long a Migration Job will take?
A: You can first check out the speed test for your domain. Go to https://<domainname>.egnyte.com/speed-test/ (replacing <domainname> with your domain).
Keep in mind there are a lot of factors at play, but this will at least give you a baseline. If you’re reading from a network share, that will also impact your upload speed. For more information, see How Long Will it Take to Upload, Backup, or Download my Files?
Q: Why does the estimated time to complete a migration job keep changing on the dashboard?
A: For every file, Migration App does a metadata operation on the background, so the ETA is a function of the number of objects in the migration (folders and files combined.) For a total payload of similar size, if it comprises lots of small files, it takes longer than if the migration comprised a few larger files. As a given Migration job works through the files, the estimated time will continue to change based on the size of the current files being moved.
Q: How many migrations can run concurrently from the same Agent?
A: This depends on the capacity of the host machine where the Agent is running. Each migration job takes around 250 MB of memory. Depending on your host machine CPU/memory, you may run three or four concurrent migration jobs. We don’t recommend running more than four jobs at one time. The limitation here is not the Migration App itself but rather the Egnyte system back end.
Q. Is there a minimum bandwidth requirement for the Migration App?
A: No. Migration Jobs will see higher throughput the more bandwidth you have. But high latency/low bandwidth is one of the use cases for Migration App. These jobs will take more time.
Q: What to do about improving upload speeds for migration jobs? Is it possible to set a number of threads for the Migration App to increase the throughput?
A: Yes. To do this, you must first have Advanced Mode enabled for your domain. Then you can use the Throughput or Threads features in Advanced Options, located on your Migration Details page. See Controlling Bandwidth Throughput for a Migration Job and Controlling Threads for a Migration Job.
Advanced Options and Advanced Mode
Q: What is the difference between Advanced Mode and Advanced Options?
A: Advanced Options are a set of feature controls available for all migration jobs. To access them go to the Migration Details page and click on the arrow next to Advanced Options in the left column.
Advanced Mode, however, is a setting that can be enabled for a domain that will give the Migration Operator several additional, more technical controls. We recommend this be used only by seasoned users of Migration App. See Advanced Options for Migration Jobs.
Q: What can I control with Advanced Options?
A: Advanced Options provides controls for the following functionality:
- Sanitizing
- Migrating Empty Folders
- Skip Scan Period
- Excluding File Types
- Confluence Mode
- Unattended Mode
- Symbolic Links
More detailed information may be found for this feature set in the Helpdesk article Advanced Options for Migration Jobs.
Q: What is Advanced Mode?
A: Advanced Mode is a setting that allows the Migration Operator to undertake several more complex actions in Migration App. It is not enabled by default, so it must be first enabled for the domain, and then more options become available. Advanced Mode features are very technical and can have a major impact on your host machine and migration job. Accordingly, we only recommend Advanced Mode for the most experienced Migration Operators.
Q: How do I get Advanced Mode enabled for my domain?
A: Submit a ticket to support@egnyte.com requesting enablement.
Q: What features are available with Advanced Mode?
A: Advanced Mode enables the following features:
- Increasing the threads (transfers and checkers) for a job to improve performance.
- Controlling bandwidth throughput for a job..
- More features to come.
Q: How do you change the threads for improved performance?
A: This requires Advanced Mode to be enabled for your domain. See this Helpdesk article to understand the process.
Q: How do you change the bandwidth throughput for reduced strain on my network?
A: This requires Advanced Mode be enabled for your domain. See this Helpdesk article for more information.
Troubleshooting
Q: What if the credentials to register the Agent won't allow me to access the network share Source?
A: You must ensure the Windows host machine is on the same AD domain as the network share resources. Check out this Helpdesk article Ensuring Windows Host Machine and Source Are on the Same AD Domain.
Q: What if a Migration Job hangs?
A: Check out this Helpdesk article What if a Migration Job Hangs?
Q: What if the Agent Registration hangs?
A: See this Helpdesk article What if Agent Registration is Hanging?
Q: What if I’m unable to execute any commands?
A: Refer to this Helpdesk article What if I Am Unable to Execute Any Commands in Migration App?
General Questions
Q: Can any Egnyte User use Migration App?
A: By default, only Administrators can use Migration App. Power Users can be granted access by exception, but this has several prerequisites. See Enabling Power Users to use Migration App.
Q: Can Migration App be limited to be available to only certain Admin users on a domain?
A: No. Currently, Migration App is enabled for the entire domain. All Admins can see Migration App, and if you make an exception for Power Users, all Power Users can see Migration App.
Q: Can any Administrator monitor migration jobs created by another Administrator?
A: No. Migration jobs are tied to the User/Domain. This becomes the key to each job and therefore only a given User can see their own Agents and Migration Jobs in the dashboard. However, any user can download the Migration Jobs List which details all jobs created by all users.
Q: If I need to stop a migration for some reason, can I restart it later? I don’t want to be using all the bandwidth during the day when it may impact other users doing their work.
A Yes. You can stop and restart a Migration Job at any time. However, any time you restart a Migration Job, it needs to do a complete scan of both the source and the destination. This allows it to identify what, if any, data has already been migrated. Actual movement of the data begins where it left off previously. Alternatively, you may wish to look into Controlling Bandwidth for your migration job, which is a feature that requires Advanced Mode be enabled for your domain.
Q: If I need to restart a migration job, what do I need to do?
A: Return to the Migration Dashboard, click on Details for the migration job, and then click Migrate Data (or True-Up Data). It can take a while for the system to determine where it left off, but it will not duplicate content and it will proceed to completion.
Q: Where can I find my migration job logs?
A: It depends on how you’re logged into the Agent.
If you’re logged in as the Local System:
C:\Windows\System32\config\systemprofile\AppData\Local\egnyte-agent\[migration-id]
If you are logged in as the Local User:
C:\Users\[username]\AppData\Local\egnyte-agent\[migration-id]
Q: What if I have a feature request?
A: 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.
Q: Is there a way to get a quick question answered?
A: You can always submit a support ticket to support@egnyte.com.