Configuring alarms Configure events to trigger alarms
Digi TransPort® Routers User Guide
683
Configure sending email alert messages when events occur
About using email templates
One of the key features provided by the event log function is the ability to configure the router to
automatically generate and send an email alert message each time an event of up to a specified
priority occurs. The format of the message is determined by the email template specified in the Use
email template file parameter, normally event.eml, and on the Configuration > Alarms > Event
Settings > Email Notifications web page.
If the standard event.eml template supplied with the router is not suitable, you can create your own
template. An email template is a text file that defines the appearance and content of the email
messages generated by the event logger.
Email template structure
An email template consists of a header section followed by a body section. One or more blank lines
separate the two sections.
Header section
The header section MUST contain the following three fields:
TO
Used to specify at least one recipient’s email address. Multiple addresses may be included and must
be separated by a space, comma or semicolon character. For example:
To: 123@456. com, 456@123. com; abc. def . com
FROM
The email address of the sending unit. Alternatively, you can enter a simple string. This may depend on
the SMTP server as to what is accepted. For example:
FROM: WR44
Or:
FROM: wr 44@mycompany. com
SUBJECT
A string describing the subject of the email message. For example:
Subj ect : Aut omat ed message f r om r out er
Other fields
In addition to the required fields described above, the header section of an email can also contain one
or more optional fields. Many such fields are defined in the relevant RFCs, but there are some fields
the router handles a little differently, as described below. The router inserts other fields as necessary
if it is required to send attachments with the email.
Reply To
If the router discovers this field is not present in the email template, it inserts this field into the
header. The string for this field is the one configured by the smtp 0 reply_to CLI command (or the use
Reply To address parameter in the Configuration > Alarms > SMTP Account web page). This allows