IP Interface Policy
The Matching IP Interface policy (MatchingIpInterfacePolicy) controls whether interfaces discovered during a node scan are persisted, and, if they are, whether they are managed or unmanaged.
Set the action parameter to one of the values below.
| Action | Description |
|---|---|
DISABLE_COLLECTION |
Disallow collecting performance metrics on the interface. |
DISABLE_SNMP_POLL |
Disallow SNMP polling on the interface. |
DO_NOT_PERSIST |
Prevent the IP interface from being added to the node. |
ENABLE_COLLECTION |
Allow collecting performance metrics on the interface. |
ENABLE_SNMP_POLL |
Allow SNMP polling on the interface. |
MANAGE |
Add interface to node and allow polling and collection. |
UNMANAGE |
Add interface to node but do not process pollerd and collectd tasks for the interface. |
The web UI requires you to set both action and matchBehavior before it will save the policy.
matchBehavior is otherwise optional and defaults to ANY_PARAMETER.
|
This policy also accepts the common matchBehavior parameter.
See Policies for matchBehavior and the ~ regular-expression prefix.
Match criteria
| Property | Description |
|---|---|
ipAddress |
IP address of the discovered interface. |
ipHostName |
Resolved host name of the interface. |
Persistence
This policy is reapplied on each subsequent scan or reimport of the requisition.
Note that UNMANAGE does not delete an interface — it keeps the interface and marks it unmanaged.
A DO_NOT_PERSIST match keeps a discovered interface from being persisted; a non-primary interface that was persisted on an earlier scan is then removed during scan reconciliation (the primary interface is never removed this way).
To delete a specific interface outright, recreate the node in the Requisition UI (change the foreign ID and reimport the group) or use the REST API:
> curl -X DELETE -H "Content-Type: application/xml" -u admin:admin http://localhost:8980/opennms/rest/nodes/6/ipinterfaces/10.1.1.1For configuration examples, see Policy Examples.