Mobile Synchronization

In order to provide Mobile Synchronization you'll need to install Funambol Data Synchronization Server.

You can download Funambol server from here:

Windows
Funambol Server for Wndows

Windows 64
Funambol Server for 64 bit Windows

Linux
Funambol Server for Linux

Linux64
Funambol Server for 64 bit Linux

Upon obtaining Funambol Data Synchronization Server please install it into

for Windows

    C:\Program Files\Funambol

for Linux

    /opt/Funambol

In the rest of this document, this Funambol installation directory will be referred to as $FUNAMBOL_HOME.

Once installation is completed, you need to configure Funambol Server. It should be configured to use the same MySQL Database that was specified for WebMail. You need to configure properties file for Funambol Data Synchronization Server. The $FUNAMBOL_HOME/install.properties file is the central configuration information storage that is used by the installation procedure to set up the Funambol Data Synchronization Server. Please, follow the below steps to configure Funambol Server:

  1. Download MySQL connector from official MySQL page
  2. Copy MySQL connector to

    for Windows

        $FUNAMBOL_HOME\funambol\tools\jre-1.6.0\jre\lib\ext
    

    for Linux

        $FUNAMBOL_HOME/funambol/tools/jre-1.6.0/jre/lib/ext
    
  3. Modify the following file:

    for Windows

        $FUNAMBOL_HOME\funambol\ds-server\install.properties
    

    for Linux

        $FUNAMBOL_HOME/funambol/ds-server/install.properties
    

    Change the value of the dbms parameter to: dbms=mysql

  4. Comment out the hypersonic configuration section:
        #jdbc.classpath=../tools/hypersonic/lib/hsqldb.jar
        #jdbc.driver=org.hsqldb.jdbcDriver
        #jdbc.url=jdbc:hsqldb:hsql://localhost/funambol
        #jdbc.user=sa
        #jdbc.password=
    
  5. Place the MySQL configuration: details:

    for example:

    for Windows

        jdbc.classpath="C:\Program Files\Funambol\tools\jre-1.6.0\jre\lib\ext\mysql-connector-java-<version>-bin.jar
    

    for Linux

        jdbc.classpath=/opt/Funambol/tools/jre-1.6.0/lib/ext/mysql-connector-java-<version>-bin.jar
    

    jdbc.driver=com.mysql.jdbc.Driver
    jdbc.url=jdbc:mysql://db_host:db_port/db_name?characterEncoding=UTF-8
    jdbc.user=db_user
    jdbc.password=db_user_password

  6. Run the following command:

    for Windows

        $FUNAMBOL_HOME\funambol\bin\install.cmd
    

    for Linux

        $FUNAMBOL_HOME/funambol/bin/install
    
  7. answering 'y' to all questions.
    After that, run the service

    for Windows
    Start->Programs->Funambol->Data Synchronization Server->Start Server

    for Linux
    $FUNAMBOL_HOME/funambol/bin/funambol start

    then specify Mobile Sync URL in AdminPanel->WebMail->MobileSync as described here

  8. The final step in setting up Synchronization - you should set the following script to be launched by your OS once a minute:
        $WEBMAIL_ROOR/calendar/cron/funambol.php Cron job should run PHP interpreter with funambol.php file as a parameter. Something like this:
    php -f /path/to/calendar/cron/funambol.php