How to install or upgrade the MAPI Client and Collaboration Data Objects 1.2.1 on the BlackBerry Enterprise Server

Article ID: KB15779

Type: Support Content

Last Modified: 06-17-2014

 

Product(s) Affected:

  • BlackBerry Enterprise Server for Microsoft Exchange
  • BlackBerry Enterprise Server Express for Microsoft Exchange
  • BlackBerry Professional Software
CollapseEnvironment
  • BlackBerry Enterprise Server 4.1 SP4 to 5.0 SP4 for Microsoft Exchange
  • BlackBerry Professional Software 4.1 SP4 for Microsoft Exchange
  • BlackBerry Enterprise Server Express 5.0 SP1 to 5.0 SP4
  • Microsoft Windows Server
CollapseOverview

To update a previous MAPI client to Microsoft Exchange Server MAPI Client and CDO version 1.2.1

Note: This package will not install on a system on which any version of Microsoft Outlook or Microsoft Exchange Server 2003 or earlier is installed

Supported operating systems for MAPI 6.5.8244 and CDO version 1.2.1 are: 

  • Windows 7
  • Windows Server 2003
  • Windows Server 2008
  • Windows Server 2008 R2
  • Windows Vista
  • Windows XP

To update the MAPI Client and CDO version 1.2.1 from a MAPI pack or Microsoft Exchange System Manager, complete the following steps:

1. Download ExchangeMapiCdo.exe from the Microsoft Help and Support Site.

2. Stop all BlackBerry Enterprise Server services.

3. Set all of the Automatic BlackBerry Enterprise Server services to Disabled.

  • To not change the manual BlackBerry services (BlackBerry Enterprise Server 5.0.x only).

4. Remove the Microsoft Exchange System Manager or the Messaging API and Collaboration Data Objects 1.2.1 installed on the computer using the Add or Remove Programs tool in Control Panel.

  • To remove the Microsoft Exchange System Manager, please make sure to log in as an Exchange Administrator and have the Microsoft Exchange 2003 CD or equivalent on a network share.

Note: If there is an issue with removing Microsoft Exchange System Manager 2003, please see KB260378 under the Microsoft Help and Support Site website for steps on how to manually uninstall.

  • Windows Server 2008 uses the Programs and Features tool in Control Panel.

5. Locate the following files and rename them with the file extension .old if they exist. Please ensure Search system folders and Search hidden files and folders in the More advanced options is selected during the search:

  • EMSMDB32.DLL
  • EMSABP32.DLL
  • CDO.DLL

Note: When upgrading from Exchange System Management (ESM) 2003 tools to MAPI and CDO 1.2.1 the mapi32.dll file will need to be renamed also. This will only need to be performed on Windows Server 2003 and should not be necessary for Windows Server 2008.

6. Reboot the server.

7. Log in with the BlackBerry Enterprise Server service account (i.e. BESadmin).

8. Double-click ExchangeMapiCdo.exe to extract the ExchangeMapiCdo.msi file.

9. Double-click ExchangeMapiCdo.msi and follow the prompts to install the Microsoft Exchange Server MAPI Client and CDO version 1.2.1.

10. Set all the Disabled BlackBerry services to automatic but do not start the BlackBerry services.

11. For BlackBerry Enterprise Server 5.0.X only, do not change the manual BlackBerry services.

12. Recreate the MAPI Profile

Note: For instructions on how to recreate the MAPI profile, see KB10285.

13. Reboot the Blackberry Enterprise server. After the reboot confirm all the services started started automatically. If restarting services manually after the reboot restart them in the order starting with BlackBerry Router, BlackBerry Dispatcher, BlackBerry Controller, and then all the others.

Note: Services that should be set to manual for start up are BlackBerry Mailstore, Synchronization, and Policy. The remaining services should be set to automatic start up.

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

CollapseAdditional Information

To verify the successful installation of the Microsoft Exchange Server MAPI Client and CDO 1.2.1, complete the following steps:

  1. Verify that the ExchangeMAPI folder was created in the Program Files folder. The ExchangeMAPI folder contains a selection of .DLL files.
  2. In the BlackBerry Messaging Agent (MAGT) logs, verify the following ENV environment variables are reported:

    [ENV] MAPI32.DLL: C:\Windows\System32\MAPI32.DLL, Version: 1.0.2536.0
    [ENV] CDO.DLL: C:\Program Files\ExchangeMapi\cdo.dll, Version: 6.5.8244.0

    Note:
    The file directories listed in the logs contain the version of the files, and the currently available version might be newer than the versions in the preceding list. For Windows Server 2008 64-bit, use c:\Program Files (x86) instead of c:\Program Files. 

Note: If User Account Control is enabled on the BlackBerry Enterprise Server, the installation of the MAPI Client and CDO version 1.2.1 should be run as an administrator, but this option is not available when right-clicking ExchangeMapiCdo.MSI. to install the MAPI Client and CDO version 1.2.1 as an administrator, complete the following steps:

  1. Click Start, click All Programs, and then click Accessories.
  2. Right-click Command prompt, and then click Run as administrator.
  3. If the User Account Control dialog box appears, confirm that the action it displays is what you want, and then click Continue.
  4. Navigate to the folder that ExchangeMapiCdo.MSI was extracted to.
  5. Type ExchangeMapiCdo.MSI and press Enter.
  6. Follow the prompts to install the Microsoft Exchange Server MAPI Client and CDO version 1.2.1.

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.