HP-ICF-UDLD-MIB

All MIBs › HP-ICF-UDLD-MIB

Organization: HP Networking

Last Updated: 2014-06-15

Category: Protocol: UDLD, Technology: OAM, Technology: Switching/L2, Vendor: HP/HPE

Description: HP ICF SNMP MIB for Unidirectional Link Detection (UDLD) configuration and port state on HP ProCurve switches.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

What Is HP-ICF-UDLD-MIB?

HP-ICF-UDLD-MIB is an HP MIB, part of HP's ICF private-MIB architecture, for HP ProCurve switches implementing UDLD (UniDirectional Link Detection), a feature that detects one-way fiber/copper link faults that basic link-state monitoring would miss. It defines global timing configuration (hpicfUdldConfigTimeInterval, hpicfUdldConfigMaxRetries, hpicfUdldConfigForwardMode) plus per-port administrative configuration (hpicfUdldPortConfigTable, hpicfUdldPortAdminStatus, hpicfUdldPortVlanId) and per-port statistics/state (hpicfUdldPortStatsTable, hpicfUdldStatsPortCurrentState). Its monitoring value is fault detection for physical link integrity: administrators poll hpicfUdldStatsPortCurrentState to catch ports that have detected a unidirectional link condition, a common cause of spanning-tree loops or one-way connectivity issues, before it causes an outage, and receive hpicfUdldNotifications traps when such a state is detected. It builds on HP's standard ICF port/interface indexing conventions and complements standard IF-MIB link-state data. It's deployed on HP ProCurve switches wherever fiber links or long copper runs are used, since unidirectional faults are otherwise invisible to standard link-up/down monitoring. Engineers can download the HP-ICF-UDLD-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in HP-ICF-UDLD-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

HP ProCurve managed switch

Monitoring Examples

An administrator would poll hpicfUdldStatsPortCurrentState for each port in hpicfUdldPortStatsTable to catch a port that has detected a unidirectional link fault even though standard link-state shows it as up, a classic cause of intermittent spanning-tree loops. Checking hpicfUdldPortAdminStatus confirms UDLD is enabled on the suspect port, and hpicfUdldConfigMaxRetries/hpicfUdldConfigTimeInterval reveal how aggressively the feature is configured to detect faults. An hpicfUdldNotifications trap firing for a specific port would immediately flag the fault to the NMS without waiting for a manual poll.

What Can Be Monitored

per-port UDLD current state
per-port UDLD admin status
UDLD detection time interval
UDLD max retries
UDLD notifications/traps

Imported Objects

From HP-ICF-OID

hpSwitch

OBJECT-IDENTITY

From IF-MIB

ifIndex

OBJECT-TYPE

From SNMPv2-CONF

MODULE-COMPLIANCE
NOTIFICATION-GROUP
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Integer32
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

MacAddress
TruthValue

How to Use in IPNetwork Monitor

Example using hpicfUdldStatsPortTotalTx OID:

Select an HP ProCurve managed switch (UniDirectional Link Detection) as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type hpicfUdldStatsPortTotalTx into the Find box to locate it in the OID tree, selecting the specific row/instance you want to monitor since this is a table column, then select it and click OK. The number of UDLD control packets sent from this port. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is a Counter32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases sharply between polls relative to its normal baseline, since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
hpicfUdldMIB	1.3.6.1.4.1.11.2.14.11.5.1.33			This MIB module describes objects to configure the UniDirectional Link Detection (UDLD) feature.
hpicfUdldNotifications	1.3.6.1.4.1.11.2.14.11.5.1.33.0
hpicfUdldNotificationPrefix	1.3.6.1.4.1.11.2.14.11.5.1.33.0.0
NTF hpicfUdldLinkfault	1.3.6.1.4.1.11.2.14.11.5.1.33.0.0.1			This notification is generated when the link failure occurs.
NTF hpicfUdldLinkUp	1.3.6.1.4.1.11.2.14.11.5.1.33.0.0.2			This notification is generated when UDLD link goes from down to up.
hpicfUdldObjects	1.3.6.1.4.1.11.2.14.11.5.1.33.1
hpicfUdldConfig	1.3.6.1.4.1.11.2.14.11.5.1.33.1.1
U32 hpicfUdldConfigTimeInterval	1.3.6.1.4.1.11.2.14.11.5.1.33.1.1.1	Unsigned32	read-write	The interval in deciseconds between UDLD packets. The same interval can also be set in milliseconds with hpicfUdldConfigTimeIntervalMs.
U32 hpicfUdldConfigMaxRetries	1.3.6.1.4.1.11.2.14.11.5.1.33.1.1.2	Unsigned32	read-write	The number of unanswered UDLD packets allowed before declaring the link faulty.
hpicfUdldPortConfigTable	1.3.6.1.4.1.11.2.14.11.5.1.33.1.1.3		not-accessible	The table that controls UDLD status on individual ports.
hpicfUdldPortConfigEntry	1.3.6.1.4.1.11.2.14.11.5.1.33.1.1.3.1		not-accessible	An entry in the hpicfUdldPortConfigTable.
INT hpicfUdldPortAdminStatus	1.3.6.1.4.1.11.2.14.11.5.1.33.1.1.3.1.1	INTEGER	read-write	The hpicfUdldPortAdminStatus can be enabled/disabled The value enable(1) means that UDLD is enabled. the value disable(2) means that UDLD is disabled.
I32 hpicfUdldPortVlanId	1.3.6.1.4.1.11.2.14.11.5.1.33.1.1.3.1.2	Integer32	read-write	The vlan id associated with tagged UDLD control packets. The value of 0 indicates that UDLD control packets are untagged.
INT hpicfUdldConfigForwardMode	1.3.6.1.4.1.11.2.14.11.5.1.33.1.1.4	INTEGER	read-write	The port transmission mode while UDLD verification is in progress. The value 'verifyThenForward' will block ports until a successful UDLD exchange is established. The value forwardThenVerify will forward traffic normally while UDLD link verification is in progress and ports will not be blocked until the UDLD retry count is exceeded.
U32 hpicfUdldConfigTimeIntervalMs	1.3.6.1.4.1.11.2.14.11.5.1.33.1.1.5	Unsigned32	read-write	The interval in milliseconds between sending UDLD packets. The default is 5 seconds. Some devices may not allow values less than 1 second due to the load it puts on the CPU. Devices that do allow values less than 1 second may restrict the number of ports that can have UDLD enabled. Some devices may also round the value up to a multiple of their clock granularity, for example 33ms.
hpicfUdldStats	1.3.6.1.4.1.11.2.14.11.5.1.33.1.2
hpicfUdldPortStatsTable	1.3.6.1.4.1.11.2.14.11.5.1.33.1.2.1		not-accessible	A table containing UDLD statistics for individual ports.
hpicfUdldPortStatsEntry	1.3.6.1.4.1.11.2.14.11.5.1.33.1.2.1.1		not-accessible	UDLD statistics for a particular physical port.
INT hpicfUdldStatsPortCurrentState	1.3.6.1.4.1.11.2.14.11.5.1.33.1.2.1.1.1	INTEGER	read-only	The desired status of UDLD on a port. If the associated hpicfUdldStatsPortCurrentState object has a value of 'offline(1)', then the port or udld is administratively disabled. If the associated hpicfUdldStatsPortCurrentState object has a value of 'failure(2)', then the port and udld are administratively enabled, but udld packets are not being received successfully. Link may or may not be present. If the associated hpicfUdldStatsPortCurrentState object has a value of 'up(3)', then udld is enabled and udld packets are being received successfully in both directions.
MAC hpicfUdldStatsPortNeighborMAC	1.3.6.1.4.1.11.2.14.11.5.1.33.1.2.1.1.2	MacAddress	read-only	The MAC address of the adjacent switch.
I32 hpicfUdldStatsPortNeighborPort	1.3.6.1.4.1.11.2.14.11.5.1.33.1.2.1.1.3	Integer32	read-only	The port number of the adjacent switch.
C32 hpicfUdldStatsPortTotalTxEx	1.3.6.1.4.1.11.2.14.11.5.1.33.1.2.1.1.4	Counter32	read-only	The number of UDLD control packets sent from this port.
C32 hpicfUdldStatsPortTotalRx	1.3.6.1.4.1.11.2.14.11.5.1.33.1.2.1.1.5	Counter32	read-only	The number of UDLD control packets received on this port.
C32 hpicfUdldStatsPortNumStateChange	1.3.6.1.4.1.11.2.14.11.5.1.33.1.2.1.1.6	Counter32	read-only	The number of state transitions.
I32 hpicfUdldStatsPortStatus	1.3.6.1.4.1.11.2.14.11.5.1.33.1.2.1.1.7	Integer32	read-only	The value of this object indicates whether the port is blocked by UDLD or not.
T/F hpicfUdldStatsClearAll	1.3.6.1.4.1.11.2.14.11.5.1.33.1.2.2	TruthValue	read-write	When the value of this object is set to TRUE, the UDLD transmit, receive and state change statistics are cleared. A get request for this object always returns FALSE.
hpicfUdldConformance	1.3.6.1.4.1.11.2.14.11.5.1.33.2
hpicfUdldCompliances	1.3.6.1.4.1.11.2.14.11.5.1.33.2.1
hpicfUdldCompliance	1.3.6.1.4.1.11.2.14.11.5.1.33.2.1.1			The compliance statement for SNMP entities which implement the UDLD MIB.
hpicfUdldCompliance2	1.3.6.1.4.1.11.2.14.11.5.1.33.2.1.2			The compliance statement for SNMP entities that implement the UDLD MIB.
hpicfUdldCompliance3	1.3.6.1.4.1.11.2.14.11.5.1.33.2.1.3			The compliance statement for SNMP entities that implement the UDLD MIB.
hpicfUdldGroups	1.3.6.1.4.1.11.2.14.11.5.1.33.2.2
hpicfUdldPortConfigGroup	1.3.6.1.4.1.11.2.14.11.5.1.33.2.2.1			The collection of objects which are used to configure the UDLD implementation behavior. This group is mandatory for ports which implement the UDLD.
hpicfUdldPortStatsGroup	1.3.6.1.4.1.11.2.14.11.5.1.33.2.2.2			The collection of objects which are used to represent UDLD statistics. This group is mandatory for ports which implement the UDLD.
hpicfUdldNotificationGroup	1.3.6.1.4.1.11.2.14.11.5.1.33.2.2.3			Notification used for signaling change in Link state.
hpicfUdldStatsGroup	1.3.6.1.4.1.11.2.14.11.5.1.33.2.2.4			The collection of objects that are used to perform operations on UDLD related statistics.
hpicfUdldPortConfigGroup1	1.3.6.1.4.1.11.2.14.11.5.1.33.2.2.5			The collection of objects which are used to configure the UDLD implementation behavior. This group is mandatory for ports which implement the UDLD.

RFC description

Configures Unidirectional Link Detection (UDLD) to identify and disable half-duplex links on HP networking switches.

Start monitoring HP ProCurve managed switch (UniDirectional Link Detection) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download HP-ICF-UDLD-MIB