The sync service is a lightweight Windows service that you can run on any Windows machine to syncronise emails to your local file system.


Installation


When the Licenses/Tokens/Apps section of the portal becomes available, you will be able to download both the MSI installer and your license file from there.


Until then, we will have provided your license files via email and access to the installers via a shared folder.


NOTE: Be sure to download the File Sync Connector's LIC file too, as you will be required to provide it during installation


WARNING: Be sure to place the file on a local drive as the installer can fail to copy the license if it is on a network drive.

We are working with the installer vendor to resolve this.


If you encounter problems during installation, take a look at Sync connector won't install


Run the service under a domain account

We recommend that you create a user account specifically for the sync service which has read/write permissions on the required destination folders and then ensure that the service is run under this account. 


After installing the sync service, run the Windows Services application...


Locate the CloudFiler Sync Service... 


Right-click it, pick Properties  then select the Recovery tab and set the First, Second and Subsequent failure actions to Restart the Service:




Next select the Log On tab. Assign your specially created user, enter their password and click Apply, then OK.


WARNING: Be sure to assign a domain user and provide a password, otherwise the sync service will not be able to write to network folders.




For the change to take affect you will need to stop the service and restart it. Although you can restart the service, we recommend the following:

  1. Right-click the CloudFiler Sync Service and select Stop
  2. Right-click it again and select Start


If the sync service won't run as this user, take a look at Sync Connector won't run

Why would you sync messages locally?

Some customers want to keep copies of filed emails in local folders. For example they may have Windows folders for projects that have sub-folders for emails. CloudFiler can sync emails to these folders automatically. If you add locations via the Shell Extension, the path to the folder is automatically registered in CloudFiler. If you add a location via the portal or via the API, you can add a sync path.

How does it work?

The sync service communicates with the CloudFiler services and from time-to-time it will ask whether there are any messages for your tenant that need filing.

If the service has write permissions to the destination folder it will create the file locally. If not, the file is skipped.

Running multiple sync services

To avoid clashes we recommend that you only run one sync service per tenant. 

WARNING: Be careful not to run multiple sync services that share the same tenant, as clashes can occur.
 


File format and naming

The files are written in Microsoft's MSG format so that they open with a double click.

The file names are based on the ISO 8601 standard and the dates are in UTC time so that the server and your local copies share the same time stamp. 

Troubleshooting

Take a look at this troubleshooting page if files are not syncing as expected. Files are not syncing to your folders

Change Log

Check the Change log for patches and new releases.