Setting up EmailRelay for different types of email servers

HCL Compass EmailRelay uses configuration files to support an SMTP Email server. If your server requires additional parameters, they are supplied using the <properties> settings.

The following examples show how to setup EmailRelay for various SMTP Mail servers. Use them as a guideline to get started.

GMail SMTP Email server

Use these parameters to setup HCL Compass EmailRelay for a GMail SMTP Email server. Also, see https://www-304.ibm.com/support/docview.wss?uid=swg21444700 How to setup messaging with Gmail SMTP for instructions to prevent SSL handshake failure.

cqperl cqemailrelay.pl -dbset EmailPlus -userdb SAMPL -username admin -password "" -serverurl https:// cqweb.server.com/cqweb/ -outputpath C:\EmailRelay -smtpserver smtp.gmail.com -smtpport 465 -smtpuser you@gmail.com -smtppassword secret -mode postoffice

Hotmail SMTP Email server

Use these parameters to setup HCL Compass EmailRelay for Hotmail SMTP Email server:

cqperl cqemailrelay.pl -dbset EmailPlus -userdb SAMPL -username admin -password "" -serverurl https:// cqweb.server.com/cqweb/ -outputpath C:\EmailRelay -smtpserver smtp.live.com -smtpport 587 -smtpuser you@hotmail.com -smtppassword secret -mode direct -usessl no

Note: Notice how the -usessl parameter was set to no in the previous example. This is required because Hotmail SMTP Email sever does not use SSL. It uses TLS. In addition, you must add the following parameter to your cqemailrelay_cfg.xml file:

"<property
key="mail.smtp.starttls.enable" val="true"/>"

Also, you must login into your Hotmail account using a browser on the same machine the EmailRelay sever is running. Otherwise, you will receive the following error: 550 5.3.4 Requested action not taken; To continue sending messages, please sign in to your account.

Microsoft™ Exchange server SMTP Email server

The following example assumes that you have enabled SMTP with TLS on your Microsoft Exchange server, and that port 465 is where Microsoft Exchange server is listening on.

cqperl cqemailrelay.pl -dbset EmailPlus -userdb SAMPL -username admin -password "" -serverurl https:// cqweb.server.com/cqweb/ -outputpath C:\EmailRelay -smtpserver your_exchange.com -smtpport 465 -smtpuser you@your_exchange.com -smtppassword secret -mode direct -usessl no

Note: Just as with the Hotmail setup, you must add "" to your cqemailrelay_cfg.xml file.