EASA Help Pages

User Tools

Site Tools

You are here: EASA 6.0 » What is an EASA system? » EASA Guides » Administrator's Guide » 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\Session.xml

Office 365 mail server

In Office 365 mail server, timeout periods must be set manually. Add the following parameters to,

  • <SERVERDATA>\easa-share\naming\mail\Session.xml
Session.xml
  <parameter>
    <name>mail.smtp.connectiontimeout</name>
    <value>60000</value>
  </parameter>
  <parameter>
    <name>mail.smtp.timeout</name>
    <value>300000</value>
  </parameter>
  <parameter>
    <name>mail.smtp.writetimeout</name>
    <value>60000</value>
  </parameter>

Exchange SMTP server caveat

Microsoft 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 Session.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 Session.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\Session.xml
  3. Restart the EASA/Tomcat service

TLS authentication

Session.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

Session.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