This article describes the most common reasons for the “Personal Folder Migration Failed” error message when upgrading Citrix ShareFile Sync for Windows or Mac.
ShareFile Sync for Mac: Personal Folder Migration Error
When upgrading ShareFile Sync for Mac, you may encounter the error message shown below:
The first attempt to resolve this should be to restart your computer and let the migration attempt to proceed again. If this fails, Mac Sync was likely already in an error state that you may not have noticed. It is suggested to contact ShareFile Customer Support for a detailed analysis of the Sync log files. If you are unable to contact support, the alternate method is to uninstall Mac Sync and perform a clean installation which will create the new folder structure, and download your files from the cloud storage.
Completely Uninstalling ShareFile Sync for Mac
To uninstall Mac Sync, following these steps:
1. Ensure no ShareFile process is currently running on your system. To do this, open Activity Monitor from Utilities. Search for the process SyncEngine and/or ShareFile. If either process is found, select the Force Quit from the menu bar in Activity Monitor.
2. Open Finder and go your Applications folder. Move ShareFile to the trash.
3. Open Finder and go to ~/Library/Logs. You can reach this location by selecting Go > Go To Folder. Move the ShareFile folder to the trash. (Save a copy of your logs if you plan to contact support for further investigation)
4. Open Finder and go to ~/Library/Preferences. You can reach this location by selecting Go > Go To Folder. Move any items to the trash that start with com.citrix.sharefile.
5. Open Finder and go to your ShareFile sync directory. This path is typically ~/ShareFile, but may differ if the local sync location was previously changed. Make a backup copy of your ShareFile folder for safekeeping and then delete the original folder. (This will ensure the new installation can proceed without conflict)
6. Open KeyChain Access from Utilities and delete keychain entries for ShareFile (SFSyncPassword*, SFSyncToken*)
7. Restart your computer and attempt a re-installation of ShareFile Sync.
If the above steps fail, please contact ShareFile Customer Support.
ShareFile Sync for Windows: Personal Folder Migration Error
File in use
The most common reason for the migration to fail when upgrading the ShareFile Sync tool is when you have a document which resides in one of the sync folders currently being used. With version 2.6.x and above, a prompt is displayed to close the applications which might be using the files. To fix this issue, save and close any applications which are open and click Retry button. If the issue persists, click Close, log out, and log on another time.
Path too long
When migrating the ShareFile tool, some folders might exceed 248 characters in length, which is a hard limit set by the Windows Operating System. If the folder exceeds the length, an error occurs because the path is longer than the defined value.
Complete the following steps to fix the issue:
1. Ensure that all the work is saved.
2. Open Windows Explorer.
3. On the address bar, type %appdata%ShareFileSyncEngine and press the Enter key.
4. Locate the file sfconfig.db in this directory.
5. Rename the sfconfig.db file to sfconfig.db.old.
6. Restart the machine.
7. When the machine restarts, the sync prompts to reconfigure the settings.
8. Select a folder where you want to sync in the wizard.
9. Ensure that new folder has a shorter path when compared to the previous configured path. For example, If the older path was C:UsersMyNameCitrixShareFileSync , then save the new path in C:UsersMyNameShareFile.
10. Wait for the client to sync and if any of the files are not updated, copy the up-to-date file from your old sync location.
If the above steps fail, please contact ShareFile Customer Support.