Administration Guide

Local Navigation

Configuring the BlackBerry Mail Store Service instance that updates the contact list

The BlackBerry® Configuration Database contains your organization's contact list and a list of BlackBerry® Enterprise Server instances. By default, the BlackBerry Mail Store Service instance that you installed with the first BlackBerry Enterprise Server instance that appears in the list updates the contact list. If you prevent the BlackBerry Mail Store Service that you installed with the first BlackBerry Enterprise Server instance from updating the contact list, the next available BlackBerry Mail Store Service instance in the list updates the contact list.

By default, if you install multiple BlackBerry Mail Store Service instances, each instance can update the contact list in the BlackBerry Configuration Database. The first BlackBerry Mail Store Service instance that updates the contact list prevents the other instances from also updating the contact list. Each BlackBerry Mail Store Service instance searches for time stamp information in the BlackBerry Configuration Database to determine if another BlackBerry Mail Store Service instance is updating the contact list already before it starts to update the contact list.

You must verify that at least one BlackBerry Mail Store Service instance can update the contact list in the BlackBerry Configuration Database so that the BlackBerry Administration Service can access the latest contact list information when you create and manage user accounts. If you prevent all of the BlackBerry Mail Store Service instances from updating the contact list, the BlackBerry Configuration Database might not contain the contact information for all user accounts on your organization's messaging server.

If the BlackBerry Configuration Database does not contain contact information for a user account, you cannot create the user account by searching for the contact information in the BlackBerry Administration Service. You can only create the user account if you use the Add from company directory option in the BlackBerry Administration Service. The Add from company directory option permits the BlackBerry Mail Store Service to search the contact information that is stored in the messaging environment so that you can create the user account even if the BlackBerry Configuration Database does not contain the contact information for the user account.

Configure the BlackBerry Mail Store Service instance that updates the contact list

  1. Copy the BlackBerry® Enterprise Server installation media to a computer that hosts a BlackBerry Enterprise Server instance.
  2. Extract the contents to a folder on the computer.
  3. At the command prompt, navigate to <extracted_folder>\tools.
  4. Perform one of the following actions:
    • To permit a BlackBerry Mail Store Service instance to update the contact list, type Traittool -host <instance_name> -trait MailstoreAddressRefreshEnabled -set true, where <instance_name> is the name of the BlackBerry Enterprise Server instance that you installed the BlackBerry Mail Store Service with.
    • To prevent a BlackBerry Mail Store Service instance from updating the contact list, type Traittool -host <instance_name> -trait MailstoreAddressRefreshEnabled -set false, where <instance_name> is the name of the BlackBerry Enterprise Server instance that you installed the BlackBerry Mail Store Service with.
  5. Repeat step 4 for each BlackBerry Mail Store Service instance.

Was this information helpful? Send us your comments.