Question

A remote CMIS repository contains many folders/files.

I am writing a software that keeps a local copy of these folders/files in sync.

1. At first run I just download everything recursively.
2. At later runs, I check what has changed, and download any changes.

What is the most efficient way to check the remote changes?
(additional/removal of files/folders)
Most efficient = Least bandwidth usage.

I can only use the CMIS protocol, and I can not run any custom software on the remote server.

My ideas so far:

• Idea 1: Re-download everthing every time.
• Idea 2: Check the root folder’s modification date, hoping modification dates are recursive.
• Idea 3: Use CMIS search to find all files that are more recent than the last time I synchronized. Problem: that won’t tell me which files have been removed.

Any other ideas?
I don’t know the CMIS protocol much, there might be something more convenient.

Answer 1

Using the repository’s change log is the right way to go, but realize that not every repository supports this. For example, for Alfresco you must configure the audit sub-system and you must set audit.cmischangelog.enabled=true in alfresco-global.properties.

To find out if your repo supports changes you can look as the results of the repository’s getCapabilities response. If you see ‘Changes’ set to ‘None’ then your repository doesn’t support change logs.

Assuming it does, you need to ask the repository for its latest change log token. You can get that from getRepositoryInfo. Save that before you call getContentChanges. Then, on the next call, pass in the token. You’ll get the changes made since the token was issued.

So, your code needs to:

1. Check getCapabilities for something other than Changes = None
2. Save the getRepositoryInfo’s latestChangeLogToken
3. The first time you ask, call getContentChanges with no arguments
4. The next time you ask, call getcontentChanges with the last saved token
5. You can then process the result set. Each change log entry tells you its type (created, updated, deleted, permissions, etc., see spec for exact values) and provides the cmis:objectId of the changed object.
6. Repeat with step 2.

I have a “cmis-sync” script that does one-way synchronization using this approach implemented in Python. I’ve tested it against Alfresco as the source and the OpenCMIS InMemory repository as the target. If there is interest I can make it available.