WebLogic Exchange Service Setup

Configuration

This chapter describes how to configure the WebLogic Exchange Service.

This chapter contains the following sections:

Starting and Stopping the WebLogic Exchange Service

You can start and stop the WebLogic Exchange Service from the Control Panel or from the Windows Start Menu.

This section contains the following topics:

Starting and Stopping from the Control Panel

Perform the following steps to start or stop the WebLogic Exchange Service from the Control Panel:

Browse to Start > Settings > Control Panel > Administrative Tools > Services.

Locate the BEA WebLogic Exchange Service.

To start the service: Right-click on the service and select Start.
To stop the service: Right-click on the service and select Stop.

Starting and Stopping from the Windows Start Menu

Perform the following steps to start or stop the WebLogic Exchange Service from the Windows Start Menu:

Browse to Start > Programs > BEA WebLogic > Personal Messaging API > Exchange Service.

To start the service, select Start Service. To stop the service, select Stop Service.

Setting Process Rights

The machine that runs the WebLogic Exchange Service and the MAPI subsystem on behalf of users requires the "Act as Part of Operating System" privilege. This process actually logs the user accessing their Exchange mailbox into the Windows machine and the operating system calls required to do this need "Act as Part of Operating System". If WebLogic Exchange Service runs as LocalSystem (the default), no further action is required since this privilege is granted to the LocalSystem user.

To grant "Act as Part of Operating System" privilege, browse to Control Panel > Administrative Tools > Local Security Policy > Local Policies > User Rights Assignment.

Windows Domain Requirements

The machine running the WebLogic Exchange Service must be in the same domain as the Exchange server, or on a domain with a bidirectional trust relationship with the Exchange domain. Additionally, each user that will access their mailbox using the machine with the WebLogic Exchange Service must have "Log on Locally" rights to that machine.

Maintaining Application/Service Uptime

The WebLogic Exchange Service runs as a Windows service. This allows you to use the Windows built-in crash recovery for services. To enable crash recovery, go to Control Panel > Administrative Tools > Services > properties for the service you are running. Under the Recovery tab, set First Failure, Second Failure and Subsequent Failures to Restart the Service. You may want to set the Restart Service After time to 0 minutes, so that the service restarts immediately.

Note: In the event that the service does restart, all existing sessions will be lost.

Reporting a WebLogic Exchange Service Crash

This section includes steps to gather information to help debug an WebLogic Exchange Service crash. Provide as much of the following information when submitting your request to support:

The contents of your Application Log in the Event Viewer - This can be obtained by running eventvwr, right clicking on the Application Log and choosing Save File As. Save the file in .evt format.
What operation was being performed at the time of the crash, what mailbox was being hit, and a PST file containing the contents of the mailbox against which the crash occurred - PST files may be exported from Outlook. This can be difficult to obtain, but given the data and a series of steps to reproduce a particular problem, support will be better able to solve any crash issue.
The version information for cz_mapi.dll - In Windows Explorer, right click the cz_mapi.dll file and select the Version tab.
A crash log from Java - When a crash occurs, frame information is written to an hs*.log file (HotSpot Log).