Enterprise Recon Cloud 2.12.0

How to Configure Mail Settings

Configure Mail Settings to allow ER Cloud to send email notifications and password recovery emails.

This section covers the following topics:

Overview

For ER Cloud to send emails to users, you must set up a Message Transfer Agent (MTA) in the Mail Settings page. You can have more than one active MTA.

ER Cloud automatically distributes the Mail Queue among the active MTAs for sending emails. Refer to View Mail Queue below.

Mail Settings page displaying the list of Message Transfer Agent (MTA), with the "smpt.gmail.com" MTA enabled.

Set Up Message Transfer Agent

To set up a MTA:

  1. Log in to the ER Cloud Web Console.
  2. Go to Settings > Notifications > Mail Settings.
  3. On the top-right of the Mail Settings page, click +Add MTA.
  4. In the Add New MTA window, fill in the following fields:

    Dialog box to configure the host name, port and other settings to add a new MTA.

    Field Description
    Description Enter a name to describe this MTA.
    Host Name Enter the MTA hostname from your email service provider, e.g. smtp.gmail.com.
    Host Port Enter the port used for MTAs, e.g. default TCP port: 25; default SSL port: 465.
    Enable SSL When selected, SSL is enabled.
    Enable STARTTLS When selected, STARTTLS is enabled. The Host Port defaults to 587.
    Use User/Pass Authorization Select to set up a MTA that requires credentials:
    • Username: Enter a user name. This user must be able to send out emails from the default ER Cloud admin user's email address.

    • Password: Enter the password for the given Username.
    • Max. Concurrent Connections: Enter to set the connection limit.
  5. Click Test to test the connection.
  6. In the Test Email Settings window, enter a valid email address and click Ok to send a test email. Emails will be sent from the email address that is configured for the default ER Cloud admin user's account. See Update Administrator Account for more information.

If your settings are correct, Email server accepted mail for delivery is displayed.

The MTA appears on the Mail Settings page under the List of Message Transfer Agents (MTA).

Manage Message Transfer Agent List

From the List of Message Transfer Agents (MTA) section, you can:

Feature Description
View list of MTAs Displays a list of of MTAs. To view details of a MTA, click the arrow ◀ to the left of the MTA host name.
Add MTA Refer to Set Up Message Transfer Agent above.
Edit MTA Hover over the MTA and click Edit.
Remove MTA Hover over the MTA and click Remove.
View Mail Queue To view unsent emails, go to the bottom-right of the Mail Settings page and click View Mail Queue. The Mail Queue page displays the number of attempts, the delivery attempt and the intended receiver of the email.

Master Server Host Name for Email

By default, password recovery emails delivered by the MTA uses the public domain name system (DNS) name of the Master Server EC2 instance in the password recovery URL.

In environments where the DNS is configured to require the use of a fully qualified domain name, the default password recovery URL will fail.

Instead, configure ER Cloud to use the fully qualified domain name, e.g. <public DNS name>.domain_name.com.

To set the Master Server Host name for email:

  1. From the Mail Settings page, go to the Master Server Host Name for Email Links section.
  2. Hover over the Master Server host name and click Edit.
  3. In Edit Host, enter the fully qualified domain name of the Master Server:

  4. Click Ok.