Configuring an Microsoft Exchange Server 5.5 to work with the eG Manager

The MsXMail test, which is executed by an eG external agent, mimics an MS Outlook mail client that sends and receives mails from an Exchange server. Whereas eG Enterprise's  Mail test relies on SMTP and POP3/IMAP protocols to communicate with the mail server, the MsXMail test is used for emulating client accesses via the native Microsoft Mail protocol (i.e. in situations where SMTP/POP3/IMAP are not enabled for a mail server). This test takes three main parameters:

  • A user mailbox that the test uses to send and receive mails
  • The site on the Exchange server that hosts this user account
  • The organizational unit on the Exchange server that hosts this site

In order to ensure that this test functions, the following conditions are to be fulfilled:

  • The eG external agent that is executing the MsXMail test, should be installed on a Windows NT server/client in the same domain as the MS Exchange server.
  • The administrator configuring the test should ensure that the mailbox being used in the test, exists on the Exchange server. If no mailboxes exist, then follow the instructions given below to create one for an existing Windows NT domain user:
  1. Click the Start button on the task bar of the Windows NT server that hosts the Exchange server, and follow the menu sequence: Start -> Programs -> Microsoft Exchange Server -> Microsoft Exchange Administrator (see Figure 1):


    Figure 1 : The Microsoft Exchange Administrator window


    Administrator privileges are required for creating a mailbox on the MS Exchange server 5.5

  2. The administrator window that appears has a tree structure in its left pane (Figure 2). The top-most node of the tree structure is the organizational unit on the Exchange server. Expanding this node, reveals the complete list of sites in the organization. Expanding a site, reveals a Recipients sub-node, clicking on which, the existing user accounts (mailboxes) on the site will be displayed in the right pane (see Figure 2).


    Figure 2 : The Administrator window

  3. Next, select the site on which the mailbox is to be created, click on the File option on the menu bar, and select New Mailbox, to create a new mail box on the selected site (see Figure 3).


    Figure 3 : Creating a mailbox for a user

  4. In the Properties dialog box that appears (see Figure 4), specify the details of the user’s mailbox. If the Windows NT user account which is to be associated with the new mailbox already exists in the same domain as the MS Exchange server, then that user account will be automatically displayed against Primary Windows NT Account (see Figure 4). However, such an automatic association is possible only if the name of the user account and the mailbox are the same. If not, you can click on the Primary Windows NT Account button to explicitly define the association.


    Figure 4 : Specifying the details of the new user account

  5. Finally, click the Apply button in Figure 4 to register the changes, and then, click the ok button to close the dialog box.
  6. Once back in the Exchange Administrator window (see Figure 5), drill-down the tree structure in the left pane using the following node-sequence: <Organization name> -> <Site name> -> Recipients (see Figure 5). This will display the list of mailboxes in the right pane. Note that the newly created mailbox is listed therein (see Figure 5).


    Figure 5 : The newly created mailbox being displayed in the Administrator window

  7. The eGurkhaAgent service should run using the NT account information of the user whose mailbox has been configured for the MsXMail test
  8. By default, the eGurkhaAgent service uses the LocalSystem account for execution. This account however, may not permit an external agent to access the mailbox that has been configured for the MsXMail test. Hence, the eGurkhaAgent service should be made to run using the login information of the user whose mailbox has been configured for the MsXMail test.
  9. For example, assume that the administrator has decided to use the Windows NT user john’s mail box for configuring the MsXMail test. To login to a Windows NT server/client, john uses the user name john and the password john. To ensure that the external agent gains access to john’s mailbox for monitoring, the above-mentioned login information should be passed to the eGurkhaAgent service.

To achieve this, do the following:

  1. Login to the Windows NT server hosting the external agent as an eG user who has a mailbox on the Exchange server 5.5.
  2. Then, open the Services window of the server (see Figure 6) using the menu sequence: Start -> Programs -> Administrative Tools -> Services.


    Figure 6 : The Services window displaying the eGurkhaAgent service

  3. Double-click on the eGurkhaAgent service in Figure 6 to open its Properties (see Figure 7) dialog box. Click on the Log On tab of the dialog box (see Figure 7), select the This Account option, and specify the name of user whose mailbox is to be configured. Then, specify the Password of the user and confirm it by retyping it in the Confirm Password text box. This name and password should be the same as those specified while creating the user on Windows NT. The Browse button can also be used to specify the user name (see Figure 7).


    Figure 7 : Configuring the eGurkhaAgent service to use the eG user name

  4. Finally, click on the Apply button in Figure 7, followed by the OK button.