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
- Log on to the Rational ClearQuest Web
client by using an account with the Super User privilege.
- Configure the E-mail Options tab of the
Site Administration page:
- In the Sending E-mail Status list, select Active or Inactive,
as appropriate.
- In the Mail Transport Type list, select SMTP.
- In the SMTP Host field, enter the name
of your SMTP server.
- 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
- Review the /etc/mail/sendmail.cf file on
the Rational ClearQuest server
to verify that it is configured properly.
- Use an email client on the server to verify that you can send
email.
- 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
- 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.
- 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.