idnits 2.17.1 draft-ietf-pce-pcep-mib-07.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- No issues found here. Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the IETF Trust and authors Copyright Line does not match the current year == The document seems to use 'NOT RECOMMENDED' as an RFC 2119 keyword, but does not include the phrase in its RFC 2119 key words list. -- The document date (February 6, 2014) is 3704 days in the past. Is this intentional? Checking references for intended status: Proposed Standard ---------------------------------------------------------------------------- (See RFCs 3967 and 4897 for information about using normative references to lower-maturity documents in RFCs) ** Downref: Normative reference to an Informational RFC: RFC 4655 ** Downref: Normative reference to an Informational RFC: RFC 3410 Summary: 2 errors (**), 0 flaws (~~), 2 warnings (==), 1 comment (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 PCE Working Group A. Koushik 3 Internet-Draft Cisco Systems, Inc. 4 Intended status: Standards Track E. Stephan 5 Expires: August 10, 2014 France Telecom 6 Q. Zhao 7 Huawei Technology 8 D. King 9 Old Dog Consulting 10 J. Hardwick 11 Metaswitch 12 February 6, 2014 14 Path Computation Element Protocol (PCEP) Management Information Base 15 draft-ietf-pce-pcep-mib-07 17 Abstract 19 This memo defines a portion of the Management Information Base for 20 use with network management protocols in the Internet community. In 21 particular, it describes managed objects for modeling of Path 22 Computation Element communication Protocol (PCEP) for communications 23 between a Path Computation Client (PCC) and a Path Computation 24 Element (PCE), or between two PCEs. 26 Status of This Memo 28 This Internet-Draft is submitted in full conformance with the 29 provisions of BCP 78 and BCP 79. 31 Internet-Drafts are working documents of the Internet Engineering 32 Task Force (IETF). Note that other groups may also distribute 33 working documents as Internet-Drafts. The list of current Internet- 34 Drafts is at http://datatracker.ietf.org/drafts/current/. 36 Internet-Drafts are draft documents valid for a maximum of six months 37 and may be updated, replaced, or obsoleted by other documents at any 38 time. It is inappropriate to use Internet-Drafts as reference 39 material or to cite them other than as "work in progress." 41 This Internet-Draft will expire on August 10, 2014. 43 Copyright Notice 45 Copyright (c) 2014 IETF Trust and the persons identified as the 46 document authors. All rights reserved. 48 This document is subject to BCP 78 and the IETF Trust's Legal 49 Provisions Relating to IETF Documents 50 (http://trustee.ietf.org/license-info) in effect on the date of 51 publication of this document. Please review these documents 52 carefully, as they describe your rights and restrictions with respect 53 to this document. Code Components extracted from this document must 54 include Simplified BSD License text as described in Section 4.e of 55 the Trust Legal Provisions and are provided without warranty as 56 described in the Simplified BSD License. 58 Table of Contents 60 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 61 2. The Internet-Standard Management Framework . . . . . . . . . . 3 62 3. Requirements Language . . . . . . . . . . . . . . . . . . . . 3 63 4. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 3 64 5. PCEP MIB Module Architecture . . . . . . . . . . . . . . . . . 4 65 5.1. pcePcepEntityTable . . . . . . . . . . . . . . . . . . . . 4 66 5.2. pcePcepPeerTable . . . . . . . . . . . . . . . . . . . . . 4 67 5.3. pcePcepSessTable . . . . . . . . . . . . . . . . . . . . . 4 68 5.4. PCEP Notifications . . . . . . . . . . . . . . . . . . . . 5 69 5.5. Relationship to other MIB modules . . . . . . . . . . . . 5 70 6. Object Definitions . . . . . . . . . . . . . . . . . . . . . . 6 71 6.1. PCE-PCEP-MIB . . . . . . . . . . . . . . . . . . . . . . . 6 72 7. Security Considerations . . . . . . . . . . . . . . . . . . . 45 73 8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 45 74 9. Contributors . . . . . . . . . . . . . . . . . . . . . . . . . 46 75 10. References . . . . . . . . . . . . . . . . . . . . . . . . . . 46 76 10.1. Normative References . . . . . . . . . . . . . . . . . . . 46 77 10.2. Normative References . . . . . . . . . . . . . . . . . . . 46 78 Appendix A. Acknowledgement . . . . . . . . . . . . . . . . . . . 47 80 1. Introduction 82 The Path Computation Element (PCE) defined in [RFC4655] is an entity 83 that is capable of computing a network path or route based on a 84 network graph, and applying computational constraints. A Path 85 Computation Client (PCC) may make requests to a PCE for paths to be 86 computed. 88 The PCE communication protocol (PCEP) is the communication protocol 89 between a PCC and PCE for point-to-point (P2P) path computations and 90 is defined in [RFC5440]. Such PCEP communication interactions 91 include path computation requests and path computation replies as 92 well as notifications of specific states related to the use of a PCE 93 in the context of Multiprotocol Label Switching (MPLS) and 94 Generalized MPLS (GMPLS) Traffic Engineering. 96 This memo defines a portion of the Management Information Base (MIB) 97 for use with network management protocols in the Internet community. 98 In particular, it defines a MIB module that can be used to monitor 99 PCEP communications between a PCC and a PCE, or between two PCEs. 101 2. The Internet-Standard Management Framework 103 For a detailed overview of the documents that describe the current 104 Internet-Standard Management Framework, please refer to section 7 of 105 RFC 3410 [RFC3410]. 107 Managed objects are accessed via a virtual information store, termed 108 the Management Information Base or MIB. MIB objects are generally 109 accessed through the Simple Network Management Protocol (SNMP). 110 Objects in the MIB are defined using the mechanisms defined in the 111 Structure of Management Information (SMI). This memo specifies a MIB 112 module that is compliant to the SMIv2, which is described in STD 58, 113 RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579], and STD 58, RFC 2580 114 [RFC2580]. 116 3. Requirements Language 118 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", 119 "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this 120 document are to be interpreted as described in BCP 14, RFC 2119 121 [RFC2119]. 123 4. Terminology 125 The terminology used in this document is built on notions introduced 126 and discussed in PCE WG documents. The reader should be familiar 127 with these documents. 129 Domain: any collection of network elements within a common sphere of 130 address management or path computational responsibility. 132 IGP Area: OSPF Area or ISIS level/area. 134 This document also uses the terminology defined in [RFC4655] and 135 [RFC5440]. 137 5. PCEP MIB Module Architecture 139 The PCEP MIB contains the following information: 141 a. PCE and PCC entity status (see pcePcepEntityTable). 143 b. PCEP peer information (see pcePcepPeerTable). 145 c. PCEP session information (see pcePcepSessTable). 147 d. Notifications to indicate PCEP session changes. 149 5.1. pcePcepEntityTable 151 The pcePcepEntityTable contains one row for each PCEP-speaking entity 152 (PCC or PCE). Each row is read-only and contains current status 153 information plus the running configuration of the PCEP-speaking 154 entity. 156 5.2. pcePcepPeerTable 158 The pcePcepPeerTable contains one row for each PCEP peer that the 159 PCEP entity (PCE or PCC) knows about. Each row is read-only and 160 contains information to identify the peer, the running configuration 161 relating to that peer and statistics that track the messages 162 exchanged with that peer and its response times. 164 Since PCEP sessions can be ephemeral, the pcePcepPeerTable tracks a 165 peer even when no PCEP session currently exists to that peer. The 166 statistics contained in pcePcepPeerTable are an aggregate of the 167 statistics for all successive sessions to that peer. 169 To limit the quantity of information that is stored, an 170 implementation MAY choose to discard a row from the pcePcepPeerTable 171 if and only if no PCEP session exists to the corresponding peer. 173 5.3. pcePcepSessTable 175 The pcePcepSessTable contains one row for each PCEP session that the 176 PCEP entity (PCE or PCC) is currently participating in. Each row is 177 read-only and contains the running configuration that is applied to 178 the session, plus identifiers and statistics for the session. 180 The statistics in pcePcepSessTable are semantically different from 181 those in pcePcepPeerTable since the former apply to the current 182 session only, whereas the latter are the aggregate for all sessions 183 that have existed to that peer. 185 Although [RFC5440] forbids there from being more than one active PCEP 186 session between a given pair of PCEP entities at any one time, there 187 is a window during session establishment where the pcePcepSessTable 188 may contain two rows for a given peer, one representing a session 189 initiated by the local PCEP speaker and one representing a session 190 initiated by the remote PCEP speaker. If either of these sessions 191 reaches active state, then the other is discarded. 193 5.4. PCEP Notifications 195 The PCEP MIB contains notifications for the following conditions. 197 a. pcePcepSessUp: PCEP Session has gone up. 199 b. pcePcepSessDown: PCEP Session has gone down. 201 c. pcePcepSessLocalOverload: Local PCEP entity has sent an overload 202 PCNtf on this session. 204 d. pcePcepSessLocalOverloadClear: Local PCEP entity has sent an 205 overload-cleared PCNtf on this session. 207 e. pcePcepSessPeerOverload: Remote PCEP entity has sent an overload 208 PCNtf on this session. 210 f. pcePcepSessPeerOverloadClear: Remote PCEP entity has sent an 211 overload-cleared PCNtf on this session. 213 5.5. Relationship to other MIB modules 215 The PCEP MIB imports the following textual conventions from the INET- 216 ADDRESS-MIB defined in RFC 4001 [RFC4001]: 218 o InetAddressType 220 o InetAddress 222 PCEP relies on existing protocols which have specialized MIB objects 223 to monitor their own activities. Consequently this document 224 considers that the monitoring of underlying protocols is out of scope 225 of the PCEP MIB module. 227 6. Object Definitions 229 6.1. PCE-PCEP-MIB 231 PCE-PCEP-MIB DEFINITIONS ::= BEGIN 233 IMPORTS 234 MODULE-IDENTITY, 235 OBJECT-TYPE, 236 mib-2, 237 NOTIFICATION-TYPE, 238 Unsigned32, 239 Counter32 240 FROM SNMPv2-SMI -- RFC 2578 241 TruthValue, 242 TimeStamp 243 FROM SNMPv2-TC -- RFC 2579 244 MODULE-COMPLIANCE, 245 OBJECT-GROUP, 246 NOTIFICATION-GROUP 247 FROM SNMPv2-CONF -- RFC 2580 248 InetAddressType, 249 InetAddress 250 FROM INET-ADDRESS-MIB; -- RFC 4001 252 pcePcepMIB MODULE-IDENTITY 253 LAST-UPDATED 254 "201402051200Z" -- 5 February 2014 255 ORGANIZATION 256 "IETF Path Computation Element (PCE) Working Group" 257 CONTACT-INFO 258 "Email: pce@ietf.org 259 WG charter: 260 http://www.ietf.org/html.charters/pce-charter.html" 262 DESCRIPTION 263 "This MIB module defines a collection of objects for managing 264 PCE communication protocol (PCEP). 266 Copyright (C) The IETF Trust (2014). This version of this 267 MIB module is part of RFC YYYY; see the RFC itself for full 268 legal notices." 269 -- RFC Ed,: replace YYYY with actual RFC number & remove this note 270 REVISION 271 "201402051200Z" -- 5 February 2014 272 DESCRIPTION 273 "Initial version, published as RFC YYYY." 274 -- RFC Ed.: replace YYYY with actual RFC number & remove this note 275 ::= { mib-2 XXX } 276 -- RFC Ed.: replace XXX with IANA-assigned number & remove this note 278 pcePcepNotifications OBJECT IDENTIFIER ::= { pcePcepMIB 0 } 279 pcePcepObjects OBJECT IDENTIFIER ::= { pcePcepMIB 1 } 280 pcePcepConformance OBJECT IDENTIFIER ::= { pcePcepMIB 2 } 281 pcePcepEntityObjects OBJECT IDENTIFIER ::= { pcePcepObjects 1 } 283 -- 284 -- PCE Entity Objects 285 -- 287 pcePcepEntityTable OBJECT-TYPE 288 SYNTAX SEQUENCE OF PcePcepEntityEntry 289 MAX-ACCESS not-accessible 290 STATUS current 291 DESCRIPTION 292 "This table contains information about PCEP Entities." 293 ::= { pcePcepEntityObjects 1 } 295 pcePcepEntityEntry OBJECT-TYPE 296 SYNTAX PcePcepEntityEntry 297 MAX-ACCESS not-accessible 298 STATUS current 299 DESCRIPTION 300 "An entry in this table represents a PCEP entity." 301 INDEX { pcePcepEntityIndex } 302 ::= { pcePcepEntityTable 1 } 304 PcePcepEntityEntry ::= SEQUENCE { 305 pcePcepEntityIndex Unsigned32, 306 pcePcepEntityAdminStatus INTEGER, 307 pcePcepEntityOperStatus INTEGER, 308 pcePcepEntityAddrType InetAddressType, 309 pcePcepEntityAddr InetAddress, 310 pcePcepEntityConnectTimer Unsigned32, 311 pcePcepEntityConnectMaxRetry Unsigned32, 312 pcePcepEntityOpenWaitTimer Unsigned32, 313 pcePcepEntityKeepWaitTimer Unsigned32, 314 pcePcepEntityKeepAliveTimer Unsigned32, 315 pcePcepEntityDeadTimer Unsigned32, 316 pcePcepEntityMaxKeepAliveTimer Unsigned32, 317 pcePcepEntityMaxDeadTimer Unsigned32, 318 pcePcepEntityAllowNegotiation TruthValue, 319 pcePcepEntityMinKeepAliveTimer Unsigned32, 320 pcePcepEntityMinDeadTimer Unsigned32, 321 pcePcepEntitySyncTimer Unsigned32, 322 pcePcepEntityRequestTimer Unsigned32, 323 pcePcepEntityInitBackoffTimer Unsigned32, 324 pcePcepEntityMaxBackoffTimer Unsigned32, 325 pcePcepEntityMaxSessions Unsigned32, 326 pcePcepEntityMaxUnknownReqs Unsigned32, 327 pcePcepEntityMaxUnknownMsgs Unsigned32 328 } 330 pcePcepEntityIndex OBJECT-TYPE 331 SYNTAX Unsigned32 (1..2147483647) 332 MAX-ACCESS not-accessible 333 STATUS current 334 DESCRIPTION 335 "This index is used to uniquely identify the PCEP entity." 336 ::= { pcePcepEntityEntry 1 } 338 pcePcepEntityAdminStatus OBJECT-TYPE 339 SYNTAX INTEGER { 340 adminStatusUp(1), 341 adminStatusDown(2) 342 } 343 MAX-ACCESS read-only 344 STATUS current 345 DESCRIPTION 346 "The administrative status of this PCEP Entity." 347 ::= { pcePcepEntityEntry 2 } 349 pcePcepEntityOperStatus OBJECT-TYPE 350 SYNTAX INTEGER { 351 operStatusUp(1), 352 operStatusDown(2), 353 operStatusGoingUp(3), 354 operStatusGoingDown(4), 355 operStatusFailed(5), 356 operStatusFailedPerm(6) 357 } 358 MAX-ACCESS read-only 359 STATUS current 360 DESCRIPTION 361 "The operational status of the PCEP entity. Takes one of the 362 following values. 363 - operStatusUp(1): the PCEP entity is active. 364 - operStatusDown(2): the PCEP entity is inactive. 365 - operStatusGoingUp(3): the PCEP entity is activating. 366 - operStatusGoingDown(4): the PCEP entity is deactivating. 367 - operStatusFailed(5): the PCEP entity has failed and will 368 recover when possible. 370 - operStatusFailedPerm(6): the PCEP entity has failed and 371 will not recover without operator intervention." 372 ::= { pcePcepEntityEntry 3 } 374 pcePcepEntityAddrType OBJECT-TYPE 375 SYNTAX InetAddressType 376 MAX-ACCESS read-only 377 STATUS current 378 DESCRIPTION 379 "The type of the PCEP entity's Internet address. This object 380 specifies how the value of the pcePcepEntityAddr object 381 should be interpreted." 382 ::= { pcePcepEntityEntry 4 } 384 pcePcepEntityAddr OBJECT-TYPE 385 SYNTAX InetAddress 386 MAX-ACCESS read-only 387 STATUS current 388 DESCRIPTION 389 "The local Internet address of this PCEP entity. The type is 390 given by pcePcepEntityAddrType. 392 If operating as a PCE server, the PCEP entity listens on 393 this address. If operating as a PCC, the PCEP entity binds 394 outgoing TCP connections to this address. 396 It is possible for the PCEP entity to operate both as a PCC 397 and a PCE Server, in which case it uses this address both to 398 listen for incoming TCP connections and to bind outgoing 399 TCP connections." 400 ::= { pcePcepEntityEntry 5 } 402 pcePcepEntityConnectTimer OBJECT-TYPE 403 SYNTAX Unsigned32 (1..65535) 404 UNITS "seconds" 405 MAX-ACCESS read-only 406 STATUS current 407 DESCRIPTION 408 "The time that the PCEP entity will wait to establish a TCP 409 connection with a PCEP peer. If a TCP connection is not 410 established within this time then PCEP aborts the session 411 setup attempt." 412 ::= { pcePcepEntityEntry 6 } 414 pcePcepEntityConnectMaxRetry OBJECT-TYPE 415 SYNTAX Unsigned32 416 MAX-ACCESS read-only 417 STATUS current 418 DESCRIPTION 419 "The maximum number of times the system tries to establish 420 a TCP connection to a peer before going back to the Idle 421 state." 422 ::= { pcePcepEntityEntry 7 } 424 pcePcepEntityOpenWaitTimer OBJECT-TYPE 425 SYNTAX Unsigned32 (1..65535) 426 UNITS "seconds" 427 MAX-ACCESS read-only 428 STATUS current 429 DESCRIPTION 430 "The time that the PCEP entity will wait to receive an Open 431 message from a PCEP peer. If no Open message is received 432 within this time then PCEP aborts the session setup 433 attempt." 434 ::= { pcePcepEntityEntry 8 } 436 pcePcepEntityKeepWaitTimer OBJECT-TYPE 437 SYNTAX Unsigned32 (1..65535) 438 UNITS "seconds" 439 MAX-ACCESS read-only 440 STATUS current 441 DESCRIPTION 442 "The time that the PCEP entity will wait to receive a 443 Keepalive or PCErr message from a PCEP peer during session 444 initialization. If no Keepalive or PCErr message is 445 received within this time then PCEP aborts the session setup 446 attempt." 447 ::= { pcePcepEntityEntry 9 } 449 pcePcepEntityKeepAliveTimer OBJECT-TYPE 450 SYNTAX Unsigned32 (0..255) 451 UNITS "seconds" 452 MAX-ACCESS read-only 453 STATUS current 454 DESCRIPTION 455 "The keep alive transmission timer that this PCEP entity will 456 propose in the initial OPEN message of each session it is 457 involved in. This is the maximum time between two 458 consecutive messages sent to a PCEP peer. Zero means that 459 the PCEP entity prefers not to send Keepalives at all. 461 Note that the actual Keepalive transmission intervals, in 462 either direction of an active PCEP session, are determined 463 by negotiation between the PCEP peers as specified by RFC 464 5440, and so may differ from this configured value. For 465 the actually negotiated values (per-session), see 466 pcePcepSessKeepaliveTimer and 467 pcePcepSessPeerKeepaliveTimer." 468 ::= { pcePcepEntityEntry 10 } 470 pcePcepEntityDeadTimer OBJECT-TYPE 471 SYNTAX Unsigned32 (0..255) 472 UNITS "seconds" 473 MAX-ACCESS read-only 474 STATUS current 475 DESCRIPTION 476 "The dead timer that this PCEP entity will propose in the 477 initial OPEN message of each session it is involved in. 478 This is the time after which a PCEP peer should declare a 479 session down if it does not receive any PCEP messages. 481 pcePcepEntityDeadTimer is recommended to be 4 times the 482 pcePcepEntityKeepAliveTimer value. Zero means suggesting 483 that the peer does not run a dead timer at all; it is only 484 allowed when pcePcepEntityKeepAliveTimer is also zero." 485 ::= { pcePcepEntityEntry 11 } 487 pcePcepEntityMaxKeepAliveTimer OBJECT-TYPE 488 SYNTAX Unsigned32 (0..255) 489 UNITS "seconds" 490 MAX-ACCESS read-only 491 STATUS current 492 DESCRIPTION 493 "The maximum value that this PCEP entity will accept from a 494 peer for the interval between Keepalive transmissions. Zero 495 means that the PCEP entity will allow no Keepalive 496 transmission at all." 497 ::= { pcePcepEntityEntry 12 } 499 pcePcepEntityMaxDeadTimer OBJECT-TYPE 500 SYNTAX Unsigned32 (0..255) 501 UNITS "seconds" 502 MAX-ACCESS read-only 503 STATUS current 504 DESCRIPTION 505 "The maximum value that this PCEP entity will accept from a 506 peer for the Dead timer. Zero means that the PCEP entity 507 will allow not running a Dead timer. 509 A Dead timer will not be accepted unless it is both greater 510 than the session Keepalive timer and less than this field." 511 ::= { pcePcepEntityEntry 13 } 513 pcePcepEntityAllowNegotiation OBJECT-TYPE 514 SYNTAX TruthValue 515 MAX-ACCESS read-only 516 STATUS current 517 DESCRIPTION 518 "Whether the PCEP entity will permit negotiation of session 519 parameters." 520 ::= { pcePcepEntityEntry 14 } 522 pcePcepEntityMinKeepAliveTimer OBJECT-TYPE 523 SYNTAX Unsigned32 (0..255) 524 UNITS "seconds" 525 MAX-ACCESS read-only 526 STATUS current 527 DESCRIPTION 528 "In PCEP session parameter negotiation, the minimum value 529 that this PCEP entity will accept for the interval between 530 Keepalive transmissions. Zero means that the PCEP entity 531 insists on no Keepalive transmission at all." 532 ::= { pcePcepEntityEntry 15 } 534 pcePcepEntityMinDeadTimer OBJECT-TYPE 535 SYNTAX Unsigned32 (0..255) 536 UNITS "seconds" 537 MAX-ACCESS read-only 538 STATUS current 539 DESCRIPTION 540 "In PCEP session parameter negotiation, the minimum value 541 that this PCEP entity will accept for the Dead timer. Zero 542 means that the PCEP entity insists on not running a Dead 543 timer. 545 A Dead timer will not be accepted unless it is both greater 546 than the session Keepalive timer and greater than this 547 field." 548 ::= { pcePcepEntityEntry 16 } 550 pcePcepEntitySyncTimer OBJECT-TYPE 551 SYNTAX Unsigned32 (1..65535) 552 UNITS "seconds" 553 MAX-ACCESS read-only 554 STATUS current 555 DESCRIPTION 556 "The value of SYNC timer is used in the case of synchronized 557 path computation request using the SVEC object. 559 Consider the case where a PCReq message is received by a PCE 560 that contains the SVEC object referring to M synchronized 561 path computation requests. If after the expiration of the 562 SYNC timer all the M path computation requests have not been 563 received, a protocol error is triggered and the PCE MUST 564 cancel the whole set of path computation requests. 566 The aim of the SyncTimer is to avoid the storage of unused 567 synchronized requests should one of them get lost for some 568 reasons (for example, a misbehaving PCC)." 569 ::= { pcePcepEntityEntry 17 } 571 pcePcepEntityRequestTimer OBJECT-TYPE 572 SYNTAX Unsigned32 (1..65535) 573 UNITS "seconds" 574 MAX-ACCESS read-only 575 STATUS current 576 DESCRIPTION 577 "The maximum time that the PCEP entity will wait for a 578 response to a PCReq message." 579 ::= { pcePcepEntityEntry 18 } 581 pcePcepEntityInitBackoffTimer OBJECT-TYPE 582 SYNTAX Unsigned32 (1..65535) 583 UNITS "seconds" 584 MAX-ACCESS read-only 585 STATUS current 586 DESCRIPTION 587 "The initial back-off time for retrying a failed session 588 setup attempt to a peer. 590 The back-off time increases for each failed session setup 591 attempt, until a maximum back-off time is reached. The 592 maximum back-off time is pcePcepEntityMaxBackoffTimer." 593 ::= { pcePcepEntityEntry 19 } 595 pcePcepEntityMaxBackoffTimer OBJECT-TYPE 596 SYNTAX Unsigned32 597 UNITS "seconds" 598 MAX-ACCESS read-only 599 STATUS current 600 DESCRIPTION 601 "The maximum back-off time for retrying a failed session 602 setup attempt to a peer. 604 The back-off time increases for each failed session setup 605 attempt, until this maximum value is reached. Session 606 setup attempts then repeat periodically without any 607 further increase in back-off time." 608 ::= { pcePcepEntityEntry 20 } 610 pcePcepEntityMaxSessions OBJECT-TYPE 611 SYNTAX Unsigned32 612 MAX-ACCESS read-only 613 STATUS current 614 DESCRIPTION 615 "Maximum number of sessions involving this PCEP entity 616 that can exist at any time." 617 ::= { pcePcepEntityEntry 21 } 619 pcePcepEntityMaxUnknownReqs OBJECT-TYPE 620 SYNTAX Unsigned32 621 MAX-ACCESS read-only 622 STATUS current 623 DESCRIPTION 624 "The maximum number of unrecognized requests and replies that 625 any session on this PCEP entity is willing to accept per 626 minute. 628 A PCRep message contains an unrecognized reply if it 629 contains an RP object whose request ID does not correspond 630 to any in-progress request sent by this PCEP entity. 632 A PCReq message contains an unrecognized request if it 633 contains an RP object whose request ID is zero." 634 ::= { pcePcepEntityEntry 22 } 636 pcePcepEntityMaxUnknownMsgs OBJECT-TYPE 637 SYNTAX Unsigned32 638 MAX-ACCESS read-only 639 STATUS current 640 DESCRIPTION 641 "The maximum number of unknown messages that any session 642 on this PCEP entity is willing to accept per minute." 643 ::= { pcePcepEntityEntry 23 } 645 -- 646 -- The PCEP Peer Table 647 -- 649 pcePcepPeerObjects OBJECT IDENTIFIER ::= { pcePcepObjects 2 } 651 pcePcepPeerTable OBJECT-TYPE 652 SYNTAX SEQUENCE OF PcePcepPeerEntry 653 MAX-ACCESS not-accessible 654 STATUS current 655 DESCRIPTION 656 "Information about PCEP peers known by the local PCEP 657 speaker. 659 This MIB table gives PCEP peer information that spans PCEP 660 sessions. Information about current PCEP sessions can be 661 found in the pcePcepSessTable MIB table." 662 ::= { pcePcepPeerObjects 1 } 664 pcePcepPeerEntry OBJECT-TYPE 665 SYNTAX PcePcepPeerEntry 666 MAX-ACCESS not-accessible 667 STATUS current 668 DESCRIPTION 669 "Information about a single PCEP peer which spans all PCEP 670 sessions to that peer. The information contained in a row 671 is read-only." 672 INDEX { pcePcepEntityIndex, 673 pcePcepPeerAddrType, 674 pcePcepPeerAddr } 675 ::= { pcePcepPeerTable 1 } 677 PcePcepPeerEntry ::= SEQUENCE { 678 pcePcepPeerAddrType InetAddressType, 679 pcePcepPeerAddr InetAddress, 680 pcePcepPeerRole INTEGER, 681 pcePcepPeerDiscontinuityTime TimeStamp, 682 pcePcepPeerInitiateSession TruthValue, 683 pcePcepPeerSessionExists TruthValue, 684 pcePcepPeerNumSessSetupOK Counter32, 685 pcePcepPeerNumSessSetupFail Counter32, 686 pcePcepPeerSessionUpTime TimeStamp, 687 pcePcepPeerSessionFailTime TimeStamp, 688 pcePcepPeerAvgRspTime Unsigned32, 689 pcePcepPeerLWMRspTime Unsigned32, 690 pcePcepPeerHWMRspTime Unsigned32, 691 pcePcepPeerNumPCReqSent Counter32, 692 pcePcepPeerNumPCReqRcvd Counter32, 693 pcePcepPeerNumPCRepSent Counter32, 694 pcePcepPeerNumPCRepRcvd Counter32, 695 pcePcepPeerNumPCErrSent Counter32, 696 pcePcepPeerNumPCErrRcvd Counter32, 697 pcePcepPeerNumPCNtfSent Counter32, 698 pcePcepPeerNumPCNtfRcvd Counter32, 699 pcePcepPeerNumKeepaliveSent Counter32, 700 pcePcepPeerNumKeepaliveRcvd Counter32, 701 pcePcepPeerNumUnknownRcvd Counter32, 702 pcePcepPeerNumReqSent Counter32, 703 pcePcepPeerNumSvecSent Counter32, 704 pcePcepPeerNumSvecReqSent Counter32, 705 pcePcepPeerNumReqSentPendRep Counter32, 706 pcePcepPeerNumReqSentEroRcvd Counter32, 707 pcePcepPeerNumReqSentNoPathRcvd Counter32, 708 pcePcepPeerNumReqSentCancelRcvd Counter32, 709 pcePcepPeerNumReqSentErrorRcvd Counter32, 710 pcePcepPeerNumReqSentTimeout Counter32, 711 pcePcepPeerNumReqSentCancelSent Counter32, 712 pcePcepPeerNumReqSentClosed Counter32, 713 pcePcepPeerNumReqRcvd Counter32, 714 pcePcepPeerNumSvecRcvd Counter32, 715 pcePcepPeerNumSvecReqRcvd Counter32, 716 pcePcepPeerNumReqRcvdPendRep Counter32, 717 pcePcepPeerNumReqRcvdEroSent Counter32, 718 pcePcepPeerNumReqRcvdNoPathSent Counter32, 719 pcePcepPeerNumReqRcvdCancelSent Counter32, 720 pcePcepPeerNumReqRcvdErrorSent Counter32, 721 pcePcepPeerNumReqRcvdCancelRcvd Counter32, 722 pcePcepPeerNumReqRcvdClosed Counter32, 723 pcePcepPeerNumRepRcvdUnknown Counter32, 724 pcePcepPeerNumReqRcvdUnknown Counter32 725 } 727 pcePcepPeerAddrType OBJECT-TYPE 728 SYNTAX InetAddressType 729 MAX-ACCESS not-accessible 730 STATUS current 731 DESCRIPTION 732 "The type of the peer's Internet address. This object 733 specifies how the value of the pcePcepPeerAddr object should 734 be interpreted." 735 ::= { pcePcepPeerEntry 1 } 737 pcePcepPeerAddr OBJECT-TYPE 738 SYNTAX InetAddress 739 MAX-ACCESS not-accessible 740 STATUS current 741 DESCRIPTION 742 "The Internet address of the peer. The type is given by 743 pcePcepPeerAddrType. " 744 ::= { pcePcepPeerEntry 2 } 746 pcePcepPeerRole OBJECT-TYPE 747 SYNTAX INTEGER { 748 pcc(1), 749 pce(2), 750 pccAndPce(3), 751 unknown(4) 752 } 753 MAX-ACCESS read-only 754 STATUS current 755 DESCRIPTION 756 "The role that this peer took the last time a session was 757 established. Takes one of the following values. 758 - pcc(1): this peer is a Path Computation Client (PCC). 759 - pce(2): this peer is a Path Computation Server (PCE). 760 - pccAndPce(3): this peer is both a PCC and a PCE. 761 - unknown(4): this peer's role is not known." 762 ::= { pcePcepPeerEntry 3 } 764 pcePcepPeerDiscontinuityTime OBJECT-TYPE 765 SYNTAX TimeStamp 766 MAX-ACCESS read-only 767 STATUS current 768 DESCRIPTION 769 "The value of sysUpTime at the time that the information and 770 statistics in this row were last reset." 771 ::= { pcePcepPeerEntry 4 } 773 pcePcepPeerInitiateSession OBJECT-TYPE 774 SYNTAX TruthValue 775 MAX-ACCESS read-only 776 STATUS current 777 DESCRIPTION 778 "Indicates whether the PCEP Entity initiates sessions to this 779 peer, or waits for the peer to initiate a session." 780 ::= { pcePcepPeerEntry 5 } 782 pcePcepPeerSessionExists OBJECT-TYPE 783 SYNTAX TruthValue 784 MAX-ACCESS read-only 785 STATUS current 786 DESCRIPTION 787 "Indicates whether a session with this peer currently 788 exists." 789 ::= { pcePcepPeerEntry 6 } 791 pcePcepPeerNumSessSetupOK OBJECT-TYPE 792 SYNTAX Counter32 793 MAX-ACCESS read-only 794 STATUS current 795 DESCRIPTION 796 "The number of PCEP sessions successfully established with 797 the peer, including any current session. This counter is 798 incremented each time a session with this peer is 799 successfully established." 800 ::= { pcePcepPeerEntry 7 } 802 pcePcepPeerNumSessSetupFail OBJECT-TYPE 803 SYNTAX Counter32 804 MAX-ACCESS read-only 805 STATUS current 806 DESCRIPTION 807 "The number of PCEP sessions with the peer that have been 808 attempted but failed before being fully estbalished. 809 This counter is incremented each time a session with this 810 peer fails before reaching session state pceSessionUp." 811 ::= { pcePcepPeerEntry 8 } 813 pcePcepPeerSessionUpTime OBJECT-TYPE 814 SYNTAX TimeStamp 815 MAX-ACCESS read-only 816 STATUS current 817 DESCRIPTION 818 "The value of sysUpTime the last time a session with this 819 peer was successfully established. 821 If pcePcepPeerNumSessSetupOK is zero, then this object 822 contains zero." 823 ::= { pcePcepPeerEntry 9 } 825 pcePcepPeerSessionFailTime OBJECT-TYPE 826 SYNTAX TimeStamp 827 MAX-ACCESS read-only 828 STATUS current 829 DESCRIPTION 830 "The value of sysUpTime the last time a session with this 831 peer failed to be established. 833 If pcePcepPeerNumSessSetupFail is zero, then this object 834 contains zero." 835 ::= { pcePcepPeerEntry 10 } 837 pcePcepPeerAvgRspTime OBJECT-TYPE 838 SYNTAX Unsigned32 839 UNITS "milliseconds" 840 MAX-ACCESS read-only 841 STATUS current 842 DESCRIPTION 843 "The average response time for this peer. 845 If an average response time has not been calculated for this 846 peer then this object has the value zero. 848 If pcePcepPeerRole is pcc then this field is meaningless and 849 is set to zero." 850 ::= { pcePcepPeerEntry 11 } 852 pcePcepPeerLWMRspTime OBJECT-TYPE 853 SYNTAX Unsigned32 854 UNITS "milliseconds" 855 MAX-ACCESS read-only 856 STATUS current 857 DESCRIPTION 858 "The smallest (low-water mark) response time seen from this 859 peer. 861 If no responses have been received from this peer then this 862 object has the value zero. 864 If pcePcepPeerRole is pcc then this field is meaningless and 865 is set to zero." 866 ::= { pcePcepPeerEntry 12 } 868 pcePcepPeerHWMRspTime OBJECT-TYPE 869 SYNTAX Unsigned32 870 UNITS "milliseconds" 871 MAX-ACCESS read-only 872 STATUS current 873 DESCRIPTION 874 "The greatest (high-water mark) response time seen from this 875 peer. 877 If no responses have been received from this peer then this 878 object has the value zero. 880 If pcePcepPeerRole is pcc then this field is meaningless and 881 is set to zero." 882 ::= { pcePcepPeerEntry 13 } 884 pcePcepPeerNumPCReqSent OBJECT-TYPE 885 SYNTAX Counter32 886 MAX-ACCESS read-only 887 STATUS current 888 DESCRIPTION 889 "The number of PCReq messages sent to this peer." 890 ::= { pcePcepPeerEntry 14 } 892 pcePcepPeerNumPCReqRcvd OBJECT-TYPE 893 SYNTAX Counter32 894 MAX-ACCESS read-only 895 STATUS current 896 DESCRIPTION 897 "The number of PCReq messages received from this peer." 898 ::= { pcePcepPeerEntry 15 } 900 pcePcepPeerNumPCRepSent OBJECT-TYPE 901 SYNTAX Counter32 902 MAX-ACCESS read-only 903 STATUS current 904 DESCRIPTION 905 "The number of PCRep messages sent to this peer." 906 ::= { pcePcepPeerEntry 16 } 908 pcePcepPeerNumPCRepRcvd OBJECT-TYPE 909 SYNTAX Counter32 910 MAX-ACCESS read-only 911 STATUS current 912 DESCRIPTION 913 "The number of PCRep messages received from this peer." 914 ::= { pcePcepPeerEntry 17 } 916 pcePcepPeerNumPCErrSent OBJECT-TYPE 917 SYNTAX Counter32 918 MAX-ACCESS read-only 919 STATUS current 920 DESCRIPTION 921 "The number of PCErr messages sent to this peer." 922 ::= { pcePcepPeerEntry 18 } 924 pcePcepPeerNumPCErrRcvd OBJECT-TYPE 925 SYNTAX Counter32 926 MAX-ACCESS read-only 927 STATUS current 928 DESCRIPTION 929 "The number of PCErr messages received from this peer." 930 ::= { pcePcepPeerEntry 19 } 932 pcePcepPeerNumPCNtfSent OBJECT-TYPE 933 SYNTAX Counter32 934 MAX-ACCESS read-only 935 STATUS current 936 DESCRIPTION 937 "The number of PCNtf messages sent to this peer." 938 ::= { pcePcepPeerEntry 20 } 940 pcePcepPeerNumPCNtfRcvd OBJECT-TYPE 941 SYNTAX Counter32 942 MAX-ACCESS read-only 943 STATUS current 944 DESCRIPTION 945 "The number of PCNtf messages received from this peer." 946 ::= { pcePcepPeerEntry 21 } 948 pcePcepPeerNumKeepaliveSent OBJECT-TYPE 949 SYNTAX Counter32 950 MAX-ACCESS read-only 951 STATUS current 952 DESCRIPTION 953 "The number of Keepalive messages sent to this peer." 954 ::= { pcePcepPeerEntry 22 } 956 pcePcepPeerNumKeepaliveRcvd OBJECT-TYPE 957 SYNTAX Counter32 958 MAX-ACCESS read-only 959 STATUS current 960 DESCRIPTION 961 "The number of Keepalive messages received from this peer." 962 ::= { pcePcepPeerEntry 23 } 964 pcePcepPeerNumUnknownRcvd OBJECT-TYPE 965 SYNTAX Counter32 966 MAX-ACCESS read-only 967 STATUS current 968 DESCRIPTION 969 "The number of unknown messages received from this peer." 970 ::= { pcePcepPeerEntry 24 } 972 pcePcepPeerNumReqSent OBJECT-TYPE 973 SYNTAX Counter32 974 MAX-ACCESS read-only 975 STATUS current 976 DESCRIPTION 977 "The number of requests sent to this peer. A request 978 corresponds 1:1 with an RP object in a PCReq message. 980 This might be greater than pcePcepPeerNumPCReqSent because 981 multiple requests can be batched into a single PCReq 982 message." 983 ::= { pcePcepPeerEntry 25 } 985 pcePcepPeerNumSvecSent OBJECT-TYPE 986 SYNTAX Counter32 987 MAX-ACCESS read-only 988 STATUS current 989 DESCRIPTION 990 "The number of SVEC objects sent to this peer in PCReq 991 messages. An SVEC object represents a set of synchronized 992 requests." 993 ::= { pcePcepPeerEntry 26 } 995 pcePcepPeerNumSvecReqSent OBJECT-TYPE 996 SYNTAX Counter32 997 MAX-ACCESS read-only 998 STATUS current 999 DESCRIPTION 1000 "The number of requests sent to this peer that appeared in 1001 one or more SVEC objects." 1002 ::= { pcePcepPeerEntry 27 } 1004 pcePcepPeerNumReqSentPendRep OBJECT-TYPE 1005 SYNTAX Counter32 1006 MAX-ACCESS read-only 1007 STATUS current 1008 DESCRIPTION 1009 "The number of requests that have been sent to this peer for 1010 which a response is still pending." 1011 ::= { pcePcepPeerEntry 28 } 1013 pcePcepPeerNumReqSentEroRcvd OBJECT-TYPE 1014 SYNTAX Counter32 1015 MAX-ACCESS read-only 1016 STATUS current 1017 DESCRIPTION 1018 "The number of requests that have been sent to this peer for 1019 which a response with an ERO object was received. Such 1020 responses indicate that a path was successfully computed by 1021 the peer." 1022 ::= { pcePcepPeerEntry 29 } 1024 pcePcepPeerNumReqSentNoPathRcvd OBJECT-TYPE 1025 SYNTAX Counter32 1026 MAX-ACCESS read-only 1027 STATUS current 1028 DESCRIPTION 1029 "The number of requests that have been sent to this peer for 1030 which a response with a NO-PATH object was received. Such 1031 responses indicate that the peer could not find a path to 1032 satisfy the request." 1033 ::= { pcePcepPeerEntry 30 } 1035 pcePcepPeerNumReqSentCancelRcvd OBJECT-TYPE 1036 SYNTAX Counter32 1037 MAX-ACCESS read-only 1038 STATUS current 1039 DESCRIPTION 1040 "The number of requests that were cancelled by the peer with 1041 a PCNtf message. 1043 This might be different than pcePcepPeerNumPCNtfRcvd because 1044 not all PCNtf messages are used to cancel requests, and a 1045 single PCNtf message can cancel multiple requests." 1046 ::= { pcePcepPeerEntry 31 } 1048 pcePcepPeerNumReqSentErrorRcvd OBJECT-TYPE 1049 SYNTAX Counter32 1050 MAX-ACCESS read-only 1051 STATUS current 1052 DESCRIPTION 1053 "The number of requests that were rejected by the peer with a 1054 PCErr message. 1056 This might be different than pcePcepPeerNumPCErrRcvd because 1057 not all PCErr messages are used to reject requests, and a 1058 single PCErr message can reject multiple requests." 1059 ::= { pcePcepPeerEntry 32 } 1061 pcePcepPeerNumReqSentTimeout OBJECT-TYPE 1062 SYNTAX Counter32 1063 MAX-ACCESS read-only 1064 STATUS current 1065 DESCRIPTION 1066 "The number of requests that have been sent to a peer and 1067 have been abandoned because the peer has taken too long to 1068 respond to them." 1069 ::= { pcePcepPeerEntry 33 } 1071 pcePcepPeerNumReqSentCancelSent OBJECT-TYPE 1072 SYNTAX Counter32 1073 MAX-ACCESS read-only 1074 STATUS current 1075 DESCRIPTION 1076 "The number of requests that were sent to the peer and 1077 explicitly canceled by the local PCEP speaker sending a 1078 PCNtf." 1079 ::= { pcePcepPeerEntry 34 } 1081 pcePcepPeerNumReqSentClosed OBJECT-TYPE 1082 SYNTAX Counter32 1083 MAX-ACCESS read-only 1084 STATUS current 1085 DESCRIPTION 1086 "The number of requests that were sent to the peer and 1087 implicitly canceled when the session they were sent over was 1088 closed." 1089 ::= { pcePcepPeerEntry 35 } 1091 pcePcepPeerNumReqRcvd OBJECT-TYPE 1092 SYNTAX Counter32 1093 MAX-ACCESS read-only 1094 STATUS current 1095 DESCRIPTION 1096 "The number of requests received from this peer. A request 1097 corresponds 1:1 with an RP object in a PCReq message. 1099 This might be greater than pcePcepPeerNumPCReqRcvd because 1100 multiple requests can be batched into a single PCReq 1101 message." 1102 ::= { pcePcepPeerEntry 36 } 1104 pcePcepPeerNumSvecRcvd OBJECT-TYPE 1105 SYNTAX Counter32 1106 MAX-ACCESS read-only 1107 STATUS current 1108 DESCRIPTION 1109 "The number of SVEC objects received from this peer in PCReq 1110 messages. An SVEC object represents a set of synchronized 1111 requests." 1112 ::= { pcePcepPeerEntry 37 } 1114 pcePcepPeerNumSvecReqRcvd OBJECT-TYPE 1115 SYNTAX Counter32 1116 MAX-ACCESS read-only 1117 STATUS current 1118 DESCRIPTION 1119 "The number of requests received from this peer that appeared 1120 in one or more SVEC objects." 1121 ::= { pcePcepPeerEntry 38 } 1123 pcePcepPeerNumReqRcvdPendRep OBJECT-TYPE 1124 SYNTAX Counter32 1125 MAX-ACCESS read-only 1126 STATUS current 1127 DESCRIPTION 1128 "The number of requests that have been received from this 1129 peer for which a response is still pending." 1130 ::= { pcePcepPeerEntry 39 } 1132 pcePcepPeerNumReqRcvdEroSent OBJECT-TYPE 1133 SYNTAX Counter32 1134 MAX-ACCESS read-only 1135 STATUS current 1136 DESCRIPTION 1137 "The number of requests that have been received from this 1138 peer for which a response with an ERO object was sent. Such 1139 responses indicate that a path was successfully computed by 1140 the local PCEP speaker." 1141 ::= { pcePcepPeerEntry 40 } 1143 pcePcepPeerNumReqRcvdNoPathSent OBJECT-TYPE 1144 SYNTAX Counter32 1145 MAX-ACCESS read-only 1146 STATUS current 1147 DESCRIPTION 1148 "The number of requests that have been received from this 1149 peer for which a response with a NO-PATH object was sent. 1150 Such responses indicate that the local PCEP speaker could 1151 not find a path to satisfy the request." 1152 ::= { pcePcepPeerEntry 41 } 1154 pcePcepPeerNumReqRcvdCancelSent OBJECT-TYPE 1155 SYNTAX Counter32 1156 MAX-ACCESS read-only 1157 STATUS current 1158 DESCRIPTION 1159 "The number of requests received from this peer that were 1160 cancelled by the local PCEP speaker sending a PCNtf message. 1162 This might be different than pcePcepPeerNumPCNtfSent because 1163 not all PCNtf messages are used to cancel requests, and a 1164 single PCNtf message can cancel multiple requests." 1165 ::= { pcePcepPeerEntry 42 } 1167 pcePcepPeerNumReqRcvdErrorSent OBJECT-TYPE 1168 SYNTAX Counter32 1169 MAX-ACCESS read-only 1170 STATUS current 1171 DESCRIPTION 1172 "The number of requests received from this peer that were 1173 rejected by the local PCEP speaker sending a PCErr message. 1175 This might be different than pcePcepPeerNumPCErrSent because 1176 not all PCErr messages are used to reject requests, and a 1177 single PCErr message can reject multiple requests." 1178 ::= { pcePcepPeerEntry 43 } 1180 pcePcepPeerNumReqRcvdCancelRcvd OBJECT-TYPE 1181 SYNTAX Counter32 1182 MAX-ACCESS read-only 1183 STATUS current 1184 DESCRIPTION 1185 "The number of requests that were received from the peer and 1186 explicitly canceled by the peer sending a PCNtf." 1187 ::= { pcePcepPeerEntry 44 } 1189 pcePcepPeerNumReqRcvdClosed OBJECT-TYPE 1190 SYNTAX Counter32 1191 MAX-ACCESS read-only 1192 STATUS current 1193 DESCRIPTION 1194 "The number of requests that were received from the peer and 1195 implicitly canceled when the session they were received over 1196 was closed." 1197 ::= { pcePcepPeerEntry 45 } 1199 pcePcepPeerNumRepRcvdUnknown OBJECT-TYPE 1200 SYNTAX Counter32 1201 MAX-ACCESS read-only 1202 STATUS current 1203 DESCRIPTION 1204 "The number of responses to unknown requests received from 1205 this peer. A response to an unknown request is a response 1206 whose RP object does not contain the request ID of any 1207 request that is currently outstanding on the session." 1208 ::= { pcePcepPeerEntry 46 } 1210 pcePcepPeerNumReqRcvdUnknown OBJECT-TYPE 1211 SYNTAX Counter32 1212 MAX-ACCESS read-only 1213 STATUS current 1214 DESCRIPTION 1215 "The number of unknown requests that have been received from 1216 a peer. An unknown request is a request whose RP object 1217 contains a request ID of zero." 1218 ::= { pcePcepPeerEntry 47 } 1220 -- 1221 -- The PCEP Sessions Table 1222 -- 1224 pcePcepSessObjects OBJECT IDENTIFIER ::= { pcePcepObjects 3 } 1226 pcePcepSessTable OBJECT-TYPE 1227 SYNTAX SEQUENCE OF PcePcepSessEntry 1228 MAX-ACCESS not-accessible 1229 STATUS current 1230 DESCRIPTION 1231 "A table of PCEP sessions that involve the local PCEP 1232 speaker. Each row in this table represents a single 1233 session." 1234 ::= { pcePcepSessObjects 1 } 1236 pcePcepSessEntry OBJECT-TYPE 1237 SYNTAX PcePcepSessEntry 1238 MAX-ACCESS not-accessible 1239 STATUS current 1240 DESCRIPTION 1241 "An entry in this table represents a single PCEP session in 1242 which the local PCEP speaker participates. 1244 An entry in this table exists only if the corresponding PCEP 1245 session has been initialized by some event, such as manual 1246 user configuration, autodiscovery of a peer, or an incoming 1247 TCP connection. 1249 An entry appears in this table when the corresponding PCEP 1250 session transitions out of idle state. If the PCEP session 1251 transitions back into idle state then the corresponding 1252 entry in this table is removed." 1253 INDEX { pcePcepEntityIndex, 1254 pcePcepPeerAddrType, 1255 pcePcepPeerAddr, 1256 pcePcepSessInitiator } 1257 ::= { pcePcepSessTable 1 } 1259 PcePcepSessEntry ::= SEQUENCE { 1260 pcePcepSessInitiator INTEGER, 1261 pcePcepSessStateLastChange TimeStamp, 1262 pcePcepSessState INTEGER, 1263 pcePcepSessConnectRetry Counter32, 1264 pcePcepSessLocalID Unsigned32, 1265 pcePcepSessRemoteID Unsigned32, 1266 pcePcepSessKeepaliveTimer Unsigned32, 1267 pcePcepSessPeerKeepaliveTimer Unsigned32, 1268 pcePcepSessDeadTimer Unsigned32, 1269 pcePcepSessPeerDeadTimer Unsigned32, 1270 pcePcepSessKAHoldTimeRem Unsigned32, 1271 pcePcepSessOverloaded TruthValue, 1272 pcePcepSessOverloadTime Unsigned32, 1273 pcePcepSessPeerOverloaded TruthValue, 1274 pcePcepSessPeerOverloadTime Unsigned32, 1275 pcePcepSessDiscontinuityTime TimeStamp, 1276 pcePcepSessAvgRspTime Unsigned32, 1277 pcePcepSessLWMRspTime Unsigned32, 1278 pcePcepSessHWMRspTime Unsigned32, 1279 pcePcepSessNumPCReqSent Counter32, 1280 pcePcepSessNumPCReqRcvd Counter32, 1281 pcePcepSessNumPCRepSent Counter32, 1282 pcePcepSessNumPCRepRcvd Counter32, 1283 pcePcepSessNumPCErrSent Counter32, 1284 pcePcepSessNumPCErrRcvd Counter32, 1285 pcePcepSessNumPCNtfSent Counter32, 1286 pcePcepSessNumPCNtfRcvd Counter32, 1287 pcePcepSessNumKeepaliveSent Counter32, 1288 pcePcepSessNumKeepaliveRcvd Counter32, 1289 pcePcepSessNumUnknownRcvd Counter32, 1290 pcePcepSessNumReqSent Counter32, 1291 pcePcepSessNumSvecSent Counter32, 1292 pcePcepSessNumSvecReqSent Counter32, 1293 pcePcepSessNumReqSentPendRep Counter32, 1294 pcePcepSessNumReqSentEroRcvd Counter32, 1295 pcePcepSessNumReqSentNoPathRcvd Counter32, 1296 pcePcepSessNumReqSentCancelRcvd Counter32, 1297 pcePcepSessNumReqSentErrorRcvd Counter32, 1298 pcePcepSessNumReqSentTimeout Counter32, 1299 pcePcepSessNumReqSentCancelSent Counter32, 1300 pcePcepSessNumReqRcvd Counter32, 1301 pcePcepSessNumSvecRcvd Counter32, 1302 pcePcepSessNumSvecReqRcvd Counter32, 1303 pcePcepSessNumReqRcvdPendRep Counter32, 1304 pcePcepSessNumReqRcvdEroSent Counter32, 1305 pcePcepSessNumReqRcvdNoPathSent Counter32, 1306 pcePcepSessNumReqRcvdCancelSent Counter32, 1307 pcePcepSessNumReqRcvdErrorSent Counter32, 1308 pcePcepSessNumReqRcvdCancelRcvd Counter32, 1309 pcePcepSessNumRepRcvdUnknown Counter32, 1310 pcePcepSessNumReqRcvdUnknown Counter32 1311 } 1313 pcePcepSessInitiator OBJECT-TYPE 1314 SYNTAX INTEGER { 1315 local(1), 1316 remote(2) 1317 } 1318 MAX-ACCESS not-accessible 1319 STATUS current 1320 DESCRIPTION 1321 "The initiator of the session, that is, whether the TCP 1322 connection was initiated by the local PCEP speaker or the 1323 remote PCEP speaker. 1325 There is a window during session initialization where two 1326 sessions can exist between a pair of PCEP speakers, each 1327 initiated by one of the speakers. One of these sessions is 1328 always discarded before it leaves OpenWait state. However, 1329 before it is discarded, two sessions to the given peer 1330 appear transiently in the MIB. The sessions are 1331 distinguished by who initiated them, and so this field is an 1332 index for the pcePcepSessTable." 1334 ::= { pcePcepSessEntry 1 } 1336 pcePcepSessStateLastChange OBJECT-TYPE 1337 SYNTAX TimeStamp 1338 MAX-ACCESS read-only 1339 STATUS current 1340 DESCRIPTION 1341 "The value of sysUpTime at the time this session entered its 1342 current state as denoted by the pcePcepSessState object." 1343 ::= { pcePcepSessEntry 2 } 1345 pcePcepSessState OBJECT-TYPE 1346 SYNTAX INTEGER { 1347 tcpPending(1), 1348 openWait(2), 1349 keepWait(3), 1350 sessionUp(4) 1351 } 1352 MAX-ACCESS read-only 1353 STATUS current 1354 DESCRIPTION 1355 "The current state of the session. 1357 The set of possible states excludes the idle state since 1358 entries do not exist in this table in the idle state." 1359 ::= { pcePcepSessEntry 3 } 1361 pcePcepSessConnectRetry OBJECT-TYPE 1362 SYNTAX Counter32 1363 MAX-ACCESS read-only 1364 STATUS current 1365 DESCRIPTION 1366 "The number of times that the local PCEP speaker has 1367 attempted to establish a TCP connection for this session 1368 without success. The PCEP speaker gives up when this 1369 reaches pcePcepEntityConnectMaxRetry." 1370 ::= { pcePcepSessEntry 4 } 1372 pcePcepSessLocalID OBJECT-TYPE 1373 SYNTAX Unsigned32 (0..255) 1374 MAX-ACCESS read-only 1375 STATUS current 1376 DESCRIPTION 1377 "The value of the PCEP session ID used by the local PCEP 1378 speaker in the Open message for this session. 1380 If pcePcepSessState is tcpPending then this is the session 1381 ID that will be used in the Open message. Otherwise, this 1382 is the session ID that was sent in the Open message." 1383 ::= { pcePcepSessEntry 5 } 1385 pcePcepSessRemoteID OBJECT-TYPE 1386 SYNTAX Unsigned32 (0..255) 1387 MAX-ACCESS read-only 1388 STATUS current 1389 DESCRIPTION 1390 "The value of the PCEP session ID used by the peer in its 1391 Open message for this session. 1393 If pcePcepSessState is tcpPending or openWait then this 1394 field is not used and MUST be set to zero." 1395 ::= { pcePcepSessEntry 6 } 1397 pcePcepSessKeepaliveTimer OBJECT-TYPE 1398 SYNTAX Unsigned32 (0..255) 1399 UNITS "seconds" 1400 MAX-ACCESS read-only 1401 STATUS current 1402 DESCRIPTION 1403 "The agreed maximum interval at which the local PCEP speaker 1404 transmits PCEP messages on this PCEP session. Zero means 1405 that the local PCEP speaker never sends Keepalives on this 1406 session. 1408 This field is used if and only if pcePcepSessState is 1409 sessionUp. Otherwise, it is not used and MUST be set to 1410 zero." 1411 ::= { pcePcepSessEntry 7 } 1413 pcePcepSessPeerKeepaliveTimer OBJECT-TYPE 1414 SYNTAX Unsigned32 (0..255) 1415 UNITS "seconds" 1416 MAX-ACCESS read-only 1417 STATUS current 1418 DESCRIPTION 1419 "The agreed maximum interval at which the peer transmits PCEP 1420 messages on this PCEP session. Zero means that the peer 1421 never sends Keepalives on this session. 1423 This field is used if and only if pcePcepSessState is 1424 sessionUp. Otherwise, it is not used and MUST be set to 1425 zero." 1426 ::= { pcePcepSessEntry 8 } 1428 pcePcepSessDeadTimer OBJECT-TYPE 1429 SYNTAX Unsigned32 (0..255) 1430 UNITS "seconds" 1431 MAX-ACCESS read-only 1432 STATUS current 1433 DESCRIPTION 1434 "The DeadTimer interval for this PCEP session." 1435 ::= { pcePcepSessEntry 9 } 1437 pcePcepSessPeerDeadTimer OBJECT-TYPE 1438 SYNTAX Unsigned32 (0..255) 1439 UNITS "seconds" 1440 MAX-ACCESS read-only 1441 STATUS current 1442 DESCRIPTION 1443 "The peer's DeadTimer interval for this PCEP session. 1445 If pcePcepSessState is tcpPending or openWait then this 1446 field is not used and MUST be set to zero." 1447 ::= { pcePcepSessEntry 10 } 1449 pcePcepSessKAHoldTimeRem OBJECT-TYPE 1450 SYNTAX Unsigned32 (0..255) 1451 UNITS "seconds" 1452 MAX-ACCESS read-only 1453 STATUS current 1454 DESCRIPTION 1455 "The keep alive hold time remaining for this session. 1457 If pcePcepSessState is tcpPending or openWait then this 1458 field is not used and MUST be set to zero." 1459 ::= { pcePcepSessEntry 11 } 1461 pcePcepSessOverloaded OBJECT-TYPE 1462 SYNTAX TruthValue 1463 MAX-ACCESS read-only 1464 STATUS current 1465 DESCRIPTION 1466 "If the local PCEP speaker has informed the peer that it is 1467 currently overloaded, then this is set to true. Otherwise, 1468 it is set to false." 1469 ::= { pcePcepSessEntry 12 } 1471 pcePcepSessOverloadTime OBJECT-TYPE 1472 SYNTAX Unsigned32 1473 UNITS "seconds" 1474 MAX-ACCESS read-only 1475 STATUS current 1476 DESCRIPTION 1477 "The interval of time until the local PCEP speaker will cease 1478 to be overloaded on this session. 1480 This field is only used if pcePcepSessOverloaded is set to 1481 true. Otherwise, it is not used and MUST be set to zero." 1482 ::= { pcePcepSessEntry 13 } 1484 pcePcepSessPeerOverloaded OBJECT-TYPE 1485 SYNTAX TruthValue 1486 MAX-ACCESS read-only 1487 STATUS current 1488 DESCRIPTION 1489 "If the peer has informed the local PCEP speaker that it is 1490 currently overloaded, then this is set to true. Otherwise, 1491 it is set to false." 1492 ::= { pcePcepSessEntry 14 } 1494 pcePcepSessPeerOverloadTime OBJECT-TYPE 1495 SYNTAX Unsigned32 1496 UNITS "seconds" 1497 MAX-ACCESS read-only 1498 STATUS current 1499 DESCRIPTION 1500 "The interval of time until the peer will cease to be 1501 overloaded. If it is not known how long the peer will stay 1502 in overloaded state, this field is set to zero. 1504 This field is only used if pcePcepSessPeerOverloaded is set 1505 to true. Otherwise, it is not used and MUST be set to 1506 zero." 1507 ::= { pcePcepSessEntry 15 } 1509 pcePcepSessDiscontinuityTime OBJECT-TYPE 1510 SYNTAX TimeStamp 1511 MAX-ACCESS read-only 1512 STATUS current 1513 DESCRIPTION 1514 "The value of sysUpTime at the time that the statistics in 1515 this row were last reset." 1516 ::= { pcePcepSessEntry 16 } 1518 pcePcepSessAvgRspTime OBJECT-TYPE 1519 SYNTAX Unsigned32 1520 UNITS "milliseconds" 1521 MAX-ACCESS read-only 1522 STATUS current 1523 DESCRIPTION 1524 "The average response time for this peer on this session. 1526 If an average response time has not been calculated for this 1527 peer then this object has the value zero." 1528 ::= { pcePcepSessEntry 17 } 1530 pcePcepSessLWMRspTime OBJECT-TYPE 1531 SYNTAX Unsigned32 1532 UNITS "milliseconds" 1533 MAX-ACCESS read-only 1534 STATUS current 1535 DESCRIPTION 1536 "The smallest (low-water mark) response time seen from this 1537 peer on this session. 1539 If no responses have been received from this peer then this 1540 object has the value zero." 1541 ::= { pcePcepSessEntry 18 } 1543 pcePcepSessHWMRspTime OBJECT-TYPE 1544 SYNTAX Unsigned32 1545 UNITS "milliseconds" 1546 MAX-ACCESS read-only 1547 STATUS current 1548 DESCRIPTION 1549 "The greatest (high-water mark) response time seen from this 1550 peer on this session. 1552 If no responses have been received from this peer then this 1553 object has the value zero." 1554 ::= { pcePcepSessEntry 19 } 1556 pcePcepSessNumPCReqSent OBJECT-TYPE 1557 SYNTAX Counter32 1558 MAX-ACCESS read-only 1559 STATUS current 1560 DESCRIPTION 1561 "The number of PCReq messages sent on this session." 1562 ::= { pcePcepSessEntry 20 } 1564 pcePcepSessNumPCReqRcvd OBJECT-TYPE 1565 SYNTAX Counter32 1566 MAX-ACCESS read-only 1567 STATUS current 1568 DESCRIPTION 1569 "The number of PCReq messages received on this session." 1570 ::= { pcePcepSessEntry 21 } 1572 pcePcepSessNumPCRepSent OBJECT-TYPE 1573 SYNTAX Counter32 1574 MAX-ACCESS read-only 1575 STATUS current 1576 DESCRIPTION 1577 "The number of PCRep messages sent on this session." 1578 ::= { pcePcepSessEntry 22 } 1580 pcePcepSessNumPCRepRcvd OBJECT-TYPE 1581 SYNTAX Counter32 1582 MAX-ACCESS read-only 1583 STATUS current 1584 DESCRIPTION 1585 "The number of PCRep messages received on this session." 1586 ::= { pcePcepSessEntry 23 } 1588 pcePcepSessNumPCErrSent OBJECT-TYPE 1589 SYNTAX Counter32 1590 MAX-ACCESS read-only 1591 STATUS current 1592 DESCRIPTION 1593 "The number of PCErr messages sent on this session." 1594 ::= { pcePcepSessEntry 24 } 1596 pcePcepSessNumPCErrRcvd OBJECT-TYPE 1597 SYNTAX Counter32 1598 MAX-ACCESS read-only 1599 STATUS current 1600 DESCRIPTION 1601 "The number of PCErr messages received on this session." 1602 ::= { pcePcepSessEntry 25 } 1604 pcePcepSessNumPCNtfSent OBJECT-TYPE 1605 SYNTAX Counter32 1606 MAX-ACCESS read-only 1607 STATUS current 1608 DESCRIPTION 1609 "The number of PCNtf messages sent on this session." 1610 ::= { pcePcepSessEntry 26 } 1612 pcePcepSessNumPCNtfRcvd OBJECT-TYPE 1613 SYNTAX Counter32 1614 MAX-ACCESS read-only 1615 STATUS current 1616 DESCRIPTION 1617 "The number of PCNtf messages received on this session." 1618 ::= { pcePcepSessEntry 27 } 1620 pcePcepSessNumKeepaliveSent OBJECT-TYPE 1621 SYNTAX Counter32 1622 MAX-ACCESS read-only 1623 STATUS current 1624 DESCRIPTION 1625 "The number of Keepalive messages sent on this session." 1626 ::= { pcePcepSessEntry 28 } 1628 pcePcepSessNumKeepaliveRcvd OBJECT-TYPE 1629 SYNTAX Counter32 1630 MAX-ACCESS read-only 1631 STATUS current 1632 DESCRIPTION 1633 "The number of Keepalive messages received on this session." 1634 ::= { pcePcepSessEntry 29 } 1636 pcePcepSessNumUnknownRcvd OBJECT-TYPE 1637 SYNTAX Counter32 1638 MAX-ACCESS read-only 1639 STATUS current 1640 DESCRIPTION 1641 "The number of unknown messages received on this session." 1642 ::= { pcePcepSessEntry 30 } 1644 pcePcepSessNumReqSent OBJECT-TYPE 1645 SYNTAX Counter32 1646 MAX-ACCESS read-only 1647 STATUS current 1648 DESCRIPTION 1649 "The number of requests sent on this session. A request 1650 corresponds 1:1 with an RP object in a PCReq message. 1652 This might be greater than pcePcepSessNumPCReqSent because 1653 multiple requests can be batched into a single PCReq 1654 message." 1655 ::= { pcePcepSessEntry 31 } 1657 pcePcepSessNumSvecSent OBJECT-TYPE 1658 SYNTAX Counter32 1659 MAX-ACCESS read-only 1660 STATUS current 1661 DESCRIPTION 1662 "The number of SVEC objects sent on this session in PCReq 1663 messages. An SVEC object represents a set of synchronized 1664 requests." 1665 ::= { pcePcepSessEntry 32 } 1667 pcePcepSessNumSvecReqSent OBJECT-TYPE 1668 SYNTAX Counter32 1669 MAX-ACCESS read-only 1670 STATUS current 1671 DESCRIPTION 1672 "The number of requests sent on this session that appeared in 1673 one or more SVEC objects." 1674 ::= { pcePcepSessEntry 33 } 1676 pcePcepSessNumReqSentPendRep OBJECT-TYPE 1677 SYNTAX Counter32 1678 MAX-ACCESS read-only 1679 STATUS current 1680 DESCRIPTION 1681 "The number of requests that have been sent on this session 1682 for which a response is still pending." 1683 ::= { pcePcepSessEntry 34 } 1685 pcePcepSessNumReqSentEroRcvd OBJECT-TYPE 1686 SYNTAX Counter32 1687 MAX-ACCESS read-only 1688 STATUS current 1689 DESCRIPTION 1690 "The number of successful responses received on this session. 1691 A response corresponds 1:1 with an RP object in a PCRep 1692 message. A successful response is a response for which an 1693 ERO was successfully computed." 1694 ::= { pcePcepSessEntry 35 } 1696 pcePcepSessNumReqSentNoPathRcvd OBJECT-TYPE 1697 SYNTAX Counter32 1698 MAX-ACCESS read-only 1699 STATUS current 1700 DESCRIPTION 1701 "The number of unsuccessful responses received on this 1702 session. A response corresponds 1:1 with an RP object in a 1703 PCRep message. An unsuccessful response is a response with 1704 a NO-PATH object." 1705 ::= { pcePcepSessEntry 36 } 1707 pcePcepSessNumReqSentCancelRcvd OBJECT-TYPE 1708 SYNTAX Counter32 1709 MAX-ACCESS read-only 1710 STATUS current 1711 DESCRIPTION 1712 "The number of requests sent on this session that were 1713 cancelled by the peer with a PCNtf message. 1715 This might be different than pcePcepSessNumPCNtfRcvd because 1716 not all PCNtf messages are used to cancel requests, and a 1717 single PCNtf message can cancel multiple requests." 1719 ::= { pcePcepSessEntry 37 } 1721 pcePcepSessNumReqSentErrorRcvd OBJECT-TYPE 1722 SYNTAX Counter32 1723 MAX-ACCESS read-only 1724 STATUS current 1725 DESCRIPTION 1726 "The number of requests sent on this session that were 1727 rejected by the peer with a PCErr message. 1729 This might be different than pcePcepSessNumPCErrRcvd because 1730 not all PCErr messages are used to reject requests, and a 1731 single PCErr message can reject multiple requests." 1732 ::= { pcePcepSessEntry 38 } 1734 pcePcepSessNumReqSentTimeout OBJECT-TYPE 1735 SYNTAX Counter32 1736 MAX-ACCESS read-only 1737 STATUS current 1738 DESCRIPTION 1739 "The number of requests sent on this session that have been 1740 sent to a peer and have been abandoned because the peer has 1741 taken too long to respond to them." 1742 ::= { pcePcepSessEntry 39 } 1744 pcePcepSessNumReqSentCancelSent OBJECT-TYPE 1745 SYNTAX Counter32 1746 MAX-ACCESS read-only 1747 STATUS current 1748 DESCRIPTION 1749 "The number of requests sent on this session that were sent 1750 to the peer and explicitly canceled by the local PCEP 1751 speaker sending a PCNtf." 1752 ::= { pcePcepSessEntry 40 } 1754 pcePcepSessNumReqRcvd OBJECT-TYPE 1755 SYNTAX Counter32 1756 MAX-ACCESS read-only 1757 STATUS current 1758 DESCRIPTION 1759 "The number of requests received on this session. A request 1760 corresponds 1:1 with an RP object in a PCReq message. 1762 This might be greater than pcePcepSessNumPCReqRcvd because 1763 multiple requests can be batched into a single PCReq 1764 message." 1765 ::= { pcePcepSessEntry 41 } 1767 pcePcepSessNumSvecRcvd OBJECT-TYPE 1768 SYNTAX Counter32 1769 MAX-ACCESS read-only 1770 STATUS current 1771 DESCRIPTION 1772 "The number of SVEC objects received on this session in PCReq 1773 messages. An SVEC object represents a set of synchronized 1774 requests." 1775 ::= { pcePcepSessEntry 42 } 1777 pcePcepSessNumSvecReqRcvd OBJECT-TYPE 1778 SYNTAX Counter32 1779 MAX-ACCESS read-only 1780 STATUS current 1781 DESCRIPTION 1782 "The number of requests received on this session that 1783 appeared in one or more SVEC objects." 1784 ::= { pcePcepSessEntry 43 } 1786 pcePcepSessNumReqRcvdPendRep OBJECT-TYPE 1787 SYNTAX Counter32 1788 MAX-ACCESS read-only 1789 STATUS current 1790 DESCRIPTION 1791 "The number of requests that have been received on this 1792 session for which a response is still pending." 1793 ::= { pcePcepSessEntry 44 } 1795 pcePcepSessNumReqRcvdEroSent OBJECT-TYPE 1796 SYNTAX Counter32 1797 MAX-ACCESS read-only 1798 STATUS current 1799 DESCRIPTION 1800 "The number of successful responses sent on this session. A 1801 response corresponds 1:1 with an RP object in a PCRep 1802 message. A successful response is a response for which an 1803 ERO was successfully computed." 1804 ::= { pcePcepSessEntry 45 } 1806 pcePcepSessNumReqRcvdNoPathSent OBJECT-TYPE 1807 SYNTAX Counter32 1808 MAX-ACCESS read-only 1809 STATUS current 1810 DESCRIPTION 1811 "The number of unsuccessful responses sent on this session. 1812 A response corresponds 1:1 with an RP object in a PCRep 1813 message. An unsuccessful response is a response with a 1814 NO-PATH object." 1816 ::= { pcePcepSessEntry 46 } 1818 pcePcepSessNumReqRcvdCancelSent OBJECT-TYPE 1819 SYNTAX Counter32 1820 MAX-ACCESS read-only 1821 STATUS current 1822 DESCRIPTION 1823 "The number of requests received on this session that were 1824 cancelled by the local PCEP speaker sending a PCNtf message. 1826 This might be different than pcePcepSessNumPCNtfSent because 1827 not all PCNtf messages are used to cancel requests, and a 1828 single PCNtf message can cancel multiple requests." 1829 ::= { pcePcepSessEntry 47 } 1831 pcePcepSessNumReqRcvdErrorSent OBJECT-TYPE 1832 SYNTAX Counter32 1833 MAX-ACCESS read-only 1834 STATUS current 1835 DESCRIPTION 1836 "The number of requests received on this session that were 1837 rejected by the local PCEP speaker sending a PCErr message. 1839 This might be different than pcePcepSessNumPCErrSent because 1840 not all PCErr messages are used to reject requests, and a 1841 single PCErr message can reject multiple requests." 1842 ::= { pcePcepSessEntry 48 } 1844 pcePcepSessNumReqRcvdCancelRcvd OBJECT-TYPE 1845 SYNTAX Counter32 1846 MAX-ACCESS read-only 1847 STATUS current 1848 DESCRIPTION 1849 "The number of requests that were received on this session 1850 and explicitly canceled by the peer sending a PCNtf." 1851 ::= { pcePcepSessEntry 49 } 1853 pcePcepSessNumRepRcvdUnknown OBJECT-TYPE 1854 SYNTAX Counter32 1855 MAX-ACCESS read-only 1856 STATUS current 1857 DESCRIPTION 1858 "The number of responses to unknown requests received on this 1859 session. A response to an unknown request is a response 1860 whose RP object does not contain the request ID of any 1861 request that is currently outstanding on the session." 1862 ::= { pcePcepSessEntry 50 } 1864 pcePcepSessNumReqRcvdUnknown OBJECT-TYPE 1865 SYNTAX Counter32 1866 MAX-ACCESS read-only 1867 STATUS current 1868 DESCRIPTION 1869 "The number of unknown requests that have been received on 1870 this session. An unknown request is a request whose RP 1871 object contains a request ID of zero." 1872 ::= { pcePcepSessEntry 51 } 1874 --- 1875 --- Notifications 1876 --- 1878 pcePcepSessUp NOTIFICATION-TYPE 1879 OBJECTS { 1880 pcePcepSessState, 1881 pcePcepSessStateLastChange 1882 } 1883 STATUS current 1884 DESCRIPTION 1885 "This notification is sent when the value of 1886 'pcePcepSessState' enters the 'sessionUp' state." 1887 ::= { pcePcepNotifications 1 } 1889 pcePcepSessDown NOTIFICATION-TYPE 1890 OBJECTS { 1891 pcePcepSessState, 1892 pcePcepSessStateLastChange 1893 } 1894 STATUS current 1895 DESCRIPTION 1896 "This notification is sent when the value of 1897 'pcePcepSessState' leaves the 'sessionUp' state." 1898 ::= { pcePcepNotifications 2 } 1900 pcePcepSessLocalOverload NOTIFICATION-TYPE 1901 OBJECTS { 1902 pcePcepSessOverloaded, 1903 pcePcepSessOverloadTime 1904 } 1905 STATUS current 1906 DESCRIPTION 1907 "This notification is sent when the local PCEP speaker enters 1908 overload state for a peer." 1909 ::= { pcePcepNotifications 3 } 1911 pcePcepSessLocalOverloadClear NOTIFICATION-TYPE 1912 OBJECTS { 1913 pcePcepSessOverloaded 1914 } 1915 STATUS current 1916 DESCRIPTION 1917 "This notification is sent when the local PCEP speaker leaves 1918 overload state for a peer." 1919 ::= { pcePcepNotifications 4 } 1921 pcePcepSessPeerOverload NOTIFICATION-TYPE 1922 OBJECTS { 1923 pcePcepSessPeerOverloaded, 1924 pcePcepSessPeerOverloadTime 1925 } 1926 STATUS current 1927 DESCRIPTION 1928 "This notification is sent when a peer enters overload 1929 state." 1930 ::= { pcePcepNotifications 5 } 1932 pcePcepSessPeerOverloadClear NOTIFICATION-TYPE 1933 OBJECTS { 1934 pcePcepSessPeerOverloaded 1935 } 1936 STATUS current 1937 DESCRIPTION 1938 "This notification is sent when a peer leaves overload 1939 state." 1940 ::= { pcePcepNotifications 6 } 1942 -- 1943 -- Module Conformance Statement 1944 -- 1946 pcePcepCompliances 1947 OBJECT IDENTIFIER ::= { pcePcepConformance 1 } 1949 pcePcepGroups 1950 OBJECT IDENTIFIER ::= { pcePcepConformance 2 } 1952 -- 1953 -- Read-Only Compliance 1954 -- 1956 pcePcepModuleReadOnlyCompliance MODULE-COMPLIANCE 1957 STATUS current 1958 DESCRIPTION 1959 "The Module is implemented with support for read-only. In 1960 other words, only monitoring is available by implementing 1961 this MODULE-COMPLIANCE." 1963 MODULE -- this module 1964 MANDATORY-GROUPS { 1965 pcePcepGeneralGroup, 1966 pcePcepNotificationsGroup 1967 } 1968 ::= { pcePcepCompliances 1 } 1970 -- units of conformance 1972 pcePcepGeneralGroup OBJECT-GROUP 1973 OBJECTS { pcePcepEntityAdminStatus, 1974 pcePcepEntityOperStatus, 1975 pcePcepEntityAddrType, 1976 pcePcepEntityAddr, 1977 pcePcepEntityConnectTimer, 1978 pcePcepEntityConnectMaxRetry, 1979 pcePcepEntityOpenWaitTimer, 1980 pcePcepEntityKeepWaitTimer, 1981 pcePcepEntityKeepAliveTimer, 1982 pcePcepEntityDeadTimer, 1983 pcePcepEntityMaxKeepAliveTimer, 1984 pcePcepEntityMaxDeadTimer, 1985 pcePcepEntityAllowNegotiation, 1986 pcePcepEntityMinKeepAliveTimer, 1987 pcePcepEntityMinDeadTimer, 1988 pcePcepEntitySyncTimer, 1989 pcePcepEntityRequestTimer, 1990 pcePcepEntityInitBackoffTimer, 1991 pcePcepEntityMaxBackoffTimer, 1992 pcePcepEntityMaxSessions, 1993 pcePcepEntityMaxUnknownReqs, 1994 pcePcepEntityMaxUnknownMsgs, 1995 pcePcepPeerRole, 1996 pcePcepPeerDiscontinuityTime, 1997 pcePcepPeerInitiateSession, 1998 pcePcepPeerSessionExists, 1999 pcePcepPeerNumSessSetupOK, 2000 pcePcepPeerNumSessSetupFail, 2001 pcePcepPeerSessionUpTime, 2002 pcePcepPeerSessionFailTime, 2003 pcePcepPeerAvgRspTime, 2004 pcePcepPeerLWMRspTime, 2005 pcePcepPeerHWMRspTime, 2006 pcePcepPeerNumPCReqSent, 2007 pcePcepPeerNumPCReqRcvd, 2008 pcePcepPeerNumPCRepSent, 2009 pcePcepPeerNumPCRepRcvd, 2010 pcePcepPeerNumPCErrSent, 2011 pcePcepPeerNumPCErrRcvd, 2012 pcePcepPeerNumPCNtfSent, 2013 pcePcepPeerNumPCNtfRcvd, 2014 pcePcepPeerNumKeepaliveSent, 2015 pcePcepPeerNumKeepaliveRcvd, 2016 pcePcepPeerNumUnknownRcvd, 2017 pcePcepPeerNumReqSent, 2018 pcePcepPeerNumSvecSent, 2019 pcePcepPeerNumSvecReqSent, 2020 pcePcepPeerNumReqSentPendRep, 2021 pcePcepPeerNumReqSentEroRcvd, 2022 pcePcepPeerNumReqSentNoPathRcvd, 2023 pcePcepPeerNumReqSentCancelRcvd, 2024 pcePcepPeerNumReqSentErrorRcvd, 2025 pcePcepPeerNumReqSentTimeout, 2026 pcePcepPeerNumReqSentCancelSent, 2027 pcePcepPeerNumReqSentClosed, 2028 pcePcepPeerNumReqRcvd, 2029 pcePcepPeerNumSvecRcvd, 2030 pcePcepPeerNumSvecReqRcvd, 2031 pcePcepPeerNumReqRcvdPendRep, 2032 pcePcepPeerNumReqRcvdEroSent, 2033 pcePcepPeerNumReqRcvdNoPathSent, 2034 pcePcepPeerNumReqRcvdCancelSent, 2035 pcePcepPeerNumReqRcvdErrorSent, 2036 pcePcepPeerNumReqRcvdCancelRcvd, 2037 pcePcepPeerNumReqRcvdClosed, 2038 pcePcepPeerNumRepRcvdUnknown, 2039 pcePcepPeerNumReqRcvdUnknown, 2040 pcePcepSessStateLastChange, 2041 pcePcepSessState, 2042 pcePcepSessConnectRetry, 2043 pcePcepSessLocalID, 2044 pcePcepSessRemoteID, 2045 pcePcepSessKeepaliveTimer, 2046 pcePcepSessPeerKeepaliveTimer, 2047 pcePcepSessDeadTimer, 2048 pcePcepSessPeerDeadTimer, 2049 pcePcepSessKAHoldTimeRem, 2050 pcePcepSessOverloaded, 2051 pcePcepSessOverloadTime, 2052 pcePcepSessPeerOverloaded, 2053 pcePcepSessPeerOverloadTime, 2054 pcePcepSessDiscontinuityTime, 2055 pcePcepSessAvgRspTime, 2056 pcePcepSessLWMRspTime, 2057 pcePcepSessHWMRspTime, 2058 pcePcepSessNumPCReqSent, 2059 pcePcepSessNumPCReqRcvd, 2060 pcePcepSessNumPCRepSent, 2061 pcePcepSessNumPCRepRcvd, 2062 pcePcepSessNumPCErrSent, 2063 pcePcepSessNumPCErrRcvd, 2064 pcePcepSessNumPCNtfSent, 2065 pcePcepSessNumPCNtfRcvd, 2066 pcePcepSessNumKeepaliveSent, 2067 pcePcepSessNumKeepaliveRcvd, 2068 pcePcepSessNumUnknownRcvd, 2069 pcePcepSessNumReqSent, 2070 pcePcepSessNumSvecSent, 2071 pcePcepSessNumSvecReqSent, 2072 pcePcepSessNumReqSentPendRep, 2073 pcePcepSessNumReqSentEroRcvd, 2074 pcePcepSessNumReqSentNoPathRcvd, 2075 pcePcepSessNumReqSentCancelRcvd, 2076 pcePcepSessNumReqSentErrorRcvd, 2077 pcePcepSessNumReqSentTimeout, 2078 pcePcepSessNumReqSentCancelSent, 2079 pcePcepSessNumReqRcvd, 2080 pcePcepSessNumSvecRcvd, 2081 pcePcepSessNumSvecReqRcvd, 2082 pcePcepSessNumReqRcvdPendRep, 2083 pcePcepSessNumReqRcvdEroSent, 2084 pcePcepSessNumReqRcvdNoPathSent, 2085 pcePcepSessNumReqRcvdCancelSent, 2086 pcePcepSessNumReqRcvdErrorSent, 2087 pcePcepSessNumReqRcvdCancelRcvd, 2088 pcePcepSessNumRepRcvdUnknown, 2089 pcePcepSessNumReqRcvdUnknown 2090 } 2091 STATUS current 2092 DESCRIPTION 2093 "Objects that apply to all PCEP MIB implementations." 2094 ::= { pcePcepGroups 1 } 2096 pcePcepNotificationsGroup NOTIFICATION-GROUP 2097 NOTIFICATIONS { pcePcepSessUp, 2098 pcePcepSessDown, 2099 pcePcepSessLocalOverload, 2100 pcePcepSessLocalOverloadClear, 2101 pcePcepSessPeerOverload, 2102 pcePcepSessPeerOverloadClear 2103 } 2105 STATUS current 2106 DESCRIPTION 2107 "The notifications for a PCEP MIB implementation." 2108 ::= { pcePcepGroups 2 } 2110 END 2112 7. Security Considerations 2114 The readable objects in the PCE-PCEP-MIB module (i.e., those with 2115 MAX-ACCESS other than not-accessible) may be considered sensitive in 2116 some environments since, collectively, they provide information about 2117 the amount and frequency of path computation requests and responses 2118 within the network and can reveal some aspects of their 2119 configuration. 2121 In such environments it is important to control also GET and NOTIFY 2122 access to these objects and possibly even to encrypt their values 2123 when sending them over the network via SNMP. 2125 SNMP versions prior to SNMPv3 did not include adequate security. 2126 Even if the network itself is secure (for example by using IPsec), 2127 even then, there is no control as to who on the secure network is 2128 allowed to access and GET/SET (read/change/create/delete) the objects 2129 in this MIB module. 2131 It is RECOMMENDED that implementers consider the security features as 2132 provided by the SNMPv3 framework (see [RFC3410], section 8), 2133 including full support for the SNMPv3 cryptographic mechanisms (for 2134 authentication and privacy). 2136 Further, deployment of SNMP versions prior to SNMPv3 is NOT 2137 RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to 2138 enable cryptographic security. It is then a customer/operator 2139 responsibility to ensure that the SNMP entity giving access to an 2140 instance of this MIB module is properly configured to give access to 2141 the objects only to those principals (users) that have legitimate 2142 rights to indeed GET or SET (change/create/delete) them. 2144 8. IANA Considerations 2146 The MIB module in this document uses the following IANA-assigned 2147 OBJECT IDENTIFIER values recorded in the SMI Numbers registry: 2149 Descriptor OBJECT IDENTIFIER value 2150 ---------- ----------------------- 2151 pcePcepMIB { mib-2 XXX } 2153 Editor's Note (to be removed prior to publication): the IANA is 2154 requested to assign a value for "XXX" under the 'mib-2' subtree and 2155 to record the assignment in the SMI Numbers registry. When the 2156 assignment has been made, the RFC Editor is asked to replace "XXX" 2157 (here and in the MIB module) with the assigned value and to remove 2158 this note. 2160 9. Contributors 2162 Thanks to Dhruv Dhody for his contribution and detailed review. 2164 10. References 2166 10.1. Normative References 2168 [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate 2169 Requirement Levels", BCP 14, RFC 2119, March 1997. 2171 [RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J. 2172 Schoenwaelder, Ed., "Structure of Management Information 2173 Version 2 (SMIv2)", STD 58, RFC 2578, April 1999. 2175 [RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J. 2176 Schoenwaelder, Ed., "Textual Conventions for SMIv2", 2177 STD 58, RFC 2579, April 1999. 2179 [RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder, 2180 "Conformance Statements for SMIv2", STD 58, RFC 2580, 2181 April 1999. 2183 [RFC4001] Daniele, M., Haberman, B., Routhier, S., and J. 2184 Schoenwaelder, "Textual Conventions for Internet Network 2185 Addresses", RFC 4001, February 2005. 2187 [RFC4655] Farrel, A., Vasseur, J., and J. Ash, "A Path Computation 2188 Element (PCE)-Based Architecture", RFC 4655, August 2006. 2190 [RFC5440] Vasseur, JP. and JL. Le Roux, "Path Computation Element 2191 (PCE) Communication Protocol (PCEP)", RFC 5440, 2192 March 2009. 2194 10.2. Normative References 2196 [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, 2197 "Introduction and Applicability Statements for Internet- 2198 Standard Management Framework", RFC 3410, December 2002. 2200 Appendix A. Acknowledgement 2202 The authors would like to thank Santanu Mazumder and Meral 2203 Shirazipour for their valuable input. 2205 Funding for the RFC Editor function is currently provided by the 2206 Internet Society. 2208 Authors' Addresses 2210 A S Kiran Koushik 2211 Cisco Systems, Inc. 2213 EMail: kkoushik@cisco.com 2215 Emile Stephan 2216 France Telecom 2217 2 avenue Pierre Marzin 2218 Lannion F-22307 2219 France 2221 EMail: emile.stephan@orange.com 2223 Quintin Zhao 2224 Huawei Technology 2225 125 Nagog Technology Park 2226 Acton, MA 01719 2227 US 2229 EMail: qzhao@huawei.com 2231 Daniel King 2232 Old Dog Consulting 2233 UK 2235 EMail: daniel@olddog.co.uk 2236 Jonathan Hardwick 2237 Metaswitch 2238 100 Church Street 2239 Enfield EN2 6BQ 2240 UK 2242 EMail: jonathan.hardwick@metaswitch.com