MPLS Working Group T. Saad Internet-Draft K. Raza Intended status: Standards Track R. Gandhi Expires: April 13, 2019 Cisco Systems, Inc. X. Liu Volta Networks V. Beeram Juniper Networks H. Shah Ciena I. Bryskin Huawei Technologies October 10, 2018 A YANG Data Model for MPLS Static LSPs draft-ietf-mpls-static-yang-06 Abstract This document contains the specification for the MPLS Static Label Switched Paths (LSPs) YANG model. The model allows for the provisioning of static LSP(s) on LER(s) and LSR(s) devices along a LSP path without the dependency on any signaling protocol. The MPLS Static LSP model augments the MPLS base YANG model with specific data to configure and manage MPLS Static LSP(s). 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 April 13, 2019. Saad, et al. Expires April 13, 2019 [Page 1] Internet-Draft MPLS Static LSPs YANG Data Model October 2018 Copyright Notice Copyright (c) 2018 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 (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. Acronyms and Abbreviations . . . . . . . . . . . . . . . 3 2. MPLS Static LSP Model . . . . . . . . . . . . . . . . . . . . 4 2.1. Model Organization . . . . . . . . . . . . . . . . . . . 4 2.2. Model Tree Diagram . . . . . . . . . . . . . . . . . . . 4 2.3. Model Overview . . . . . . . . . . . . . . . . . . . . . 6 2.4. Model YANG Module(s) . . . . . . . . . . . . . . . . . . 7 3. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 14 4. Security Considerations . . . . . . . . . . . . . . . . . . . 14 5. References . . . . . . . . . . . . . . . . . . . . . . . . . 15 5.1. Normative References . . . . . . . . . . . . . . . . . . 15 5.2. Informative References . . . . . . . . . . . . . . . . . 16 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 16 1. Introduction This document describes a YANG [RFC7950] data model for configuring and managing the Multiprotocol Label Switching (MPLS) [RFC3031] Static LSPs. The model allows the configuration of LER and LSR devices with the necessary MPLS cross-connects or bindings to realize an end-to-end LSP service. A static LSP is established by manually specifying incoming and outgoing MPLS label(s) and necessary forwarding information on each of the traversed Label Edge Router (LER) and Label Switched Router (LSR) devices (ingress, transit, or egress nodes) of the forwarding path. For example, on an ingress LER device, the model is used to associate a specific Forwarding Equivalence Class (FEC) of packets- e.g. Saad, et al. Expires April 13, 2019 [Page 2] Internet-Draft MPLS Static LSPs YANG Data Model October 2018 matching a specific IP prefix in a Virtual Routing or Forwarding (VRF) instance- to an MPLS outgoing label imposition, next-hop(s) and respective outgoing interface(s) to forward the packet. On an LSR device, the model is used to create a binding that swaps the incoming label with an outgoing label and forwards the packet on one or multiple egress path(s). On an egress LER, it is used to create a binding that decapsulates the incoming MPLS label and performs forwarding based on the inner MPLS label (if present) or IP forwarding in the packet. The MPLS Static LSP YANG model is broken into two modules "ietf-mpls- static" and "ietf-mpls-static-extended". The "ietf-mpls-static" module covers basic features for the configuration and management of unidirectional Static LSP(s), while "ietf-mpls-static-extended" covers extended features like the configuration and management of bidirectional Static LSP(s) and LSP admission control. The module "ietf-mpls-static" augments the MPLS Base YANG model defined in module "ietf-mpls" in [I-D.ietf-mpls-base-yang]. 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. Acronyms and Abbreviations MPLS: Multiprotocol Label Switching LSP: Label Switched Path LSR: Label Switching Router LER: Label Edge Router FEC: Forwarding Equivalence Class NHLFE: Next Hop Label Forwarding Entry ILM: Incoming Label Map Saad, et al. Expires April 13, 2019 [Page 3] Internet-Draft MPLS Static LSPs YANG Data Model October 2018 2. MPLS Static LSP Model 2.1. Model Organization The base MPLS Static LSP model covers the core features with the minimal set of configuration parameters needed to manage and operate MPLS Static LSPs. Additional MPLS Static LSP parameters as well as optional feature(s) are grouped in a separate MPLS Static LSP extended model. The relationship between the MPLS base and other MPLS modules are shown in Figure 1. Routing module +---------------+ v: import | ietf-routing | o: augment +---------------+ o | v MPLS base +-----------+ v: import module | ietf-mpls | o: augment +-----------+ o o | \ v v +------------------+ +--------------------+ MPLS Static | ietf-mpls-static | | ietf-mpls-ldp.yang | . . . LSP module +------------------+ +--------------------+ o | v +---------------------------+ Extended MPLS | ietf-mpls-static-extended | Static LSP +---------------------------+ module Figure 1: Relationship between MPLS modules 2.2. Model Tree Diagram The MPLS Static and extended LSP tree diagram as per [RFC8340] is shown in Figure 2. module: ietf-mpls-static augment /rt:routing/mpls:mpls: +--rw static-lsps +--rw static-lsp* [name] Saad, et al. Expires April 13, 2019 [Page 4] Internet-Draft MPLS Static LSPs YANG Data Model October 2018 | +--rw name string | +--rw operation? mpls:mpls-operations-type | +--rw in-segment | | +--rw fec | | +--rw (type)? | | | +--:(ip-prefix) | | | | +--rw ip-prefix? inet:ip-prefix | | | +--:(mpls-label) | | | | +--rw incoming-label? rt-types:mpls-label | | | +--:(tunnel) | | | +--rw tunnel? te:tunnel-ref | | +--rw incoming-interface? if:interface-ref | +--rw out-segment | +--rw (out-segment)? | +--:(nhlfe-single) | | +--rw nhlfe-single | | +--rw remote-labels | | | +--rw remote-label* [index] | | | +--rw index uint8 | | | +--rw label? rt-types:mpls-label | | +--rw outgoing-interface? if:interface-ref | +--:(nhlfe-multiple) | +--rw nhlfe-multiple | +--rw nhlfe* [index] | +--rw index string | +--rw backup-index? string | +--rw loadshare? uint16 | +--rw role? nhlfe-role | +--rw remote-labels | | +--rw remote-label* [index] | | +--rw index uint8 | | +--rw label? rt-types:mpls-label | +--rw outgoing-interface? if:interface-ref +--rw mpls-static-ext:bandwidth? uint32 +--rw mpls-static-ext:lsp-priority-setup? uint8 +--rw mpls-static-ext:lsp-priority-hold? uint8 module: ietf-mpls-static-extended augment /rt:routing/mpls:mpls: +--rw bidir-static-lsps +--rw bidir-static-lsp* [name] +--rw name string +--rw forward-lsp? mpls-static:static-lsp-ref +--rw reverse-lsp? mpls-static:static-lsp-ref Figure 2: MPLS Static LSP tree diagram Saad, et al. Expires April 13, 2019 [Page 5] Internet-Draft MPLS Static LSPs YANG Data Model October 2018 2.3. Model Overview This document defines two YANG modules for MPLS Static LSP(s) configuration and management: ietf-mpls-static.yang and ietf-mpls- static-extended.yang. The ietf-mpls-static module imports the followinig modules: o ietf-inet-types defined in [RFC6991] o ietf-routing defined in [RFC8349] o ietf-routing-types defined in [RFC8294] o ietf-interfaces defined in [RFC8343] o ietf-mpls defined in [I-D.ietf-mpls-base-yang] o ietf-te defined in [I-D.ietf-teas-yang-te] ietf-mpls-static module contains the following high-level types and groupings: static-lsp-ref: A YANG reference type for a static LSP that can be used by data models to reference a configured static LSP. in-segment: A YANG grouping that describes parameters of an incoming class of FEC associated with a specific LSP as described in the MPLS architecture document [RFC3031]. The model allows the following types of traffic to be mapped onto the static LSP on an ingress LER: o Unlabeled traffic destined to a specific prefix o Labeled traffic arriving with a specific label o Traffic carried on a TE tunnel whose LSP is statically created via this model. out-segment: A YANG grouping that describes parameters for the forwarding path(s) and their associated attributes for an LSP. The model allows for the following cases: Saad, et al. Expires April 13, 2019 [Page 6] Internet-Draft MPLS Static LSPs YANG Data Model October 2018 o single forwarding path or NHLFE o multiple forwarding path(s) or NHLFE(s), each of which can serve a primary, backup or both role(s). 2.4. Model YANG Module(s) Configuring LSPs through an LSR/LER involves the following steps: o Enabling MPLS on MPLS capable interfaces. o Configuring in-segments and out-segments on LER(s) and LSR(s) traversed by the LSP. o Setting up the cross-connect per LSP to associate segments and/or to indicate connection origination and termination. o Optionally specifying label stack actions. o Optionally specifying segment traffic parameters. The objects covered by this model are derived from the Incoming Label Map (ILM) and Next Hop Label Forwarding Entry (NHLFE) as specified in the MPLS architecture document [RFC3031]. The MPLS Static LSP module is shown in Figure 3. file "ietf-mpls-static@2018-10-04.yang" module ietf-mpls-static { yang-version 1.1; namespace "urn:ietf:params:xml:ns:yang:ietf-mpls-static"; prefix "mpls-static"; import ietf-mpls { prefix "mpls"; reference "draft-ietf-mpls-base-yang: MPLS Base YANG Data Model"; } import ietf-routing { prefix "rt"; reference "RFC8349: A YANG Data Model for Routing Management"; } import ietf-routing-types { prefix "rt-types"; reference "RFC6991: Common YANG Data Types"; } Saad, et al. Expires April 13, 2019 [Page 7] Internet-Draft MPLS Static LSPs YANG Data Model October 2018 import ietf-inet-types { prefix inet; reference "RFC6991: Common YANG Data Types"; } import ietf-interfaces { prefix "if"; reference "RFC7223: A YANG Data Model for Interface Management"; } /* Import TE Tunnel */ import ietf-te { prefix te; reference "draft-ietf-teas-yang-te: A YANG Data Model for Traffic Engineering Tunnels and Interfaces"; } organization "IETF MPLS Working Group"; contact "WG Web: WG List: WG Chair: Loa Andersson Editor: Tarek Saad Editor: Kamran Raza Editor: Rakesh Gandhi Editor: Xufeng Liu Editor: Vishnu Pavan Beeram Editor: Himanshu Shah Editor: Igor Bryskin "; Saad, et al. Expires April 13, 2019 [Page 8] Internet-Draft MPLS Static LSPs YANG Data Model October 2018 description "This YANG module augments the 'ietf-routing' module with basic configuration and operational state data for MPLS static"; revision "2018-10-04" { description "Latest revision: - Addressed MPLS-RT review comments"; reference "RFC 3031: Multiprotocol Label Switching Architecture"; } typedef static-lsp-ref { type leafref { path "/rt:routing/mpls:mpls/mpls-static:static-lsps/" + "mpls-static:static-lsp/mpls-static:name"; } description "This type is used by data models that need to reference configured static LSP."; } grouping in-segment { description "In-segment grouping"; container in-segment { description "MPLS incoming segment"; container fec { description "Forwarding Equivalence Class grouping"; choice type { description "FEC type choices"; case ip-prefix { leaf ip-prefix { type inet:ip-prefix; description "An IP prefix"; } } case mpls-label { leaf incoming-label { type rt-types:mpls-label; description "label value on the incoming packet"; } } case tunnel { leaf tunnel { type te:tunnel-ref; description "TE tunnel FEC mapping"; } } } Saad, et al. Expires April 13, 2019 [Page 9] Internet-Draft MPLS Static LSPs YANG Data Model October 2018 leaf incoming-interface { type if:interface-ref; description "Optional incoming interface if FEC is restricted to traffic incoming on a specific interface"; } } } } grouping out-segment { description "Out-segment grouping"; container out-segment { description "MPLS outgoing segment"; choice out-segment { description "The MPLS out-segment type choice"; case nhlfe-single { container nhlfe-single { description "Container for single NHLFE entry"; uses mpls:nhlfe-single-contents; leaf outgoing-interface { type if:interface-ref; description "The outgoing interface"; } } } case nhlfe-multiple { container nhlfe-multiple { description "Container for multiple NHLFE entries"; list nhlfe { key index; description "MPLS NHLFE entry"; uses mpls:nhlfe-multiple-contents; leaf outgoing-interface { type if:interface-ref; description "The outgoing interface"; } } } } } } } augment "/rt:routing/mpls:mpls" { description "Augmentations for MPLS Static LSPs"; Saad, et al. Expires April 13, 2019 [Page 10] Internet-Draft MPLS Static LSPs YANG Data Model October 2018 container static-lsps { description "Statically configured LSPs, without dynamic signaling"; list static-lsp { key name; description "list of defined static LSPs"; leaf name { type string; description "name to identify the LSP"; } leaf operation { type mpls:mpls-operations-type; description "The MPLS operation to be executed on the incoming packet"; } uses in-segment; uses out-segment; } } } } Figure 3: MPLS Static LSP YANG module The extended MPLS Static LSP module is shown in Figure 4. file "ietf-mpls-static-extended@2018-10-04.yang" module ietf-mpls-static-extended { namespace "urn:ietf:params:xml:ns:yang:ietf-mpls-static-extended"; prefix "mpls-static-ext"; import ietf-mpls { prefix "mpls"; } import ietf-routing { prefix "rt"; } import ietf-mpls-static { prefix "mpls-static"; } organization "IETF MPLS Working Group"; Saad, et al. Expires April 13, 2019 [Page 11] Internet-Draft MPLS Static LSPs YANG Data Model October 2018 contact "WG Web: WG List: WG Chair: Loa Andersson Editor: Tarek Saad Editor: Kamran Raza Editor: Rakesh Gandhi Editor: Xufeng Liu Editor: Vishnu Pavan Beeram Editor: Himanshu Shah Editor: Igor Bryskin "; description "This module contains the Extended MPLS YANG data model."; revision "2018-10-04" { description "Latest revision of MPLS extended yang module."; reference "RFC2205"; } /* RSVP features */ feature bandwidth { description "Indicates support for static LSP bandwidth allocation"; } grouping bidir-static-lsp { description "grouping for top level list of static bidirectional LSPs"; leaf forward-lsp { Saad, et al. Expires April 13, 2019 [Page 12] Internet-Draft MPLS Static LSPs YANG Data Model October 2018 type mpls-static:static-lsp-ref; description "Reference to a configured static forward LSP"; } leaf reverse-lsp { type mpls-static:static-lsp-ref; description "Reference to a configured static reverse LSP"; } } augment "/rt:routing/mpls:mpls/mpls-static:static-lsps" { description "Augmentation for static MPLS LSPs"; leaf bandwidth { type uint32; description "bandwidth in Mbps, e.g., using offline calculation"; } leaf lsp-priority-setup { type uint8 { range "0..7"; } description "LSP setup priority"; } leaf lsp-priority-hold { type uint8 { range "0..7"; } description "LSP hold priority"; } } augment "/rt:routing/mpls:mpls" { description "Augmentations for MPLS Static LSPs"; container bidir-static-lsps { description "Statically configured LSPs, without dynamic signaling"; list bidir-static-lsp { key name; description "list of defined static LSPs"; leaf name { type string; description "name to identify the LSP"; } uses bidir-static-lsp; Saad, et al. Expires April 13, 2019 [Page 13] Internet-Draft MPLS Static LSPs YANG Data Model October 2018 } } } } Figure 4: Extended MPLS Static LSP 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-mpls-static XML: N/A, the requested URI is an XML namespace. URI: urn:ietf:params:xml:ns:yang:ietf-mpls-static-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-mpls-static namespace: urn:ietf:params:xml:ns:yang:ietf-mpls-static prefix: ietf-mpls-static reference: RFC3031 name: ietf-mpls-static-extended namespace: urn:ietf:params:xml:ns:yang:ietf-mpls-static-extended prefix: ietf-mpls-static reference: RFC3031 4. Security Considerations The YANG module defined in this document is designed to be accessed via the NETCONF protocol [RFC6241]. The lowest NETCONF layer is the secure transport layer and the mandatory-to-implement secure transport is SSH [RFC6242]. The NETCONF access control model [RFC8341] provides means to restrict access for particular NETCONF users to a pre-configured subset of all available NETCONF protocol operations and content. There are certain objects or data nodes that are defined in this YANG module which are writable/creatable/deletable and that can be considered sensitive or vulnerable in some network environments. Specifically, misconfiguration or manipulations of objects or data Saad, et al. Expires April 13, 2019 [Page 14] Internet-Draft MPLS Static LSPs YANG Data Model October 2018 node(s) defined in this model, including: in-segment(s), out- segment(s) and their associated parameters that collectively allow the provisioning of MPLS LSP(s) and associated parameters on a LSR can potentially have disastrous results. 5. References 5.1. Normative References [I-D.ietf-mpls-base-yang] Saad, T., Raza, K., Gandhi, R., Liu, X., and V. Beeram, "A YANG Data Model for MPLS Base", draft-ietf-mpls-base- yang-07 (work in progress), October 2018. [I-D.ietf-teas-yang-te] Saad, T., Gandhi, R., Liu, X., Beeram, V., Shah, H., and I. Bryskin, "A YANG Data Model for Traffic Engineering Tunnels and Interfaces", draft-ietf-teas-yang-te-16 (work in progress), July 2018. [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997, . [RFC3031] Rosen, E., Viswanathan, A., and R. Callon, "Multiprotocol Label Switching Architecture", RFC 3031, DOI 10.17487/RFC3031, January 2001, . [RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, DOI 10.17487/RFC3688, January 2004, . [RFC6020] Bjorklund, M., Ed., "YANG - A Data Modeling Language for the Network Configuration Protocol (NETCONF)", RFC 6020, DOI 10.17487/RFC6020, October 2010, . [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, . [RFC6242] Wasserman, M., "Using the NETCONF Protocol over Secure Shell (SSH)", RFC 6242, DOI 10.17487/RFC6242, June 2011, . Saad, et al. Expires April 13, 2019 [Page 15] Internet-Draft MPLS Static LSPs YANG Data Model October 2018 [RFC6991] Schoenwaelder, J., Ed., "Common YANG Data Types", RFC 6991, DOI 10.17487/RFC6991, July 2013, . [RFC7950] Bjorklund, M., Ed., "The YANG 1.1 Data Modeling Language", RFC 7950, DOI 10.17487/RFC7950, August 2016, . [RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, May 2017, . [RFC8294] Liu, X., Qu, Y., Lindem, A., Hopps, C., and L. Berger, "Common YANG Data Types for the Routing Area", RFC 8294, DOI 10.17487/RFC8294, December 2017, . [RFC8341] Bierman, A. and M. Bjorklund, "Network Configuration Access Control Model", STD 91, RFC 8341, DOI 10.17487/RFC8341, March 2018, . [RFC8343] Bjorklund, M., "A YANG Data Model for Interface Management", RFC 8343, DOI 10.17487/RFC8343, March 2018, . [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, . 5.2. Informative References [RFC8340] Bjorklund, M. and L. Berger, Ed., "YANG Tree Diagrams", BCP 215, RFC 8340, DOI 10.17487/RFC8340, March 2018, . Authors' Addresses Tarek Saad Cisco Systems, Inc. Email: tsaad@cisco.com Saad, et al. Expires April 13, 2019 [Page 16] Internet-Draft MPLS Static LSPs YANG Data Model October 2018 Kamran Raza Cisco Systems, Inc. Email: skraza@cisco.com Rakesh Gandhi Cisco Systems, Inc. Email: rgandhi@cisco.com Xufeng Liu Volta Networks Email: xufeng.liu.ietf@gmail.com Vishnu Pavan Beeram Juniper Networks Email: vbeeram@juniper.net Himanshu Shah Ciena Email: hshah@ciena.com Igor Bryskin Huawei Technologies Email: Igor.Bryskin@huawei.com Saad, et al. Expires April 13, 2019 [Page 17]