Have sync-engine running
If you haven't do so already, please make sure that the sync-engine is running. You can do this by opening up a terminal and start it with:
$ sync-engine
Ubuntu users should not have to execute the sync-engine manually: it will be launched automatically by dbus when its presence is required. If you do want to start it manually under Ubuntu, you should execute
$ synce-sync-engine
If you get the following error:
File "/usr/bin/sync-engine", line 84, in <module>
configObj = Config.Config(progopts)
File "/usr/lib/python2.5/site-packages/SyncEngine/config.py", line 292, in __init__
oldconf = os.path.join(self.path,"config.xml")
AttributeError: Config instance has no attribute 'path'please download [http://synce.svn.sf.net/svnroot/synce/releases/0.11.1/sync-engine/config/config.xml config.xml] and save it as ~/.synce/config.xml
After that starting sync-engine should work.
Create a partnership
Now we have the sync-engine running you can create a partnership between device and computer by typing in another terminal:
$ create_partnership.py "Linux desktop" "Contacts,Calendar"
Ubuntu Hardy users should instead execute
$ synce-create-partnership "Linux desktop" "Contacts,Calendar"
The "Linux desktop" string can be any string of 20 characters or less. The available items for synchronization are:
- Contacts
- Calendar
- Tasks
- Files
When specifying items to sync, they must be separated by commas. You must also surround the list in double quotes and the string must not contain any whitespace.
If you see an error like:
$ synce-create-partnership "Linux desktop" "Contacts,Calendar,Tasks,Files" Creating partnership... error: failed to create partnership error: org.synce.SyncEngine.Error.NoFreeSlots
This means that there is no more room for partnerships on your phone. You can only have two partnerships with normal computers and one additional partnership with an exchange server on the device. If you get this error, you will first have to delete a partnership on your device to create room for a new one.
Configuring SyncEngine
There is a ~/.synce/config.xml file that can be edited to adjust the behaviour of SyncEngine. It is created the first time SyncEngine is run. It is an XML file and each attribute is documented in the file.
Set up OpenSync
../OpenSync contains information on setting up OpenSync.