Installation and Configuration Guide

Local Navigation

Configuring a Hosted BlackBerry services environment

Hosted BlackBerry® services permit you to make the BlackBerry® Enterprise Server available to other organizations (for example, small or medium-sized businesses). When you use the Hosted BlackBerry services in your organization's environment, one or more organizations can subscribe to your organization's BlackBerry Enterprise Server.

If your organization hosts a BlackBerry Enterprise Server and multiple organizations subscribe to the Hosted BlackBerry services, you must customize the contact lookup feature so that users can access their organization’s contact list and download the information to their BlackBerry devices. When you customize how users search for email addresses, you restrict the users from accessing the contact information of another organization that also subscribes to the Hosted BlackBerry service.

You must make sure that the organization name for each user is listed accurately and consistently in the contact list. For example, if the organization name appears as an acronym in some entries but in full in others, the address search results might be inaccurate. If a user tries to look up contact information for a user whose organization name is not specified, no search results appear.

When users try to look up contact information, they must type the entire email address.

To configure Hosted BlackBerry services, you must use a different licensing model for the BlackBerry Enterprise Server.

If you do not want to use the contact lookup feature, you can configure the BlackBerry Enterprise Server to look up email addresses using LDAP. With LDAP, users can perform more comprehensive searches for email addresses in the contact list. The BlackBerry Enterprise Server does not search for a user’s organization name in the contact list. Instead, it uses an LDAP field as a filter for retrieving email addresses with a specific organization name. You can select an existing LDAP field or you can create a custom LDAP field.

For more information about Hosted BlackBerry services, see the BlackBerry Enterprise Server Planning Guide.

Configure how users search for email addresses in a Hosted BlackBerry services environment

  1. On the computer that hosts the BlackBerry® Enterprise Server, click Start > Run.
  2. Type regedit. Click OK.
  3. Perform one of the following actions:
    • If you are running a 32-bit version of Windows®, navigate to HKEY_LOCAL_MACHINE\Software\Research In Motion\BlackBerry Enterprise Server\Agents.
    • If you are running a 64-bit version of Windows, navigate to HKEY_LOCAL_MACHINE\Software\WOW6432Node\Research In Motion\BlackBerry Enterprise Server\Agents.
  4. If it exists, verify that the DWORD value for AllowAddressLookup is 1.
  5. Create a DWORD value named HostedServer.
  6. Change the value to 1.
  7. In the Windows® Services, restart the BlackBerry Controller.

Configure the BlackBerry Enterprise Server to search for email addresses using LDAP

  1. On the computer that hosts the BlackBerry® Enterprise Server, click Start > Run.
  2. Type regedit. Click OK.
  3. Perform one of the following actions:
    • If you are running a 32-bit version of Windows®, navigate to HKEY_LOCAL_MACHINE\Software\Research In Motion\BlackBerry Enterprise Server\Agents.
    • If you are running a 64-bit version of Windows, navigate to HKEY_LOCAL_MACHINE\Software\WOW6432Node\Research In Motion\BlackBerry Enterprise Server\Agents.
  4. Create a DWORD value named LDAPSearch.
  5. Change the value to 1.
  6. Create a DWORD value named LDAPALPSearch.
  7. Change the value to 1.
  8. In the Windows® Services, restart the BlackBerry Controller.

Configure the BlackBerry Enterprise Server to search for email addresses using a custom LDAP field

  1. On the computer that hosts the BlackBerry® Enterprise Server, click Start > Run.
  2. Type regedit. Click OK.
  3. Perform one of the following actions:
    • If you are running a 32-bit version of Windows®, navigate to HKEY_LOCAL_MACHINE\Software\Research In Motion\BlackBerry Enterprise Server\Agents.
    • If you are running a 64-bit version of Windows, navigate to HKEY_LOCAL_MACHINE\Software\WOW6432Node\Research In Motion\BlackBerry Enterprise Server\Agents.
  4. Create a string value named LDAPCompanyField.
  5. Specify the custom LDAP field that you want to use as the organization name field as the value.
  6. In the Windows® Services, restart the BlackBerry Controller.

Was this information helpful? Send us your comments.