Funambol Installation and Administration Guide v9.0 PDF

Funambol
Installation and Administration Guide

Last modified: January 5, 2011
Table of Contents
1. Introduction....................................................................................................................... 6
2. Getting started................................................................................................................... 7
2.1. Preparing a host computer............................................................................................................... 7
2.1.1. Minimum system requirements............................................................................................... 7
2.1.2. Preparing the Funambol Serer pac!age installation............................................................ 7
2.2. "btaining the Funambol Serer pac!age......................................................................................... #
3. Installing the Funambol Server ac!age......................................................................... "
$.1. Installation on a %indo&s host serer.............................................................................................. '
$.1.1. (eri)ying the serer startup..................................................................................................... '
$.1.2. %hat to do i) the serer does not automatically start............................................................ 1*
$.1.$. +un Funambol As Microso)t %indo&s Serice ,)rom -P to aboe....................................... 1*
$.2. Installation on a /inu0 host serer.................................................................................................. 1*
$.2.1. (eri)ying the serer startup................................................................................................... 11
$.$. Setting up automatic 1ata Synchroni2ation Serice startup........................................................... 11
#. The Funambol $dministration Tool................................................................................ 12
3.1. "pening the Administration 4ool &indo&........................................................................................ 12
3.2. /ogging into the 1ata Synchroni2ation Serice.............................................................................. 1$
3.2.1. /ogging in through a pro0y................................................................................................... 1$
3.$. 5hanging the admin user pass&ord............................................................................................... 13
3.3. 5reating additional administrator user accounts............................................................................ 16
3.6. A tour o) the Administration 4ool &indo&........................................................................................ 17
3.6.1. Ma0imi2ing 8 minimi2ing the 1ata 9ntry pane....................................................................... 17
3.6.2. :iding 8 restoring the ;aigation pane................................................................................. 17
3.6.$. :iding 8 restoring the "utput < Messages pane.................................................................... 1#
%. &evie'ing the (ata S)nchroni*ation Service+s settings.............................................. 2,
6.1. Getting started............................................................................................................................... 2*
6.2. Speci)ying a public IP address....................................................................................................... 2*
6.$. +eie&ing the capabilities options................................................................................................. 21
= 2*11 Funambol> Inc. All rights resered. < Page 2
6.3. +eie&ing the engine options........................................................................................................ 21
6.6. 5on)iguring the 1ata 4rans)ormation Manager.............................................................................. 2$
6.7. 5on)iguring the synchroni2ation strategy....................................................................................... 23
6. $dding and managing user accounts............................................................................ 26
7.1. Adding a ne& user account............................................................................................................ 27
7.2. 9diting e0isting user accounts....................................................................................................... 27
7.$. 1eleting e0isting user accounts..................................................................................................... 2#
7. -anaging device records............................................................................................... 2"
7.1. Adding a ne& deice record........................................................................................................... 2'
7.2. 9diting e0isting deice records...................................................................................................... $*
7.$. +eie&ing deice capabilities........................................................................................................ $1
7.3. 1eleting deice records................................................................................................................. $2
.. -anaging rincials........................................................................................................ 33
#.1. 5reating a ne& principal................................................................................................................ $$
#.2. 9diting e0isting principals............................................................................................................... $6
#.$. 1eleting e0isting principal records................................................................................................. $6
#.3. +eie&ing last synchroni2ation timestamps................................................................................... $6
#.3.1. 1eleting a synchroni2ation record........................................................................................ $7
". /sing the 0mail Connector and Inbo1 2istener Service..............................................37
'.1. 9nironment description................................................................................................................ $7
'.2. 9mail 5onnector con)iguration steps............................................................................................. $'
'.$. Assigning the o))icer )or the 9mail 5onnector................................................................................ $'
'.3. 5on)iguring the 9mail 5onnector................................................................................................... $'
'.3.1. 5reating public mail serer records..................................................................................... 3*
'.3.2. /in!ing user accounts to mail serers.................................................................................. 32
'.3.$. Actiating mailbo0 listening and email push )or user accounts............................................. 3$
'.6. Forcing the eri)ication o) SS/ certi)icates..................................................................................... 3$
'.7. Manually enabling encryption 8 encoding....................................................................................... 33
'.7. 4he Inbo0 /istener Serice............................................................................................................ 36
'.#. 5on)iguring the Inbo0 /istener Serice.......................................................................................... 36
'.#.1. Inbo0 /istener Serice con)iguration strategy...................................................................... 37
'.'. Starting and stopping the Inbo0 /istener Serice........................................................................... 37
'.1*. 1atabase maintenance................................................................................................................ 37
= 2*11 Funambol> Inc. All rights resered. < Page $
1,. /sing the 3I- 2istener Service.................................................................................... #7
1*.1. 5on)iguring the PIM /istener Serice.......................................................................................... 37
1*.1.1. 5on)iguring PIM /istener Serice logging.......................................................................... 37
1*.1.2. About the detailed appenders............................................................................................ 3#
1*.2. Actiating and using the PIM /istener Serice............................................................................. 3#
1*.2.1. Starting the PIM /istener Serice....................................................................................... 3#
1*.2.2. Monitoring the PIM /istener Serice status........................................................................ 3#
1*.2.$. Managing the user account database................................................................................ 3'
1*.2.3. Stopping the PIM /istener Serice..................................................................................... 3'
11. /sing the 3ush Connection Service............................................................................ %,
11.1. 5on)iguring the Push 5onnection Serice.................................................................................... 6*
11.1.1. 5on)iguring Push 5onnection Serice logging................................................................... 6*
11.2. Actiating and using the Push 5onnection Serice...................................................................... 6*
11.2.1. Starting the Push 5onnection Serice................................................................................ 61
11.2.2. Monitoring the Push 5onnection Serice status................................................................. 61
11.2.$. Stopping the Push 5onnection Serice status.................................................................... 61
12. Customi*ing the (S Service4s log settings................................................................. %2
12.1. Getting started............................................................................................................................. 62
12.2. +eie&ing the logging appenders................................................................................................ 63
12.$. 5ustomi2ing log )iles on a per<user basis.................................................................................... 67
13. Test5driving Funambol.................................................................................................. %7
1$.1. ?Proo) o) concept@ test drie......................................................................................................... 67
1$.2. ?+eal &orld@ test drie.................................................................................................................. 67
1$.$. Synchroni2ing your Microso)t "utloo! data.................................................................................. 67
1$.3. :o& do test dries compareA...................................................................................................... 6#
1#. Ta!ing the 6roof of concet7 test drive..................................................................... %"
13.1. Managing user data on the Funambol 1ata Synchroni2ation Serice.........................................6'
13.1.1. Getting started.................................................................................................................... 6'
13.1.2. Adding a ne& Address Boo! contact to the database........................................................ 7*
13.1.$. Adding a ne& 5alendar entry to the database................................................................... 71
13.1.3. 4est preparation summary.................................................................................................. 72
13.2. Synchroni2ing a mobile deice &ith the Funambol 1ata Synchroni2ation Serice 1atabase......7$
13.$. Synchroni2ing Microso)t "utloo! &ith the Funambol 1ata Synchroni2ation Serice................... 73
1%. Ta!ing the 6real 'orld7 test drive................................................................................ 6%
16.1. 5on)iguring the 1ata Synchroni2ation Serice............................................................................. 76
16.1.1. Setting up user accounts on the Funambol 1S Serice..................................................... 76
16.2. Synchroni2ing Microso)t "utloo! &ith the Funambol Serer........................................................ 76
16.2.1. (eri)ying synchroni2ed data &ith the %eb 1emo 5lient..................................................... 77
16.$. Synchroni2ing a mobile deice &ith Funambol............................................................................ 77
16.$.1. Setting up a mobile deice )or Funambol connections....................................................... 77
16.$.2. Starting the synchroni2ation............................................................................................... 7#
16. Funambol reference guide............................................................................................ 6"
17.1. :o& to install a ne& module........................................................................................................ 7'
17.2. 1e)ault SyncSource properties.................................................................................................... 7*
17.2.1. 5ontacts............................................................................................................................. 7*
17.2.2. 5alendar............................................................................................................................ 7*
17.2.$. ;otes.................................................................................................................................. 71
17.2.3. Brie)case............................................................................................................................ 71
17.$. 4he install.properties con)iguration )ile......................................................................................... 71
17.3. Csing Funambol &ith MySD/...................................................................................................... 71
1. Introduction
4his document &ill guide you through the Funambol Serer installation and both initial and ongoing
administration tas!s> using the Funambol Administration 4ool> a standalone application &ith ersions
)or both /inu0 and Microso)t %indo&s.
5hapter $ &ill ta!e you through a small<scale serer installation. ,;oteE i) you are using Funambol
5arrier 9dition> you should s!ip this chapter and re)er to the Funambol 5arrier 9dition Installation and
"peration Guide..
5hapter 3 describes in detail the Funambol Administration 4ool.
4he 1ata Synchroni2ation Serice and related con)iguration topics are described in chapters 6> 7> 7
and #.
4he remaining components that ma!e up Funambol are described in chapters ' ,9mail 5onnector and
Inbo0 /istener Serice.> 1* ,PIM /istener Serice. and 11 ,Push 5onnection Serice..
5hapter 12 describes the 1ata Synchroni2ation SericeFs log settings.
In chapters 1$> 13 and 16 you &ill see ho& you can test<drie Funambol in t&o di))erent
synchroni2ation scenariosE
Csing a ?mobile deice@ emulator or your current copy o) Microso)t "utloo!
Csing a real SyncM/ deice> through a lie Internet connection> along &ith your current copy
o) Microso)t "utloo!
5hapter 17 includes additional re)erence topics.
2. Getting started
Be)ore you start the process> you may &ant to start &ith a reie& o) your installation options.
Funambol is distributed as an all<components<included pac!age> that includes all the required so)t&are
resources and a set o) accessories that let you try out the Funambol Serer be)ore committing to a )ull<
scale installation8con)iguration.
4he Funambol Serer pac!age installation proides you &ith a )ully )unctional Funambol Serer <
&hich includes 1ata Synchroni2ation Serice> Inbo0 /istener Serice> PIM /istener Serice and Push
5onnection Serice < and i) your host computer is open to out<o)<net&or! connections> you &ill quic!ly
hae a Funambol system ready )or real<&orld use.
4o help you get started> all steps o) the setup procedures )or each pac!age are proided )or use &ith
both Microso)t %indo&s and /inu0 systems.
2.1. 3rearing a host comuter
4he Funambol Serer pac!age is aailable )or both %indo&s and /inu0. 4his section details the
so)t&are and hard&are requirements )or a success)ul installation o) each pac!age ,&hich hae
oerlapping system requirements..
2.1.1. -inimum s)stem re8uirements
Windows-based host
Pentium 3 5PC> running at 1.#G:2
%indo&s 2*** Pro)essional> %indo&s -P Pro)essional or %indo&s (ista
2** MB o) )ree dis! space
77# MB memory
Linux-based host
Pentium 3 5PC> running at 1.#G:2
;o /inu0 ersion or publisher restrictions> at present
2** MB o) )ree dis! space
612 MB memory
Per-user capacity
Allocate 1.6 Mb o) drie space per potential user ,allo&ing )or an aerage o) 1>*** contacts and 1>***
eents..
2.1.2. 3rearing the Funambol Server ac!age installation
I) your plan is to ealuate the 1ata Synchroni2ation Serice be)ore engaging in a real<&orld
deployment> you should install this ready<to<run Funambol serer pac!age on a little<used local host
computer. "r> i) you hae a net&or! &ith a )e& users> and &ould li!e to o))er data synchroni2ation that
encompasses contacts and calendar in)ormation &ith a minimum o) additional setup> this pac!age &ill
sere your needs. Gou also hae the option o) establishing lin!s )rom the 1ata Synchroni2ation
Serice to any e0ternal data sources such as email serers.
4his pac!age includes these !ey componentsE
Funambol 1ata Synchroni2ation Serice
Haa +untime 9nironment
:ypersonic ,H1B5<compliant. database
Funambol Administration 4ool
So)t&are accessories )or use in the 1ata Synchroni2ation Serice test dries
9oteE i) you pre)er to use a H1B5<compliant database other than :ypersonic> you need to install both
the database and the required drier.
Fix for PostgreSQL version 8.3 or ater !error syncing configuration"
%hen using the serer &ith PostgreSD/ ersion #.$ or later> there is an error &hile per)orming a )ast
sync o) client con)iguration ,)or the clients that support this )eature as )or e0ample the %indo&s Mobile
Sync 5lient.. 4he problem arises )rom a change in the database )rom ersion #.2.
4he database no longer automatically casts all data types into te0t strings )or )unctions that ta!e a
string input. An e0plicit cast is no& needed.
4his can be accomplished by launching the )ollo&ing commands )rom the database promptE
CREATE FUNCTION pg_catalog.text(bigint) RETURNS text STRICT IMMUTABLE LANUAE
S!L AS "SELECT textin(int#o$t(%&))'"'
CREATE CAST (bigint AS text) (IT) FUNCTION pg_catalog.text(bigint) AS IM*LICIT'
CREATE FUNCTION pg_catalog.text(intege+) RETURNS text STRICT IMMUTABLE LANUAE
S!L AS "SELECT textin(int,o$t(%&))'"'
CREATE CAST (intege+ AS text) (IT) FUNCTION pg_catalog.text(intege+) AS
IM*LICIT'
2.2. :btaining the Funambol Server ac!age
Gou can obtain the Funambol Serer installation pac!age )or your host system ,%indo&s or /inu0. by
do&nloading it )rom the Funambol &ebsiteE &&&.)unambol.com.
"nce the do&nload is complete> you can start the installation process> as detailed in sections $.1
Installation on a %indo&s host serer or $.2 Installation on a /inu0 host serer.
= 2*11 Funambol> Inc. All rights resered. < Page #
3. Installing the Funambol Server ac!age
A)ter do&nloading a copy o) the Funambol Serer pac!age ,as detailed in the preious chapter.> you
can run the installer on either a %indo&s or /inu0 host. 9ach installation is described in step<by<step
detail in the )ollo&ing sections.
In the rest o) this document> the Funambol installation directory &ill be re)erred to as
$FUNAMBOL_OM!.
3.1. Installation on a ;indo's host server
A)ter do&nloading the pac!age> double<clic! the installer icon and )ollo& these stepsE
1. %hen the Funambol Setup &i2ard &indo& appears> reie& the introductory te0t and clic! Ne"t
to proceed.
2. %hen the Li#ense A$reement &indo& appears> reie& the G;C A))ero General Public /icense
,AGP/. te0t. I) you agree to the terms in the license> clic! the chec!bo0 by %& a##e't((() and
clic! Ne"t to proceed.
$. %hen the *+oose &nsta,, Lo#ation &indo& appears> i) you pre)er> you can change the de)ault
destination )olderE *:-.ro$ram Fi,es-Funam/o,(. 5lic! Ne"t to proceed.
3. %hen the *+oose 0tart Menu Fo,der &indo& appears> i) you pre)er> you can change the
de)ault )older selectionE Funam/o,.
6. 5lic! &nsta,, to proceed &ith installation. 4he &nsta,,in$ 0tatus &indo& records each phase o)
installation.
7. %hen the )inal *om',etin$ Funam/o, 0etu' &indo& appears>i) you &ant to immediately run
Funambol> ma!e sure the 0tart Funam/o, 0er1er chec!bo0 is chec!ed> then clic! Finis+.
A terminal &indo& brie)ly appears> recording the status o) the serer startup.
I) a %indo&s Security Alert dialog bo0 appears to in)orm you that a particular Haa program &ill ,by
de)ault. be bloc!ed> clic! Un/,o#2> &hich enables the serer startup to continue.
Serer startup should normally be complete in under a minuteIs time.
9oteE &hen installing the Funambol Serer Pac!age on %indo&s 7 73<bit> the de)ault installation path>
e.g. *:-.ro$ram Fi,es 3"456> does not &or!. 4o sole the issue> remoe the parenthesis )rom the )ile
path> )or e0ampleE *:-.ro$ram Fi,es "45.
3.1.1. <erif)ing the server startu
4o eri)y that the Funambol 1ata Synchroni2ation Serice is running> open the system tray and loo!
)or the 1S Serice status icon> as sho&n in Figure 1.
4he serer status icon should be green i) the serer &as success)ully started. I) the icon is red> or i) no
status icon appears> )ollo& the steps detailed in the ne0t section to manually start the 1ata
Synchroni2ation Serice.
I) you &ant to assign a public IP to your Funambol 1S Serice> please re)er to section 6.2.
= 2*11 Funambol> Inc. All rights resered. < Page '
Fi$ure 1: 0er1er status i#on
3.1.2. ;hat to do if the server does not automaticall) start
I) no serer status icon appears in the system tray a)ter a couple o) minutes> you must manually start
the Funambol serer. 4o do so> )ollo& these stepsE
1. From the 0tart menu> choose .ro$rams 78 Funam/o, 78 9ata 0yn#+roni:ation 0er1er 78 0tart
0er1er. A)ter a brie) pause> the system tray icon should appear at this point. 4he color o) the
icon represents one o) these statesE
Green J the serer is running.
Gello& J the serer is loading.
+ed J the serer is stopped.
2. I) the Funambol icon is green> you can start a &eb bro&ser and connect to the C+/
+tt':;;,o#a,+ost:4040;funam/o,. A summary &eb page &ith Funambol 1S Serice in)ormation
appears.
3.1.3. &un Funambol $s -icrosoft ;indo's Service =from >3 to above?
1. 1o&nload instsr1(e"e and sr1any(e"e included in %indo&s Serer 2**$ +esource Kit 4oolsE
httpE88&&&.microso)t.com8do&nloads8details.asp0A)amilyidL'd377a7'<67))<3ae7<'7ee<
b1#c37'*c))dMdisplaylangLen
2. 5reate the sericeE Ninstsr OSerice;ameP OsranyPA4:PQsrany.e0eN
i.e.E *:-.ro$ram Fi,es-<indo=s >esour#e ?its-@oo,s-8 instsr1(e"e AFunam/o,90A A*:-.ro$ram
Fi,es-<indo=s >esour#e ?its-@oo,s-sr1any(e"eA
$. +un re$edit(e"e and naigate to
:K9GR/"5A/RMA5:I;9QSGS49MQ5urrent5ontrolSetQSericesQOSerice;ameP
3. set 1%"+1 0tart to alue 2 ,auto start.
6. create !ey Parameters and inside this !ey> create the )ollo&ing String alues
A''9ire#tory &ith alue $FUNAMBOL_OM!-/in
A'',i#ation =it+ 1a,ue $FUNAMBOL_OM!-/in-restarta,,(#md
A''.arameters =it+ em'ty 1a,ues
7. "pen 5ontrol Panel ,5lassic (ie&. <S System <S Adanced <S 9nironment (ariables
7. /oo! )or the system ariable ,at the bottom o) the list. JABA_O.@0 and i) it e0ists add NC7DrsN.
I) it does not e0ist> create the ne& ariable JABA_O.@0 =it+ A7DrsA
#. +estart %indo&s
3.2. Installation on a 2inu1 host server
4his installation requires the use o) a terminal &indo& and a shell command line. :ae the pac!age
ersion number handy ,as noted in the do&nloaded pac!age )ilename.> )or use in this procedure.
9oteE you do not hae to log in as root to complete this installationT any administratie account has
permission )or this tas!.
A)ter do&nloading the pac!age> )ollo& these steps to install the Funambol Serer pac!ageE
1. "pen a terminal &indo& and type the )ollo&ing commandE
-. /$na0bol123e+-ion n$0be+4.bin
2. %hen the license agreement appears> read the te0t. 4o accept the terms o) the agreement>
type y ,yes. at the prompt and press !nter.
$. Speci)y a top<leel directory in &hich to install the pac!aged so)t&are> &hich &ill be re)erred to
as $FUNAMBOL_OM! in this document. "ther&ise> the installation de)aults to the directory
;o't;Funam/o,.
At the conclusion o) installation> you are prompted to start the sererT type y ,yes. and press !nter.
= 2*11 Funambol> Inc. All rights resered. < Page 1*
I) you pre)er to delay the serer startup> you can al&ays change to $FUNAMBOL_OM!;/in and run
this command at a later timeE
-. /$na0bol -ta+t
4his concludes the installation.
I) you &ant to assign a public IP to your Funambol 1S Serice> please re)er to section 6.2.
3.2.1. <erif)ing the server startu
A)ter youIe installed and started the 1ata Synchroni2ation Serice> you can eri)y its operation by
)ollo&ing these stepsE
1. "pen a terminal and run the 's command.
2. %hen the results appear> $re' )or ?)unambol@.
$. I) a listing is )ound> the serer is in operation.
"r you can do the )ollo&ingE
1. Start a &eb bro&ser and connect to the C+/E +tt':;;,o#a,+ost:4040;funam/o,
2. I) the serer is running> a &eb page &ith Funambol 1ata Synchroni2ation Serice in)ormation
appear.
3.3. Setting u automatic (ata S)nchroni*ation Service startu
As o) this edition o) the user guide> the Funambol 1ata Synchroni2ation Serice &onIt automatically
start &hen you start or restart the host serer.
Follo& these steps to automate serer startup on a /inu0 hostE
1. Csing a terminal &indo&> copy the startup script into the ;et#;init(d directory using the )ollo&ing
commandE
cp %FUNAMBOL_)OME5bin5/$na0bol 5etc5init.65/$na0bol
2. "pen the ne&ly copied script in a te0t editor and change the )ollo&ing lineE
FUNAMBOL_)OME78(c6 .. ' p96)8
toE
FUNAMBOL_)OME78(c6 %FUNAMBOL_)OME ' p96)8
4his points the script to the absolute location o) your installation.
$. 5reate a symbolic lin! to your r#E(d directory using this commandE
ln 1- 5etc5init.65/$na0bol 5etc5+c:.65S:;/$na0bol
4o eri)y that the Funambol 1ata Synchroni2ation Serice is running> start a &eb bro&ser and open
the C+/ +tt':;;Fser1ername8:4040;funam/o,. A 1ata Synchroni2ation Serice test page should
appear.
#. The Funambol $dministration Tool
4he Funambol Administration 4ool is a user inter)ace that allo&s remote con)iguration o) serer
parameters.
9oteE be)ore using the Administration 4ool> eri)y that both 1ata Synchroni2ation Serice and
database hae been started and are in operation. For details on ho& to use Funambol &ith a MySD/
database> see section 17.3 Csing Funambol &ith MySD/.
9oteE 4he user running the Funambol Administration 4ool and other Funambol tools ,such as the Haa
1emo 5lient. must hae &riting8e0ecution permissions on the installation directory.
#.1. :ening the $dministration Tool 'indo'
4o start the Funambol Administration 4ool> use one o) the )ollo&ing commandsE
"n %indo&sE )rom the 0tart menu> choose .ro$rams 78 Funam/o, 78 Administration @oo,.
,Please note that the Funambol Administration 4ool does not &or! &ithout administrator
priileges in %indo&s (ista..
"n /inu0E at the prompt> change to $FUNAMBOL_OM! and typeE
a60in5bin5/$na0bola60in
4he Funambol Administration 4ool &indo& appears on<screen ,see Figure 2..
;o in)ormation &ill be displayed until you log in &ith an administratie user I1 and pass&ord> as
detailed in the ne0t section.
Fi$ure 2: @+e Funam/o, Administration @oo,
#.2. 2ogging into the (ata S)nchroni*ation Service
In the Administration 4ool &indo&> choose Fi,e 78 Lo$in or double<clic! the Funambol Administration
4ool icon in the ;aigation pane.
4he Lo$in dialog bo0 appears ,see Figure $..
I) this is your )irst time logging in> you hae t&o optionsE
I) the serer is on a local host> ma!e no changes to the de)ault settings and clic! Lo$in.
I) the serer is on a remote host> enter the correct in)ormation in the ostname;&. )ield> then
clic! Lo$in.
4he de)ault access credentials areE
CsernameE admin
Pass&ordE sa
9ote@ the Administration 4ool remembers the most recent entries and &ill suggest them )or use in
)uture logins.
A)ter login> the Administration 4ool &indo& Na1i$ation pane &ill list your serer as the root node o) an
e0pandable tree structure that sorts your management options into Serer Settings> Csers> 1eices>
Principals> Modules and more.
Gour )irst tas! is to change the de)ault admin login in)ormation> as detailed in section 3.$.
#.2.1. 2ogging in through a ro1)
A)ter con)iguring and actiating your 1ata Synchroni2ation Serice> you or other admin<role users may
need to log in )or administratie purposes through a pro0y serer> depending on your location and
net&or! connection. 4his requires a slight adUustment o) the login procedureE
= 2*11 Funambol> Inc. All rights resered. < Page 1$
Fi$ure E: Funam/o, Administration @oo, ,o$in /o"
1. In the Administration 4ool &indo&> choose Fi,e 78 Lo$in or double<clic! the Funambol
Administration 4ool icon in the ;aigation paneT the Lo$in dialog bo0 appears.
2. (eri)y your user entries in the actie )ields.
$. 5hec! the Use .ro"y chec!bo0. Additional )eatures appear in the Lo$in dialog bo0.
3. 9nter the releant pro0y serer in)ormation. "nce you hae logged in &ith pro0y settings> the
/ogin dialog bo0 retains your entries )or )uture use.
6. 5lic! /ogin.
#.3. Changing the ad#in user ass'ord
Gou should regularly change the admin pass&ord to increase security to your system> &hen you )irst
log in and at regular interals therea)ter. ;ote that &hen you apply the change> youIll need to
immediately e0it the Funambol Administration 4ool> then restart it and log bac! in to the serer> using
the ne& pass&ord.
In order to change the admin user pass&ord> )ollo& these stepsE
1. In the Administration 4ool &indo&> e0pand the serer tree in the Na1i$ation pane> and double<
clic! Users.
2. %hen the 0ear#+ Users )eatures appears> type ?admin@ in the Username )ield and then clic!
0ear#+ ,see Figure 3..
4he admin account should appear in the results table.
$. Select the admin account and clic! !dit. 4he User 9etai,s options panel appears> &ith !ey
in)ormation displayed in editable )ields ,see Figure 6..
3. 4ype a ne& pass&ord in both .ass=ord and *onfirm .ass=ord )ields.
Fi$ure G: 0ear#+ users
6. 5lic! 0a1e to apply the ne& pass&ord.
7. A)ter changing the pass&ord> e0it the Administration 4ool.
7. +estart the tool and log in again as admin using your ne& pass&ord. 4his con)irms your ne&
pass&ord.
#.#. Creating additional administrator user accounts
I) your Funambol serer &or!load Uusti)ies the use o) more than one system administrator> you can add
the needed accounts by )ollo&ing these steps ,also see section 7 Adding and managing user
accounts.E
1. 90pand the serer tree in the Na1i$ation pane> right<clic! Users and choose Add User. 4he
Add User options appear in the 9ata !ntry pane.
2. 9nter the required in)ormation in the )ollo&ing )ieldsE
Fied $escription
Csername A name up to 266 characters in length> using any combination o) characters ,case<
sensitie..
Pass&ord A unique pass&ord ,case<sensitie..
5on)irm pass&ord 4he same pass&ord.
First ;ame 4he userIs )irst name.
/ast ;ame 4he userIs last name.
9mail 4he email address the user &ants to lin! to the Funambol 1S Serice
+oles 5hoose Administrator( Anyone using this account &ill be able to per)orm
administratie tas!s but not synchroni2ations.
Fi$ure 5: !dit admin user detai,s
$. 5lic! Add to sae the settings. A con)irmation message appears in the Out'ut 7 Messa$es
pane.
+epeat this procedure to create other needed administrator accounts.
#.%. $ tour of the $dministration Tool 'indo'
4he Funambol Administration 4ool &indo& is diided into three panes> displayed in Figure 7 in a
typical &or!ing mode ,e0ample o) log )ile con)iguration.E
1. 9avigationE lists all the primary components that you can add to or edit to monitor and
maintain the serer> users> deices> principals> modules> etc.
1ouble<clic! an item in the e0panded naigation tree to see the current entries and editable
options in the 9ata !ntry pane.
2. (ata 0ntr)E use the )eatures in this pane to add> edit> delete or search )or in)ormation related
to the item selected in the Na1i$ation pane.
$. :utut 5 -essagesE this pane displays in<progress status messages ,results> success or
)ailure. releant to your current tas!.
Fi$ure 5: Funam/o, Administration @oo, 'anes
It is possible to temporarily hide one or t&o o) the three principal panes> as needed.
#.%.1. -a1imi*ing A minimi*ing the (ata 0ntr) ane
Gou can quic!ly ma0imi2e the 9ata !ntry pane to hide both Out'ut 7 Messa$es and Na1i$ation panes
by doing the )ollo&ing ,see Figure 7.E
1. 1ouble<clic! the 9ata !ntry label tab to e0pand this pane. 4he e0panded pane no& )ills the
&indo&.
2. 4o see the Na1i$ation pane> double<clic! the 9ata !ntry pane label tab again. 4he 9ata !ntry
pane is minimi2ed to its original si2e.
#.%.2. Biding A restoring the 9avigation ane
4o hide Uust the Na1i$ation pane> clic! the ide button once ,see Figure #..
4he Na1i$ation pane collapses into the le)t &indo& )rame> isible as a side&ays label ,see Figure '..
Fi$ure 4: idin$;restorin$ t+e Na1i$ation 'ane
Fi$ure H: Ma"imi:in$;minimi:in$ t+e 9ata !ntry 'ane
4o reopen the Na1i$ation pane ,see Figure 1*.E
1. Float the cursor oer the label.
2. %hen the pane temporarily reappears> clic! the 0+o= button.
#.%.3. Biding A restoring the :utut 5 -essages ane
4o hide Uust the Out'ut 7 Messa$es pane> clic! the ide button once ,see Figure 11..
4he Na1i$ation pane collapses into the &indo& )rame> isible as a tab label ,see Figure 12..
= 2*11 Funambol> Inc. All rights resered. < Page 1#
Fi$ure 11: idin$ t+e Out'ut 7 Messa$es 'ane
Fi$ure 10: >eo'enin$ t+e Na1i$ation 'ane
Fi$ure I: Na1i$ation 'ane 7 #o,,a'sed
4o reopen the Out'ut 7 Messa$es pane ,see Figure 1$.E
1. Float the cursor oer the tab label.
2. %hen the pane temporarily reappears> clic! the 0+o= button.
9ote@ the 9ata !ntry pane cannot be hidden> only the Na1i$ation and "utput < Messages panes
,singly or both at once. can be hidden.
= 2*11 Funambol> Inc. All rights resered. < Page 1'
Fi$ure 12: Out'ut 'ane 7 #o,,a'sed
Fi$ure 1E: >eo'enin$ t+e Out'ut 'ane
%. &evie'ing the (ata S)nchroni*ation Service+s settings
4he 1ata Synchroni2ation Serice is at the core o) the Funambol Serer sync architecture. Gou can
reie& and modi)y the serer settings using the Administration 4ool> as detailed in this chapter.
%.1. Getting started
4o open the 1ata Synchroni2ation Serice )ile containing the principal settings in the Administration
4ool> )ollo& these stepsE
1. In the Administration 4ool &indo&> e0pand the serer tree in the Na1i$ation pane.
2. 1ouble<clic! 0er1er 0ettin$s. 4he 0er1er 0ettin$ options appear in the 9ata !ntry pane.
$. Gou can reie& and change serer setting as organi2ed into the )ollo&ing !ey categoriesE
5apabilities ,detailed in section 6.$.
9ngine ,detailed in section 6.3.
3. Cnder !n$ine you &ill )ind additional options )or the )ollo&ingE
1ata 4rans)ormer Manager ,detailed in section 6.6.
Strategy con)iguration ,detailed in section 6.7.
4his chapter &ill guide you through the options )or each category> as incorporated into the
Administration 4ool.
%.2. Secif)ing a ublic I3 address
A)ter installation> your access to the Funambol Serer is ia a localhost addressT this allo&s e0tremely
limited access to the Funambol 1ata Synchroni2ation Serice> permitting only direct administratie
connections.
4his section details replacing the localhost address &ith a publicly accessible IP address> to allo&
system users ,internal and e0ternal. to connect to the 1ata Synchroni2ation Serice )or data
synchroni2ation.
In order to change the IP address> )ollo& these stepsE
1. /og in to the 1ata Synchroni2ation Serice &ith the Administration 4ool ,see section 3.2..
2. 90pand the serer tree and double<clic! 0er1er 0ettin$s and locate the 0er1er U>& property.
$. 9nter the IP address or hostname assigned to the 1ata Synchroni2ation Serice> in the
)ollo&ing )ormatE
.ttp<552-e+3e+ na0e o+ I* a66+e--4<2-e+3e+ po+t45/$na0bol56-
4he de)ault port number )or Funambol is #*#*.
3. 5lic! Sae. 4he Out'ut Messa$e pane &ill display a con)irmation message.
9oteE A)ter changing the C+I> you can test the aailability o) your Funambol Serer )rom outside your
net&or! by starting a bro&ser and entering the sererIs public address in either o) the )ollo&ing
)ormatsE
+tt':;;Fyour_&._address8:F'ort_num/er8;funam/o,;
+tt':;;Fyour_ser1er_name8:F'ort_num/er8;funam/o,;
%.3. &evie'ing the caabilities otions
4hese options include all the settings that determine &hat is initially sent to the SyncM/ deice or
Funambol client> to describe important serer characteristics.
9oteE in most 1ata Synchroni2ation Serice installations> the de)ault 5apabilities and 9ngine settings
should not require any changes.
1. In the Administration 4ool &indo&> open the 0er1er 0ettin$s in the 9ata !ntry pane. 4he
0er1er 0ettin$s options appear in the 9ata !ntry pane> including the 5apabilities options> as
sho&n in Figure 13.
4his collection o) options represents in)ormation about the 1ata Synchroni2ation Serice that
is sent to the client> to help in identi)ying the serer.
2. +eie& the options under *a'a/i,ities> and ma!e any needed changes.
$. %hen done> clic! 0a1e to apply the changes. /oo! )or a con)irmation message in the Out'ut 7
Messa$es pane.
Gou can no& reie& the 1ata Synchroni2ation Serice engine options> detailed in the ne0t section.
%.#. &evie'ing the engine otions
4hese options include all the settings that control the behaior o) the 1ata Synchroni2ation Serice. In
most serer installations> you &ill need to attend to the engine settings )or :andler> 1ata trans)ormer
and Strategy.
9oteE in most 1ata Synchroni2ation Serice installations> the de)ault 5apabilities and 9ngine settings
should proe adequate.
1. In the Administration 4ool &indo&> open the 0er1er 0ettin$s in the 9ata !ntry pane. 4he
0er1er 0ettin$s options appear in the 9ata !ntry pane> including the !n$ine options as sho&n
in Figure 16.
Fi$ure 1G: 0er1er 0ettin$s o'tions 'ane, 7 *a'a/i,ities
2. +eie& the )ollo&ing optionsE
%ption $escription
Serer C+I Speci)ies the C+I to be used by the client in responding to the serer
messages. ;ote that this alue doesnFt a))ect the C+/ or port used by the
application serer that runs the Funambol application. For e0ampleE
+tt':;;my(funam/o,(#om;syn#.
"))icer 5ontrols ho& users are authenticated and granted access to the system.
,See section '.$ Assigning the o))icer )or the 9mail 5onnector )or more
details..
:andler 4his option ,utili2ing the contents o) an -M/<)ormat )ile. manages the
synchroni2ation sessions.
1eice Inentory 4his option manages all the deice records.
1ata 4rans)ormation Manager 4his option inoles a separate dialog bo0 that allo&s you to customi2e
the encryption applied to incoming and outgoing messages. ,See section
6.6 5on)iguring the 1ata 4rans)ormation Manager )or more details..
Strategy 4his option inoles a separate dialog bo0 in &hich you can )ine<tune the
prioriti2ation o) data> &hen duplications are detected. ,See section 6.7
5on)iguring the synchroni2ation strategy )or more details..
SMS serice 4his option manages the SMS serice> responsible )or sending SMS
messages.
Cser Manager 4his option manages all the user records. I) you plan to store user records
on a /1AP serer> you &ill need to create a ne& user manager and select
the resulting -M/ )ile in this )ield.
Min. (alue )or Ma0. Msg Si2e 4his option speci)ies the minimum alue to be used by the client )or
Ma"Ms$0i:e. 4his alue is the ma0imum si2e that all messages sent by
the serer must hae ,speci)ied by the SyncM/ protocol..
I) a client speci)ies a alue )or Ma"Ms$0i:e that is smaller than ?Min.
(alue )or Ma0. Msg Si2e@> the serer re)uses the synchroni2ation and &ill
log an error.
5hec! )or updates 9nables the 1ata Synchroni2ation Serice to chec! the Funambol &ebsite
daily )or updates> that &ill be automatically do&nloaded and installed. 4his
option is actie by de)ault.
$. %hen done> clic! 0a1e to apply the changes. /oo! )or a con)irmation message in the Out'ut 7
Messa$es pane.
Fi$ure 15: 0er1er 0ettin$s o'tions 'ane, 7 !n$ine
Gou can no& reie& the encryption and duplicate<in)ormation strategy options> detailed in the )ollo&ing
sections.
%.%. Configuring the (ata Transformation -anager
4hese options> part o) the !n$ine settings> control &hich encryption algorithms are applied to data
tra))ic. 4rans)ormations are applied to data in both directions> usually encrypting outgoing data and
decrypting incoming data.
Gou can speci)y the name and class o) trans)ormers )or both incoming and outgoing items> &ith the
source C+I o) items to be trans)ormed along &ith the name o) the trans)ormer to be used.
1. In the !n$ine options o) the 0er1er 0ettin$s> reie& the in)ormation noted in the 9ata
@ransformer Mana$er.
2. 4o edit or replace this entry> clic! *onfi$ure. 4he 9ata@ransformer Mana$er options appear in
the 9ata !ntry pane ,see Figure 17..
4his collection o) )eatures includes de)ault trans)ormation encryption components> and pre<set
combinations that are applied to incoming and outgoing messages.
Fi$ure 15: 9ata@ransformer Mana$er #onfi$uration
$. +eie& the )ollo&ing options> and ma!e the needed changes. 4his includes adding ne&
ro&s8entries> editing the e0isting ro&s8entries> and deleting e0isting ro&s8entries.
3. Cnder @ransformers for in#omin$ items> clic! the %J) icon in the upper right corner o) this table.
A ne& ro& appears at the bottom o) the table> as sho&n in Figure 17.
6. 5lic! each cell in the ro& to ma!e it actie> and ma!e the needed entries to guide the serer in
decrypting in)ormation )rom a speci)ic item that may hae a combination o) encryption applied.
4his allo&s the serer to decrypt the data receied )rom a client and sync it.
7. Cnder @ransformers for out$oin$ items clic! the %J) icon in the upper right corner o) this table.
7. %hen a ne& ro& appears at the bottom o) the table> ma!e the needed entries to guide the
serer in encrypting in)ormation e0tracted )rom a speci)ic item that may require a speci)ic
combination o) encryption applied. 4his allo&s the serer to encrypt the data and transmit it to
the client.
#. Cnder 9ata @ransformations clic! the %J) icon in the upper right corner o) this table.
%hen a ne& ro& appears at the bottom o) the table> ma!e the )ollo&ing entries in each column
o) the ne& ro&E
&ou#n $escription
Source C+I 9nter the alue o) the source ,e.g.> card> mail> .....
4rans)ormation 9nter the needed encoding parameters> separated by a semi<colon.
'. %hen done> clic! 0a1e.
A con)irmation message appears in the Out'ut 7 Messa$es pane. 4o return to 0er1er 0ettin$s> clic!
*an#e,(
%.6. Configuring the s)nchroni*ation strateg)
4hese options> part o) the !n$ine settings> are &here you can set the pre)erred con)lict resolution
applied by the Funambol 1ata Synchroni2ation Serice to SyncSources. Gou can use this )eature to
speci)y ho& the serer handles any potential con)licts that may occur &hen the 1ata Synchroni2ation
Serice tries to synchroni2e t&o copies o) similar records. 4his is done by designating either client or
serer as ?&inner@.
1. In the !n$ine options o) the 0er1er 0ettin$s> note the -M/ )ile path&ay in the 0trate$y )ield.
4his )ile stores all data<con)lict strategy settings.
2. 4o reie& the current settings and ma!e changes> clic! *onfi$ure. 4he 0trate$y *onfi$uration
options appear in the 9ata !ntry pane ,see Figure 1#..
Fi$ure 1H: @rasformers for in#omin$ items
4he aailable options )or resoling con)licts are listed in the )ollo&ing tableE
%ption $escription
Serer &ins 5hanges made to an item on the serer are copied to the client> oer&riting
preiously stored data.
5lient &ins 5hanges made to an item on the client are copied to the serer> oer&riting
preiously stored data.
Merge data Item details are compared and changes are mergedT i) a )ield ,)or e0ample> the
contactIs last name. has been modi)ied both on the serer and on the client> the
?5lient &ins@ rule is applied.
$. "pen the 9efau,t *onf,i#t >eso,ution menu and choose the desired option.
9oteE this setting is applied to those SyncSources that do not need to be con)igured
indiidually> and can be used to globally s&itch the con)lict resolution )or all such
SyncSources.
3. +eie& the table and select the pre)erred con)lict resolution )or each C+I source name ,&here
the option is actie..
9oteE data sources &ith only one actie resolution option re)lect their base SyncSource> &hile
other sources &ith t&o or more resolution options re)lect di))erent SyncSources.
6. %hen done> clic! 0a1e.
A con)irmation message appears in the Out'ut 7 Messa$es pane. 4o return to 0er1er 0ettin$s> clic!
*an#e,(
Fi$ure 14: 0trate$y #onfi$uration o'tions
6. $dding and managing user accounts
It is critically important to understand ho& User records )it in &ith 9e1i#e and .rin#i'a, records> since
the t&o types o) records are used together in the data synchroni2ation process.
/ser records A separate user record must e0ist )or eery person &ho &ill be synching data
bet&een a &ireless deice and the 1ata Synchroni2ation Serice. the system
de)ines a single record per user> regardless o) the number o) deices that the
user &ill be syncing.
(evice records 9ach &ireless deiceVlaptop> smartphone> P1A> etc.Vmust hae a record in
the 1ata Synchroni2ation Serice database> &hether used solely by one
person> or shared among seeral users
3rincial records 4his set o) records allo&s you to combine indiidual users and deices> so
that you can account )or all usage patterns. 4his includes the )ollo&ingE
90clusie use o) one deice by one person.
Shared use o) one deice by seeral people.
4his enables the 1ata Synchroni2ation Serice to speci)ically sort out data
synchroni2ed )rom more than one user> &ho share the same &or!<use cell
phone. 4heir speci)ic data &ill be aailable only to them> once theyIe been
identi)ied in a ?principal@ record.
Imortant notice
"ne o) the most e))icient labor<saing aspect o) the Funambol Serer is that Administrators and I4
sta)) do not need to manually add ne& user records ,as described in this chapter.> as ne& Funambol
users can auto<load their accounts ,including deice record. &hen they initially connect to the 1ata
Synchroni2ation SericeT this )eature is re)erred to as ?sel)<proisioning@. I) you are anticipating
thousands o) users> this is a tremendous bene)it.
Bo' does this 'or!C
9ach user initially prepares their mobile deices )or a ?sync@ by entering a username and pass&ord o)
their choice> along &ith the Funambol serer C+/. 1uring the resulting connection attempt> this
in)ormation triggers the 1ata Synchroni2ation Serice toE
Auto<generate a ne& user record ,applying their user name and pass&ord..
Add a ne& deice record.
/in! user and deice automatically in a ne& principal record.
A synchroni2ation then starts. 4his auto<loading process is particularly use)ul i) you hae a large
number o) potential users.
SoD 'h) is there a 'dd (ser entr) formC
%hen &ould you possibly manually create ne& user recordsA I) you are setting up an email
synchroni2ation )or a potential ,unregistered. user> you may need to create the records )or Cser>
1eice and Principal> then use the ne& user record to lin! to the releant mail serer ,using the 9mail
5onnector> as detailed in a later chapter.. 4he actual user ,&ho hasnIt registered yet. must then be
sent a copy o) the Funambol C+/> plus the ne&ly recorded username and pass&ord> to use in
setting up all their synchroni2ation connections &ith clients and deices.
6.1. $dding a ne' user account
4o add a ne& user record to the 1ata Synchroni2ation Serice database> )ollo& these stepsE
1. A)ter e0panding the serer tree in the Na1i$ation pane> right<clic! Users and choose Add
User.
4he Add Cser options appear in the 1ata 9ntry pane ,see Figure 1'..
2. 9nter the releant in)ormation in the aailable )ields.
Fied $escription
Csername 4he userFs system I1E a name up to 266 characters in length> using any combination
o) characters ,case<sensitie..
9oteE !eep in mind the space and typing limitations o) mobile deices.
Pass&ord A unique pass&ord ,case<sensitie..
5on)irm pass&ord 4he same pass&ord.
First ;ame 4he userFs )irst name.
/ast ;ame 4he userFs last name.
9mail 4he email address the user &ants to lin! to the Funambol 1S Serice.
+oles Select a role )rom the )ollo&ingE
/serE can per)orm synchroni2ations &ith the serer.
$dministratorE can log into the Administration 4ool ,see chapter 3. and per)orm
administratie tas!s but not synchroni2ations.
@a/,e 1: User detai,s
$. 5lic! Add to sae the settings> or *an#e, to quit &ithout saing the settings.
A con)irmation message appears in the Out'ut 7 Messa$es pane.
+epeat this procedure to create any other user accounts.
6.2. 0diting e1isting user accounts
4o reie& and change the in)ormation )or an e0isting user account> )ollo& these stepsE
1. A)ter e0panding the serer tree in the Na1i$ation pane> double<clic! Users. 4he 0ear#+ User
options appear in the 9ata !ntry pane ,see Figure 2*..
Fi$ure 1I: Add User 'ane,
2. 5lic! in one or more releant search )ields ,e.g.> Uust Last Name> or both First Name and Last
Name. and type the search te0t.
$. 5lic! 0ear#+. 4he resulting matches> i) any> appear in the table.
3. 5lic! the li!ely record and then clic! the no&<actie !dit button. 4he !dit User options appear
in the 9ata !ntry pane> displaying the current userIs in)ormation.
6. +eie& the aailable )ields and ma!e the needed changes. +e)er to 4able 1 on page 27.
7. 5lic! Add to sae the changes> or *an#e, to quit &ithout saing the settings.
6.3. (eleting e1isting user accounts
4o delete an e0isting user account> )ollo& these stepsE
1. 90pand the serer tree in the Na1i$ation pane and double<clic! Users. 4he 0ear#+ User
options appear in the 1ata 9ntry pane.
2. 5lic! in one or more releant search )ields ,e.g.> Uust Last Name> or both First Name and Last
Name. and type the search te0t.
$. 5lic! 0ear#+. 4he resulting matches> i) any> appear in the table.
3. 4o eri)y the account is the one that is to be deleted> select the li!ely record and clic! the no&<
actie !dit button.
6. +eie& the User 9etai,s options> then clic! *an#e, to reopen the 0ear#+ Users pane.
7. Select the record and clic! the no&<actie 9e,ete button.
Fi$ure 20: 0ear#+ Users o'tions
7. -anaging device records
As &ith user records> this chapter guides you through the creation and management o) the needed
records. 9ach &ireless deice J laptop> Smartphone> P1A> etc. J must hae a record in the 1ata
Synchroni2ation Serice database> &hether used solely by one person> or shared among seeral
users. As noted preiously> this permits you to set up synchroni2ation )or each user on any releant
deice.
Imortant notice
Gou do not need to manually add ne& deice records ,as detailed in this chapter.> as Funambol
users can auto<load their account ,including user> deice and principal in)ormation. &hen they initially
connect to the 1ata Synchroni2ation Serice or later> i) they update their deice.
For more details> see bo0 on page 27.
7.1. $dding a ne' device record
4o manually add a ne& deice record to the 1ata Synchroni2ation Serice> )ollo& these stepsE
1. In the ;aigation pane> right<clic! 9e1i#es and choose Add 9e1i#e. 4he Add 9e1i#e options
appear in the 9ata !ntry pane ,see Figure 21..
2. 9nter the releant in)ormation in the aailable )ields.
Fi$ure 21: Add 9e1i#e o'tions
Fied $escription
I1 4he deice I1> e.g.> the phone IM9I )or SyncM/ phones.
4ype 4he deice type.
4ime2one ,4W. 4he time2one associated &ith the deice.
5onersion to current 4W 9nable8disable conersion to the current time2one.
5harset 4he character set used )or communication &ith the deice. (alid aluesE C4F<#> C4F<
17> IS"<##6'<1> CS<AS5II.
Address IP address o) the deice ,i) applicable..
Phone number 4he )ull phone number o) the deice.
;oti)ication type 5hoose the correct type )rom the options in this menuE
:-$ (S 1.2E &or!s &ith Funambol clients and &ith SyncM/ 1.2 clients
9o!ia :-$ (S 1.1E &or!s &ith ;o!ia phones that support SyncM/ 1.1
1escription In)ormational or descriptie te0t ,optional..
@a/,e 2: 9e1i#e detai,s
$. 5lic! Add to sae the settings. A con)irmation message appears in the Out'ut 7 Messa$es
pane
7.2. 0diting e1isting device records
4o reie& and reise the settings )or an e0isting deice record> )ollo& these stepsE
1. In the Na1i$ation pane> double<clic! 9e1i#es. 4he 0ear#+ 9e1i#es options appear in the 9ata
!ntry pane ,see Figure 22..
= 2*11 Funambol> Inc. All rights resered. < Page $*
Fi$ure 22: 0ear#+ 9e1i#es o'tions
2. 5lic! in one or more releant search )ields and type the search te0t. ,"r> to ie& a complete
list o) all e0isting deice records> ma!e no entries in the search )ields..
$. 5lic! 0ear#+. 4he resulting matches appear in the table.
3. 5lic! the li!ely record and then clic! the no&<actie !dit button. 4he !dit 9e1i#e options
appear in the 9ata !ntry pane ,see Figure 2$..
6. +eie& the in)ormation in the aailable )ields and ma!e any needed changes. +e)er to 4able
2 on page $*.
7. 5lic! 0a1e to commit any changes. A con)irmation message appears in the Out'ut 7
Messa$es pane.
7.3. &evie'ing device caabilities
I) you &ish to e0amine in great detail the technical capabilities o) a speci)ic deice> you can do so
using the Funambol Administration 4ool> in the 9e1i#es data entry options.
9oteE all o) the 9e1i#e *a'a/i,ity categories and options are read<only displays and cannot be
modi)ied.
1. A)ter e0panding the serer tree in the Na1i$ation pane> double<clic! 9e1i#es.
2. 4he 0ear#+ User options appear in the 9ata !ntry pane.
$. 5lic! in one or more releant search )ields and type the search te0tT then clic! 0ear#+.
4he resulting matches> i) any> appear in the table.
3. 4o eri)y the account is the one that is to be deleted> select the li!ely record and clic! the no&<
actie *a'a/i,ities button.
= 2*11 Funambol> Inc. All rights resered. < Page $1
Fi$ure 2E: 9e1i#e 9etai,s o'tions
4he *a'a/i,ities 9etai,s pane appears ,see Figure 23..
4his pane is organi2ed into collections o) related capability optionsE .ro'erties> 9atastores> !"tensions
and a )ull range o) 9atastore: *onta#ts.
Gou can reie& all )our sets o) options through this 9ata !ntry display.
7.#. (eleting device records
4o delete an e0isting deice record )rom the 1ata Synchroni2ation Serice database> )ollo& these
stepsE
1. A)ter e0panding the serer tree in the Na1i$ation pane> double<clic! 9e1i#es. 4he 0ear#+
9e1i#es options appear in the 9ata !ntry pane.
2. 4ype the search te0t in one or more releant search )ields and then clic! 0ear#+. 4he resulting
matches> i) any> appear in the table.
$. 4o eri)y the account is the one that is to be deleted> select the li!ely record and clic! the no&<
actie !dit button.
3. +eie& the 9e1i#e 9etai,s options> then clic! *an#e, to reopen the 0ear#+ 9e1i#es pane.
Select the record and clic! the no&<actie 9e,ete button. A con)irmation message appears in
the Out'ut 7 Messa$es pane.
Fi$ure 2G: 9e1i#e *a'a/i,ities
.. -anaging rincials
In the &ireless mobile unierse> there are t&o oerlapping combinations o) user and deice that pose a
potential quandary )or centrali2ed data synchroni2ation sericesE
A single Funambol user using more than one deice or client )or data synchroni2ation. For
e0ample> one might hae an at<&or! SyncM/ phone> a personal<use Smartphone> a copy o)
Microso)t "utloo! on their laptop> and a Poc!et P5 P1A.
"r> that same indiidual may be one o) seeral users &ho &ould &ant to synchroni2e data
)rom a single deice that they ta!e turns sharing.
%ith these t&o associations in mind> the Funambol 1ata Synchroni2ation Serice incorporates the
concept o) a principal> that associates a single user &ith a speci)ic deice. 4his allo&s one deice to
be shared by multiple users> or one user to utili2e any number o) deices> all synchroni2ing &ith
Funambol> but &ithout the &rong data going to the &rong client. 9ach o) these associations is uniquely
identi)iable in the system as a principal.
Imortant notice
Gou do not need to manually add ne& principal records ,as detailed in this chapter.> as Funambol
users can auto<load their account ,including user> deice and principal in)ormation. &hen they initially
connect to the 1ata Synchroni2ation Serice or later> i) they update their deice.
For more details> see bo0 on page 27.
..1. Creating a ne' rincial
4o create a ne& principal in Funambol> use the Administration 4ool to search )or the desired user> then
)or a deice match. A)ter selecting a matching user and deice )rom the search results tables> you lin!
them as an indiidual principal )ollo&ing the steps detailed belo&.
9oteE remember that you can pair more than one user &ith the same deice> each as a unique
principal. I) a single phone has )ie users> you &ould create )ie principals to represent the
associations.
1. In the Na1i$ation pane> right<clic! .rin#i'a,s and choose Add .rin#i'a,. 4he Add .rin#i'a,
options appear in the 9ata !ntry pane ,see Figure 26..
= 2*11 Funambol> Inc. All rights resered. < Page $$
2. 9nter the releant in)ormation in one or more o) the I search )ields and then clic! 0ear#+. 4he
results ,i) any. appear in the table belo&.
$. 9nter the releant in)ormation in one or more o) the 9e1i#es search )ields and clic! 0ear#+.
4he table belo& the search )orm lists the results o) your query.
A)ter you hae matched a particular user and a deice> the tables should loo! li!e the
e0ample in Figure 27.
Fi$ure 25: Add .rin#i'a, o'tions
Fi$ure 25: Add .rin#i'a, 7 sear#+ resu,t
3. I) your search turned up one match )or each category> ma!e sure each record is selected. I)
your search turned up multiple matches )or user or deice> select the correct record )or each
category.
6. 5lic! the no&<actie Add .rin#i'a, button to sae the user8deice pairing. /oo! in the Out'ut 7
Messa$es area )or con)irmation o) the ne& principal.
..2. 0diting e1isting rincials
As there is no &ay to directly edit a principal record. In the Funambol Administration 4ool you hae the
option to delete the e0isting record and create a ne& principal record.
..3. (eleting e1isting rincial records
In order to delete an e0isting principal record> )ollo& these stepsE
1. +ight<clic! the .rin#i'a,s icon in the Na1i$ation pane and choose 0ear#+ .rin#i'a,s. 4he
0ear#+ .rin#i'a,s options appear in the 9ata !ntry pane.
2. Search )or a speci)ic principal> using any o) the aailable data )ields> or i) you pre)er to ie&
the complete catalog o) principals> leae the search )ields empty and clic! 0ear#+.
$. Select the appropriate result in the table belo& the search )orm and clic! 9e,ete.
3. %hen the deletion con)irmation dialog bo0 appears> clic! O?. 4he selected record is deleted
and a con)irmation message appears in the Out'ut 7 Messa$es pane.
..#. &evie'ing last s)nchroni*ation timestams
4o )ind and display the details about the most recent synchroni2ation o) a speci)ic principal> )ollo&
these stepsE
1. +ight<clic! the .rin#i'a,s icon in the Na1i$ation pane and choose 0ear#+ .rin#i'a,s. 4he
0ear#+ .rin#i'a,s options appear in the 9ata !ntry pane.
6. Search )or a speci)ic principal> using any o) the aailable data )ields> or i) you pre)er to ie&
the complete catalog o) principals> leae the search )ields empty and clic! 0ear#+.
2. Select the appropriate result in the table belo& the search )orm and clic! 9etai,s.
$. 4he Last 0yn#+roni:ation @imestam's options appear in the 9ata !ntry pane ,see Figure 27..
3. 4he table sho&n in Figure 27 proides the )ollo&ing in)ormation about the most recent
synchroni2ations o) the selected principalE
Fi$ure 2H: Last 0yn#+roni:ation @imestam's
&ou#n $escription
1atabase Identi)ies the SyncSource used by the principal
Sync 4ype ;otes the type o) synchroni2ation
Status +eports the sync status code
5lient anchor 1isplays the client anchor last used
Serer anchor 1isplays the serer anchor last used
Start ;otes the start time o) the most recent synchroni2ation
9nd ;otes the end time o) synchroni2ation
6. I) you &ish to eri)y that this is indeed the most recent synchroni2ation> clic! >efres+(
%hen done> double<clic! another icon in the serer tree> or e0it the Funambol Administration 4ool.
..#.1. (eleting a s)nchroni*ation record
Gou can delete the records about the most recent synchroni2ations. 4his not only erases the records>
but &ill also )orce the 1ata Synchroni2ation Serice to per)orm a deep comparison o) client and serer
data> that is> a so<called slo& synchroni2ation. 4his &ill be automatically initiated the ne0t time the
client deice or serice attempts to sync &ith the 1ata Synchroni2ation Serice. Gou may &ant to
per)orm this tas! only i) there are problems arising )rom preious synchroni2ations.
4o start the process> clic! the >eset button.
". /sing the 0mail Connector and Inbo1 2istener Service
4he 9mail 5onnector> a !ey Funambol 1ata Synchroni2ation Serice module> allo&s a user to
synchroni2e email clients on their computers and mobile deices to e0ternal mail serers through a
Funambol 1ata Synchroni2ation Serice connection.
I) you hae preiously installed the Funambol Serer pac!age> the 9mail 5onnector is present> ready
)or setup and use ,as detailed in this chapter..
4he 9mail 5onnector module incorporates a basic SyncSource ,?mail@. that enables email
synchroni2ation and email push )or both P"P and IMAP email. %hen this module is set up and actie>
email can be synchroni2ed &ith a designated mail serer> but &ith important protocol<speci)ic
di))erencesE
P"P users can sync their client Inbo0 )older ,but no sub)olders.> and can send mail through
their client "utbo0
IMAP users enUoy )ull synchroni2ation o) all )olders and sub)olders &ith the mail serer
Gou set up the 9mail 5onnector as a ?mail@ serice> then con)igure the protocols ,P"P or IMAP. on a
per<user record basis> through the Csers options.
;ote that ,as detailed in this chapter. user authentication &ith the email serer can be con)igured to
rely on the userIs o&n mail authentication settingsV&hich means a simpler setup )or you> the
administrator.
4he 9mail 5onnector seres your users &ho &ant to manually synchroni2e their arious email clients.
Gou can also install and con)igure Funambol Inbo0 /istener Serice ,as detailed in ?About the Inbo0
/istener Serice@ on page 36. to enable email push> so that the 1ata Synchroni2ation Serice is
automatically loaded &ith the latest incoming email> and copies are pushed to all actie client deices.
".1. 0nvironment descrition
Be)ore starting &ith the installation procedure> it may be help)ul to reie& the main )eatures o)
FunambolFs email module.
4o implement the push email )unctionality and improe per)ormance> the email module proides the
9mail 5onnector and the Inbo0 /istener Serice tool> &hich o))ers the )ollo&ing )eaturesE
3olling Inbo1 2istener Service feature. 4he serice polls the Mail Serer )or ne& mail )or a
speci)ic email accountT &hen ne& mail has been receied )or that account> the tool sends a
noti)ication to the 1ata Synchroni2ation Serice.
9otifiable Inbo1 2istener Service feature. 4he serice !eeps listening )or noti)ications )rom
the Mail Serer> &hich are sent out &hen ne& mails are receied by a speci)ic email account.
-essage rocessor feature. 4he serice stores some basic email in)ormation ,such as
Message<I1> 1ate> etc.. )rom the inbo0 )older into a local caching system in order to improe
the synchroni2ation per)ormance. 4he number o) emails that should be cached on the system
can be con)igured by the user.
9oteE i) the Inbo0 /istener Serice is not running> both push email )unctionalities and message
processor )eatures are not aailable.
4o use the email synchroni2ation )eature> the module ,sGK. o) the 9mail 5onnector must be added to
the 1ata Synchroni2ation SericeT this component allo&s synchroni2ation o) a userFs email bet&een a
Mail Serer and a Mobile 1eice.
In order to manage the 9mail 5onnector and the Inbo0 /istener Serice> the administrator can use the
panels proided in the Administration 4ool a)ter the 9mail 5onnector installation.
All data related to the 9mail 5onnector is stored in a database schema that must be added to the
Funambol 1ata Synchroni2ation Serice Schema. 4his database schema is automatically created
during the installation procedure.
4he email synchroni2ation process is summari2ed in Figure 2# and detailed in the )ollo&ing stepsE
1. 4he administrator user must create the ds7user user in the 1ata Synchroni2ation Serice and
the relatie account ,i.e. ds7user X all the in)ormation about the mail serer.
2. 4he Inbo0 /istener Serice uses the 9mail 5onnector 1B Schema and reads data )rom the
A##ounts table. It retriees the last N ,ma0 email number. emails )rom the sererFs inbo0 )older
and stores some basic in)o in the local cache. 4his behaior allo&s the 9mail 5onnector to
improe the per)ormance during the sync process. 4he Inbo0 /istener Serice can be drien
by a polling system or an asynchronous e0ternal noti)ication.
$. %hen ne& email has been receied in the sererFs inbo0 )older> the Inbo0 /istener Serice
sends a noti)ication to the 1ata Synchroni2ation Serice.
3. 4he 1ata Synchroni2ation Serice sends the noti)ication to the client.
6. 4he client ,or mobile deice. per)orms a sync session. A sync session can be drien byE
A 1ata Synchroni2ation Serice ;oti)ication. 4he 1ata Synchroni2ation Serice sends a
noti)ication i) a ne& email is the inbo0 )older.
4he user. 4he user starts the sync session pressing the sync button on the SyncM/ client.
7. 4he 1ata Synchroni2ation Serice uses the 9mail 5onnector in order to sync the email &ith
the Mail Serer. 4he 9mail 5onnector uses the local cache in order to improe the
per)ormance.
= 2*11 Funambol> Inc. All rights resered. < Page $#
Fi$ure 24: !mai, *onne#tor: en1ironment des#ri'tion dia$ram
".2. 0mail Connector configuration stes
4o con)igure the 9mail 5onnector )or e0ternal mail serer communications and synchroni2ations> use
the Funambol Administration 4ool to per)orm the )ollo&ing actionsE
Assigning the "))icer )or the 9mail 5onnector to enable user authentication ,see section '.$..
5on)iguring the 9mail 5onnector ,see section '.3..
Setting up the 9mail SyncSources.
".3. $ssigning the officer for the 0mail Connector
A)ter the initial installation> a !ey serer setting> !mai, Offi#er> controls ho& users are authenticated so
that they can access the serer )unctions. 4&o 0ml )iles de)ine the options )or the t&o instances o) the
"))icer that are present in the Funambol standard installationE
User.ro1isionin$Offi#er("m,. 4his is the de)ault o))icer. Cse this )ile i) your 1ata
Synchroni2ation Serice cannot use an e0ternal mail serer or user database )or user
authentication. In this case> this "))icer per)orms the authentication )unction locally. ;ote that>
i) this o))icer is actie> you must manually enter user accounts> including I1 and pass&ord>
then communicate that in)ormation to users to aid them in preparing their clients and deices
)or synchroni2ation.
!mai,Offi#er("m,. 4his is the alternate o))icer. Cse this )ile i) your 1ata Synchroni2ation Serice
has access to a mail serer or other user<authentication source. 4his greatly simpli)ies your
user<connection setupT your users can set up deice sync pro)iles using their email login
entries )or authentication and access to Funambol. %hen they )irst connect> the system
alidates their identity> then auto<generates the needed user> deice and principal records.
4o change the de)ault to !mai,Offi#er("m,> )ollo& these stepsE
1. A)ter opening the Funambol Administration 4ool> log into the serer.
2. 90pand the serer tree in the Na1i$ation pane and double<clic! 0er1er 0ettin$s. 4he 0er1er
0ettin$s options appear in the 9ata !ntry pane.
$. In the Offi#er )ield ,included in the !n$ine optionsT see .> the de)ault entry is
User.ro1isionin$Offi#er("m,. 9dit the entry as )ollo&s ,&ith edits sho&n in bold.E
#om;funam/o,;ser1er;se#urity;)#ai%fficer.x#
3. 5lic! 0a1e to apply the con)iguration settings. Gou can no& proceed &ith 9mail 5onnector
con)iguration.
".#. Configuring the 0mail Connector
90pand the Na1i$ation pane tree to Modu,es L emai, L Funam/o,!mai,*onne#tor and double<clic!
Funam/o,!mai,*onne#tor. 4he 9mail 5onnector options appear in the &or!ing pane> diided into t&o
collections o) optionsE .u/,i# Mai, 0er1ers and A##ounts ,see Figure $*..
= 2*11 Funambol> Inc. All rights resered. < Page $'
Fi$ure 2I: *+an$in$ t+e defau,t offi#er
Cse these )eatures to complete a sequence o) three setup tas!sE
1. 5reate records )or public mail serers that your Funambol users &ould synchroni2e &ith ,see
section '.3.1..
2. /in! e0isting user records to releant serers ,see section '.3.2..
$. Actiate mailbo0 monitoring and email push on a per<account basis ,see section '.3.$..
".#.1. Creating ublic mail server records
4he 1ata Synchroni2ation Serice is pre<loaded &ith the most common public mail serers> such as
A"/> Gahoo> Gmail> :otmail. A)ter actiating this group> you may need to manually add more mail
serers. 4his section describes both tas!s in step<by<step detail.
1. A)ter opening the Funam/o,Mai,*onne#tor options> locate the .u/,i# Mai, 0er1er options and
clic! 0ear#+. 4he table lists a de)ault set o) public serers> ready )or use ,see Figure $1..
2. I) this list is not inclusie o) serers utili2ed by your users> clic! Add. 4he Mai, 0er1er 9etai,s
dialog bo0 appears ,see Figure $2..
Fi$ure E0: !mai, *onne#tor #onfi$uration o'tions
Fi$ure E1: .u/,i# Mai, 0er1ers ,ist
$. +eie& the )ollo&ing options ,some o) &hich are read<only. and ma!e needed entries and
selectionsE
Fied $escription * action
1escription A plain<language descriptie name )or this serer> usually incorporating the sererIs
brand name> e.g. Scali0.
Serer product "pen this menu and choose the mail serer application. I) it matches one o) the listed
options. 1e)aultE ?"ther@.
Protocol "pen this menu and choose ?pop$@ or ?imap@. ;ote that some options &ill be
actiated ,or rendered inactie. depending on your choice o) protocol.
"utgoing serer 4he C+/ o) the outgoing email serer.
Port "utgoing email serer port. 1e)ault is 26 ,SM4P..
Auth i) chec!ed> the user credentials ,mail login and pass&ord. are sent to the email
serer to authenticate the outgoing mail.
Incoming serer 4he C+/ o) the incoming email serer.
Port Incoming mail serer port. 1e)ault entries are 11* ,P"P. and 13$ ,IMAP.
SS/ "utgoing I) chec!ed> this option actiates SS/ on all outgoing messages.
SS/ Incoming I) chec!ed> this option actiates SS/ on all incoming messages.
So)t<delete on serer I) chec!ed> &hen you delete a message on your client> the message &ill not be
deleted on the serer. 5hec!ed by de)ault.
Inbo0 )older name 1isplays the name serer label assigned to the Inbo0 )older. Inactie by de)ault.
"utbo0 )older name 1isplays the name serer label )or the "utbo0 )older. ,Inactie by de)ault..
Sent )older name 1isplays the name serer label )or the Sent )older.
1ra)ts )older name 9nter the name serer label )or the 1ra)ts )older. 5hec! this option to actiate
synchroni2ation. ,"ptional..
4hrash )older name 9nter the name serer label )or the 4rash )older. 5hec! this option to actiate
synchroni2ation. ,"ptional..
3. 5lic! 0a1e. %hen the con)irmation dialog bo0 appears> clic! O?.
Fi$ure E2: .u/,i# Mai, 0er1ers 7 Mai, 0er1er 9etai,s
+epeat the preious steps as needed until you hae records )or all releant mail serers.
".#.2. 2in!ing user accounts to mail servers
1o not start this tas! until you hae already compiled a 1ata Synchroni2ation Serice database o) user
records.
1. In the Funam/o,!mai,*onne#tor A##ount options> clic! Add. 4he 0ear#+ Users dialog bo0
appears.
2. Cse the search )eatures to )ind matching user records ,)rom your Funambol database o) actie
users and double<clic! the e0act user match.
4he 0ear#+ Users dialog bo0 is replaced by the User A##ount 9etai,s dialog bo0> &hich
displays a set o) options related to the current state o) the user record> including mail serer
options that automatically )ill in &ith releant alues ,see Figure $$..
$. +eie& the le)t<hand column o) user<speci)ic options> and ma!e any needed changesE
Fied $escription
/ogin 9nter the mail serer user name )or this record.
Pass&ord 9nter the related pass&ord.
5on)irm pass&ord +e<enter the same pass&ord te0t.
9<mail address 9nter the )ull te0t o) this userIs email address.
9nable Push 5hec! this )lag to enable push noti)ications.
9nable Polling 5hec! this )lag to enable polling.
+e)resh time ,min. 9nter a number that determines ho& many minutes bet&een mailbo0 pollings.
Ma0 email number ,Applies to P"P accounts. 5hoose a number )rom the menu to control the ma0imum
number o) email messages that are pushed to the user at one time.
Ma0 IMAP emails ,Applies to IMAP accounts. 5hoose a number )rom the menu to set the ma0imum
number o) email messages that are cached )rom the Inbo0> 1ra)ts> Sent and 4rash
)olders at one time.
3. +eie& the right<hand mail serer<speci)ic options> but donIt ma!e any changes at this time.
6. "pen the Mai, 0er1er menu and choose the pre<e0isting mail serer used by this user. 4he
e0isting serer settings automatically load into this dialog bo0. All the options are read<only> as
sho&n in Figure $3.
Fi$ure EE: User A##ount 9etai,s
+epeat this procedure as needed to lin! all users to mail serers.
".#.3. $ctivating mailbo1 listening and email ush for user accounts
I) a user &ishes to ma!e use o) email push> you can use the Funambol Administration 4ool to open
that userIs record and reset the releant Inbo0 /istener Serice actiation options.
1. 90pand the Na1i$ation pane tree to Modu,es L emai, L Funam/o,!mai,*onne#tor and double<
clic! Funam/o,!mai,*onne#tor. 4he 9mail 5onnector options appear in the &or!ing pane>
diided into t&o collections o) options.
2. Select a user record ,a)ter searching )or and )inding the records. and clic! !dit.
$. %hen the User A##ount 9etai,s dialog bo0 appears> loo! )or the optionE
!na/,e .us+ J 5hec! to actiate email push> by &hich the Inbo0 /istener Serice noti)ies
the 1ata Synchroni2ation Serice o) ne& email to be pushed to the userIs client.
4his &ill enable push to the user. 4he push mode depends on the user deiceFs capabilitiesE the serer
&ill )irst try to use connection<less push &ith the deice> than connection<oriented push> and )inally
SMS<based push> i) permitted to do so by the parameter in the respectie -M/ )ile located in the
directory $FUNAMBOL_OM!;#onfi$;#om;funam/o,;ser1er;notifi#ation.
9oteE SMS<based push is not proided out<o)<the<bo0.
".%. Forcing the verification of SS2 certificates
By de)ault> Funambol doesnFt eri)y the certi)icates proided by email serers in SS/ connections. 4his
doesnFt mean that the communication bet&een Funambol and the email serers are not encrypted> but
that the authenticity o) the certi)icates is not eri)ied. 4his ma!es it possible )or the portal to connect to
email serer that support SS/ &ithout any manual interention.
I) you are &orried about this behaior> you can change it editing the )ollo&ing )ilesE
Funam/o,;#onfi$;#om;funam/o,;emai,;in/o",istener;tas2;&n/o"Listener@as2("m,
Funam/o,;#onfi$;emai,;emai,;Funam/o,!mai,*onne#tor("m,
Fi$ure EG: User A##ount 9etai,s M read on,y detai,s
and setting the #+e#2*ertifi#ates property to NtrueN.
".6. -anuall) enabling encr)tion A encoding
All communication bet&een the 9mail 5onnector and any SyncM/ client is automatically encoded &ith
base73. I) you pre)er> those communications can be encoded &ith both 19S and base73. 4o do so>
)ollo& the procedure described belo&E
1. In the Na1i$ation pane> e0pand the serer tree and double<clic! 0er1er 0ettin$s. 4he 0er1er
0ettin$s options appear in the 9ata !ntry pane.
2. /ocate the 9ata @ransformer Mana$er option ,under !n$ine. and clic! the *onfi$ure button to
the right o) the )ield.
$. %hen the 9ata @ransformer Mana$er *onfi$uration options appears as sho&n in Figure $6>
clic! the ?J@ icon in the upper right corner o) the 9ata @ransformations table.
4his creates a ne& ro& at the bottom o) the table.
3. Ma!e the )ollo&ing entries in each column o) the ne& ro&E
Fi$ure E5: 9ata @ransformer Mana$er *onfi$uration
Fied $escription
Source C+I 9nter the alue o) the Source C+I ,e.g.> the string ?mail@. o) the SyncSource instance
you created in the preious section.
4rans)ormation 9nter this te0tE ?desTb73@ to apply the 19S cipher and Base73 encoding.
6. 5lic! 0a1e to apply this encryption trans)ormation.
".7. The Inbo1 2istener Service
In conUunction &ith the 9mail 5onnector> the Inbo0 /istener Serice is a !ey component that ma!es it
possible )or the Funambol 1ata Synchroni2ation Serice to monitor e0ternal mail serers> and &hen
ne& in<bound messages are detected in a userIs mailbo0> to do the )ollo&ingE
Send an alert to the user.
Automatically sync ,?push@. the ne& messages to the userIs Funambol archies.
%hen a ne& message is detected by the Inbo0 /istener Serice> the Funambol engine noti)ies the
userIs deice about the ne& mail. 4he deice then initiates the email synchroni2ation process &ith the
email serer ia the Funambol engine and Funambol 9mail 5onnector.
9oteE there is no access to the Inbo0 /istener Serice by means o) the Administration 4ool. Gou must
use the command line ,as detailed in the )ollo&ing sections. to con)igure and manage the Inbo0
/istener Serice.
"... Configuring the Inbo1 2istener Service
4o customi2e the Inbo0 /istener Serice to match your system> you &ill )ollo& the procedure detailed
in this section. Gou may need to repeat the procedure t&ice> to coer P"P mail and IMAP mail. 4he
)ollo&ing cannot be done &ith the Administration 4oolT you must use a command line &indo&.
1. 5hange to the directory $FUNAMBOL_OM!;#onfi$;#om;funam/o,;emai,;in/o",istener and
open the &n/o"Listener*onfi$uration("m, )ile using a te0t editor.
2. +eie& and edit any o) the )ollo&ing propertiesE
Property $escription
ma04hreadPoolSi2e Speci)ies the ma0 number o) threads that can be used. 4his should be a )unction o)
the number o) users to monitor.
health4hread90ecutionPeriod Sets the interal ,in seconds. bet&een e0ecutions o) the :ealth4hread> a thread
that at regular interals assesses the Inbo0 /istener Serice status.
registryMonitorPolling4ime Sets the interal ,in seconds. bet&een e0ecutions o) the +egistryMonitor> a thread
that regularly chec!s the database )or changes to the monitored accounts.
tas!Period4olerance Sets the tolerance accepted on the period bet&een t&o data chec!s. I) a user is
scheduled to be chec!ed eery 0 seconds ,period.> the serer &ill produce a
&arning log entry i) the data chec! occurs a)ter 0 X period4olerance80
registry4able;ame 1e)ines the table that contains the push registry entries. By de)ault
)nblRemailRpushRregistry.
registry9ntriesIdSpace I1 space used to create unique identi)iers )or registry entries. By de)ault
email.registryid.
plugin1irectory 4he directory )rom &hich the serice loads plug<ins.
%SSererIn)ormation +ecords the in)ormation used to call any &ebserices e0posed by the 1ata
Synchroni2ation Serice> as noted belo&E
ur,E the Funambol engine administration C+/
usernameE the Funambol engine administrator username
'ass=ordE the Funambol engine administrator pass&ord
cluster5on)iguration 5ontains the in)ormation used to create a cluster bet&een t&o or more Inbo0
/istener Serices.
$. Sae your changes and close the )ile.
"...1. Inbo1 2istener Service configuration strateg)
I) you anticipate a large number o) users &ho &ant email push )or their mail data> the cluster
con)iguration o) the Inbo0 /istener Serice is suggestedT in this con)iguration> load balancing is
implemented )or better per)ormances.
".". Starting and stoing the Inbo1 2istener Service
4o start the Inbo0 /istener Serice> )ollo& these stepsE
1. "pen a command line &indo& ,%indo&s or /inu0..
2. At the prompt> type the )ollo&ingE
on %indo&sE
c6 %FUNAMBOL_)OME=bin
inbox1li-tene+.c06 -ta+t >16eb$g?
on /inu0E ,you must hae superuser priileges.
c6 %FUNAMBOL_)OME5bin
.5inbox1li-tene+ -ta+t >16eb$g?
4o stop the Inbo0 /istener Serice> )ollo& these stepsE
1. "pen a command line &indo&.
2. 4ype the )ollo&ing at the promptE
on %indo&sE
inbox1li-tene+.c06 -top
on /inu0E
.5inbox1li-tene+ -top
9oteE i) the Inbo0 /istener Serice &as started &ith the 7de/u$ option> use the *tr,7* !ey combination
to stop it.
".1,. (atabase maintenance
%hen using a PostgreSD/ database> you need to periodically chec! the the si2e o) the
fn/,_emai,_in/o" table. 4o do so> go to the PostgreSD/ console and run this queryE
-elect @ /+o0 pg_+elation_-iAe("/nbl_e0ail_inbox")'
&hich &ill return the number o) bytes occupied by the fn/,_emai,_in/o" ta/,e.
I) necessary> use the (A5CCM )acility proided )or PostgreSD/ to clean up the database.
4o do a deeper cleaning and )ree the dis! space> the (A5CCM )unction should be run &ith the Nfu,,N
option. Please re)er to o))icial PostgreSD/ documentation )or )urther details.
1,. /sing the 3I- 2istener Service
PIM> or Personal In)ormation Management> is the standard term used to re)er to the collection o)
personal in)ormation ,contacts> calendar entries> notes> tas!s> etc.. that the user can synchroni2e &ith
the serer using the Funambol so)t&are.
4he Funambol PIM /istener Serice monitors the 1ata Synchroni2ation Serice PIM database. I) PIM
/istener Serice detects any out<o)<sync data> a prompt is sent to the Funambol engine. I) correctly
con)igured> the serer noti)ies any a))ected> out<o)<sync deices using the appropriate push mode
,connectionless> connection<oriented or SMS. T the deices> in response> automatically initiate a ne&
synchroni2ation process to update all their data.
9oteE SMS<based push is not proided out<o)<the<bo0.
1,.1. Configuring the 3I- 2istener Service
4his section details the con)iguration o) the so)t&are> including log settings ,see section 1*.1.1..
1. 5hange to the directory $FUNAMBOL_OM!;#onfi$;#om;funam/o,;'im,istener;
2. "pen the .&MListener*onfi$uration("m, )ile.
$. +eie& and edit the )ollo&ing propertiesE
ma04hreadPoolSi2e Speci)ies the ma0 number o) threads that can be used. 4his should be a )unction o)
the number o) users to monitor.
health4hread90ecutionPeriod Sets the interal ,in seconds. bet&een e0ecutions o) the :ealth4hread> a thread
that at regular interals assesses the PIM /istener Serice status.
registryMonitorPolling4ime Sets the interal ,in seconds. bet&een e0ecutions o) the +egistryMonitor> a thread
that regularly chec!s the database )or changes to the monitored accounts.
tas!Period4olerance Sets the tolerance accepted on the period bet&een t&o data chec!s. I) a user is
scheduled to be chec!ed eery 0 seconds ,period.> a &arning is triggered i) the data
chec! occurs a)ter " J 'eriod@o,eran#e;"
registry4able;ame 1e)ines the table that contains the push registry entries. By de)ault
fn/,_'us+_,istener_re$istry.
registry9ntriesIdSpace I1 space used to create unique identi)iers )or registry entries. By de)ault
'us+,istener(id.
plugin1irectory 4he directory )rom &hich the serice loads plug<ins.
%SSererIn)ormation +ecords the in)ormation used to call any &eb serices e0posed by the 1ata
Synchroni2ation Serice> as noted belo&E
ur,E the Funambol engine administration C+/
usernameE the Funambol engine administrator username
'ass=ordE the Funambol engine administrator pass&ord
cluster5on)iguration 5ontains the in)ormation used to create a cluster bet&een t&o or more PIM /istener
Serices.
3. Sae your changes and close the )ile.
1,.1.1. Configuring 3I- 2istener Service logging
4he Funambol PIM /istener Serice uses /og3U as the basis )or its logging system. In order to
con)igure the PIM /istener Serice log> )ollo& these stepsE
1. 5hange to the directory $FUNAMBOL_OM!;#onfi$
2. "pen the ,o$GK7'im,istener("m, )ile.
9oteE there is no need to restart the 1ata Synchroni2ation Serice )or changes to ta!e e))ect since> by
de)ault> this )ile is chec!ed )or updates eery $* seconds.
+e)er to o))icial /og3U documentation )or details about log con)iguration.
1,.1.2. $bout the detailed aenders
By de)ault> t&o detailed appenders are con)igured in the PIM /istener SericeE
detailed<console
detailed<log<)ile
Both appenders use this layoutE
>B6CDDDD1MM166 ))<00<--ESSSF? >Bc? >Bp? >Bt? >BGCent+DI6F? >BGC6e3iceI6F?
>BGC$-e+Na0eF? >BGC-o$+ceURIF? B0Bn
4hese options> &hen utili2ed )ully> create a ery enriched log message &ith this Ote0tPE
$-e+na0e56e3iceI65-o$+ceU+i
1,.2. $ctivating and using the 3I- 2istener Service
Actiating and using the PIM /istener Serice
4his section coers the procedures )or starting the PIM /istener Serice> and managing the user
account database. 4he )ollo&ing tas!s are coered in separate sub<sections.
Starting the PIM /istener Serice ,see 1*.2.1.
Monitoring the status o) the PIM /istener Serice ,see 1*.2.2.
Adding user accounts to the PIM /istener Serice ,see 1*.2.$.
Stopping the PIM /istener Serice ,see 1*.2.3.
1,.2.1. Starting the 3I- 2istener Service
4o start the PIM /istener Serice a)ter con)iguring the scripts> open a command line &indo& and type
the )ollo&ing at the promptE
on %indo&sE
pi01li-tene+.c06 -ta+t >16eb$g?
.5pi01li-tene+ -ta+t >16eb$g?
9oteE i) you run the PIM /istener Serice using the 7de/u$ option> the output messages &ill be
displayed on the console.
1,.2.2. -onitoring the 3I- 2istener Service status
4o reie& the current PIM /istener Serice status> open a command line &indo& and type the
)ollo&ing at the promptE
on %indo&sE
pi01li-tene+.c06 -tat$-
on /inu0E
.5pi01li-tene+ -tat$-
1,.2.3. -anaging the user account database
4o con)igure the users that must be monitored> )ollo& these stepsE
1. "pen a command line &indo& and type the )ollo&ing at the promptE
on %indo&sE
pi01li-tene+.c06 con-ole
on /inu0E
c6 %FUNAMBOL_)OME
.5pi01li-tene+ con-ole
2. %hen the PIM /istener Serice console &indo& appears> use the )ollo&ing commands to
enter and8or manage your user accountsE
&o##and $escription
* J quit 90its the PIM /istener Serice console.
11 J list entries 1isplays a list o) all monitored users ,entries..
12 J list entries by user;ame 1isplays a list o) all entries associated &ith a speci)ic user.
13 J get entry 1isplays the entry &ith a speci)ied I1.
16 J enable entry 9nables the entry &ith a speci)ied I1.
17 J disable entry 1isables the entry &ith a speci)ied I1.
17 J insert entry Inserts a ne& entry through a guided procedure. Please note that by actiating
calendars> tas!s &ill be actiated as &ell.
1# J update entry Cpdate an already e0isting entry.
1' J mar! an entry as deleted Mar!s an entry deleted. 4he record in the database &ill be automatically deleted by
the PIM /istener Serice itsel).
1,.2.#. Stoing the 3I- 2istener Service
4o stop the PIM /istener Serice> open a command line &indo& and type the )ollo&ing at the promptE
on %indo&sE
pi01li-tene+.c06 -top
on /inu0E
.5pi01li-tene+ -top
9oteE i) the PIM /istener Serice &as started &ith the 7de/u$ option> use the *tr,7* !ey combination to
stop it.
11. /sing the 3ush Connection Service
4he Funambol Push 5onnection Serice is responsible )or managing the connections bet&een the
mobile deice and the Funambol 1ata Synchroni2ation Serice.
11.1. Configuring the 3ush Connection Service
4his section details the con)iguration o) the so)t&are> including log settings ,see ..
1. 5hange to the directory $FUNAMBOL_OM!;#onfi$;#om;funam/o,;#t';ser1er;
2. "pen the *@.0er1er*onfi$uration("m, )ile.
$. +eie& and edit the )ollo&ing propertiesE
port;umber By de)ault> the Push 5onnection Serice opens a serer soc!et on port 3736. 5lient
deices connect to this port in order to receie noti)ication messages. I) you &ish to
change the port> change the alue o) this property accordingly.
loggingFilter9nabled By de)ault> the Push 5onnection Serice does not log incoming and outgoing
messages. I) you &ant to log them you hae to enable the logging )ilter by setting
the alue o) this property to ?true@.
Please note that the incoming and outgoing messages are logged at ?trace@ leel>
so you hae to enable logging leel to ?All@ in the )ile ,o$GK7#t'ser1er("m, located in
the directoryE $FUNAMBOL_OM!;#onfi$;
%SSererIn)ormation By de)ault> the Push 5onnection Serice connects to the 1ata Synchroni2ation
Serice &eb serice at the C+/ httpE88localhostE#*#*8)unambol8serices8admin using
user L ?admin@ and pass&ord L ?sa@.
I) you &ish to change these details> modi)y the alue o) the sub<properties url>
username and pass&ord.
noti)icationGroup;ame By de)ault> Push 5onnection Serices and Push Senders communicate using the
group name #t'7notifi#ation7$rou'. I) you &ish to install t&o distinct groups o)
processes> you must speci)y a di))erent group name either )or the Push 5onnection
Serices or )or the Push SendersE
4o speci)y the group name )or the Push 5onnection Serice> modi)y the alue o)
this property.
4o speci)y the group name )or the Push Sender> open the
YFC;AMB"/R:"M98con)ig8com8)unambol8serer8noti)ication8PushSender.0ml
)ile and modi)y the group;ame property.
11.1.1. Configuring 3ush Connection Service logging
4he Funambol Push 5onnection Serice uses /og3U as the basis )or its logging system. In order to
con)igure the Push 5onnection Serice log> )ollo& these stepsE
1. 5hange to the directory $FUNAMBOL_OM!;#onfi$ dire#tory
2. "pen the ,o$GK7#t'ser1er("m, )ile.
9oteE there is no need to restart the 1ata Synchroni2ation Serice )or changes to ta!e e))ect since> by
de)ault> this )ile is chec!ed )or updates eery $* seconds.
Please re)er to o))icial /og3U documentation )or details about log con)iguration.
11.2. $ctivating and using the 3ush Connection Service
4his section coers the procedures )or starting the Push 5onnection Serice and managing the user
account database. 4he )ollo&ing tas!s are coered in separate sub<sections.
Starting the Push 5onnection Serice ,see 11.2.1.
Monitoring the status o) the Push 5onnection Serice ,see 11.2.2.
Stopping the Push 5onnection Serice ,see 11.2.$.
11.2.1. Starting the 3ush Connection Service
4o start the Push 5onnection Serice a)ter con)iguring the scripts> open a command line &indo& and
type the )ollo&ing at the promptE
on %indo&sE
ctp1-e+3e+.c06 -ta+t >16eb$g?
.5ctp1-e+3e+ -ta+t >16eb$g?
9oteE i) you run the PIM /istener using the 7de/u$ option> the output messages &ill be displayed on
the console.
11.2.2. -onitoring the 3ush Connection Service status
4o reie& the current Push 5onnection Serice status> open a command line &indo& and type the
)ollo&ing at the promptE
on %indo&sE
ctp1-e+3e+.c06 -tat$-
on /inu0E
.5ctp1-e+3e+ -tat$-
11.2.3. Stoing the 3ush Connection Service status
4o stop the Push 5onnection Serice> open a command line &indo& and type the )ollo&ing at the
promptE
on %indo&sE
ctp1-e+3e+.c06 -top
on /inu0E
.5ctp1-e+3e+ -top
9oteE i) the Push 5onnection Serice &as started &ith the 7de/u$ option> use the *tr,7* !ey
combination to stop it.
12. Customi*ing the (S Service4s log settings
A basic 1ata Synchroni2ation Serice installation proides a single log )ile called ds7ser1er(,o$> &hich
you &ill )ind in the $FUNAMBOL_OM!;,o$s;ds7ser1er directory. 4his )ile has been structured to store
a lot o) in)ormationT i) you pre)er> you can use the Funambol Administration 4ool to redirect logging )or
speci)ic serer components so that more re)ined output is sorted into distinct log )iles.
12.1. Getting started
4o reie& the settings )or the de)ault system logger> )ollo& these stepsE
1. In the Funambol Administration 4ool> e0pand the naigation pane serer tree to 0er1er
settin$s 78 Lo$$in$ 78 Lo$$ers. A list o) logging categories ,called ?loggers@. appears belo&
Lo$$in$> as sho&n in Figure $7.
A second list o) logging con)iguration )iles ,called ?appenders@. are also listed here.
2. 4o reie& the de)ault log )ile settings ,automatically applied to all other loggers.> double<clic!
funam/o, ,under ?loggers@..
4he pane displays the current logger settings> &hich are editable ,see Figure $7..
Fi$ure E5: Lo$$ers
4hese settings are automatically applied to all o) the other listed loggers.
$. 4o reie& and customi2e each logging category> double<clic! each logger name in the Lo$$er
tree. ;ote that all o) the options o) all other loggers are grayed out ,inactie..
3. 4o customi2e the settings )or a speci)ic serer logger> unchec! the Same as Funambol
chec!bo0.
6. 4he )ollo&ing logging parameters become actie> &hich you can no& reiseE
Lo$$in$ Le1e,. "pen this menu and choose the leel o) in)ormation to be logged ,see
Figure $#.. 4he de)ault menu choice is &NFO.
4he menu choice range )rom ")) to All> re)lecting the )ollo&ingE
OFF L no in)ormation logged
ALL L in)o> errors and debug in)ormation are logged.
Fi$ure E4: Lo$$in$ ,e1e,
Fi$ure EH: Lo$$er settin$s
4o record all serer problems &hen debugging the serer or a SyncSource> choose ALL.
4his leel proides the most in)ormation. Gou should also use ALL i) you &ish to submit a
log )ile )or consideration by participants in any Funambol mailing lists.
A''enders. 4his list displays the releant appenders that control aspects o) this loggerIs
operations. Gou can reie& each o) the appenders and their settings in a separate
procedure> detailed in the )ollo&ing section.
Users =it+ Le1e,(ALL. 4his list is )or additional logs that trac! speci)ic indiidual users. 4o
add a user to this list> clic! the plus OXP button> then double<clic! the ?user name@ ro& that
appears to actiate the te0t )ield.
4ype the e0act te0t o) a user name in this )ield> then clic! any&here in the pane. 4he
funam/o,_ds(,o$ )ile no& trac!s the actiities o) the selected user.
9oteE the log to ALL )or users is alid only )or speci)ic actions ,)or e0ample> syncing. carried
out by a particular user> but it does not a))ect SMS sending. In order to enable )ull logging on
SMS sending as &ell> &hich is controlled by the logger funam/o,(ser1er(notifi#ation(su/itosms>
you must enable )ull logging on the parent loggerE funam/o,(ser1er(notifi#ation> by )ollo&ing
these stepsE
1. "pen the Funambol Administration 4ool
2. /og in to the serer you &ant to manage
$. 90pand the serer name
3. 90pand 0er1er settin$s L Lo$$in$ L Lo$$ers
6. 1ouble clic! on funam/o,(ser1er(notifi#ationT the logger con)iguration panel &ill appear on
the right.
7. Cnchec! %0ame as funam/o,(ser1er)( By doing so> you are speci)ying di))erent logging
settings )or the speci)ic logger.
7. Set Lo$$in$ ,e1e, to ALL
#. Select funam/o,(,o$fi,e in the Appenders list.
%hen done> clic! 0a1e to apply your changes. A con)irmation message appears in the Out'ut 7
Messa$es pane.
12.2. &evie'ing the logging aenders
Appenders are )iles that store particular con)igurations that you can customi2e on a per<log basis.
settin$s 78 Lo$$in$ 78 A''enders ,see Figure $'..
4he appenders listed in the ;aigation tree areE
funam/o,(#onso,e
funam/o,(#ontent7'ro1ider(,o$fi,e
funam/o,(dai,y7,o$fi,e
funam/o,(+our,y7,o$fi,e
funam/o,(,o$fi,e
2. 1ouble<clic! an appender to reie& its current settings. 4he appender<speci)ic options appear
in the &or!ing pane.
For e0ample> i) you open the funam/o,(#onso,e appender> the dialog bo0 sho&n in Figure 3*
appearsE
4he )ollo&ing options are used to )ormat appendersE
%ption $escription
File ;ame Stores the log )ile name and e0act path&ay.
1ate Pattern ;otes the pattern o) date entries.
File Si2e /imit Sets a ma0imum si2e )or a log )ile> be)ore earliest entries are deleted to ma!e room.
+otation File 5ount 1etermines ho& many separate log )iles can be maintained.
Pattern /ayout 9dit these te0t string elements to control ho& much data is stored per entryE
8 < the local pathname separator
Zt < the system temporary directory
Zh < the alue o) the user(+ome system property
Zg < an automatically generated number to distinguish rotated logs
Zu < a unique number to resole con)licts
ZZ < translates to a single percent sign ,Z.
5opy the current .attern Layout string to a te0t editor> ma!e any needed changes> then copy it
bac! to this te0t )ield.
Fi$ure G0: funam/o,(#onso,e a''ender settin$s
Fi$ure EI: A''enders
$. 5lic! 0a1e to apply any changes. A con)irmation message appears in the Out'ut 7 Messa$es
pane.
12.3. Customi*ing log files on a er5user basis
It is possible to add indiidual users to the log )iles maintained by the 1ata Synchroni2ation Serice. In
addition to system status and actiities> log )iles can no& be directed to record all the actiities o)
indiidual users.
4his enables you to chec! the actiities and any potential problems e0perienced by users> )rom the
point o) ie& o) the serer. All you need is the e0act Funambol username and the appropriate log )ile.
4o set up a log )ile )or an indiidual user> )ollo& these stepsE
settin$s 78 Lo$$in$ 78 Lo$$ers( A list o) logging categories appears.
2. 1ouble<clic! the appropriate log )ile ,under ?loggers@.. ;ote that all o) the options o) this logger
are grayed out ,inactie..
$. 4o add a user to this logger> unchec! the %0ame as Funam/o,) chec!bo0.
3. Gou can no& add one or more user<speci)ic log )iles> by means o) the Users =it+ Le1e,(ALL
listE
1. 5lic! the plus OXP button.
2. 1ouble<clic! the user name ro& that appears ,see ..
4his actiates the te0t )ield.
$. 4ype the e0act te0t o) the Funambol user name in this )ield.
3. 5lic! any&here in the pane to sae your entry.
6. +epeat this procedure to add other users> as needed.
An additional log )ile &ill be !ept ,&ith ?leel A//@. that trac!s the actiities o) the ne&ly
entered user.
6. 5lic! 0a1e to apply your changes. A con)irmation message appears in the Out'ut 7 Messa$es
pane.
Fi$ure G1: Users =it+ Le1e,(ALL
13. Test5driving Funambol
4his section presents seeral test dries that &ill help you ealuate the use o) a 1ata Synchroni2ation
Serice at &hat it does bestE synchroni2ing important personal data on a &ide range o) client deices
and applications.
13.1. 63roof of concet7 test drive
4he )irst test drie> &hich is called a ?proo) o) concept@> installs all the so)t&are and accessories that let
you try out the 1ata Synchroni2ation Serice in an e))icient simulation mode. Gou use a pre<pac!aged
Serer demo> a Sync 5lient demo> and ,optionally. a local copy o) Microso)t "utloo!> to try out the
)ollo&ingE
Storing and managing personal in)ormation on the Funambol Serer
Synchroni2ing serer data &ith in)ormation stored on the mobile deice
Installing the Funambol "utloo! Sync 5lient and running a "utloo!<to<serer<to<mobile deice
synchroni2ation ,optional.
4his test drie sho&s ho& both Funambol administrators and users can use Funambol to set up user
data stores and to synchroni2e that data &ith other deicesE
As a prospectie Funambol administrator> you use a demo bro&ser<based Administration 4ool
to add user<speci)ic contact and calendar data to a 1ata Synchroni2ation Serice at your site.
As a prospectie Funambol user> you use a demo client to synchroni2e a )ictitious deice to
the Funambol Serer> to copy the ne&ly entered contact and eent data.
See chapter 13 )or a detailed description o) this test.
13.2. 6&eal 'orld7 test drive
I) you hae a host computer that is accessible by other deices outside your net&or! &ith actie
Internet connections> the Funambol Serer pac!age installs all the so)t&are and accessories that let
you try out the 1ata Synchroni2ation Serice in a ?real &orld@ test drie.
In )act> you can !eep running this Funambol installation a)ter a success)ul test drie i) your potential
user group is small enough and you donIt plan on trying to sync Funambol &ith an email serer or any
other e0ternal data source. 4his lo&<scale implementation allo&s you and a small number o) users to
synchroni2e your contact records and calendar items &ith a minimum o) setup inoled.
See chapter 16 )or a detailed description o) this test.
13.3. S)nchroni*ing )our -icrosoft :utloo! data
;ot only can you> as a user> connect &ith any number o) SyncM/<enabled mobile deices and
synchroni2e data bet&een their Funambol data stores and their client deices> but you can use the
Funambol Sync 5lient &ith %indo&s Mobile and Haa M9 phones> and also &ith iPods or copies o)
Microso)t "utloo! to e0change data &ith the Funambol Serer.
A !ey test drie component> aailable to both ?proo) o) concept@ and ?real &orld@ test dries> is the
Funambol "utloo! Sync 5lient. A)ter installation o) the client on your computer> you can synchroni2e
your contacts> notes> tas!s> and calendar entries. Gou can then run a )ull ?real &orld@ through<the<
internet sync or a ?proo) o) concept@ sync on the local Funambol host.
4his additional test is detailed in section 16.2. Gou can ta!e adantage o) this )eature a)ter completing
the preliminary test drie ealuations.
13.#. Bo' do test drives comareC
4he )ollo&ing table sho&s ho& each test drie di))ers in setup> use> and scope.
+Proof of concept, test drive +-ea word, test drive
"ne user> on a single P5 "ne or more users
;o user accounts Cser accounts aailable
;o out<o)<net&or! access Both in<net&or! and Internet access )or all users
So)t&are simulators Actual deices and so)t&are clients
"ne user syncs data )rom Microso)t "utloo! "ne or more users sync data &ith multiple copies o) "utloo!
SetupE none SetupE Minor net&or! con)iguration
"nce you determine &hich scenario you &ould li!e to ta!e adantage o) ,i) not both.> this guide ta!es
you through the preparation and use o) Funambol in the )ollo&ingE
Synchroni2ing a small set o) data &ith a mobile deice emulator or a local copy o) Microso)t
"utloo! on the Funambol host computer.
Synchroni2ing real data on any number o) real client deices or client applications such as
Microso)t "utloo! through the net&or! or Internet.
1#. Ta!ing the 6roof of concet7 test drive
4his chapter &ill help you try out the ?proo) o) concept@ test drie brie)ly described in section 1$.1 using
conenient so)t&are emulators ,installed as part o) the Funambol Serer pac!age. to do the )ollo&ingE
Storing and managing personal in)ormation on the Funambol Serer
Ma!ing a deice<to<serer connection> in &hich serer data is synchroni2ed &ith in)ormation
stored on the mobile deice
I) you &ant> you can also install and use the Funambol "utloo! Sync 5lient to run an "utloo!<to<
serer<to<mobile deice synchroni2ation ,optional. as detailed in section 16.2.
4his simulation gies you an e0perience o) ho& both administrators and users &ould use Funambol.
As a prospectie Funambol administrator> you &ould install> con)igure and manage a 1ata
Synchroni2ation Serice at your site> and &ould &ant to !no& ho& data is synchroni2ed and &hat data
is trans)erred during a sync. 4his simulation &ill proe ho& the concept actually &or!s.
1#.1. -anaging user data on the Funambol (ata S)nchroni*ation
Service
A)ter installing and starting the Funambol Serer> you can do the )ollo&ingE
+eie& already<loaded personal in)ormation on the serer
Add more data ,such as personal in)ormation. to the serer database
4hese t&o tas!s let you e0perience the role o) an administrator &or!ing on a 1ata Synchroni2ation
Serice &ith the Administration 4ool.
4he scope o) this test drie encompasses personal contacts and calendar entries.
1#.1.1. Getting started
4o start a &eb bro&ser that auto<loads the %eb 1emo 5lient> )ollo& these stepsE
1. ,on %indo&s. "pen the 0tart menu and choose .ro$rams L Funam/o, L <e/ 9emo *,ient and
then clic! on the <e/ 9emo *,ient te0t lin!.
,on /inu0. "pen your bro&ser at the )ollo&ing C+/E +tt':;;,o#a,+ost:4040;=e/demo
A login page appears> as sho&n in Figure 32.
2. As the printed instructions suggest> enter the &ord ?guest@ as both Csername and Pass&ord
and clic! Lo$in.
4he bro&ser should no& display the Funambol %eb 1emo 5lient page ,see Figure 3$..
Gou &ill use this &eb demo to create ne& personal contact and calendar entries on the serer.
1#.1.2. $dding a ne' $ddress Eoo! contact to the database
At this time> you add a ne& contact to the Address Boo! that e))ectiely stores the record on the 1ata
Synchroni2ation Serice.
4o create a ne& contact> )ollo& these stepsE
1. 5lic! the ?ne&@ te0t lin!> as sho&n in Figure 33.
Fi$ure G2: Funam/o, <e/ 9emo *,ient ,o$in s#reen
Fi$ure GE: Funam/o, <e/ 9emo *,ient initia, 'a$e
4he *onta#t 9etai,s page appears> displaying empty contact data )ields ,see Figure 36..
2. 5lic! in the data )ields and type the in)ormation )or a ne& contact.
9oteE you Uust need to enter First Name> Last Name and Main .+one.
$. 1o not )ill in the 9is',ay Name )ieldT it auto<)ills &ith ?/ast ;ame> First ;ame@ a)ter you ma!e
those entries..
3. %hen done> clic! Add to sae your changes.
6. A)ter the *onta#t 9etai,s page re)reshes itsel)> clic! Ba#2 to reopen the *onta#t List page.
Gour ne& entry should be listed.
1#.1.3. $dding a ne' Calendar entr) to the database
4o create a ne& calendar entry> )ollo& these stepsE
1. In the le)t column> clic! *a,endars. A blan! *a,endars List appears ,see Figure 37..
Fi$ure GG: *reate a ne= #onta#t
Fi$ure G5: *onta#t 9etai,s 'a$e
Fi$ure G5: *a,endars ,ist
2. 5lic! the ?ne&@ te0t lin! to add a ne& eent to the list. 4he *a,endar 9etai,s page appears
,see Figure 37..
$. Cse the )eatures to create an entry )or an eent ,such as> )or e0ample> your birthday..
Gou can enter a 9es#ri'tion> a 0ummary> and 0tart and !nd times8dates.
9oteE the te0t in the 0ummary te0t )ield is &hat &ill be listed in the *a,endars List menu.
3. %hen you are done> clic! Add to sae your changes.
6. +epeat this procedure to add other upcoming eents> i) you choose.
7. %hen done> clic! Ba#2 to reopen the *a,endars list page. Gour ne& eent entries should be
listed there.
Gou can no& minimi2e the bro&ser &indo& and re)er to it as the simulation proceeds.
1#.1.#. Test rearation summar)
Gou hae Uust loaded a sample o) personal and calendar in)ormation into the Funambol 1ata
Synchroni2ation Serice> Uust as you might do using the Funambol Administration 4ool.
;o& you can use the Haa 1emo 5lient to simulate &hat happens &hen you> as a &ould<be user>
synchroni2e a SyncM/<enabled mobile deice &ith your e0isting 1ata Synchroni2ation Serice
records.
Fi$ure GH: *a,endar 9etai,s 'a$e
1#.2. S)nchroni*ing a mobile device 'ith the Funambol (ata
S)nchroni*ation Service (atabase
%ith personal in)ormation stored in the Funambol Serer> you can simulate the synchroni2ation o) the
address boo! or calendar bet&een a mobile deice and your data on a 1ata Synchroni2ation Serice
database. 4o do so> you use a Haa 1emo 5lient that &as installed as part o) the Funambol Serer
pac!age.
9oteE this simulation assumes that the SyncM/ deice has already been con)igured to communicate
&ith the Funambol Serer.
4o start the Haa 1emo 5lient> )ollo& these stepsE
1. ,on %indo&s. "pen the 0tart menu and choose A,, .ro$rams L Funam/o, L Ja1a 9emo *,ient
or or go to $FUNAMBOL_OM!;',u$7ins;Ka1ademo;/in and run the commandE
6e0o.c06
,on /inu0. At the prompt> change to $FUNAMBOL_OM!;',u$7ins;Ka1ademo;/in and run the
commandE
.56e0o.-.
%hen the Funambol Haa 1emo 5lient client &indo& appears> it displays an empty *onta#t
List ,see Figure 3#..
2. 5lic! 0yn#+roni:e at the bottom o) the &indo&. A series o) log entries appears in the client
&indo&> as sho&n in Figure 3'.
$. 5lic! O? to return to the *onta#t List.
Fi$ure G4: @+e Funam/o, Ja1a 9emo *,ient
I) the synchroni2ation is success)ul> you &ill see the records )rom the Funambol Serer in the
*onta#t List> that you preiously entered &ith the %eb 1emo 5lient. 4hese records are no&
aailable through the mobile deice.
3. 4o ie& any synchroni2ed calendar entries> choose Bie=;*a,endar List.
1#.3. S)nchroni*ing -icrosoft :utloo! 'ith the Funambol (ata
S)nchroni*ation Service
At this point you hae success)ully stored personal data in the Funambol Serer> then synchroni2ed
the data &ith your Haa 1emo 5lient. It may be help)ul to ta!e the simulation one step )urther> and
attempt a synchroni2ation o) your Microso)t "utloo! contacts &ith the Funambol Serer on your
computer> then synchroni2e the ne& entries to the Haa 1emo 5lient.
4o ta!e adantage o) this> )ollo& the procedure detailed in section 16.2.
Fi$ure GI: Lo$ info in t+e Funam/o, Ja1a 9emo *,ient
1%. Ta!ing the 6real 'orld7 test drive
Follo&ing installation> the Funambol 1ata Synchroni2ation Serice is ready to use out<o)<the<bo0. I)
you pre)er the ?real &orld@ test drie> you &ill need to complete a brie) con)iguration o) the 1ata
Synchroni2ation Serice be)ore starting. 4his preparation ,i.e. entering a alid net&or! address. &ill be
detailed in this chapter. Gou can then start your ?real &orld@ test drie> either &ith an "utloo!<to<
Funambol synchroni2ation or letting real users connect &ith real mobile deices to your 1ata
Synchroni2ation Serice through the Internet.
4he preliminary con)iguration procedures are completed &ith the Funambol Administration 4ool> a
GCI<based application that proides e))icient access to most o) the )unctions on the Funambol 1S
Serer ,see chapter 3 )or )urther details..
A)ter you change the IP address o) the serer> real<&orld synchroni2ations can begin < &ith a Microso)t
"utloo! sync ,see section 16.2.> then by con)iguring a &ireless mobile deice to connect to the
Funambol Serer> and synchroni2ing contacts and calendar items ,see section 16.$..
1%.1. Configuring the (ata S)nchroni*ation Service
5hanging your 1ata Synchroni2ation Serice IP address> as detailed belo&> &ill ma!e your Funambol
1ata Synchroni2ation Serice )ully ready )or use> including ,but not restricted to. a ?real &orld@ test
drie.
1. Start the Administration 4ool ,see section 3.1..
2. /og in to the 1ata Synchroni2ation Serice ,see section 3.2..
$. Speci)y a public IP address )or your serer> as detailed in section 6.2.
3. 4est the aailability o) your Funambol Serer )rom outside your net&or! by starting a bro&ser
and entering the sererIs public address in one o) the )ollo&ing )ormatsE
+tt':;;Fyour_&._address8:F'ort_num/er8;funam/o,;
+tt':;;Fyour_ser1er_name8:F'ort_num/er8;funam/o,;
,4he de)ault port number )or Funambol is #*#*..
9oteE again> the Funambol Serer must hae a publicly aailable IP address. Internal<use IP
addresses &ill not permit success)ul connection to> or testing and use o) the 1ata Synchroni2ation
Serice.
1%.1.1. Setting u user accounts on the Funambol (S Service
Gou do not need to manually add ne& user records> as Funambol users can auto<load their account
,including user and deice in)ormation. &hen they initially connect to the 1ata Synchroni2ation Serice
or later> i) they update their deice. For more details> see bo0 on page 27.
1%.2. S)nchroni*ing -icrosoft :utloo! 'ith the Funambol Server
4his section proides instructions )or a help)ul synchroni2ation that can be accomplished &ith either
test drie. GouIll learn ho& to install the Funambol "utloo! Sync 5lient> con)igure it )or 1ata
Synchroni2ation Serice connections> and then run a synchroni2ation.
Gou hae t&o test drie<speci)ic optionsE
1. Gou can run this synchroni2ation as the )irst component o) the ?real &orld@ test drie. It
assumes the installation and con)iguration o) a 1ata Synchroni2ation Serice &ith an
e0ternally aailable IP address ,as detailed in section 6.2..
4his component also assumes the setup o) a mobile deice )or Funambol access> as detailed
in section 16.$. Gou &ill need some synchroni2ation connection data )rom your deice to ta!e
adantage o) this test drie.
2. I) you are continuing the ?proo) o) concept@ test drie> at this point you hae success)ully
entered contact and eent data on a Funambol 1ata Synchroni2ation Serice> then
synchroni2ed data bet&een a mobile deice and the 1ata Synchroni2ation Serice. It may be
help)ul to ta!e the e0perience one step )urther> and attempt a synchroni2ation o) your
Microso)t "utloo! contacts &ith the Funambol Serer> then synchroni2e those ne& entries to
the mobile deice ,i.e. the Haa 1emo 5lient. that you hae already synchroni2ed to
Funambol.
4he basic tas!s that you need to carry out to set up Microso)t "utloo! )or Funambol synchroni2ation
are the )ollo&ingE
1. 1o&nload the "utloo! Sync 5lient )rom the Funambol &ebsiteE +tt':;;===(funam/o,(#om.
2. Install and con)igure the "utloo! Sync 5lient )ollo&ing the instructions proided in the
Funambol "utloo! Sync 5lient Cser Guide.
$. Start the synchroni2ationE
I) you are ta!ing the ?proo) o) concept@ test drie> )ollo& these stepsE
1. Ma!e the bro&ser &indo& &ith the %eb 1emo 5lient actie> and clic! >efres+.
2. /oo! at the *onta#ts List. 4he )ull collection o) Microso)t "utloo! contacts should be
listed.
$. Ma!e the Haa 1emo 5lient &indo& actie and clic! 0yn#+roni:e. A)ter a brie) pause>
your "utloo! contacts should no& be listed in this &indo&.
4his completes the synchroni2ation simulation.
I) you are ta!ing the ?real &orld@ test drie> you hae the )ollo&ing optionsE
Cse the %eb 1emo 5lient> as detailed in section 16.2.1> to eri)y the presence o)
synchroni2ed data in your database.
/og into the 1ata Synchroni2ation Serice using the Funambol Administration 4ool
and eri)y that a ne& user record e0ists )or test drie participants.
Cse your ne&ly registered mobile deice to sync &ith the 1ata Synchroni2ation
Serice> as detailed in section 16.$> at &hich time you should see your Microso)t
"utloo! contacts added to the deice.
1%.2.1. <erif)ing s)nchroni*ed data 'ith the ;eb (emo Client
In order to eri)y that data &as success)ully synchroni2ed bet&een Microso)t "utloo! and the
Funambol 1ata Synchroni2ation Serer database> )ollo& these stepsE
1. "pen the 0tart menu in Microso)t %indo&s and choose .ro$rams L Funam/o, L <e/ 9emo
*,ient(
2. %hen the %eb 1emo 5lient login page appears in a bro&ser &indo&> edit the de)ault 9ata
0yn#+roni:ation 0er1i#e U>L to replace the %,o#a,+ost:4040) te0t &ith the actual IP address or
host name> as con)igured )ollo&ing instructions in section 6.2.
For e0ample> the C+/ may be +tt's:;;,o#a,+ost:4040;=e/demo;,o$in(Ks'T replace it &ith your
Funambol Serer IP address> )or e0ampleE +tt's:;;1I2(154(0(0:4040;=e/demo;,o$in(Ks'
$. 9nter your username and pass&ord and clic! Lo$in.
%hen the %eb 1emo 5lient loads> the Address Boo! appears. Gou should see all o) the
contacts )rom your Microso)t "utloo! and Haa 1emo 5lient listed here.
3. 4o )ully eri)y your test drie results> loo! in the %eb 1emo 5lient naigation area and clic! the
5alendars lin!. 4he 5alendars /ist should display any items )rom your preious
synchroni2ations.
Gou can no& log out o) the %eb 1emo 5lient> and e0it the bro&ser.
1%.3. S)nchroni*ing a mobile device 'ith Funambol
4his section &ill ta!e you through the ?real &orld@ test drie scenario in &hich you can do &hat the
typical user &ould doE
Setup a mobile phone or &ireless deice )or Funambol connections.
9stablish the initial connection.
Synchroni2e any data stored on the 1ata Synchroni2ation Serice ,including contacts and
calendars..
In this section> &e &ill assume the typical ne&<user setup o) a basic SyncM/ phone> that requires only
net&or!8serer con)iguration )or success)ul use.
9oteE the Funambol Serer supports user sel)<proisioning> so you do not hae to manually set up
user access or enter records )or each o) the userIs mobile deices on the 1ata Synchroni2ation
Serice and each potential user can auto<load the needed records by simply connecting to the 1ata
Synchroni2ation Serice &ith a SyncM/<ready deice> using a username and pass&ord o) their
choosing. :o&eer> all users need the C+/ o) the 1ata Synchroni2ation Serice to proision their
mobile deices.
1%.3.1. Setting u a mobile device for Funambol connections
Be)ore starting the synchroni2ation test> you need to ma!e sure that the chosen deice is compatible
&ith SyncM/ serices on the Funambol &ebsiteE +tt':;;===(funam/o,(#om;so,utions;de1i#es('+'.
4he )ollo&ing is a generali2ed e0ample o) mobile deice setup instructions> and is included to gie you
some idea o) the !ind o) setup process your o&n phone or deice might require. 4he actual sequence
)or your phone may aryT )or e0act instructions> re)er to your deice user guide.
1. A)ter turning your phone on> eri)y that it has a lie Internet connection.
2. /ocate and open the 0yn# options. ,5hec! your phoneIs user guide )or details..
$. 5reate a ne& ,untitled. sync pro)ile.
3. %hen the )ollo&ing )ields ,or their counterparts. appear> ma!e the needed pro)ile entriesE
Name: the pre)erred name ,)or e0ample> ?Funambol@.
U>LE the C+/ o) the 1ata Synchroni2ation Serice. It should appro0imately match this
e0ampleE +tt's:;;Fyour7ser1er8:Fyour7'ort8;funam/o,;ds
User NameE your username
.ass=ordE your pass&ord
@rans'ort .roto#o,E i) this option is present> enter ?:44P@
6. I) a 9ata .at+ or 9ata/ase option is aailable> select it.
7. %hen the )ollo&ing 9ata .at+ or 9ata/ase )ields8settings appear> eri)y the )ollo&ingE
*onta#tsE should display the notation ?card@
*a,endarE should display the notation ?cal@
@as2sE should display the notation ?tas!@
NotesE should display the notation ?note@
9oteE these entries are case<sensitie.
7. Sae these ne& entries.
#. Sae this ne& sync pro)ile.
Gour phone is no& ready )or synchroni2ation.
1%.3.2. Starting the s)nchroni*ation
;o& you can synchroni2e the contact and calendar data on your deice &ith the Funambol 1ata
Synchroni2ation Serice database. 4o do so> )ollo& these stepsE
1. From your phoneFs menu> choose 0ettin$s L *onne#tion L 0yn#( 4he menu sequence may ary
per phoneT please re)er to your phoneFs user guide.
2. Select Funam/o,. A sync8connection status screen appears.
$. %hen the synchroni2ation process completes> a con)irmation message appears.
I) )or some reason the data synchroni2ation )ails or the connection is bro!en> a noti)ication &ill
be displayed.
3. I) your synchroni2ation attempt is success)ul> you should see your Microso)t "utloo! contacts
listed in your phoneFs address boo!. I) so> congratulations[
16. Funambol reference guide
16.1. Bo' to install a ne' module
In order to install a ne& module ,such as a connector. into the Funambol Serer> copy the sGK )ile into
the directory $FUNAMBOL_OM!;ds7ser1er;modu,es ,)or e0ample> a#me#onne#tor71(0(sGK6 and
)ollo& these stepsE
1. Ma!e sure Funambol is up and running
2. Csing a te0t editor> open the $FUNAMBOL_OM!;ds7ser1er;insta,,('ro'erties )ile.
$. Find the line that begins &ith ?modu,es7to7insta,,O@ in the Module de)initions section. 4his line
speci)ies> in a comma<separated list> the modules to install during installation.
3. Add the connector to the comma<separated list> omitting the (sGK )ilename e0tension ,)or
e0ample> a#me#onne#tor71(0..
6. Sae and close the insta,,('ro'erties )ile.
7. "pen a command &indo& and run the serer installation script by typing the )ollo&ingE
on %indo&sE
c6 %FUNAMBOL_)OME56-1-e+3e+
bin=in-tall10o6$le-
on Cni08/inu0E
c6 %FUNAMBOL_)OME56-1-e+3e+
bin5in-tall10o6$le-
7. Ans&er all questions about re<creating the modules 1B schema &hen promptedT type FyF &hen
as!ed to install the database )or the ne& module and FnF )or all others.
>ec.o? F$na0bol Hata SDnc.+oniAation Se+3e+ 9ill be in-talle6 on t.e To0cat I.I.x
application -e+3e+
>ec.o? Un6eploDing /$na0bol...
>ec.o? *+e in-tallation /o+ 0o6$le- /o$n6ation1#.;.&Eac0econnecto+1&.;
>ec.o? /o$n6ation1#.;.& p+e1in-tallation...
>ec.o? /o$n6ation1#.;.& p+e1in-tallation -$cce--/$llD co0plete6
>ec.o? ac0econnecto+1&.; p+e1in-tallation...
>ec.o? ac0econnecto+1&.; p+e1in-tallation -$cce--/$llD co0plete6
>ec.o? CopDing con/ig$+ation /ile-
>ec.o? *o-t in-tallation /o+ 0o6$le- /o$n6ation1#.;.&Eac0econnecto+1&.;
>ec.o? .a-.in-tall< t+$e
>ec.o? Sta+ting c$-to0 in-tallation...
>ec.o? Fo$n6ation In-tallation
>ec.o? Fo$n6ation in-tallation -$cce--/$llD co0plete6
>ec.o? /o$n6ation1#.;.& in-tallation...
>ec.o? Hataba-e in-tallation /o+ 0o6$le /o$n6ation1#.;.& on .Dpe+-onic
(5opt5F$na0bol56-1-e+3e+)
>ite+ate? T.e F$na0bol Hata SDnc.+oniAation Se+3e+ in-tallation p+og+a0 can no9 c+eate
>ite+ate? t.e 6ataba-e +eJ$i+e6 bD t.e 0o6$le /o$n6ation1#.;.& (i/ anD i- nee6e6).
>ite+ate? Ko$ can -Lip t.i- -tep i/ Do$ .a3e al+ea6D a 3ali6 6ataba-e c+eate6
>ite+ate? o+ t.e 0o6$le 6oe- not +eJ$i+e a 6ataba-e.
>ite+ate? I/ Do$ c.oo-e "D" Do$+ exi-ting 6ata 9ill be 6elete6.
>ite+ate? Ho Do$ 9ant to +ec+eate t.e 6ataba-eM
>ite+ate? (DEn)
n
and
>ec.o? /o$n6ation1#.;.& in-tallation -$cce--/$llD co0plete6
>ec.o? .a-.in-tall< t+$e
>ec.o? Sta+ting c$-to0 in-tallation...
>ec.o? ac0econnecto+ in-tallation
>ec.o? ac0econnecto+ in-tallation -$cce--/$llD co0plete6
>ec.o? ac0econnecto+1&.; in-tallation...
>ec.o? Hataba-e in-tallation /o+ 0o6$le ac0econnecto+1&.; on .Dpe+-onic
(5opt5F$na0bol56-1-e+3e+)
>ite+ate? T.e F$na0bol Hata SDnc.+oniAation Se+3e+ in-tallation p+og+a0 can no9 c+eate
>ite+ate? t.e 6ataba-e +eJ$i+e6 bD t.e 0o6$le ac0econnecto+1&.; (i/ anD i- nee6e6).
>ite+ate? Ko$ can -Lip t.i- -tep i/ Do$ .a3e al+ea6D a 3ali6 6ataba-e c+eate6
>ite+ate? o+ t.e 0o6$le 6oe- not +eJ$i+e a 6ataba-e.
>ite+ate? I/ Do$ c.oo-e "D" Do$+ exi-ting 6ata 9ill be 6elete6.
>ite+ate? Ho Do$ 9ant to +ec+eate t.e 6ataba-eM
>ite+ate? (DEn)
D
>ec.o? ac0econnecto+1&.; in-tallation -$cce--/$llD co0plete6
>9a+? (a+ning< -electe6 9a+ /ile- incl$6e a (EB1INF59eb.x0l 9.ic. 9ill be igno+e6
(plea-e $-e 9ebx0l att+ib$te to 9a+ ta-L)
>ec.o? Re0o3e o$tp$t 6i+
BUILH SUCCESSFUL
Total ti0e< &N -econ6-
#. +estart the 1ata Synchroni2ation Serice.
4he ne& module is no& installed.
9oteE installed modules are isible in the Funambol Administration 4ool> in the Modu,es section.
16.2. (efault S)ncSource roerties
4he Funambol 1ata Synchroni2ation Serice proides the )ollo&ing de)ault databases to &hich you
can synchroni2e user data. ;ote that all noted C+I entries are case<sensitie.
16.2.1. Contacts
CsageE synchroni2ing contact data.
(-L ./.)-type &ient
card te0t80<card
te0t8card
All Funambol clients and most o) the common and !no&n clients that
are already built into a mobile deice.
16.2.2. Calendar
CsageE synchroni2ing calendar data> including eents and tas!s.
(-L ./.)-type &ient
cal te0t80<calendar
te0t8calendar
Some Funambol clients and most o) the common and !no&n clients
that are already built into a mobile deice. 4his database manages
both eents and tas!s.
eent te0t80<calendar
te0t8calendar
eents only.
tas! te0t80<calendar
te0t8calendar
tas!s only.
16.2.3. 9otes
CsageE synchroni2ing te0t<based notes.
(-L ./.)-type &ient
note te0t8plain Most o) the common and !no&n clients that are already built into a
mobile deice.
snote te0t80<s3U<si)n All Funambol clients
16.2.#. Eriefcase
CsageE synchroni2ing brie)case data.
(-L ./.)-type &ient
brie)case Application8\ All Funambol clients
16.3. The install.roerties configuration file
4he $FUNAMBOL_OM!;insta,,('ro'erties )ile is the central repository o) con)iguration in)ormation
that is used by the installation procedure to set up the Funambol 1ata Synchroni2ation Serice. A
standard Haa properties )ile> it contains the )ollo&ing parametersE
Para#eter $escription
conte0t<path 4he conte0t path to be used to con)igure the &eb container )or the Funambol 1ata.
Synchroni2ation Serice module. 4he 1ata Synchroni2ation Serice &ill respond to C+/s
starting &ith this conte0t path.
dbms ;ame o) the database &here Funambol 1ata Synchroni2ation Serice tables are created.
Udbc.classpath 5lasspath including the H1B5 drier )or the database> i) not included in the system classpath.
Udbc.drier H1B5 drier class.
Udbc.pass&ord 1atabase user pass&ord.
Udbc.url H1B5 connection C+/.
modules<to<install 5omma<separated list o) Funambol 1ata Synchroni2ation Serice modules to install. I) a
module has already been installed> the installation procedure reinstalls it again.
serer<name 4he serer C+I that &ill be speci)ied in SyncM/ messages. 4he serer &ill only respond to
messages addressed to this C+I.
16.#. /sing Funambol 'ith -)SF2
I) you &ish to use Funambol &ith a MySD/ database ,instead o) :ypersonic> &hich is proided by
de)ault &hen installing Funambol. )ollo& these stepsE
1. 5reate the user funam/o,.
2. 5reate the database funam/o, and grant the user funam/o, all priileges on the database
funam/o,E
0D-Jl4 c+eate 6ataba-e /$na0bol'
0D-Jl4 RANT ALL *RIOILEES ON /$na0bol.@ TO "/$na0bol"P"local.o-t" IHENTIFIEH BK
"/$na0bol"'
$. 5opy mysP,7#onne#tor7Ka1a75(0(G7/in(Kar to the directoryE
$FUNAMBOL_OM!;funam/o,;too,s;Kre71(5(0;Kre;,i/;e"t
3. Modi)y the )ileE
$FUNAMBOL_OM!;funam/o,;ds7ser1er;insta,,('ro'erties
changing the alue o) the d/ms parameter toE
6b0-70D-Jl
6. 5omment the hypersonic con)iguration sectionE
QR6bc.cla--pat.7..5tool-5.Dpe+-onic5lib5.-Jl6b.Ra+
QR6bc.6+i3e+7o+g..-Jl6b.R6bcH+i3e+
QR6bc.$+l7R6bc<.-Jl6b<.-Jl<55local.o-t5/$na0bol
QR6bc.$-e+7-a
QR6bc.pa--9o+67
7. Insert the MySD/ con)igurationT )or e0ampleE
R6bc.cla--pat.75opt5F$na0bol5tool-5R+e1&.S.;5lib5ext50D-Jl1connecto+1Ra3a1I.&.T1
bin.Ra+
R6bc.6+i3e+7co0.0D-Jl.R6bc.H+i3e+
R6bc.$+l7R6bc<0D-Jl<55local.o-t5/$na0bolMc.a+acte+Enco6ing7UTF1#
R6bc.$-e+7/$na0bol
R6bc.pa--9o+67/$na0bol
7. +un the commandE
$FUNAMBOL_OM!;funam/o,;/in;insta,,(#md
ans&ering ]yI to all questions.

Funambol Installation and Administration Guide v9.0 PDF

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Funambol Installation and Administration Guide v9.0 PDF

Uploaded by

Copyright:

Available Formats

Funambol

Installation and Administration Guide

You might also like