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:
- Log in to the Rational ClearQuest Web
client. Your user account must be set up 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 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.
- Review the /etc/mail/sendmail.cf file on the Rational ClearQuest server
computer to verify that it is configured properly.
- Using an e-mail client on the Rational ClearQuest Server
computer, verify that you can send e-mail.
- 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
- 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.
- 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.