Novell Data Synchronizer 1.2


August 24, 2011

1.0 Overview

Novell Data Synchronizer and the GroupWise Connector provide the foundation for synchronizing data between GroupWise and other collaboration solutions such as Novell Vibe OnPrem,, SharePoint, and SugarCRM.

NOTE:This configuration does not include synchronization with mobile devices.

Updates to Data Synchronizer are released regularly, in conjunction with major updates to the Data Synchronizer Mobility Pack. This ensures that the core components (Data Synchronizer and the GroupWise Connector) are the same for the major releases of the two interrelated products. The Mobility Pack releases minor updates between major updates. Data Synchronizer does not release minor updates.

For the list of the bugs that have been fixed since Data Synchronizer 1.1.1, see Section 8.0, Data Synchronizer 1.2 Bug Fixes.

2.0 Data Synchronizer System Requirements

See Data Synchronizer System Requirements in the Novell Data Synchronizer Installation Guide.

3.0 Installation Instructions for Creating a New Synchronizer System

  1. Make sure that the Linux server where you plan to install Data Synchronizer meets the system requirements.

  2. If a Web server is currently running on the Synchronizer server, stop it, and preferably disable it.

  3. Download the Data Synchronizer 1.2 ISO (novell-data-synchronizer-x86_64-build_number.iso) as part of your connector package.

  4. Use YaST to install the Data Synchronizer 1.2 ISO:

    1. Under Groups, click Software, then click Add-On Products.

    2. Install Data Synchronizer as an add-on product.

      Complete installation instructions are available in Installing and Setting Up a Data Synchronizer System in the Novell Data Synchronizer Installation Guide.

NOTE:If you need to uninstall and reinstall Data Synchronizer, follow the instructions in Uninstalling Data Synchronizer in the Data Synchronizer Installation. See also Section 5.9, Thorough Uninstallation Required.

4.0 Installation Instructions for Updating an Existing Synchronizer System

  1. Download the Data Synchronizer 1.2 ISO (novell-data-synchronizer-x86_64-build_number.iso) as part of your updated connector package.

  2. In YaST, run Patch CD Update to install the updated Data Synchronizer and GroupWise Connector components to your Synchronizer system.

  3. Install the updated connector RPM.

  4. Restart the Synchronizer services.

    For more detailed instructions, see Data Synchronizer System Update in the Novell Data Synchronizer Installation Guide.

    See also the Readme and the Installation and Configuration Guide for your particular connector.

5.0 Installation Issues

5.1 Misleading Prompt in the Update Script

When you run the Data Synchronizer Update script (, it asks if you want to update “Data Synchronizer Mobility Pack.” The prompt should read simply “Data Synchronizer.” Enter yes to update your Data Synchronizer system.

5.2 Synchronizer System Configuration

A Synchronizer system can communicate with only one GroupWise system. Creating multiple connectors of the same type on a single Synchronizer server is not supported. For more details, see Synchronizer System Configuration in Data Synchronizer Product Overview in the Novell Data Synchronizer Installation Guide.

5.3 Virtualization Support

Data Synchronizer is supported in a virtual environment, but performance might be somewhat slower when virtualized. Individual results might vary.

5.4 GroupWise Trusted Application Creation

Before you run the Data Synchronizer Installation program, you must create a GroupWise trusted application so that the GroupWise Connector can log in to a GroupWise Post Office Agent (POA) in order to access GroupWise mailboxes without needing personal user passwords. When you set up the GroupWise Connector as a trusted application, you need to fill in only three fields in the Create Trusted Application dialog box in ConsoleOne: Name, Location for Key File, and Name of Key File. Do not fill in any other fields. If you fill in additional fields, the trusted application does not work correctly with the GroupWise Connector.

5.5 YaST Proposal Error

When you run the Data Synchronizer Installation program in YaST, you might see the following error:

The proposal contains an error that must be resolved before continuing

This error indicates that you clicked Next without providing the configuration information for your Synchronizer system. Instead of clicking Next, click Change > Data Synchronizer Configuration, then provide the configuration as prompted. After you provide the configuration information, click Next.

5.6 YaST Hangs When Browsing Files in the Installation Program

When you run the Data Synchronizer Installation program on SUSE Linux Enterprise Server (SLES) 11 SP1, the Installation program might hang if you browse to and select a file. This can occur if you try to browse to and select any of the following files during installation:

  • Data Synchronizer ISO file

  • GroupWise trusted application key file

As a workaround, type the full path and filename for the file instead of browsing to it.

5.7 Required Python Package Version

If you already have Python packages installed on the server where you are installing Data Synchronizer, the Installation program needs to update the existing packages, rather than install new packages. This does not happen by default.

When you run the Installation program, you are prompted if packages need to be updated. Enter 1 for Solution 1 to update each package.

5.8 Data Synchronizer Installation Program Fails on a 32-Bit/x86 Processor

Data Synchronizer must be installed on a server with a 64-bit/x86 processor. If you try to install it on a server with a 32-bit/x86 processor, the Data Synchronizer Installation program does not detect the problem. It tries to run, but it cannot run correctly.

If the behavior of the Installation program does not match the installation instructions provided in the Novell Data Synchronizer Installation Guide, make sure that you are installing Data Synchronizer on a server that meets the documented system requirements.

There are currently no plans to make Data Synchronizer available in a 32-bit version.

5.9 Thorough Uninstallation Required

The standard uninstallation procedures provided in Uninstalling Data Synchronizer in the Novell Data Synchronizer Installation Guide occasionally fail to completely uninstall Data Synchronizer because of various server-specific issues. When the Data Synchronizer software is not completely uninstalled, the next installation does not proceed normally. For example, you might encounter problems configuring LDAP access during installation. To ensure that the Data Synchronizer software has been completely uninstalled, perform the following checks:

  • In YaST, click Software > Add-On Products. Data Synchronizer should not be listed. If it is still listed, select it, then click Delete.

  • In YaST, click Software > Software Repositories. The Data Synchronizer repository should not be listed. If it is still listed, select it, then click Delete.

    IMPORTANT:If you do not remove the existing Data Synchronizer repository, you cannot successfully install the next version of the Data Synchronizer software.

  • In YaST, click Software > Software Management. In the Filters drop-down list, select Patterns. Under the Primary Functions heading, Data Synchronizer should not be listed. If it is still listed, select it. Review the Packages list for any packages that were not successfully uninstalled and uninstall them.

  • In YaST, click Software > Software Management. In the Search field, specify datasync, then click Search. The Packages list should be empty. If any Data Synchronizer packages are still listed, uninstall them.

  • Log in as root in a terminal window, then check for Data Synchronizer RPMs:

    rpm -qa | grep datasync

    If any Data Synchronizer RPMs are still installed, uninstall them:

    rpm -e rpm_name.rpm
  • Make sure that none of the following directories still exist on your server:


    If any of these directories still exist, delete them.

  • After performing all these checks, reboot the Synchronizer server.

  • Remove the Synchronizer certificate from any workstations where you have run Synchronizer Web Admin. For example, in Firefox, click Tools > Options > Advanced > Encryption > View Certificates. Select the certificate named DataSync Web Admin, then click Delete.

6.0 Data Synchronizer Issues

6.1 Moved Users in eDirectory Groups

If you add a user to a connector as part of an eDirectory group, and if you subsequently move the user from one eDirectory container to another, the user is removed from the connector because the user’s context has changed. There is currently no mechanism for the connector to detect this change.

As a workaround:

  1. Delete the user from the eDirectory group.

  2. Wait until the user has been removed from all connectors.

  3. Add the user back to the eDirectory group, so that the user’s new context is available to the connectors.

6.2 Users and Groups Not Displayed Correctly in Synchronizer Web Admin

When you add or delete a large number of users or groups in Synchronizer Web Admin, the Manage Users page or the Manage Groups page might not correctly display the presence or absence of the users or groups. Refresh the page in your browser to correctly display the users or groups.

6.3 Synchronizer Web Admin Responsiveness

After you add a large number of users to the GroupWise Connector, the responsiveness of Synchronizer Web Admin might diminish each time you restart the GroupWise Connector. For example, it might take longer to log in to Synchronizer Web Admin, or you might not be able to navigate easily between pages while the GroupWise Connector is starting. This occurs because the GroupWise Connector verifies all of the users each time it starts. After the user verification process is completed, Synchronizer Web Admin behaves normally.

6.4 Connector Configuration Settings

On the Connector Configuration Settings pages for the GroupWise Connector, if you set and save general connector settings, then set and save connector-specific settings, the general connector settings are not actually saved. However, if you set and save connector-specific settings, then set and save general connector settings, all changed settings are saved as expected.

7.0 Connector Issues

7.1 General Connector Issues

7.1.1 User Deletion

In order to delete users from a connector, the connector must be running. If the connector is not running, some user event data is not properly deleted. When the connector starts again, the administrator does not need to take any additional action.

7.1.2 Connector Does Not Stop

When you stop a connector in Synchronizer Web Admin and then start it again immediately, the status might indefinitely remain as Starting. This can happen because the connector did not completely stop before you tried to restart it. The connector might have been completing a polling cycle before shutting down, even though Synchronizer Web Admin displayed the status as Stopped. When you try to start a connector that is still shutting down, it cannot start normally.

To restart the connector when this situation has occurred:

  1. Restart the Connector Manager on the command line:

    rcdatasync-connectors restart

    This should change the connector status in Synchronizer Web Admin from Starting to Stopped.

  2. Start the connector in Synchronizer Web Admin.

  3. Start any other connectors that stopped as a result of restarting the Connector Manager.

    Some connectors restart automatically when the Connector Manager restarts.

If this problem occurs repeatedly, wait a few seconds between the time when you stop the connector and when you start it again to allow the connector to shut down completely before restarting.

7.1.3 Multiple Instances of the Same Connector

Synchronizer Web Admin allows you to manually create multiple instances of the same connector. However, this configuration is not currently supported.

If you have more users than a single connector can service, you can install one or more additional instances of Data Synchronizer on additional servers until all users are being successfully serviced. Users can be organized on multiple instances of Data Synchronizer based on various schemes such as the location of the users, the location of the synchronized applications, or the desired quality of service (executives vs. regular employees, for example). Instances of Data Synchronizer do not need to mirror the structure of your GroupWise system.

7.2 Connector-Specific Issues

Refer to the Readme for each connector on the Novell Data Synchronizer Connectors Documentation Web site.

8.0 Data Synchronizer 1.2 Bug Fixes

For the list of the bugs that have been fixed since Data Synchronizer 1.1.1, see the Novell Data Synchronizer 1.2 Bug Fix List.

If you have access to Novell Bugzilla, you can look up the bug numbers for more information about each bug.

9.0 Documentation

Data Synchronizer documentation is available at the Novell Data Synchronizer Documentation Web site:

  • Data Synchronizer Readme

  • Data Synchronizer Installation Guide

  • Data Synchronizer System Administration Guide

Data Synchronizer connector documentation is available at the Novell Data Synchronizer Connector Documentation Web site

  • Connector Readmes

  • Connector Quick Starts

  • Connector installation and configuration guides

In addition to the Data Synchronizer product documentation, the following resources provide additional information about Data Synchronizer: