User manual NOVELL DATA SYNCHRONIZER MOBILITY PACK INSTALLATION GUIDE 07-2010

[. . . ] novdocx (en) 16 April 2010 AUTHORIZED DOCUMENTATION Installation Guide Novell® Public Beta July 14, 2010 Data Synchronizer Mobility Pack www. novell. com Novell Data Synchronizer Mobility Pack Installation 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. 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. 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. [. . . ] It is much easier to add multiple users to an LDAP group than it is to select them individually in the Mobility Pack Installation program. IMPORTANT: LDAP groups must include at least one user in order to be added to your Synchronizer system during installation. Setting application names If users' LDAP usernames are not the same as their GroupWise user IDs, you must set users' application names in Synchronizer Web Admin to map from LDAP usernames to GroupWise user IDs. This must be done regardless of whether you add the users during installation or after installation, and it applies to users who are added by being members of LDAP groups. To plan ahead for this process, review "Changing a User's Application Name" in "Managing Connectors" in the Novell Data Synchronizer Administration Guide. Single-server If you are planning a single-server Synchronizer system, you might already have or want installation to create LDAP groups based on departmental membership, organizational roles, geographic locations, or even the need to participate in data synchronization. For example, if only a few users have mobile devices and they are scattered throughout a number of existing LDAP groups, you might create a new LDAP group named MobileDeviceUsers so that you can easily add them as a group to your Synchronizer system. Multi-server installation If you are planning a multi-server Synchronizer system, you might already have or want to create LDAP groups that would be set up on different Synchronizer servers. You might be planning several Synchronizer servers based on geographic location, so having an LDAP group of users for each geographic location would facilitate adding users to connectors. If you want a separate Synchronizer server for executives, creating an LDAP group of executives would allow you to add them as a group, rather than selecting each executive individually. If you have a very large number of groups with no particular distinguishing characteristics, you might want to create LDAP groups based on the first letter of users' last names or usernames (for example, A-I, J-R, and S-Z). 18 Novell Data Synchronizer Mobility Pack Installation Guide novdocx (en) 16 April 2010 Regardless of the variables involved in adding users to your Synchronizer system, advanced planning can make the process of adding users easier and faster. DATA SYNCHRONIZER MOBILITY PACK INSTALLATION SUMMARY SHEET Under Add Groups, specify LDAP groups of users to add to your Synchronizer system. If the LDAP groups do not already exist, create them in your LDAP directory before you run the Mobility Pack Installation program. Under Add Users, specify any individual users that are not part of LDAP groups that you want to add to your Synchronizer system. IMPORTANT: Be sure to add yourself to the Synchronizer system for testing purposes. 2. 1. 4 Gathering GroupWise System Information In order to configure the GroupWise Connector as you run the Mobility Pack Installation program, you need to gather certain information about the GroupWise system where users want to synchronize data. "GroupWise Trusted Application" on page 19 "GroupWise Post Office Agent" on page 20 "GroupWise Address Book User" on page 21 GroupWise Trusted Application A GroupWise trusted application can log into a GroupWise Post Office Agent (POA) in order to access GroupWise mailboxes without needing personal user passwords. The GroupWise Connector requires such mailbox access in order to synchronize GroupWise data with mobile devices and with other applications. In addition, the Mobility Connector uses trusted application authentication through the GroupWise Connector in order to access the GroupWise Address Book to provide contact lookup beyond the contacts that are downloaded to users' devices from personal address books. Before you install the Mobility Pack, you must use ConsoleOne to configure the GroupWise Connector as a GroupWise trusted application. You might name the trusted application MobilityPack or GroupWiseConnector. A trusted application uses a key that consists of a long string of letters and numbers to provide authentication to the GroupWise POA. ConsoleOne creates the key in a file in a specified location that is accessible to ConsoleOne. Follow the instructions in "Creating a Trusted Application and Key" in "System" in the GroupWise 8 Administration Guide to set up a trusted application and obtain a trusted application key. When setting up the GroupWise Connector as a trusted application, you only need to fill in three fields in the Create Trusted Application dialog box in ConsoleOne: Name Location for Key File Name of Key File Do not fill in any other fields. Mobility Pack Installation 19 novdocx (en) 16 April 2010 IMPORTANT: In order for the Mobility Pack Installation program to access the key file, you might need to copy it to a convenient location on the Synchronizer server. The Installation program automatically transfers the trusted application key from the key file into the configuration of the GroupWise Connector. DATA SYNCHRONIZER MOBILITY PACK INSTALLATION SUMMARY SHEET Under GroupWise Trusted Application, specify the name of the trusted application that you created in ConsoleOne and the location where the Mobility Pack Installation program can access the trusted application key file. GroupWise Post Office Agent The GroupWise Connector accesses your GroupWise system by communicating with a Post Office Agent (POA). The selected POA must be configured for SOAP, as described in "Supporting SOAP Clients" in "Post Office Agent" in the GroupWise 8 Administration Guide. [. . . ] 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 Chapter 3, "What's Next, " on page 31. 2. 2. 7 Uninstalling the Mobility Pack IMPORTANT: When you uninstall the Data Synchronizer software, certificate files are also deleted. If you have obtained commercially signed certificates for use in your Synchronizer system, back them up before uninstall the Data Synchronizer software. 1 In a terminal window on the Synchronizer server, become root by entering su - and the root password. [. . . ]