Novell DATA SYNCHRONIZER ADMINISTRATION GUIDE
Administration Guide
Novell®
Data Synchronizer
novdocx (en) 16 April 2010
AUTHORIZED DOCUMENTATION
July 26, 2010
www.novell.com
Novell Data Synchronizer Administration Guide
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.
novdocx (en) 16 April 2010
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).
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.
novdocx (en) 16 April 2010
novdocx (en) 16 April 2010
4 Novell Data Synchronizer Administration Guide
Contents
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
novdocx (en) 16 April 2010
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
Contents 5
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 Connecto r 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
novdocx (en) 16 April 2010
A Troubleshooting 49
6 Novell Data Synchronizer Administration 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,” 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.
novdocx (en) 16 April 2010
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
About This Guide 7
novdocx (en) 16 April 2010
8 Novell Data Synchronizer Administration Guide
1
Managing the Synchronizer
novdocx (en) 16 April 2010
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
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
rcdatasync status
root
to check the status of the Synchronizer services:
root
user.
1
Use the following commands as
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.
root
to manually start and stop all the Synchronizer services:
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
Managing the Synchronizer Services
9
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
novdocx (en) 16 April 2010
Use the following command as
rcdatasync-syncengine status
Use the following commands as
rcdatasync-syncengine start
rcdatasync-syncengine restart
rcdatasync-syncengine stop
root
to check the status of the Sync Engine:
root
to manually start and stop the Sync Engine:
1.2.2 Managing the Config Engine
Use the following command as
rcdatasync-configengine status
Use the following commands as
rcdatasync-configengine start
rcdatasync-configengine restart
rcdatasync-configengine stop
root
to check the status of the Config Engine:
root
to manually start and stop the Config Engine:
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
rcdatasync-webadmin start
rcdatasync-webadmin restart
rcdatasync-webadmin stop
root
to manually start and stop the Web Admin service:
1.2.4 Managing the Connector Manager
Use the following command as
rcdatasync-connectors status
10 Novell Data Synchronizer Administration Guide
root
to check the status of the Connector Manager:
novdocx (en) 16 April 2010
Use the following commands as
rcdatasync-connectors start
rcdatasync-connectors restart
rcdatasync-connectors stop
root
to manually start and stop the Connector Manager:
Managing the Synchronizer Services 11
novdocx (en) 16 April 2010
12 Novell Data Synchronizer Administration Guide
2
Accessing Synchronizer Web
novdocx (en) 16 April 2010
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.
Section 2.1, “As the Synchronizer Administrator,” on page 13
Section 2.2, “As a Synchronizer User,” on page 14
See also Section 3.1, “Configuring Synchronizer Web Admin,” on page 15.
2.1 As the Synchronizer Administrator
1 Access Synchronizer Web Admin at the following URL:
https://data_synchronizer_server:8120
Replace
Synchronizer server.
data_synchronizer_server
with the IP address or DNS hostname of the
2
2 Specify the Synchronizer administrator username (such as
established during installation, then click Login.
Synchronizer system configuration and administration is performed using Synchronizer Web
Admin.
Section 3.1, “Configuring Synchronizer Web Admin,” on page 15
Section 3.2, “Configuring the Sync Engine,” on page 19
admin
) and password that were
Accessing Synchronizer Web Admin
13
Section 4.2, “Managing Users,” on page 34
Section 4.3, “Managing Groups,” on page 38
Section 4.1, “Managing User Profiles,” on page 33
Section 4.4, “Auditing User Synchronization Activity,” on page 39
Section 4.5, “Customizing General Connector Configuration Settings,” on page 39
3 Click to log out of Synchronizer Web Admin.
If you want multiple users to be able to access Synchronizer Web Admin, see Section 3.1.2, “Setting
Up Multiple Synchronizer Administrator Users,” on page 16.
2.2 As a Synchronizer User
Users can use the Synchronizer Web Admin URL to access the Data Synchronizer User Options
page by logging in with their network username and password. The options available to users
depend on the connectors to which they have been added. All users added during the Mobility Pack
installation have at least the following options:
novdocx (en) 16 April 2010
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
14 Novell Data Synchronizer Administration Guide
3
Managing Your Synchronizer
novdocx (en) 16 April 2010
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.
Section 3.1, “Configuring Synchronizer Web Admin,” on page 15
Section 3.2, “Configuring the Sync Engine,” on page 19
Section 3.3, “Monitoring the Sync Engine,” on page 23
Section 3.4, “Working with Synchronizer Log Files,” on page 25
Section 3.5, “Changing the Synchronizer Database Password,” on page 30
3.1 Configuring Synchronizer Web Admin
Synchronizer Web Admin is the management and administration tool for your Synchronizer system.
Section 3.1.1, “Searching Multiple LDAP Contexts for Users and Groups,” on page 15
Section 3.1.2, “Setting Up Multiple Synchronizer Administrator Users,” on page 16
Section 3.1.3, “Adjusting the Synchronizer Web Admin Polling Rate for Groups,” on page 17
Section 3.1.4, “Adjusting the Synchronizer Web Admin Timeout,” on page 18
3
Section 3.1.5, “Changing the Synchronizer Web Admin Port Number,” on page 18
Section 3.1.6, “Configuring Synchronizer Web Admin for a Specific Language,” on page 18
3.1.1 Searching Multiple LDAP Contexts for Users and Groups
During installation, you specify one LDAP container to search in for user information and another
container to in search for group information. After installation, you can add more containers for
Synchronizer Web Admin to search in for users and groups when you need to add users and groups
to a connector.
IMPORTANT: Subcontainers are also searched, so you do not need to add them separately.
1 In Synchronizer Web Admin, click (Manage Global Settings).
Managing Your Synchronizer System
15
Loading...