Configuring SMTP on Windows

This section explains the procedures for configuring Rational® ClearQuest® Web to use the SMTP mail transport protocol on Windows.

The procedure to configure e-mail options for SMTP on Windows varies depending on whether your environment has a single Rational ClearQuest Server or multiple servers. Use the appropriate procedure for your environment.

When using SMTP on Windows, all e-mail notification messages that Rational ClearQuest Web sends have the From address of the user who set up the e-mail rules and a Reply To address that corresponds to the SMTP Reply To address specified on the E-Mail Options tab of the Site Administration page.

Configuring SMTP in a single server environment

To configure the SMTP protocol in a single Rational ClearQuest server environment on Windows:

  1. Log in to the Rational ClearQuest Web client. Your user account must be set up with the Super User privilege.
  2. Configure the E-mail Options tab of Site Administration:
    1. In the Mail Transport Type list, select SMTP.
    2. In the Sending E-mail Status list, select Active or Inactive.
    3. In the SMTP Host field, enter the name of your SMTP server.
    4. In the Reply To field, enter the e-mail address of a dedicated e-mail account that Rational ClearQuest Web can use as the Reply To address in notification messages. In this example, SomeGenericReturnAddress@MyDomain.

Configuring SMTP in a multiple server environment

If your environment includes multiple Rational ClearQuest servers on Windows, you cannot configure them on the E-mail Options tab of the Site Administration page. You must perform the following procedure on each server computer:

  1. Edit your Windows Registry settings in the regedt32 editor.. To ensure that you configure the same settings on each server computer, create a .reg file and import it into regedt32.
    1. Create this key:
      HKEY_USERS\.DEFAULT\Software\Rational Software\Email\SendMail
    2. Create these values under the SendMail key:
      • For SendActive, type one of these DWORD values: 1 for active, 0 for inactive.
      • For MailTransport, type the string value "SMTP".
      • For SMTPHost, type a string value that corresponds to the name of your SMTP server.
      • For ReplyTo, type a string value that corresponds to a dedicated e-mail account that can be used as the Reply To value in notification messages, for example, SomeGenericReturnAddress@MyDomain.
  2. Restart the Rational ClearQuest Web server.
Attention: If you change any of these Registry values on one server computer in your configuration, you must make the same change on the other computers.

Feedback