Installation Manual for Synthesis Sync Client 3.0
Contents
1. SYNTHESIS SYNC CLIENT doc s pd documentation in Adobe PDF format we syncclient_odbc exe PRO version syncclient_odbc_std exe STD version sample_config interbase firebird interbase sql interbase upgrade 2 1 to 3 0 sql syncclient_odbc xml for PRO version syncclient_odbc_std xml for STD version mssql mssql sql mssql upgrade 2 1 to 3 0 sql syncclient_odbc xml for PRO version syncclient_odbc_std xml for STD version fT mysql mysgql sql mysql upgrade 2 1 to 3 0 sql syncclient_odbc xml for PRO version syncclient_odbc_std xml for STD version a unsupported admin php config php index php read m e txt logo jpg docs Directory e SySync_Client_manual pdf This file e SySync_config_reference pdf Detailed description of XML configuration options 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 12 Eventually some extra materials such as Synthesis SyncML product overviews etc bin_win32 Directory syncclient_odbcXXX exe where XXX is _std for STD This is the console based standa lone version of the client sample_config Directory interbase_firebird This directory contains a SQL set up script for Interbase 6 or Firebird 1 SQL servers and sample config files for the Synthesis Sync Client Note that you need to use the config files ending with _std when you are using the STANDARD version mysql This directory conta2. Linux Unix Installing ODBC Unlike Windows under Linux and other UNIX flavors ODBC is not a standard component of the operating system There are two well known implementations of ODBC under non Windows platforms one is called iODBC and the other is called UnixODBC In order for ODBC to work one of them must be installed Most Linux distributions contain one of them as ready to install packages Setting up the ODBC Datasource Under Linux there might be no graphical interface to the ODBC configuration in all cases but iODBC features a graphical ODBC Administrator In this case you need to edit the odbc ini file with a text editor This file is usually located at usr local etc To add a ODBC datasource for MySQL you need to add something like the following mysql sync_dsn Driver usr local lib libmyodbc3 so Description MySQL ODBC 3 51 Driver DSN SERVER localhost PORT 3306 USER syncml 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 20 Password syneml Database syncdb OPTION 3 SOCKET tmp mysql sock Note that SOCKET is important only if SERVER is localhost as in this case clients connect directly to the mysql sock If server is an IP address name TCP IP is used on the PORT speci fied Important It seems that there is a problem in MyODBC 3 51 which causes that neit her database nor Socket nor Server settings are properly read from odbc ini This is why
3. Sustainable _ Software Concepts SYNTHESIS AG www synthesis ch Installation Manual for Synthesis Sync Client 3 0 SyncML 2002 2006 by Synthesis AG Page 2 This manual was written for Synthesis Sync Client Version 3 0 0 2 This manual and the Synthesis Syne Client software described in it are copyrighted with all rights reserved This manual and the Synthesis Sync Client software may not be copied except as o therwise provided in your software license or as expressly permitted in writing by Synthesis AG http www synthesis ch Synthesis Sync Client uses parts of the following software expat XML parser see http expat sourceforge net Copyright c 1998 1999 2000 Thai Open Source Software Center Ltd SyncML toolkit see http www syncmLorg and http sourceforge net projects syneml ctoolkit This product includes software developed by The SyncML Initiative Copyright c 2000 Ericsson IBM Lotus Matsushita Communications Industrial Co LTD Moto rola Nokia Palm Inc Psion Starfish Software All rights reserved Disclaimer Use of the Synthesis Sync Client software and other software accompanying your license the Software and its documentation is at your sole tisk The Software and its documentation inc luding this manual and software maintainance by Synthesis AG if applicable are provided AS IS and without warranty of any kind and Synthesis AG EXPRES
4. www synthesis ch Page 17 fails before any synchronisation is initialized for example when a device tries to connect with invalid credentials e Data storage tables These tables are named SYNC_CONTACTS for contact information and SYNC_EVENTS for events SYNC_TASKS for todo list items and SYNC_NOTES for memos While the layout of all the other tables will not need changes in most applications the data tables can be totally different from this sample layout A common customization will probably use all the other tables from the sample but include customer specific tables from an existing application for the data storage tables 4 1 1 2 Database preparation for MS SQL Server Note This description is indended for using the Synthesis SyncML Client on the Windows platform Using ap propriate third party drivers such as those from www openlinksw com MS SOL can also be accessed via ODBC from a Linux or MacOS X hosted SyncML Client We assume that you are familiar with using MS SQL Server The following step by step descrip tion is written just as an orientation and not as an introduction to SQL Server The steps are described for SQL Server 7 but are similar in SQL Server 2000 You can install the sync tables into an existing database or create a new one Skip the following paragraph if you want to install into an existing database Creating a new Database Open SQL Server Enterprise Manager Select the server you wan
5. button to see if the datasource is defined ok e Ifthe test is ok click the OK button to confirm the new datasource e Close the ODBC control panel 4 1 1 4 Database preparation for InterbaselFirebird SQL Server Note This description is indended for using the Synthesis SyncML Client on the Windows platform Firebird itself is also available on Linux so with appropriate third party drivers see www ibdatabase com or ofbodbe sourceforge net a SyncML client using Firebird can also run on Linux Some information about Interbase Firebird Originally developed by Borland Interbase 6 was made Open Source mid 2000 available in under www borland com devsupport interbase opensource Further development of the open source version ate now named Firebird Firebird is available for download under firebird sourceforge net Note that the GUI Tool IBConsole used in the following description is 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 21 not included in the Firebird distribution so you need to download it separately from www borland com devsupport interbase opensoutce Note that in order to use Interbase Firebird you need to have an ODBC driver for this server before you can use it with Synthesis Sync Client There are various ODBC drivers available for Interbase but not all of the same quality We have tested Synthesis Sync Client successfully with Gemini InterBase ODBC Driver which is a commercial
6. 20026 20027 20028 20500 20998 20999 20599 No error These have the same meaning as the SyncML Status Codes see 6 1 but they are offset by 10000 to make clear that they were generated internally and not sent or received via SyncML Bad or unknown transport protocol Fatal problem with SyncML encoder decoder Cannot open communication Cannot send data Cannot receive data Bad content type message received with an unknown MIME type Error processing incoming SyncML message for example invalid XML or WBXML formatting Cannot close communication Transport layer authorisation e g HTTP auth failed Error parsing XML config file Error reading config file No configuration found at all or not enough for requested op client session start Config file could not be found License expired or no license found Internal fatal error Bad handle Session aborted by user Invalid license Limited trial version Connection timeout Connection SSL certificate expired Connection SSL certificate invalid incomplete sync session some datastores failed some completed Out of memory Connection impossible e g no network available Establishing connection failed e g network layer login failure element is already installed These represent SIG_xxx codes in Linux versions of the server Unexpected SIG_xxx will generate a error code of 20500 signal_code Internal unkown exception Unknown error 21000 21999 Data
7. 4 2 for how to install this version quickly 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 4 Contents 1 Introduction ccceceeeeee sees ee ee seen eee eee eee 3 CORTON ian ceicnnicnneenceneicenssnevenseceevensdnessensnenitendsensvnesenesienwenedwenseeniiewaneninne 4 2 Changes Since Version 2 1 s ssss122222 5 2 1 Feature Matrix 2 1 vs 3 0 and STD VS PRO 0 ccccccceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee 5 2 2 Changes for end users clients of the SyncML client ceeeeeeeeeeeeeees 6 2 3 Changes in the new 3 0 sample layout ODBC version ceeeeeeeeeeeeeees 7 2 4 Migration Guide How to upgrade existing 2 1 x installations to 3 0 7 VIC Wy is tas cen vesccesencacevenvongasescincsciuceeneutersag coeevenanegrtee eeu E E 7 2 4 2 Updating a 2 1 installation for 3 0 with full Suspend amp Resume support 8 3 Distribution FileS ccscsceeeseeeeeeeeeeeeeeneeeeeeeeeeeeeeeeeeeee eee eee 11 3 1 ODBC Version WiINdOWS cccccseeeeeeeeeeeeeeeceeeesseeeeeeeseeeeeeeeseeeeeseseeaaeneess 11 3 2 ODBC Version LINUX cciccrexcrescatetuaccaretnasssesdoacshtonesd cnvsdeahiuatnmiisecivicenectecctwmeta ans 13 3 3 Demo text file based Version 0 060 00000 ene eee 15 4 Setup Cl nnmnnn 16 4 1 ODBC Version with standard layouts seeeeeseeseesesssseeesesessreeseerrreersrreeene 16 4 1 1 Databa
8. items Instead of aborting sync when a client returns an error for a Add Replace or Delete operation the item can now be marked for resend in the next session This helps a lot to overcome temporary problems in client data bases without interrupting sync Page 6 Hierachically structured HTML logs Much easier to read debug logs as nicely colored e g error conditions in bright red to immediately catch the eye and dynamically folding HTML as XML ot structured plain text Much faster log writing better detail control Support for BLOB data PHOTO email attachments Sto re BLOB binary large object data in the database and map it to base 64 encoded binary properties like PHOTO in vCard or email attachments On request delayed BLOB reading for high efficiency To optimize efficiency large BLOB fields can be fetched from the database separately at the time they are required for transferring to a remote party This allows efficient handling of large BLOBs such as email attachments Scripting Gain much more flexibility in adapting SyncML to your existing database create fully custom value conversi ons and much mote using the new built in highly efficient C JavaScript Style scripting language Macros in Scripts Wrap script parts into a macro and use it in multiple scripts across the configuration Email with Attachments Use the built in support for RFC822 2822 MIME email encoding and decoding inclu ding
9. lt slowsync gt false lt slowsync gt lt syncrequest gt 2 Modify the highlighted settings e lt localdbuser gt lt localdbpassword gt Enter the user name and password for the local database This allows for having multiple user s data in the same database but in case you only have a single user s data in the database you can just use the predefined u ser passwotd test test e lt syncmlencoding gt You can specify here what format the client uses to communicate with the server Usually this is the more efficient wbxml but for debugging purposes you might want to set it to the more readable plain xml format e lt serverurl gt Enter the full URL of the SyncML server you want to syne with here e lt serveruser gt lt serverpassword gt Enter the username and password required to log into the SyncML server you have specified with lt serverurl gt 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 25 e lt syncrequest gt The sample config contains 4 lt syncrequest gt s but all of them are initially commented out First remove the comment bracket lt gt from the sync request for the data you want to sync with contacts events tasks notes Then edit the lt dbpath gt to match the server s name for that data type The default value contained in the sample is compatible with Synthesis SyncML server defaults so if you are syncing with a Synthesis SyncML based server you no
10. multipart bodies and attachments Support for vVBookmark The new sample config contains sup port for vBookmark which is supported by some newer cli ent devices Array Fields For repeating items such as storing an unlimited number of telephone numbers per contact the server now supports dynamic array fields that can hold as many values as required Master Detail database Table support For storing array con tents or other data not in the main master record but in a related detail table the server provides powerful mapping options More than 30 new configuration tags Many detail enhance ments and extended configuration options More than 10 new script functions Several new built in func tions for more scripting capabilities 2 2 Changes for end users clients of the SyncML client e Errors storing or modifying items in the client will no longer abort the sync Instead the sa me item will be retried in the next session This enhances overall experience also with older pre SyncML 1 2 servers as a single problematic item in a sync will no longer make the entire sync fail 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 7 When using the new 3 0 sample layout config the client now supports email sync and vBookmark sync with devices that support these data types 2 3 Changes in the new 3 0 sample layout ODBC version SYNC_TARGETS and SYNC_MAPS h
11. new datasource depends on the server used as well as on the ODBC driver used So the following procedure applies to SQL Server only altough other drivers might behave similar So installing the ODBC datasource for SQL Server consists of the following steps 1 Open the ODBC Datasources control panel Select the User DSN or System DSN tab depending on wether you want to make the datasoure available to the currently logged in user only or all users and system processes on the machine 3 Click the Add button 4 From the list of available drivers select SQL Server for MS SQL as if MS SQL was the only SQL server in the world 5 Click Finish 6 Now the driver specific installation dialogs appear 7 Enter a name for the datasource This name will be used to identify the datasource in the Synthesis Sync Client config so remember the name you use here 8 Optionally enter a descriptive text for the datasoutce 9 Enter or select if you have used it before the server name 10 Click Next 11 Select the appropriate authentification method If you are not sure use the second option and enter the database username and password in the text fields at the bottom of the dialog 12 Make sure the connect to SQL server check box is checked 13 Click Client Configuration and enter server parameters normally just select TCP IP and set the computer name 14 Click Next 15 Check Change standard database ch
12. sql provided in the Synthesis Syne Client distribution in the interbase_firebird directory in the sample_config directory 7 Execute the script Press Ctrl E or click the yellow lightning icon DOr Ds Now you have the standard database tables for Synthesis Sync Client installed in Interbase 6 or Firebird 1 Server Setting up the ODBC Datasource ODBC Datasoutces are configured using the ODBC Datasources or similar control panel It is hidden at different places on different versions of Windows In older versions it can be found among the other Control Panels Start gt Settings gt Control Panel in Windows 2000 and newer it is under Start gt Applications gt Administration 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 22 The installation of a new datasource depends on ODBC driver used so we cannot provide details here Installing the ODBC datasource consists roughly of the following steps e Install the Interbase Firebird ODBC driver of your choice e Open the ODBC Datasources control panel e Select the User DSN or System DSN tab depending on wether you want to make the datasoure available to the currently logged in user only or all users and system processes on the machine Click the Add button e From the list of available drivers select an ODBC driver for Interbase Firebird e Click Finish e Now the driver specific installation dialogs appear Usually the only d
13. sync session is interrupted intentionally or due to external conditions like network coverage loss etc the sync will just continue at the point it was interrupted and not restarted from beginning Even if syne stops while transferring a large item the part of the item that was already sucessfully transmitted will not be sent again This greatly enhances end user experience and reduces data volume especially for large syncs and instable mobile data connections Note that Suspend amp Resume support needs some a daptations in the database layout and the config file for existing 2 1 x client See Migration Guide in 2 4 SyncML DS 1 2 filtering Support for sending lt filter gt expres sions to servers that support it ODBC Datastores Make data from SQL ODBC databases available for SyncML Plugin Datastores Develop custom database adapters with our a Plugin SDK in C C or Java to communicate with any custom application layer Can be mixed in the same server with ODBC based datastores Administrative data can be managed in ODBC SQL or plugins independently from how the user data is handled All combinations possible Built in Textfile based plugin A plugin for textfile based sto rage of administrative data and or user data is built in and can be used in any mix with ODBC and custom plugins 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Resend failed
14. 5 4 SyncML client command line options The SyncML client when started from a command line has several command line options n do not wait for keypress before exit Linux MacOS X default w wait for keypress before exit Windows default v just show version info t only test syntax of configuration file but do not perform a sync session S singlestep messages for debug If specified the client will prompt for continu ation or abort after every SyncML message f interactively ask for message retry for debug This can be used to force a client to re send the previous message to test a server s handling for re sent messages f lt configpath gt specify config file path and name By default the config file is read from the current directory and is named as described in this manual see above for details h show a short help text for the command line options 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 28 6 Error codes This section lists the error codes that can occur normally visible in the logs or on the console 6 1 SyncML Status Codes These codes are defined by the SyncML standard For details see www openmobilealliance org release_ptrogram ds v12 html Note that this list is not complete but only contains the codes that are important for the SyncML engine 101 200 201 207 208 209 210 211 212 213 400 401 403 404 405 406 407 408 409 410 412 415 418 41
15. 9 420 500 501 503 505 508 509 510 511 512 513 Server is busy licensed number of connection limit reached OK successful operation Item added Conflict resolved with merge Conflict resolved client wins Conflict resolved by duplicating item Deleted without archive Item not deleted Authentication accepted for entire session Chunked item accepted and buffered this status is sent for each non final part of a data item that has been split across multiple SyncML messages Bad request Unauthorized bad credentials Forbidden e g attempt to write to a read only database Object not found Command not allowed Optional feature not supported Authentication required no credentials found Timeout Conflict operation failed Gone requested object not here any more Incomplete command Unsupported media type or format Object already exists Conflict resolved with server data Device full Command failed Command not implemented Service unavailable DTD version not supported Slow sync required Authentication required Database error Server error Synchronisation failed SyncML Version not supported 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch 514 Page 29 Cancelled 6 2 Internal Error Codes 0 10000 10999 20001 20002 20003 20004 20005 20006 20007 20008 20009 20010 20011 20012 20013 20014 20015 20016 20017 20018 20019 20020 20021 20022 20023 20025
16. MS SQL MySQL or Interbase Firebird 4 1 ODBC Version with standard layouts 4 1 1 Database preparation 4 1 1 1 Standard Layout overview You can skip reading this paragraph if you just want to install the standard layouts as quickly as possible Note The Standard Layout is identical for both Synthesis SyncML Client and Server It is therefore possible to connect a SyncML server to a database to make its data available for sync to remote devices and in parallel use the Synthesis SyncML Client to keep the same database in sync with another SyncML server This implies that the standard database layout contains all features such as multi user multi folder needed for a SyncML server even if these are not needed for a client in all cases Synthesis Sync client and server needs a database to read and write the synced objects contact and calendar data in the standard layout The standard layouts provided as samples include the following features e Sync user authentication A table named SYNC_USERS contains usernames and passwords for all users that are allowed to synchronize data in the database with a remote SyncML ser ver see lt localdbuser gt and lt localdbpassword gt configuration tags Note that this has nothing to do with the user password required to login into a remote SyncML server e Sync folder management The standard layout provides multiple folders separate datasto res This allows different users to have differe
17. SIS AG DOES NOT PROVIDE ANY SUPPORT FOR THESE FILES e read me txt Short explanation how to use the PHP files 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 15 3 3 Demo text file based Version The distribution media normally a ZIP archive contains the following files e SySync_Client_manual pdf This file e SySync_config_reference pdf This extra manual contains detailed information for writing config files e syneclient_demo exe This is the demo sync client It is a console based standalone version of the client using text files for storing data e syneclient_demo For MacOSX and Linux the executable file has no extension e syncclient_demo_gec33 For Linux this binary is able to run under current distributions like Debian 3 1 Sarge SuSE 9 3 and Fedora Core 3 e syncclient_demo xml Sample config file This file contains everything you need to start up the client e Eventually some extra materials such as Synthesis SyncML product overviews etc 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 16 4 Setup Guide This setup guide consists of two main sections e Section 4 2 describes how to install the free textfile based demo version e Section 4 1 describes the more complex set up for the ODBC versions which store data in an SQL database The setup guide contains step by step instructions to install one of the stan dard configurations
18. SLY DISCLAIM ALL WAR RANTIES EXPRESS OR IMPLIED INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICU LAR PURPOSE TITLE AND NON INFRINGEMENT IN NO EVENT SHALL SYN THESIS AG BE LIABLE FOR ANY DIRECT INDIRECT INCIDENTAL SPECIAL E XEMPLARY OR CONSEQUENTIAL DAMAGES INCLUDING BUT NOT LIMITED TO PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES LOSS OF USE DATA OR PROFITS OR BUSINESS INTERRUPTION HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHER IN CONTRACT STRICT LIABILITY OR TORT INCLUDING NEGLIGENCE OR OTHERWISE ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DA MAGE 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 3 1 Introduction Thank you for choosing Synthesis Sync Client as your SyncML client solution It provides you with a very efficient compliant SyncML client with many advanced features and especially a high configurability If you have used earlier versions of the Synthesis SyncML client please refer to Chapter 2 for a quick overview of the changes Synthesis Sync Client exists in different versions for different database interfaces This manual covers the SQL ODBC with custom database adaptor plugin version of Synthesis Sync Client This manual covers installation based on the sample configuration provided by Synthesis Please refer to the Synthesis SyncML Config Reference document for de
19. ata that MUST be ente red is the name of the datasource you will need it for Synthesis Sync Server config and the specification of the database to be accessed a protocol selection normally TCP IP a server name and the full path to the database file like C databases syncdb gdb from the database creation example above Additionally you need to enter a valid user password to connect to the database Most drivers offer a Test button to test the connection and make sure the ODBC Datasoutrce will work ok Important Make sure that the same character set is chosen in the ODBC settings for the datasource as defined when creating the databa se Otherwise using non ASCII chars will cause database acesses to fail e Confirm the settings and close the control panel 4 1 2 Installing the ODBC SyncML client Installing the client is simple 1 Copy the file syneclient_odbc exe or syncclient_odbc_std exe if you have the STD version from the bin_win32 bin_linux_x86 or bin_macosx distribution directory to a directory of your choice Note on Linux and Mac OS X these files have no exe extension 2 Copy the file syncclient_odbc xml if you have the evaluation or PRO version or syncc lient_odbc_std xml if you have the STD version from the appropriate distribution directory according to the database you are using in sample_config to the same directory where you put the executable file 4 1 3 Configuring the ODBC SyncML clien
20. ave a number of new fields to support Suspend amp Resume see 2 4 2 for details SYNC_LOGS has some additional fields for extra information such as number of errors The DEVICEID and DEVICEINFO fields in SYNC_DEVICES are now longer to make sure even very long device IDs don t cause problems New tables SYNC_EMAILS SYNC_EMAIL_ATTS and SYNC_BOOKMARKS have been added to support email and bookmarks Data tables for contacts events and tasks SYNC_CONTACTS SYNC_EVENTS SYNC_TASKS have been enhanced to support some mote fields like contacts picture a third postal address categories classification etc 2 4 Migration Guide How to upgrade existing 2 1 x instal lations to 3 0 2 4 1 Overview What needs to be done to upgrade an existing 2 1 x based installation to 3 0 There are three possibilities 1 2 Just use the new client version with your existing 2 1 config and database This will bring you basic SyncML DS 1 2 compatibility with almost no effort However a very impor tant advantage of SyncML DS 1 2 the Suspend amp Resume feature will not work this way You will also get some warnings about lt linemap gt s that should be moved into lt textprofile gt when starting up the client or testing the config syntax This is not recommended as a long term solution but can be done as a first step towards SyncML DS 1 2 support Apply minimal updates to enable full SyncML DS 1 2 Suspend amp Resume This requi res some changes
21. base connection module specific error code 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch
22. cclient_odbc PRO version syncclient odbc std STD version E cer ae syncclient odbc PRO version syncclient odbc std STD version sample config interbase firebird interbase sql interbase upgrade 2 1 to 3 0 sql mssql sql mssql upgrade 2 1 to 3 0 sql _ mysql sql mysql upgrade 2 1 to 3 0 sql unsupported admin php config php index php read_me txt logo jpg syncclient_odbc xml for PRO version syncclient_odbc_std xml for STD version mssql syncclient_odbc xml for PRO version syncclient_odbc_std xml for STD version syncclient_odbc xml for PRO version syncclient_odbc_std xml for STD version distribution directory root e Read me disclaimer license text files depending on version 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 14 docs Directory e SySync_Client_manual pdf This file e SySync_config_reference pdf Detailed description of XML configuration options e Eventually some extra materials such as Synthesis SyncML product overviews etc bin_linux_x86 Directory e syneclient_odbc for the PRO and syncclient_odbc_std for STD version This is the conso le based standalone version of the client bin_linux_x86_gcc33 Directory e The same files as under bin_linux_x806 but compiled with GCC 3 3 instead of GCC 2 95 for the bin_linux_x86 files These binaries are able to run under current distributions like Debian 3 1 Sa
23. cts source contacts lt SyncML message 2 sent to http myserver sync sessionid 123 gt SyncML message 2 received from http myserver sync lt SyncML message 3 sent to http myserver sync sessionid 123 gt SyncML message 3 received from http myserver sync Syne Statistics for contacts contacts slow sync on Client on Server Added 1 0 Deleted 0 0 Updated 0 3 Client Session successfully terminated 5 3 Debug Log Files Synthesis Sync Client can create a configurable amount of log information to help tracking down problems The log information is controlled by the lt debug gt section in the config file 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 26 lt debug gt lt enable option all gt lt logpath gt D sync logs lt logpath gt lt msgdump gt no lt msgdump gt lt debug gt There are many options available see description of the lt debug gt tag in the config reference manual for details For evaluation we recommend to leave the settings as they are full log in formation In addition if you have problems with a server you want to report to Synthesis AG you can set lt msgdump gt to yes This will generate a separate file for every message sent or received by the SyncML client You can also switch off debug information totally by replacing the lt enable option all gt with lt disable option all gt To only log
24. d ne naiidediguei en alicediaideiinebeediuedsieiess 29 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 5 2 Changes since Version 2 1 This paragraph is indended for existing users of the previous 2 1 version of the Synthesis SyncML server It lists the most important differences between the two versions Basically SyncML Server 3 0 and 2 9 x is upwards compatible with existing 2 1 x configurati ons This means that most configuration files written for the 2 1 x release will also work with version 3 0 and higher There might be cases where minor adaptions are required Please note however that the new sample database layouts provided for MySQL MS SQL and Interbase with this 3 0 server release are not fully compatible with the old 2 1 sample layouts because they were update to include new features and datatypes 2 1 Feature Matrix 2 1 vs 3 0 and STD vs PRO The following matrix shows the most important changes between 2 1 and the new 3 0 version and also shows the difference between the STD and PRO versions Note that this matrix is not intended to be complete it would get too long it just lists the most important new features Feature Description STD PRO SyncML DS 1 2 OMA DS 1 2 Supports SyncML 1 2 standard o but automatically falls back to 1 1 or 1 0 if server does not support 1 2 Suspend amp Resume Full support for new SyncML DS 1 2 Suspend amp Resume feature if a
25. description is written just as an orientation and not as an introduction to MySQL or MyODBC You can install the sync tables into an existing database or create a new one Skip the following paragraph if you want to install into an existing database Creating a new Database 1 Start the mysql mysql exe under windows client program with a username password having enough privileges to create a new database 2 Enter create database syncdb 3 MySQL will create a new database 4 quit the mysql client program by entering exit Creating the Sync Tables 1 Start the mysql mysql exe under windows client program with a username password having enough privileges to create a new database 2 Execute the mysql sql script provided in the sample_config mysql directory by entering source path to evaluationpackage sample_config mysql mysql sql 3 MySQL creates the database tables required for the SyncML client and server 4 Grant appropriate privileges to the user password combination you want to use for accessing the database from the SyncML server For example executing GRANT USAGE ON TO syncml localhost and then GRANT SELECT INSERT UPDATE DELETE ON syncdb TO syncml localhost IDENTIFIED BY mysecret will allow access from the lo cal machine with user password syncml mysectet 5 quit the mysql client program by entering exit Now you have the standard database tables for Synthesis Syne Client installed MySQL Server
26. e gt all identical as follows add the bold red part INSERT INTO SYNC MAPS LOCALID REMOTEID TARGETKEY ENTRYTYPE FLAGS VALUES k r t e x 8 Change all lt updatemapsql gt one for each lt datastore gt all identical as follows add the bold red part UPDATE SYNC MAPS SET REMOTEID sr FLAGS x WHERE LO CALID k AND ENTRYTYPE e AND TARGETKEY t 9 Change all lt deletemapsql gt one for each lt datastore gt all identical as follows add the bold red part DELETE FROM SYNC _ MAPS WHERE LOCALID k AND ENTRYTYPE e AND TARGETKEY t With these steps your installation is now enabled for SyncML DS 1 2 suspend and resume Still for making full use of the numerous improvements and new features in the 3 0 client have a look at the new 3 0 sample config and maybe use a difference viewer to compare your config to 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 10 the new 3 0 this way you ll probably see other changes that might be advantageous for your installation The config reference manual explains all config features in detail 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 11 3 Distribution Files 3 1 ODBC Version Windows The distribution media normally a ZIP archive contains the following files note that depen ding on the version you have not all of the listed files will be included
27. eckbox 16 Select the correct database from the popup list below 17 Click Next 18 Click Finish 19 Click Test Datasoutce to see if datasource works ok 20 Click OK and close the ODBC Datasources control panel 4 1 1 3 Database preparation for MySQLiIMyODBC Note This description is primarily indended for using the Synthesis SyncML Client on the Linux plat form However MySOL is and MyODBC are available for Windows as well installation procedure might differ slightly but using the SyncML client with MySQL on Windows is no problem Some information about MySQL MySQL is a very popular open source SQL database server which is widely used for web applications on many different platforms Linux MacOS X Win dows among them MySQL sources and ready to install packages for most popular operating systems are available from www mysql com The same site also provides an ODBC driver for MySQL named MyODBC Synthesis SyncML Client and the sample configuration delivered with it was tested with MySQL Version 4 0 16 and MyODBC 3 51 06 but is expected to run with earlier and future of course versions of MySQL as well as the SyncML client does not make use of any special features of newet MySQL versions 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 19 We assume that you are familiar with using MySQL on the target platform of your choice Linux Windows Mac OS X The following step by step
28. emsupport gt yes lt resumeitemsupport gt lt synctargetsql gt 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 9 4 Change all lt synctargetgetsqI gt there is one for each lt datastore gt differing only in the DSCODE xx part but that s essential make sure you leave that xx as it is for each da tastore in your XML config file as follows add the bold red part SELECT TARGET KEY ANCHOR LASTSYNC LASTTOREMOTESYNC RESUMEALERT LASTSUSPEND LISOURCE LITARGET LISTATUS PISTATE PITOTALSZ PIUNCONFSZ PISTOREDSZ PIDATA FROM SYNC TARGETS WHERE DSCODE xx AND USERKEY su AND FOL DERKEY AND DEVICEKEY d AND DEVICEDBPATH P 5 Change all lt synctargetupdatesql gt one for each lt datastore gt all identical as follows add the bold red part UPDATE SYNC CONTACTS TARGETS SET ANCHOR A LAST SYNC L WHERE TARGET KEY st UPDATE SYNC TARGETS SET ANCHOR A LASTSYNC L LAST TOREMOTESYNC RL RESUMEALERT SUA LASTSUSPEND SU LISOURCE pSU LITARGET pTU LISTATUS pSt PISTATE pM PITOTALSZ pTS PIUNCONFSZ pUS PISTOREDSZ pSS PIDATA pDAT WHERE TARGET KEY t 6 Change all lt selectmapallsql gt one for each lt datastore gt all identical as follows add the bold red part SELECT LOCALID REMOTEID ENTRYTYPE FLAGS FROM SYNC _MAPS WHERE TARGETKEY lt st 7 Change all lt insertmapsqlI gt one for each lt datastor
29. error conditions use lt enable option error gt The files generated are where xxxx is odbc for the ODBC version and demo for the De mo version e client_xxxx log This is the main debug log file It contains all the messages that cannot be related to a certain SyncML session e client_xxxx_sYYYYYYYYYY log These are session specific log files where YYYY is the internal session ID To see what happened in a Sync Session look at these files e client_xxxx_reqNNN_incoming sml and client_xxxx_reqNNN_outgoing sml These are 1 1 dumps of the incoming and outgoing SyncML messages when lt msgdump gt is set to yes see above NNN is a three digit request number that starts counting at 1 when the server is started Note that these normally contain binary WBXML data and cannot be vie wed with a text editor In case of reporting problems with Synthesis Sync Client it helps a lot if you include the ap propriate log files main debug log file log file for the session in question and message dumps if possible In case you want to do performance testing please switch off debug logging completely or redu ce it to error reporting because log writing is done in a safe way log file opened and closed for every log message which may degrade performance a little So use lt disable option all gt in the config to make performance tests 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 27
30. in the config file and some new fields in the admin tables in the databases but does not touch anything related to your data tables so it requires no changes in your application This is the recommended migration and is explained step by step below see 2 4 2 Enhance your existing configuration with new features from the new 3 0 sample The new 3 0 client supports new things that were not possible with the 2 1 For example support for pictures in contacts is now easily possible and also part of the new 3 0 config sample If your application supports contact pictures you should adapt your 2 1 config to support them with your application The new sample config now also contains sample support for an email datastore and vBookmark 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 8 2 4 2 Updating a 2 1 installation for 3 0 with full Suspend amp Resume support The following is a step by step guide how to update an existing Synthesis SyncML Client 2 1 in stallation to version 3 0 to gain full SyncML DS 1 2 Suspend amp Resume support 1 2 Backup your database and config of course Or work on a copy of the current database For suspend and resume to work the SYNC_TARGETS and SYNC_MAPS tables need additional fields In the samp le_config directory of the 3 0 client distribution there is a SQL script for each supported database called XXX X _wupegrade_2 1_to_3 0 sql XXX database system This script con
31. ins a SQL set up script for MySQL server and sample config files Note that you need to use the config files ending with _std when you are using the STANDARD version Please note that this sample is primarily intended for use with Linux and therefore sample file paths are in UNIX format however you can just change them to appropriate Windows paths mssql This directory contains a SQL set up script for MS SQL server and sample config files Note that you need to use the config files ending with _std when you are using the STANDARD version unsupported Directory config php admin php index php and logo jpg These files provide a simple web based interface to access the data in the standard database layouts You need to have PHP4 installed on the web server which hosts these files see www php net THESE FILES ARE PRO VIDED AS IS AS A FREE ADD ON FOR TESTING PURPOSES SYNTHESIS AG DOES NOT PROVIDE ANY SUPPORT FOR THESE FILES read me txt Short explanation how to use the PHP files 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch 3 2 ODBC Version Linux Page 13 The distribution media normally a gzipped tar archive tgz contains the following files note that depending on the version you have not all of the listed files will be included SYNTHESIS SYNC CLIENT some tead me license disclaimer text files o s pdf documentation in Adobe PDF format bin linux x86 syn
32. le can be created there Sync Client uses this path to store diagnostic log files here lt datasource gt This is the name of the datasource you have created above lt dbuser gt lt dbpassword gt User and password used to access the database Note some MySQL MyODBC installations do not work correctly when only given the datasource name for some reason the driver will not use the database name configured in the datasource but expects that the database name is specified explicitly when connec ting the datasource In this case you should use the lt dbconnectionstring gt tag instead of lt datasource gt and lt dbuser gt This is described in detail in the configuration reference manual For making it work quickly just delete the lt datasource gt and lt dbuser gt tags from the config file and insert something like lt dbconnectionstring gt DSN syneml UID syncml DATABASE syncdb lt dbconnectionstring gt 3 Save the config file 4 2 Installing and configuring the DEMO SyncML client 4 2 1 Installing the DEMO SyncML client Simply copy the executable syncserv_demo exe for Windows syncserv_demo for Linux and MacOS X and syncserv_demo xml file into a directory where you have write access 4 2 2 Configuring the DEMO SyncML client There is basic configuration needed for the demo client Of course there are various options such as logfile paths etc that can be configured but for a basic operation this is not re
33. nt data sets in the same database The table named SYNC_FOLDERS contains a folder ID name which is used to access the folder from the SyncML clients see lt localpathextension gt configuration tag and a decriptive text e Permission management The table named SYNC_PERM links between users and folders A user can be granted permission to any folder by inserting a record in SYNC_PERM contai ning the appropriate keys from SYNC_USERS and SYNC_FOLDERS resp e Syncable database management SYNC_TARGETS manages the so called Sync Targets A Sync Target is a remote database one remote server often has more than one database which is performing synchronisation with a local database The client uses the SYNC_TARGETS records to remember the time of last sync and a few other items for every Sync Target e Change Log Management The table named SYNC_MAP contains mapping data Mapping entries are needed to determine which items have been deleted on a per server All entries in SYNC_MAP are related to an entry in SYNC_TARGET e Sync Log The table named SYNC_LOG is used to log SyncML client activity A new record is created for every started synchronisation of a Sync Target so a device syncing contacts and events will create two entries one for contacts one for events A log entry is created even if synchronisation fails with a Sync Target Note that no log entry is created if the sync session 2002 2005 by Synthesis AG Z rich Switzerland
34. product see www ibdatabase com We assume that you are familiar with using Interbase 6 or Firebird The following step by step description is written just as an orientation and not as an introduction to Interbase or Firebird You can install the sync tables into an existing database or create a new one Skip the following paragraph if you want to install into an existing database Creating a new Database 6 Open IBConsole Doubleclick and login to the server you want to create the database on Right click Databases and select Create Database from the context menu Under Filename s enter the FULL PATH for the database file into the first field e g C databases syncdb gdb 10 Make sure the checkbox Register Database is checked 11 Under Alias enter a descriptive name e g Sync DB 12 Press OK 13 In the tree view the new database is automatically opened 14 Add database users required access the database For a quick test you can just use existing sysdba but this is not a secure way to do it re N Creating the Sync Tables 1 Open IBConsole 2 Doubleclick and login to the server the database is on you are already there if you just have created the database Doubleclick the database you want to use to connect to it From the menu select Tools gt Interactive SQL In the Interactive SQL window select Query gt Load Script from the menu Select the SQL script named interbase
35. quired Please refer to the SySync_Config_Reference manual for details 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 24 5 Using the SyncML client 5 1 Specifying the SyncML server and databases to syn chronize with Before actually starting a synchronisation you need to specify the server to synchronize with and some information what data you want to synchronize The related information is also contained in the XML config file 1 Use a text editor to open the syncclient_odbe xml ODBC version the syncc lient_demo xml Demo version or file Scroll down to the comment that reads lt Confi guration of Sync Requests gt lt Configuration of Sync Requests gt lt gt lt localdbuser gt test lt localdbuser gt lt localdbpassword gt test lt localdbpassword gt lt defaultsyncemlversion gt 1 1 lt defaultsyncmlversion gt lt choose encoding for SyncML messages xml or wbxml gt lt syncmlencoding gt wbxml lt syncmlencoding gt lt serverurl gt http yourserver com sync sync d1ll lt serverurl gt lt Enter user and password to be used to login to the remote server gt lt serveruser gt myuser lt serveruser gt lt serverpassword gt mypassword lt serverpassword gt lt syncrequest datastore contacts gt lt localpathextension gt lt localpathextension gt lt dbpath gt contacts lt dbpath gt lt syncmode gt twoway lt syncmode gt
36. rge SuSE 9 3 and Fedora Core 3 sample_config Directory e mysql This directory contains a SQL set up script for MySQL server and sample config files Note that you need to use the config files ending with _std when you are using the STANDARD version e interbase_firebird This directory contains a SQL set up script for Interbase 6 or Firebird 1 SQL servers and sample config files for the Synthesis Sync Client Note that you need to use the config files ending with _std when you are using the STANDARD version Please no te that this sample is primarily intended for use with Windows and therefore sample file paths are in Windows format however you can just change them to appropriate Linux paths e mssql This directory contains a SQL set up script for MS SQL server and sample config files Note that you need to use the config files ending with _std when you are using the STANDARD version Please note that this sample is primarily intended for use with Windows and therefore sample file paths are in Windows format however you can just change them to appropriate Linux paths unsupported Directory e config php admin php index php and logo jpe These files provide a simple web based interface to access the data in the standard database layouts You need to have PHP4 installed on the web server which hosts these files see www php net THESE FILES ARE PRO VIDED AS IS AS A FREE ADD ON FOR TESTING PURPOSES SYNTHE
37. rmally don t need to edit lt dbpath gt at all Optionally you can also set a different lt syncmode gt twoway fromserver fromclient and force a slow sync lt slowsync gt true lt slowsync gt For a normal two way sync no changes are needed 5 2 Running the SyncML client To start the client just doubleclick the syncserv_xpt_odbc_ev exe file Under Linux and Mac OS X start syncserv_xpt_odbc from the command line Note that there are some command line options that can be used when staring the client in a console terminal window see Chapter 5 4 for details If there is an error condition such as bad config or connection problem the client does not start the sync session but displays the error condition See Chapter Fehler Verweisquelle konnte nicht gefunden werden for explanation of error codes After successful startup the console window will show some progress of the sync session like this SySync Client Win32 Demo Version 2 0 8 12 Reading config from syncclient_odbc xml Config file read from syncclient_odbc xml Debug log path D synclogs SEPARATE log file starting client session with http myserver sync lt SyncML message 1 sent to http myserver sync gt SyncML message 1 received from http myserver sync lt SyncML message 1 sent to http myserver sync gt SyncML message 1 received from http myserver sync Remote alerts 201 two way slow sync for conta
38. se preparation saissanscsnatdusnanacaranarenaesnatanubebiaerenabitensiabiiedabend ES 16 4 1 1 1 Standard Layout OVErview ccccceeceeeeceeeeeeeesseeeeeeeeeeeeneaeeeeeeeeeenees 16 4 1 1 2 Database preparation for MS SQL Servetl cccceceeeeeeeeeeeeeeeees 17 4 1 1 3 Database preparation for MySQL MyODBC e 18 4 1 1 4 Database preparation for Interbase Firebird SQL Server 20 4 1 2 Installing the ODBC SyncML Chen sssicscinscenceescemactentedetertbeseecnnteteceandtenne 22 4 1 3 Configuring the ODBC SyncML client s sseeeeneeeeeeerrrrrrrrrressreeresereeee gt 22 4 2 Installing and configuring the DEMO SyncML client 23 4 2 1 Installing the DEMO SyncML Client eee eeeeeeeeeeeeeeeeeeeeeteeeeeeeeeeeeeeeeeeee 23 4 2 2 Configuring the DEMO SyncML client 22 22 2 22eeeeeeeeeeeeeeeeeeee 23 5 Using the SyncML client sss ss 22 24 5 1 Specifying the SyncML server and databases to synchronize with 24 5 2 Running the SyncML CUT secede cetteetnn eaten ceetiuderiundiunt a eeleeeceveuee 25 5 3 Debug Log Filesxiso ee eee ee 29 5 4 SyncML client command line Options 0 eeeeeee seer eee 27 6 Error COGCS ccecceeeeeeeeeeeeee cece eeeeee eee ee eee eee eee eee 28 6 1 SyncML Status OOS cee cee cetee roerien rororo ERCE KERERE EEEE EO O EEEE 28 6 2 Internal Error CodeS cceccccsisss5enic Hacsdecss
39. t 1 Use a text editor of your choice Windows Notepad is ok to open the copied syncc lient_odbc xml file The beginning looks similar to the following lt xml version 1 0 gt s lt sysync_ config version 1 0 gt lt licensename gt licensee name lt licensename gt lt licensecode gt XXXX XXXX XXKK XXXX lt licensecode gt lt debug gt lt enable option all gt lt logpath gt D synce logs lt logpath gt lt msgdump gt no lt msgdump gt lt debug gt a lot of XML follows here scroll down until you reach the lt client gt tag 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 23 lt client type odbc gt some more XML follows here please scroll down lt logfile D sync logs synclog txt lt logfile gt some more XML follows here please scroll down lt datasource gt DataSourceName lt datasource gt lt dbuser gt dbuser lt dbuser gt lt dbpass gt dbpassword lt dbpass gt 2 Modify the highlighted settings lt licensename gt lt licensecode gt Enter the licensing information you have received from Synthesis AG for your purchased product or evaluation package here Note that demo versions do not need any licensing information lt logpath gt Enter a full path that exists and is writable here Sync Client uses this path to store diagnostic log files here lt logfile gt Enter a full path to the desired log file and make sure the fi
40. t to create the database on Right click Databases and select New Database from the context menu Give it a name e g SyncDB Press OK Open the Databases folder in the tree the new database should appear there Add database users required access the database For a quick test you can just use existing dbo but this is not a secure way to do it SEON Oe ce Creating the Sync Tables 1 Open SQL Query Analyzer 2 Connect to the correct SQL Server 3 In the query window click the open button folder icon 4 Select the SQL script named mssql sql provided in the Synthesis Sync Client distribution in the mssql directory in the sample_config directory 5 Make sure to select the correct database name in the DB popup in the toolbar of the query window 6 Execute the script Press F5 or click the green right pointing arrow Now you have the standard database tables for Synthesis Sync Client and Server installed in MS SQL Server Setting up the ODBC Datasource ODBC Datasoutces are configured using the ODBC Datasources or similar control panel It is hidden at different places on different versions of Windows In older versions it can be found among the other Control Panels Start gt Settings gt Control Panel in Windows 2000 and newer it is under Start gt Applications gt Administration 2002 2005 by Synthesis AG Z rich Switzerland www synthesis ch Page 18 The installation of a
41. tails about all the configura tion options Synthesis Sync Client 3 0 ODBC Version is designed to bring SyncML synchronisation functionality to almost any SQL accessible database using the ODBC interface To allow using existing database tables the Synthesis Sync Client is highly configurable With its XML based configuration file the mapping between SyncML data formats normally vCard and vCalendar and database tables can be defined on a field by field basis As this customized configuration to a specific database layout is not trivial and needs some time to successfully be completed and tested Synthesis Sync Client comes with sample files for crea ting a standard layout This allows you to set up a working SyncML solution in a short time It also provides a starting point for customizing the client to your specific needs Therefore the setup guide in this manual describes how to use the standard layout If you are new to Synthesis Sync Client we recommend that you first install and test a standard layout befo re doing your own configuration Synthesis Sync Client 2 0 Text File Version is a Demo version It is available for free and provides full SyncML functionality but stores data in TAB separated text files While this version is not indended nor suitable for productive use it is installed in seconds and very useful to test SyncML servers or get an insight into Synthesis Sync engine s configuration capabilities See section
42. tains the necessary ALTER TABLE statements to add the required fields to SYNC_TARGETS and SYNC_MAPS In addition the size of the deviceID in SYNC_DEVICKES is increased and two new fields are added to SYNC_LOGS These two changes are not absolutely needed but strongly recom mended Execute this script on your sync database using your favorite SQL tool to apply the changes You can also apply them manually in a GUI table editor To summarize The new fields are e InSYNC_TARGETS LASTSUSPEND DATETIME RESUMEALERT INTEGER 16 bits required LISOURCE VARCHAR 63 LITARGET VARCHAR 63 LISTATUS INTEGER 16 bits required PISTATE INTEGER 8 bits required PITOTALSZ INTEGER 32 bits required PIUNCONFSZ INTEGER 32 bits required PISTOREDSZ INTEGER 32 bits required PIDATA BLOB eventually called IMAGE or LARGEBLOB e InSYNC_MAPS ENTRYTYPE INTEGER 8 bits required Part of Primary Key FLAGS INTEGER 32 bits required Note that it is essential that ENTRYTYPE becomes part of the primary key of the map table in addition to LOCALID and TARGETKEY e InSYNC_LOGS LOC_ERRORS INTEGER REM_ERRORS INTEGER In your XML config file immediately Before each occurrence of lt synctargetgetsqI gt there is one for each lt datastore gt add the following two new tags add the bold red part these enable Suspend and Resume functionality for details see Config Reference Manual lt resumesupport gt yes lt resumesupport gt lt resumeit
43. we recommed including them in the connection string as well see below Under Windows ODBC Datasoutces are configured using the ODBC Datasources or similar control panel It is hidden at different places on different versions of Windows In older versions it can be found among the other Control Panels Start gt Settings gt Control Panel in Windows 2000 and newer it is under Start gt Applications gt Administration Installing the ODBC datasource for MySQL MyODBC consists of the following steps on a Windows system e Install the MyODBC driver e Open the ODBC Datasources control panel e Select the User DSN or System DSN tab depending on wether you want to make the datasoure available to the currently logged in user only or all users and system processes on the machine Click the Add button e From the list of available drivers select MySQL ODBC 3 51 or newer version e Click Finish e The MySQL specific set up panel appears e Enter a name for the datasource such as syncml this will be used to refer to the datasour ce from within the SyncML client s config file e You may also enter a description for the datasource e Now you can enter the host name usually localhost if MySQL and the SyncML client are running on the same machine e To test the connection you can enter username passwotd as well would be syncml mysecret if database was set up as shown in the example above and click the Test Data Source
Download Pdf Manuals
Related Search