TEAS Working Group V. Beeram Internet-Draft T. Saad Intended status: Standards Track Juniper Networks Expires: January 14, 2021 R. Gandhi Cisco Systems, Inc. X. Liu Volta Networks I. Bryskin Individual July 13, 2020 A YANG Data Model for Resource Reservation Protocol (RSVP) draft-ietf-teas-yang-rsvp-13 Abstract This document defines a YANG data model for the configuration and management of RSVP Protocol. The model covers the building blocks of the RSVP protocol that can be augmented and used by other RSVP extension models such as RSVP extensions to Traffic-Engineering (RSVP-TE). The model covers the configuration, operational state, remote procedure calls, and event notifications data. Status of This Memo This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet- Drafts is at https://datatracker.ietf.org/drafts/current/. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." This Internet-Draft will expire on January 14, 2021. Copyright Notice Copyright (c) 2020 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 Beeram, et al. Expires January 14, 2021 [Page 1]
Internet-Draft RSVP YANG Data Model July 2020 (https://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 . . . . . . . . . . . . . . . . . . . . . . . . 2 1.1. Terminology . . . . . . . . . . . . . . . . . . . . . . . 3 1.2. Model Tree Diagram . . . . . . . . . . . . . . . . . . . 3 1.3. Prefixes in Data Node Names . . . . . . . . . . . . . . . 3 2. Model Overview . . . . . . . . . . . . . . . . . . . . . . . 3 2.1. Module(s) Relationship . . . . . . . . . . . . . . . . . 4 2.2. Design Considerations . . . . . . . . . . . . . . . . . . 4 2.3. Model Notifications . . . . . . . . . . . . . . . . . . . 5 2.4. RSVP Base YANG Model . . . . . . . . . . . . . . . . . . 5 2.4.1. Tree Diagram . . . . . . . . . . . . . . . . . . . . 7 2.4.2. YANG Module . . . . . . . . . . . . . . . . . . . . . 12 2.5. RSVP Extended YANG Model . . . . . . . . . . . . . . . . 33 2.5.1. Tree Diagram . . . . . . . . . . . . . . . . . . . . 33 2.5.2. YANG Module . . . . . . . . . . . . . . . . . . . . . 35 3. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 45 4. Security Considerations . . . . . . . . . . . . . . . . . . . 46 5. Acknowledgement . . . . . . . . . . . . . . . . . . . . . . . 47 6. Contributors . . . . . . . . . . . . . . . . . . . . . . . . 47 7. References . . . . . . . . . . . . . . . . . . . . . . . . . 47 7.1. Normative References . . . . . . . . . . . . . . . . . . 47 7.2. Informative References . . . . . . . . . . . . . . . . . 50 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 50 1. Introduction YANG [RFC6020] is a data definition language that was introduced to define the contents of a conceptual data store that allows networked devices to be managed using NETCONF [RFC6241]. YANG is proving relevant beyond its initial confines, as bindings to other interfaces (e.g. ReST) and encoding other than XML (e.g. JSON) are being defined. Furthermore, YANG data models can be used as the basis of implementation for other interfaces, such as CLI and programmatic APIs. This document defines a YANG data model that can be used to configure and manage the RSVP protocol [RFC2205]. This model covers RSVP protocol building blocks that can be augmented and used by other RSVP Beeram, et al. Expires January 14, 2021 [Page 2]
Internet-Draft RSVP YANG Data Model July 2020 extension models- such as for signaling RSVP-TE MPLS (or other technology specific) Label Switched Paths (LSP)s. 1.1. Terminology 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 BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here. The terminology for describing YANG data models is found in [RFC7950]. 1.2. Model Tree Diagram A full tree diagram of the module(s) defined in this document is given in subsequent sections as per the syntax defined in [RFC8340]. 1.3. Prefixes in Data Node Names In this document, names of data nodes and other data model objects are prefixed using the standard prefix associated with the corresponding YANG imported modules, as shown in Table 1. +-----------+--------------------+-----------+ | Prefix | YANG module | Reference | +-----------+--------------------+-----------+ | yang | ietf-yang-types | [RFC6991] | | inet | ietf-inet-types | [RFC6991] | | rt-type | ietf-routing-types | XX | | key-chain | ietf-key-chain | XX | +---------+----------------------+-----------+ Table 1: Prefixes and corresponding YANG modules 2. Model Overview The RSVP base YANG module augments the "control-plane-protocol" list in ietf-routing [RFC8349] module with specific RSVP parameters in an "rsvp" container. It also defines an extension identity "rsvp" of base "rt:routing-protocol" to identify the RSVP protocol. The augmentation of the RSVP model by other models (e.g. RSVP-TE for MPLS or other technologies) are outside the scope of this document and are discussed in separate document(s), e.g. [I-D.ietf-teas-yang-rsvp-te]. Beeram, et al. Expires January 14, 2021 [Page 3]
Internet-Draft RSVP YANG Data Model July 2020 2.1. Module(s) Relationship This document divides the RSVP model into two modules: base and extended RSVP modules. Some RSVP features are categorized as core to the function of the protocol and are supported by most vendors claiming the support for RSVP protocol. Such features configuration and state are grouped in the RSVP base module. Other extended RSVP features are categorized as either optional or providing ability to better tune the basic functionality of the RSVP protocol. The support for extended RSVP features by all vendors is considered optional. Such features are grouped in a separate RSVP extended module. The relationship between the base and extended RSVP YANG model and the IETF routing YANG model is shown in Figure 1. +--------------+ Routing | ietf-routing | +--------------+ o | +-----------+ RSVP module | ietf-rsvp | +-----------+ o | o: augment relationship RSVP extended | module +--------------------+ | ietf-rsvp-extended | +--------------------+ Figure 1: Relationship of RSVP and RSVP extended modules with other protocol modules 2.2. Design Considerations The RSVP base model does not aim to be feature complete. The primary intent is to cover a set of standard core features that are commonly in use. For example: o Authentication ([RFC2747]) o Refresh Reduction ([RFC2961]) o Hellos ([RFC3209]) o Graceful Restart ([RFC3473], [RFC5063]) Beeram, et al. Expires January 14, 2021 [Page 4]
Internet-Draft RSVP YANG Data Model July 2020 The extended RSVP YANG model covers the configuration for optional features that are not must for basic RSVP protocol operation. The defined data model supports configuration inheritance for neighbors, and interfaces. Data elements defined in the main container (e.g. the container that encompasses the list of interfaces, or neighbors) are assumed to apply equally to all elements of the list, unless overridden explicitly for a certain element (e.g. interface). Vendors are expected to augment the above container(s) to provide the list of inheritance command for their implementations. 2.3. Model Notifications Notifications data modeling is key in any defined data model. [RFC8639] and [RFC8641] define a subscription and push mechanism for YANG datastores. This mechanism currently allows the user to: o Subscribe notifications on a per client basis o Specify subtree filters or xpath filters so that only interested contents will be sent. o Specify either periodic or on-demand notifications. 2.4. RSVP Base YANG Model The RSVP base YANG data model defines the container "rsvp" as the top level container in this data model. The presence of this container enables the RSVP protocol functionality. The derived state data is contained in "read-only" nodes directly under the intended object as shown in Figure 2. Beeram, et al. Expires January 14, 2021 [Page 5]
Internet-Draft RSVP YANG Data Model July 2020 module: ietf-rsvp +--rw rsvp! +--rw globals . . +--rw interfaces . +-- ro <<derived state associated with interfaces>> . . +--rw neighbors . +-- ro <<derived state associated with the tunnel>> . . +--rw sessions . +-- ro <<derived state associated with the tunnel>> . rpcs: +--x clear-session +--x clear-neighbor Figure 2: RSVP high-level tree model view Configuration and state data are grouped to those applicable on per node (global), per interface, per neighbor, or per session. Global Data: The global data cover the configuration and state that is applicable the RSVP protocol behavior. Interface Data: The interface data configuration and state model relevant attributes applicable to one or all RSVP interfaces. Any data or state at the "interfaces" container level is equally applicable to all interfaces - unless overridden by explicit configuration or state under a specific interface. Neighbor Data: The neighbor data cover configuration and state relevant to RSVP neighbors. Neighbors can be dynamically discovered using RSVP signaling or explicitly configured. Beeram, et al. Expires January 14, 2021 [Page 6]
Internet-Draft RSVP YANG Data Model July 2020 Session Data: The sessions data branch covers configuration and state relevant to RSVP sessions. This is usually derived state that is result of signaling. This model defines attributes related to IP RSVP sessions as defined in [RFC2205]. 2.4.1. Tree Diagram Figure 3 shows the YANG tree representation for configuration and state data that is augmenting the RSVP basic module: module: ietf-rsvp augment /rt:routing/rt:control-plane-protocols /rt:control-plane-protocol: +--rw rsvp! +--rw globals | +--rw sessions | | +--ro session-ip* | | [destination protocol-id destination-port] | | +--ro destination-port inet:port-number | | +--ro protocol-id uint8 | | +--ro source? inet:ip-address | | +--ro destination inet:ip-address | | +--ro session-name? string | | +--ro session-status? enumeration | | +--ro session-type? identityref | | +--ro psbs | | | +--ro psb* [] | | | +--ro source-port? inet:port-number | | | +--ro expires-in? uint32 | | +--ro rsbs | | +--ro rsb* [] | | +--ro source-port? inet:port-number | | +--ro reservation-style? identityref | | +--ro expires-in? uint32 | +--ro statistics | | +--ro messages | | | +--ro ack-sent? yang:counter64 | | | +--ro ack-received? yang:counter64 | | | +--ro bundle-sent? yang:counter64 | | | +--ro bundle-received? yang:counter64 | | | +--ro hello-sent? yang:counter64 | | | +--ro hello-received? yang:counter64 | | | +--ro integrity-challenge-sent? yang:counter64 | | | +--ro integrity-challenge-received? yang:counter64 | | | +--ro integrity-response-sent? yang:counter64 | | | +--ro integrity-response-received? yang:counter64 Beeram, et al. Expires January 14, 2021 [Page 7]
Internet-Draft RSVP YANG Data Model July 2020 | | | +--ro notify-sent? yang:counter64 | | | +--ro notify-received? yang:counter64 | | | +--ro path-sent? yang:counter64 | | | +--ro path-received? yang:counter64 | | | +--ro path-err-sent? yang:counter64 | | | +--ro path-err-received? yang:counter64 | | | +--ro path-tear-sent? yang:counter64 | | | +--ro path-tear-received? yang:counter64 | | | +--ro resv-sent? yang:counter64 | | | +--ro resv-received? yang:counter64 | | | +--ro resv-confirm-sent? yang:counter64 | | | +--ro resv-confirm-received? yang:counter64 | | | +--ro resv-err-sent? yang:counter64 | | | +--ro resv-err-received? yang:counter64 | | | +--ro resv-tear-sent? yang:counter64 | | | +--ro resv-tear-received? yang:counter64 | | | +--ro summary-refresh-sent? yang:counter64 | | | +--ro summary-refresh-received? yang:counter64 | | | +--ro unknown-messages-received? yang:counter64 | | +--ro packets | | | +--ro sent? yang:counter64 | | | +--ro received? yang:counter64 | | +--ro errors | | +--ro authenticate? yang:counter64 | | +--ro checksum? yang:counter64 | | +--ro packet-length? yang:counter64 | +--rw graceful-restart | +--rw enabled? boolean +--rw interfaces | +--rw refresh-reduction | | +--rw enabled? boolean | +--rw hellos | | +--rw enabled? boolean | +--rw authentication | | +--rw enabled? boolean | | +--rw authentication-key? string | | +--rw crypto-algorithm identityref | +--ro statistics | | +--ro messages | | | +--ro ack-sent? yang:counter64 | | | +--ro ack-received? yang:counter64 | | | +--ro bundle-sent? yang:counter64 | | | +--ro bundle-received? yang:counter64 | | | +--ro hello-sent? yang:counter64 | | | +--ro hello-received? yang:counter64 | | | +--ro integrity-challenge-sent? yang:counter64 | | | +--ro integrity-challenge-received? yang:counter64 | | | +--ro integrity-response-sent? yang:counter64 Beeram, et al. Expires January 14, 2021 [Page 8]
Internet-Draft RSVP YANG Data Model July 2020 | | | +--ro integrity-response-received? yang:counter64 | | | +--ro notify-sent? yang:counter64 | | | +--ro notify-received? yang:counter64 | | | +--ro path-sent? yang:counter64 | | | +--ro path-received? yang:counter64 | | | +--ro path-err-sent? yang:counter64 | | | +--ro path-err-received? yang:counter64 | | | +--ro path-tear-sent? yang:counter64 | | | +--ro path-tear-received? yang:counter64 | | | +--ro resv-sent? yang:counter64 | | | +--ro resv-received? yang:counter64 | | | +--ro resv-confirm-sent? yang:counter64 | | | +--ro resv-confirm-received? yang:counter64 | | | +--ro resv-err-sent? yang:counter64 | | | +--ro resv-err-received? yang:counter64 | | | +--ro resv-tear-sent? yang:counter64 | | | +--ro resv-tear-received? yang:counter64 | | | +--ro summary-refresh-sent? yang:counter64 | | | +--ro summary-refresh-received? yang:counter64 | | | +--ro unknown-messages-received? yang:counter64 | | +--ro packets | | | +--ro sent? yang:counter64 | | | +--ro received? yang:counter64 | | +--ro errors | | +--ro authenticate? yang:counter64 | | +--ro checksum? yang:counter64 | | +--ro packet-length? yang:counter64 | +--rw interface* [interface] | +--rw interface if:interface-ref | +--rw refresh-reduction | | +--rw enabled? boolean | +--rw hellos | | +--rw enabled? boolean | +--rw authentication | | +--rw enabled? boolean | | +--rw authentication-key? string | | +--rw crypto-algorithm identityref | +--ro statistics | +--ro messages | | +--ro ack-sent? | | | yang:counter64 | | +--ro ack-received? | | | yang:counter64 | | +--ro bundle-sent? | | | yang:counter64 | | +--ro bundle-received? | | | yang:counter64 | | +--ro hello-sent? Beeram, et al. Expires January 14, 2021 [Page 9]
Internet-Draft RSVP YANG Data Model July 2020 | | | yang:counter64 | | +--ro hello-received? | | | yang:counter64 | | +--ro integrity-challenge-sent? | | | yang:counter64 | | +--ro integrity-challenge-received? | | | yang:counter64 | | +--ro integrity-response-sent? | | | yang:counter64 | | +--ro integrity-response-received? | | | yang:counter64 | | +--ro notify-sent? | | | yang:counter64 | | +--ro notify-received? | | | yang:counter64 | | +--ro path-sent? | | | yang:counter64 | | +--ro path-received? | | | yang:counter64 | | +--ro path-err-sent? | | | yang:counter64 | | +--ro path-err-received? | | | yang:counter64 | | +--ro path-tear-sent? | | | yang:counter64 | | +--ro path-tear-received? | | | yang:counter64 | | +--ro resv-sent? | | | yang:counter64 | | +--ro resv-received? | | | yang:counter64 | | +--ro resv-confirm-sent? | | | yang:counter64 | | +--ro resv-confirm-received? | | | yang:counter64 | | +--ro resv-err-sent? | | | yang:counter64 | | +--ro resv-err-received? | | | yang:counter64 | | +--ro resv-tear-sent? | | | yang:counter64 | | +--ro resv-tear-received? | | | yang:counter64 | | +--ro summary-refresh-sent? | | | yang:counter64 | | +--ro summary-refresh-received? | | | yang:counter64 | | +--ro unknown-messages-received? Beeram, et al. Expires January 14, 2021 [Page 10]
Internet-Draft RSVP YANG Data Model July 2020 | | yang:counter64 | +--ro packets | | +--ro sent? yang:counter64 | | +--ro received? yang:counter64 | +--ro errors | +--ro authenticate? yang:counter64 | +--ro checksum? yang:counter64 | +--ro packet-length? yang:counter64 +--rw neighbors +--rw neighbor* [address] +--rw address inet:ip-address +--rw epoch? uint32 +--rw expiry-time? uint32 +--rw graceful-restart | +--rw enabled? boolean | +--rw local-restart-time? uint32 | +--rw local-recovery-time? uint32 | +--rw neighbor-restart-time? uint32 | +--rw neighbor-recovery-time? uint32 | +--rw helper-mode | +--rw enabled? boolean | +--rw max-helper-restart-time? uint32 | +--rw max-helper-recovery-time? uint32 | +--rw neighbor-restart-time-remaining? uint32 | +--rw neighbor-recovery-time-remaining? uint32 +--rw hello-status? enumeration +--rw interface? if:interface-ref +--rw neighbor-status? enumeration +--rw refresh-reduction-capable? boolean +--rw restart-count? yang:counter32 +--rw restart-time? yang:date-and-time rpcs: +---x clear-session | +---w input | +---w routing-protocol-instance-name leafref | +---w (filter-type) | +--:(match-all) | | +---w all empty | +--:(match-one) | +---w session-info | +---w (session-type) | +--:(rsvp-session-ip) | +---w destination leafref | +---w protocol-id uint8 | +---w destination-port inet:ip-address +---x clear-neighbor | +---w input Beeram, et al. Expires January 14, 2021 [Page 11]
Internet-Draft RSVP YANG Data Model July 2020 | +---w routing-protocol-instance-name leafref | +---w (filter-type) | +--:(match-all) | | +---w all empty | +--:(match-one) | +---w neighbor-address leafref +---x clear-authentication +---w input +---w routing-protocol-instance-name leafref +---w (filter-type) +--:(match-all) | +---w all empty +--:(match-one-interface) +---w interface? if:interface-ref Figure 3: RSVP model tree diagram 2.4.2. YANG Module The ietf-rsvp module imports from the following modules: o ietf-interfaces defined in [RFC8343] o ietf-yang-types and ietf-inet-types defined in [RFC6991] o ietf-routing defined in [RFC8349] o ietf-key-chain defined in [RFC8177] <CODE BEGINS> file "ietf-rsvp@2020-01-13.yang" module ietf-rsvp { yang-version 1.1; namespace "urn:ietf:params:xml:ns:yang:ietf-rsvp"; /* Replace with IANA when assigned */ prefix rsvp; import ietf-interfaces { prefix if; reference "RFC8343: A YANG Data Model for Interface Management"; } import ietf-inet-types { prefix inet; reference "RFC6991: Common YANG Data Types"; } Beeram, et al. Expires January 14, 2021 [Page 12]
Internet-Draft RSVP YANG Data Model July 2020 import ietf-yang-types { prefix yang; reference "RFC6991: Common YANG Data Types"; } import ietf-routing { prefix rt; reference "RFC8349: A YANG Data Model for Routing Management (NMDA Version)"; } import ietf-key-chain { prefix key-chain; reference "RFC8177: YANG Data Model for Key Chains"; } organization "IETF Traffic Engineering Architecture and Signaling (TEAS) Working Group"; contact "WG Web: <http://tools.ietf.org/wg/teas/> WG List: <mailto:teas@ietf.org> Editor: Vishnu Pavan Beeram <mailto:vbeeram@juniper.net> Editor: Tarek Saad <mailto:tsaad@juniper.net> Editor: Rakesh Gandhi <mailto:rgandhi@cisco.com> Editor: Xufeng Liu <mailto: xufeng.liu.ietf@gmail.com> Editor: Igor Bryskin <mailto:i_bryskin@yahoo.com>"; description "This module contains the RSVP YANG data model. The model fully conforms to the Network Management Datastore Architecture (NMDA). Copyright (c) 2019 IETF Trust and the persons identified as authors of the code. All rights reserved. Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and subject Beeram, et al. Expires January 14, 2021 [Page 13]
Internet-Draft RSVP YANG Data Model July 2020 to the license terms contained in, the Simplified BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info). This version of this YANG module is part of RFC XXXX; see the RFC itself for full legal notices."; // RFC Ed.: replace XXXX with actual RFC number and remove this // note. // RFC Ed.: update the date below with the date of RFC publication // and remove this note. revision 2020-01-13 { description "A YANG Data Model for Resource Reservation Protocol"; reference "RFCXXXX: A YANG Data Model for Resource Reservation Protocol (RSVP)"; } identity rsvp { base rt:routing-protocol; description "RSVP protocol"; } identity rsvp-session-type { description "Base RSVP session type"; } identity rsvp-session-ip { base rsvp-session-type; description "RSVP IP session type"; } identity reservation-style { description "Base identity for reservation style"; } identity reservation-wildcard-filter { base reservation-style; description "Wildcard-Filter (WF) Style"; reference "RFC2205"; Beeram, et al. Expires January 14, 2021 [Page 14]
Internet-Draft RSVP YANG Data Model July 2020 } identity reservation-fixed-filter { base reservation-style; description "Fixed-Filter (FF) Style"; reference "RFC2205"; } identity reservation-shared-explicit { base reservation-style; description "Shared Explicit (SE) Style"; reference "RFC2205"; } grouping graceful-restart-config { description "Base configuration parameters relating to RSVP Graceful-Restart"; leaf enabled { type boolean; description "'true' if RSVP Graceful Restart is enabled. 'false' if RSVP Graceful Restart is disabled."; } } grouping graceful-restart { description "RSVP graceful restart parameters grouping"; container graceful-restart { description "RSVP graceful restart parameters container"; uses graceful-restart-config; } } grouping refresh-reduction-config { description "Configuration parameters relating to RSVP refresh reduction"; leaf enabled { type boolean; description "'true' if RSVP Refresh Reduction is enabled. Beeram, et al. Expires January 14, 2021 [Page 15]
Internet-Draft RSVP YANG Data Model July 2020 'false' if RSVP Refresh Reduction is disabled."; } } grouping refresh-reduction { description "Top level grouping for RSVP refresh reduction parameters"; container refresh-reduction { description "Top level container for RSVP refresh reduction parameters"; uses refresh-reduction-config; } } grouping authentication-config { description "Configuration parameters relating to RSVP authentication"; leaf enabled { type boolean; description "'true' if RSVP Authentication is enabled. 'false' if RSVP Authentication is disabled."; } leaf authentication-key { type string; description "An authentication key string"; reference "RFC 2747: RSVP Cryptographic Authentication"; } leaf crypto-algorithm { type identityref { base key-chain:crypto-algorithm; } mandatory true; description "Cryptographic algorithm associated with key."; } } grouping authentication { description "Top level grouping for RSVP authentication parameters"; container authentication { description Beeram, et al. Expires January 14, 2021 [Page 16]
Internet-Draft RSVP YANG Data Model July 2020 "Top level container for RSVP authentication parameters"; uses authentication-config; } } grouping hellos-config { description "Configuration parameters relating to RSVP hellos"; leaf enabled { type boolean; description "'true' if RSVP Hello is enabled. 'false' if RSVP Hello is disabled."; } } grouping hellos { description "Top level grouping for RSVP hellos parameters"; container hellos { description "Top level container for RSVP hello parameters"; uses hellos-config; } } grouping signaling-parameters-config { description "Configuration parameters relating to RSVP signaling"; } grouping signaling-parameters { description "Top level grouping for RSVP signaling parameters"; uses signaling-parameters-config; } grouping session-attributes { description "Top level grouping for RSVP session properties"; leaf destination-port { type inet:port-number; description "RSVP destination port"; reference Beeram, et al. Expires January 14, 2021 [Page 17]
Internet-Draft RSVP YANG Data Model July 2020 "RFC2205"; } leaf protocol-id { type uint8; description "The IP protocol ID."; reference "RFC2205, section 3.2"; } leaf source { type inet:ip-address; description "RSVP source address"; reference "RFC2205"; } leaf destination { type inet:ip-address; description "RSVP destination address"; reference "RFC2205"; } leaf session-name { type string; description "The signaled name of this RSVP session."; } leaf session-status { type enumeration { enum up { description "RSVP session is up"; } enum down { description "RSVP session is down"; } } description "Enumeration of RSVP session states"; } leaf session-type { type identityref { base rsvp-session-type; } description "RSVP session type"; Beeram, et al. Expires January 14, 2021 [Page 18]
Internet-Draft RSVP YANG Data Model July 2020 } container psbs { description "Path State Block container"; list psb { description "List of path state blocks"; leaf source-port { type inet:port-number; description "RSVP source port"; reference "RFC2205"; } leaf expires-in { type uint32; units "seconds"; description "Time to reservation expiry (in seconds)"; } } } container rsbs { description "Reservation State Block container"; list rsb { description "List of reservation state blocks"; leaf source-port { type inet:port-number; description "RSVP source port"; reference "RFC2205"; } leaf reservation-style { type identityref { base reservation-style; } description "RSVP reservation style"; } leaf expires-in { type uint32; units "seconds"; description "Time to reservation expiry (in seconds)"; } Beeram, et al. Expires January 14, 2021 [Page 19]
Internet-Draft RSVP YANG Data Model July 2020 } } } grouping neighbor-attributes { description "Top level grouping for RSVP neighbor properties"; leaf address { type inet:ip-address; description "Address of RSVP neighbor"; } leaf epoch { type uint32; description "Neighbor epoch."; } leaf expiry-time { type uint32; units "seconds"; description "Neighbor expiry time after which the neighbor state is purged if no states associated with it"; } container graceful-restart { description "Graceful restart information."; leaf enabled { type boolean; description "'true' if graceful restart is enabled for the neighbor."; } leaf local-restart-time { type uint32; units "seconds"; description "Local node restart time"; } leaf local-recovery-time { type uint32; units "seconds"; description "Local node recover time"; } leaf neighbor-restart-time { type uint32; units "seconds"; description Beeram, et al. Expires January 14, 2021 [Page 20]
Internet-Draft RSVP YANG Data Model July 2020 "Neighbor restart time"; } leaf neighbor-recovery-time { type uint32; units "seconds"; description "Neighbor recover time"; } container helper-mode { description "Helper mode information "; leaf enabled { type boolean; description "'true' if helper mode is enabled."; } leaf max-helper-restart-time { type uint32; units "seconds"; description "The time the router or switch waits after it discovers that a neighboring router has gone down before it declares the neighbor down"; } leaf max-helper-recovery-time { type uint32; units "seconds"; description "The amount of time the router retains the state of its RSVP neighbors while they undergo a graceful restart"; } leaf neighbor-restart-time-remaining { type uint32; units "seconds"; description "Number of seconds remaining for neighbor to send Hello message after restart."; } leaf neighbor-recovery-time-remaining { type uint32; units "seconds"; description "Number of seconds remaining for neighbor to refresh."; } } // helper-mode } Beeram, et al. Expires January 14, 2021 [Page 21]
Internet-Draft RSVP YANG Data Model July 2020 // graceful-restart leaf hello-status { type enumeration { enum enabled { description "Enabled"; } enum disabled { description "Disabled"; } enum restarting { description "Restarting"; } } description "Hello status"; } leaf interface { type if:interface-ref; description "Interface where RSVP neighbor was detected"; } leaf neighbor-status { type enumeration { enum up { description "up"; } enum down { description "down"; } enum hello-disable { description "hello-disable"; } enum restarting { description "restarting"; } } description "Neighbor state"; } leaf refresh-reduction-capable { type boolean; Beeram, et al. Expires January 14, 2021 [Page 22]
Internet-Draft RSVP YANG Data Model July 2020 description "enables all RSVP refresh reduction message bundling, RSVP message ID, reliable message delivery and summary refresh"; reference "RFC 2961 RSVP Refresh Overhead Reduction Extensions"; } leaf restart-count { type yang:counter32; description "Number of times this neighbor restart"; } leaf restart-time { type yang:date-and-time; description "Last restart time of the neighbor"; } } grouping packet-statistics { description "Packet statistics grouping"; container packets { description "Packet statistics container"; leaf sent { type yang:counter64; description "Packet sent count"; } leaf received { type yang:counter64; description "Packet received count"; } } } grouping message-statistics { description "RSVP protocol statistics grouping"; container messages { description "RSVP protocol statistics container"; leaf ack-sent { type yang:counter64; description Beeram, et al. Expires January 14, 2021 [Page 23]
Internet-Draft RSVP YANG Data Model July 2020 "Hello sent count"; } leaf ack-received { type yang:counter64; description "Hello received count"; } leaf bundle-sent { type yang:counter64; description "Bundle sent count"; } leaf bundle-received { type yang:counter64; description "Bundle received count"; } leaf hello-sent { type yang:counter64; description "Hello sent count"; } leaf hello-received { type yang:counter64; description "Hello received count"; } leaf integrity-challenge-sent { type yang:counter64; description "Integrity Challenge sent count"; } leaf integrity-challenge-received { type yang:counter64; description "Integrity Challenge received count"; } leaf integrity-response-sent { type yang:counter64; description "Integrity Response sent count"; } leaf integrity-response-received { type yang:counter64; description "Integrity Response received count"; } leaf notify-sent { Beeram, et al. Expires January 14, 2021 [Page 24]
Internet-Draft RSVP YANG Data Model July 2020 type yang:counter64; description "Notify sent count"; } leaf notify-received { type yang:counter64; description "Notify received count"; } leaf path-sent { type yang:counter64; description "Path sent count"; } leaf path-received { type yang:counter64; description "Path received count"; } leaf path-err-sent { type yang:counter64; description "Path error sent count"; } leaf path-err-received { type yang:counter64; description "Path error received count"; } leaf path-tear-sent { type yang:counter64; description "Path tear sent count"; } leaf path-tear-received { type yang:counter64; description "Path tear received count"; } leaf resv-sent { type yang:counter64; description "Resv sent count"; } leaf resv-received { type yang:counter64; description "Resv received count"; Beeram, et al. Expires January 14, 2021 [Page 25]
Internet-Draft RSVP YANG Data Model July 2020 } leaf resv-confirm-sent { type yang:counter64; description "Confirm sent count"; } leaf resv-confirm-received { type yang:counter64; description "Confirm received count"; } leaf resv-err-sent { type yang:counter64; description "Resv error sent count"; } leaf resv-err-received { type yang:counter64; description "Resv error received count"; } leaf resv-tear-sent { type yang:counter64; description "Resv tear sent count"; } leaf resv-tear-received { type yang:counter64; description "Resv tear received count"; } leaf summary-refresh-sent { type yang:counter64; description "Summary refresh sent count"; } leaf summary-refresh-received { type yang:counter64; description "Summary refresh received count"; } leaf unknown-messages-received { type yang:counter64; description "Unknown packet received count"; } } } Beeram, et al. Expires January 14, 2021 [Page 26]
Internet-Draft RSVP YANG Data Model July 2020 grouping errors-statistics { description "Error statistics grouping"; container errors { description "Error statistics container"; leaf authenticate { type yang:counter64; description "The total number of packets received with an authentication failure."; } leaf checksum { type yang:counter64; description "The total number of packets received with an invalid checksum value."; } leaf packet-length { type yang:counter64; description "The total number of packets received with an invalid packet length."; } } } grouping statistics { description "RSVP statistic attributes."; container statistics { config false; description "RSVP statistics container"; uses message-statistics; uses packet-statistics; uses errors-statistics; } } grouping global-attributes { description "Top level grouping for RSVP global properties"; container sessions { description "RSVP sessions container"; list session-ip { key "destination protocol-id destination-port"; Beeram, et al. Expires January 14, 2021 [Page 27]
Internet-Draft RSVP YANG Data Model July 2020 config false; description "List of RSVP sessions"; uses session-attributes; } } uses statistics; } grouping intf-attributes { description "Top level grouping for RSVP interface properties"; uses signaling-parameters; uses refresh-reduction; uses hellos; uses authentication; uses statistics; } augment "/rt:routing/rt:control-plane-protocols/" + "rt:control-plane-protocol" { when "rt:type = 'rsvp:rsvp'" { description "This augment is only valid when routing protocol instance type is RSVP."; } description "RSVP protocol augmentation"; container rsvp { presence "Enable RSVP feature"; description "RSVP feature container"; container globals { description "RSVP global properties."; uses global-attributes; uses graceful-restart; } container interfaces { description "RSVP interfaces container"; uses intf-attributes; list interface { key "interface"; description "RSVP interfaces."; leaf interface { type if:interface-ref; Beeram, et al. Expires January 14, 2021 [Page 28]
Internet-Draft RSVP YANG Data Model July 2020 description "RSVP interface."; } uses intf-attributes; } } container neighbors { description "RSVP neighbors container"; list neighbor { key "address"; description "List of RSVP neighbors"; uses neighbor-attributes; } } } } grouping session-ref { description "Session reference information"; leaf destination { type leafref { path "/rt:routing/rt:control-plane-protocols" + "/rt:control-plane-protocol/rsvp:rsvp/rsvp:globals" + "/rsvp:sessions/rsvp:session-ip/destination"; } mandatory true; description "RSVP session"; } leaf protocol-id { type uint8; mandatory true; description "The RSVP session protocol ID"; } leaf destination-port { type inet:ip-address; mandatory true; description "The RSVP session destination port"; } } rpc clear-session { description Beeram, et al. Expires January 14, 2021 [Page 29]
Internet-Draft RSVP YANG Data Model July 2020 "Clears RSVP sessions RPC"; input { leaf routing-protocol-instance-name { type leafref { path "/rt:routing/rt:control-plane-protocols/" + "rt:control-plane-protocol/rt:name"; } mandatory true; description "Name of the RSVP protocol instance whose session is being cleared. If the corresponding RSVP instance doesn't exist, then the operation will fail with an error-tag of 'data-missing' and an error-app-tag of 'routing-protocol-instance-not-found'."; } choice filter-type { mandatory true; description "Filter choice"; case match-all { leaf all { type empty; mandatory true; description "Match all RSVP sessions"; } } case match-one { container session-info { description "Specifies the specific session to invoke operation on"; choice session-type { mandatory true; description "RSVP session type"; case rsvp-session-ip { uses session-ref; } } } } } } } rpc clear-neighbor { Beeram, et al. Expires January 14, 2021 [Page 30]
Internet-Draft RSVP YANG Data Model July 2020 description "RPC to clear the RSVP Hello session to a neighbor"; input { leaf routing-protocol-instance-name { type leafref { path "/rt:routing/rt:control-plane-protocols/" + "rt:control-plane-protocol/rt:name"; } mandatory true; description "Name of the RSVP protocol instance whose session is being cleared. If the corresponding RSVP instance doesn't exist, then the operation will fail with an error-tag of 'data-missing' and an error-app-tag of 'routing-protocol-instance-not-found'."; } choice filter-type { mandatory true; description "Filter choice"; case match-all { leaf all { type empty; mandatory true; description "Match all RSVP neighbor sessions"; } } case match-one { leaf neighbor-address { type leafref { path "/rt:routing/rt:control-plane-protocols" + "/rt:control-plane-protocol/rsvp:rsvp" + "/rsvp:neighbors/rsvp:neighbor/address"; } mandatory true; description "Match specific RSVP neighbor session"; } } } } } rpc clear-authentication { description Beeram, et al. Expires January 14, 2021 [Page 31]
Internet-Draft RSVP YANG Data Model July 2020 "Clears RSVP Security Association (SA) before the lifetime expires."; input { leaf routing-protocol-instance-name { type leafref { path "/rt:routing/rt:control-plane-protocols/" + "rt:control-plane-protocol/rt:name"; } mandatory true; description "Name of the RSVP protocol instance whose session is being cleared. If the corresponding RSVP instance doesn't exist, then the operation will fail with an error-tag of 'data-missing' and an error-app-tag of 'routing-protocol-instance-not-found'."; } choice filter-type { mandatory true; description "Filter choice"; case match-all { leaf all { type empty; mandatory true; description "Match all RSVP security associations"; } } case match-one-interface { leaf interface { type if:interface-ref; description "Interface where RSVP security association(s) to be detected"; } } } } } } <CODE ENDS> Beeram, et al. Expires January 14, 2021 [Page 32]
Internet-Draft RSVP YANG Data Model July 2020 2.5. RSVP Extended YANG Model The RSVP extended YANG model covers non-core RSVP feature(s). It also covers feature(s) that are not necessarily supported by all vendors, and hence, can be guarded with "if-feature" checks. 2.5.1. Tree Diagram Figure 4 shows the YANG tree representation for configuration and state data that is augmenting the RSVP extended module: module: ietf-rsvp-extended augment /rt:routing/rt:control-plane-protocols /rt:control-plane-protocol/rsvp:rsvp/rsvp:globals /rsvp:graceful-restart: +--rw restart-time? uint32 +--rw recovery-time? uint32 augment /rt:routing/rt:control-plane-protocols /rt:control-plane-protocol/rsvp:rsvp/rsvp:globals /rsvp:statistics/rsvp:packets: +--ro discontinuity-time? yang:date-and-time +--ro out-dropped? yang:counter64 +--ro in-dropped? yang:counter64 +--ro out-errors? yang:counter64 +--ro in-errors? yang:counter64 augment /rt:routing/rt:control-plane-protocols /rt:control-plane-protocol/rsvp:rsvp/rsvp:globals /rsvp:statistics/rsvp:messages: augment /rt:routing/rt:control-plane-protocols /rt:control-plane-protocol/rsvp:rsvp/rsvp:globals /rsvp:statistics/rsvp:errors: augment /rt:routing/rt:control-plane-protocols /rt:control-plane-protocol/rsvp:rsvp/rsvp:interfaces: +--rw refresh-interval? uint32 +--rw refresh-misses? uint32 +--rw checksum? boolean +--rw patherr-state-removal? empty augment /rt:routing/rt:control-plane-protocols /rt:control-plane-protocol/rsvp:rsvp/rsvp:interfaces /rsvp:refresh-reduction: +--rw bundle-message-max-size? uint32 +--rw reliable-ack-hold-time? uint32 +--rw reliable-ack-max-size? uint32 +--rw reliable-retransmit-time? uint32 +--rw reliable-srefresh? empty +--rw summary-max-size? uint32 augment /rt:routing/rt:control-plane-protocols /rt:control-plane-protocol/rsvp:rsvp/rsvp:interfaces Beeram, et al. Expires January 14, 2021 [Page 33]
Internet-Draft RSVP YANG Data Model July 2020 /rsvp:hellos: +--rw interface-based? empty +--rw hello-interval? uint32 +--rw hello-misses? uint32 augment /rt:routing/rt:control-plane-protocols /rt:control-plane-protocol/rsvp:rsvp/rsvp:interfaces /rsvp:authentication: +--rw lifetime? uint32 +--rw window-size? uint32 +--rw challenge? empty +--rw retransmits? uint32 +--rw key-chain? key-chain:key-chain-ref augment /rt:routing/rt:control-plane-protocols /rt:control-plane-protocol/rsvp:rsvp/rsvp:interfaces /rsvp:interface: +--rw refresh-interval? uint32 +--rw refresh-misses? uint32 +--rw checksum? boolean +--rw patherr-state-removal? empty augment /rt:routing/rt:control-plane-protocols /rt:control-plane-protocol/rsvp:rsvp/rsvp:interfaces /rsvp:interface/rsvp:refresh-reduction: +--rw bundle-message-max-size? uint32 +--rw reliable-ack-hold-time? uint32 +--rw reliable-ack-max-size? uint32 +--rw reliable-retransmit-time? uint32 +--rw reliable-srefresh? empty +--rw summary-max-size? uint32 augment /rt:routing/rt:control-plane-protocols /rt:control-plane-protocol/rsvp:rsvp/rsvp:interfaces /rsvp:interface/rsvp:hellos: +--rw interface-based? empty +--rw hello-interval? uint32 +--rw hello-misses? uint32 augment /rt:routing/rt:control-plane-protocols /rt:control-plane-protocol/rsvp:rsvp/rsvp:interfaces /rsvp:interface/rsvp:authentication: +--rw lifetime? uint32 +--rw window-size? uint32 +--rw challenge? empty +--rw retransmits? uint32 +--rw key-chain? key-chain:key-chain-ref Figure 4: RSVP extended model tree diagram Beeram, et al. Expires January 14, 2021 [Page 34]
Internet-Draft RSVP YANG Data Model July 2020 2.5.2. YANG Module The ietf-rsvp-extended module imports from the following modules: o ietf-rsvp defined in this document o ietf-routing defined in [RFC8349] o ietf-yang-types and ietf-inet-types defined in [RFC6991] o ietf-key-chain defined in [RFC8177] Figure 5 shows the RSVP extended YANG module: <CODE BEGINS> file "ietf-rsvp-extended@2019-07-04.yang" module ietf-rsvp-extended { yang-version 1.1; namespace "urn:ietf:params:xml:ns:yang:ietf-rsvp-extended"; prefix rsvp-ext; import ietf-rsvp { prefix rsvp; reference "RFCXXXX: A YANG Data Model for Resource Reservation Protocol (RSVP)"; } import ietf-routing { prefix rt; reference "RFC8349: A YANG Data Model for Routing Management (NMDA Version)"; } import ietf-yang-types { prefix yang; reference "RFC6991: Common YANG Data Types"; } import ietf-key-chain { prefix key-chain; reference "RFC8177: YANG Data Model for Key Chains"; } organization "IETF Traffic Engineering Architecture and Signaling (TEAS) Working Group"; contact "WG Web: <http://tools.ietf.org/wg/teas/> Beeram, et al. Expires January 14, 2021 [Page 35]
Internet-Draft RSVP YANG Data Model July 2020 WG List: <mailto:teas@ietf.org> Editor: Vishnu Pavan Beeram <mailto:vbeeram@juniper.net> Editor: Tarek Saad <mailto:tsaad@juniper.net> Editor: Rakesh Gandhi <mailto:rgandhi@cisco.com> Editor: Xufeng Liu <mailto: xufeng.liu.ietf@gmail.com> Editor: Igor Bryskin <mailto:i_bryskin@yahoo.com>"; description "This module contains the Extended RSVP YANG data model. The model fully conforms to the Network Management Datastore Architecture (NMDA). Copyright (c) 2019 IETF Trust and the persons identified as authors of the code. All rights reserved. Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and subject to the license terms contained in, the Simplified BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info). This version of this YANG module is part of RFC XXXX; see the RFC itself for full legal notices."; // RFC Ed.: replace XXXX with actual RFC number and remove this // note. // RFC Ed.: update the date below with the date of RFC publication // and remove this note. revision 2019-07-04 { description "A YANG Data Model for Extended Resource Reservation Protocol"; reference "RFCXXXX: A YANG Data Model for Resource Reservation Protocol (RSVP)"; } /* RSVP features */ Beeram, et al. Expires January 14, 2021 [Page 36]
Internet-Draft RSVP YANG Data Model July 2020 feature authentication { description "Indicates support for RSVP authentication"; } feature error-statistics { description "Indicates support for error statistics"; } feature global-statistics { description "Indicates support for global statistics"; } feature graceful-restart { description "Indicates support for RSVP graceful restart"; } feature hellos { description "Indicates support for RSVP hellos (RFC3209)."; } feature notify { description "Indicates support for RSVP notify message (RFC3473)."; } feature refresh-reduction { description "Indicates support for RSVP refresh reduction (RFC2961)."; } feature refresh-reduction-extended { description "Indicates support for RSVP refresh reduction (RFC2961)."; } feature per-interface-statistics { description "Indicates support for per interface statistics"; } grouping graceful-restart-extended-config { description "Configuration parameters relating to RSVP Beeram, et al. Expires January 14, 2021 [Page 37]
Internet-Draft RSVP YANG Data Model July 2020 Graceful-Restart"; leaf restart-time { type uint32; units "seconds"; description "Graceful restart time (seconds)."; reference "RFC 5495: Description of the Resource Reservation Protocol - Traffic-Engineered (RSVP-TE) Graceful Restart Procedures"; } leaf recovery-time { type uint32; units "seconds"; description "RSVP state recovery time"; } } grouping authentication-extended-config { description "Configuration parameters relating to RSVP authentication"; leaf lifetime { type uint32 { range "30..86400"; } units "seconds"; description "Life time for each security association"; reference "RFC 2747: RSVP Cryptographic Authentication"; } leaf window-size { type uint32 { range "1..64"; } description "Window-size to limit number of out-of-order messages."; reference "RFC 2747: RSVP Cryptographic Authentication"; } leaf challenge { type empty; description Beeram, et al. Expires January 14, 2021 [Page 38]
Internet-Draft RSVP YANG Data Model July 2020 "Enable challenge messages."; reference "RFC 2747: RSVP Cryptographic Authentication"; } leaf retransmits { type uint32 { range "1..10000"; } description "Number of retransmits when messages are dropped."; reference "RFC 2747: RSVP Cryptographic Authentication"; } leaf key-chain { type key-chain:key-chain-ref; description "Key chain name to authenticate RSVP signaling messages."; reference "RFC 2747: RSVP Cryptographic Authentication"; } } grouping hellos-extended-config { description "Configuration parameters relating to RSVP hellos"; leaf interface-based { type empty; description "Enable interface-based Hello adjacency if present."; } leaf hello-interval { type uint32; units "milliseconds"; description "Configure interval between successive Hello messages in milliseconds."; reference "RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels. RFC 5495: Description of the Resource Reservation Protocol - Traffic-Engineered (RSVP-TE) Graceful Restart Procedures"; } leaf hello-misses { Beeram, et al. Expires January 14, 2021 [Page 39]
Internet-Draft RSVP YANG Data Model July 2020 type uint32 { range "1..10"; } description "Configure max number of consecutive missed Hello messages."; reference "RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels RFC 5495: Description of the Resource Reservation Protocol - Traffic- Engineered (RSVP-TE) Graceful Restart Procedures"; } } grouping signaling-parameters-extended-config { description "Configuration parameters relating to RSVP signaling"; leaf refresh-interval { type uint32; description "Set interval between successive refreshes"; } leaf refresh-misses { type uint32; description "Set max number of consecutive missed messages for state expiry"; } leaf checksum { type boolean; description "Enable RSVP message checksum computation"; } leaf patherr-state-removal { type empty; description "State-Removal flag in Path Error message if present."; } } grouping refresh-reduction-extended-config { description "Configuration parameters relating to RSVP refresh reduction"; leaf bundle-message-max-size { Beeram, et al. Expires January 14, 2021 [Page 40]
Internet-Draft RSVP YANG Data Model July 2020 type uint32 { range "512..65000"; } description "Configure maximum size (bytes) of a single RSVP Bundle message."; } leaf reliable-ack-hold-time { type uint32; units "milliseconds"; description "Configure hold time in milliseconds for sending RSVP ACK message(s)."; } leaf reliable-ack-max-size { type uint32; description "Configure max size of a single RSVP ACK message."; } leaf reliable-retransmit-time { type uint32; units "milliseconds"; description "Configure min delay in milliseconds to wait for an ACK before a retransmit."; } leaf reliable-srefresh { type empty; description "Configure use of reliable messaging for summary refresh if present."; } leaf summary-max-size { type uint32 { range "20..65000"; } description "Configure max size (bytes) of a single RSVP summary refresh message."; } } grouping packets-extended-statistics { description "Packet statistics."; leaf discontinuity-time { type yang:date-and-time; Beeram, et al. Expires January 14, 2021 [Page 41]
Internet-Draft RSVP YANG Data Model July 2020 description "The time on the most recent occasion at which any one or more of the statistic counters suffered a discontinuity. If no such discontinuities have occurred since the last re-initialization of the local management subsystem, then this node contains the time the local management subsystem re-initialized itself."; } leaf out-dropped { type yang:counter64; description "Out packet drop count"; } leaf in-dropped { type yang:counter64; description "In packet drop count"; } leaf out-errors { type yang:counter64; description "Out packet errors count"; } leaf in-errors { type yang:counter64; description "In packet rx errors count"; } } grouping messages-extended-statistics { description "RSVP protocol statistics."; } grouping errors-extended-statistics { description "Error statistics."; } /** * RSVP extensions augmentations */ /* RSVP globals graceful restart*/ augment "/rt:routing/rt:control-plane-protocols/" + "rt:control-plane-protocol/rsvp:rsvp/rsvp:globals/" + "rsvp:graceful-restart" { Beeram, et al. Expires January 14, 2021 [Page 42]
Internet-Draft RSVP YANG Data Model July 2020 description "RSVP globals configuration extensions"; uses graceful-restart-extended-config; } /* RSVP statistics augmentation */ augment "/rt:routing/rt:control-plane-protocols/" + "rt:control-plane-protocol/rsvp:rsvp/rsvp:globals/" + "rsvp:statistics/rsvp:packets" { description "RSVP packet stats extensions"; uses packets-extended-statistics; } augment "/rt:routing/rt:control-plane-protocols/" + "rt:control-plane-protocol/rsvp:rsvp/rsvp:globals/" + "rsvp:statistics/rsvp:messages" { description "RSVP protocol message stats extensions"; uses messages-extended-statistics; } augment "/rt:routing/rt:control-plane-protocols/" + "rt:control-plane-protocol/rsvp:rsvp/rsvp:globals/" + "rsvp:statistics/rsvp:errors" { description "RSVP errors stats extensions"; uses errors-extended-statistics; } /** * RSVP all interfaces extensions */ /* RSVP interface signaling extensions */ augment "/rt:routing/rt:control-plane-protocols/" + "rt:control-plane-protocol/rsvp:rsvp/rsvp:interfaces" { description "RSVP signaling all interfaces configuration extensions"; uses signaling-parameters-extended-config; } /* RSVP refresh reduction extension */ augment "/rt:routing/rt:control-plane-protocols/" + "rt:control-plane-protocol/rsvp:rsvp/rsvp:interfaces/" + "rsvp:refresh-reduction" { Beeram, et al. Expires January 14, 2021 [Page 43]
Internet-Draft RSVP YANG Data Model July 2020 description "RSVP refresh-reduction all interface configuration extensions"; uses refresh-reduction-extended-config; } /* RSVP hellos extension */ augment "/rt:routing/rt:control-plane-protocols/" + "rt:control-plane-protocol/rsvp:rsvp/rsvp:interfaces/" + "rsvp:hellos" { description "RSVP hello all interfaces configuration extensions"; uses hellos-extended-config; } /* RSVP authentication extension */ augment "/rt:routing/rt:control-plane-protocols/" + "rt:control-plane-protocol/rsvp:rsvp/rsvp:interfaces/" + "rsvp:authentication" { description "RSVP authentication all interfaces configuration extensions"; uses authentication-extended-config; } /** * RSVP interface extensions */ /* RSVP interface signaling extensions */ augment "/rt:routing/rt:control-plane-protocols/" + "rt:control-plane-protocol/rsvp:rsvp/rsvp:interfaces/" + "rsvp:interface" { description "RSVP signaling interface configuration extensions"; uses signaling-parameters-extended-config; } /* RSVP refresh reduction extension */ augment "/rt:routing/rt:control-plane-protocols/" + "rt:control-plane-protocol/rsvp:rsvp/rsvp:interfaces/" + "rsvp:interface/rsvp:refresh-reduction" { description "RSVP refresh-reduction interface configuration extensions"; uses refresh-reduction-extended-config; } Beeram, et al. Expires January 14, 2021 [Page 44]
Internet-Draft RSVP YANG Data Model July 2020 /* RSVP hellos extension */ augment "/rt:routing/rt:control-plane-protocols/" + "rt:control-plane-protocol/rsvp:rsvp/rsvp:interfaces/" + "rsvp:interface/rsvp:hellos" { description "RSVP hello interface configuration extensions"; uses hellos-extended-config; } /* RSVP authentication extension */ augment "/rt:routing/rt:control-plane-protocols/" + "rt:control-plane-protocol/rsvp:rsvp/rsvp:interfaces/" + "rsvp:interface/rsvp:authentication" { description "RSVP authentication interface configuration extensions"; uses authentication-extended-config; } } <CODE ENDS> Figure 5: RSVP extended YANG module 3. IANA Considerations This document registers the following URIs in the IETF XML registry [RFC3688]. Following the format in [RFC3688], the following registration is requested to be made. URI: urn:ietf:params:xml:ns:yang:ietf-rsvp XML: N/A, the requested URI is an XML namespace. URI: urn:ietf:params:xml:ns:yang:ietf-rsvp-extended XML: N/A, the requested URI is an XML namespace. This document registers two YANG modules in the YANG Module Names registry [RFC6020]. name: ietf-rsvp namespace: urn:ietf:params:xml:ns:yang:ietf-rsvp prefix: ietf-rsvp reference: RFCXXXX name: ietf-rsvp-extended namespace: urn:ietf:params:xml:ns:yang:ietf-rsvp-extended prefix: ietf-rsvp-extendeed reference: RFCXXXX Beeram, et al. Expires January 14, 2021 [Page 45]
Internet-Draft RSVP YANG Data Model July 2020 4. Security Considerations The YANG module specified in this document defines a schema for data that is designed to be accessed via network management protocols such as NETCONF [RFC6241] or RESTCONF [RFC8040]. The lowest NETCONF layer is the secure transport layer, and the mandatory-to-implement secure transport is Secure Shell (SSH) [RFC6242]. The lowest RESTCONF layer is HTTPS, and the mandatory-to-implement secure transport is TLS [RFC8446]. The Network Configuration Access Control Model (NACM) [RFC8341] provides the means to restrict access for particular NETCONF or RESTCONF users to a preconfigured subset of all available NETCONF or RESTCONF protocol operations and content. There are a number of data nodes defined in the YANG module which are writable/creatable/deletable (i.e., config true, which is the default). These data nodes may be considered sensitive or vulnerable in some network environments. Write operations (e.g., <edit-config>) to these data nodes without proper protection can have a negative effect on network operations. /rt:routing/rt:control-plane-protocols/rt:control-plane-protocol/ rsvp: The presence of this container enables the RSVP protocol functionality on a device. It alsocontrols the configuration settings on data nodes pertaining to RSVP sessions, interfaces and neighbors. All of which are considered sensitive and if access to either of these is compromised, it can result in temporary network outages or be employed to mount DoS attacks. For RSVP authentication, the configuration supported is via the specification of key-chains [RFC8177] or the direct specification of key and authentication algorithm, and hence security considerations of [RFC8177] are inherited. This includes the considerations with respect to the local storage and handling of authentication keys. Some of the RPC operations defined in this YANG module may be considered sensitive or vulnerable in some network environments. It is thus important to control access to these operations. The RSVP YANG module support the "clear-session" and "clear-neighbor" RPCs. If access to either of these is compromised, they can result in temporary network outages be employed to mount DoS attacks. The security considerations spelled out in the YANG 1.1 specification [RFC7950] apply for this document as well. Beeram, et al. Expires January 14, 2021 [Page 46]
Internet-Draft RSVP YANG Data Model July 2020 5. Acknowledgement The authors would like to thank Lou Berger for reviewing and providing valuable feedback on this document. 6. Contributors Himanshu Shah Ciena Email: hshah@ciena.com Xia Chen Huawei Technologies Email: jescia.chenxia@huawei.com Raqib Jones Brocade Email: raqib@Brocade.com Bin Wen Comcast Email: Bin_Wen@cable.comcast.com 7. References 7.1. Normative References [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997, <https://www.rfc-editor.org/info/rfc2119>. [RFC2205] Braden, R., Ed., Zhang, L., Berson, S., Herzog, S., and S. Jamin, "Resource ReSerVation Protocol (RSVP) -- Version 1 Functional Specification", RFC 2205, DOI 10.17487/RFC2205, September 1997, <https://www.rfc-editor.org/info/rfc2205>. Beeram, et al. Expires January 14, 2021 [Page 47]
Internet-Draft RSVP YANG Data Model July 2020 [RFC2747] Baker, F., Lindell, B., and M. Talwar, "RSVP Cryptographic Authentication", RFC 2747, DOI 10.17487/RFC2747, January 2000, <https://www.rfc-editor.org/info/rfc2747>. [RFC2961] Berger, L., Gan, D., Swallow, G., Pan, P., Tommasi, F., and S. Molendini, "RSVP Refresh Overhead Reduction Extensions", RFC 2961, DOI 10.17487/RFC2961, April 2001, <https://www.rfc-editor.org/info/rfc2961>. [RFC3209] Awduche, D., Berger, L., Gan, D., Li, T., Srinivasan, V., and G. Swallow, "RSVP-TE: Extensions to RSVP for LSP Tunnels", RFC 3209, DOI 10.17487/RFC3209, December 2001, <https://www.rfc-editor.org/info/rfc3209>. [RFC3473] Berger, L., Ed., "Generalized Multi-Protocol Label Switching (GMPLS) Signaling Resource ReserVation Protocol- Traffic Engineering (RSVP-TE) Extensions", RFC 3473, DOI 10.17487/RFC3473, January 2003, <https://www.rfc-editor.org/info/rfc3473>. [RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, DOI 10.17487/RFC3688, January 2004, <https://www.rfc-editor.org/info/rfc3688>. [RFC5063] Satyanarayana, A., Ed. and R. Rahman, Ed., "Extensions to GMPLS Resource Reservation Protocol (RSVP) Graceful Restart", RFC 5063, DOI 10.17487/RFC5063, October 2007, <https://www.rfc-editor.org/info/rfc5063>. [RFC6020] Bjorklund, M., Ed., "YANG - A Data Modeling Language for the Network Configuration Protocol (NETCONF)", RFC 6020, DOI 10.17487/RFC6020, October 2010, <https://www.rfc-editor.org/info/rfc6020>. [RFC6241] Enns, R., Ed., Bjorklund, M., Ed., Schoenwaelder, J., Ed., and A. Bierman, Ed., "Network Configuration Protocol (NETCONF)", RFC 6241, DOI 10.17487/RFC6241, June 2011, <https://www.rfc-editor.org/info/rfc6241>. [RFC6242] Wasserman, M., "Using the NETCONF Protocol over Secure Shell (SSH)", RFC 6242, DOI 10.17487/RFC6242, June 2011, <https://www.rfc-editor.org/info/rfc6242>. [RFC6991] Schoenwaelder, J., Ed., "Common YANG Data Types", RFC 6991, DOI 10.17487/RFC6991, July 2013, <https://www.rfc-editor.org/info/rfc6991>. Beeram, et al. Expires January 14, 2021 [Page 48]
Internet-Draft RSVP YANG Data Model July 2020 [RFC7950] Bjorklund, M., Ed., "The YANG 1.1 Data Modeling Language", RFC 7950, DOI 10.17487/RFC7950, August 2016, <https://www.rfc-editor.org/info/rfc7950>. [RFC8040] Bierman, A., Bjorklund, M., and K. Watsen, "RESTCONF Protocol", RFC 8040, DOI 10.17487/RFC8040, January 2017, <https://www.rfc-editor.org/info/rfc8040>. [RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, May 2017, <https://www.rfc-editor.org/info/rfc8174>. [RFC8177] Lindem, A., Ed., Qu, Y., Yeung, D., Chen, I., and J. Zhang, "YANG Data Model for Key Chains", RFC 8177, DOI 10.17487/RFC8177, June 2017, <https://www.rfc-editor.org/info/rfc8177>. [RFC8340] Bjorklund, M. and L. Berger, Ed., "YANG Tree Diagrams", BCP 215, RFC 8340, DOI 10.17487/RFC8340, March 2018, <https://www.rfc-editor.org/info/rfc8340>. [RFC8341] Bierman, A. and M. Bjorklund, "Network Configuration Access Control Model", STD 91, RFC 8341, DOI 10.17487/RFC8341, March 2018, <https://www.rfc-editor.org/info/rfc8341>. [RFC8343] Bjorklund, M., "A YANG Data Model for Interface Management", RFC 8343, DOI 10.17487/RFC8343, March 2018, <https://www.rfc-editor.org/info/rfc8343>. [RFC8349] Lhotka, L., Lindem, A., and Y. Qu, "A YANG Data Model for Routing Management (NMDA Version)", RFC 8349, DOI 10.17487/RFC8349, March 2018, <https://www.rfc-editor.org/info/rfc8349>. [RFC8446] Rescorla, E., "The Transport Layer Security (TLS) Protocol Version 1.3", RFC 8446, DOI 10.17487/RFC8446, August 2018, <https://www.rfc-editor.org/info/rfc8446>. [RFC8639] Voit, E., Clemm, A., Gonzalez Prieto, A., Nilsen-Nygaard, E., and A. Tripathy, "Subscription to YANG Notifications", RFC 8639, DOI 10.17487/RFC8639, September 2019, <https://www.rfc-editor.org/info/rfc8639>. [RFC8641] Clemm, A. and E. Voit, "Subscription to YANG Notifications for Datastore Updates", RFC 8641, DOI 10.17487/RFC8641, September 2019, <https://www.rfc-editor.org/info/rfc8641>. Beeram, et al. Expires January 14, 2021 [Page 49]
Internet-Draft RSVP YANG Data Model July 2020 7.2. Informative References [I-D.ietf-teas-yang-rsvp-te] Beeram, V., Saad, T., Gandhi, R., Liu, X., Bryskin, I., and H. Shah, "A YANG Data Model for RSVP-TE Protocol", draft-ietf-teas-yang-rsvp-te-08 (work in progress), March 2020. Authors' Addresses Vishnu Pavan Beeram Juniper Networks Email: vbeeram@juniper.net Tarek Saad Juniper Networks Email: tsaad@juniper.net Rakesh Gandhi Cisco Systems, Inc. Email: rgandhi@cisco.com Xufeng Liu Volta Networks Email: xufeng.liu.ietf@gmail.com Igor Bryskin Individual Email: i_bryskin@yahoo.com Beeram, et al. Expires January 14, 2021 [Page 50]