2.3 Installing and Setting Up a Data Synchronizer System

You should already have reviewed Section 2.1, Planning a Data Synchronizer System, filled out the Mobility Pack Installation Summary Sheet, and completed the tasks in Section 2.2, Preparing to Install the Mobility Pack Software.

NOTE:If you are setting up a multi-server Synchronizer system, you should have a Summary Sheet for each Synchronizer server. Each Synchronizer server is independent of other Synchronizer servers, so you can set them up in whatever order is convenient given the overall configuration of your Synchronizer system.

The following sections step you through the process of installing the Mobility Pack and configuring a Synchronizer server.

2.3.1 Obtaining the Mobility Pack ISO

  1. On Novell Downloads, click Search Patches to display Novell Patch Finder.

    IMPORTANT:The Mobility Pack software is located in the Patches list, not the Products list.

  2. Select Data Synchronizer, then click Search.

  3. Under the current release of the Mobility Pack, click the current patch.

  4. Click Proceed to Download, then follow the online instructions to download the Mobility Pack ISO to a convenient temporary directory on the Synchronizer server.

  5. Continue with Running the Mobility Pack Installation Program.

2.3.2 Running the Mobility Pack Installation Program

  1. Make sure that you know the location where the Mobility Pack ISO was downloaded on the Synchronizer server:

    novell-data-synchronizer-mobility-pack-x86_64-build_number.iso

  2. On your Linux desktop, click Computer > YaST.

  3. Enter the root password.

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

  5. On the Installed Add-On Products page, click Add, select Local ISO Image, then click Next.

    Repository fields

  6. In the Repository Name field, specify a name for the repository that will hold the Mobility Pack software, such as Mobility Pack.

  7. In the Path to ISO Image field, specify the full path name of the ISO file from Step 1, then click Next.

    IMPORTANT:Do not try to browse to the ISO file on SUSE Linux Enterprise Server 11 SP1.

  8. Accept the License Agreement, then click Next.

  9. Under Primary Functions, select Novell Data Synchronizer Mobility Pack.

    Primary Functions list

  10. Click Accept to start the installation.

  11. Click Continue to acknowledge the automatic changes to other aspects of your system that will be made as the Mobility Pack software is installed.

    Novell Data Synchronizer Mobility Pack page

    IMPORTANT:Do not click Next at this point.

  12. After the software has been installed, click Change > Mobility Pack Configuration to configure your Synchronizer system.

  13. Use the information that you have gathered on the Mobility Pack Installation Summary Sheet to provide the information that the Mobility Pack Installation program prompts you for, clicking Next to move from page to page.

    LDAP Server Settings:

    Data Synchronizer Settings:

    GroupWise Connector Settings:

    Mobility Connector Settings:

    Add Users and Groups:

    Novell Customer Center Registration:

  14. On the Mobility Pack Configuration page, click Next to save the configuration settings and set up your Synchronizer system.

    You see the Novell Data Synchronizer Mobility Pack listed on the Installed Add-on Products page.

  15. Click OK to return to the main YaST page.

If you encounter any problems during the installation, check the Mobility Pack Installation program log file for information about the problem:

/var/log/datasync/install.log

For additional assistance, see Section A.0, Mobility Pack Installation Troubleshooting.

The Mobility Pack Installation program creates the following directories and files:

/opt/novell/datasync
/etc/datasync
/etc/init.d/datasync*
/usr/sbin/rcdatasync*
/var/lib/datasync
/var/log/datasync
/var/run/datasync

IMPORTANT:Although you use the YaST Add-On Products installer to install the Mobility Pack, you must use the uninstall.sh script to uninstall it. For instructions, see Section 2.3.8, Uninstalling the Mobility Pack. If you do not uninstall the Mobility Pack correctly, you cannot install the next version.

2.3.3 Checking the Status of the Data Synchronizer Services

The Mobility Pack Installation program should start the Synchronizer services for you.

  1. In a terminal window on the Synchronizer server, become root by entering su - and the root password.

  2. Check the status of the Synchronizer services:

    rcdatasync status

    If the installation proceeded normally, the four Synchronizer services should be running.

Use the following commands as root to manually start and stop all the Synchronizer services:

rcdatasync start
rcdatasync restart
rcdatasync stop

The Synchronizer services can also be managed independently, as described in Synchronizer Services in the Mobility Pack Administration Guide.

2.3.4 Checking the Status of the Connectors

The Mobility Pack Installation program starts the GroupWise Connector and the Mobility Connector for you. Use Synchronizer Web Admin to check connector status.

  1. In a Web browser, display Synchronizer Web Admin:

    https://data_synchronizer_server:8120

    Replace data_synchronizer_server with the IP address or DNS hostname of the server where you installed the Mobility Pack.

  2. Log in as the Synchronizer administrator that you set up during installation.

    If the installation proceeded normally, the GroupWise Connector and the Mobility Connector should be running.

  3. (Conditional) If one or both connectors are not yet running:

    1. Start the GroupWise Connector first.

    2. Start the Mobility Connector second.

    3. (Conditional) If you encounter problems starting the connectors, see Section A.0, Mobility Pack Installation Troubleshooting.

      See also Working with Log Files in Synchronizer System Management in the Mobility Pack Administration Guide.

  4. Verify that the users that you selected during installation have been added to your Synchronizer system:

    1. Under Manage Access, click Users.

    2. Verify that all users have been successfully added.

    3. Click Home to return to the main Synchronizer Web Admin page.

  5. Verify that the groups that you selected during installation have been added to your Synchronizer System:

    1. Under Manage Access, click Groups.

    2. Verify that all groups have been successfully added.

    3. Click Home to return to the main Synchronizer Web Admin page.

  6. (Conditional) If any users or groups were not successfully added during installation, you can add them manually afterwards and then verify that they have been added.

    See Section A.0, Mobility Pack Installation Troubleshooting for instructions.

2.3.5 Managing Initial Device Synchronization

From your point of view as the Synchronizer administrator, initial synchronization means that GroupWise data has been synchronized from the GroupWise Connector to the Mobility Connector and is ready to be synchronized to users’ mobile devices as soon as users configure their mobile devices to connect to the Synchronizer system.

IMPORTANT:If users’ LDAP user names are not the same as their GroupWise user IDs, you must update their application names in Synchronizer Web Admin before initial device synchronization can succeed. For instructions, see Setting a User’s Application Name in User Management in the Mobility Pack Administration Guide.

Initial device synchronization provides the following synchronization of GroupWise items:

  • Contacts from all personal address books, excluding the Frequent Contacts address book

    You can change this personal address book selection setting for users after installation in Synchronizer Web Admin, as described in Customizing a User’s Synchronization Settings in User Management in the Mobility Pack Administration Guide. Users can also change their own synchronization settings on the User Options page in Synchronizer Web Admin.

    The GroupWise Address Book cannot be synchronized to mobile devices. However, users can still access individual contacts in the GroupWise Address Book, if their mobile devices can do a Global Address List (GAL) lookup. As an alternative, users can create a personal address book that is a subset of the GroupWise Address Book to synchronize to their mobile devices.

  • Calendar items (appointments and reminder notes) from the last two weeks and all future items

    Shared calendars are synchronized only for the owners of the shared calendars. If shared calendars are very important to users, shared calendar owners can post them to the Internet using the GroupWise Calendar Publishing Host, as described in Publishing Personal Calendars on the Internet in Calendar in the GroupWise 2012 Windows Client User Guide. After the owner publishes the calendar, other users can view the calendar URL in the Web browser on their mobile devices. For Calendar Publishing Host setup instructions, see Installing the GroupWise Calendar Publishing Host in the GroupWise 2012 Installation Guide.

  • Email messages in the Mailbox folder for the last three days

    If users want to receive more existing email messages on their devices, they can configure their mobile devices to request additional existing email messages.

  • Folders in the Cabinet (but not items in folders until users request them by opening folders on their mobile devices)

When you add several users to the Mobility Connector at the same time, the Mobility Connector performs initial synchronization for four users at once. When it finishes with one of the four users, it starts on another user.

In Synchronizer Web Admin, you can monitor the progress of data synchronization from GroupWise to the Mobility Connector, as described in Monitoring Mobility Connector Synchronization Status in Synchronization Monitoring and Management in the Mobility Connector Configuration Guide.

You should complete this initial synchronization before you notify users to configure their mobile devices. Initial synchronization can take a substantial amount of time, depending on the amount of data to synchronize. Occasionally, initial synchronization fails, and troubleshooting is required.

IMPORTANT:If you selected Block Incoming Devices during Mobility Pack installation, you must unblock incoming devices in Synchronizer Web Admin after all GroupWise data has synchronized to the Mobility Connector. Follow the instructions in Blocking/Unblocking Incoming Devices before Initial Synchronization in Mobility Connector Configuration in the Mobility Connector Configuration Guide.

2.3.6 Helping Mobile Device Users Understand Synchronization

To help your mobile device users get started efficiently, notify them of the following information:

IMPORTANT:These two sources of information can help eliminate the need for mobile device users to contact you with functional and device-specific questions as they start synchronizing GroupWise data to their mobile devices.

2.3.7 Testing Your Synchronizer System

  1. Test your Synchronizer system by logging into the GroupWise client and sending yourself an email message

  2. Reply to the message from your mobile device.

    If the message synchronizes to your mobile device and the reply on your mobile device synchronizes back to GroupWise, your basic Synchronizer system is up and running.

  3. To customize and expand your Synchronizer system, see Section 2.5, What’s Next.

2.3.8 Uninstalling the Mobility Pack

IMPORTANT:When you uninstall the Mobility Pack software, certificate files are also deleted. If you have obtained commercially signed certificates for use in your Synchronizer system, back them up before you uninstall the Mobility Pack software.

  1. In a terminal window on the Synchronizer server, become root by entering su - and the root password.

  2. Change to the following directory:

    /opt/novell/datasync

  3. Run the Synchronizer Uninstallation script:

    ./uninstall.sh

    The Uninstallation script stops the Synchronizer services and the PostgreSQL database server, uninstalls all Synchronizer and connector RPMs, drops the Synchronizer and Mobility Connector PostgreSQL databases, and deletes the following directories and files from the Synchronizer server: 

    /opt/novell/datasync
/etc/datasync
/etc/init.d/datasync*
/var/lib/datasync
/var/log/datasync
/var/run/datasync
/var/lib/pgsql

  4. Remove the Mobility Pack repository from the Linux server.

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

    1. In YaST, click Software > Software Repositories.

    2. Select the Mobility Pack repository, then click Delete.