EASA Help Pages

User Tools

Site Tools

You are here: EASA 5.5 » What is EASA? » EASA Guides » Administrator's Guide to EASA » Enable Email in EASA

Sidebar

Homepage | About EASA | Contact

Contents

Table of Contents

Enable Email in EASA

Allow an EASA Server to send email messages, by specifying SMTP server parameters.

Go to:

  • EASA→Set Mode→Administrator→Configure→Email

Set:

  • Outgoing Mail Server (SMTP) - Name of SMTP server for EASA to use to send e-mail messages.
  • Port Number (Optional) - Set the port number used by the SMTP server connection, default→25.
  • User Name (Optional) - User Name used to authenticate on the SMTP server, if needed.
  • Password (Optional) - Password used to authenticate on the SMTP server, if needed.
  • Encryption (Optional) - Select encryption method, if not default of None.

Check these settings with a test email message from this page.

These settings will be stored in the file:

  • <SERVERDATA>\easa-share\naming\mail\server.xml

Exchange SMTP Server Caveat

Exchange must allow anonymous access to be used as the outgoing SMTP server.

Exchange may be configured for either:

  1. TLS authentication
  2. No authentication

For each case the server.xml configuration file needs be manually modified, and not reconfigured within EASA.

Any visit to EASA→Set Mode→Administrator→Configure→Email will overwrite this manual change.

Thus an Administrator must not select 'send test email' but instead should Author a simple EASAP with an EMAIL ACTION.

Below are the server.xml files for each case.

  1. Change EXCHANGE-SMTP-SERVER to the actual SMTP hostname.
  2. Copy the file to:
    • <SERVERDATA>\easa-share\naming\mail\server.xml
  3. Restart the EASA/Tomcat service

TLS authentication

server.xml
<resource name="mail/Session" type="javax.mail.Session">
  <parameter>
    <name>encryption</name>
    <value>TLS</value>
  </parameter>
  <parameter>
    <name>mail.smtp.host</name>
    <value>EXCHANGE-SMTP-SERVER</value>
  </parameter>
  <parameter>
    <name>factory</name>
    <value>com.easa.naming.EncryptedMailSessionFactory</value>
  </parameter>
  <parameter>
    <name>mail.smtp.starttls.enable</name>
    <value>false</value>
  </parameter>
  <parameter>
    <name>mail.smtp.auth</name>
    <value>false</value>
  </parameter>
</resource>

No authentication

server.xml
<resource name="mail/Session" type="javax.mail.Session">
  <parameter>
    <name>encryption</name>
    <value>none</value>
  </parameter>
  <parameter>
    <name>mail.smtp.port</name>
    <value>25</value>
  </parameter>
  <parameter>
    <name>mail.smtp.host</name>
    <value>EXCHANGE-SMTP-SERVER</value>
  </parameter>
  <parameter>
    <name>factory</name>
    <value>com.easa.naming.EncryptedMailSessionFactory</value>
  </parameter>
  <parameter>
    <name>mail.smtp.auth</name>
    <value>false</value>
  </parameter>
</resource>

Page Tools