|
|
|
|
Configuration File
<TRAVERSE_HOME>/etc/emerald.xml
Restart These Components After Changing the Configuration File
Description
The DGE and Report Server components need to know which email servers they should use to send notifications or reports via email.
Edit the following section in<TRAVERSE_HOME>/etc/emerald.xml:
<email-servers>
<sender address="traverse@your.domain" name="Traverse Alerter"/>
<host name="mail_server1" priority="10"/>
<host name="mail_server2" port="589" priority="30">
</email-servers>
Change mail_server1 / mail_server2 to the FQDN of your local email server or the email server that you use for sending outgoing email. If you have more than one email server, you can add additional servers with a different priority value (the lowest priority server is preferred).
Create an email alias for the Traverse administrator, and set the sender address to this email alias. All alerts from Traverse will be sent from this sender address.
Note: There is a separate email address setting in emerald.env used for getting administrative alerts from Traverse such as DGE process failure, backups, etc.
You should make sure that the email servers are configured properly to allow Traverse to relay email to any email address. (Please refer to your email server's administration guide for instructions on how to accomplish this). See Actions and Notifications for more details.
Authenticated SMTP Over Plain-Text
You can optionally specify a username and password for authenticated SMTP:
<host name="mail_server2" port="25" username="abc" password="xyz" priority="20"/>
Encrypted SMTP using TLS
You can add the following parameter so that Traverse uses encrypted TLS connections for sending email:
starttls="true"
If the SMTP server supports TLS, then during the initial SMTP handshake, Traverse BVE/DGE will switch to encrypted TLS connection for sending email.
Encrypted SMTP using SSL
As an alternative to TLS, you can also enable SSL encryption by specifying an SSL port in the mail server section:
sslport="nnn"
e.g. for Gmail, use:
<host name="smtp.gmail.com" priority="10" sslport="465" username="abc" password="xyz">
If both STARTTLS and SSLPORT are specified for the mail server, then the SSLPORT entry is ignored.