Skip to main content
Version: 7.9

Email Notification Profile

Inductive University

Email Notification Profile

Watch the video

Alarm notification is the act of sending an email message to a group of people when an alarm becomes active or cleared. In Ignition, this functionality is enabled by having the Alarm Notification Module installed which provides alarm pipelines and email notification.

Once you have your Email Notification Profile created in Ignition, you can notify people when alarms occur via Email. If the two-way setting is enabled, operators can also acknowledge the alarm by clicking the link in the body of the email.

Let's get started setting up an Email Notification Profile.

How to Create an Email Notification Profile

  1. Go to the Configure section of the Gateway webpage.
  2. Select Alarming > Notification from the menu on the left side. The Alarm Notification Profiles page will be displayed.

Alarm Notification Gateway Config List

  1. Click on the Create new Alarm Notification Profile link.

Alarm Notification Create New Pipeline

  1. A list of available alarm notification profiles appear. If any of the profiles are not displayed, it means the required module is missing, or faulted. (To verify that the Alarm Notification Module is installed and running, click on Modules from the menu bar on the left side). Choose Email Notification, and click Next.

Alarm Notification Email Setup Step 1

  1. Configure the settings for the Email Notification Profile, and then click Create New Alarm Notification Profile.
    • Enter a Name: Email 1
    • Click the Enabled box to enable Email notifications.
    • Enter the Hostname. This is the hostname of the SMTP server that will be responsible for sending the emails. 
    • Enter the Port. The default is Port 25, but your mail server may be different. 
    • Enable SSL/TLS if you are using encryption.
    • Enter your Username and Password if they are required.
    • Click the Two-way Enable box if you want to make your Email Notification Profile two-way so that the operator can acknowledge the email. There is a link to acknowledge the alarm in the email.
      note

      You must have a connection back to the Ignition Gateway. So, if you are working from home and not on a VPN, you will either have to get on a VPN or expose your Ignition server on the internet. You can do this with port forwarding, talk to your IT department about it.

    • Auditing: You have the option of attaching emails to an Audit profile so that Ignition can store all the events associated with the Email Notification Profile. (I.e., who is receiving alarm and who is acknowledging an alarm).

Alarm Notification Email Setup Step 5 Alarm Notification Email Notification Step 5 Pt 2

  1. Once you create your Email Notification Profile, it will appear in the Alarm Notification Profiles list, and it will be running. You can edit the profile at any time to change any of the settings, and create as many Email Notification Profiles as you need.

Alarm Notification Profiles on GW Webpage

tip

Once your Notification profile is created, you can use it in an Alarm Pipeline.

Email Notification Profile Settings

Email Settings

These settings specify the SMTP server that should deliver the emails. Multiple Ignition Gateways may be configured to use the same SMTP server.

Property NameDescription
Use SMTP Profile?If selected, this notification profile will use one of the Gateway-defined SMTP profiles, Otherwise, it will use the settings defined here.
The setting should NOT be enabled unless an SMTP Profile has been configured elsewhere on the Gateway. Enabling this property causes the profile to ignore the Hostname and Port properties listed below.
SMTP ProfileIf the Use SMTP Profile property is enabled, alarm notifications will be emailed using this profile.
HostnameHostname of the SMTP server to send email through.
Only used when Use SMTP Profile is false.
PortPort SMTP service is running on.
Only used when Use SMTP Profile is false.
Enable SSL/TLSConnect Using SSL/TLS.
Only used when Use SMTP Profile is false.
UsernameThe username Ignition should use when communicating with the SMTP server. This is only required if the SMTP server expects authentication.
Only used when Use SMTP Profile is false.
PasswordThe password Ignition will use to authenticate against the SMTP server. This is only required if the SMTP server expects authentication.

Two Way Settings

These settings allow users to acknowledge alarms directly from the Email Notification. When enabled, a link is included in the email that will redirect to a page on the Gateway.

Property NameDescription
Two-way EnabledEnables remote alarm acknowledgement. If disabled, users will not be able to acknowledge alarms from the email.
GatewayNetwork address and port the Gateway is reachable at. Will be used in notification emails.
Send HTTPS LinkSpecifies if the link should use an HTTPS link for SSL.

POP3 Two-way Settings

New in 7.9.1
These settings allows Notifications to be acknowledged from when retrieved from a POP3 mailserver. Multiple Ignition Gateways may be configured to use the same POP3 server.
Property NameDescription
Pop3 Two-way EnabledEnable two-way notification via POP3.
Enable SSL/TLSEnables SSL/TLS between the Gateway and the mailserver.
Delete On AcknowledgeIf enabled, will delete messages from the inbox after acknowledging an alarm.
HostnameThe hostname of the mailserver.
PortThe port the mailserver is running on.
UsernameThe username the Gateway will use when authenticating against the mailserver.
PasswordThe password the Gateway will use when authenticating against the mailserver.
Custom MessageAllows an opportunity to provide an additional message to the notification. This custom message is in addition to the Custom Messages configured on the Alarm and the Notification Blocks in the Alarm Pipeline.
Polling IntervalThe interval (in milliseconds) that the Gateway will check for new notifications.

Auditing

Property NameDescription
Audit ProfileIf an audit profile is selected, events such as emails and acknowledgements will be stored to the audit system. Note that alarm acknowledgements are also stored to the alarm journal.

Advanced

Property NameDescription
SMTP TimeoutTimeout (in milliseconds) to use when connecting to, reading from, and writing to the SMTP server.
Debug Mode EnabledEnable email session debugging. Information is printed to standard output (wrapper.log).
STARTTLS EnabledEnable use of the STARTTLS command, allowing the connection to be upgraded to an SSL or TLS connection if supported by the server. This is not necessary for connections that are already SSL/TLS. Ignored when Use SMTP Profile is checked.