Page History

...

If this is not already configured by you then you will need to create your email server. opEvents requires an email server in order to sent notifications via email.  This email server is configured in /usr/local/omk/conf/opCommon.nmis. If you do not want to edit text files to configure this, it can be accomplished within the NMIS GUI as well. NMIS will symlink Email, UsersContacts, etc. already created to opEvents, keep this in mind throughout the guide and choose what works best for you.

1. Follow the Wiki guide and set up your Email server
   a. Information on setting up an Email server can be found here - Create Email Server
   b. Alternative Email configuration through NMIS resource - NMIS8 Email

Configure Contacts

...

1. Configure in opEvents by following the Wiki guide to assist in setting up your Contacts - Configure Contacts

      2. Alternatively, you can create Contacts within the NMIS GUI.
          a. Navigate to NMIS menu -> Setup -> Contact Setup
          b. Click 'add' next to Action > add
          c. Enter relevant information, click Add at the bottom to confirm.
Image Modified

Creating your Policy and Action

The policy consists of any number of nested if-this-then-that clauses, which specify the  conditions an event must conform to and what actions to take in case of a match. Further configuration sections specific to particular actions can be present in the same file. Create a policy that ensures that the engineers you want to alert by email, text, etc. are only alerted by the severity of the event that makes sense within your organization. Doing this reduces event noise allowing your team to quickly identify the important events. Use the examples within the links below as well as the default policies within the EventActions.nmis file json (EventActions.nmis for NMIS 8) file to help create a policy right for your environment.

1. Follow the basic example of creating a new Escalation Policy - Escalation Policy example
2. More detailed Escalation Policy examples and information - Event Actions and Escalation

      3. Escalation Policies can also be created within NMIS:
          a. Navigate to the NMIS menu -> System -> System Configuration -> Escalation Policy
          b. Click 'add' next to Action > add
          c. Enter the relevant information and click Add at the bottom to save.
Image Modified

Test your changes

The opevents-cli.exe utility found in /usr/local/omk/bin may be used to create a test event.  Create an event that will match a previously configured action rule. For example:

[root@opmantek conf]# /usr/local/omk/bin/opevents-cli.exe act=create-event node=testNode4 stateful=node state=down event="Node DOWN" priority=5
5997bb8cce2c2e6d9453c101

This command will return an event ID.  Go to the event context page for this event.  In the Actions section of the page there should be an entry stating an email was successfully sent.  Keep in mind that this entry will not be present until the flap window and escalation timers have elapsed.

...