374
edits
Changes
Jump to navigation
Jump to search
Line 2:
Line 2: − + − + − + − + − + − + − + − + Line 25:
Line 25: − + − + + + Line 48:
Line 50: − + Line 58:
Line 60: − + − + Line 66:
Line 68: − + − − Line 129:
Line 129: − + − + Line 170:
Line 170: − + − + − + − + Line 181:
Line 181: − + Line 200:
Line 200: − and have a quick look if it is running correctly by accessing the web page on:+ − + + + + + Line 236:
Line 240: − + − + Line 468:
Line 472: − −
→Download & Install Funambol
{{Level|Advanced}}
{{Level|Advanced}}
== Introduction ==
== Introduction ==
The Funambol middleware allows you to synchronize mobile devices with [[Sogo:SOGo]] through the
The Funambol middleware allows you to synchronize mobile devices with [http://wiki.contribs.org/Sogo SOGo] through the
use of the Funambol [[Sogo:SOGo]] Connector. The connector allows any SyncML enabled devices to
use of the Funambol [http://wiki.contribs.org/Sogo SOGo] Connector. The connector allows any SyncML enabled devices to
fully synchronize contacts, events and tasks with [[Sogo:SOGo]].
fully synchronize contacts, events and tasks with [http://wiki.contribs.org/Sogo SOGo].
This HOWTO describes the installation procedure for installing Funambol with the [[Sogo:SOGo]]] Connector on an SME8b5 installation.
This HOWTO describes the installation procedure for installing Funambol with the [http://wiki.contribs.org/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.5. The latest GNU/Linux 32bit funambol server is 8.7, but this has not been confirmed yet for use with SOGO.
wget http://download.forge.objectweb.org/sync4j/funambol-8.0.2.bin
wget http://download.forge.objectweb.org/sync4j/funambol-8.5.2.bin
Run the binary to install:
Run the binary to install:
chmod +x funambol-8.0.2.bin
chmod +x funambol-8.5.2.bin
./funambol-8.0.2.bin
./funambol-8.5.2.bin
Agree on the licence terms and accept '''/opt''' as the directory to extract Funambol. This will install it in:
Agree on the licence terms and accept '''/opt''' as the directory to extract Funambol. This will install it in:
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 ==
== Setup Funambol to use MySQL ==
Funambol by installation defaults to use the Hypersonic DB engine, but SOGO requires the use of MySQL as the Funambol database.
=== Download & Configure MySQL JDBC driver ===
Funambol by installation defaults to use the Hypersonic DB engine, but [http://wiki.contribs.org/Sogo SOGo] uses MySQL and for Funambol to access the [http://wiki.contribs.org/Sogo SOGo] databases it needs to be setup to also use MySQL for 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'''.
dbms=mysql
dbms=mysql
Comment out the existing jdbc driver for Hypersonic and add the MySQL:
Comment out the existing jdbc driver for Hypersonic and add the MySQL connection information:
# MySQL
# MySQL
jdbc.password=yourpassword
jdbc.password=yourpassword
== 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 with the InnoDB engine and uses networking for access.
/sbin/e-smith/config setprop mysqld InnoDB enabled
/sbin/e-smith/config setprop mysqld InnoDB enabled
/etc/rc.d/rc7.d/S50mysqld restart
/etc/rc.d/rc7.d/S50mysqld restart
== 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:
mysqladmin create funambol --default-character-set=utf8
mysqladmin create funambol --default-character-set=utf8
mysql -e "grant all privileges on funambol.* to funambol@localhost identified by 'yourpassword'"
mysql -e "grant all privileges on funambol.* to funambol@localhost identified by 'yourpassword'"
mysql -e "flush privileges"
mysql -e "flush privileges"
{{Warning box|You may wish to alter the "funambol" and "yourpassword" information in the grant privileges line above. Be sure to configure it correctly in '''/opt/Funambol/ds-server/install.properties''' !}}
{{Warning box|You may wish to alter the "funambol" and "yourpassword" information in the grant privileges line above. Be sure to configure it correctly in '''/opt/Funambol/ds-server/install.properties''' !}}
== Add the SOGo Connector ==
== 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.''
''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 [http://wiki.contribs.org/Sogo SOGo] parts before doing so.''
=== Apache Commons Components ===
=== 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.
The Funambol [http://wiki.contribs.org/Sogo 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:
These components can be downloaded from here:
cp json_simple.jar /opt/Funambol/tools/tomcat/lib/
cp json_simple.jar /opt/Funambol/tools/tomcat/lib/
=== Download & Configure Funambol SOGO Connector ===
=== Download & Configure Funambol [http://wiki.contribs.org/Sogo SOGo] Connector ===
Check here: http://www.scalableogo.org/english/downloads/backend.html for the latest version of the
Check here: http://www.sogo.nu/english/downloads/backend.html for the latest version of the
'''Funambol SOGo Connector'''
'''Funambol SOGo Connector'''
wget http://www.scalableogo.org/uploads/Funambol/funambol-sogo-1.0.7.s4j
wget http://www.sogo.nu/uploads/Funambol/funambol-sogo-1.0.8.s4j
cp funambol-sogo-1.0.7.s4j /opt/Funambol/ds-server/modules
cp funambol-sogo-1.0.8.s4j /opt/Funambol/ds-server/modules
Then, open the '''/opt/Funambol/ds-server/install.properties''' file
Then, open the '''/opt/Funambol/ds-server/install.properties''' file
vim /opt/Funambol/ds-server/install.properties
vim /opt/Funambol/ds-server/install.properties
and add '''funambol-sogo-1.0.7''' at the end of the "modules-to-install" line.
and add '''funambol-sogo-1.0.8''' at the end of the "modules-to-install" line.
== Install Modules and Create Funambol Database Tables ==
== Install Modules and Create Funambol Database Tables ==
/etc/init.d/funambol start
/etc/init.d/funambol start
== Verify Funambol Installation ==
http://<server_domain_name>:8080
Have a quick look if Funambol is running correctly by accessing the web page on:
http://<server_domain_name>:8080/funambol/ds
if the server is running, a web page with Funambol Data Synchronization Service information will appear.
== Change Funambol Admin Password ==
== Change Funambol Admin Password ==
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.
However, the commands below emulate this process and creates entries in the funambol database and the sections below create templated versions of the required XML files, as this allows the SOGo database password to be inserted into these XML files.
However, the commands below emulate this process and creates entries in the funambol database and the sections below create templated versions of the required XML files, as this allows the [http://wiki.contribs.org/Sogo SOGo] database password to be inserted into these XML files.
The section below inserts the required entries into the funambol database. The next sections create and expand the template files as needed to complete the configuration for SOGo.
The section below inserts the required entries into the funambol database. The next sections create and expand the template files as needed to complete the configuration for [http://wiki.contribs.org/Sogo SOGo].
=== Create Funambol Database Sync Source Entries ===
=== Create Funambol Database Sync Source Entries ===
* Funambol Documentation: https://www.forge.funambol.org/download/documentation.html
* Funambol Documentation: https://www.forge.funambol.org/download/documentation.html
* SOGo Documentation: http://www.sogo.nu/english/downloads/documentation.html
* SOGo Documentation: http://www.sogo.nu/english/downloads/documentation.html
----
----
[[Category: Howto]]
[[Category: Howto]]