Remerciez-le!

Remerciez @Admin pour avoir partagé cet document gratuitement, de la manière la plus simple, en partageant sur les réseaux sociaux.

Compelson SyncML Server Administrator’s Guide, revision 1.26, 12/08/2008 Page 1

Compelson SyncML Server Administrator’s Guide, revision 1.26, 12/08/2008 Page 1 out of 25 Compelson SyncML Server Administrator’s Guide revision 1.26 Compelson SyncML Server Administrator’s Guide, revision 1.26, 12/08/2008 Page 2 out of 25 1 Table of contents 1 Table of contents................................................................................................. 2 2 Introduction.......................................................................................................... 4 2.1 Features....................................................................................................... 4 2.2 Device compatibility list ................................................................................ 5 3 Installation ........................................................................................................... 6 3.1 Prerequisites ................................................................................................ 6 3.2 Copying files................................................................................................. 7 3.3 Setting up application account ..................................................................... 8 3.4 Creating and populating databases.............................................................. 9 3.4.1 SQL Permissions .................................................................................. 9 3.5 Creating event log ...................................................................................... 10 3.6 Configuring IIS ........................................................................................... 11 3.7 Configuring SyncML................................................................................... 14 3.7.1 Outgoing e-mail configuration ............................................................. 15 4 Activation............................................................................................................16 5 Management ......................................................................................................17 5.1 Configuration files....................................................................................... 17 5.2 Web manager............................................................................................. 18 5.3 Event log .................................................................................................... 21 5.4 Communication dump folder ...................................................................... 22 6 Localizing public web..........................................................................................23 7 Support...............................................................................................................24 8 Appendix ............................................................................................................25 8.1 SQL Permission Fix Commands ................................................................ 25 Compelson SyncML Server Administrator’s Guide, revision 1.26, 12/08/2008 Page 3 out of 25 Compelson SyncML Server Administrator’s Guide, revision 1.26, 12/08/2008 Page 4 out of 25 2 Introduction Compelson SyncML Server is a remote synchronization solution for mobile devices. Currently it supports synchronization of contacts (phonebook), events (calendar), tasks, and notes – the PIM features most commonly found in today’s mobile phones and personal digital assistants. Over-the-air synchronization avoids the need for a cable, IR, or Bluetooth connection, which is vital to any local synchronization solution. In addition to the SyncML protocol support itself, mobile devices are only required to have a working Internet connection, such as GPRS, HSCSD, EDGE, UMTS, etc. Users don’t have to install specialized software on their machines since a web browser is all they need to access their data stored on the server. Advantages of web-based access naturally include platform independence and simple centralized management. With the recent Internet ubiquity, data can be accessed almost instantly from virtually any place at any time. Losing one’s mobile phone while traveling should no longer be a catastrophe. Visiting an Internet café is all it takes to access its latest content. Furthermore, loading all the contacts and meetings to a new phone is just a matter of a few clicks. 2.1 Features Compelson SyncML Server consists of a synchronization engine distributed in binary form and a web interface (public and administrative web) distributed in source code form. The web interface is an ASP.NET 2.0 application and as its source files are available, it can be easily customized to fit specific needs. Minimum effort is required to translate the web to another language or change its overall visual appearance. The engine is a .NET 2.0 application that integrates with the Microsoft IIS server at the IHttpHandler level, taking full advantage of the ASP.NET infrastructure. Microsoft SQL Server 2000 or 2005 is used as storage for all user data, as well as for internal structures related to synchronization. Contrary to most SyncML implementations around, Compelson SyncML Server is proud to provide excellent support for national character sets (Cyrillic, diacritic characters, etc.) Other distinguished features include recurrent event support in the calendar. As for data formats, the engine accepts and generates contacts in the vCard 2.1 format (content type text/x-vcard), events and tasks in the vCalendar 1.0 format (content type text/x-vcalendar), and notes in vNote 1.1 (content type text/x- vnote) and plain text (content type text/plain) format. Two-way as well as one-way synchronization is supported. More devices can synchronize their data with one server store, which results in their mutual synchronization with the server database acting as an intermediary. Compelson SyncML Server Administrator’s Guide, revision 1.26, 12/08/2008 Page 5 out of 25 2.2 Device compatibility list We have implemented the solution according OMA SyncML DS 1.2 specifications. All phones and clients compliant with the specification are compatible with our server. The exception is only if there is some bug in the phone. The number of compliant phones is growing every day as manufacturers are releasing phones to the market, so we don’t have a list. Compelson SyncML Server Administrator’s Guide, revision 1.26, 12/08/2008 Page 6 out of 25 3 Installation The installation program performs several complex tasks in order to fully set up Compelson SyncML Server on the target machine. Aside from copying all the files, the necessary databases are created and populated, IIS is properly configured, a new event log is created, and the SyncML server is configured. The following paragraphs describe in detail all the steps involved in setting up the server. 3.1 Prerequisites The server can be installed on any machine with: • Windows 2003 Server with IIS 6.0 • Microsoft .NET Framework 2.0 (distributed via Windows Update) • Microsoft SQL Server 2000 (or 2005), the free Express (MSDE) editions are also supported (MSDE 2000 is not recommended, due to it’s limitations, which can cause problems with multiple simultaneous user connections) • SMTP service installed on server or accessible trough network (this is optionaly required for sending informative e-mails from server application) Compelson SyncML Server Administrator’s Guide, revision 1.26, 12/08/2008 Page 7 out of 25 3.2 Copying files The installer creates in the target folder a directory structure. Some important subdirectories are described in the following table (target path is the directory chosen during installation – C:\Inetpub\wwwroot\SyncML\ by default): Path Description TARGET_PATH Represents the root of the public web application. TARGET_PATH\WebManager Represents the root of the web manager application. TARGET_PATH\sync Contains the “synchronization document”, with which client devices communicate. Make sure that the target folder is accessible for the account under which the applications will run. By default, it is the NT AUTHORITY\NETWORK SERVICE account. It is rarely necessary to change the directory structure created by the installer. If the applications are required to run at different URLs, you can conveniently achieve this goal by reconfiguring the appropriate IIS virtual directories (see below). Compelson SyncML Server Administrator’s Guide, revision 1.26, 12/08/2008 Page 8 out of 25 3.3 Setting up application account Installer can setup application either to run with under own account or use system ‘NT AUTHORITY\NETWORK SERVICE’ account. This account will be used as identity for web application pool and also for accessing databases. This account can be also used to access WebManager page (normaly it can be accessed only by Administrators group members). Account will be created on machine as local user account, and added to IIS_WPG group (group which has permission to run IIS application pool). Also read access for SyncML installation directory will be given to this account. Important: Installer does not support domain accounts, only local accounts. Compelson SyncML Server Administrator’s Guide, revision 1.26, 12/08/2008 Page 9 out of 25 3.4 Creating and populating databases The installer creates and populates four databases on a specified SQL server and grants needed access right to application account on them. The connection string as well as database names are entered during installation by the user. Make sure that the SQL server is running and that the databases do not already exist. If the databases already exist (i.e. you are repairing an existing installation), use the Skip button to go directly to the next step. Note that it is not necessary to backup the databases before uninstalling Compelson SyncML Server because the user is asked during uninstall whether to keep them or remove them. The connection string entered at this stage will also be used at application run-time (unless changed manually, of course). If you decide to use Integrated Authentication, make sure that the account under which the application will be running has sufficient SQL permissions. 3.4.1 SQL Permissions Application needs to have db_datawriter and db_datareader permission to created databases for account, which is running application pool, also for SyncML database is needed to grant Execute persmission for stored procedures. Standard installation of SQL server includes management tools where account and its right can be assigned, for SQL Express 2005 you need to install SQL Express Management Studio, which can be downloaded from Microsoft download website. For SQL commands, see end of this document. Compelson SyncML Server Administrator’s Guide, revision 1.26, 12/08/2008 Page 10 out of 25 3.5 Creating event log A new event log named SyncML is automatically created by the installer. The log can be accessed using standard tools, e.g. the Event Viewer located in Administrative Tools. It might be necessary to adjust the event log so that it fits your needs. For example the maximum log size, which is by default only 512 kB, and the overwriting policy might need adjustments. Compelson SyncML Server Administrator’s Guide, revision 1.26, 12/08/2008 Page 11 out of 25 3.6 Configuring IIS It is possible to let the installer configure IIS so that the server will work out-of-the- box. The user is asked for a virtual path where the public web should be accessible and for the synchronization virtual path (the one that is entered to client devices). Make sure that IIS is properly installed, i.e. Windows has been configured with the Application Server role. Automatic installation commenced by the OK button creates a new application pool named SyncMLPool and a new web site uploads/Management/ compelson-syncml-server-administrator-x27-s-guide-revision-1-26.pdf