Configuring SMTP on the UNIX system and Linux

This section explains how to configure Rational® ClearQuest® Web to use the SMTP mail transport protocol on the UNIX system and Linux

The procedure to configure e-mail options for SMTP on the UNIX system and Linux 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 the UNIX system and Linux, 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 ClearQuest Server configuration on the UNIX system and Linux:

  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 the Site Administration page:
    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 SMTP in a multiple server environment

If your environment includes multiple servers on the UNIX system and Linux, 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. Review the /etc/mail/sendmail.cf file on the Rational ClearQuest server computer to verify that it is configured properly.
  2. Using an e-mail client on the Rational ClearQuest Server computer, verify that you can send e-mail.
  3. Copy the file/opt/rational/clearquest/cqweb/cqserver/config/SendMail to this location in the root directory, creating subdirectories as needed:

    /.Rational/.Registry/ClearQuest/SendMail

  4. Edit the file /.Rational/.Registry/ClearQuest/SendMail, replacing the placeholder text with the appropriate configuration settings. For example:
    SendActive: 1
    ReplyTo: SomeGenericReturnAddress@mycompany.com
    SMTPHost: SomeHost

    For information about SMTP e-mail options, see the context-sensitive help for Site Administration page.

  5. Restart the Rational ClearQuest Server.

If you change any of these Registry values on one Rational ClearQuest Server computer in your configuration, you must make the same change on the other computers.


Feedback