mibs/ietf/OSPF-TRAP-MIB

   1 OSPF-TRAP-MIB DEFINITIONS ::= BEGIN
   2
   3 IMPORTS
   4     MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, IpAddress
   5                  FROM SNMPv2-SMI
   6     MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
   7                  FROM SNMPv2-CONF
   8     ospfRouterId, ospfIfIpAddress, ospfAddressLessIf, ospfIfState,
   9     ospfVirtIfAreaId, ospfVirtIfNeighbor, ospfVirtIfState,
  10     ospfNbrIpAddr, ospfNbrAddressLessIndex, ospfNbrRtrId,
  11     ospfNbrState, ospfVirtNbrArea, ospfVirtNbrRtrId,
  12     ospfVirtNbrState, ospfLsdbType, ospfLsdbLsid, ospfLsdbRouterId,
  13     ospfLsdbAreaId, ospfExtLsdbLimit, ospf, ospfAreaId,
  14     ospfAreaNssaTranslatorState, ospfRestartStatus,
  15     ospfRestartInterval, ospfRestartExitReason,
  16     ospfNbrRestartHelperStatus, ospfNbrRestartHelperAge,
  17     ospfNbrRestartHelperExitReason, ospfVirtNbrRestartHelperStatus,
  18     ospfVirtNbrRestartHelperAge, ospfVirtNbrRestartHelperExitReason
  19                  FROM OSPF-MIB;
  20
  21   ospfTrap MODULE-IDENTITY
  22
  23        LAST-UPDATED "200611100000Z" -- November 10, 2006 00:00:00 EST
  24        ORGANIZATION "IETF OSPF Working Group"
  25        CONTACT-INFO
  26        "WG E-Mail: ospf@ietf.org
  27
  28         WG Chairs: acee@cisco.com
  29                    rohit@gmail.com
  30
  31         Editors:   Dan Joyal
  32                    Nortel
  33                    600 Technology Park Drive
  34                    Billerica, MA  01821
  35                    djoyal@nortel.com
  36
  37                    Piotr Galecki
  38                    Airvana
  39                    19 Alpha Road
  40                    Chelmsford, MA 01824
  41                    pgalecki@airvana.com
  42
  43                    Spencer Giacalone
  44                    CSFB
  45                    Eleven Madison Ave
  46                    New York, NY 10010-3629
  47
  48
  49                    spencer.giacalone@gmail.com"
  50
  51        DESCRIPTION
  52           "The MIB module to describe traps for the OSPF
  53           Version 2 Protocol.
  54
  55           Copyright (C) The IETF Trust (2006).
  56           This version of this MIB module is part of
  57           RFC 4750;  see the RFC itself for full legal
  58           notices."
  59
  60        REVISION "200611100000Z" -- November 10, 2006 00:00:00 EST
  61        DESCRIPTION
  62           "Updated for latest changes to OSPFv2:
  63            -added graceful restart related traps
  64            -added new config error types
  65            -added ospfNssaTranslatorStatusChange trap.
  66            See Appendix B of RFC 4750 for more details.
  67
  68           This version published as part of RFC 4750"
  69
  70        REVISION "199501201225Z" -- Fri Jan 20 12:25:50 PST 1995
  71        DESCRIPTION
  72           "The initial SMIv2 revision of this MIB module, published
  73           in RFC 1850."
  74
  75        ::= { ospf 16 }
  76
  77 --  Trap Support Objects
  78
  79 --  The following are support objects for the OSPF traps.
  80
  81   ospfTrapControl OBJECT IDENTIFIER ::= { ospfTrap 1 }
  82   ospfTraps OBJECT IDENTIFIER ::= { ospfTrap 2 }
  83
  84   ospfSetTrap OBJECT-TYPE
  85        SYNTAX       OCTET STRING (SIZE(4))
  86        MAX-ACCESS   read-write
  87        STATUS       current
  88        DESCRIPTION
  89           "A 4-octet string serving as a bit map for
  90           the trap events defined by the OSPF traps.  This
  91           object is used to enable and disable specific
  92           OSPF traps where a 1 in the bit field
  93           represents enabled.  The right-most bit (least
  94           significant) represents trap 0.
  95
  96           This object is persistent and when written
  97
  98
  99
 100           the entity SHOULD save the change to non-volatile
 101           storage."
 102         ::= { ospfTrapControl 1 }
 103
 104   ospfConfigErrorType OBJECT-TYPE
 105        SYNTAX       INTEGER {
 106                        badVersion (1),
 107                        areaMismatch (2),
 108                        unknownNbmaNbr (3), -- Router is DR eligible
 109                        unknownVirtualNbr (4),
 110                        authTypeMismatch(5),
 111                        authFailure (6),
 112                        netMaskMismatch (7),
 113                        helloIntervalMismatch (8),
 114                        deadIntervalMismatch (9),
 115                        optionMismatch (10),
 116                        mtuMismatch (11),
 117                        duplicateRouterId (12),
 118                        noError (13) }
 119        MAX-ACCESS   read-only
 120        STATUS   current
 121        DESCRIPTION
 122           "Potential types of configuration conflicts.
 123           Used by the ospfConfigError and
 124           ospfConfigVirtError traps.  When the last value
 125           of a trap using this object is needed, but no
 126           traps of that type have been sent, this value
 127           pertaining to this object should be returned as
 128           noError."
 129        ::= { ospfTrapControl 2 }
 130
 131   ospfPacketType OBJECT-TYPE
 132        SYNTAX       INTEGER {
 133                        hello (1),
 134                        dbDescript (2),
 135                        lsReq (3),
 136                        lsUpdate (4),
 137                        lsAck (5),
 138                        nullPacket (6) }
 139        MAX-ACCESS   read-only
 140        STATUS       current
 141        DESCRIPTION
 142           "OSPF packet types.  When the last value of a trap
 143           using this object is needed, but no traps of
 144           that type have been sent, this value pertaining
 145           to this object should be returned as nullPacket."
 146        ::= { ospfTrapControl 3 }
 147
 148
 149
 150
 151   ospfPacketSrc OBJECT-TYPE
 152        SYNTAX       IpAddress
 153        MAX-ACCESS   read-only
 154        STATUS       current
 155        DESCRIPTION
 156           "The IP address of an inbound packet that cannot
 157           be identified by a neighbor instance.  When
 158           the last value of a trap using this object is
 159           needed, but no traps of that type have been sent,
 160           this value pertaining to this object should
 161           be returned as 0.0.0.0."
 162        ::= { ospfTrapControl 4 }
 163
 164 --  Traps
 165
 166   ospfVirtIfStateChange NOTIFICATION-TYPE
 167        OBJECTS { ospfRouterId, -- The originator of the trap
 168           ospfVirtIfAreaId,
 169           ospfVirtIfNeighbor,
 170           ospfVirtIfState  -- The new state
 171           }
 172        STATUS       current
 173        DESCRIPTION
 174           "An ospfVirtIfStateChange trap signifies that there
 175           has been a change in the state of an OSPF virtual
 176           interface.
 177
 178           This trap should be generated when the interface
 179           state regresses (e.g., goes from Point-to-Point to Down)
 180           or progresses to a terminal state
 181           (i.e., Point-to-Point)."
 182        ::= { ospfTraps 1 }
 183
 184   ospfNbrStateChange NOTIFICATION-TYPE
 185        OBJECTS { ospfRouterId, -- The originator of the trap
 186           ospfNbrIpAddr,
 187           ospfNbrAddressLessIndex,
 188           ospfNbrRtrId,
 189           ospfNbrState  -- The new state
 190           }
 191        STATUS       current
 192        DESCRIPTION
 193           "An ospfNbrStateChange trap signifies that
 194           there has been a change in the state of a
 195           non-virtual OSPF neighbor.  This trap should be
 196           generated when the neighbor state regresses
 197           (e.g., goes from Attempt or Full to 1-Way or
 198           Down) or progresses to a terminal state (e.g.,
 199
 200
 201
 202           2-Way or Full).  When an neighbor transitions
 203           from or to Full on non-broadcast multi-access
 204           and broadcast networks, the trap should be
 205           generated by the designated router.  A designated
 206           router transitioning to Down will be noted by
 207           ospfIfStateChange."
 208        ::= { ospfTraps 2 }
 209
 210   ospfVirtNbrStateChange NOTIFICATION-TYPE
 211        OBJECTS { ospfRouterId, -- The originator of the trap
 212           ospfVirtNbrArea,
 213           ospfVirtNbrRtrId,
 214           ospfVirtNbrState  -- The new state
 215           }
 216        STATUS       current
 217        DESCRIPTION
 218           "An ospfVirtNbrStateChange trap signifies that there
 219           has been a change in the state of an OSPF virtual
 220           neighbor.  This trap should be generated
 221           when the neighbor state regresses (e.g., goes
 222           from Attempt or Full to 1-Way or Down) or
 223           progresses to a terminal state (e.g., Full)."
 224        ::= { ospfTraps 3 }
 225
 226   ospfIfConfigError NOTIFICATION-TYPE
 227        OBJECTS { ospfRouterId, -- The originator of the trap
 228           ospfIfIpAddress,
 229           ospfAddressLessIf,
 230           ospfPacketSrc,  -- The source IP address
 231           ospfConfigErrorType, -- Type of error
 232           ospfPacketType
 233           }
 234        STATUS       current
 235        DESCRIPTION
 236           "An ospfIfConfigError trap signifies that a
 237           packet has been received on a non-virtual
 238           interface from a router whose configuration
 239           parameters conflict with this router's
 240           configuration parameters.  Note that the event
 241           optionMismatch should cause a trap only if it
 242           prevents an adjacency from forming."
 243        ::= { ospfTraps 4 }
 244
 245   ospfVirtIfConfigError NOTIFICATION-TYPE
 246        OBJECTS { ospfRouterId, -- The originator of the trap
 247           ospfVirtIfAreaId,
 248           ospfVirtIfNeighbor,
 249           ospfConfigErrorType, -- Type of error
 250
 251
 252
 253           ospfPacketType
 254           }
 255        STATUS       current
 256        DESCRIPTION
 257           "An ospfVirtIfConfigError trap signifies that a
 258           packet has been received on a virtual interface
 259           from a router whose configuration parameters
 260           conflict with this router's configuration
 261           parameters.  Note that the event optionMismatch
 262           should cause a trap only if it prevents an
 263           adjacency from forming."
 264        ::= { ospfTraps 5 }
 265
 266   ospfIfAuthFailure NOTIFICATION-TYPE
 267        OBJECTS { ospfRouterId, -- The originator of the trap
 268           ospfIfIpAddress,
 269           ospfAddressLessIf,
 270           ospfPacketSrc,  -- The source IP address
 271           ospfConfigErrorType, -- authTypeMismatch or
 272                                -- authFailure
 273           ospfPacketType
 274           }
 275        STATUS       current
 276        DESCRIPTION
 277           "An ospfIfAuthFailure trap signifies that a
 278           packet has been received on a non-virtual
 279           interface from a router whose authentication key
 280           or authentication type conflicts with this
 281           router's authentication key or authentication
 282           type."
 283        ::= { ospfTraps 6 }
 284
 285   ospfVirtIfAuthFailure NOTIFICATION-TYPE
 286        OBJECTS { ospfRouterId, -- The originator of the trap
 287           ospfVirtIfAreaId,
 288           ospfVirtIfNeighbor,
 289           ospfConfigErrorType, -- authTypeMismatch or
 290                                -- authFailure
 291           ospfPacketType
 292           }
 293        STATUS       current
 294        DESCRIPTION
 295           "An ospfVirtIfAuthFailure trap signifies that a
 296           packet has been received on a virtual interface
 297           from a router whose authentication key or
 298           authentication type conflicts with this router's
 299           authentication key or authentication type."
 300
 301
 302
 303
 304        ::= { ospfTraps 7 }
 305
 306   ospfIfRxBadPacket NOTIFICATION-TYPE
 307        OBJECTS { ospfRouterId, -- The originator of the trap
 308           ospfIfIpAddress,
 309           ospfAddressLessIf,
 310           ospfPacketSrc,  -- The source IP address
 311           ospfPacketType
 312           }
 313        STATUS       current
 314        DESCRIPTION
 315           "An ospfIfRxBadPacket trap signifies that an
 316           OSPF packet has been received on a non-virtual
 317           interface that cannot be parsed."
 318        ::= { ospfTraps 8 }
 319
 320   ospfVirtIfRxBadPacket NOTIFICATION-TYPE
 321        OBJECTS { ospfRouterId, -- The originator of the trap
 322          ospfVirtIfAreaId,
 323          ospfVirtIfNeighbor,
 324          ospfPacketType
 325          }
 326        STATUS       current
 327        DESCRIPTION
 328           "An ospfVirtIfRxBadPacket trap signifies that an OSPF
 329           packet has been received on a virtual interface
 330           that cannot be parsed."
 331        ::= { ospfTraps 9 }
 332
 333   ospfTxRetransmit NOTIFICATION-TYPE
 334        OBJECTS { ospfRouterId, -- The originator of the trap
 335           ospfIfIpAddress,
 336           ospfAddressLessIf,
 337           ospfNbrRtrId, -- Destination
 338           ospfPacketType,
 339           ospfLsdbType,
 340           ospfLsdbLsid,
 341           ospfLsdbRouterId
 342           }
 343         STATUS       current
 344         DESCRIPTION
 345            "An ospfTxRetransmit trap signifies than an
 346            OSPF packet has been retransmitted on a
 347            non-virtual interface.  All packets that may be
 348            retransmitted are associated with an LSDB entry.
 349            The LS type, LS ID, and Router ID are used to
 350            identify the LSDB entry."
 351         ::= { ospfTraps 10 }
 352
 353
 354
 355   ospfVirtIfTxRetransmit NOTIFICATION-TYPE
 356        OBJECTS { ospfRouterId, -- The originator of the trap
 357           ospfVirtIfAreaId,
 358           ospfVirtIfNeighbor,
 359           ospfPacketType,
 360           ospfLsdbType,
 361           ospfLsdbLsid,
 362           ospfLsdbRouterId
 363           }
 364        STATUS       current
 365        DESCRIPTION
 366           "An ospfVirtIfTxRetransmit trap signifies than an
 367           OSPF packet has been retransmitted on a virtual
 368           interface.  All packets that may be retransmitted
 369           are associated with an LSDB entry.  The LS
 370           type, LS ID, and Router ID are used to identify
 371           the LSDB entry."
 372        ::= { ospfTraps 11 }
 373
 374   ospfOriginateLsa NOTIFICATION-TYPE
 375        OBJECTS { ospfRouterId, -- The originator of the trap
 376           ospfLsdbAreaId,  -- 0.0.0.0 for AS Externals
 377           ospfLsdbType,
 378           ospfLsdbLsid,
 379           ospfLsdbRouterId
 380           }
 381        STATUS       current
 382        DESCRIPTION
 383           "An ospfOriginateLsa trap signifies that a new
 384           LSA has been originated by this router.  This
 385           trap should not be invoked for simple refreshes
 386           of LSAs (which happens every 30 minutes), but
 387           instead will only be invoked when an LSA is
 388           (re)originated due to a topology change.
 389           Additionally, this trap does not include LSAs that
 390           are being flushed because they have reached
 391           MaxAge."
 392        ::= { ospfTraps 12 }
 393
 394   ospfMaxAgeLsa NOTIFICATION-TYPE
 395        OBJECTS { ospfRouterId, -- The originator of the trap
 396           ospfLsdbAreaId,  -- 0.0.0.0 for AS Externals
 397           ospfLsdbType,
 398           ospfLsdbLsid,
 399           ospfLsdbRouterId
 400           }
 401        STATUS       current
 402        DESCRIPTION
 403
 404
 405
 406           "An ospfMaxAgeLsa trap signifies that one of
 407           the LSAs in the router's link state database has
 408           aged to MaxAge."
 409        ::= { ospfTraps 13 }
 410
 411   ospfLsdbOverflow NOTIFICATION-TYPE
 412        OBJECTS { ospfRouterId, -- The originator of the trap
 413           ospfExtLsdbLimit
 414           }
 415
 416        STATUS       current
 417        DESCRIPTION
 418           "An ospfLsdbOverflow trap signifies that the
 419           number of LSAs in the router's link state
 420           database has exceeded ospfExtLsdbLimit."
 421        ::= { ospfTraps 14 }
 422
 423   ospfLsdbApproachingOverflow NOTIFICATION-TYPE
 424        OBJECTS { ospfRouterId, -- The originator of the trap
 425           ospfExtLsdbLimit
 426           }
 427        STATUS       current
 428        DESCRIPTION
 429           "An ospfLsdbApproachingOverflow trap signifies
 430           that the number of LSAs in the router's
 431           link state database has exceeded ninety percent of
 432           ospfExtLsdbLimit."
 433        ::= { ospfTraps 15 }
 434
 435   ospfIfStateChange NOTIFICATION-TYPE
 436        OBJECTS { ospfRouterId, -- The originator of the trap
 437           ospfIfIpAddress,
 438           ospfAddressLessIf,
 439           ospfIfState   -- The new state
 440           }
 441        STATUS       current
 442        DESCRIPTION
 443           "An ospfIfStateChange trap signifies that there
 444           has been a change in the state of a non-virtual
 445           OSPF interface.  This trap should be generated
 446           when the interface state regresses (e.g., goes
 447           from Dr to Down) or progresses to a terminal
 448           state (i.e., Point-to-Point, DR Other, Dr, or
 449           Backup)."
 450        ::= { ospfTraps 16 }
 451
 452   ospfNssaTranslatorStatusChange NOTIFICATION-TYPE
 453        OBJECTS { ospfRouterId, -- The originator of the trap
 454
 455
 456
 457           ospfAreaId,
 458           ospfAreaNssaTranslatorState -- The current translation
 459                                       -- status
 460           }
 461        STATUS       current
 462        DESCRIPTION
 463           "An ospfNssaTranslatorStatusChange trap indicates that
 464           there has been a change in the router's ability to
 465           translate OSPF type-7 LSAs into OSPF type-5 LSAs.
 466           This trap should be generated when the translator
 467           status transitions from or to any defined status on
 468           a per-area basis."
 469        ::= { ospfTraps 17 }
 470
 471   ospfRestartStatusChange NOTIFICATION-TYPE
 472        OBJECTS { ospfRouterId, -- The originator of the trap
 473                  ospfRestartStatus,
 474                  ospfRestartInterval,
 475                  ospfRestartExitReason
 476                }
 477        STATUS       current
 478        DESCRIPTION
 479           "An ospfRestartStatusChange trap signifies that
 480           there has been a change in the graceful restart
 481           state for the router.  This trap should be
 482           generated when the router restart status
 483           changes."
 484        ::= { ospfTraps 18 }
 485
 486   ospfNbrRestartHelperStatusChange NOTIFICATION-TYPE
 487        OBJECTS { ospfRouterId, -- The originator of the trap
 488                  ospfNbrIpAddr,
 489                  ospfNbrAddressLessIndex,
 490                  ospfNbrRtrId,
 491                  ospfNbrRestartHelperStatus,
 492                  ospfNbrRestartHelperAge,
 493                  ospfNbrRestartHelperExitReason
 494                }
 495        STATUS       current
 496        DESCRIPTION
 497           "An ospfNbrRestartHelperStatusChange trap signifies that
 498           there has been a change in the graceful restart
 499           helper state for the neighbor.  This trap should be
 500           generated when the neighbor restart helper status
 501           transitions for a neighbor."
 502        ::= { ospfTraps 19 }
 503
 504   ospfVirtNbrRestartHelperStatusChange NOTIFICATION-TYPE
 505
 506
 507
 508        OBJECTS { ospfRouterId, -- The originator of the trap
 509                  ospfVirtNbrArea,
 510                  ospfVirtNbrRtrId,
 511                  ospfVirtNbrRestartHelperStatus,
 512                  ospfVirtNbrRestartHelperAge,
 513                  ospfVirtNbrRestartHelperExitReason
 514                }
 515        STATUS       current
 516        DESCRIPTION
 517           "An ospfVirtNbrRestartHelperStatusChange trap signifies
 518           that there has been a change in the graceful restart
 519           helper state for the virtual neighbor.  This trap should
 520           be generated when the virtual neighbor restart helper
 521           status transitions for a virtual neighbor."
 522        ::= { ospfTraps 20 }
 523
 524 --  conformance information
 525
 526 ospfTrapConformance OBJECT IDENTIFIER ::= { ospfTrap 3 }
 527 ospfTrapGroups      OBJECT IDENTIFIER ::= { ospfTrapConformance 1 }
 528 ospfTrapCompliances OBJECT IDENTIFIER ::= { ospfTrapConformance 2 }
 529
 530 --  compliance statements
 531
 532 ospfTrapCompliance MODULE-COMPLIANCE
 533      STATUS       obsolete
 534      DESCRIPTION
 535         "The compliance statement."
 536      MODULE       -- this module
 537      MANDATORY-GROUPS { ospfTrapControlGroup }
 538
 539      GROUP       ospfTrapControlGroup
 540      DESCRIPTION
 541         "This group is optional but recommended for all
 542         OSPF systems."
 543      ::= { ospfTrapCompliances 1 }
 544
 545 ospfTrapCompliance2 MODULE-COMPLIANCE
 546      STATUS       current
 547      DESCRIPTION
 548         "The compliance statement."
 549      MODULE       -- this module
 550      MANDATORY-GROUPS { ospfTrapControlGroup, ospfTrapEventGroup }
 551      OBJECT       ospfConfigErrorType
 552      MIN-ACCESS   accessible-for-notify
 553      DESCRIPTION
 554         "This object is only required to be supplied within
 555         notifications."
 556
 557
 558
 559      OBJECT       ospfPacketType
 560      MIN-ACCESS   accessible-for-notify
 561      DESCRIPTION
 562         "This object is only required to be supplied within
 563         notifications."
 564      OBJECT       ospfPacketSrc
 565      MIN-ACCESS   accessible-for-notify
 566      DESCRIPTION
 567         "This object is only required to be supplied within
 568         notifications."
 569      ::= { ospfTrapCompliances 2 }
 570
 571 --  units of conformance
 572
 573   ospfTrapControlGroup    OBJECT-GROUP
 574        OBJECTS { ospfSetTrap,
 575                  ospfConfigErrorType,
 576                  ospfPacketType,
 577                  ospfPacketSrc }
 578        STATUS       current
 579        DESCRIPTION
 580           "These objects are required to control traps
 581           from OSPF systems."
 582        ::= { ospfTrapGroups 1 }
 583
 584   ospfTrapEventGroup       NOTIFICATION-GROUP
 585        NOTIFICATIONS {
 586           ospfVirtIfStateChange,
 587           ospfNbrStateChange,
 588           ospfVirtNbrStateChange,
 589           ospfIfConfigError,
 590           ospfVirtIfConfigError,
 591           ospfIfAuthFailure,
 592           ospfVirtIfAuthFailure,
 593           ospfIfRxBadPacket,
 594           ospfVirtIfRxBadPacket,
 595           ospfTxRetransmit,
 596           ospfVirtIfTxRetransmit,
 597           ospfOriginateLsa,
 598           ospfMaxAgeLsa,
 599           ospfLsdbOverflow,
 600           ospfLsdbApproachingOverflow,
 601           ospfIfStateChange,
 602           ospfNssaTranslatorStatusChange,
 603           ospfRestartStatusChange,
 604           ospfNbrRestartHelperStatusChange,
 605           ospfVirtNbrRestartHelperStatusChange
 606           }
 607
 608
 609
 610        STATUS        current
 611        DESCRIPTION
 612           "A grouping of OSPF trap events, as specified
 613           in NOTIFICATION-TYPE constructs."
 614        ::= { ospfTrapGroups 2 }
 615
 616 END