374
edits
Changes
From SME Server
Jump to navigationJump to searchReordered some sections.
{{Needs review}}
{{Needs review}}
{{Level|Advanced}}
{{Level|Advanced}}
== Introduction ==
== Introduction ==
The Funambol middleware allows you to synchronize mobile devices with [[Sogo:SOGo]] through the
use of the Funambol [[Sogo:SOGo]] Connector. The connector allows any SyncML enabled devices to
fully synchronize contacts, events and tasks with [[Sogo:SOGo]].
This is a very preliminary writeup on the installation of Funambol on an SME8b5 installation for use with [[Sogo]]
This HOWTO describes the installation procedure for installing Funambol with the [[Sogo:SOGo]]] Connector on an SME8b5 installation.
== Download & Install Funambol ==
== Download & Install Funambol ==
Goto https://www.forge.funambol.org/DomainHome.html
Goto https://www.forge.funambol.org/DomainHome.html
to download Funambol 8.0. The latest GNU/Linux 32bit funambol server is 8.5, but this has not been confirmed yet for use with SOGO.
to download Funambol 8.0. The latest GNU/Linux 32bit funambol server is 8.5, but this has not been confirmed yet for use with SOGO.
At the end of the install, answer '''NO''' on the question if you want to start the server.
At the end of the install, answer '''NO''' on the question if you want to start the server.
== Download & Configure MySQL JDBC driver ==
== Download & Configure MySQL JDBC driver ==
Funambol by installation defaults to use the Hypersonic DB engine, but SOGO requires the use of MySQL.
Funambol by installation defaults to use the Hypersonic DB engine, but SOGO requires the use of MySQL as the Funambol database.
Goto http://dev.mysql.com/downloads/connector/j/5.0.html to download the JDBC driver for MySQL. The current version is '''mysql-connector-java-5.0.8.zip'''.
Goto http://dev.mysql.com/downloads/connector/j/5.0.html to download the JDBC driver for MySQL. The current version is '''mysql-connector-java-5.0.8.zip'''.
== Reconfigure MySQL for InnoDB and access from the local network ==
== Reconfigure MySQL for InnoDB and access from the local network ==
Funambol uses MySQL wit the InnoDB engine and uses networking for access.
Funambol uses MySQL wit the InnoDB engine and uses networking for access.
== Creating MYSQL user and database ==
== Creating MYSQL user and database ==
To create the Funambol Database, you'll need to perform each of the following steps:
To create the Funambol Database, you'll need to perform each of the following steps:
== Disable Hypersonic JDBC driver ==
== Disable Hypersonic JDBC driver ==
Edit '''/opt/Funambol/bin/funambol''' and change '''COMED=true''' to '''COMED=false''' somewhere around line 44.
Edit '''/opt/Funambol/bin/funambol''' and change '''COMED=true''' to '''COMED=false''' somewhere around line 44.
== Create Funambol user and group ==
== Create Funambol user and group ==
groupadd funambol
groupadd funambol
useradd -g funambol -d /opt/Funambol funambol
useradd -g funambol -d /opt/Funambol funambol
== Set Funambol to start on system startup ==
== Set Funambol to start on system startup ==
To make Funambol start automagically, create
To make Funambol start automagically, create
ln -s /etc/init.d/funambol /etc/rc.d/rc0.d/K02funambol
ln -s /etc/init.d/funambol /etc/rc.d/rc0.d/K02funambol
== Install Modules in Funambol ==
== Add the SOGo Connector ==
''At this stage the core Funambol installation is complete with the exception of the creation of the Funambol database tables. The sections below add the SOGo parts before doing so.''
=== Apache Commons Components ===
The Funambol SOGo Connector requires Apache commons collections (v3.2.1), confguration (v1.6), logging (v1.1), lang (v2.4) and the JSON.simple package. The following subsections have the command required to download and insert the .jar files into the Funambol installation.
These components can be downloaded from here:
http://commons.apache.org/
and are copied into the following directory
cd /opt/Funambol/tools/tomcat/lib/
==== collections (v3.2.1) ====
wget http://www.apache.org/dist/commons/collections/binaries/commons-collections-3.2.1-bin.zip
unzip commons-collections-3.2.1-bin.zip
cp -p commons-collections-3.2.1/commons-collections-3.2.1.jar /opt/Funambol/tools/tomcat/lib/
rm -rf commons-collections-3.2.1
==== confguration (v1.6) ====
wget http://www.apache.org/dist/commons/configuration/binaries/commons-configuration-1.6.zip
unzip commons-configuration-1.6.zip
cp -p commons-configuration-1.6/commons-configuration-1.6.jar /opt/Funambol/tools/tomcat/lib/
rm -rf commons-configuration-1.6
==== logging (v1.1) ====
wget http://www.apache.org/dist/commons/logging/binaries/commons-logging-1.1.1-bin.zip
unzip commons-logging-1.1.1-bin.zip
cp -p commons-logging-1.1.1/commons-logging-1.1.1.jar /opt/Funambol/tools/tomcat/lib/
rm -rf commons-logging-1.1.1
==== lang (v2.4) ====
wget http://www.apache.org/dist/commons/lang/binaries/commons-lang-2.5-bin.zip
unzip commons-lang-2.5-bin.zip
cp -p commons-lang-2.5/commons-lang-2.5.jar /opt/Funambol/tools/tomcat/lib/
rm -rf commons-lang-2.5
==== json-simple ====
wget http://json-simple.googlecode.com/files/json_simple.jar
cp json_simple.jar /opt/Funambol/tools/tomcat/lib/
=== Download & Configure Funambol SOGO Connector ===
Check here: http://www.scalableogo.org/english/downloads/backend.html for the latest version of the
'''Funambol SOGo Connector'''
wget http://www.scalableogo.org/uploads/Funambol/funambol-sogo-1.0.7.s4j
cp funambol-sogo-1.0.7.s4j /opt/Funambol/ds-server/modules
Then, open the '''/opt/Funambol/ds-server/install.properties''' file
vim /opt/Funambol/ds-server/install.properties
and add '''funambol-sogo-1.0.7''' at the end of the "modules-to-install" line.
=== Install Modules and Create Funambol Database Tables ===
Next, install the Funambol SOGo Connector within Funambol server by issuing the following commands :
Next, install the Funambol SOGo Connector within Funambol server by issuing the following commands :
{{Note box|TODO: setup apache to proxy the funambol port.}}
{{Note box|TODO: setup apache to proxy the funambol port.}}
== SOGO Sync Sources ==
== Create SOGo Sync Sources ==
The SOGo-Funambol documentation describes how to create the '''sogo-cal''', '''sogo-card''' and '''sogo-todo''' sync sources through the Funambol administration tool. There are Windows versions of this tool that can be run from a PC and connect to the Funambol server we just installed.
The SOGo-Funambol documentation describes how to create the '''sogo-cal''', '''sogo-card''' and '''sogo-todo''' sync sources through the Funambol administration tool. There are Windows versions of this tool that can be run from a PC and connect to the Funambol server we just installed.
