This documentation supports the 9.1 version of BMC Remedy ITSM Deployment.

To view the latest version, select the version from the Product version menu.

Email Engine preinstallation tasks - Windows

Complete the following tasks before you install the Email Engine on Microsoft Windows.

Setting environment variables

Before you start the installation, set the PATH environment variable to access the latest JRE directory. Make sure that you include the bin directory of your Java installation (for example, C:\Program Files\Java\jre7\bin). Otherwise, the Email Engine might not start correctly after you complete the installation.

Determining the requirement for the SSL option

Determine whether your environment requires the Secure Socket Layer (SSL) option.

Setting up your system to use MAPI and MBOX mail protocols

You must be a Windows domain administrator or Microsoft Exchange administrator to perform these steps.


  • You do not need to prepare the system if you are using the IMAP4, POP3, SMTP, or EWS protocols.
  • The MAPI protocol for incoming and outgoing mail is disabled for 64-bit JVM.
  • MAPI users (for 32-bit JVM only): If you are upgrading your Email Engine from a previous Email Engine version and you do not need to change your existing MAPI configuration information, you can skip this section.

To prepare for MAPI

  1. Install the Exchange server at one of the following locations:

    • The same domain as the Email Engine domain
    • A domain with the appropriate trust relationship to the Email Engine domain
  2. Install the Exchange client on the computer on which you plan to install the Email Engine.
    The client contains the libraries that the email protocols will use.
  3. Create and configure a Windows domain account:
    1. Create a Windows domain user account at one of the following locations:
      • On the same domain as the Email Engine

      • On a domain with appropriate trust relationships

      Note the name of the user:

      • Windows — Incoming mailbox: Server user

      • Windows — MAPI logon settings: Windows NT user

    2. Assign group and domain membership to the domain user account at one of the following locations:

      • On the same domain as the Email Engine — Give group membership to the local administrator's group [HTMLUATarsPlanAndInstallFinal2:active directories only].

      • On a domain with appropriate trust relationships — Give domain membership to the Email Engine domain or the Exchange Server domain.

    3. Grant the domain user the following advanced rights on the computer where you plan to install the Email Engine:

      • Act as part of the operating system

      • Log on as a service


        (Active directories only) Make sure that the Effective Rights option shares the correct advanced rights.

  4. Create and configure an Exchange profile:
    1. Log in as the domain user on the computer where you plan to install the Email Engine, and create an Exchange email profile.
    2. Configure the profile to:
      • Work exclusively with the Email Engine.
      • Be accessible by the Windows domain user account you created in step 3.
      • Point to the Exchange server and mailbox.


        Make sure to disable the Cached Exchange Mode as a part of the MAPI profile creation.

  5. Verify your profile setup.
  6. From the computer where you plan to install the Email Engine, log on as the domain user that you created earlier in step 3.
  7. Using the Microsoft Outlook client, send and receive emails to verify that the Exchange profile is functioning correctly.

To prepare the system for using the MBOX protocol

  1. Create an email account and an account user.
  2. Give the email account user full read and write permissions to relevant directories and files.
  3. Verify that the account can send and receive emails.

Related topics

  • Configuring SSL for the email engine .
  • Setting up UNIX mailboxes .
Was this page helpful? Yes No Submitting... Thank you