- So, what gets synced?
- Can I use Desktop Sync during initial sync?
- Will syncing happen while I am offline?
- Where can I find my synced files?
- How many folder levels can I sync?
- Can I cancel initial sync?
- I made changes to a local file that aren't showing in Alfresco.
- What's the orphaned folder in my local synced drive?
- If a file is checked out by another user in Alfresco, can I update it?
- When will a deferred file be synced?
- I see a red flag on my menu bar. What does that mean?
- Do I need to restart Desktop Sync when I restart my computer?
- Can I use Desktop Sync while I am offline?
- What happens to a file/folder which is moved out of Alfresco folder on my desktop?
- Why can't I see status icons on my files and folders?
- What happens if two Alfresco sites have the same name?
- What happens if the site name is invalid or contains unsupported characters?
- What is the Icon? file in the Alfresco Content Services sync folder?
- Where do I find the Desktop Sync log file?
- Where do I find the Desktop Sync crash log file?
- I no longer need a site. How do I remove the site and its contents from my desktop?
- Will my files be versioned in Alfresco?
- Can I recover a deleted file using Desktop Sync?
- Which file extensions are supported by Desktop Sync?
- If a file has a file extension which is in the exempted list above, how can I include that file in the sync set?
- How are files with an unknown or no extension handled?
- What files should be backed up/restored on the client?
- I have a new computer, is it possible to migrate my Alfresco sync folder to the new computer?
So, what gets synced?
Desktop Sync shows you all your Alfresco sites and folders which you have access to, plus your My Files and Shared Files content. You can select any (or all) of these and click Sync to create a local copy of the content on your computer.
Individual files you've favorited aren't displayed and can be synced directly, you need to sync the folder they're in.
Whenever you update any of this local content (which includes adding, moving, and deleting files and folders within the synced area) these changes will automatically be replicated on Alfresco.
Whenever you or anyone else make changes in Alfresco to sites or folders that you've synced with, then these changes will be replicated in your local content.
Can I use Desktop Sync during initial sync?Yes. During initial sync, any content created on your desktop will be synced only after the initial sync is over.
Will syncing happen while I am offline?Sync needs a connection to the server. Syncing will resume when the connection is restored.
Where can I find my synced files?The content is synced to <userHome>/Alfresco. The Alfresco folder can also be found in Finder under Home.
How many folder levels can I sync?You can sync as many folder levels on a Mac. This is only a limitation of the Windows File System, where the maximum length for a path should not be more than 260 characters.
Can I cancel initial sync?Yes. As a Desktop Sync user, you can either:
- Take your computer offline: You can simply ignore initial sync and shut down your computer or disconnect the network. Initial sync will resume when connection is restored.
- Keep your computer running but discontinue initial sync: You can quit Desktop Sync and initial sync will resume when you restart Desktop Sync.
- Amend your selected content choices by clicking Return to Content Selection.
I made changes to a local file that aren't showing in Alfresco.
A number of scenarios can cause this:
- The file is held/locked open by an application on your computer.
- Network connection problems, Alfresco connection problems, or synchronization service connection problems; contact your IT team.
- If you've made changes locally that are showing in Alfresco, then make sure that Desktop Sync is running by confirming that the icon is showing in the system tray (Windows) or menu bar (Mac).
- It's also possible that someone was updating the content in Alfresco at the same time as you were updating the local content. The file is in conflict state. See Conflict matrix on how to resolve the conflict.
What's the orphaned folder in my local synced drive?
If you deselect synced content in Desktop Sync and click Sync, then you're effectively breaking the link between local content and Alfresco content.
The content won't be synced any more. Files that weren't synced to Alfresco due to conflict or deferred can be found in the orphaned folder. This folder is automatically created in your synced area and the previously synced content is moved to there.
If a file is checked out by another user in Alfresco, can I update it?No, you can't update files that are checked out by other users.
When will a deferred file be synced?
- When you don't have free space on your desktop.
- If you have an Office file open and you're saving it to your computer.
- You're not connected to the server.
Resolve the issue and your file will be synced automatically.
I see a red flag on my menu bar. What does that mean?See Working with Desktop Sync to find out what each of the Desktop Sync icons means.
- You can only resolve the parent folder.
- You can't resolve the child as the Finder menu actions aren't visible.
- Any children in conflict are shown in an indented list below the parent.
- Once you select a resolution, the child is resolved using the same choice as the parent.
Do I need to restart Desktop Sync when I restart my computer?No, Desktop Sync is automatically started when your computer starts.
Can I use Desktop Sync while I am offline?You can continue working on your files offline and they'll be synced to Alfresco whenever you have a connection to the server.
What happens to a file/folder which is moved out of Alfresco folder on my desktop?The moved file or folder is deleted in Alfresco.
Why can't I see content icons on my files and folders?
If, for some reason, your content icons are hidden in Finder, you can make them visible by checking your System Preferences. See note about content iconsfor more details.
Additionally, check if you have accidentally quit Desktop Sync. Upon restart, the icons should be restored.
What happens if two Alfresco sites have the same name?If the site name is duplicated, one of the site names will be displayed as SiteName_01, for example, Test Site_01.
What happens if the site name is invalid or contains unsupported characters?A file name can't contain the following characters: \ / : * ? " < >. Desktop Sync replaces these characters with underscores, for example, Test>test is replaced by Test_test on your desktop.
How do I uninstall Desktop Sync?
Can Desktop Sync be installed in an unattended mode?Yes.
Upon unselecting not all files are getting removed. What's wrong?When a file or folder is locked by Finder, applications, like Desktop Sync, can't remove that file and folder. In that case, when unsubscribing content or removing the application, some files and folders maybe left behind. They should be removed manually.
What is the Icon? file in the Alfresco Content Services sync folder?
Icon? is a hidden file that's used by Mac OS X to put the Alfresco Content Services logo on the Alfresco Content Services sync folder in Finder.
Where do I find the Desktop Sync log file?
If you're having any issues with Desktop Sync, then your IT team might ask you to provide the log file.
- ~/Library/Application Support/Alfresco/AlfrescoSync.log
Where do I find the Desktop Sync crash log file?
If Desktop Sync quits unexpectedly, a log file is generated that can help to identify potential issues on your Mac. To help troubleshoot the issue, your IT team may ask you to provide the crash log.
- In Finder, click on the Go menu and select Go to Folder.... A text field should appear in Finder.
- Paste the path ~/Library/Logs/DiagnosticReports/ into the text field and click Go.
- In this folder, find all log files with filename Alfresco*.crash.
- Send these files to your IT team.
I no longer need a site. How do I remove the site and its contents from my desktop?Go to Settings > Manage Sync Folder and deselect the sites you no longer need. Click Sync to remove the selected files and folders from your desktop.
Can I use Desktop Sync while I am offline?You can continue working on your files offline but they will get synced to Alfresco whenever you have a connection to the server.
Will syncing happen while I am offline?Sync needs a connection to the server. Syncing will resume when your connection is restored.
Will my files be versioned in Alfresco?Yes. All file updates synced in Alfresco using Desktop Sync are versioned.
Can I recover a deleted file using Desktop Sync?Yes. Any file deleted in Alfresco using Desktop Sync is moved to the Alfresco trashcan.
Which file extensions are supported by Desktop Sync?Desktop Sync syncs all file extensions except for the temporary file extensions mentioned in the table below:
If a file has a file extension which is in the exempted list above, can I include that file in the sync set?Yes. In the ~/Library/Application Support/Alfresco/AlfrescoSync.conf file, find the Sync constraints section, and update the syncmanager.constraint.1=FileExt|.tmp,.temp property.
How are files with an unknown or no extension handled?When a file is renamed in Alfresco Content Services to either an unknown extension (such as .aaa) or to remove the extension, it may not open on your computer. Since the file extension is used to associate programs with files, rename the file to a known extension to fix the file association so you can open the file.
What files should be backed up/restored on the client?You'll find the synced data in the <userHome>/Alfresco folder. The sync client settings/database/logs are in the ~/Library/Application Support/Alfresco folder.
When the sync client starts up, it uses the modification time stamp from the AlfrescoSync.time file in the /Application Support/Alfresco folder to check if any files/folders were changed while Desktop Sync wasn't running. If you delete and recreate the AlfrescoSync.time file after restoring the Desktop Sync data and settings, it'll do a full scan of the local and remote folders.
I have a new computer, is it possible to migrate my Alfresco sync folder to the new computer?To avoid problems with conflicts on device registration, and content going out of sync during the migration process, you should first remove your account from the deprecated computer and then setup Alfresco Desktop Sync on the new machine.