EASA Help Pages

User Tools

Site Tools

You are here: EASA 6.1 » Administrator Guide » Enable email

Sidebar

About EASA | Contact

Contents

Enable email

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