Novell DATA SYNCHRONIZER - 07-2010 Instruction Manual

Novell®
www.novell.com
novdocx (en) 16 April 2010
AUTHORIZED DOCUMENTATION
Novell Data Synchronizer Administration Guide
Data Synchronizer
July 26, 2010
Administration Guide

novdocx (en) 16 April 2010
Legal Notices
Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and
specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose.
Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time,
without obligation to notify any person or entity of such revisions or changes.
Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims
any express or implied warranties of merchantability or fitness for any particular purpose. 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.
Any products or technical information provided under this Agreement may be subject to U.S. export controls and the
trade laws of other countries. You agree to comply with all export control regulations and to obtain any required
licenses or classification to export, re-export, or import deliverables. You agree not to export or re-export to entities
on the current U.S. export exclusion lists or to any embargoed or terrorist countries as specified in the U.S. export
laws. You agree to not use deliverables for prohibited nuclear, missile, or chemical biological weaponry end uses. See
the Novell International Trade Services Web page (http://www.novell.com/info/exports/) for more information on
exporting Novell software. Novell assumes no responsibility for your failure to obtain any necessary export
approvals.
Copyright © 2010 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied,
stored on a retrieval system, or transmitted without the express written consent of the publisher.
Novell, Inc.
404 Wyman Street, Suite 500
Waltham, MA 02451
U.S.A.
www.novell.com
Online Documentation: To access the online documentation for this and other Novell products, and to get updates,
see the Novell Documentation Web site (http://www.novell.com/documentation).

novdocx (en) 16 April 2010
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.

4Novell Data Synchronizer Administration Guide
novdocx (en) 16 April 2010

Contents 5
Contents
novdocx (en) 16 April 2010
About This Guide 7
1 Managing the Synchronizer Services 9
1.1 Managing the Data Synchronizer Services Collectively . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.2 Managing the Synchronizer Services Individually . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.2.1 Managing the Sync Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.2.2 Managing the Config Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.2.3 Managing the Web Admin Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.2.4 Managing the Connector Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2 Accessing Synchronizer Web Admin 13
2.1 As the Synchronizer Administrator. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2.2 As a Synchronizer User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3 Managing Your Synchronizer System 15
3.1 Configuring Synchronizer Web Admin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.1.1 Searching Multiple LDAP Contexts for Users and Groups . . . . . . . . . . . . . . . . . . . . 15
3.1.2 Setting Up Multiple Synchronizer Administrator Users . . . . . . . . . . . . . . . . . . . . . . . 16
3.1.3 Adjusting the Synchronizer Web Admin Polling Rate for Groups . . . . . . . . . . . . . . . 17
3.1.4 Adjusting the Synchronizer Web Admin Timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
3.1.5 Changing the Synchronizer Web Admin Port Number . . . . . . . . . . . . . . . . . . . . . . . 18
3.1.6 Configuring Synchronizer Web Admin for a Specific Language . . . . . . . . . . . . . . . . 18
3.2 Configuring the Sync Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
3.2.1 Enabling Caching for Troubleshooting Purposes . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
3.2.2 Selecting a Log Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
3.2.3 Enabling Per-User Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
3.2.4 Configuring Database Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
3.3 Monitoring the Sync Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
3.4 Working with Synchronizer Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
3.4.1 Log File Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
3.4.2 Sync Engine Log File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
3.4.3 Config Engine Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
3.4.4 Web Admin Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
3.4.5 Connector Manager Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
3.4.6 Per-User Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
3.4.7 Flatfile Connector Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
3.4.8 Collect Logs Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
3.5 Changing the Synchronizer Database Password. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
4 Managing Connectors 33
4.1 Managing User Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
4.1.1 Adding a User Profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
4.1.2 Deleting a User Profile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
4.2 Managing Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
4.2.1 Changing a User’s Application Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
4.2.2 Adding a User to a Connector in Synchronizer Web Admin . . . . . . . . . . . . . . . . . . . 35
4.2.3 Adding a User to a Connector through an LDAP Group . . . . . . . . . . . . . . . . . . . . . . 36

6Novell Data Synchronizer Administration Guide
novdocx (en) 16 April 2010
4.2.4 Customizing a User’s Synchronization Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
4.2.5 Deleting a User from a Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
4.3 Managing Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
4.3.1 Adding a Group to a Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
4.3.2 Deleting a Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
4.4 Auditing User Synchronization Activity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
4.5 Customizing General Connector Configuration Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
4.5.1 Controlling Connector Startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
4.5.2 Configuring Connector Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
4.5.3 Controlling Connector Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
4.6 Customizing Connector-Specific Configuration Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
5 Securing Your Synchronizer System 43
5.1 Security Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
5.1.1 Securing Communication with the LDAP Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
5.1.2 Securing Communication between the GroupWise Connector and the GroupWise
POA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
5.1.3 Securing Communication between the Mobility Connector and Mobile Devices . . . . 43
5.1.4 Selecting a Specific Version of SSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
5.2 Security Policies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
5.2.1 Securing Your Synchronizer Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
5.2.2 Securing Your Synchronizer System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
A Troubleshooting 49

About This Guide 7
novdocx (en) 16 April 2010
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,” on page 15
Chapter 4, “Managing Connectors,” on page 33
Chapter 5, “Securing Your Synchronizer System,” on page 43
Appendix A, “Troubleshooting,” on page 49
Audience
This guide is intended for network administrators who manage a Data Synchronizer system.
Feedback
We want to hear your comments and suggestions about this manual and the other documentation
included with this product. Please use the User Comment feature at the bottom of each page of the
online documentation, or go to www.novell.com/documentation/feedback.html and enter your
comments there.
Additional Documentation
For additional Data Synchronizer documentation, see the following documentation provided at the
Novell Data Synchronizer Documentation Web site (http://www.novell.com/documentation/
datasynchronizer1).
Novell Data Synchronizer Mobility Pack Readme
Novell Data Synchronizer installation and administration guides
For additional Data Synchronizer connector documentation, see the following documentation
provided at the Novell Data Synchronizer Connectors Documentation Web site (http://
www.novell.com/documentation/datasync_connectors1).
Connector Readmes
Connector Quick Starts
Connector installation and configuration guides

8Novell Data Synchronizer Administration Guide
novdocx (en) 16 April 2010

Managing the Synchronizer Services
1
9
novdocx (en) 16 April 2010
1
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.
IMPORTANT: The Synchronizer services must always run as the Linux root user.
Section 1.1, “Managing the Data Synchronizer Services Collectively,” on page 9
Section 1.2, “Managing the Synchronizer Services Individually,” on page 9
1.1 Managing the Data Synchronizer Services
Collectively
Use the following command as root to check the status of the Synchronizer services:
rcdatasync status
Use the following commands as root to manually start and stop all the Synchronizer services:
rcdatasync start
rcdatasync restart
rcdatasync stop
IMPORTANT: After restarting the Synchronizer services, you must manually restart all connectors
in Synchronizer Web Admin. Always start the GroupWise Connector first before any other
connectors.
1.2 Managing the Synchronizer Services
Individually
If you manage the Synchronizer services individually, they should be started in the following order:
Config Engine
Sync Engine
Connector Manager
The Synchronizer services should be stopped in the following order:
Connector Manager

10 Novell Data Synchronizer Administration Guide
novdocx (en) 16 April 2010
Sync Engine
Config Engine
You can start and stop Web Admin at any time, as long as the other Synchronizer services are
running.
Each Synchronizer service has its own set of commands:
Section 1.2.1, “Managing the Sync Engine,” on page 10
Section 1.2.2, “Managing the Config Engine,” on page 10
Section 1.2.3, “Managing the Web Admin Service,” on page 10
Section 1.2.4, “Managing the Connector Manager,” on page 10
1.2.1 Managing the Sync Engine
Use the following command as root to check the status of the Sync Engine:
rcdatasync-syncengine status
Use the following commands as root to manually start and stop the Sync Engine:
rcdatasync-syncengine start
rcdatasync-syncengine restart
rcdatasync-syncengine stop
1.2.2 Managing the Config Engine
Use the following command as root to check the status of the Config Engine:
rcdatasync-configengine status
Use the following commands as root to manually start and stop the Config Engine:
rcdatasync-configengine start
rcdatasync-configengine restart
rcdatasync-configengine stop
1.2.3 Managing the Web Admin Service
Use the following command as root to check the status of the Web Admin service:
rcdatasync-webadmin status
Use the following commands as root to manually start and stop the Web Admin service:
rcdatasync-webadmin start
rcdatasync-webadmin restart
rcdatasync-webadmin stop
1.2.4 Managing the Connector Manager
Use the following command as root to check the status of the Connector Manager:
rcdatasync-connectors status