The EmailRelay application on a non-replicated ClearQuest database with multiple ClearQuest databases

In this scenario, two or more IBM® Rational® ClearQuest® databases are configured for use with the EmailRelay application in a non-replicated environment.

There is a separate <repository> XML block in the cqemailrelay_cfg.xml file for each ClearQuest database that you plan to enable the EmailRelay application on. When the EmailRelay application is configured to run in PostOffice Relay mode, it uses the <repository> XML block to determine how to communicate with the ClearQuest Web server. If more than one <repository> XML block exists, EmailPlus cycles through each block, polling the ClearQuest database for new EmailPlus records to send.

When the EmailRelay application is configured to run in SMTP Relay mode, the <repository> XML block is ignored. The EmailPlus package of each ClearQuest database must be configured to use the same port that EmailRelay is listening on.
Important: Use the same value for -relaycfgdir. Otherwise, a new cqemailrelay_cfg.xml file will be created that only contains configuration parameters for the new database.

In the following example, there are two ClearQuest databases: one called SAMPL, and the other called TEST. To setup and configure the EmailRelay application for both databases, run the cqemailrelay.pl Perl script twice, changing ClearQuest -dbset, -userdb -username, -password, and -serverurl values to be specific to your additional ClearQuest user database.

First, you setup the EmailRelay application for the SAMPL database.
cqperl cqemailrelay.pl -dbset EmailPlus -userdb SAMPL -username admin -password secret -serverurl https://cqweb.server.com/cqweb/oslc/ -relaycfgdir C:\EmailRelay -smtpserver smtp.your.org.com -smtpport 465 -smtpuser cq.emailrelay@your.org.com -smtppassword secret -mode postoffice
Next, you setup the EmailRelay application for the TEST database.
cqperl cqemailrelay.pl -dbset EmailPlus -userdb TEST -username admin -password secret -serverurl https://cqweb.server.com/cqweb/oslc/ -relaycfgdir C:\EmailRelay -smtpserver smtp.your.org.com -smtpport 465 -smtpuser cq.emailrelay@your.org.com -smtppassword secret -mode postoffice
Note: If you are setting up the EmailRelay application in SMTP Relay mode, you have to run the cqemailrealy.pl script only once.
Note: Because there is one EmailRelay server for each ClearQuest Web deployment, you cannot configure some of your ClearQuest databases to use PostOffice Relay mode and others to use SMTP Relay mode.

Feedback