Groupware sync readme

bionicmessage.net Groupware sync server, December 2010 release - The Groupware sync server is based on Funambol DS server, a open source OMA DS (formerly SyncML) implementation developed by Funambol, Inc.[1]

The Groupware sync server bundles several components used to bridge GroupDAV[2] servers with mobile devices. These include: - GroupDAV address/calendar connector - Citadel push email connector - HTTP Authentication officer - WebConfig setup wizard - HTTP-SMS gateway module

Components not generally used in the GroupDAV context have been stripped out. Those desiring the following may download Funambol from funambol.org and install the above components into the server manually: - CTP server (TCP based push notification) - Java demo client - Inbox listener (POP/IMAP inbox polling for push) - Web Demo client

[1] Funambol.com / funambol.org Requirements - A Java 6.0 runtime is required. To avoid duplication I have not included the JRE with this distribution, one may obtain the runtime from java.com or use packages from their operating system distribution (derivates such as OpenJDK work as well). The JAVA_HOME environment variable must be set to the path of the JRE for the server to start.

This server is configured to use ports 8080 (HTTP), 8005 (control) and 8009 by default. You can reconfigure this by editing tools/tomcat/conf/server.xml

Usage - The server may be started by running 'bin/funambol'. On the first installation you should navigate to http://localhost:8080/webconfig* and login as an administrator with credentials username: 'admin' password: sa

Then, run the groupware wizard, selecting your server time and entering the relevant details. Providing configuration is successful, the server will be available for immediate use.


 * You may access this from another machine, replace the name and port appropriately.

Client configuration -- The SyncML database names have been changed in this release to replace the Funambol default databases to allow easier client side configuration and to facilitate the use of clients where changing the database name is not yet possible (i.e Funambol's Android client)

Therefore, for the Funambol clients, only the following information is needed: Server URL: http://yourserver:8080/funambol/ds Username: as with GroupDAV server Password: as with GroupDAV server

For non Funambol clients: Calendar: event Tasks: task Address book: card

Symbian-OS based phones (S60 and UIQ) need to use the combined groupdav-s60-v database for calendar and tasks.

Notes on clients

This release marks a change in client support priorities. Android 2.2 is now the 'flagship' client, and driven by demand from users, Blackberry OS 5 is now tested as well, along with Outlook.

At the time of writing, the Funambol Android client from the Android market does not support Calendar or Task sync. A snapshot (which is relatively stable) may be obtained from https://core.forge.funambol.org/ds/viewMessage.do?dsForumId=405&dsMessageId=132012. You will need to be able to install non-market Android apk's to use it.

Android calendar support depends on Android 2.2, due to 2.1 and earlier not having calendar API's. On some phones, the sync may be 'linked' to the users Google account, so the user should disable Google calendar sync in this instance.

Task support uses the third party Astrid task manager.

As of this release, support for the older, Funambol 'proprietary' SIF format is dropped.

Feedback -- A discussion forum is available at https://comalies.citadel.org or as a mailing list subscription at https://comalies.citadel.org/listsub.

I may be contacted regarding issues with this software distribution at info@bionicmessage.net. Please be aware that responses may be sluggish at times, but I endeavor to respond as best I can within the time I have available.

Some useful documentaion covering previous versions of the server is available at http://bionicmessage.net

At the time of writing, I am in the process of migrating the source code repositories (in git) to gitorious.org at http://gitorious.org/bmessage-funambol

Enjoy, Mathew McBride December 2010