IBM DB2 Everyplace Sync Server Administration Guide Version 7 Release 2 Modification 1


Defining mobile users to the Sync Server

A user is a user who needs to synchronize data with an enterprise server. Users form groups, collections of users who have similar needs for data access and synchronization. Organizing users into groups helps you minimize the effort required to deliver synchronization services to many users in a uniform way.

You can define users to the Sync Server by creating users in the Mobile Devices Administration Center (see Creating users in the Mobile Devices Administration Center) or importing existing definitions directly into the administration control database (see Importing user definitions from another source).

Creating users in the Mobile Devices Administration Center

To create a user:

  1. Open the Create User notebook.
  2. Identify the user.
  3. Assign the user to a group.
  4. Optional: Provide a password for the user.
  5. Optional: Filter the source data available to the user. The data filter that you specify for the user overrides the filter that you set for the group.
  6. Click OK.

Each step is explained further in this section.

After you create the user, the user must register his or her device as explained in Registering the user's device.

Identifying the user

For authentication purposes, the Sync Server must be able to uniquely identify each user by name.

To name and describe a user, provide information in the following fields on the Identification page of the Create User notebook:

Name
Provide a descriptive, unique name for the user from 1 to 18 characters. The name serves as the user's user ID for accessing the DB2 Everyplace Sync Server on the mid-tier system. Names are case-sensitive.

Description
Type up to 128 characters of text that describes this user.

Assigning the user to a group

To access and synchronize data on a source system, the user must belong to a group. If there is no group assignment, the user can register the device (as explained in Registering the user's device), but all other data synchronization fails. A user can belong to only one group at a time.

To assign a user to a group:

  1. On the Identification page of the Create User notebook, type the name of the group in the Group field. To select a group from a list, click the Figure dsys013 not displayed. push button.

    If no groups are displayed in the list, you will need to create a group. You can click Create to open the Create Group notebook now, or you can create a group later and associate the group with a user later. See Creating a data synchronization group for more information on creating a group.

You can also assign users to a group from the Group notebook. For more information, see Assigning users to the group.

Setting the user's password

For enhanced security and especially if encryption is enabled, use a long password, that includes non-alpha characters. Passwords are case-sensitive.

To assign a password to a user:

  1. On the Authentications page of the Create User notebook, type the password that this user will use to gain access to the DB2 Everyplace Sync Server.
  2. Type the password again in the Verify password field.

Filtering the data available to the user

You can set a data filter value for individual users that overrides the value of the data filter that you set for the group.

To set a user-specific data filter:

  1. Ensure that the group filter specifies a DB2 variable for the parameter name instead of a hard-coded value. (For more information about group data filters, see Filtering the data available to the group.)
  2. Go to the Data Filter page of the Create User notebook. The filters displayed here are those that you set for the group to which the user is assigned. Select the filter whose value you want to change.
  3. Click Change. The Change Data Filter window opens.
  4. In the User override field, type the value of the parameter for this user.
  5. Click OK.

Registering the user's device

Either you or the user can register the device; however, after registration you still need to perform some configuration steps for synchronization to work properly, so you might choose to do this step yourself.

To register the device:

  1. Start the device.
  2. Tap the APPLICATIONS icon to display all available subscription sets.
  3. Tap the IBM Sync icon to start the synchronization client software.
  4. In the main IBM Sync window, tap Synchronize.
  5. When prompted for a user ID and password, enter the user ID and password of the user who will be using the device. Registration proceeds according to whether the user ID and password exist in the administration control database:
  6. Tap OK.

If the user has already been created in the Mobile Devices Administration Center and assigned to an enabled group, the Sync Server automatically enables the user for synchronization after registration.

If a user switches devices, the new device must be registered. When the user begins using a new device, you must:

  1. In the Mobile Devices Administration Center, open the Users folder.
  2. In the contents pane, right-click the user whose device registration you want to delete.
  3. Select Reset. The system displays a confirmation window listing all objects that you selected for deletion.

    This will delete the old device registration information from the control database so that the association with the new device can be registered.

Importing user definitions from another source

If you already have user names, passwords, and descriptions defined in another program, you can import this information directly into the administration control database and bypass creating these users in the Mobile Devices Administration Center. The user import tool that allows you to do this accepts any comma-delimited file exported in DB2 Universal Database DEL format.

To use the tool to import multiple users, go to an MS-DOS command line and enter the following command. You can use one or more of the optional parameters in parentheses. Replace filename with the fully-qualified name of the comma-delimited file containing the users to import.

DSYImportUsers.bat (-commit) (-exception) (-fail) (-group group_name) filename

The optional parameters are:

-commit
Commit each successful insert and do not rollback if an error occurs

-exception
Display exceptions.

-fail
Display failed entries only.

-group group_name
Assign users in the file to the group specified. Make sure the group exists before you use this parameter.

The required parameter is:

filename
Specifies the file name of the comma-delimited input file.

The format for the comma-deliminated input file is: {user name},{password -optional},{description -- optional}

For example, a file formatted with no passwords would look like this:

jay,,Jay Smith Mobile Sales NC
mike,,Michael Doe Mobile Sales CA
...


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]