Sync Service Admin FAQs

• Does Sync Service support Smart Folders?
• What tools can I use to validate the relative states of the MQ/Sync Service/Desktop Sync data/Alfresco data and the existing sync sets?
• What is the starting order of Sync Service?
• In the event of a conflict, how do I resolve it?
• What authentication does Sync Service support?

Does Sync Service support Smart Folders?

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

back to top

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

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

back to top

What is the starting order of Sync Service?

1. Postgres
2. ActiveMQ
3. Alfresco Content Services repository (Share)
4. Sync 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 Sync Service support?

back to top

How can I monitor ActiveMQ?

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 Sync Service?

To monitor Sync Service, see Sync Service health check.

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

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

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

• The Sync Service is running
• The 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 Sync Service

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 Prerequisites and supported platforms for more. A feature of the 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 Sync Service with a valid security certificate or disable SSL for the synchronization server if required.

back to top

How can I prevent the synchronization of a folder, or folder structure?

You can stop users from synchronizing folders by creating a custom model with an aspect, and then updating the configuration in Alfresco Content Services.

See Limiting folder synchronization for more.

back to top

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

See Backing up and restoring Desktop Sync.

back to top