Step 2: Turn on Default Notifications

This section describes how to turn default notifications on in Horizon.

Horizon uses notifications to inform users about events in the network without requiring them to log in to the web UI. Notifications are commonly sent through email and text or pager messages, but can be customized to send to a variety of external systems. For additional information, including alternative notification mechanisms, see Notifications in the Deep Dive section and the notifd reference section.

Enable notifications

Notifications are disabled by default in a fresh Horizon installation, as indicated by the red bell symbol in the menu bar:

red bell notifications

Follow these steps to enable notifications:

  1. Log out of the admin account and log in as the user you created in Step 1: First-Time Login.

  2. Click the gear symbol in the top-right of the screen.

  3. Under Event Management, click On beside Notification Status, and click Update. The red bell symbol in the top menu bar turns green, indicating that notifications are enabled globally.

notifications-on
The workflow above is functionally equivalent to editing ${OPENNMS_HOME}/etc/notifd-configuration.xml and setting status="on" in the top-level notifd-configuration element. This configuration file update happens immediately, with no need to restart Horizon.

The following event notifications are defined by default:

Notification Default State

High threshold

OFF

High threshold rearmed

OFF

Low threshold

OFF

Low threshold rearmed

OFF

interfaceDeleted

ON

interfaceDown

ON

nodeAdded

ON

nodeDown

ON

nodeLostService

ON

You can turn them on or off on the Configure Event Notifications screen. See Notifications in the Deep Dive section for more information.

Configure destination paths

A destination path specifies the "who" (recipient), "when" (delay), and "how" (method) of a notification. It also specifies escalation targets. Configuring destination paths separately for individual events lets you use the same information for multiple notifications. This encourages reuse and minimizes duplication.

You must specify a destination path to receive notifications from Horizon. The Email-Admin destination path is defined by default, and is the notification path when no other destination paths are specified. It sends email notifications to users in the Admin group.

For the Email-Admin destination path to work, you have to configure your email server, which is beyond the scope of this Quick Start guide. For this example, we will specify a destination path that sends browser pop-up notifications to users in the Admin group (currently, the default admin user and the personalized user that you created in Step 1: First-Time Login).

  1. Click the gear symbol in the top-right of the screen.

  2. Under Event Management, click Configure Notifications  Configure Destination Paths.

  3. Click New Path and configure it:

    1. Specify a name for the path (for example, "Browser") and define an initial delay. The initial delay specifies how long to wait before sending the first notification.

    2. Click Edit.

    3. Under Send to Selected Groups, choose the Admin group.

    4. Click Next Step.

    5. You are prompted to define the time to wait between sending notifications to each member of a group. For the purpose of this Quick Start guide, do not specify a delay interval, and click Next Step.

    6. Select Browser from the list of commands and make sure that it is on.

    7. Click Next Step.

      The Admin group and the email address you specified appear in the Initial Targets list.

  4. Verify the settings, and click Finish.

Users in the Admin group will see pop-up notifications in their browsers about events in Horizon.