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 or their Customer Success Manager for consideration.

Sections

Getting Started

The Agent

The Migrations Dashboard

Creating a Migration Job

What Gets Migrated

Permissions

Sanitizing

Speed, Bandwidth, and Throughput

Troubleshooting

General Questions

 

 

Getting Started

 

Q: What does it mean that Migration App is in Beta?

A: While it has already proven effective at migrating thousands of TB of data for dozens of customers, Migration App is not yet Generally Available (GA). The Beta Program allows us to enable Migration App for a subset of Egnyte Professional Services customers and other more technical customers willing to use the product without full Technical Support or standard SLAs. Support is provided by Product Management and Engineering on a best-effort basis.

 

Q: Can Migration App be enabled on a trial domain?

A: No. Only valid Egnyte production domains may be enabled with Migration App. Trial domains are ineligible due to the memory limitations imposed by the trial program.

 

Q: Can Migration App be enabled on an Archive domain?

A: Yes.

 

Q: How do I get to the Migration App once it has been enabled for my domain?

A: You can find Migration under the hamburger menu on your domain interface.

 

Q: Once enabled, does Migration remain enabled for a domain indefinitely?

A: Currently, access to the Migration App is controlled via a setting service flag on the back end of the Egnyte platform so that it can be enabled or disabled as needed. There is no set policy for disabling Migration App.

 

Q: Is there anything special I need to do to “upgrade” from the CMM Agent CLI tool to the Migration App?

A: Yes, check out this Helpdesk article for an important prerequisite.

 

Q: What are the firewall requirements for Migration App?

A: If you have a firewall set up for outbound access, you will need to whitelist the following URLs before running the Migration App.

  • https://<your-domain>.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

For more detailed setup information for Migration App, please see the Product Guide.

 

 

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 the identity that has access to network shares. The Destination is defined by the domain and the Admin’s user name. For more information, see this Helpdesk Article.

 

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: How can I tell what version of the Agent I have running?

A: View it in System Settings.

  • From Windows search, type Add.
  • Select Add or remove programs in System Settings.
  • Scroll down to Cloud Migration Manager Agent.
  • Click on it to view the version number, e.g., 3.5.0

 

Q: What if I see a message on the Migration Dashboard that a Source is inactive because the Version is unsupported?

A: Periodically, we will release an updated version of the Agent to address bug fixes and feature enhancements. There’s a simple process for updating the Agent detailed in the Helpdesk article Manually Updating the CMM Agent. Be sure to finish or stop any Migration Jobs that are running before you update the agent.

 

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.

 

 

The Migrations Dashboard

 

Q: How can I clean up my dashboard and remove some Sources and Jobs that are no longer needed?

A: See this Helpdesk article Deleting Sources and Migration Jobs from the Migration Dashboard.

 

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 my Migration Report?

A: On the dashboard 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 file to download it and open it in Excel.

 

Q: My migration job says “Data migration succeeded,” but the progress bar still shows only partial progress. Why is that?

A: This will occur when you do a True-Up data migration, because the majority of the files for the job had already been migrated previously. So the progress bar is illustrating only the files migrated during this particular run - the deltas or true-up. You can always double-check in the destination on Egnyte. There you can see all of your source data minus any files that may have failed to be migrated, as indicated in the Migration Report.

 

 

Creating a Migration Job

 

Q: Can I create a Migration Job where the source is a mapped drive letter?

A: No. The current version of CMM Agent (3.4) does not support mapped drives. When you create your Migration Job, just exchange the drive letter with the relevant UNC path. To find the full UNC path of a mapped drive:

  1. Hold down the Windows key + R, type cmd and click OK.
  2. In the command window type net use then hit Enter.
  3. Make a note of the required path, then type Exit, then hit Enter.

 

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.

 

Q: I just created a Migration Job but I'm getting an error “Unable to validate source path.” What do I do?

A: This occurs if the correct permissions for either the Source or the Destination aren’t in place. Instead, you need to run it as the local User who has the permission to read from the Source, and you must also be an Egnyte Admin to access the Destination. See Using Migration App to Migrate Content from a Network Share.

 

 

What Gets Migrated

 

Q: Are there any limits to the size of migration jobs with Migration App?

A: We recommend a maximum of 5TB and 5 million objects per migration job. While Migration App itself doesn't impose a limit on migration jobs, we recommend parsing jobs into smaller subsets to facilitate ingress into the Egnyte back end.

 

Q: Why doesn’t the Migration App migrate empty folders?

A: This was not originally prioritized for the launch of the Migration App, but it is on our roadmap.

 

Q: Migration App failed to migrate some folders in the job. Why would that be?

A: If folders are empty, they will not be migrated. Another reason might be that the user logged into the CMM Agent doesn’t have the necessary permissions to view those folders. And finally, there are limitations to what Migration App can migrate. More information may be found in this Helpdesk article Filtered and Unsupported Objects with Migration App.

 

Q: If I re-run a migration job to True-up data, does it create duplicates of what was already copied previously?

A: The Migrate Data command does not per-se create duplicates. But there are some considerations to keep in mind. Let’s look at a couple of different scenarios when running Migration App for True-ups:

  • If a file is exactly the same at both the Source and the Destination, Migration App checks the size and mtime (mtime is a file attribute that records the time and date a file was last modified) of the file at Destination and does not re-send.
  • However, if a user renames or moves a folder to a different location on the Source, Migration App creates the new folder at the Destination and does not delete the old folder. That's when you get into a duplication scenario.
  • Alternatively, if a user deletes a folder on the Source that has already been migrated, the next time Migration App runs, it will delete that folder on the Destination. That’s because the Migration App is mirroring the two locations.

 

Q: For True-ups, what explains the discrepancy between the amount of data scanned on the source versus the amount of data migrated? What accounts for the discrepancy in the migrated data?

A: When you do a true-up, only the deltas will report as migrated. For example, you might have 90TB on the source, but only 20TB is new or changed. So only 20TB needs to be migrated as part of the true-up or synchronization process. We recognize this creates some confusion and look forward to seeing it resolved as our product matures and improves.

 

Q: If there are folders with more than 50K objects in them, can they still be migrated? Are 50K objects a hard limit or just a suggested limit for performance reasons?

A: 50K objects is a hard limit on the Egnyte platform, not of Migration App. You will need to break your folders down into smaller subsets to use Egnyte.

 

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.

 

 

Permissions

 

Q: How does Migration App migrate permissions?

A: Permissions migration involves three steps.

  1. Extract the permissions from the source
  2. Map it to what it should look like at the Egnyte side
  3. Apply it to the files on Egnyte

 

Q: How does Migration App map permissions?

A: See this Helpdesk article Permission Translation with Migration App.

 

Q: Can I “sync” or True-Up permissions with Migration App?

A: No. In Migration App, Permissions Migration is a one-time command. 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: What is the estimated speed for permissions to be applied in Migration App?

A: Once permissions are scanned and extracted from the source and mapped to Egnyte (the first 2 steps), they are then applied at a rate of one folder per second, regardless of the number of permissions aligned with each folder.

 

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. In the current version, during the first and second steps no information is communicated through the Migration Dashboard to the user. Only once the permissions are being applied to the files on Egnyte (Step Three) does the progress bar show any movement.

 

 

Sanitizing

 

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 Sanitization function do?

A: Running the Sanitize command changes any unsupported characters in filenames on the Source to an underscore. Once Sanitize is complete, rerun Scan, after which you will be able to migrate those renamed files successfully. Important: If you don’t want file names on the Source to be changed, do not run Sanitize. For more information about substitutions for unsupported characters, see this Helpdesk article Understanding the Sanitize Command in Migration App.

 

Q: After scanning, can I start migrating data without first sanitizing?  If so, can we sanitize later and just shore up any changes at that point?

A: Yes, that is entirely up to you. Sanitize is an optional command and can impact your Source file names. See this Helpdesk article Understanding the Sanitize Command in Migration App.

 

Speed, Bandwidth, and Throughput

 

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 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: We don’t yet have a mechanism available to change parameters like the number of threads. Migration App can only use the default threads (4 transfer and 4 checkers). We do plan to expose such configurable parameters as part of the migration job configuration in the future. For more information, see How Long Will it Take to Upload, Backup, or Download my Files?

 

 

Troubleshooting

 

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: Check out this Helpdesk article What if Cloud Migration Agent Registration is Hanging?

 

Q: What if I’m unable to execute any commands?

A: Check out 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: No, only Administrators can use the Migration App. Power Users can view the Migration Dashboard but cannot successfully run jobs.

 

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 all Administrators on a given domain.

 

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 the job.

 

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.

 

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 again.

 

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]