How to install or upgrade the Microsoft Exchange Server MAPI Client and Collaboration Data Objects 1.2.1

How to install or upgrade the Microsoft Exchange Server MAPI Client and Collaboration Data Objects 1.2.1
Article ID: KB15779

Type: Support Content

Last Modified: 01-31-2011

PrintEmail Document Bookmark
Product(s) Affected:

BlackBerry® Enterprise Server Express for Microsoft® Exchange
BlackBerry® Enterprise Server for Microsoft® Exchange
BlackBerry® Professional Software

Search the knowledge base:


Visit BlackBerry Community Support Forums
Follow us on Twitter® @BlackBerryHelp
Collapse all | Expand all
Jump to: Overview | Environment | Additional Information
Overview

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

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

Download ExchangeMapiCdo.EXE from www.microsoft.com.
Stop all BlackBerry Enterprise Server services.
Set all of the Automatic BlackBerry Enterprise Server services to Disabled.
Do not change the manual BlackBerry services (BlackBerry Enterprise Server 5.0.x only).
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 Microsoft Exchange System Manager, you will need to be logged in as an Exchange Administrator user and have the Microsoft Exchange 2003 CD.
Windows Server® 2008 uses the Programs and Features tool in Control Panel.
Locate the following files and rename them with the file extension .old if they exist. Please make sure you are searching the hidden and system folders:
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. Please see Additional information for Windows Server 2008.
Reboot the server.
Login with the BESAdmin service account.
Double-click ExchangeMapiCdo.EXE to extract the ExchangeMapiCdo.MSI file.
Double-click ExchangeMapiCdo.MSI and follow the prompts to install the Microsoft Exchange Server MAPI Client and CDO version 1.2.1.
Set all the Disabled BlackBerry services to Automatic (but do not start the BlackBerry services).
Do not change the manual BlackBerry services (BlackBerry Enterprise Server 5.0.x only).
Recreate the MAPI Profile

Verify that all the BlackBerry services are stopped.
Open regedit.
Navigate to HKEY_CURRENT_USER\SOFTWARE\MICROSOFT\WINDOWSNT\CURRENT VERSION\WINDOWS MESSAGING SUBSYSTEM\PROFILES.
Right-click Profiles and select Export.
Save the profile with MAPI and today’s date (i.e. mapi09212010.reg).
Right-click Profiles and select Delete.
Click on Start - Programs - BlackBerry Enterprise Server and select BlackBerry Server Configuration.
Click the BlackBerry Server tab.
Click Edit Mapi.
Type in your Microsoft Exchange Server.
It should default to the BESAdmin service account for the mailbox.
Click Check Name.
The Microsoft Exchange Server and mailbox should underline if they are resolved.
Click OK.
Start all of the automatic BlackBerry services, starting with BlackBerry Router, BlackBerry Dispatcher, BlackBerry Controller, and then all the others.
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.

Back to top
Environment

BlackBerry® Enterprise Server 4.1 SP4 to 5.0 SP2 for Microsoft® Exchange
BlackBerry® Professional Software 4.1 SP4 for Microsoft® Exchange
BlackBerry Enterprise Server Express 5.0 SP1 to 5.0 SP2
Windows®
Back to top
Additional Information

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

Verify that the ExchangeMAPI folder was created in the Program Files folder. The ExchangeMAPI folder contains a selection of .DLL files.
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\ Version: CDO.DLL, 6.5.8190.0
[ENV] EMSMDB32.DLL: C:\Program Files\ExchangeMAPI\EMSMDB32.DLL, Version: 6.5.8190.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.


--------------------------------------------------------------------------------

This article contains information previously documented in KB12701 and KB20774.


--------------------------------------------------------------------------------

Windows Server 2008 - How to rename the mapi32.dll in the c:\windows\system32 folder:

For Windows 2008 the c:\windows\system32\mapi32.dll file does not need to be renamed. If it must be removed, follow the directions below.

You must take ownership and full control of the file:

Open a command prompt as Administrator.
Right-click the Command Prompt in the Start > Programs > Accessories.
Select Run as administrator.
Change directories to c:\windows\system32.
cd\windows\system32
Type the following two commands:
Takeown /f c:\windows\system32\mapi32.dll
Icacls c:\windows\system32\mapi32.dll /grant besadmin:F (If you service account name is not besadmin then replace besadmin with the appropriate service account name)
Rename the mapi32.dll - Example: ren mapi32.dll mapi32.old.
Right click fixmapi.exe and select Run As Administrator.
Note: If this does not work, reboot the computer into Safe Mode, and then try to rename the mapi32.dll file.