Configuring Rational ClearQuest Web to use SMTP on Windows

This topic describes the procedures for configuring the site e-mail options to use SMTP as the mail transport for e-mail notification on Windows

.

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

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 configured on the E-mail Options tab of Site Configuration.

Configuring site e-mail options for SMTP for one Rational ClearQuest server

To configure SMTP on one server 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 Configuration:
    1. In the Sending E-mail Status list, select Active or Inactive, as appropriate.
    2. In the Mail Transport Type list, select SMTP.
    3. In the SMTP Host field, enter the name of your SMTP server.
    4. In the SMTP 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 site e-mail options for SMTP for multiple Rational ClearQuest servers

If your environment includes multiple servers on Windows, you cannot configure them on the E-mail Options tab of Site Configuration. You must perform this procedure steps on each server machine in your environment.

To configure e-mail options for SMTP for multiple servers:

  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 Registry Server service.

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