Equisys technical notes

Technical guidance, explanations and fixes for our products

PRB: Zetafax 2008 messaging components MAPI/CDO pre-requisite check

Print

ZTN1691

ID: ZTN1691

This Zetafax technical note applies to:

  • Zetafax 2008 12.0.670

Symptom

For systems using Exchange2007, Zetafax Server does not start. Attempts to start the server fail with the following error:

" Process GATEWAY terminated - shutting down system"

This behaviour will be seen on the combinations marked below on all Operating Systems:

Combination

No Exchange

Exchange 2003

Exchange 2007

No Outlook

YES*

NO

YES

Outlook

NO

NO

NO

* Only if Zetafax is using an Exchange 2007 server elsewhere on the network.

Cause

The above problems are caused by the following:

1)        Zetafax does not check for the MAPI/CDO pre-requisite, even in cases where the Email Gateway might be configured and used.

2)        The Email Gateway for Exchange 2007 detects the presence of MAPI incorrectly.

3)        MAPI is installed correctly, but is not detected by the Zetafax Server and Zetafax Server does not start.

Resolution

To resolve problems 1 and 2, customers should do the following:

1)        Stop the Zetafax Server and the Zetafax Configuration program.

2)        Install the patch on the machine.  This can be downloaded from the following location or by using the Update Service (Zetafax Server Monitor | Help | Check for Updates...)

Click here to download the patch.

3)        Launch the Zetafax Configuration program from the Zetafax program group.

4)        Select “Server settings”, from the tree in the left pane.

5)        Open the Email Gateway configuration by double clicking on “Email Gateway” in the right pane.

6)        Click on “Configure” to launch the configuration window. Select “Microsoft Exchange” in the right pane, and click “Setup”. If prompted for the Exchange version, please select Exchange 2007. This will launch the “Microsoft Exchange Setup Service”.

7)        Select the Exchange 2007 server and click “Test Connection”.

8)        This will prompt the user to update messaging components (MAPI/CDO), if required. If prompted:

 a)        Launch Control Panel | Add Remove Programs

 b)      Uninstall “Messaging API and Collaboration Data Objects 1.2.1”. Please note this step is critical or the MAPI components will not be updated, though the installation might be reported as being successful.

 c)        Install the components from the displayed web page.

9)        Click “Test Connection”.  You should see no further warning regarding MAPI/CDO.

10)  Start the Zetafax Server.

Problem 3 can be resolved by performing the following steps:

1)        Launch the start menu, and click on “Run”.

2)        Type “regedit” and press enter.

3)        If on a 32-bit system browse to the key “HKEY_LOCAL_MACHINE\SOFTWARE\Equisys\Zetafax Server”, otherwise browse to the key “HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Equisys\Zetafax Server”

4)        On the right pane, right click and create a new DWORD value.

5)        Name the DWORD value to BypassMapiCdoCheck.

6)        Set its value to 1.

Important: You should only set the above registry key, only when presence of MAPI has been confirmed on the machine.

Status

This fault has been corrected as an update service patch.

Note: Customers using 64-bit Windows 2003 SP1 may see the following error on trying to install the patch. This is a known problem and will not affect the installation of the patch.

Customers are advised to download and install the correct version of the following update (either ia64 or x64), to avoid related errors in the future:

http://www.microsoft.com/downloads/details.aspx?FamilyId=8B4E6B93-1886-4D47-A18D-35581C42ECA0&displaylang=en#filelist

Last updated: 26th June 2008 (HP/GR)

Keywords: Zetafax Server Email Gateway

EquisysLogo
 

Recent news

This week we are acknowledging World Wellbeing Week 2020 - which runs from Monday 22 to Friday 26 June 2020. Participants including wellbeing practitioners, charities and social enterprises ...

As much of the world starts to ease after lockdown, the next couple of months provide many businesses with a useful window ahead of the next phase - of opening up the economy. Of course, many ...