How to recreate the BlackBerry Enterprise Server MAPI profile

Article ID: KB10285

Type: Support Content

Last Modified: 02-14-2014

 

Product(s) Affected:

  • BlackBerry Enterprise Server for Microsoft Exchange
CollapseEnvironment
  • BlackBerry Enterprise Server 2.1 to 5.0 SP4 for Microsoft Exchange
CollapseOverview

The Messaging Application Programming Interface (MAPI) profile is used to facilitate data communication between the Microsoft Outlook email application and the Microsoft Exchange Server. Within the BlackBerry Solution Services, MAPI is used by the BlackBerry Enterprise Server to communicate with the Microsoft Exchange Server. In rare cases, it may be necessary to recreate the MAPI profile in order for the server to operate effectively.

CollapseResolution

To re-create the MAPI profile on the BlackBerry Enterprise Server, complete the following steps:

  1. Log in to the BlackBerry Enterprise Server using the service account.
  2. Stop the BlackBerry Enterprise Server services, and close the BlackBerry Manager if it is running.
  3. Open the Registry Editor and go to HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\Windows Messaging Subsystem\Profiles\.
  4. Right-click the Profiles folder, then click Export. Give the backup file a name and then save.
  5. Delete the Profiles folder.
  6. Close the Registry Editor.
  7. Create a new MAPI profile by following the steps for the appropriate version of the BlackBerry Enterprise Server, found below.
  8. Start the BlackBerry Enterprise Server services.

Important: Restarting certain BlackBerry Enterprise Server services delays email message delivery to BlackBerry smartphones. For more information, see KB04789.

BlackBerry Enterprise Server 5.0 running in High Availability (HA) pair only follow these steps:

  1. Re-create the MAPI profile on the Standby server first, using steps 1 to 8 above.
  2. Manually fail over the Primary to the Standby. For more information, see KB17408.
  3. Re-create the MAPI profile on the original Primary server using steps 1 to 8 above.
  4. Manually fail back to the original Primary server. For more information, see KB17408.
  5. To create a new MAPI profile, perform the steps for the appropriate version of the BlackBerry Enterprise Server.

BlackBerry Enterprise Server 5.0 follow these steps:

  1. Go to Start > Programs > BlackBerry Enterprise Server > BlackBerry Server Configuration.
  2. On the BlackBerry Server tab, click Edit MAPI Profile.
  3. Type the name of the Microsoft Exchange Server and the BlackBerry Enterprise Server service account mailbox name.
  4. Click Check Name.
  5. Click Apply > OK.

BlackBerry Enterprise Server 4.1 follow these steps:

  1. Go to Start > Programs > BlackBerry Enterprise Server > BlackBerry Server Configuration.
  2. On the BlackBerry Server tab, click Edit MAPI Profile.
  3. Type the name of the Microsoft Exchange Server and the BlackBerry Enterprise Server service account mailbox name in the appropriate fields.
  4. Click Check Name. The service account name will now be underlined.
  5. Click Apply > OK.
  6. To create the BlackBerry Manager profile, click Start.
  7. Click BlackBerry Enterprise Server.
  8. Click Edit MAPI Profile.
  9. Type the name of the Microsoft Exchange Server and the BlackBerry Enterprise Server service account mailbox name in the appropriate fields.
  10. Click Check Name. The service account name will now be underlined.
  11. Click Apply > OK.

BlackBerry Enterprise Server 4.0 follow these steps:

  1. Go to Start > Programs > BlackBerry Enterprise Server > BlackBerry Server Configuration.
  2. On the BlackBerry Server tab, click Edit MAPI Profile.
  3. Type the name of the Microsoft Exchange Server and the BlackBerry Enterprise Server service account mailbox name.
  4. Click Check Name.
  5. Click Apply > OK.

BlackBerry Enterprise Server 3.5 and 3.6 follow these steps:

  1. Go to Start > Programs > BlackBerry Enterprise Server > Edit MAPI Profile for. (Perform the steps below for the MAPI profile's requiring changing)
  2. Select the desired profile.
  3. Type the name of the Microsoft Exchange Server and the BlackBerry Enterprise Server service account mailbox name.
  4. Click Check Name and verify that the profile resolves.
  5. Click Apply > OK.

BlackBerry Enterprise Server 2.1 follow these steps:

  1. Go to Start > Programs > BlackBerry Enterprise Server > Edit BES MAPI Profile.
  2. Type the name of the Microsoft Exchange Server and the BlackBerry Enterprise Server administration mailbox name.
  3. Click Check Name.
  4. Click Apply > OK.
CollapseAdditional Information

Warning: Do not re-create the MAPI profile on a BlackBerry Enterprise Server that is connected to a Zimbra mail server or a Google apps mail platform. Doing so is unsupported and might result in having to reinstall the BlackBerry Enterprise Server.

Warning: The following procedure requires modifying the computer registry. This can cause substantial damage to the Windows operating system. Document and back up the existing registry entries prior to implementing any changes.

To determine which service account the BlackBerry Enterprise Server is using, complete the following steps:

For BlackBerry Enterprise Server 4.0 to 5.0

  1. Go to Start > All Programs > Administrative Tools > Services.
  2. Select the BlackBerry Dispatcher service.
  3. Right-click and then click Properties.
  4. Click the Log On tab.
  5. The name specified in the Account field is the service account.

For BlackBerry Enterprise Server 3.6

  1. Go to Start > All Programs > Administrative Tools > Services.
  2. Select the BlackBerry Server service.
  3. Right-click and then click Properties.
  4. Click the Log On tab.
  5. The name specified in the Account field is the service account.

Note: If the account specified is the Administrator account or a local user account, and not the BlackBerry service account specifically created in Microsoft Active Directory for use by BlackBerry services, then the service account must be switched. For instructions on switching the service account, see the following articles:

For BlackBerry Enterprise Server 4.0 to 5.0, see KB04293.

Disclaimer

By downloading, accessing or otherwise using the Knowledge Base documents you agree:

   (a) that the terms of use for the documents found at www.blackberry.com/legal/knowledgebase apply to your use or reference to these documents; and

   (b) not to copy, distribute, disclose or reproduce, in full or in part any of the documents without the express written consent of RIM.


Visit the BlackBerry Technical Solution Center at www.blackberry.com/btsc.