1 HP-ICF-FAULT-FINDER-MIB DEFINITIONS ::= BEGIN 2 3 IMPORTS 4 Integer32, MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE 5 FROM SNMPv2-SMI 6 TimeStamp, TEXTUAL-CONVENTION 7 FROM SNMPv2-TC 8 MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP 9 FROM SNMPv2-CONF 10 PhysicalIndex, PhysicalClass 11 FROM ENTITY-MIB 12 hpicfObjectModules, hpicfCommon, hpicfCommonTrapsPrefix 13 FROM HP-ICF-OID; 14 15 hpicfFaultFinderMib MODULE-IDENTITY 16 LAST-UPDATED "200505021934Z" -- May 2, 2005 17 ORGANIZATION "Hewlett-Packard Company, 18 Procurve Networking Business" 19 CONTACT-INFO "Hewlett-Packard Company 20 8000 Foothills Blvd. 21 Roseville, CA 95747" 22 DESCRIPTION "This MIB module contains object definitions for 23 managing the Fault Finder feature in web-capable 24 HP devices." 25 26 REVISION "200505021934Z" -- May 2, 2005 27 DESCRIPTION "Added 3 new Transceiver related fault messages." 28 29 REVISION "200503221130Z" -- March 22, 2005 30 DESCRIPTION "Added Transceiver related fault messages, 31 jumbos/flow control fault. Also added 32 Connection-Rate-Filtering fault type to 33 extend support for virus throttling." 34 35 REVISION "200307280707Z" -- July 28, 2003 36 DESCRIPTION "Add duplexMismatch type. Update division name." 37 38 REVISION "200011030707Z" -- November 3, 2000 39 DESCRIPTION "Add lossOfStackMember and hotSwapReboot fault 40 types. Update division name." 41 42 REVISION "9811202350Z" -- November 20, 1998 43 DESCRIPTION "Added several fault types, and the ability to 44 reduce a port's speed as one of the actions to 45 take on a fault." 46 47 REVISION "9710210249Z" -- October 21, 1997 48 DESCRIPTION "Initial version of this MIB module." 49 ::= { hpicfObjectModules 12 } 50 51 hpicfFaultFinder OBJECT IDENTIFIER ::= { hpicfCommon 7 } 52 53 HpicfFaultType ::= TEXTUAL-CONVENTION 54 STATUS current 55 DESCRIPTION "An enumerated value which indicates a type of 56 fault which is monitored by the agent." 57 SYNTAX INTEGER { 58 badDriver(1), 59 badXcvr(2), 60 badCable(3), 61 tooLongCable(4), 62 overBandwidth(5), 63 bcastStorm(6), 64 partition(7), 65 misconfiguredSQE(8), 66 polarityReversal(9), 67 networkLoop(10), 68 lossOfLink(11), 69 portSecurityViolation(12), 70 backupLinkTransition(13), 71 meshingFault(14), 72 fanFault(15), 73 rpsFault(16), 74 stuck10MbFault(17), 75 lossOfStackMember(18), 76 hotSwapReboot(19), 77 duplexMismatchHDX(20), 78 duplexMismatchFDX(21), 79 flowcntlJumbosFault(22), 80 portSelftestFailure(23), 81 xcvrUnidentified(24), 82 xcvrUnsupported(25), 83 crfNotify(26), 84 crfThrottled(27), 85 crfBlocked(28), 86 xcvrNotYetSupported(29), 87 xcvrBRevOnly(30), 88 xcvrNotSupportedOnPort(31), 89 phyReadFailure(32) 90 } 91 92 HpicfFaultTolerance ::= TEXTUAL-CONVENTION 93 STATUS current 94 DESCRIPTION "Objects of this type are used to scale internal 95 fault thresholds between hard-coded minimum and 96 maximum threshold values as follows: 97 98 actual = min + ((max - min) * tol)/maxTol 99 100 where: 101 actual - actual threshold used by Fault Finder 102 min - minimum threshold for this fault 103 max - maximum threshold for this fault 104 tol - configured tolerance for this fault 105 maxTol - maximum tolerance value (255)" 106 SYNTAX Integer32 (0..255) 107 108 HpicfFaultAction ::= TEXTUAL-CONVENTION 109 STATUS current 110 DESCRIPTION "Objects of this type are used to indicate 111 actions taken on detection of a fault." 112 SYNTAX INTEGER { 113 none(1), 114 warn(2), 115 warnAndDisable(3), 116 warnAndSpeedReduce(4), 117 warnAndSpeedReduceAndDisable(5) 118 } 119 120 HpicfUrlString ::= TEXTUAL-CONVENTION 121 STATUS current 122 DESCRIPTION "This TC describes an object which holds a 123 reference to a (remote) resource by using the 124 Uniform Resource Locator (URL) notation as 125 defined in RFC 1738. The allowed character set 126 and the encoding rules for this textual 127 convention are defined in RFC 1738 section 2.2." 128 SYNTAX OCTET STRING (SIZE(0..255)) 129 130 hpicfFfControlTable OBJECT-TYPE 131 SYNTAX SEQUENCE OF HpicfFfControlEntry 132 MAX-ACCESS not-accessible 133 STATUS current 134 DESCRIPTION "This table contains one entry per fault type 135 that this agent is capable of monitoring." 136 ::= { hpicfFaultFinder 1 } 137 138 hpicfFfControlEntry OBJECT-TYPE 139 SYNTAX HpicfFfControlEntry 140 MAX-ACCESS not-accessible 141 STATUS current 142 DESCRIPTION "Configuration information for a particular fault 143 type." 144 INDEX { hpicfFfControlIndex } 145 ::= { hpicfFfControlTable 1 } 146 147 HpicfFfControlEntry ::= 148 SEQUENCE { 149 hpicfFfControlIndex HpicfFaultType, 150 hpicfFfAction HpicfFaultAction, 151 hpicfFfWarnTolerance HpicfFaultTolerance, 152 hpicfFfDisablePortTolerance HpicfFaultTolerance, 153 hpicfFfSpeedReduceTolerance HpicfFaultTolerance 154 } 155 156 hpicfFfControlIndex OBJECT-TYPE 157 SYNTAX HpicfFaultType 158 MAX-ACCESS not-accessible 159 STATUS current 160 DESCRIPTION "The type of fault for which this entry contains 161 configuration information." 162 ::= { hpicfFfControlEntry 1 } 163 164 hpicfFfAction OBJECT-TYPE 165 SYNTAX HpicfFaultAction 166 MAX-ACCESS read-write 167 STATUS current 168 DESCRIPTION "This object is used to configure the action, 169 if any, to be taken if a fault of this type is 170 detected by the agent. Setting an instance of 171 this object to 'none' will clear any previous 172 state of the associated fault on all ports. 173 174 This object is used to enable or disable the 175 port disable feature for this fault type. 176 Setting this object to 'warnAndDisable' will 177 enable the port disable feature for this fault 178 type. This feature is intended to allow an agent 179 to disable ports that are being disruptive to the 180 rest of the network. 181 182 Note that not all agents will support setting 183 this object to 'warnAndDisable'. The agent 184 may choose not to disable a particular port for a 185 particular fault based on its knowledge of if/how 186 that fault disrupts the network." 187 ::= { hpicfFfControlEntry 2 } 188 189 hpicfFfWarnTolerance OBJECT-TYPE 190 SYNTAX HpicfFaultTolerance 191 MAX-ACCESS read-write 192 STATUS current 193 DESCRIPTION "The tolerance level used to calculate the 194 fault warning threshold for this fault type. 195 196 The agent will periodically check relevant 197 statistics for each port for each type of fault. 198 If the warning threshold has been exceeded, and 199 fault warning action is enabled for that fault 200 type, an hpicfFaultFinderTrap notification will 201 be sent. In addition, an entry will be made in 202 the hpicfFfLogTable for the fault. Once a fault 203 warning has fired, a hysteresis mechanism assures 204 that another warning will not be fired until the 205 relevant counter drops below a hysteresis 206 threshold value." 207 ::= { hpicfFfControlEntry 3 } 208 209 hpicfFfDisablePortTolerance OBJECT-TYPE 210 SYNTAX HpicfFaultTolerance 211 MAX-ACCESS read-write 212 STATUS current 213 DESCRIPTION "The tolerance level used to calculate the 214 port disable threshold for this fault type. 215 The value of an instance of this object MUST be 216 greater than the value of the corresponding 217 instance of the hpicfFfWarnTolerance. 218 219 The agent will periodically check relevant 220 statistics for each port for each type of fault. 221 If the port disable threshold has been exceeded, 222 and port disable is enabled for that fault type, 223 an hpicfFaultFinderTrap notification will be 224 sent. In addition, an entry will be made in the 225 hpicfFfLogTable for the fault. 226 227 Ports will not be disabled until at least one 228 polling interval after a warning has fired. In 229 addition, the agent may further delay disabling 230 a port in certain situations. For example, it 231 may choose to delay disabling a cascade port to 232 give the cascaded device a chance to correct the 233 problem." 234 ::= { hpicfFfControlEntry 4 } 235 236 hpicfFfSpeedReduceTolerance OBJECT-TYPE 237 SYNTAX HpicfFaultTolerance 238 MAX-ACCESS read-write 239 STATUS current 240 DESCRIPTION "The tolerance level used to calculate the 241 speed reduce threshold for this fault type. 242 The value of an instance of this object MUST be 243 greater than the value of the corresponding 244 instance of the hpicfFfWarnTolerance, and 245 less than or equal to the corresponding instance 246 of hpicfFfDisablePortTolerance. 247 248 The agent will only speed reduce on a port if 249 auto-negotiation has been performed, and the 250 partners link abilities allow operation at a 251 slower media speed. 252 253 The agent will periodically check relevant 254 statistics for each port for each type of fault. 255 If the speed reduce threshold has been exceeded, 256 and speed rededuction option is enabled for that 257 fault type, an hpicfFaultFinderTrap notification 258 will be sent. In addition, an entry will be made 259 in the hpicfFfLogTable for the fault. 260 261 The agent may elect to not or delay speed 262 reduction of certain ports. For example, 263 it may choose to delay taking action on a 264 cascade port to give the cascaded device a 265 chance to correct the problem." 266 ::= { hpicfFfControlEntry 5 } 267 268 269 hpicfFfLogTable OBJECT-TYPE 270 SYNTAX SEQUENCE OF HpicfFfLogEntry 271 MAX-ACCESS not-accessible 272 STATUS current 273 DESCRIPTION "A log of fault warnings and ports disabled by 274 the Fault Finder." 275 ::= { hpicfFaultFinder 2 } 276 277 hpicfFfLogEntry OBJECT-TYPE 278 SYNTAX HpicfFfLogEntry 279 MAX-ACCESS not-accessible 280 STATUS current 281 DESCRIPTION "An entry in the Fault Finder log, containing 282 information about a single fault." 283 INDEX { hpicfFfLogIndex } 284 ::= { hpicfFfLogTable 1 } 285 286 HpicfFfLogEntry ::= 287 SEQUENCE { 288 hpicfFfLogIndex Integer32, 289 hpicfFfLogCreateTime TimeStamp, 290 hpicfFfLogPhysEntity PhysicalIndex, 291 hpicfFfLogFaultType HpicfFaultType, 292 hpicfFfLogAction HpicfFaultAction, 293 hpicfFfLogSeverity INTEGER, 294 hpicfFfLogStatus INTEGER, 295 hpicfFfLogPhysClass PhysicalClass, 296 hpicfFfLogInfoType INTEGER, 297 hpicfFfLogInfo OCTET STRING 298 } 299 300 hpicfFfLogIndex OBJECT-TYPE 301 SYNTAX Integer32 (1..2147483647) 302 MAX-ACCESS not-accessible 303 STATUS current 304 DESCRIPTION "An arbitrary value which uniquely identifies 305 this log entry. The index for a particular log 306 entry must not change, even though entries with 307 lower valued indices have been deleted." 308 ::= { hpicfFfLogEntry 1 } 309 310 hpicfFfLogCreateTime OBJECT-TYPE 311 SYNTAX TimeStamp 312 MAX-ACCESS read-only 313 STATUS current 314 DESCRIPTION "The value of sysUpTime when this log entry was 315 added to the hpicfFfLogTable." 316 ::= { hpicfFfLogEntry 2 } 317 318 hpicfFfLogPhysEntity OBJECT-TYPE 319 SYNTAX PhysicalIndex 320 MAX-ACCESS read-only 321 STATUS current 322 DESCRIPTION "The entPhysicalIndex of the device port or other 323 physical component on which the fault was 324 detected. On agents which do not implement the 325 Entity MIB, this will contain the ifIndex of the 326 offending port." 327 ::= { hpicfFfLogEntry 3 } 328 329 hpicfFfLogFaultType OBJECT-TYPE 330 SYNTAX HpicfFaultType 331 MAX-ACCESS read-only 332 STATUS current 333 DESCRIPTION "The type of fault which was detected on the 334 physical entity indicated by 335 hpicfFfLogPhysEntity." 336 ::= { hpicfFfLogEntry 4 } 337 338 hpicfFfLogAction OBJECT-TYPE 339 SYNTAX HpicfFaultAction 340 MAX-ACCESS read-only 341 STATUS current 342 DESCRIPTION "The action, if any, that was taken by the agent 343 when this fault was detected." 344 ::= { hpicfFfLogEntry 5 } 345 346 hpicfFfLogSeverity OBJECT-TYPE 347 SYNTAX INTEGER { 348 informational(1), 349 medium(2), 350 critical(3) 351 } 352 MAX-ACCESS read-only 353 STATUS current 354 DESCRIPTION "The severity level of the fault. Port disables 355 will always be logged as 'critical'. 356 357 An agent may need to remove faults from the fault 358 log in order to reclaim resources. If so, it 359 must remove lower severity faults before removing 360 higher severity faults. Faults at the same 361 severity level should be removed from oldest to 362 newest." 363 ::= { hpicfFfLogEntry 6 } 364 365 hpicfFfLogStatus OBJECT-TYPE 366 SYNTAX INTEGER { 367 new(1), 368 active(2), 369 old(3) 370 } 371 MAX-ACCESS read-write 372 STATUS current 373 DESCRIPTION "Log entries will initially be created with the 374 value 'new'. A manager cannot set this object to 375 'new'. Setting this object to 'active' indicates 376 that the fault has been displayed to a user. 377 Setting this object to 'old' indicates that the 378 agent should remove this fault from the log." 379 ::= { hpicfFfLogEntry 7 } 380 381 hpicfFfLogPhysClass OBJECT-TYPE 382 SYNTAX PhysicalClass 383 MAX-ACCESS read-only 384 STATUS current 385 DESCRIPTION "The PhysicalClass as defined by Entity MIB to 386 which this hpicfFfLogPhysIndex belongs. " 387 ::= { hpicfFfLogEntry 8 } 388 389 hpicfFfLogInfoType OBJECT-TYPE 390 SYNTAX INTEGER { 391 ipv4Address(1), 392 displayString(2) 393 } 394 MAX-ACCESS read-only 395 STATUS current 396 DESCRIPTION "This field can be used to indicate the class of 397 information that 'hpicfFfLogInfo' holds" 398 ::= { hpicfFfLogEntry 9 } 399 400 hpicfFfLogInfo OBJECT-TYPE 401 SYNTAX OCTET STRING (SIZE (0..255)) 402 MAX-ACCESS read-only 403 STATUS current 404 DESCRIPTION "This can be used to hold any relevant information 405 about the current fault" 406 ::= { hpicfFfLogEntry 10 } 407 408 hpicfFfFaultInfoURL OBJECT-TYPE 409 SYNTAX HpicfUrlString 410 MAX-ACCESS accessible-for-notify 411 STATUS current 412 DESCRIPTION "A URL which a management station can use to 413 access additional information about the fault 414 which triggered the notification in which this 415 object was sent." 416 ::= { hpicfFaultFinder 3 } 417 418 419 420 hpicfFaultFinderTrap NOTIFICATION-TYPE 421 OBJECTS { hpicfFfLogFaultType, 422 hpicfFfLogAction, 423 hpicfFfLogSeverity, 424 hpicfFfFaultInfoURL 425 } 426 STATUS current 427 DESCRIPTION "This notification is sent whenever the Fault 428 Finder creates an entry in the hpicfFfLogTable." 429 ::= { hpicfCommonTrapsPrefix 5 } 430 431 hpicfFaultFinderConformance 432 OBJECT IDENTIFIER ::= { hpicfFaultFinderMib 1 } 433 434 hpicfFaultFinderCompliances 435 OBJECT IDENTIFIER ::= { hpicfFaultFinderConformance 1 } 436 hpicfFaultFinderGroups 437 OBJECT IDENTIFIER ::= { hpicfFaultFinderConformance 2 } 438 439 hpicfFaultFinderCompliance MODULE-COMPLIANCE 440 STATUS current 441 DESCRIPTION "The compliance statement for devices 442 implementing the HP Fault Finder capability." 443 MODULE 444 MANDATORY-GROUPS { hpicfFaultConfigGroup, 445 hpicfFaultLogGroup, 446 hpicfFaultNotifyGroup } 447 448 OBJECT hpicfFfAction 449 DESCRIPTION "Support for 'warnAndDisable' is not required 450 on devices that do not support the optional 451 port disable capability." 452 453 OBJECT hpicfFfDisablePortTolerance 454 MIN-ACCESS read-only 455 DESCRIPTION "Write access to this object is not required 456 on devices that do not support the optional 457 port disable capability." 458 459 ::= { hpicfFaultFinderCompliances 1 } 460 461 hpicfFaultFinder2Compliance MODULE-COMPLIANCE 462 STATUS current 463 DESCRIPTION "The compliance statement for devices 464 implementing the HP Fault Finder capability." 465 MODULE 466 MANDATORY-GROUPS { hpicfFaultConfig2Group, 467 hpicfFaultLogGroup, 468 hpicfFaultNotifyGroup } 469 470 OBJECT hpicfFfAction 471 DESCRIPTION "Support for 'warnAndDisable' is not required 472 on devices that do not support the optional 473 port disable capability." 474 475 OBJECT hpicfFfDisablePortTolerance 476 MIN-ACCESS read-only 477 DESCRIPTION "Write access to this object is not required 478 on devices that do not support the optional 479 port disable capability." 480 481 OBJECT hpicfFfSpeedReduceTolerance 482 MIN-ACCESS read-only 483 DESCRIPTION "Write access to this object is not required 484 on devices that do not support the optional 485 speed reduce capability." 486 487 ::= { hpicfFaultFinderCompliances 2 } 488 489 hpicfFaultConfigGroup OBJECT-GROUP 490 OBJECTS { hpicfFfAction, 491 hpicfFfWarnTolerance, 492 hpicfFfDisablePortTolerance 493 } 494 STATUS current 495 DESCRIPTION "A collection of objects for configuring the 496 Fault Finder feature." 497 ::= { hpicfFaultFinderGroups 1 } 498 499 hpicfFaultLogGroup OBJECT-GROUP 500 OBJECTS { hpicfFfLogCreateTime, 501 hpicfFfLogPhysEntity, 502 hpicfFfLogFaultType, 503 hpicfFfLogAction, 504 hpicfFfLogSeverity, 505 hpicfFfLogStatus, 506 hpicfFfFaultInfoURL, 507 hpicfFfLogPhysClass, 508 hpicfFfLogInfoType, 509 hpicfFfLogInfo 510 } 511 STATUS current 512 DESCRIPTION "A collection of objects for accessing the log of 513 discovered faults." 514 ::= { hpicfFaultFinderGroups 2 } 515 516 hpicfFaultNotifyGroup NOTIFICATION-GROUP 517 NOTIFICATIONS { hpicfFaultFinderTrap } 518 STATUS current 519 DESCRIPTION "A collection of notifications used to indicate 520 the discovery of a network fault." 521 ::= { hpicfFaultFinderGroups 3 } 522 523 hpicfFaultConfig2Group OBJECT-GROUP 524 OBJECTS { hpicfFfAction, 525 hpicfFfWarnTolerance, 526 hpicfFfDisablePortTolerance, 527 hpicfFfSpeedReduceTolerance 528 } 529 STATUS current 530 DESCRIPTION "A collection of objects for configuring the 531 Fault Finder feature, including the ability 532 to reduce a port's media speed in the event 533 of a fault." 534 ::= { hpicfFaultFinderGroups 4 } 535 536 END 537