Child pages
  • opEvents - Solution Guide - Setup Email Notifications and Other Actions

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: added description of fields


  • An event matches criteria defined in an action rule.
  • An action fires an escalation policy.
  • The Escalation policy initiates email or some other action.  The email action calls a 'contact' variable.
  • The contact variable is resolved to an email address or multiple
  • The event action policy indicates that an email action is to be taken, with a given 'contact'.
  • Or: the event action activates an escalation policy, the event is escalated after some time and the Escalation policy indicates an email action to take, again with a given 'contact.
  • The named 'contact' is resolved to one or more email addresses.
  • Emails are sent via an associated the configured email server.

Related Wiki Articles



Define an Email Server

opEvents requires an email server in order to sent notifications via email.  This email server is associated in configured in /usr/local/omk/conf/opCommon.nmis.

Code Block
   'email' => {
    'mail_domain' => '',
    'mail_from' => '',
    'mail_password' => 'your_password',
    'mail_server' => '',
    'mail_server_port' => 25,
    'mail_use_sasl' => 'false',
    'mail_use_tls' => 'true',
    'mail_user' => ''

Find Open opCommon.nmis in an editor, find the email section in opCommon.nmis and update the values to match the email server that opEvents should utilise.

Here is a brief description of the fields:

Field NameDescription
mail_domainThis is required for some mail servers that enforce strict HELO messages. Using your company domain here is a good idea.
mail_fromThis is the From address for email notifications. Emails will go out with this as the sender.
mail_userThis is the mail user name for authenticating at your mail server. Leave this blank if you don't need to authenticate at your mail server.
mail_passwordThis is the password for authenticating at your mail server. Leave this blank if you don't need to authenticate at your mail server.
mail_serverThe FQDN (or IP address) of your outgoing mail server.
mail_server_portThe port number your mail server listens on for SMTP conversations. Common choices are 25 and 587, but note that 587 commonly requires authentication!
mail_use_tlsIf you select true here, then opEvents will try to negotiate STARTTLS encryption with your mail server. Not useful if your mail server is localhost.
mail_use_sasldisregard: deprecated, should not be present in new installations.



Optional - Create an Email Template