Directed Discovery

Directed discovery is the process of manually adding nodes to Horizon through the requisition UI. Two other methods for manually adding nodes (quick adding a node and manually adding an interface) are in the process of being deprecated. We do not recommend using these features.

Make sure you complete the tasks in Step 3: Provision Inventory before adding nodes.

Add nodes through the requisition UI

Before adding nodes to a requisition, you must create a requisition.

  1. In the web UI, click the Gear symbol in the top-right of the screen.

  2. Choose Provisioning  Manage Provisioning Requisition.

  3. Click the Edit symbol beside the requisition that you want to add nodes to.

  4. Click Add Node. Horizon auto-generates the foreign ID used to identify this node.

  5. Enter the appropriate information in each of the tabs:

    Tab Settings

    Basic Information

    Required: Auto-generated foreign ID, node label
    Optional: Minion location, building, city

    Path Outage

    Parent foreign source, parent foreign ID, parent node label

    Interfaces

    Interface IP addresses, description, SNMP primary, services, actions

    Assets

    Pre-defined metadata types (name, value, actions)

    Categories

    Category name for node type (for example, Routers, Production)

    Meta-Data

    Customized asset information (scope, interface, service, and so on)

  6. Repeat for each node you want to add.

  7. Click Return to view the list of nodes you have added.

  8. Click Synchronize to provision them to the Horizon database.

Add nodes via REST API

You can use the REST API to add nodes to your Horizon database. There are endpoints for both individual nodes and entire requisitions.

Add nodes via newSuspect events

You can use the ${OPENNMS_HOME}/bin/send-event.pl script to generate newSuspect events to trigger the Provisiond service to check a given IP address. Replace ip-address in the command below with the address you want to discover.

# ${OPENNMS_HOME}/bin/send-event.pl --interface ip-address uei.opennms.org/internal/discovery/newSuspect
This adds the discovered node directly into the database. We strongly recommend that you use requisitions when adding individual IP addresses, as it will be easier to manage the nodes over time.