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 email 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 you use SMTP on the UNIX™ system and Linux™, 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

Perform the following steps to configure the SMTP protocol in a single ClearQuest® Server configuration on the UNIX™ system and Linux™.

Procedure

  1. Log on to the Rational® ClearQuest® Web client by using an account 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 address of a dedicated email account that Rational® ClearQuest® Web can use as the Reply To address in notification messages. Use the following format: SomeGenericReturnAddress@MyDomain.

Configuring SMTP in a multiple server environment

If your environment includes multiple servers on the UNIX™ system and Linux™, you must configure each server separately by performing the next steps.

Procedure

  1. Review the /etc/mail/sendmail.cf file on the Rational® ClearQuest® server to verify that it is configured properly.
  2. Use an email client on the server to verify that you can send email.
  3. Copy the file$CLEARQUEST_HOME/cqweb/cqserver/config/SendMail to the following 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

    See the context-sensitive help for the Site Administration page for information about SMTP email options.

  5. Restart the Rational® ClearQuest® Server.

If you change any registry values on one Rational® ClearQuest® Server in your configuration, you must make the same change on the other servers.