Product:
Search Type:

BlackBerry GAL lookup does not work as expected

Article ID: 3013 
Last Review: Mar,19 2008
APPLIES TO:
  • Parallels Automation (PEM)

SYMPTOMS

Lookup works by a mailbox name, but does not work by a Display Name (or vise-versa).

 

CAUSE

There are two main GAL lookup modes:

MAPI-based lookup


This is the default lookup method. It works in following way: when one
tries to perform GAL lookup from a BlackBerry device, it looks in Default Global
Address List for all matches (same way as Outlook does). Result of search - ALL
entries from the whole Exchange organization. This search works fast (average response
time is less than 1 second). Search results are shown using Display name of
matched entities.

There is one setting in a BES server's registry which could be used for hiding
one hosted company from another. Run regedit.exe, navigate to
HKLM\Software\Research In Motion\BlackBerry Enterprise Server\Agents
and create DWORD key "HostedServer" with value 0x1

This setting enables additional filtering on GAL lookup results: it shows only
those AD entities, which have the same value of "Company" attribute as the mailbox
activated on the BlackBerry device. If a mailbox has empty "Company" attribute,
it will never find anything (in other words: if a blackberry mailbox has company
"ABC Inc" set in contact info, then it will get only mailboxes/contacts/DLs
which also have company "ABC Inc" set in theirs contact info; if it has nothing
in company field, it will get nothing).
Since "Company" field is not controlled by PSA and customers could fill it by any
value, this configuration IS NOT recommended in Hosted Environment.


LDAP-query-based lookup

This method is designed specially for Hosted Environment. To enable it, open
HKLM\Software\Research In Motion\BlackBerry Enterprise Server\Agents

and create following DWORD keys:
- "HostedServer" with value 0x1
- "LDAPSearch" with value 0x1
- "LDAPALPSearch" with value 0x1
- "AllowAddressLookup" with value 0x1

and one string key:
- "LDAPCompanyField" with value "extensionAttribute10" (this attribute is controlled and prefilled by PSA)

When such setting is applied, BlackBerry GAL lookup will return only those
entities, which are created in the same subscription as the BlackBerry mailbox. But there
are following disadvantages of such solution:
1. Lookup works much slower than MAPI lookup.
2. Search is performed by a mailbox name ONLY (even not by alias/display
name/email etc).
3. Search returns the following items:
- First name/Last name if a mailbox has them set
- Mailbox name (not a display name) if there are no first/last name specified
 
NOTE: you must restart "BlackBerry Controller" service after the registry changes.
 

RESOLUTION

Select one of the modes described above, edit registry and restart BlackBerry Controller service and all BlackBerry nodes.
Keywords: blackberry

Please provide feedback on this article

Did this article help you solve your issue?
Yes
No
Partially
I do not know yet
 
Strongly Agree   Strongly Disagree
  9 8 7 6 5 4 3 2 1
The article is easy to understand
The article is accurate
Additional Comments:
*Please provide us with your email address in case we need to contact you.
*Please type the code you can see.
* - required fields