HP-ICF-FAULT-FINDER-MIB DEFINITIONS ::= BEGIN IMPORTS Integer32, MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE FROM SNMPv2-SMI TimeStamp, TEXTUAL-CONVENTION FROM SNMPv2-TC MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP FROM SNMPv2-CONF PhysicalIndex, PhysicalClass FROM ENTITY-MIB hpicfObjectModules, hpicfCommon, hpicfCommonTrapsPrefix FROM HP-ICF-OID; hpicfFaultFinderMib MODULE-IDENTITY LAST-UPDATED "200701091456Z" -- January 9, 2007 ORGANIZATION "Hewlett-Packard Company, Procurve Networking Business" CONTACT-INFO "Hewlett-Packard Company 8000 Foothills Blvd. Roseville, CA 95747" DESCRIPTION "This MIB module contains object definitions for managing the Fault Finder feature in web-capable HP devices." REVISION "200701091456Z" -- January 9, 2007 DESCRIPTION "Added hpicfFfLogPhysEntity to hpicfFaultFinderTrap." REVISION "200505021934Z" -- May 2, 2005 DESCRIPTION "Added 3 new Transceiver related fault messages." REVISION "200503221130Z" -- March 22, 2005 DESCRIPTION "Added Transceiver related fault messages, jumbos/flow control fault. Also added Connection-Rate-Filtering fault type to extend support for virus throttling." REVISION "200307280707Z" -- July 28, 2003 DESCRIPTION "Add duplexMismatch type. Update division name." REVISION "200011030707Z" -- November 3, 2000 DESCRIPTION "Add lossOfStackMember and hotSwapReboot fault types. Update division name." REVISION "9811202350Z" -- November 20, 1998 DESCRIPTION "Added several fault types, and the ability to reduce a port's speed as one of the actions to take on a fault." REVISION "9710210249Z" -- October 21, 1997 DESCRIPTION "Initial version of this MIB module." ::= { hpicfObjectModules 12 } hpicfFaultFinder OBJECT IDENTIFIER ::= { hpicfCommon 7 } HpicfFaultType ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "An enumerated value which indicates a type of fault which is monitored by the agent." SYNTAX INTEGER { badDriver(1), badXcvr(2), badCable(3), tooLongCable(4), overBandwidth(5), bcastStorm(6), partition(7), misconfiguredSQE(8), polarityReversal(9), networkLoop(10), lossOfLink(11), portSecurityViolation(12), backupLinkTransition(13), meshingFault(14), fanFault(15), rpsFault(16), stuck10MbFault(17), lossOfStackMember(18), hotSwapReboot(19), duplexMismatchHDX(20), duplexMismatchFDX(21), flowcntlJumbosFault(22), portSelftestFailure(23), xcvrUnidentified(24), xcvrUnsupported(25), crfNotify(26), crfThrottled(27), crfBlocked(28), xcvrNotYetSupported(29), xcvrBRevOnly(30), xcvrNotSupportedOnPort(31), phyReadFailure(32) } HpicfFaultTolerance ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "Objects of this type are used to scale internal fault thresholds between hard-coded minimum and maximum threshold values as follows: actual = min + ((max - min) * tol)/maxTol where: actual - actual threshold used by Fault Finder min - minimum threshold for this fault max - maximum threshold for this fault tol - configured tolerance for this fault maxTol - maximum tolerance value (255)" SYNTAX Integer32 (0..255) HpicfFaultAction ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "Objects of this type are used to indicate actions taken on detection of a fault." SYNTAX INTEGER { none(1), warn(2), warnAndDisable(3), warnAndSpeedReduce(4), warnAndSpeedReduceAndDisable(5) } HpicfUrlString ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "This TC describes an object which holds a reference to a (remote) resource by using the Uniform Resource Locator (URL) notation as defined in RFC 1738. The allowed character set and the encoding rules for this textual convention are defined in RFC 1738 section 2.2." SYNTAX OCTET STRING (SIZE(0..255)) hpicfFfControlTable OBJECT-TYPE SYNTAX SEQUENCE OF HpicfFfControlEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table contains one entry per fault type that this agent is capable of monitoring." ::= { hpicfFaultFinder 1 } hpicfFfControlEntry OBJECT-TYPE SYNTAX HpicfFfControlEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Configuration information for a particular fault type." INDEX { hpicfFfControlIndex } ::= { hpicfFfControlTable 1 } HpicfFfControlEntry ::= SEQUENCE { hpicfFfControlIndex HpicfFaultType, hpicfFfAction HpicfFaultAction, hpicfFfWarnTolerance HpicfFaultTolerance, hpicfFfDisablePortTolerance HpicfFaultTolerance, hpicfFfSpeedReduceTolerance HpicfFaultTolerance } hpicfFfControlIndex OBJECT-TYPE SYNTAX HpicfFaultType MAX-ACCESS not-accessible STATUS current DESCRIPTION "The type of fault for which this entry contains configuration information." ::= { hpicfFfControlEntry 1 } hpicfFfAction OBJECT-TYPE SYNTAX HpicfFaultAction MAX-ACCESS read-write STATUS current DESCRIPTION "This object is used to configure the action, if any, to be taken if a fault of this type is detected by the agent. Setting an instance of this object to 'none' will clear any previous state of the associated fault on all ports. This object is used to enable or disable the port disable feature for this fault type. Setting this object to 'warnAndDisable' will enable the port disable feature for this fault type. This feature is intended to allow an agent to disable ports that are being disruptive to the rest of the network. Note that not all agents will support setting this object to 'warnAndDisable'. The agent may choose not to disable a particular port for a particular fault based on its knowledge of if/how that fault disrupts the network." ::= { hpicfFfControlEntry 2 } hpicfFfWarnTolerance OBJECT-TYPE SYNTAX HpicfFaultTolerance MAX-ACCESS read-write STATUS current DESCRIPTION "The tolerance level used to calculate the fault warning threshold for this fault type. The agent will periodically check relevant statistics for each port for each type of fault. If the warning threshold has been exceeded, and fault warning action is enabled for that fault type, an hpicfFaultFinderTrap notification will be sent. In addition, an entry will be made in the hpicfFfLogTable for the fault. Once a fault warning has fired, a hysteresis mechanism assures that another warning will not be fired until the relevant counter drops below a hysteresis threshold value." ::= { hpicfFfControlEntry 3 } hpicfFfDisablePortTolerance OBJECT-TYPE SYNTAX HpicfFaultTolerance MAX-ACCESS read-write STATUS current DESCRIPTION "The tolerance level used to calculate the port disable threshold for this fault type. The value of an instance of this object MUST be greater than the value of the corresponding instance of the hpicfFfWarnTolerance. The agent will periodically check relevant statistics for each port for each type of fault. If the port disable threshold has been exceeded, and port disable is enabled for that fault type, an hpicfFaultFinderTrap notification will be sent. In addition, an entry will be made in the hpicfFfLogTable for the fault. Ports will not be disabled until at least one polling interval after a warning has fired. In addition, the agent may further delay disabling a port in certain situations. For example, it may choose to delay disabling a cascade port to give the cascaded device a chance to correct the problem." ::= { hpicfFfControlEntry 4 } hpicfFfSpeedReduceTolerance OBJECT-TYPE SYNTAX HpicfFaultTolerance MAX-ACCESS read-write STATUS current DESCRIPTION "The tolerance level used to calculate the speed reduce threshold for this fault type. The value of an instance of this object MUST be greater than the value of the corresponding instance of the hpicfFfWarnTolerance, and less than or equal to the corresponding instance of hpicfFfDisablePortTolerance. The agent will only speed reduce on a port if auto-negotiation has been performed, and the partners link abilities allow operation at a slower media speed. The agent will periodically check relevant statistics for each port for each type of fault. If the speed reduce threshold has been exceeded, and speed rededuction option is enabled for that fault type, an hpicfFaultFinderTrap notification will be sent. In addition, an entry will be made in the hpicfFfLogTable for the fault. The agent may elect to not or delay speed reduction of certain ports. For example, it may choose to delay taking action on a cascade port to give the cascaded device a chance to correct the problem." ::= { hpicfFfControlEntry 5 } hpicfFfLogTable OBJECT-TYPE SYNTAX SEQUENCE OF HpicfFfLogEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A log of fault warnings and ports disabled by the Fault Finder." ::= { hpicfFaultFinder 2 } hpicfFfLogEntry OBJECT-TYPE SYNTAX HpicfFfLogEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the Fault Finder log, containing information about a single fault." INDEX { hpicfFfLogIndex } ::= { hpicfFfLogTable 1 } HpicfFfLogEntry ::= SEQUENCE { hpicfFfLogIndex Integer32, hpicfFfLogCreateTime TimeStamp, hpicfFfLogPhysEntity PhysicalIndex, hpicfFfLogFaultType HpicfFaultType, hpicfFfLogAction HpicfFaultAction, hpicfFfLogSeverity INTEGER, hpicfFfLogStatus INTEGER, hpicfFfLogPhysClass PhysicalClass, hpicfFfLogInfoType INTEGER, hpicfFfLogInfo OCTET STRING } hpicfFfLogIndex OBJECT-TYPE SYNTAX Integer32 (1..2147483647) MAX-ACCESS not-accessible STATUS current DESCRIPTION "An arbitrary value which uniquely identifies this log entry. The index for a particular log entry must not change, even though entries with lower valued indices have been deleted." ::= { hpicfFfLogEntry 1 } hpicfFfLogCreateTime OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "The value of sysUpTime when this log entry was added to the hpicfFfLogTable." ::= { hpicfFfLogEntry 2 } hpicfFfLogPhysEntity OBJECT-TYPE SYNTAX PhysicalIndex MAX-ACCESS read-only STATUS current DESCRIPTION "The entPhysicalIndex of the device port or other physical component on which the fault was detected. On agents which do not implement the Entity MIB, this will contain the ifIndex of the offending port." ::= { hpicfFfLogEntry 3 } hpicfFfLogFaultType OBJECT-TYPE SYNTAX HpicfFaultType MAX-ACCESS read-only STATUS current DESCRIPTION "The type of fault which was detected on the physical entity indicated by hpicfFfLogPhysEntity." ::= { hpicfFfLogEntry 4 } hpicfFfLogAction OBJECT-TYPE SYNTAX HpicfFaultAction MAX-ACCESS read-only STATUS current DESCRIPTION "The action, if any, that was taken by the agent when this fault was detected." ::= { hpicfFfLogEntry 5 } hpicfFfLogSeverity OBJECT-TYPE SYNTAX INTEGER { informational(1), medium(2), critical(3) } MAX-ACCESS read-only STATUS current DESCRIPTION "The severity level of the fault. Port disables will always be logged as 'critical'. An agent may need to remove faults from the fault log in order to reclaim resources. If so, it must remove lower severity faults before removing higher severity faults. Faults at the same severity level should be removed from oldest to newest." ::= { hpicfFfLogEntry 6 } hpicfFfLogStatus OBJECT-TYPE SYNTAX INTEGER { new(1), active(2), old(3) } MAX-ACCESS read-write STATUS current DESCRIPTION "Log entries will initially be created with the value 'new'. A manager cannot set this object to 'new'. Setting this object to 'active' indicates that the fault has been displayed to a user. Setting this object to 'old' indicates that the agent should remove this fault from the log." ::= { hpicfFfLogEntry 7 } hpicfFfLogPhysClass OBJECT-TYPE SYNTAX PhysicalClass MAX-ACCESS read-only STATUS current DESCRIPTION "The PhysicalClass as defined by Entity MIB to which this hpicfFfLogPhysIndex belongs. " ::= { hpicfFfLogEntry 8 } hpicfFfLogInfoType OBJECT-TYPE SYNTAX INTEGER { ipv4Address(1), displayString(2) } MAX-ACCESS read-only STATUS current DESCRIPTION "This field can be used to indicate the class of information that 'hpicfFfLogInfo' holds" ::= { hpicfFfLogEntry 9 } hpicfFfLogInfo OBJECT-TYPE SYNTAX OCTET STRING (SIZE (0..255)) MAX-ACCESS read-only STATUS current DESCRIPTION "This can be used to hold any relevant information about the current fault" ::= { hpicfFfLogEntry 10 } hpicfFfFaultInfoURL OBJECT-TYPE SYNTAX HpicfUrlString MAX-ACCESS accessible-for-notify STATUS current DESCRIPTION "A URL which a management station can use to access additional information about the fault which triggered the notification in which this object was sent." ::= { hpicfFaultFinder 3 } hpicfFaultFinderTrap NOTIFICATION-TYPE OBJECTS { hpicfFfLogFaultType, hpicfFfLogAction, hpicfFfLogSeverity, hpicfFfFaultInfoURL, hpicfFfLogPhysEntity } STATUS current DESCRIPTION "This notification is sent whenever the Fault Finder creates an entry in the hpicfFfLogTable." ::= { hpicfCommonTrapsPrefix 5 } hpicfFaultFinderConformance OBJECT IDENTIFIER ::= { hpicfFaultFinderMib 1 } hpicfFaultFinderCompliances OBJECT IDENTIFIER ::= { hpicfFaultFinderConformance 1 } hpicfFaultFinderGroups OBJECT IDENTIFIER ::= { hpicfFaultFinderConformance 2 } hpicfFaultFinderCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for devices implementing the HP Fault Finder capability." MODULE MANDATORY-GROUPS { hpicfFaultConfigGroup, hpicfFaultLogGroup, hpicfFaultNotifyGroup } OBJECT hpicfFfAction DESCRIPTION "Support for 'warnAndDisable' is not required on devices that do not support the optional port disable capability." OBJECT hpicfFfDisablePortTolerance MIN-ACCESS read-only DESCRIPTION "Write access to this object is not required on devices that do not support the optional port disable capability." ::= { hpicfFaultFinderCompliances 1 } hpicfFaultFinder2Compliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for devices implementing the HP Fault Finder capability." MODULE MANDATORY-GROUPS { hpicfFaultConfig2Group, hpicfFaultLogGroup, hpicfFaultNotifyGroup } OBJECT hpicfFfAction DESCRIPTION "Support for 'warnAndDisable' is not required on devices that do not support the optional port disable capability." OBJECT hpicfFfDisablePortTolerance MIN-ACCESS read-only DESCRIPTION "Write access to this object is not required on devices that do not support the optional port disable capability." OBJECT hpicfFfSpeedReduceTolerance MIN-ACCESS read-only DESCRIPTION "Write access to this object is not required on devices that do not support the optional speed reduce capability." ::= { hpicfFaultFinderCompliances 2 } hpicfFaultConfigGroup OBJECT-GROUP OBJECTS { hpicfFfAction, hpicfFfWarnTolerance, hpicfFfDisablePortTolerance } STATUS current DESCRIPTION "A collection of objects for configuring the Fault Finder feature." ::= { hpicfFaultFinderGroups 1 } hpicfFaultLogGroup OBJECT-GROUP OBJECTS { hpicfFfLogCreateTime, hpicfFfLogPhysEntity, hpicfFfLogFaultType, hpicfFfLogAction, hpicfFfLogSeverity, hpicfFfLogStatus, hpicfFfFaultInfoURL, hpicfFfLogPhysClass, hpicfFfLogInfoType, hpicfFfLogInfo } STATUS current DESCRIPTION "A collection of objects for accessing the log of discovered faults." ::= { hpicfFaultFinderGroups 2 } hpicfFaultNotifyGroup NOTIFICATION-GROUP NOTIFICATIONS { hpicfFaultFinderTrap } STATUS current DESCRIPTION "A collection of notifications used to indicate the discovery of a network fault." ::= { hpicfFaultFinderGroups 3 } hpicfFaultConfig2Group OBJECT-GROUP OBJECTS { hpicfFfAction, hpicfFfWarnTolerance, hpicfFfDisablePortTolerance, hpicfFfSpeedReduceTolerance } STATUS current DESCRIPTION "A collection of objects for configuring the Fault Finder feature, including the ability to reduce a port's media speed in the event of a fault." ::= { hpicfFaultFinderGroups 4 } END