Administration Guide

Local Navigation

Configuring a Hosted BlackBerry services environment

Hosted BlackBerry® services permit you to make the BlackBerry® Enterprise Server that is in your organization's environment available to other organizations (for example, SMBs). When you include 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 Hosted BlackBerry services, you must customize the BlackBerry Enterprise Server so that BlackBerry device users can access only their organization’s contact list and restrict users from accessing the contact information of other organizations that also subscribe to the Hosted BlackBerry services.

If your organization permits customers to have limited access or read-only access to the Microsoft® Active Directory®, you can configure the BlackBerry Enterprise Server to use MAPI, LDAP, or both to retrieve recipients’ email addresses. If your organization permits customers to have full control of subtrees in Microsoft Active Directory and you configured Microsoft Active Directory for multi-tenancy, you can configure the BlackBerry Enterprise Server to limit the scope of the LDAP search.

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

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

Configuring Hosted BlackBerry services when you permit your organization’s customers limited access to Microsoft Active Directory

If you configure Hosted BlackBerry® services, you must make sure that the name of the organization that each BlackBerry device user belongs to is listed accurately and consistently in the entry for each user in Microsoft® Active Directory®. For example, if the organization’s name appears as an acronym in some entries but in expanded form in others, the BlackBerry® Enterprise Server might return inaccurate search results. If a user tries to search for another user's contact information but you did not specify the name of the organization that the other user belongs to in Microsoft Active Directory, the BlackBerry Enterprise Server does not return any search results.

You can specify the organization name in the entry for each user in an LDAP field such as the Company Name field. If you specify the organization’s name in a field other than the Company Name field, you must specify the name of the LDAP field when you configure Hosted BlackBerry services. If you do not specify an LDAP field, the BlackBerry Enterprise Server uses the Company Name field to search for contact information.

Back To Top

Configure Hosted BlackBerry services when you permit your organization’s customers limited access to Microsoft Active Directory

Before you begin: Configure the BlackBerry® Enterprise Server to retrieve 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 HostedServer.
  5. Change the value to 1.
  6. In the Windows Services, restart the BlackBerry Controller.
Back To Top

Configure the BlackBerry Enterprise Server to resolve email addresses using an LDAP field that is not the Company Name 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 name of the LDAP field that contains the name of your organization's customers as the value.
  6. In the Windows Services, restart the BlackBerry Controller.
Back To Top

Configure Hosted BlackBerry services when your organization’s customers have full control of their subtree in Microsoft Active Directory

You can configure the BlackBerry® Enterprise Server to search for contact information or calendar availability within subtrees in a Microsoft® Active Directory® that you configured for multi-tenancy. When you configure the BlackBerry Enterprise Server to search within subtrees, the BlackBerry Enterprise Server searches the Microsoft Active Directory using the organizational unit information that is included in the distinguished name of the BlackBerry device users.
Before you begin:
  • Configure the BlackBerry Enterprise Server to retrieve email addresses using LDAP.
  • Verify that the BlackBerry Enterprise Server version is version 5.0 SP2 or later.
  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 LDAPUseScopedSearch.
  5. Change the value to 1.
  6. In the Windows Services, restart the BlackBerry Controller.
Back To Top

Was this information helpful? Send us your comments.