BlackBerry Mail Store Service
The BlackBerry® Mail Store Service connects to the messaging servers in your organization's environment and retrieves the contact information that the BlackBerry Administration Service requires to search for user accounts on the messaging servers.
- synchronizes your organization's contact list to the BlackBerry Configuration Database
- updates the contact list in the BlackBerry Configuration Database every 24 hours automatically
- permits the BlackBerry Administration Service to access user account information that is stored in the mailbox or mail file on the messaging servers
- exposes an API that the BlackBerry Administration Service can use to connect to the BlackBerry Mail Store Service
- searches for contact information on behalf of the BlackBerry Administration Service
You install a BlackBerry Mail Store Service when you install a BlackBerry® Enterprise Server. The BlackBerry Mail Store Service connects to the messaging server using the same connection information that the BlackBerry Enterprise Server uses. The BlackBerry Administration Service is designed to communicate with the BlackBerry Mail Store Service using RPC.
Database tables in the BlackBerry Configuration Database that store contact information
Contact information that the BlackBerry Mail Store Service stores in the BlackBerry Configuration Database
The BlackBerry® Mail Store Service synchronizes contact information that is stored in the messaging environment to the BlackBerry Configuration Database. To compare the contact information changes that occurred between synchronization processes, the BlackBerry Mail Store Service maintains two copies of the contact information.
The BlackBerry Mail Store Service synchronizes contact information that is stored in the messaging environment to the BlackBerry Configuration Database. The contact information is stored in database properties in the BlackBerry Configuration Database.
Contact information |
Database property name |
Database property name in BlackBerry Configuration Database version 4.1 |
Description |
|---|---|---|---|
address type |
Type |
— |
This property specifies whether this is the address for a user or distribution list. |
display name |
DisplayName |
UserConfig.DisplayName |
This property specifies the display name for the user account. |
email address |
MailboxSMTP |
UserConfig.MailboxSMTPAddr |
This property specifies the email address for the user account. |
mailbox path |
MailboxKey |
UserConfig.MailboxDN |
This property specifies the unique mailbox path. |
messaging server path |
ServerName |
UserConfig.ServerDN |
This property specifies the path to the messaging server. |
How the BlackBerry Mail Store Service accesses contact information that is stored on the messaging server
In a Microsoft® Exchange environment, the BlackBerry® Mail Store Service can connect to the messaging server and search for contact information using MAPI or LDAP. By default, the BlackBerry Mail Store Service uses MAPI to search for contact information. If you configure the BlackBerry® Enterprise Server to use LDAP to search for contact information, the BlackBerry Mail Store Service can also use LDAP to search for contact information.
For more information about how the BlackBerry Enterprise Server uses LDAP, visit www.blackberry.com/support to read article KB05174.
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.