1. Manuals
  2. Brands
  3. Novell Manuals
  4. Software
  5. DATA SYNCHRONIZER - 07-2010
  6. Administration manual

Novell DATA SYNCHRONIZER - ADMINISTRATION GUIDE 07-2010 Administration Manual

Hide thumbs Also See for DATA SYNCHRONIZER - ADMINISTRATION GUIDE 07-2010:
Table of Contents

Advertisement

Quick Links

Download this manual See also: Installation Manual
AUTHORIZED DOCUMENTATION
Administration Guide
Novell
®
Data Synchronizer
July 26, 2010
www.novell.com
Novell Data Synchronizer Administration Guide

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the DATA SYNCHRONIZER - ADMINISTRATION GUIDE 07-2010 and is the answer not in the manual?

Questions and answers

Related Manuals for Novell DATA SYNCHRONIZER - ADMINISTRATION GUIDE 07-2010

Summary of Contents for Novell DATA SYNCHRONIZER - ADMINISTRATION GUIDE 07-2010

  • Page 1 AUTHORIZED DOCUMENTATION Administration Guide Novell ® Data Synchronizer July 26, 2010 www.novell.com Novell Data Synchronizer Administration Guide...

  • Page 2: Legal Notices

    Further, Novell, Inc. reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes.
  • Page 3 Novell Trademarks For Novell trademarks, see the Novell Trademark and Service Mark list (http://www.novell.com/company/legal/ trademarks/tmlist.html). Third-Party Materials All third-party trademarks are the property of their respective owners.
  • Page 4 Novell Data Synchronizer Administration Guide...

  • Page 5: Table Of Contents

    Contents About This Guide 1 Managing the Synchronizer Services Managing the Data Synchronizer Services Collectively ....... 9 Managing the Synchronizer Services Individually .
  • Page 6 Securing Your Synchronizer System ........47 A Troubleshooting Novell Data Synchronizer Administration Guide...

  • Page 7: About This Guide

    About This Guide The Novell Data Synchronizer Administration Guide helps you to manage your Synchronizer system after you have set it up. The guide is divided into these sections: Chapter 1, “Managing the Synchronizer Services,” on page 9 Chapter 2, “Accessing Synchronizer Web Admin,” on page 13 Chapter 3, “Managing Your Synchronizer System,”...
  • Page 8 Novell Data Synchronizer Administration Guide...

  • Page 9: Managing The Synchronizer Services

    Managing the Synchronizer Services For an overview of the Novell Data Synchronizer services, see: “Data Synchronizer Product Overview” in the Novell Data Synchronizer Mobility Pack Installation Guide “Data Synchronizer Product Overview” in the Novell Data Synchronizer Installation Guide The Synchronizer services are managed on the command line in a terminal window.

  • Page 10: Managing The Sync Engine

    Web Admin service: root rcdatasync-webadmin start rcdatasync-webadmin restart rcdatasync-webadmin stop 1.2.4 Managing the Connector Manager Use the following command as to check the status of the Connector Manager: root rcdatasync-connectors status Novell Data Synchronizer Administration Guide...
  • Page 11 Use the following commands as to manually start and stop the Connector Manager: root rcdatasync-connectors start rcdatasync-connectors restart rcdatasync-connectors stop Managing the Synchronizer Services...
  • Page 12 Novell Data Synchronizer Administration Guide...

  • Page 13: Accessing Synchronizer Web Admin

    Accessing Synchronizer Web Admin All configuration of your Synchronizer system is done through Synchronizer Web Admin. When you log in as the Synchronizer administrator, you can configure the Sync Engine and connectors. When users log in using their network usernames and password, they can control connector-specific aspects of data synchronization for each connector where they have been added.

  • Page 14: As A Synchronizer User

    The user options available for each connector are described in the Quick Start (http:// www.novell.com/documentation/datasync_connectors1) for each connector. If you set yourself up as the Synchronizer administrator user, you can access your personal User Options page with the following URL: https://data_synchronizer_server:8120/admin/user/username Novell Data Synchronizer Administration Guide...

  • Page 15: Managing Your Synchronizer System

    Managing Your Synchronizer System When you install Novell Data Synchronizer, it is configured with default settings that are appropriate for your initial Synchronizer system. After installation, you can customize your Synchronizer system configuration as your Synchronizer system expands over time.

  • Page 16: Setting Up Multiple Synchronizer Administrator Users

    This section identifies the original Synchronizer user that you established during installation. 5 Copy the line for the original Synchronizer user to a new line between the tags., then <admins> modify it as needed to identify an additional Synchronizer administrator user. Novell Data Synchronizer Administration Guide...

  • Page 17: Adjusting The Synchronizer Web Admin Polling Rate For Groups

    6 Save the file, then exit the text editor. configengine.xml 7 Restart the Synchronizer services to put the new setting into effect: rcdatasync restart 3.1.3 Adjusting the Synchronizer Web Admin Polling Rate for Groups When you add an LDAP group to your Synchronizer system in Synchronizer Web Admin, the LDAP group’s existing members are added to the group as displayed in Synchronizer Web Admin.

  • Page 18: Adjusting The Synchronizer Web Admin Timeout

    6 Restart the Web Admin service to put the new port number into effect: rcdatasync-webadmin restart 3.1.6 Configuring Synchronizer Web Admin for a Specific Language The Synchronizer Web Admin interface has been translated into the following languages: Dutch French German Novell Data Synchronizer Administration Guide...

  • Page 19: Configuring The Sync Engine

    Spanish Swedish It displays in the same language as your Web browser when you are using one of the supporting languages. Otherwise, it displays in English by default. If necessary, you can override the default language selection. 1 In a terminal window on the Synchronizer server, log in as the user.

  • Page 20: Selecting A Log Level

    Synchronizer administrator who wants to observe the functioning of the Synchronizer system. However, it puts a heaver load on the Synchronizer services than the Warning and Error log levels. This is the default log level. Novell Data Synchronizer Administration Guide...

  • Page 21: Enabling Per-User Logging

    Warning: Logs problems that should not adversely affect Synchronizer processing but should be investigated and resolved for optimum performance. This log level is appropriate for a smoothly running Synchronizer system where you only want to be notified of warnings and errors. Error: Logs error messages that indicate critical errors in Synchronizer processing.

  • Page 22: Configuring Database Maintenance

    4 Click Save XML to save your change, then click Edit Settings Form to return to the Engine Configuration page. 5 In a terminal window, restart the Sync Engine to put the new database maintenance setting into effect. rcdatasync_syncengine restart Novell Data Synchronizer Administration Guide...

  • Page 23: Monitoring The Sync Engine

    3.3 Monitoring the Sync Engine You can assess the functioning of the Sync Engine by checking statistics for events, caching, and attachments. 1 In Synchronizer Web Admin, click (Monitoring) in the Actions column for the Sync Engine ) to display the Engine Monitoring Data page. default 2 Review the monitoring data in the Event Statistics section.
  • Page 24 4 Review the monitoring data in the Attachment Statistics section. Many different types of files can be attached to items. Some types and sizes of attachments are synchronized between applications and some are not, depending on how each connector is configured. Novell Data Synchronizer Administration Guide...

  • Page 25: Working With Synchronizer Log Files

    Statistic Description query.name The name of the Sync Engine query that is returning the statistics getAttachmentsStats query.timestamp The date and time when the statistics were gathered. Refresh your browser window to refresh the statistics. engine.cache.count engine.attachments.count engine.filestore.count 5 When you are finished viewing the engine monitoring data, click Home in the menu bar to return to the main Synchronizer Web Admin page.

  • Page 26: Sync Engine Log File

    Python thread is associated with the Connector Manager and which Python thread is associated with each connector. The Connector Manager log file lists each component and the PID number associated with each one. This can be very useful for troubleshooting. Novell Data Synchronizer Administration Guide...

  • Page 27: Per-User Log Files

    3.4.6 Per-User Log Files Per-user log files ( ) report on problems that a specific user is user_distinguished_name.log having. Per-user logging is disabled by default. To enable it, see Section 3.2.3, “Enabling Per-User Logging,” on page 3.4.7 Flatfile Connector Troubleshooting When data does not synchronize as expected, it can be challenging to determine which component in your Synchronizer system is the source of the problem.You can set up a Flatfile Connector to capture the data files that contain data from one application to see how that data is flowing through...
  • Page 28 3 Have the user with the synchronization problem send a message from the mobile device. 4 Again, check the directory to determine whether the data file successfully /tmp/outbound passed from the mobile device, through the Mobility Connector, through the Sync Engine, and to the Flatfile Connector. Novell Data Synchronizer Administration Guide...

  • Page 29: Collect Logs Tool

    To run the Collect Logs tool: 1 In a terminal window, become the user. root 2 Change to the following directory: /opt/novell/datasync/tools 3 Run the following command: python CollectLogs.pyc 4 Enter if you want to collect all log files. Enter if you want only the five most useful log files.

  • Page 30: Changing The Synchronizer Database Password

    3c In the section, replace the existing database password with the new password <database> between the tags. <password> 3d Save the file, then exit the text editor. configengine.xml 4 Restart the Synchronizer services: Novell Data Synchronizer Administration Guide...
  • Page 31 rcdatasync restart 5 (Conditional) If you want to change the Mobility Connector database password to match the Synchronizer database password, follow the instructions in “Changing the Mobility Connector Database Password” in “Mobility Connector Configuration” in the Groupwise Connector Installation and Configuration Guide.
  • Page 32 Novell Data Synchronizer Administration Guide...

  • Page 33: Managing Connectors

    Quick Start on the Novell Data Synchronizer Documentation Web site (http://www.novell.com/documentation/datasync_connectors1) the connector where you are adding the user profile. 3 In the Name field, specify a unique and descriptive name for the new user profile.

  • Page 34: Managing Users

    2 Click each username in the Application Username column, type the GroupWise user ID in the text box, then press Enter. 3 Click Home, then restart the connector where you modified the users’ application names. Novell Data Synchronizer Administration Guide...

  • Page 35: Adding A User To A Connector In Synchronizer Web Admin

    4.2.2 Adding a User to a Connector in Synchronizer Web Admin During installation of the Mobility Pack, you specified one LDAP user container and added users from that container. After installation, you might have configured Synchronizer Web Admin to search additional LDAP containers for users, as described in Section 3.1.1, “Searching Multiple LDAP Contexts for Users and Groups,”...

  • Page 36: Adding A User To A Connector Through An Ldap Group

    If necessary, you can limit the amount of data that is synchronized for a user. 1 In Synchronizer Web Admin, click the connector where you want to change user synchronization settings, then click Manage Users. Novell Data Synchronizer Administration Guide...

  • Page 37: Deleting A User From A Connector

    For connector-specific options, see the Quick Start on the Novell Synchronizer Connectors Documentation Web site (http://www.novell.com/documentation/datasync_connectors1) the connector where you are editing user settings. 3 Select and deselect options as needed to customize the user’s data synchronization, then click Save.

  • Page 38: Managing Groups

    Section 3.1.1, “Searching Multiple LDAP Contexts for Users and Groups,” on page In the Search Groups field, type part of the group name, then click Search. 4 Select the group to add to the connector. Novell Data Synchronizer Administration Guide...

  • Page 39: Deleting A Group

    5 (Conditional) If you want to apply a user profile to the group of users, select the profile in the Apply Profiles drop-down list. For more information, see Section 4.1, “Managing User Profiles,” on page 6 Click Add to add the group to the connector. The group is immediately added to the connector.

  • Page 40: Controlling Connector Startup

    The default filters are appropriate for typical Synchronizer systems, but they can be edited if necessary. 1 In Synchronizer Web Admin, click the connector that you want to edit the filters for. 2 (Conditional) If necessary for the selected connector, scroll down to the Filters section. Novell Data Synchronizer Administration Guide...

  • Page 41: Controlling Connector Logging

    Modifying filters requires developer-level knowledge of XSLT and is beyond the scope of the Novell Data Synchronizer Administration Guide. 5 Click Home on the menu bar to return to the main Synchronizer Web Admin page. 6 In the Actions column for the selected connector, click to stop the connector, then click to start the connector with the modified filter.

  • Page 42: Customizing Connector-Specific Configuration Settings

    Mobility Connector Installation and Configuration Guide “Salesforce.com Connector Configuration” in the Salesforce.comConnector Installation and Configuration Guide “SharePoint Connector Configuration” in the SharePoint Connector Installation and Configuration Guide “SugarCRM Connector Configuration” in the SugarCRM Connector Installation and Configuration Guide Novell Data Synchronizer Administration Guide...

  • Page 43: Securing Your Synchronizer System

    Securing Your Synchronizer System Section 5.1, “Security Administration,” on page 43 Section 5.2, “Security Policies,” on page 46 5.1 Security Administration Section 5.1.1, “Securing Communication with the LDAP Server,” on page 43 Section 5.1.2, “Securing Communication between the GroupWise Connector and the GroupWise POA,”...
  • Page 44 6 Import the certificate file into the certificate store on your mobile device. For device-specific instructions, see the Novell Data Synchronizer Mobility Connector Wiki (http://wiki.novell.com/index.php/Data_Synchronizer_Mobility_Connector). 7 (Conditional) If you are not able to access the...
  • Page 45 7b Save the file on your Linux or Windows workstation. mobility.cer 7c Set up an IMAP e-mail account on your mobile device, then e-mail the mobility.cer file from your workstation to your mobile device. Physically connect your mobile device to your workstation so that it appears as a drive on your workstation, then copy the file from your workstation to your device.

  • Page 46: Selecting A Specific Version Of Ssl

    Admin page. 7 Restart the Mobility Connector to put the desired SSL protocols into effect. 5.2 Security Policies Section 5.2.1, “Securing Your Synchronizer Data,” on page 47 Section 5.2.2, “Securing Your Synchronizer System,” on page 47 Novell Data Synchronizer Administration Guide...

  • Page 47: Securing Your Synchronizer Data

    5.2.1 Securing Your Synchronizer Data “Limiting Physical Access to Synchronizer Servers” on page 47 “Securing File System Access” on page 47 Limiting Physical Access to Synchronizer Servers Servers where Synchronizer data resides should be kept physically secure, where unauthorized persons cannot gain access to the server consoles. Securing File System Access Encrypted file systems should be used on all Synchronizer servers.
  • Page 48 Some contain very detailed information about your Synchronizer system and users. Synchronizer log files are found in the following locations: Synchronizer Component Log File Sync Engine /var/log/datasync/syncengine/engine.log Web Admin /var/log/datasync/webadmin/server.log Config Engine /var/log/datasync/configengine/configengine.log Connector Manager /var/log/datasync/syncengine/connector-manager.log Connectors /var/log/datasync/connectors/ default.pipeline1.connector_name.log default.pipeline1.connector_name-AppInterface.log Novell Data Synchronizer Administration Guide...

  • Page 49: A Troubleshooting

    Troubleshooting “Synchronizer Web Admin cannot communicate with the LDAP server” on page 49 Synchronizer Web Admin cannot communicate with the LDAP server Explanation: In order for Synchronizer Web Admin to list users to add to connectors, it must be able to communicate with your LDAP server. If Synchronizer Web Admin cannot list users, it indicates that it cannot communicate with your LDAP server.
  • Page 50 Novell Data Synchronizer Administration Guide...

This manual is also suitable for:

Data synchronizer

Table of Contents