ShareFile Windows Sync 2.6 Folder Structure Migration Failure

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:

User-added image

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.


Rename a ShareConnect Computer

You may rename a remote computer after you have installed ShareConnect on it, or after the computer has been shared with you via the Share Computers menu.

From the main Computers menu, click the icon beside the computer name and select the Rename option.

Enter the new name and hit Enter to save it.

Note: Changes to a computer name are only visible to the user making the change. If User A has shared a computer with User B, and User B uses the Rename function, only User B will see the new computer name.

User-added image


  • No Related Posts

Citrix-Managed storage zones

Designating a storage zone when creating a root level folder

When you create a root level folder, you may choose the zone in which that folder resides, whether it be a public or private zone, allowing for greater storage granularity. To create a root level folder and choose which zone you wish to store the folder’s data on, navigate to Shared Folders and use the Action Button to Create a New Shared Folder.

Name, describe, and add users to your Shared Folder. Use the storage zone drop-down menu to choose the zone of your Folder from both public and private options. Click the Create Folder button.

Changing a Folder’s storage zone

Once your Folder has been created and you have uploaded files to it, you may edit the Folder’s zone by clicking on More Options > Advanced Folder Settings drop-down menu to the right of the folder name. Click on the storage zone drop down menu to select which zone to which you wish to migrate your folder and all of its contents. Please note that clicking the Save button after making a Storage Zone change will initiate a migration of data from the origin zone to the new zone of your choosing. During this time your data will not be accessible.


Favorite Folders and Files

To add a folder or file to your favorites, click the Star icon to the left of the folder or file name.

To view all of your Favorite Folders, click on the Favorites tab in the left navigation menu.

Items in this list can be organized by selecting the gray grips along the right edge of the row. Click and hold to drag to move the file or folder up or down.


  • You cannot add a SharePoint folder that is a sub-site (ReadOnly) within your SharePoint Connectors menu.


How to Zip a File

How to zip on Microsoft Windows XP or later

To zip a folder, first locate the files or folders in Windows Explorer. You must then select the files or folders you wish to zip. Press and hold the CTRL key to select multiple files or folders simultaneously. Right-click the selected items and choose the Send to option, then click Compressed (zipped) folder.

When compression is complete, the .zip file will appear. You can then title the newly created .zip file. By default, the .zip file will be named after the last file or folder you selected.

User-added image

You can now upload the zipped folder.

How to zip on Mac OS X

To zip a file, first locate the desired files or folders in Finder. You must then select the files or folder you wish to zip. Press and hold the Command key to select multiple items consecutively.

Right-click, or Control + Click, the selected items, then choose Compress “filename” in the menu. When selecting multiple files, the option will read Compress # Items.

User-added image

When compression is complete, the .zip file will appear. The newly created .zip file will be named after the last file chosen. If multiple files or folders were zipped, the file will be named by default.

Zipping a file on operating systems without built-in zip functionality

Users on operating systems without built-in compression utilities can use 3rd party programs.


Folder Creator vs Folder Owner

Folder Creator vs Folder Owner

When a folder is created by a user, the creator will be listed as the Creator of the folder when viewing the folder as an individual item. Once you have navigated within that folder, you can view the current folder owner in the Folder Access pane at the bottom of the page. If a user created a folder, but has been removed from the account, that user will still be listed as the Folder Creator. However, Folder Owner will be changed when the deleted user’s folders and files have been reassigned to another user.

(The Creator Column denotes the original folder creator)

User-added image

(The current owner of the folder is denoted in the Folder Access pane)

User-added image


How to Prevent Clients with Download Access from Sharing Files in ShareFile Folder

This article describes how to prevent clients with download access from sharing files in ShareFile folder.


By default, all clients who have download access to a particular folder will see a “Share” button that will allow them to share any of the files in the folder to a third-party recipient. When clients are not allowed to share files, they will still be able to download items as usual, however they will not be able to share files to third-parties using ShareFile.

Note: If “No” is selected, the “Share” button will still appear in folders for employee users with download rights.


Troubleshoot On-Demand Sync Spontaneous File Downloads

The Windows Explorer thumbnails preview feature can cause the spontaneous download of image and executable files in ShareFile On-Demand Sync. To prevent this, the thumbnail preview feature should be disabled. The thumbnail preview feature is enabled by default in Windows Vista, Windows 7, and Windows 8. It allows the display in Windows Explorer of file icons a preview of the corresponding files. To provide this preview image, Windows Explorer must open image and executable files, which triggers the file to be downloaded through on-demand sync. This occurs upon browsing to the folder location of these files. Thumbnail previews can be disabled via group policy or for an individual user.

Disable the thumbnails preview feature via group policy

This process will disable thumbnails preview for a group of users or all users via Group Policy (administrator privileges are required). Depending on the use case open either the Local Group Policy editor or the Group Policy editor. For instance launch the Local Group Policy editor on a machine with the command line gpedit.msc . When launched, expand the tree view on the left side:

On Vista and Windows 7: User Configuration > Administrative Templates > Windows Components > Windows Explorer

On Windows 8: User Configuration => Administrative Templates => Windows Components => File Explorer

  1. Select the Windows Explorer or File Explorer node in the tree view on the left side panel. Select the Turn off the display of thumbnails and only display icons policy by double clicking it

    User-added image

  2. Select Enabled and then OK to apply.

    User-added image

  3. Note the policy might not be enabled right away. To force a refresh do the following from a command shell: gpupdate /force

Disable the thumbnails preview feature for an individual user

If desired, you can disable the thumbnails preview feature for an individual user. To do so, select Folder Options in the Control Panel. Select the View tab. Choose Always show icons, never thumbnails and then click Apply.

User-added image


ShareFile Sync – Extra 'New Folder' created from File Explorer

Why does ShareFile have an additional “New Folder” created when creating and renaming a new folder via File Explorer?

For accounts that have requested the “Creator Can Delete” setting disabled, when a user without the Delete permission on a folder creates a new folder within the File Explorer window, an additional “New Folder” is created. This behavior is a byproduct of how the sync app communicates the folder Rename action to the ShareFile account when a user that cannot delete attempts to rename the new folder. To avoid this behavior, consider creating new folders locally before adding them to the desired location within Sync, so they may be treated as an upload by the system.


Renaming ShareFile Sync Folders

You cannot rename the folders directly listed in Shared Folders or Favorite folders. However, any subfolders within those folders can be renamed in your operating system, just like it was any other folder locally, as long as you have delete and upload permissions on that folder in ShareFile.

However, as a best practice, ShareFile recommends renaming folders in the ShareFile web application, and not locally. When renaming folder directories locally, Sync will need to perform a new upload or download of data, which may not be ideal for certain use cases. Instructions for renaming a folder on the web application are available here.

The only exception to this recommendation is if your account uses the Archiving service. Because accounts with Archiving cannot rename the folder through the Web application, the upload/download process triggered by Sync would automate the process needed to get a new folder with the requested name online.