Groupware Sync Server setup

From December 2008, the Groupware sync server snapshots come with a web based administration interface which aides in configuring the server for sync and user management tasks. This has essentially reduced the setup process to "one-click".

Contents 1 Basic installation README 2 Configuring your devices 2.1 Data format 2.2 Mail 3 Changing Funambol's administrator password 4 Additional configuration

Basic installation README

Do you already have an existing Apache Tomcat server on your system? Or a service running on port 8080? Edit tools/tomcat/conf/server.xml before continuing to assign new port numbers. You will need to change the management port (8005) if you have an existing Tomcat, and then port 8080 for HTTP.

Downloaded the package without the JRE? Remember to set the JAVA_HOME environment variable to the path of JDK/JRE 1.6 on your system.

1. As packaged, the sync server is ready to start out of the box. After extracting it can be started with a simple command:

cd Funambol && bin/funambol start

2. Then, point your browser to the web administration URL, which, if you are reading this on the same machine would be: http://localhost:8080/webconfig/

NOTE: Internet Explorer currently does not work well with the administration interface

The default login details are:

Username: admin
Password: sa
User type: Administrator

3. Once logged in, click on the "Groupware Sync Wizard" from the navigation bar at the top.

4. All the wizard needs is the URL of your servers' GroupDAV root. A few examples are listed on the screen.

• If you use Citadel, you will be asked for the actual host of the Citadel server for the Citadel email connector
• The wizard allows you to select "local" and "Groupware" authentication. Local authentication creates user details in the Funambol database as users connect and perform their first sync. Groupware authentication authenticates sessions with the Groupware server. Only chose local authentication if you have non-Groupware users connecting and using Funambol's backup sync sources.
• When ready, hit 'Apply configuration'
• Thats it! You will get a list of configuration tasks to summarize what has been done. You are ready to sync.

Configuring your devices

Configuration details for most devices are listed on the Sync info screen. For your convenience they are repeated here:

You can use any SyncML client software to sync with this server.

Use the following settings:

SyncML Server	http://<your server>:8080/funambol/ds
Username and Password	Same as your groupware server
Calendar sync source	groupdav-cal-v
Task sync source	groupdav-task-v
Address Book sync source	groupdav-addr-v

Data format

All of the above sync sources use the vCalendar/vCard formats (text/x-vcalendar / text/vcard). Symbian OS based devices, such as Nokia S60 and Symbian UIQ should use groupdav-s60-v as the combined calendar/task sync source.

Some older Funambol clients use SIF XML sources (use -s instead of -v). These are being phased out of newer clients

Mail

If you are syncing mail, use the mail sync source

Changing Funambol's administrator password

The administrator password can be changed in the users screen of WebConfig. However, you should edit the CTP server configuration ( config/com/funambol/ctp/server/CTPServerConfiguration.xml as it needs a copy of the administrator password to connect to Funambol and issue push alerts to clients.

Additional configuration

Refer to the older Groupware_sync_guide for some manual configuration tasks, i.e setting logging to verbose and configuring Citadel to issue new email alerts to Funambol.