Agents Administration - Tests
 

Configuration of XChgMailTest

The XChgMailTest emulates a Microsoft Outlook client connecting to a Microsoft Exchange server and sending/receiving mails. The default parameters associated with this test are as follows:

  • The TEST PERIOD list box helps the user to decide how often this test needs to be executed. 

  • In the HOST text box, the host name of the of the machine on which the server has been installed has to be specified.

  • The port number through which the server communicates has to be mentioned in the PORT text box. The default port is 691.

  • If the ISPASSIVE parameter is set to YES, then it means that the Exchange server under consideration is a passive server in an Exchange cluster. No alerts will be generated if the server is not running. Measures will be reported as "Not applicable" by the agent if the server is not up.

  • In the XCHGMAILBOXNAME text box, specify the email ID on the Exchange server that is to be used by this test for sending/receiving mails. To know the email ID that corresponds to a user mailbox, do the following:

    • Follow the menu sequence, Programs -> Administrative Tools (or Control Panel -> Administrative Tools) -> Active Directory Users and Computers, on the Exchange server.

    • In the tree structure in the left pane of the window that appears, expand the node that corresponds to a Site on the Exchange server, and then, click on the Users folder within.

    • From the list of user accounts displayed in the right pane, select the account that you intend using for the test and double-click on it.

    • In the General tab (of the Properties window) that appears by default, look for the mail ID against the E-mail field. Specify this mail ID in the XCHGMAILBOXNAME text box.

  • Specify the IP address of the Exchange server being monitored in the SMTPSERVER text box. By default, the IP address of the HOST is displayed here.

  • Enter the port number at which the SMTPSERVER listens in the SMTPSERVERPORT text box. The default port is 25.

  • In the PROFILENAME text box, mention the profile that the email ID in the XCHGMAILBOXNAME text box is configured to use. To know the existing profiles, open the Control Panel on the Microsoft Outlook client which houses the XCHGMAILBOX that has been configured for this test, and double-click on the Mail option within. The Mail Setup dialog box will open. Click on the Show Profiles button therein to view the existing list of profiles.

  • If multiple components of the same component type are awaiting configuration, then an APPLY TO OTHER COMPONENTS check box will appear in this page. Clicking on this check box will allow you to apply the configuration to all/selected components of that type.

  • Once the necessary values have been provided, clicking on the UPDATE button will register the changes made.

  • When changing the configuration for specific servers, a “*” beside the text box corresponding to the parameter signifies that these values have to be manually configured by the user. The parameter values that require to be configured will typically be prefixed with a “$” or contain a series of “*”. A value of "none" in the parameter value indicates that the corresponding parameter value can be changed if required.

Note:
  •  This test uses only a Microsoft Outlook 2003 client for sending/receiving mails from the server; therefore, you can, if you so desire, configure a separate Outlook Mail client on the Exchange server for use by this test. Note that the test will not work with a Microsoft Outlook 2000/2002 client.

  •  The eG external agent that is executing the XChgMailTest, should be installed on a Windows 2000/2003 server/client in the same domain as the Exchange 2000/2003/2007 server.

  •  The administrator configuring the test should ensure that the mailbox being used in the test, exists on the Exchange 2000/2003/2007 server.

  • The eGurkhaAgent service should run using the account information of the user whose mailbox has been configured for the XChgMailTest.

  •  MAPI should be configured in the Exchange 2000/2003/2007 server.

  •  The Exchange client should exist in the system on which this test is executed.