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 email 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 email notification messages that Rational ClearQuest Web sends have the From address of the user who set up the email 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 email address of a dedicated email 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 email 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.
Parent topic: Configure SMTP