Changeset 2555

Show
Ignore:
Timestamp:
10/11/07 23:10:09 (1 year ago)
Author:
miciu
Message:

Updated installation instructions

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • plugins/sync4j/plugin/trunk

    • Property svn:ignore changed from
      autom4te.cache
      config.log
      config.status
      stamp-h1
      config.h
      *.tar.gz
      libtool
      Makefile
      Makefile.in
      aclocal.m4
      configure
      config.h.in
      syncml-client-plugin.spec
      config.guess
      config,sub
      depcomp
      install-sh
      ltmain.sh
      missing



       to
      autom4te.cache
      config.log
      config.status
      stamp-h1
      config.h
      *.tar.gz
      libtool
      Makefile
      Makefile.in
      aclocal.m4
      configure
      config.h.in
      syncml-client-plugin.spec
      config.guess
      config,sub
      depcomp
      install-sh
      ltmain.sh
      missing
      templates
      config.guess
      config.sub
      depcomp
      install-sh
      ltmain.sh
      sync4jplugin.kdevelop
      Doxyfile

  • plugins/sync4j/plugin/trunk/ChangeLog

    r2554 r2555  
    1 release 
    2  
    3 1.0     Initial release. I have tested vcard syncing, both ways,  
    4         "seem to work" 
     11.0     Initial release. 
     2Synchronization works with contacts, calendars, notes and todos. Tested with 
     3Funambol servers (www.scheduleworld.com). 
     4Sending changes to www.mobical.net (syncml back-end is unkown) works, retrieving 
     5changes doesn't. 
    56 
    67 
    7 1.1     added some docs and testing on calendar data. Calendar 
    8         works "a little", new events are created on the server as 
    9         required. Delete does not work. Modifications creates a new 
    10         item, the old is till thre. 
    118 

  • plugins/sync4j/plugin/trunk/INSTALL

    r2554 r2555  
    1 The usual stuff 
    2 ================ 
     1#### Requirements #### 
    32 
    4 This plugin depends on the syncml-client package I have derived from 
    5 the sources from http://www.funambol.org. At the time of writing, you 
    6 should find it on the same place you found this. Download, build and 
    7 install that package before you try this one. 
    8   
    9 Once syncml-client is in place the installation of this plugin is  
    10 (should be?) straightforward.  
    11  
    12 - autoreconf -sfi 
    13 - configure 
    14 - make  
    15 - make install 
    16  
    17 Configure SyncML server 
    18 ======================= 
    19 Gconf handles the this. You must at least set the server URI, user and 
    20 password. This is done through the gconf GUI, find the items under: 
    21  
    22 /apps/syncml-client/spds/syncml: server name, server URL, username, password. 
    23  
    24 /apps/syncml-client/spds/sources/{the source you configure to opensync}: 
    25      Check the "dir" parameter (should exist) and the uri pararm - it should 
    26      conform to the server documentation. The installed uri is OK against 
    27      scheduleworld.com. 
    28      
    29 Configure sync group 
    30 ===================== 
    31  
    32 This is handled by the normal msynctool procedures, something like this: 
    33  
    34 $msynctool --listplugins 
    35   <check for syncml-client-plugin> 
    36 $msynctool --listobjects 
    37   <check for an object you want to sync i. e., "contact"> 
    38  
    39 $msynctool --addgroup syncml-file 
    40   <a simple test case, sync the server to a directory> 
    41 $msynctool --addmember syncml-file syncml-client-plugin 
    42 $msynctool --addmember syncml-file  file-sync 
    43 $msynctool --configure syncml-file 2  
    44    < set the directory to sync with > 
    45 $msynctool --configure syncml-file 1  
    46    < set the three strings, see below> 
    47  
    48 Syncml client configuration 
    49 =========================== 
    50  
    51 The plugin  handles three configuration strings: 
    52  
    53 gconf-uri:   The base for Gconf config. Leave this as the default  
    54              /apps/syncml-client. 
    55  
    56 object-type: Set to either "contact", "event", "todo" or "note" to sync the 
    57              corresponding items. 
    58  
    59 sync-source-name: 
    60              Name of the database definition in SyncML API. Found in 
    61              gconf as one of the children of /apps/syncml-client/spds/sources. 
    62              The preconfigured ones are "card", "cal", "note" and "task", 
    63              choose one of them (or add your own). 
    64  
    65 Running 
    66 ======== 
    67  
    68 See README 
     3- opensync >= 0.32 
     4- glib-2.0 
     5- libxml-2.0 
     6- libxslt 
     7- sync4j SDK 6.0.8 
    698 
    709 
     10#### Installation #### 
     11 
     12The sync4j SDK can be found in the sync4j-SDK folder. 
     131) Extract the archive and apply the patch: 
     14$ unzip funambol-cpp-api-6.0.8.zip 
     15$ cd Funambol/ 
     16$ patch -p0 < ../sync4j-6.0.8.patch 
     17 
     182) Configure, build and install 
     19$ cd sdk/c++/build/autotools/ 
     20$ chmod u+x autogen.sh 
     21$ ./autogen.sh 
     22$ ./configure --enable-xmlconfig=yes 
     23$ make 
     24$ make install 
     25 
     26Then configure, build and install the plugin 
     27$ ./autogen.sh 
     28$ ./configure  
     29$ make 
     30$ make install 
    7131 
    7232 
     33#### Configuration #### 
     34 
     35see README 

  • plugins/sync4j/plugin/trunk/README

    r2554 r2555  
    33 
    44This is a SyncML client plugin based on the SyncML C++ API from  
    5 http://www.funambol.org. The plugin can synchronize contacts (vcards) 
    6 and calendar (ical) data.   
     5http://www.funambol.org. The plugin can synchronize contacts, calendars, 
     6notes and todos. 
    77 
    8 The configuration is kept in two places. The SyncML stuff is housed in gconf. 
    9 This is documented in the Funambol docs. At least the server URL, 
    10 name and password must be set. 
    11  
    12 The rest is kept in the syncML xml configuration file: 
    13  
    14 Key              Default                Notes 
    15 gconf-uri        /syncml-client         The base URI for gconf config. 
    16 sync-source-name card                   A subtree under spds in gconf to 
    17                                         configure the database 
    18 object-type      contact                For syncing vcards 
    19  
    20 The plugin can't sync both contacts and calendar in the same sync - they 
    21 require quite different configurations. It could configured for any of those, 
    22 though. While syncing one type of object,  other types should be filtered, 
    23 someting like: 
    24  
    25 $msynctool  --sync syncml-file --filter-objtype event --filter-objtype todo 
    26  
    27  
    28 Syncing contacts 
    29 ================ 
    30  - Create a syncgroup just to handle contacts. 
    31  - Configure the syncml-client: object-type should be 'contact', and  
    32    sync-source-name should point the proper entry under spds/sources 
    33    in the gconf tree. Using the default sources it is 'card'. 
    34  - Configure the other side of the syncgroup. 
    35  - Check that server URL, name and password is configured in gconf, 
    36    under apps/syncml-client/spds/syncml 
    37  - Check that the source (default 'card') used is properly configured.  
    38    Specifically, the uri attribute should be checked against server  
    39    documentation. 
    40  - Run it with something like 
    41    $msynctool  --sync evo2-syncml-sw \ 
    42      --filter-objtype event --filter-objtype todo 
    43  
    44 Syncing calendars 
    45 ================ 
    46  - Create a syncgroup just to handle the calendars. 
    47  - Configure the syncml-client: object-type should be 'event', and 
    48    sync-source-name should point the proper entry under spds/sources 
    49    in the gconf tree. Using the default sources it is 'cal'. 
    50  - Configure the other side of the syncgroup. 
    51  - Check that server URL, name and password is configured in gconf, 
    52    under apps/syncml-client/spds/syncml 
    53  - Check that the source (default 'cal') used is properly configured.  
    54    Specifically, the uri attribute should be checked against server  
    55    documentation. 
    56  - Run it with something like 
    57    $msynctool  --sync evo2-syncml-sw \       
    58         --filter-objtype contact --filter-objtype todo 
    59  
    60  
    61  
    62 Syncing other things 
    63 ==================== 
    64  
    65 Not tested, but might work - the code is there for notes and tasks. 

  • plugins/sync4j/plugin/trunk/src

    • Property svn:ignore set to
      .deps
      .libs
      Makefile
      Makefile.in

  • plugins/sync4j/plugin/trunk/tests

    • Property svn:ignore set to
      .deps
      Makefile
      Makefile.in