You are here

Administering Desktop Sync FAQs

Here's a list of common questions about Desktop Sync.

Does Desktop Sync support Alfresco Records Management?

No, this version of Desktop Sync doesn't support Alfresco Records Management.

back to top

Does Desktop Sync support Smart Folders?

No, this version of Desktop Sync doesn't support Smart Folders.

back to top

What tools can I use to validate the relative states of the MQ/synchronization server/Desktop Sync data/Alfresco data and the existing sync sets?

To bring the synchronization service and Alfresco repository in sync, see Backing up and restoring Desktop Sync. Currently, there are no tools that can validate this.

back to top

What is the starting order of Desktop Sync?

The sequence in which different Desktop Sync components should be started is:
  1. Postgres
  2. ActiveMQ
  3. Alfresco repository (Share)
  4. Synchronization service

back to top

In the event of a conflict, how do I resolve it?

The conflict resolution matrix describes how Desktop Sync handles sync conflicts.

back to top

What authentication does Desktop Sync support?

Desktop Sync supports basic authentication. SAML SSO is currently not supported.

back to top

How can I monitor ActiveMQ?

Access the ActiveMQ Web Console using http://<servername>:8161/admin/queues.jsp.
Make sure that the:
  • name of the subscriber corresponds to the synchronization service ID.
  • total number of Messages Enqueued is same as Messages Dequeued.

For detailed information, see How can I monitor ActiveMQ?

For information on ActiveMQ logging, see How do I change the logging.

back to top

How can I monitor Desktop Sync and the synchronization service?

To monitor Desktop Sync, see Configuring Desktop Sync (for Windows), or Configuring Desktop Sync (for Mac), and for synchronization service, see synchronization service health check.

To get detailed logging information on synchronization service, change the logging level in the config.yml file as shown below:
logging:
 level: DEBUG
loggers:
   "org.alfresco.service.common.auth": DEBUG
   "org.apache.activemq": DEBUG
   "com.sun.jersey.api.container.filter.LoggingFilter": WARN
   "org.alfresco.service": DEBUG
back to top

Why does the Desktop Sync client connect for content selection then immediately go offline?

If the Desktop Sync client connects to Alfresco to start content selection then immediately goes offline, folders may already have been created, but no files have been synced; check the following:

  • The Desktop Sync service is running
  • The Desktop Sync service is accessible from the client - you can use the Healthcheck URL in the clients browser
  • The global properties file is correctly set up - see Installing Desktop Sync service

For example, if the Sync Service port is not open on the firewall, then the client won't be able to connect to the Desktop Sync service, or the Healthcheck URL. The port is set when Installing Desktop Sync service, where the default is 9090.

back to top

What can I check if content can't be added to or updated in Alfresco Content Services via Alfresco Share or another application?

To fix this issue, check if ActiveMQ is running and available to the repository. See Desktop Sync prerequisites for more. A feature of the Desktop Sync service is to provide resilience of the service, and ensuring that no critical event information is lost.

The recommendation is to run an ActiveMQ cluster to ensure high availability.

back to top

Why has sync stopped working since upgrading the client operating system (for example to Mac OS X to Sierra High)?

If SSL has been enabled on the Sync Service without provision for a signed certificate, then the clients may fail to sync content. The log files contain a message "SSL peer certificate or SSH remote key was not OK". Install the Desktop Sync service with a valid security certificate or disable SSL for the synchronization server if required.

back to top

What tools can I use if either the desktop or Alfresco needs to restored from a backup?

See Backing up and restoring Desktop Sync.

back to top

Sending feedback to the Alfresco documentation team

You don't appear to have JavaScript enabled in your browser. With JavaScript enabled, you can provide feedback to us using our simple form. Here are some instructions on how to enable JavaScript in your web browser.