Configuring Email Notifications

Describes how to configure the Simple Mail Transfer Protocol (SMTP) to send email notifications from the Data Fabric UI to specified email accounts.

The Data Fabric UI can notify you by email when alarms are generated on a fabric. To configure email notifications, you must set up SMTP:

Setting Up SMTP

To set up SMTP:
  1. Sign in to the Data Fabric UI, and switch to the Fabric manager experience.
  2. Click Fabric administration.
  3. On the SMTP card, click Edit SMTP settings. The Edit SMTP settings form is displayed.
  4. Specify the following parameters:
    Parameter Description Example
    Provider* Select Office 365, SMTP, or Other from the drop-down menu. If you select Office 365, the SMTP server and port information is pre-filled for you.
    NOTE
    Gmail is provided as an option, but is not currently supported because Gmail does not support unsecure emails from third-party applications. For more information, see this page.
    		 Office 365
    SMTP server* The name of the mail server for the SMTP provider that you specified. smtp.office365.com
    This server requires an encrypted connection (SSL) Check this box if the connection to the SMTP server must be encrypted. N/A
    SMTP port* The SMTP port to use for sending mail. 587
    Sender's full name* The name that the HPE Ezmeral Data Fabric should use when sending email. East Lab Data Fabric
    Sender's email address* The email address that the HPE Ezmeral Data Fabric should use when sending email. jennifer-huang87@outlook.com
    Sender's username (Optional) The user name that the HPE Ezmeral Data Fabric should use when logging on to the SMTP server. jennifer46
    Sender's SMTP password (Optional) The password that the HPE Ezmeral Data Fabric should use when logging on to the SMTP server. mySMTP!pw
  5. Click Save. A message indicates if the configuration was successful.
  6. See Setting Up Alarm Notifications.

Editing SMTP Settings

After SMTP has been configured, you can edit the settings by clicking Edit SMTP settings, changing the parameter values as needed, and clicking Save.

Setting Up Alarm Notifications

Setting up SMTP does not by itself enable alarm notifications. You must also identify the alarms for which you want to be notified. Currently, setting up alarms must be done using the maprcli command line. You must run the config save command for each alarm where you want to generate an email.
WARNING
You must have fc (full control) or a (admin) permissions to run this command.
The format of the command is:
maprcli alarm config save -cluster <fabric_name> -values "<alarm>,<enableEmail>,<email>"
Assign values as follows:
Value Description Example
alarm Name of the alarm. Specify the alarm name in uppercase with underscores. For a list of Data Fabric alarms, see Alarms Reference. DISK_FAILURE_ALARM
enableEmail Specifies whether individual alarm notifications are sent to any email address (including the default email address) for the alarm type:
  • 0 – Do not send notifications to any email address for the alarm type.
  • 1 – Send notifications to all email addresses for the alarm type.
 1
email One or more email addresses other than the default email address. If specified, alarm notifications are sent to these addresses as well, if enableEmail is set to 1. Multiple email addresses must be separated by spaces only. You cannot use commas or other delimiters. For example, user1@mycorp.com user2@mycorp.com is valid. jennifer-huang87@outlook.com

Example

The following example command configures an email to be sent to test@example.com whenever the Node Alarm Core Present alarm is generated:
maprcli alarm config save -values "NODE_ALARM_CORE_PRESENT,1,test@example.com"