This page is serving as the basis to help form a how-to guide to install the Funambol sync server on an Ubuntu server. It uses mod_jk instead of requiring an installation of Tomcat. It will be modified.

It is assumed you have a LAMP server installed and is a modification of:

https://wiki.objectweb.org/sync4j/Wiki.jsp?page=UsingFunambolWithApache

Configure Apache with mod_jk

Download modjk 1.2.x

• Download the latest package available from Tomcat connector page:

http://www.apache.org/dist/tomcat/tomcat-connectors/jk/binaries/linux/jk-1.2.27/i386/

 root% cd /usr/lib/apache2/modules/
 root% wget http://www.apache.org/dist/tomcat/tomcat-connectors/jk/binaries/linux/jk-1.2.27/i386/mod_jk-1.2.27-httpd-2.2.6.so

• Rename the lib to mod_jk.so.

 root% mv mod_jk-1.2.27-httpd-2.0.61.so mod_jk.so

Configure the modjk workers

• Under APACHE_HOME/conf, create workers.properties (available at the original site). See workers.properties configuration for more details about that file.

 root% cd /etc/apache2
 root% wget --no-check-certificate https://wiki.objectweb.org/sync4j/attach?page=UsingFunambolWithApache%2Fworkers.properties

• Rename file:

 root% mv attach\?page\=UsingFunambolWithApache%2Fworkers.properties workers.properties

Configure the Apache URIs served by modjk (the applications served by JBoss/Tomcat)

• Create a uriworkermap.properties file in the APACHE_HOME/conf directory (see attached file).

 root% cd /etc/apache2
 root% wget --no-check-certificate https://wiki.objectweb.org/sync4j/attach?page=UsingFunambolWithApache%2Furiworkermap.properties

• Rename file:

 root% mv attach\?page\=UsingFunambolWithApache%2Furiworkermap.properties uriworkermap.properties

Create the modjk config

• Under APACHE_HOME/conf, create mod-jk.conf (see attached file)

 root% cd /etc/apache2/mods-available/
 root% wget --no-check-certificate https://wiki.objectweb.org/sync4j/attach?page=UsingFunambolWithApache%2Fmod-jk.conf
}}

 * Rename file:

{{
 root% mv attach\?page\=UsingFunambolWithApache%2Fmod-jk.conf mod-jk.conf

• Create a symlink from mods-available to mods-enabled

 root% cd /etc/apache2/mods-enabled
 root% ln -s ../mods-available/mod-jk.conf mod-jk.conf
 lrwxrwxrwx 1 root root   29 2009-03-10 20:15 mod-jk.conf -> ../mods-available/mod-jk.conf

Configure mod-jk.conf

 root%# vim /etc/apache2/mods-enabled/mod-jk.conf

Make the following changes

 # Load mod_jk module
 # Specify the filename of the mod_jk lib
 (-)LoadModule jk_module modules/mod_jk.so
 (+)LoadModule jk_module /usr/lib/apache2/modules/mod_jk.so 

 # Where to find workers.properties
 (-) JkWorkersFile conf/workers.properties
 (+) # JkWorkersFile /etc/apache2/workers.properties
 (for some reason, Apache says that this is already installed upon restart)

 # Where to put jk logs
 (-) JkLogFile logs/mod_jk.log
 (+) JkLogFile /var/log/apache2/mod_jk.log

 # You can use external file for mount points.
 # It will be checked for updates each 60 seconds.
 # The format of the file is: /url=worker
 # /examples/*=loadbalancer
 (-)JkMountFile conf/uriworkermap.properties
 (+)JkMountFile /etc/apache2/uriworkermap.properties

 # Add shared memory.
 # This directive is present with 1.2.10 and
 # later versions of mod_jk, and is needed for
 # for load balancing to work properly
 (-) JkShmFile logs/jk.shm
 (+) JkShmFile /var/log/apache2/jk.shm

Change APACHE_HOME/conf/httpd.conf

 root% vim /etc/apache2/httpd.conf
 # Include mod_jk configuration file
 Include /etc/apache2/mods-enabled/mod-jk.conf

-Not sure if this is necessary if I've added it to mods-enabled

Restart apache

 root% /usr/sbin/apache2ctl start

Install Funambol

Now that it is configured, you follow the instructions on the funambol site.