Internet Engineering Task Force (IETF)                          F. Zhang
Request for Comments: 7470                                        Huawei
Obsoletes: 7150                                                A. Farrel
Category: Standards Track                               Juniper Networks
ISSN: 2070-1721                                               March 2015


                Conveying Vendor-Specific Constraints
        in the Path Computation Element Communication Protocol

Abstract

  The Path Computation Element Communication Protocol (PCEP) is used to
  convey path computation requests and responses both between Path
  Computation Clients (PCCs) and Path Computation Elements (PCEs) and
  between cooperating PCEs.  In PCEP, the path computation requests
  carry details of the constraints and objective functions that the PCC
  wishes the PCE to apply in its computation.

  This document defines a facility to carry vendor-specific information
  in PCEP using a dedicated object and a new Type-Length-Value (TLV)
  that can be carried in any PCEP object that supports TLVs.

  This document obsoletes RFC 7150.  The only changes from that
  document are a clarification of the use of the new Type-Length-Value
  and the allocation of a different code point for the VENDOR-
  INFORMATION object.

Status of This Memo

  This is an Internet Standards Track document.

  This document is a product of the Internet Engineering Task Force
  (IETF).  It represents the consensus of the IETF community.  It has
  received public review and has been approved for publication by the
  Internet Engineering Steering Group (IESG).  Further information on
  Internet Standards is available in Section 2 of RFC 5741.

  Information about the current status of this document, any errata,
  and how to provide feedback on it may be obtained at
  http://www.rfc-editor.org/info/rfc7470.










Zhang & Farrel               Standards Track                    [Page 1]

RFC 7470           Vendor-Specific Constraints in PCE         March 2015


Copyright Notice

  Copyright (c) 2015 IETF Trust and the persons identified as the
  document authors.  All rights reserved.

  This document is subject to BCP 78 and the IETF Trust's Legal
  Provisions Relating to IETF Documents
  (http://trustee.ietf.org/license-info) in effect on the date of
  publication of this document.  Please review these documents
  carefully, as they describe your rights and restrictions with respect
  to this document.  Code Components extracted from this document must
  include Simplified BSD License text as described in Section 4.e of
  the Trust Legal Provisions and are provided without warranty as
  described in the Simplified BSD License.

Table of Contents

  1. Introduction ....................................................3
     1.1. Conventions Used in This Document ..........................4
  2. Procedures for the Vendor Information Object ....................5
     2.1. Backward Compatibility for the Vendor Information Object ...7
  3. Procedures for the Vendor Information TLV .......................7
     3.1. Backward Compatibility .....................................8
  4. Protocol Elements ...............................................8
  5. IANA Considerations .............................................9
     5.1. New PCEP Object ............................................9
     5.2. New PCEP TLV ...............................................9
  6. Management Considerations ......................................10
     6.1. Control of Function and Policy ............................10
     6.2. Information and Data Models ...............................10
     6.3. Liveness Detection and Monitoring .........................10
     6.4. Verifying Correct Operation ...............................10
     6.5. Requirements on Other Protocols and Functional Components .11
     6.6. Impact on Network Operation ...............................11
  7. Security Considerations ........................................11
  8. References .....................................................12
     8.1. Normative References ......................................12
     8.2. Informative References ....................................12
  Acknowledgements ..................................................14
  Contributors ......................................................14
  Authors' Addresses ................................................14










Zhang & Farrel               Standards Track                    [Page 2]

RFC 7470           Vendor-Specific Constraints in PCE         March 2015


1.  Introduction

  A Path Computation Element (PCE) is an entity (component,
  application, or network node) that is capable of computing a network
  path or route based on a network graph and applying computational
  constraints.  An architecture for the use of PCEs is defined in
  [RFC4655].

  The Path Computation Element Communication Protocol (PCEP) is defined
  in [RFC5440] to exchange path computation requests and responses
  between Path Computation Clients (PCCs) and PCEs.  It is also used
  between cooperating PCEs.

  Path computations performed by a PCE depend on a set of constraints
  indicated by the PCC.  These constraints include the endpoints of the
  path to compute (source and destination) and may include other simple
  constraints such as bandwidth requirements and metric maxima (for
  example, a maximum threshold for the hop count or the Traffic
  Engineering (TE) metric of the computed path).

  The PCE also needs to use an objective function to qualify the path
  it selects as meeting the requirements of the PCC.  The PCE may have
  a default objective function, but the PCC can also indicate which
  objective function it wants applied by placing an Objective Function
  object in the path computation request message [RFC5541].  A core set
  of objective functions to be supported in PCEP messages is defined in
  the base PCEP requirements [RFC4657], and [RFC5541] defines each of
  these functions as an abstract formula.

  The registry of codepoints used to indicate objective functions is
  managed by IANA and new assignments can be made according to "IETF
  Review" and "First Come First Served" policies [RFC5226].  PCE
  implementations may also choose to offer proprietary, vendor-specific
  objective functions, and there is scope for this within the codepoint
  registry created by [RFC5541] using the codepoints that are flagged
  as "Reserved for Private Use".

  Proprietary objective functions may operate on non-standard
  constraints or metrics.  The PCEP METRIC Object defined in [RFC5440]
  has scope for the definition of new, standardized metrics, but no
  facility for the definition of vendor-specific metrics.  At the same
  time, there is no mechanism in PCEP for carrying other, more complex,
  vendor-specific information.

  This document defines a new PCEP object, the Vendor Information
  object that can be used to carry arbitrary, proprietary information
  such as vendor-specific constraints.




Zhang & Farrel               Standards Track                    [Page 3]

RFC 7470           Vendor-Specific Constraints in PCE         March 2015


  This document also defines a new PCEP TLV, the VENDOR-INFORMATION-TLV
  that can be used to carry arbitrary information within any existing
  or future PCEP object that supports TLVs.

  It should be noted that by the very definition of "vendor-specific",
  the inclusion of either a Vendor Information object or the VENDOR-
  INFORMATION-TLV implies an inability to interoperate at a functional
  level with implementations from other vendors unless there is some
  cooperation agreement between vendors.  Sections 2.1 and 3.1 discuss
  backward compatibility, which indicates how these protocol constructs
  are handled by implementations that do not support them at all, while
  text in Sections 2 and 3 describe how implementations handle the
  constructs if they understand them, but do not support the embedded
  Enterprise Number that indicates to which vendor the constructs
  apply.

  When vendor-specific information is used by an implementation, the
  vendor is encouraged to document the meaning of the information to
  encourage wider use and implementation.  In particular, when there is
  more general interest in a vendor-specific extension, the vendor is
  encouraged to bring it to the IETF for standardization as a regular
  protocol construct, thereby moving it out of the vendor-specific
  space.

  This document obsoletes RFC 7150 [RFC7150], making two changes to
  that document:

  -  Clarification that the TLV is available for use in any PCEP object
     (existing or future) that supports TLVs.

  -  The allocation of a different code point for the
     VENDOR-INFORMATION object.  This change became necessary because
     of an inadvertent clash with codepoints used in an Internet-Draft
     that had been deployed without IANA allocation.  The PCE working
     group has conducted a survey of implementations and deployments of
     RFC 7150 and considers that this change is safe and does not harm
     early implementers of RFC 7150.

1.1.  Conventions Used in This Document

  The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
  "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
  "OPTIONAL" in this document are to be interpreted as described in
  [RFC2119].







Zhang & Farrel               Standards Track                    [Page 4]

RFC 7470           Vendor-Specific Constraints in PCE         March 2015


2.  Procedures for the Vendor Information Object

  A PCC that wants to convey proprietary or vendor-specific constraints
  or metrics to a PCE does so by including a Vendor Information object
  in the PCReq message.  The contents and format of the object are
  described in Section 4, but it is important to note that the object
  includes an Enterprise Number that is a unique identifier of an
  organization responsible for the definition of the content and
  meaning of the object.

  A PCE that receives a PCReq message containing a Vendor Information
  object MUST act according to the P flag in the object header.  That
  is, if the P flag is set, the object will be treated as mandatory and
  the request will either be processed using the contents of the object
  or be rejected as defined in [RFC5440] (see also Section 2.1).  If
  the P flag is clear, then, as defined in [RFC5440], the object may be
  used by the PCE or may be ignored.  The PCC sets the P flag according
  to how it wishes the request to be processed.

  The PCE determines how to interpret the information in the Vendor
  Information object by examining the Enterprise Number it contains.
  An implementation that supports the Vendor Information object, but
  receives one carrying an Enterprise Number that it does not support
  MUST act according to the P flag in the object.  That is, if the P
  flag is set, the PCE MUST reject the PCReq as defined in [RFC5440] by
  sending an Error message with Error-Type="Not supported Object" along
  with the corresponding Vendor Information object.

  The Vendor Information object is OPTIONAL in a PCReq message.
  Multiple instances of the object MAY be used on a single PCReq
  message, and each MUST be treated according to its P-bit setting.
  Different instances of the object can have different Enterprise
  Numbers.

  The object can be present in the PCReq message to enable it to apply
  to a single path computation request or to a set of synchronized
  requests.  This usage mirrors the usage of the Objective Function
  object [RFC5541].  Thus, the PCReq message based on [RFC6006] is
  encoded as follows using the syntax described in [RFC5511].












Zhang & Farrel               Standards Track                    [Page 5]

RFC 7470           Vendor-Specific Constraints in PCE         March 2015


  <PCReq Message> ::= <Common Header>
                      [<svec_list>]
                      <request-list>

  where

      <svec-list> ::= <SVEC>
                      [<OF>]
                      [<GC>]
                      [<XRO>]
                      [<metric-list>]
                      [<vendor-info-list>]
                      [<svec-list>]

      <metric-list> ::= <METRIC>
                        [<metric-list>]

      <vendor-info-list> ::= <VENDOR-INFORMATION>
                             [<vendor-info-list>]

      <request-list> ::= <request>
                         [<request-list>]

      <request> ::= <RP>
                    [<vendor-info-list>]
                    <end-point-rro-pair-list>
                    [<LSPA>]
                    [<BANDWIDTH>]
                    [<metric-list>]
                    [<OF>]
                    [<RRO>]
                    [<IRO>]
                    [<LOAD-BALANCING>]

  where

      <end-point-rro-pair-list> ::= <END-POINTS>
                                    [<RRO-List>]
                                    [<BANDWIDTH>]
                                    [<vendor-info-list>]
                                    [<end-point-rro-pair-list>]

      <RRO-List> ::= <RRO> [<BANDWIDTH>] [<RRO-List>]

      <metric-list> ::= <METRIC> [<metric-list>]






Zhang & Farrel               Standards Track                    [Page 6]

RFC 7470           Vendor-Specific Constraints in PCE         March 2015


  The Vendor Information object can be included in a PCRep message in
  exactly the same way as any other object as defined in [RFC5440].
  Thus, the PCRep is encoded as follows:

    <PCRep Message> ::= <Common Header>
                        <response>

    <response> ::= <RP>
                   [<vendor-info-list>]
                   [<end-point-path-pair-list>]
                   [<NO-PATH>]
                   [<attribute-list>]

  where:

     <end-point-path-pair-list> ::=
                    [<END-POINTS>]
                    <path>
                    [<vendor-info-list>]
                    [<end-point-path-pair-list>]

    <path> ::= (<ERO>|<SERO>) [<path>]

    <attribute-list> ::= [<OF>]
                         [<LSPA>]
                         [<BANDWIDTH>]
                         [<metric-list>]
                         [<IRO>]

2.1.  Backward Compatibility for the Vendor Information Object

  A legacy implementation that does not recognize the Vendor
  Information object will act according to the procedures set out in
  [RFC5440].  If the P flag is set in the object, the message will be
  rejected using a PCErr message with an Error Type of 3 ("Unknown
  Object").  If the P flag is not set, the object can safely be ignored
  by the recipient.

3.  Procedures for the Vendor Information TLV

  The Vendor Information TLV can be used to carry vendor-specific
  information that applies to a specific PCEP object by including the
  TLV in the object.








Zhang & Farrel               Standards Track                    [Page 7]

RFC 7470           Vendor-Specific Constraints in PCE         March 2015


  The PCE determines how to interpret the Vendor Information TLV by
  examining the Enterprise Number it contains.  If the Enterprise
  Number is unknown to the PCE, it MUST treat the Vendor Information
  TLV as an unknown TLV and handle it as described in [RFC5440] (see
  also Section 3.1).

  Further specifications are needed to define the position and meaning
  of the Vendor Information TLV for specific PCEP objects.

3.1.  Backward Compatibility

  A legacy implementation that does not recognize the Vendor
  Information TLV in an object will act according to the procedures set
  out in [RFC5440].  As described in Section 7.1 of [RFC5440],
  unrecognized TLVs MUST be ignored.

4.  Protocol Elements

  The Vendor Information object and TLV conform to the format for PCEP
  objects and TLVs defined in [RFC5440].

  VENDOR-INFORMATION Object-Class 34

  VENDOR-INFORMATION Object-Type 1

  VENDOR-INFORMATION-TLV Type 7

  The format of the VENDOR-INFORMATION object and the format of the
  VENDOR-INFORMATION-TLV are the same and are as shown in Figure 1.

     0                   1                   2                   3
     0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    |                       Enterprise Number                       |
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    ~                 Enterprise-Specific Information               ~
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

       Figure 1 : Format of the Vendor Information Object and TLV

  Enterprise Number

     A unique identifier of an organization encoded as a 32-bit
     integer.  Enterprise Numbers are assigned by IANA and managed
     through an IANA registry [RFC2578].






Zhang & Farrel               Standards Track                    [Page 8]

RFC 7470           Vendor-Specific Constraints in PCE         March 2015


  Enterprise-Specific Information

     The detailed enterprise-specific constraint information carried by
     the object.  The format and interpretation of this information is
     a matter for the enterprise identified by the Enterprise Number.
     Such formats and interpretation may be published by the enterprise
     (possibly through an Informational RFC or through commercial
     documentation) so that PCCs or PCEs that are not part of the
     organization can use the information.

5.  IANA Considerations

  IANA maintains a registry of PCEP parameters called the "Path
  Computation Element Protocol (PCEP) Numbers".

5.1.  New PCEP Object

  IANA had previously allocated the value 32 from the "PCEP Objects"
  subregistry for use as the VENDOR-INFORMATION object.  IANA has
  released that value and marked it as "Unassigned".

  IANA has assigned a new value as follows.

  Object-Class Value     Name                               Reference
      34                 VENDOR-INFORMATION                 RFC 7470
             Object-Type
               0: Unassigned
               1: Vendor-Specific Constraints               RFC 7470
               2-15: Unassigned

5.2.  New PCEP TLV

  IANA had made an allocation from the "PCEP TLV Type Indicators"
  subregistry, where RFC 7150 was the reference.  IANA has updated the
  reference as follows to point to this document.

  Value       Description                                   Reference
    7         VENDOR-INFORMATION-TLV                        RFC 7470













Zhang & Farrel               Standards Track                    [Page 9]

RFC 7470           Vendor-Specific Constraints in PCE         March 2015


6.  Management Considerations

  This section follows the guidance of [RFC5706] and [RFC6123].

6.1.  Control of Function and Policy

  A PCEP implementation SHOULD allow configuring of various parameters
  as described in [RFC5440].  A PCC implementation that uses vendor-
  specific information MAY make the use of this information
  configurable either across the whole PCC, per PCE that the PCC uses,
  or per path computation request.  A PCE that supports vendor-specific
  information MAY make the support of this information configurable,
  and MAY allow configuration of policies for the use of the
  information.

6.2.  Information and Data Models

  A PCEP MIB module is defined in [RFC7420] that describes managed
  objects for modeling of PCEP communications.

  It is NOT RECOMMENDED that standard MIB modules be extended to
  include detailed information about the content of the Vendor
  Information object or TLV.  However, the standard MIB module MAY be
  extended to report the use of the Vendor Information object or TLV
  and the Enterprise Numbers that the objects and TLVs contain.

6.3.  Liveness Detection and Monitoring

  This document makes no change to the basic operation of PCEP, so
  there are no changes to the requirements for liveness detection and
  monitoring set out in [RFC4657] and [RFC5440].

6.4.  Verifying Correct Operation

  This document makes no change to the basic operation of PCEP, so
  there are no changes to the requirements or techniques for monitoring
  the correct operation of the protocol out in [RFC4657] and [RFC5440].

  Note that "correct operation" in this context refers to the operation
  of the protocol itself and not to the operation of the computation
  algorithms which are out of scope for all PCEP work.

  Mechanisms for verifying the correct operation of computation
  algorithms might involve comparing the results returned by more than
  one PCE.  Scope for this might be limited by the use of vendor
  information unless multiple PCEs support the same set of vendor
  information.




Zhang & Farrel               Standards Track                   [Page 10]

RFC 7470           Vendor-Specific Constraints in PCE         March 2015


6.5.  Requirements on Other Protocols and Functional Components

  This document does not place any new requirements on other network
  components or protocols.  However, it may be beneficial to consider
  whether a PCE should advertise the Enterprise Numbers and vendor
  information it supports.  This advertisement could be within PCE
  Discovery [RFC5088] [RFC5089] or through extensions to PCEP
  [RFC5440].

  Extensions for discovery and advertisement are outside the scope of
  this document.

6.6.  Impact on Network Operation

  The availability of vendor information in PCEP messages may
  facilitate more complex and detailed path computations that may
  enhance the way in which the network is operated.

  On the other hand, the presence of additional vendor-specific
  information in PCEP messages may congest the operation of the
  protocol especially if the PCE does not support the information
  supplied by the PCC.  Thus, a PCC SHOULD monitor the capabilities of
  a PCE either by discovery mechanisms as described in Section 6.5 or
  through the receipt of negative responses.  A PCC SHOULD NOT include
  vendor information in a PCReq message to a PCE that it believes does
  not support the information and that will not forward the request to
  some other PCE that does support the information.

7.  Security Considerations

  The protocol extensions defined in this document do not substantially
  change the nature of PCEP.  Therefore, the security considerations
  set out in [RFC5440] apply unchanged.  Note that further security
  considerations for the use of PCEP over TCP are presented in
  [RFC6952].

  Operators should note that an attack on PCEP may involve making PCEP
  messages as large as possible in order to consume bandwidth and
  processing power.  The Vendor Information object and TLV may provide
  a vector for this type of attack.  It may be protected against by
  using the authentication and integrity procedures described in
  [RFC5440].









Zhang & Farrel               Standards Track                   [Page 11]

RFC 7470           Vendor-Specific Constraints in PCE         March 2015


8.  References

8.1.  Normative References

  [RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
             Requirement Levels", BCP 14, RFC 2119, March 1997,
             <http://www.rfc-editor.org/info/rfc2119>.

  [RFC5440]  Vasseur, JP., Ed., and JL. Le Roux, Ed., "Path Computation
             Element (PCE) Communication Protocol (PCEP)", RFC 5440,
             March 2009, <http://www.rfc-editor.org/info/rfc5440>.

  [RFC5511]  Farrel, A., "Routing Backus-Naur Form (RBNF): A Syntax
             Used to Form Encoding Rules in Various Routing Protocol
             Specifications", RFC 5511, April 2009,
             <http://www.rfc-editor.org/info/rfc5511>.

  [RFC6006]  Zhao, Q., Ed., King, D., Ed., Verhaeghe, F., Takeda, T.,
             Ali, Z., and J. Meuric, "Extensions to the Path
             Computation Element Communication Protocol (PCEP) for
             Point-to-Multipoint Traffic Engineering Label Switched
             Paths", RFC 6006, September 2010,
             <http://www.rfc-editor.org/info/rfc6006>.

8.2.  Informative References

  [RFC2578]  McCloghrie, K., Ed., Perkins, D., Ed., and J.
             Schoenwaelder, Ed., "Structure of Management Information
             Version 2 (SMIv2)", STD 58, RFC 2578, April 1999,
             <http://www.rfc-editor.org/info/rfc2578>.

  [RFC4655]  Farrel, A., Vasseur, J.-P., and J. Ash, "A Path
             Computation Element (PCE)-Based Architecture", RFC 4655,
             August 2006, <http://www.rfc-editor.org/info/rfc4655>.

  [RFC4657]  Ash, J., Ed., and J. Le Roux, Ed., "Path Computation
             Element (PCE) Communication Protocol Generic
             Requirements", RFC 4657, September 2006,
             <http://www.rfc-editor.org/info/rfc4657>.

  [RFC5088]  Le Roux, JL., Ed., Vasseur, JP., Ed., Ikejiri, Y., and R.
             Zhang, "OSPF Protocol Extensions for Path Computation
             Element (PCE) Discovery", RFC 5088, January 2008,
             <http://www.rfc-editor.org/info/rfc5088>.







Zhang & Farrel               Standards Track                   [Page 12]

RFC 7470           Vendor-Specific Constraints in PCE         March 2015


  [RFC5089]  Le Roux, JL., Ed., Vasseur, JP., Ed., Ikejiri, Y., and R.
             Zhang, "IS-IS Protocol Extensions for Path Computation
             Element (PCE) Discovery", RFC 5089, January 2008,
             <http://www.rfc-editor.org/info/rfc5089>.

  [RFC5226]  Narten, T. and H. Alvestrand, "Guidelines for Writing an
             IANA Considerations Section in RFCs", BCP 26, RFC 5226,
             May 2008, <http://www.rfc-editor.org/info/rfc5226>.

  [RFC5541]  Le Roux, JL., Vasseur, JP., and Y. Lee, "Encoding of
             Objective Functions in the Path Computation Element
             Communication Protocol (PCEP)", RFC 5541, June 2009,
             <http://www.rfc-editor.org/info/rfc5541>.

  [RFC5706]  Harrington, D., "Guidelines for Considering Operations and
             Management of New Protocols and Protocol Extensions", RFC
             5706, November 2009,
             <http://www.rfc-editor.org/info/rfc5706>.

  [RFC6123]  Farrel, A., "Inclusion of Manageability Sections in Path
             Computation Element (PCE) Working Group Drafts", RFC 6123,
             February 2011, <http://www.rfc-editor.org/info/rfc6123>.

  [RFC6952]  Jethanandani, M., Patel, K., and L. Zheng, "Analysis of
             BGP, LDP, PCEP, and MSDP Issues According to the Keying
             and Authentication for Routing Protocols (KARP) Design
             Guide", RFC 6952, May 2013,
             <http://www.rfc-editor.org/info/rfc6952>.

  [RFC7150]  Zhang, F. and A. Farrel, "Conveying Vendor-Specific
             Constraints in the Path Computation Element Communication
             Protocol", RFC 7150, March 2014,
             <http://www.rfc-editor.org/info/rfc7150>.

  [RFC7420]  Koushik, A., Stephan, E., Zhao, Q., King, D., and J.
             Hardwick, "Path Computation Element Communication Protocol
             (PCEP) Management Information Base (MIB) Module", RFC
             7420, December 2014,
             <http://www.rfc-editor.org/info/rfc7420>.












Zhang & Farrel               Standards Track                   [Page 13]

RFC 7470           Vendor-Specific Constraints in PCE         March 2015


Acknowledgements

  Thanks to Meral Shirazipour, Ramon Casellas, Cyril Margaria, Dhruv
  Dhody, Julien Meuric, and Robert Sparks for review and comments on
  the work that became RFC 7150.

  Thanks to Robert Varga for raising the issue of the clashing code
  point and to Dhruv Dhody for helping clarify the use of the TLV.

Contributors

  Greg Bernstein
  Grotto Networking
  EMail: [email protected]

  Ina Minei
  Juniper Networks
  EMail: [email protected]

Authors' Addresses

  Adrian Farrel
  Juniper Networks
  EMail: [email protected]

  Fatai Zhang
  Huawei Technologies
  EMail: [email protected]























Zhang & Farrel               Standards Track                   [Page 14]