Funambol – first run

OK. I assume that we have installed Funambol, as I described here. It is time to run the server. Go to the Funambol directory (default: /opt/Funambol) and run:

# ./bin/funambol start

if you are lucky the server will start, but on Solaris, you need to modify scripts, because you problably will see that message:

./bin/funambol: J2EE_HOME=/opt/Funambol/tools/tomcat: is not an identifier

and again – this is compatibility problem between Linux and Unix shell. But personally I think, that Funambol developers should correct this, and in place of:

export J2EE_HOME=${FUNAMBOL_HOME}/tools/tomcat

should be:

J2EE_HOME=${FUNAMBOL_HOME}/tools/tomcat
export J2EE_HOME

this solves this problem, another one is:

OS=$(uname)

should be:

OS=`uname`

this is example of course, there are more this kind of commands, and you can correct them if you want, but I simply decide to modify shell call in first lines of those scripts. Let’s find scripts in bin and admin directory:

# find bin admin -type f -exec file {} \;|grep shell
bin/xml-to-wbxml:       executable shell script
bin/admin-passwd:       executable shell script
bin/inbox-listener:     executable shell script
bin/funambol-server:    executable shell script
bin/encrypt-passwords:  executable shell script
bin/pim-listener:       executable shell script
bin/patch:      executable shell script
bin/install:    executable shell script
bin/funambol:   executable shell script
bin/hypersonic: executable shell script
bin/ctp-server: executable shell script
bin/wbxml-to-xml:       executable shell script
bin/install-modules:    executable shell script
admin/bin/unix/funamboladmin:   executable shell script
admin/bin/funamboladmin:        executable shell script
admin/platform6/lib/nbexec:     executable shell script

in admin you will need only admin/bin/funamboladmin, but this one looks good, and you probably will use it on desktop machine, so you do not need to change it. You need to correct those in bin directory, so:

# find bin -type f -exec file {} \; | grep shell | cut -d: -f1 > mod.txt
# for a in `cat mod.txt`; do gsed -i "s/#\!\/bin\/sh/#\!\/bin\/bash/" $a; done
# gsed -i "s/ sh / bash /g" bin/funambol
# gsed -i "s/ sh / bash /g" bin/funambol-server

remember that gsed = GNU sed, if you do not have one, you should consider to install some GNU utilities
time to run:

# ./bin/funambol start
# ps -ef|grep -v grep|grep -i funambol
    root 16346 25522   0 17:55:10 pts/1       0:03 /usr/java/bin/java -Dfile.encoding=UTF-8 -Dfunambol.home=/opt/Funambol -Djava.n
    root 16378 25522   0 17:55:10 pts/1       0:03 /usr/java/bin/java -Dfile.encoding=UTF-8 -Dfunambol.home=/opt/Funambol -Dfunamb
    root 16373 25522   0 17:55:10 pts/1       0:03 /usr/java/bin/java -Dfile.encoding=UTF-8 -Dfunambol.home=/opt/Funambol -Dfunamb
    root 16367 25522   0 17:55:10 pts/1       0:14 /usr/java/bin/java -Xmx512M -Dfunambol.debug=false -Dfunambol.home=/opt/Funambo
# netstat -an|grep 8080
      *.8080               *.*                0      0 49152      0 LISTEN

it looks like it works, well done 🙂
Now, to verify that the Funambol Data Synchronization Service is running, start a web browser and open the URL http://servername:8080/funambol. A Data Synchronization Service test page should appear. You can log in to Web Demo Client using 'guest’ as login name and password.
Next stage is to run Funambol Administration Tool, I ran this from my Linux desktop, change dir to Funambol home directory and ran:

% ./admin/bin/funamboladmin

this is shown in Funambol Installation and Administration Guide with pictures, then I will not describe it here.
Next thing I have done is described in chapter 14. Taking the „proof of concept” test drive, but described there Java Demo Client does not work for me. I changed settings in File->Configure->Server URL and tried to synchronize, but nothing has been done. When I enter configuration once more, I saw that URL is set to default http://localhost:8080/funambol/ds again. So I get desktop client for Thunderbird from this page, installed it and configured for my server. Then I succesfully synchronize contacts in address book. Synchronization with calendar was not possible, because plugin is (was) compatible with Lightning v0.8, and I have newer version (v0.9).
I do not have a BlackBerry device yet, so I downloaded plugin for my Nokia with Symbian s60 from Mobile Clients page. After installation and configuration I synchronized succesfully contacts and calendar with my Funambol BIS server.