Feature Overview

opEvents has the ability to notify people via email and conduct other actions based on criteria the administrator selects.

Order of operation:

• 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 addresses.
• Emails are sent via an associated email server.

Configuration

Declare an Email Server

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

   'email' => {
    'mail_domain' => 'yourdomain.com',
    'mail_from' => 'yourmailname@yourdomain.com',
    'mail_password' => 'your_password',
    'mail_server' => 'smtp.yourdomain.com',
    'mail_server_port' => 25,
    'mail_use_sasl' => 'false',
    'mail_use_tls' => 'true',
    'mail_user' => 'your_user_account@your_domain.com'
  },

Find the email section in opCommon.nmis and updated the values to match the email server that opEvents should utilise.

Optional - Create an Email Template

If it's desirable to have the notification email customised

Configure a Contact

A 'contact' in variable that can represent one or many email addresses.  opEvents can utilize the NMIS contacts file or the OMK contacts file.  In order to determine which file your system is using look in opCommon.nmis; find the opevents section then look for the opevents_contacts attribute.

  'opevents' => {
    'black_list_enabled' => 'true',
    'log_archive_enabled' => 'true',
    'nmis_non_stateful_events' => 'Node Configuration Change|Node Reset',
    'opevents_action_max_runtime' => 30,
    'opevents_action_policy' => '<omk_conf>/EventActions.nmis',
    'opevents_application_heading' => undef,
    'opevents_archivelogs_purge_older_than' => undef,
    'opevents_auto_acknowledge' => 'true',
    'opevents_auto_acknowledge_up' => 'true',
    'opevents_auto_create_nodes' => 'true',
    'opevents_contacts' => '<omk_conf>/Contacts.nmis',

In the example above (last line) the OMK contacts file is being used.

Create an Escalation Policy

Create an Action

Verification