MPLS Working Group K. Raza Internet-Draft S. Krishnaswamy Intended status: Standards Track Cisco Systems, Inc. Expires: September 14, 2017 X. Liu Jabil S. Esale Juniper Networks X. Chen Huawei Technologies Jeff Tantsura March 13, 2017 YANG Data Model for MPLS mLDP draft-ietf-mpls-mldp-yang-01 Abstract This document describes a YANG data model for Multi-Protocol Label Switching (MPLS) Multipoint Label Distribution Protocol (mLDP). The mLDP data model augments the LDP data model. 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 http://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 September 14, 2017. Raza, et al. Expires September 14, 2017 [Page 1] Internet-Draft YANG Data Model for MPLS mLDP March 2017 Copyright Notice Copyright (c) 2017 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. Base and Extended . . . . . . . . . . . . . . . . . . . . 3 2. Specification of Requirements . . . . . . . . . . . . . . . . 4 3. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 4 3.1. Scope . . . . . . . . . . . . . . . . . . . . . . . . . . 5 3.2. FEC Types . . . . . . . . . . . . . . . . . . . . . . . . 6 4. Configuration . . . . . . . . . . . . . . . . . . . . . . . . 7 4.1. Configuration Hierarchy . . . . . . . . . . . . . . . . . 7 4.2. mldp global container . . . . . . . . . . . . . . . . . . 9 4.3. Leveraging LDP containers . . . . . . . . . . . . . . . . 9 4.4. Configuration Tree . . . . . . . . . . . . . . . . . . . 10 4.4.1. Base . . . . . . . . . . . . . . . . . . . . . . . . 10 4.4.2. Extended . . . . . . . . . . . . . . . . . . . . . . 11 5. Operational State . . . . . . . . . . . . . . . . . . . . . . 13 5.1. Base . . . . . . . . . . . . . . . . . . . . . . . . . . 13 5.2. Extended . . . . . . . . . . . . . . . . . . . . . . . . 14 5.3. Derived states . . . . . . . . . . . . . . . . . . . . . 17 5.3.1. Root state . . . . . . . . . . . . . . . . . . . . . 18 5.3.2. Bindings state . . . . . . . . . . . . . . . . . . . 19 5.3.3. Capabilities state . . . . . . . . . . . . . . . . . 22 6. Notifications . . . . . . . . . . . . . . . . . . . . . . . . 22 6.1. Base . . . . . . . . . . . . . . . . . . . . . . . . . . 22 6.2. Extended . . . . . . . . . . . . . . . . . . . . . . . . 22 7. Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 8. Open Items . . . . . . . . . . . . . . . . . . . . . . . . . 23 9. YANG Specification . . . . . . . . . . . . . . . . . . . . . 23 9.1. Base . . . . . . . . . . . . . . . . . . . . . . . . . . 23 9.2. Extended . . . . . . . . . . . . . . . . . . . . . . . . 33 10. Security Considerations . . . . . . . . . . . . . . . . . . . 54 11. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 54 12. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 54 Raza, et al. Expires September 14, 2017 [Page 2] Internet-Draft YANG Data Model for MPLS mLDP March 2017 13. References . . . . . . . . . . . . . . . . . . . . . . . . . 54 13.1. Normative References . . . . . . . . . . . . . . . . . . 54 13.2. Informative References . . . . . . . . . . . . . . . . . 56 Appendix A. Additional Contributors . . . . . . . . . . . . . . 56 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 56 1. Introduction This document introduces a YANG data model for MPLS Multipoint Label Distribution Protocol (mLDP). The mLDP model being defined here is dependent on LDP YANG data model [I-D.ietf-mpls-ldp-yang]. This implies that an opertor will need to use base LDP module to configure and manage control plane for mLDP. For example, an operator would enable LDP discovery on MPLS interface to establish LDP/mLDP peering on which mLDP bindings could be exchanged. Similarly, an operator could query state information for an LDP peer in order to verify peering attributes etc. Moreover, it is important to note here that any assumptions made in the LDP model also hold true in this document, unless otherwise explicitly stated. Like its parent LDP data model, this mLDP model also defines the following constructs for managing the mLDP protocol: o Configuration o Operational State o Executables (Actions) o Notifications This document is organized to define the data model for each of the above constructs in the sequence as listed above. 1.1. Base and Extended Like LDP model, the configuration and state items are divided into following two broad categories: o Base o Extended The "base" category contains the basic and fundamental features that are covered in mLDP base specification [RFC6388] alongwith few significant extension like targeted mLDP [RFC7060], constituting the Raza, et al. Expires September 14, 2017 [Page 3] Internet-Draft YANG Data Model for MPLS mLDP March 2017 minumum requirements for an mLDP deployment. Whereas, the "extended" category contains all other non-base features (such as recursive FEC support, protection etc.). All the items in a base category are mandatory and hence no "if-feature" is allowed under the "base" category. While "base" model support will suffice for small deployments, large deployments will require not only the "base" module support but also "extended" support for some selected and required features. The base and extended catogories are defined in their own modules ietf-mpls-mldp and ietf-mpls-mldp-extended respectively, each of which augmenting LDP base model ietf-mpls-ldp as defined under ietf- mpls-ldp [I-D.ietf-mpls-ldp-yang]. Like LDP, mLDP "base" model configuration and state covers ipv4 address-family only, with ipv6 address-family related configuration and state be covered in "extended" model. 2. Specification of Requirements The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC2119]. 3. Overview This document defines a new module named "ietf-mpls-mldp" for mLDP YANG base data model that augments /rt:routing/rt:control-plane- protocols/ldp:mpls-ldp defined in [I-D.ietf-mpls-ldp-yang]. The document also defines "ietf-mpls-mldp-extended" module that models the extended mLDP features under YANG. Following diagram depicts high level mLDP yang tree organization and hierarchy with respect to LDP: Raza, et al. Expires September 14, 2017 [Page 4] Internet-Draft YANG Data Model for MPLS mLDP March 2017 +-- rw routing +-- rw control-plane-protocols +-- rw mpls-ldp +-- rw some_container | +-- rw config | | +-- rw .... // ldp base | | +-- rw ldp-ext:.... // ldp extended | | ... | | +-- rw mldp | | +-- rw ... // mldp base | | +-- rw mldp-ext:.... // mldp extended | | ... | +-- ro state | | +-- ro .... // ldp base | | +-- ro ldp-ext:.... // ldp extended | | ... | | +-- ro mldp | | +-- ro ... // mldp base | | +-- ro mldp-ext:.... // mldp extended | | ... +-- rw ... | notifications: +--- n mpls-mldp-some_event +--- n ... Figure 1 3.1. Scope Following are the main mLDP areas and features that are within the scope of this model: o Base: * mLDP Base Specification [RFC6388] * Targeted mLDP [RFC7060] * Configured Leaf LSPs (manually provisioned) o Extended: * mLDP Recursive FEC [RFC6512] Raza, et al. Expires September 14, 2017 [Page 5] Internet-Draft YANG Data Model for MPLS mLDP March 2017 * mLDP Fast-Reroute (FRR): + Node Protection [RFC7715] + Multicast-only * In-band Signaling: + mLDP In-band Signaling [RFC6826] + mLDP In-band signaling in a VRF [RFC7246] + mLDP In-band Signaling with Wildcards [RFC7438] * Hub-and-Spoke Multipoint LSPs [RFC7140] [Ed Note: Some of the topics in the above list are to be addressed/ extended in a later revision of this document]. 3.2. FEC Types The FEC for Multipoint LSP is presented as (root-address, opaque- type). The following is the table for various type of MP opaque values with their keys, as covered in the configuration and state model: +-------------------------+--------------------+------------+ | Opaque Type | Key | RFC | +-------------------------+--------------------+------------+ | Generic LSP Identifier | LSP Id | [RFC6388] | | Transit IPv4 Source | Source, Group | [RFC6826] | | Transit IPv6 Source | Source, Group | [RFC6826] | | Transit IPv4 Bidir | RP, Group | [RFC6826] | | Transit IPv6 Bidir | RP, Group | [RFC6826] | | Transit VPNv4 Source | Source, Group, RD | [RFC7246] | | Transit VPNv6 Source | Source, Group, RD | [RFC7246] | | Transit VPNv4 Bidir | RP, Group, RD | [RFC7246] | | Transit VPNv6 Bidir | RP, Group, RD | [RFC7246] | | Recursive Opaque | Root | [RFC6512] | | VPN-Recursive Opaque | Root, RD | [RFC6512] | +-------------------------+--------------------+------------+ Table 1: MP Opaque Types and keys It is to be noted that there are three basic types (LSP Id, Source, and Bidir) and then there are variants (VPN, recursive, VPN- recursive) on top of these basic types. Raza, et al. Expires September 14, 2017 [Page 6] Internet-Draft YANG Data Model for MPLS mLDP March 2017 The "base" model includes only the "Generic LSP Identifier" opaque type (for ipv4), while rest of the above types are covered by the "extended" model. 4. Configuration 4.1. Configuration Hierarchy Following is the high-level configuration organization for base and extended mLDP: Raza, et al. Expires September 14, 2017 [Page 7] Internet-Draft YANG Data Model for MPLS mLDP March 2017 augment /rt:routing/rt:control-plane-protocols/rt:control-plane-protocol: +-- mpls-ldp +-- global +-- ... +-- ... +-- mldp | +-- ... | +-- ... | +-- address-families | +-- ipv4 | | +-- ... | | +-- mldp-ext: ... | | +-- ... | | +-- configured-leaf-lsps | | +-- ... | | +-- ... | | +-- mldp-ext: ... | | +-- ... | +-- mldp-ext: ipv6 | +-- ... | +-- ... | +-- configured-leaf-lsps | +-- ... | +-- ... +-- capability | +-- mldp | +-- ... | +-- mldp-ext: ... | +-- ... +-- forwarding-nexthop +--- interfaces +--- interface* [name] +--- mldp-ext: ... Figure 2 From above hierarchy, we can categorize mLDP configuration parameters into two types: o Parameters that are mLDP specific o Parameters that leverage/extend LDP containers and parameters Following subsections first describe mLDP specific configuration parameters, followed by those leveraging LDP. It is to be noted that Raza, et al. Expires September 14, 2017 [Page 8] Internet-Draft YANG Data Model for MPLS mLDP March 2017 these parameters are defined under their respective base or extended module as per their categorization. 4.2. mldp global container mldp container is an augmentation of LDP global container and holds the configuration related to items that are mLDP specific. The main items under this container are: o mLDP enabling: To enable mLDP under a (VRF) routing instance, mldp container is enabled under LDP. Given that mLDP requires LDP signalling, it is not sensible to allow disabling LDP control plane under a (VRF) network-instance while requiring mLDP to be enabled for the same. However, if a user wants only to allow signalling for multipoint FECs on an LDP/mLDP enabled VRF instance, he/she can use LDP label-policies to disable unicast FECs under the VRF. o mLDP per-AF features: mLDP manages its own list of IP address- families and the features enabled underneath. The per-AF mLDP configuration items include: * Multicast-only FRR: This enables Multicast-only FRR functionality for a given AF under mLDP. The feature allows route-policy to be configured for finer control/applicability of the feature. * Recursive FEC: The recursive-fec feature [RFC6512] can be enabled per AF with a route-policy. * Configured Leaf LSPs: To provision multipoint leaf LSP manually, a container is provided per-AF under LDP. The configuration is flexible and allows a user to specify MP LSPs of type p2mp or mp2mp with IPv4 or IPv6 root address(es) by using either LSP-Id or (S,G). Targeted mLDP feature specification [RFC7060] does not require any mLDP specific configuration. It, however, requires LDP upstream- label-assignment capability [RFC6389] to be enabled. 4.3. Leveraging LDP containers mLDP configuration model leverages following configuration areas and containers that are already defined for LDP: o Capabilities: A new container "mldp" is defined that augments LDP's capabilities container. This new container specifies any mLDP specific capabilities and their parameters. Moreover, a new Raza, et al. Expires September 14, 2017 [Page 9] Internet-Draft YANG Data Model for MPLS mLDP March 2017 "mldp" container is also added by augmenting LDP per-peer capability container to override/control mLDP specific capabilities on a peer level. In the scope of this document, the most important capabilities related to mLDP are p2mp, mp2mp, make- before-break, hub-and-spoke, and node-protection. o Discovery and Peer: mLDP requires LDP discovery and peer procedures to form mLDP peering. A peer is treated as mLDP peer only when either P2MP or MP2MP capabilities have been successfully exchanged with the peer. If a user wish to selectively enable or disable mLDP with a LDP-enabled peer, he/she may use per-peer mLDP capabilities configuration. [Ed Note: The option to control mLDP enabling/disabling on a peer-list is being explored for future ]. In most common deployments, it is desirable to disable mLDP (capabilities announcements) on a targeted-only LDP peering, where targeted-only peer is the one whose discovery sources are targeted type only. In future revision, a configuration option for this support will also be provided. o Forwarding: By default, mLDP is allowed to select any of the LDP enabled interface as a downstream interface towards a nexthop (LDP/mLDP peer) for MP LSP programming. However, a configuration option is provided to allow mLDP to exclude a given interface from such a selection. Note that such a configuration option will be useful only when there are more than one interfaces available for the downstream selection. This goes without saying that mLDP configuration tree follows the same approach as LDP, where the tree comprise leafs for intended configuration. 4.4. Configuration Tree 4.4.1. Base Following is a simplified graphical representation of the data model for mLDP base configuration Raza, et al. Expires September 14, 2017 [Page 10] Internet-Draft YANG Data Model for MPLS mLDP March 2017 module: ietf-mpls-mldp augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global/ldp:config/ldp:capability: +--rw mldp +--rw p2mp | +--rw enable? boolean +--rw mp2mp | +--rw enable? boolean +--rw make-before-break +--rw enable? boolean +--rw switchover-delay? uint16 +--rw timeout? uint16 augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global: +--rw mldp +--rw config | +--rw enable? boolean +--rw address-families +--rw ipv4 +--rw configured-leaf-lsps +--rw p2mp | +--rw roots | +--rw root* [root-address] | +--rw root-address inet:ipv4-address | +--rw (lsp-key-type)? | +--:(lsp-id) | +--rw opaque-type-lspid | +--rw lsp* [lsp-id] | +--rw lsp-id uint16 +--rw mp2mp +--rw roots +--rw root* [root-address] +--rw root-address inet:ipv4-address +--rw (lsp-key-type)? +--:(lsp-id) +--rw opaque-type-lspid +--rw lsp* [lsp-id] +--rw lsp-id uint16 Figure 3 4.4.2. Extended Following is a simplified graphical representation of the data model for mLDP extended configuration module: ietf-mpls-mldp-extended Raza, et al. Expires September 14, 2017 [Page 11] Internet-Draft YANG Data Model for MPLS mLDP March 2017 augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global/ldp:config/ldp:capability/mldp:mldp: +--rw hub-and-spoke {capability-mldp-hsmp}? | +--rw enable? boolean +--rw node-protection {capability-mldp-node-protection}? +--rw plr? boolean +--rw merge-point +--rw enable? boolean +--rw targeted-session-teardown-delay? uint16 augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:peers/ldp:peer/ldp:config/ldp:capability: +--rw mldp {per-peer-capability}? +--rw p2mp | +--rw enable? boolean +--rw mp2mp | +--rw enable? boolean +--rw make-before-break +--rw enable? boolean +--rw switchover-delay? uint16 +--rw timeout? uint16 augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/mldp:ipv4: +--rw config +--rw multicast-only-frr {mldp-mofrr}? | +--rw prefix-list? ldp-ext:prefix-list-ref +--rw recursive-fec +--rw prefix-list? ldp-ext:prefix-list-ref augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/mldp:ipv4/mldp:configured-leaf-lsps/mldp:p2mp/mldp:roots/mldp:root/mldp:lsp-key-type: +--:(source-group) +--rw opaque-type-transit +--rw lsp* [source-address group-address] +--rw source-address inet:ipv4-address +--rw group-address inet:ipv4-address-no-zone augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/mldp:ipv4/mldp:configured-leaf-lsps/mldp:mp2mp/mldp:roots/mldp:root/mldp:lsp-key-type: +--:(source-group) +--rw opaque-type-transit +--rw lsp* [source-address group-address] +--rw source-address inet:ipv4-address +--rw group-address inet:ipv4-address-no-zone augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global/ldp-ext:forwarding-nexthop/ldp-ext:interfaces/ldp-ext:interface/ldp-ext:address-family/ldp-ext:config: +--rw mldp-disable? boolean augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families: +--rw ipv6 +--rw config +--rw multicast-only-frr {mldp-mofrr}? Raza, et al. Expires September 14, 2017 [Page 12] Internet-Draft YANG Data Model for MPLS mLDP March 2017 | +--rw prefix-list? ldp-ext:prefix-list-ref +--rw recursive-fec +--rw prefix-list? ldp-ext:prefix-list-ref Figure 4 5. Operational State Operational state of mLDP can be queried and obtained from various read-only mdlp "state" containers that augment ldp state containers. Please note this state tree refers both the configuration "applied" state as well as the "derived" state related to the mLDP protocol. [Ed note: Future revision will realign] 5.1. Base Following is a simplified graphical representation of the data model for mLDP base operational state: module: ietf-mpls-mldp augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global/ldp:state/ldp:capability: +--ro mldp +--ro p2mp | +--ro enable? boolean +--ro mp2mp | +--ro enable? boolean +--ro make-before-break +--ro enable? boolean +--ro switchover-delay? uint16 +--ro timeout? uint16 augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:peers/ldp:peer/ldp:state/ldp:received-peer-state/ldp:capability: +--ro mldp +--ro p2mp | +--ro enable? boolean +--ro mp2mp | +--ro enable? boolean +--ro make-before-break +--ro enable? boolean augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global: +--rw mldp +--ro state Raza, et al. Expires September 14, 2017 [Page 13] Internet-Draft YANG Data Model for MPLS mLDP March 2017 | +--ro enable? boolean +--rw address-families +--rw ipv4 +--ro state +--ro roots +--ro root* [root-address] +--ro root-address inet:ipv4-address +--ro is-self? boolean +--ro reachability* [address interface] | +--ro address inet:ipv4-address | +--ro interface ldp:mpls-interface-ref | +--ro peer? leafref +--ro bindings +--ro opaque-type-lspid +--ro fec-label* [lsp-id] +--ro lsp-id uint32 +--ro multipoint-type? multipoint-type +--ro peer* [direction peer advertisement-type] +--ro direction ldp:downstream-upstream +--ro peer leafref +--ro advertisement-type ldp:advertised-received +--ro label? rt-types:mpls-label +--ro mbb-role? enumeration Figure 5 5.2. Extended Following is a simplified graphical representation of the data model for mLDP extended operational state: module: ietf-mpls-mldp-extended augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global/ldp:state/ldp:capability/mldp:mldp: +--ro hub-and-spoke {capability-mldp-hsmp}? | +--ro enable? boolean +--ro node-protection {capability-mldp-node-protection}? +--ro plr? boolean +--ro merge-point +--ro enable? boolean +--ro targeted-session-teardown-delay? uint16 augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:peers/ldp:peer/ldp:state/ldp:capability: +--ro mldp +--ro p2mp | +--ro enable? boolean Raza, et al. Expires September 14, 2017 [Page 14] Internet-Draft YANG Data Model for MPLS mLDP March 2017 +--ro mp2mp | +--ro enable? boolean +--ro make-before-break +--ro enable? boolean +--ro switchover-delay? uint16 +--ro timeout? uint16 augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/mldp:ipv4/mldp:state: +--ro multicast-only-frr {mldp-mofrr}? | +--ro prefix-list? ldp-ext:prefix-list-ref +--ro recursive-fec +--ro prefix-list? ldp-ext:prefix-list-ref augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/mldp:ipv4/mldp:state/mldp:roots/mldp:root/mldp:bindings/mldp:opaque-type-lspid/mldp:fec-label/mldp:peer: +--ro mofrr-role? mofrr-role augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global/ldp-ext:forwarding-nexthop/ldp-ext:interfaces/ldp-ext:interface/ldp-ext:address-family/ldp-ext:state: +--ro mldp-disable? boolean augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:peers/ldp:peer/ldp:state/ldp:received-peer-state/ldp:capability/mldp:mldp: +--ro hub-and-spoke | +--ro enable? boolean +--ro node-protection +--ro plr? boolean +--ro merge-point? boolean augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/mldp:ipv4/mldp:state/mldp:roots/mldp:root/mldp:bindings: +--ro opaque-type-transit | +--ro fec-label* [source-address group-address rd recur-root-address recur-rd] | +--ro source-address inet:ip-address | +--ro group-address inet:ip-address-no-zone | +--ro rd route-distinguisher | +--ro recur-root-address inet:ip-address | +--ro recur-rd route-distinguisher | +--ro multipoint-type? mldp:multipoint-type | +--ro peer* [direction peer advertisement-type] | +--ro direction ldp:downstream-upstream | +--ro peer leafref | +--ro advertisement-type ldp:advertised-received | +--ro label? rt-types:mpls-label | +--ro mbb-role? enumeration | +--ro mofrr-role? mofrr-role +--ro opaque-type-bidir +--ro fec-label* [rp group-address rd recur-root-address recur-rd] +--ro rp inet:ip-address +--ro group-address inet:ip-address-no-zone +--ro rd route-distinguisher +--ro recur-root-address inet:ip-address Raza, et al. Expires September 14, 2017 [Page 15] Internet-Draft YANG Data Model for MPLS mLDP March 2017 +--ro recur-rd route-distinguisher +--ro multipoint-type? mldp:multipoint-type +--ro peer* [direction peer advertisement-type] +--ro direction ldp:downstream-upstream +--ro peer leafref +--ro advertisement-type ldp:advertised-received +--ro label? rt-types:mpls-label +--ro mbb-role? enumeration +--ro mofrr-role? mofrr-role augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/mldp:ipv4/mldp:state/mldp:roots/mldp:root/mldp:bindings/mldp:opaque-type-lspid/mldp:fec-label: +--ro recursive-fec* [recur-root-address recur-rd] +--ro recur-root-address inet:ip-address +--ro recur-rd route-distinguisher +--ro multipoint-type? mldp:multipoint-type +--ro peer* [direction peer advertisement-type] +--ro direction ldp:downstream-upstream +--ro peer leafref +--ro advertisement-type ldp:advertised-received +--ro label? rt-types:mpls-label +--ro mbb-role? enumeration +--ro mofrr-role? mofrr-role augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families: +--rw ipv6 +--ro state +--ro roots +--ro root* [root-address] +--ro root-address inet:ipv6-address +--ro is-self? boolean +--ro reachability* [address interface] | +--ro address inet:ipv6-address | +--ro interface ldp:mpls-interface-ref | +--ro peer? leafref +--ro bindings +--ro opaque-type-lspid | +--ro fec-label* [lsp-id] | +--ro lsp-id uint32 | +--ro multipoint-type? mldp:multipoint-type | +--ro peer* [direction peer advertisement-type] | | +--ro direction ldp:downstream-upstream | | +--ro peer leafref | | +--ro advertisement-type ldp:advertised-received | | +--ro label? rt-types:mpls-label | | +--ro mbb-role? enumeration | | +--ro mofrr-role? mofrr-role | +--ro recursive-fec* [recur-root-address recur-rd] | +--ro recur-root-address inet:ip-address Raza, et al. Expires September 14, 2017 [Page 16] Internet-Draft YANG Data Model for MPLS mLDP March 2017 | +--ro recur-rd route-distinguisher | +--ro multipoint-type? mldp:multipoint-type | +--ro peer* [direction peer advertisement-type] | +--ro direction ldp:downstream-upstream | +--ro peer leafref | +--ro advertisement-type ldp:advertised-received | +--ro label? rt-types:mpls-label | +--ro mbb-role? enumeration | +--ro mofrr-role? mofrr-role +--ro opaque-type-transit | +--ro fec-label* [source-address group-address rd recur-root-address recur-rd] | +--ro source-address inet:ip-address | +--ro group-address inet:ip-address-no-zone | +--ro rd route-distinguisher | +--ro recur-root-address inet:ip-address | +--ro recur-rd route-distinguisher | +--ro multipoint-type? mldp:multipoint-type | +--ro peer* [direction peer advertisement-type] | +--ro direction ldp:downstream-upstream | +--ro peer leafref | +--ro advertisement-type ldp:advertised-received | +--ro label? rt-types:mpls-label | +--ro mbb-role? enumeration | +--ro mofrr-role? mofrr-role +--ro opaque-type-bidir +--ro fec-label* [rp group-address rd recur-root-address recur-rd] +--ro rp inet:ip-address +--ro group-address inet:ip-address-no-zone +--ro rd route-distinguisher +--ro recur-root-address inet:ip-address +--ro recur-rd route-distinguisher +--ro multipoint-type? mldp:multipoint-type +--ro peer* [direction peer advertisement-type] +--ro direction ldp:downstream-upstream +--ro peer leafref +--ro advertisement-type ldp:advertised-received +--ro label? rt-types:mpls-label +--ro mbb-role? enumeration +--ro mofrr-role? mofrr-role Figure 6 5.3. Derived states Following are main areas for which mLDP operational derived state is defined: Raza, et al. Expires September 14, 2017 [Page 17] Internet-Draft YANG Data Model for MPLS mLDP March 2017 o Root o Bindings (FEC-label) o Capabilities 5.3.1. Root state Root address is a fundamental construct for MP FEC bindings and LSPs. The root state provides information on all the known roots in a given address-familty, and their information on the root reachability (as learnt from RIB). In case of multi-path reachability to a root, the selection of upstream path is done on per-LSP basis at the time of LSP setup. Similarly, when protection mechanisms like MBB or MoFRR are in place, the path designation as active/standby or primary/ backup is also done on per LSP basis. It is to be noted that a given root can be shared amongst multiple P2MP and/or MP2MP LSPs. Moreover, an LSP can be signaled to more than one root for RNR purposes. The following diagram illustrates a root database on a branch/transit LSR: root 1.1.1.1: path1: RIB: GigEthernet 1/0, 12.1.0.2; LDP: peer 192.168.0.1:0 path2: RIB: GigEthernet 2/0, 12.2.0.2; LDP: peer 192.168.0.3:0 root 2.2.2.2: path1: RIB: 3.3.3.3; (NOTE: This is a recursive path) LDP: peer 192.168.0.3:0 (NOTE: T-mLDP peer) root 9.9.9.9: . . . . Figure 7 A root entry on a root LSR itself will be presented as follows: Raza, et al. Expires September 14, 2017 [Page 18] Internet-Draft YANG Data Model for MPLS mLDP March 2017 root 9.9.9.9: is-self Figure 8 5.3.2. Bindings state Binding state provides information on mLDP FEC-label bindings for both P2MP and MP2MP FEC types. Like LDP, the FEC-label binding derived state is presented in a FEC-centric view per address-family, and provides information on both inbound (received) and outbound (advertised) bindings. The FEC is presented as (root-address, opaque-type-data) as described earlier in section Section 3.2, and the direction (upstream or downstream) is picked with respect to root reachability. In case of MBB or/and MoFRR, the role of a given peer binding is also provided with respect to MBB (active or standby) or/ and MoFRR (primary or backup). Following captures a high level tree hierarchy for mLDP bindings state: Raza, et al. Expires September 14, 2017 [Page 19] Internet-Draft YANG Data Model for MPLS mLDP March 2017 +--rw mpls-ldp! +--rw global +--rw mldp +--rw address-families +--rw ipv4 (or ipv6) +--ro state +--ro roots +--ro root* [root-address] +--ro .... +--ro bindings +--ro opaque-type-xxx | +--ro fec-label* [type-specific-key] | +--ro some_key_1 ... | +--ro some_key_2 ... | +--ro multipoint-type? multipoint-type | +--ro peer* [direction peer advertisement-type] | | +--ro direction ldp:downstream-upstream | | +--ro peer leafref | | +--ro advertisement-type ldp:advertised-received | | +--ro label? rt-types:mpls-label | | +--ro mbb-role? enumeration | | +--ro mldp-ext:mofrr-role? mofrr-role +--ro opaque-type-yyy | +--ro fec-label* [type-specific-key] | +--ro some_key_1 ... ... Figure 9 mLDP binding state is organized and presented per root address, and hence the bindings container hang off a root node in the model. The bindings state is made available for FECs pertaining to different types of opaque types, with some state avaiable under "base" tree and the rest under "extended". In the above tree, the various opaque types alongwith their type specific key(s) refer to the table Table 1 captured earlier in the document. For example, if the opaque type is Generic LSP Identifier, then the type-specific-key will be a uint32 LSP-Id key. Please see the complete model for all other types. It is important to take note of the following: o The address-family ipv4/ipv4 applies to "root" address in the mLDP binding tree. The other addresses (source, group, RP etc) do not have to be of the same address family type as the root. Raza, et al. Expires September 14, 2017 [Page 20] Internet-Draft YANG Data Model for MPLS mLDP March 2017 o The "recur-root-address" field applies to Recursive opaque type, and (recur-root-address, recur-rd) fields applies to VPN-Recursive opaque types as defined in [RFC6512] o In case of a recursive FEC, the address-family of the recur-root- address could be different than the address-family of the root address of original encapsulated MP FEC The following diagram illustrates the FEC-label binding information structure for a P2MP (Transit IPv4 Source type) LSP on a branch/ transit LSR: FEC (root 2.2.2.2, S=192.168.1.1, G=224.1.1.1): type: p2mp upstream: advertised: peer 192.168.0.1:0, label 16000 (local) downstream: received: peer 192.168.0.2:0, label 17000 (remote) peer 192.168.0.3:0, label 18000 (remote) Figure 10 The following diagram illustrates the FEC-label binding information structure for a similar MP2MP LSP on a branch/transit LSR: FEC (root 2.2.2.2, RP=192.168.9.9, G=224.1.1.1): type: mp2mp upstream: advertised: peer 192.168.0.1:0, label 16000 (local) received: peer 192.168.0.1:0, label 17000 (remote) downstream: advertised: peer 192.168.0.2:0, label 16001 (local), MBB role=active peer 192.168.0.3:0, label 16002 (local), MBB role=standby received: peer 192.168.0.2:0, label 17001 (remote) peer 192.168.0.3:0, label 18001 (remote) Figure 11 Raza, et al. Expires September 14, 2017 [Page 21] Internet-Draft YANG Data Model for MPLS mLDP March 2017 5.3.3. Capabilities state Like LDP, mLDP capabilities state comprise two types of information: o global: augments ldp:global/ldp:state/ldp:capability. o per-peer: augments ldp:peers/ldp:peer/ldp:state/ldp:capability 6. Notifications mLDP notification module consists of notification related to changes in the operational state of an mLDP FEC. 6.1. Base Following is a simplified graphical representation of the base data model for mLDP notifications: module: ietf-mpls-mldp notifications: +---n mpls-mldp-fec-event +--ro event-type? ldp:oper-status-event-type +--ro tree-type? multipoint-type +--ro root? inet:ip-address +--ro (lsp-key-type)? +--:(lsp-id) +--ro lsp-id? uint16 Figure 12 6.2. Extended Following is a simplified graphical representation of the extended data model for mLDP notifications: module: ietf-mpls-mldp augment /mldp:mpls-mldp-fec-event/mldp:lsp-key-type: +--:(source-group-based) +---- source-address? inet:ip-address +---- group-address? inet:ip-address Figure 13 Raza, et al. Expires September 14, 2017 [Page 22] Internet-Draft YANG Data Model for MPLS mLDP March 2017 7. Actions Currently, no RPCs/actions are defined for mLDP. 8. Open Items Following is a list of open items that are to be discussed and addressed in future revisions of this document: o Align operational state modeling with other routing protocols and [I-D.openconfig-netmod-opstate] o Specify default values for configuration parameters o Extend the "Configured Leaf LSPs" for various type of opaque-types o Extend mLDP notifications for other types of opaque values as well o Make MP LSP configuration and state model consistent 9. YANG Specification Following is the actual YANG definition (module) for mLDP constructs defined earlier in the document. 9.1. Base file "ietf-mpls-mldp@2017-03-12.yang" module ietf-mpls-mldp { namespace "urn:ietf:params:xml:ns:yang:ietf-mpls-mldp"; prefix "mldp"; import ietf-inet-types { prefix "inet"; } import ietf-routing { prefix "rt"; } import ietf-routing-types { prefix "rt-types"; } import ietf-mpls-ldp { Raza, et al. Expires September 14, 2017 [Page 23] Internet-Draft YANG Data Model for MPLS mLDP March 2017 prefix "ldp"; } organization "IETF MPLS Working Group"; contact "WG Web: WG List: WG Chair: Loa Andersson WG Chair: Ross Callon WG Chair: George Swallow Editor: Kamran Raza Editor: Rajiv Asati Editor: Xufeng Liu Editor: Santosh Esale Editor: Xia Chen Editor: Himanshu Shah "; description "This YANG module defines the essential components for the management of Multi-Protocol Label Switching (MPLS) Multipoint LDP (mLDP)."; revision 2017-03-12 { description "Initial revision."; reference "RFC XXXX: YANG Data Model for MPLS mLDP."; } Raza, et al. Expires September 14, 2017 [Page 24] Internet-Draft YANG Data Model for MPLS mLDP March 2017 /* * Typedefs */ typedef multipoint-type { type enumeration { enum p2mp { description "Point to multipoint."; } enum mp2mp { description "Multipoint to multipoint."; } } description "p2mp or mp2mp."; } /* * Groupings */ grouping mldp-capabilities { description "mLDP capabilities."; container p2mp { description "Configure point-to-multipoint capability."; leaf enable { type boolean; description "Enable point-to-multipoint."; } } container mp2mp { description "Configure multipoint-to-multipoint capability."; leaf enable { type boolean; description "Enable multipoint-to-multipoint."; } } container make-before-break { description "Configure make-before-break capability."; leaf enable { type boolean; description "Enable make-before-break."; Raza, et al. Expires September 14, 2017 [Page 25] Internet-Draft YANG Data Model for MPLS mLDP March 2017 } leaf switchover-delay { type uint16; units seconds; description "Switchover delay in seconds."; } leaf timeout { type uint16; units seconds; description "Timeout in seconds."; } } } // mldp-capabilities grouping mldp-fec-event { description "A mLDP FEC event."; leaf tree-type { type multipoint-type; description "p2mp or mp2mp."; } leaf root { type inet:ip-address; description "Root address."; } choice lsp-key-type { description "LSP ID based or source-group based ."; case lsp-id { leaf lsp-id { type uint16; description "ID to identify the LSP."; } } } } // mldp-fec-event grouping mldp-binding-label-peer-state-attributes { description "mLDP label binding per peer attributes."; leaf direction { type ldp:downstream-upstream; description Raza, et al. Expires September 14, 2017 [Page 26] Internet-Draft YANG Data Model for MPLS mLDP March 2017 "Downstream or upstream."; } leaf peer { type leafref { path "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:peers/ldp:peer/ldp:lsr-id"; } description "LDP peer from which this binding is received, or to which this binding is advertised."; } leaf advertisement-type { type ldp:advertised-received; description "Advertised or received."; } leaf label { type rt-types:mpls-label; description "Advertised (outbound) or received (inbound) label."; } leaf mbb-role { when "../direction = 'upstream'" { description "For upstream."; } type enumeration { enum none { description "MBB is not enabled."; } enum active { description "This LSP is active."; } enum inactive { description "This LSP is inactive."; } } description "The MBB status of this LSP."; } } // mldp-binding-label-peer-state-attributes grouping mldp-binding-label-state-attributes { description "mLDP label binding attributes."; leaf multipoint-type { Raza, et al. Expires September 14, 2017 [Page 27] Internet-Draft YANG Data Model for MPLS mLDP March 2017 type multipoint-type; description "The type of mutipoint, p2mp or mp2mp."; } list peer { key "direction peer advertisement-type"; description "List of advertised and received peers."; uses mldp-binding-label-peer-state-attributes; } // peer } // mldp-binding-label-state-attributes grouping mldp-ipv4-configured-lsp-roots { description "mLDP IPv4 roots containers."; container roots { description "Configured IPv4 multicast LSPs."; list root { key "root-address"; description "List of roots for configured multicast LSPs."; leaf root-address { type inet:ipv4-address; description "Root address."; } choice lsp-key-type { description "LSP ID based or source-group based ."; case lsp-id { container opaque-type-lspid { description "The type of opaque value element is the generic LSP identifier"; list lsp { key "lsp-id"; description "List of LSPs."; leaf lsp-id { type uint16; description "ID to identify the LSP."; } } // list lsp } // opaque-type-lspid Raza, et al. Expires September 14, 2017 [Page 28] Internet-Draft YANG Data Model for MPLS mLDP March 2017 } // case lsp-id } // choice lsp-key-type } // list root } // roots } // mldp-ipv4-configured-lsp-roots /* * Configuration data nodes */ augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:global/ldp:config/ldp:capability" { description "Augmentation for MLDP global capability."; container mldp { description "Multipoint capabilities."; uses mldp-capabilities; } } /* * Operational state data nodes */ augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:global/ldp:state/ldp:capability" { description "Augmentation for MLDP global capability."; container mldp { description "Multipoint capabilities."; uses mldp-capabilities; } } augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:peers/ldp:peer/ldp:state/" + "ldp:received-peer-state/ldp:capability" { description "Augmentation for MLDP received peer state capability."; container mldp { description "Multipoint capabilities."; container p2mp { description "Configure point-to-multipoint capability."; leaf enable { type boolean; description "Enable point-to-multipoint."; Raza, et al. Expires September 14, 2017 [Page 29] Internet-Draft YANG Data Model for MPLS mLDP March 2017 } } container mp2mp { description "Configure multipoint-to-multipoint capability."; leaf enable { type boolean; description "Enable multipoint-to-multipoint."; } } container make-before-break { description "Configure make-before-break capability."; leaf enable { type boolean; description "Enable make-before-break."; } } } // mldp } /* * Global augmentation */ augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:global" { description "MLDP global augmentation."; container mldp { description "mLDP attributes at per instance level. Defining attributes here does not enable any MP capabilities. MP capabilities need to be explicitly enabled under container capability."; container config { description "Configuration data."; leaf enable { type boolean; description "Enable mLDP."; } } container state { config false; description Raza, et al. Expires September 14, 2017 [Page 30] Internet-Draft YANG Data Model for MPLS mLDP March 2017 "Operational state data."; leaf enable { type boolean; description "Enable mLDP."; } } container address-families { description "Per-af params."; container ipv4 { description "IPv4 information."; container state { config false; description "Operational state data."; container roots { description "IPv4 multicast LSP roots."; list root { key "root-address"; description "List of roots for configured multicast LSPs."; leaf root-address { type inet:ipv4-address; description "Root address."; } leaf is-self { type boolean; description "This is the root."; } list reachability { key "address interface"; description "A next hop for reachability to root, as a RIB view."; leaf address { type inet:ipv4-address; description Raza, et al. Expires September 14, 2017 [Page 31] Internet-Draft YANG Data Model for MPLS mLDP March 2017 "The next hop address to reach root."; } leaf interface { type ldp:mpls-interface-ref; description "Interface connecting to next-hop."; } leaf peer { type leafref { path "../../../../../../../../../ldp:peers/" + "ldp:peer/ldp:lsr-id"; } description "LDP peer from which this next hop can be reached."; } } container bindings { description "mLDP FEC to label bindings."; container opaque-type-lspid { description "The type of opaque value element is the generic LSP identifier"; reference "RFC6388: Label Distribution Protocol Extensions for Point-to-Multipoint and Multipoint-to-Multipoint Label Switched Paths."; list fec-label { key "lsp-id"; description "List of FEC to label bindings."; leaf lsp-id { type uint32; description "ID to identify the LSP."; } uses mldp-binding-label-state-attributes; } // fec-label } // opaque-type-lspid } // bindings } // list root } // roots } // state Raza, et al. Expires September 14, 2017 [Page 32] Internet-Draft YANG Data Model for MPLS mLDP March 2017 container configured-leaf-lsps { description "Configured multicast LSPs."; container p2mp { description "Configured point-to-multipoint LSPs."; uses mldp-ipv4-configured-lsp-roots; } container mp2mp { description "Configured multipoint-to-multipoint LSPs."; uses mldp-ipv4-configured-lsp-roots; } } // configured-leaf-lsps } // ipv4 } // list address-family } // mldp } /* * Notifications */ notification mpls-mldp-fec-event { description "Notification event for a change of FEC status."; leaf event-type { type ldp:oper-status-event-type; description "Event type."; } uses mldp-fec-event; } } Figure 14 9.2. Extended file "ietf-mpls-mldp-extended@2017-03-12.yang" module ietf-mpls-mldp-extended { namespace "urn:ietf:params:xml:ns:yang:ietf-mpls-mldp-extended"; prefix "mldp-ext"; Raza, et al. Expires September 14, 2017 [Page 33] Internet-Draft YANG Data Model for MPLS mLDP March 2017 import ietf-inet-types { prefix "inet"; } import ietf-routing { prefix "rt"; } import ietf-mpls-ldp { prefix "ldp"; } import ietf-mpls-ldp-extended { prefix "ldp-ext"; } import ietf-mpls-mldp { prefix "mldp"; } organization "IETF MPLS Working Group"; contact "WG Web: WG List: WG Chair: Loa Andersson WG Chair: Ross Callon WG Chair: George Swallow Editor: Kamran Raza Editor: Rajiv Asati Editor: Xufeng Liu Editor: Santosh Esale Editor: Xia Chen Raza, et al. Expires September 14, 2017 [Page 34] Internet-Draft YANG Data Model for MPLS mLDP March 2017 Editor: Himanshu Shah "; description "This YANG module defines the essential components for the management of Multi-Protocol Label Switching (MPLS) Multipoint LDP (mLDP)."; revision 2017-03-12 { description "Initial revision."; reference "RFC XXXX: YANG Data Model for MPLS mLDP."; } /* * Features */ feature capability-mldp-hsmp { description "This feature indicates that the system allows to configure mLDP hub-and-spoke-multipoint capability."; } feature capability-mldp-node-protection { description "This feature indicates that the system allows to configure mLDP node-protection capability."; } feature mldp-mofrr { description "This feature indicates that the system supports mLDP Multicast only FRR (MoFRR)."; } feature per-peer-capability { description "This feature indicates that the system allows to configure mLDP capabilities at the per peer level."; } /* * Typedefs */ typedef route-distinguisher { Raza, et al. Expires September 14, 2017 [Page 35] Internet-Draft YANG Data Model for MPLS mLDP March 2017 type string { } description "Type definition for route distinguisher."; reference "RFC4364: BGP/MPLS IP Virtual Private Networks (VPNs)."; } typedef mofrr-role { type enumeration { enum none { description "MOFRR is not enabled."; } enum primary { description "This LSP is primary."; } enum backup { description "This LSP is backup."; } } description "This type represents the MOFRR (Multicast only FRR) role status of a LSP."; } /* * Groupings */ grouping mldp-ext-binding-label-state-attributes { description "mLDP label binding attributes."; leaf multipoint-type { type mldp:multipoint-type; description "The type of mutipoint, p2mp or mp2mp."; } list peer { key "direction peer advertisement-type"; description "List of advertised and received peers."; uses mldp:mldp-binding-label-peer-state-attributes; leaf mofrr-role { when "../direction = 'upstream'" { description "For upstream."; } Raza, et al. Expires September 14, 2017 [Page 36] Internet-Draft YANG Data Model for MPLS mLDP March 2017 type mofrr-role; description "The MOFRR status of this LSP."; } } // peer } // mldp-ext-binding-label-state-attributes grouping mldp-ext-capabilities { description "mLDP extended capabilities."; container hub-and-spoke { if-feature capability-mldp-hsmp; description "Configure hub-and-spoke-multipoint capability."; reference "RFC7140: LDP Extensions for Hub and Spoke Multipoint Label Switched Path"; leaf enable { type boolean; description "Enable hub-and-spoke-multipoint."; } } container node-protection { if-feature capability-mldp-node-protection; description "Configure node-protection capability."; reference "RFC7715: mLDP Node Protection."; leaf plr { type boolean; description "Point of Local Repair capable for MP LSP node protection."; } container merge-point { description "Merge Point capable for MP LSP node protection."; leaf enable { type boolean; description "Enable merge point capability."; } leaf targeted-session-teardown-delay { type uint16; units seconds; description "Targeted session teardown delay."; Raza, et al. Expires September 14, 2017 [Page 37] Internet-Draft YANG Data Model for MPLS mLDP March 2017 } } // merge-point } } // mldp-ext-capabilities grouping mldp-ipv6-configured-lsp-roots { description "mLDP IPv6 roots containers."; container roots { description "Configured IPv6 multicast LSPs."; list root { key "root-address"; description "List of roots for configured multicast LSPs."; leaf root-address { type inet:ipv6-address; description "Root address."; } choice lsp-key-type { description "LSP ID based or source-group based ."; case lsp-id { container opaque-type-lspid { description "The type of opaque value element is the generic LSP identifier"; list lsp { key "lsp-id"; description "List of LSPs."; leaf lsp-id { type uint16; description "ID to identify the LSP."; } } // list lsp } // opaque-type-lspid } // case lsp-id case source-group { container opaque-type-transit { description "The type of opaque value element is the transit IPv6 Raza, et al. Expires September 14, 2017 [Page 38] Internet-Draft YANG Data Model for MPLS mLDP March 2017 source."; list lsp { key "source-address group-address"; description "List of LSPs."; leaf source-address { type inet:ipv6-address; description "Source address."; } leaf group-address { type inet:ipv6-address-no-zone; description "Group address."; } } } } // case source-group } // choice lsp-key-type } // list root } // roots } // mldp-ipv6-configured-lsp-roots grouping mldp-ext-per-af-config-attibutes { description "mLDP per address family configuration attibutes."; container multicast-only-frr { if-feature mldp-mofrr; description "Multicast only FRR (MoFRR) policy."; leaf prefix-list { type ldp-ext:prefix-list-ref; description "Enables MoFRR for the specified access list."; } } // multicast-only-frr container recursive-fec { description "Recursive FEC policy."; leaf prefix-list { type ldp-ext:prefix-list-ref; description "Enables recursive FEC for the specified access list."; } } // recursive-for } // mldp-ext-per-af-config-attibutes /* Raza, et al. Expires September 14, 2017 [Page 39] Internet-Draft YANG Data Model for MPLS mLDP March 2017 * Configuration data nodes */ // Global capability config augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:global/ldp:config/ldp:capability/" + "mldp:mldp" { description "Augmentation for MLDP global capability."; uses mldp-ext-capabilities; } // Peer capability config augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:peers/ldp:peer/ldp:config/ldp:capability" { description "Augmentation for MLDP peer capability."; container mldp { if-feature per-peer-capability; description "mLDP capabilities."; uses mldp:mldp-capabilities; } } // IPv4 config augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/" + "mldp:ipv4" { description "Augmentation for MLDP IPv4 configuration."; container config { description "Configuration data."; uses mldp-ext-per-af-config-attibutes; } } // IPv4 configured-leaf-lsps config augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/" + "mldp:ipv4/mldp:configured-leaf-lsps/mldp:p2mp/mldp:roots/" + "mldp:root/mldp:lsp-key-type" { description "Augmentation for MLDP IPv4 configured-leaf-lsps configuration."; case source-group { container opaque-type-transit { description "The type of opaque value element is the transit IPv4 source."; Raza, et al. Expires September 14, 2017 [Page 40] Internet-Draft YANG Data Model for MPLS mLDP March 2017 list lsp { key "source-address group-address"; description "List of LSPs."; leaf source-address { type inet:ipv4-address; description "Source address."; } leaf group-address { type inet:ipv4-address-no-zone; description "Group address."; } } } } // case source-group } augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/" + "mldp:ipv4/mldp:configured-leaf-lsps/mldp:mp2mp/mldp:roots/" + "mldp:root/mldp:lsp-key-type" { description "Augmentation for MLDP IPv4 configured-leaf-lsps configuration."; case source-group { container opaque-type-transit { description "The type of opaque value element is the transit IPv4 source."; list lsp { key "source-address group-address"; description "List of LSPs."; leaf source-address { type inet:ipv4-address; description "Source address."; } leaf group-address { type inet:ipv4-address-no-zone; description "Group address."; } } } } // case source-group } Raza, et al. Expires September 14, 2017 [Page 41] Internet-Draft YANG Data Model for MPLS mLDP March 2017 // IPv6 config augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/" + "ipv6" { description "Augmentation for MLDP IPv4 configuration."; container config { description "Configuration data."; uses mldp-ext-per-af-config-attibutes; } } // Global forwarding-nexthop config augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:global/ldp-ext:forwarding-nexthop/" + "ldp-ext:interfaces/ldp-ext:interface/ldp-ext:address-family/" + "ldp-ext:config" { description "Augmentation for MLDP nexthop forwarding interface."; leaf mldp-disable { type boolean; description "Disable mLDP forwarding on the interface."; } } /* * Operational state data nodes */ // Global capability state augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:global/ldp:state/ldp:capability/" + "mldp:mldp" { description "Augmentation for MLDP global capability."; uses mldp-ext-capabilities; } // Peer capability state augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:peers/ldp:peer/ldp:state/ldp:capability" { description "Augmentation for MLDP peer capability."; container mldp { description "mLDP capabilities."; uses mldp:mldp-capabilities; } } Raza, et al. Expires September 14, 2017 [Page 42] Internet-Draft YANG Data Model for MPLS mLDP March 2017 // IPv4 state augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/" + "mldp:ipv4/mldp:state" { description "Augmentation for MLDP IPv4 state."; uses mldp-ext-per-af-config-attibutes; } // IPv4 state for per peer bindings augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/" + "mldp:ipv4/mldp:state/mldp:roots/mldp:root/mldp:bindings/" + "mldp:opaque-type-lspid/mldp:fec-label/mldp:peer" { description "Augmentation for MLDP IPv4 state."; leaf mofrr-role { when "../mldp:direction = 'upstream'" { description "For upstream."; } type mofrr-role; description "The MOFRR status of this LSP."; } } // IPv6 state augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/" + "ipv6/state" { description "Augmentation for MLDP IPv6 state."; uses mldp-ext-per-af-config-attibutes; } // Global forwarding-nexthop config augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:global/ldp-ext:forwarding-nexthop/" + "ldp-ext:interfaces/ldp-ext:interface/ldp-ext:address-family/" + "ldp-ext:state" { description "Augmentation for MLDP nexthop forwarding interface."; leaf mldp-disable { type boolean; description "Disable mLDP forwarding on the interface."; } Raza, et al. Expires September 14, 2017 [Page 43] Internet-Draft YANG Data Model for MPLS mLDP March 2017 } // Peer capability state augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:peers/ldp:peer/ldp:state/" + "ldp:received-peer-state/ldp:capability/mldp:mldp" { description "Augmentation for MLDP received peer state capability."; container hub-and-spoke { description "Configure hub-and-spoke-multipoint capability."; reference "RFC7140: LDP Extensions for Hub and Spoke Multipoint Label Switched Path"; leaf enable { type boolean; description "Enable hub-and-spoke-multipoint."; } } container node-protection { description "Configure node-protection capability."; reference "RFC7715: mLDP Node Protection."; leaf plr { type boolean; description "Point of Local Repair capable for MP LSP node protection."; } leaf merge-point { type boolean; description "Merge Point capable for MP LSP node protection."; } // merge-point } // node-protection } // IPv4 bindings state augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/" + "mldp:ipv4/mldp:state/mldp:roots/mldp:root/mldp:bindings" { description "Augmentation for MLDP IPv4 bindings."; container opaque-type-transit { description "The type of opaque value element is the transit IPv4 source."; Raza, et al. Expires September 14, 2017 [Page 44] Internet-Draft YANG Data Model for MPLS mLDP March 2017 reference "RFC6826: Multipoint LDP In-Band Signaling for Point-to-Multipoint and Multipoint-to-Multipoint Label Switched Paths."; list fec-label { key "source-address group-address " + "rd recur-root-address recur-rd"; description "List of FEC to label bindings."; leaf source-address { type inet:ip-address; description "Source address."; } leaf group-address { type inet:ip-address-no-zone; description "Group address."; } leaf rd { type route-distinguisher; description "Route Distinguisher."; reference "RFC7246: Multipoint Label Distribution Protocol In-Band Signaling in a Virtual Routing and Forwarding (VRF) Table Context."; } leaf recur-root-address { type inet:ip-address; description "Recursive root address."; reference "RFC6512: Using Multipoint LDP When the Backbone Has No Route to the Root"; } leaf recur-rd { type route-distinguisher; description "Route Distinguisher in the VPN-Recursive Opaque Value."; reference "RFC6512: Using Multipoint LDP When the Backbone Has No Route to the Root"; } uses mldp-ext-binding-label-state-attributes; Raza, et al. Expires September 14, 2017 [Page 45] Internet-Draft YANG Data Model for MPLS mLDP March 2017 } // fec-label } // opaque-type-transit container opaque-type-bidir { description "The type of opaque value element is the generic LSP identifier"; reference "RFC6826: Multipoint LDP In-Band Signaling for Point-to-Multipoint and Multipoint-to-Multipoint Label Switched Paths."; list fec-label { key "rp group-address rd recur-root-address recur-rd"; description "List of FEC to label bindings."; leaf rp { type inet:ip-address; description "RP address."; } leaf group-address { type inet:ip-address-no-zone; description "Group address."; } leaf rd { type route-distinguisher; description "Route Distinguisher."; reference "RFC7246: Multipoint Label Distribution Protocol In-Band Signaling in a Virtual Routing and Forwarding (VRF) Table Context."; } leaf recur-root-address { type inet:ip-address; description "Recursive root address."; reference "RFC6512: Using Multipoint LDP When the Backbone Has No Route to the Root"; } leaf recur-rd { type route-distinguisher; description Raza, et al. Expires September 14, 2017 [Page 46] Internet-Draft YANG Data Model for MPLS mLDP March 2017 "Route Distinguisher in the VPN-Recursive Opaque Value."; reference "RFC6512: Using Multipoint LDP When the Backbone Has No Route to the Root"; } uses mldp-ext-binding-label-state-attributes; } // fec-label } // opaque-type-bidir } // IPv6 bindings state augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/" + "ipv6/state/roots/root/bindings" { description "Augmentation for MLDP IPv6 bindings."; container opaque-type-transit { config false; description "The type of opaque value element is the transit IPv6 source."; reference "RFC6826: Multipoint LDP In-Band Signaling for Point-to-Multipoint and Multipoint-to-Multipoint Label Switched Paths."; list fec-label { key "source-address group-address " + "rd recur-root-address recur-rd"; description "List of FEC to label bindings."; leaf source-address { type inet:ip-address; description "Source address."; } leaf group-address { type inet:ip-address-no-zone; description "Group address."; } leaf rd { type route-distinguisher; description "Route Distinguisher."; reference "RFC7246: Multipoint Label Distribution Raza, et al. Expires September 14, 2017 [Page 47] Internet-Draft YANG Data Model for MPLS mLDP March 2017 Protocol In-Band Signaling in a Virtual Routing and Forwarding (VRF) Table Context."; } leaf recur-root-address { type inet:ip-address; description "Recursive root address."; reference "RFC6512: Using Multipoint LDP When the Backbone Has No Route to the Root"; } leaf recur-rd { type route-distinguisher; description "Route Distinguisher in the VPN-Recursive Opaque Value."; reference "RFC6512: Using Multipoint LDP When the Backbone Has No Route to the Root"; } uses mldp-ext-binding-label-state-attributes; } // fec-label } // opaque-type-transit container opaque-type-bidir { config false; description "The type of opaque value element is the generic LSP identifier"; reference "RFC6826: Multipoint LDP In-Band Signaling for Point-to-Multipoint and Multipoint-to-Multipoint Label Switched Paths."; list fec-label { key "rp group-address rd recur-root-address recur-rd"; description "List of FEC to label bindings."; leaf rp { type inet:ip-address; description "RP address."; } leaf group-address { type inet:ip-address-no-zone; description Raza, et al. Expires September 14, 2017 [Page 48] Internet-Draft YANG Data Model for MPLS mLDP March 2017 "Group address."; } leaf rd { type route-distinguisher; description "Route Distinguisher."; reference "RFC7246: Multipoint Label Distribution Protocol In-Band Signaling in a Virtual Routing and Forwarding (VRF) Table Context."; } leaf recur-root-address { type inet:ip-address; description "Recursive root address."; reference "RFC6512: Using Multipoint LDP When the Backbone Has No Route to the Root"; } leaf recur-rd { type route-distinguisher; description "Route Distinguisher in the VPN-Recursive Opaque Value."; reference "RFC6512: Using Multipoint LDP When the Backbone Has No Route to the Root"; } uses mldp-ext-binding-label-state-attributes; } // fec-label } // opaque-type-bidir } // IPv4 bindings opaque-type-lspid state augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/" + "mldp:ipv4/mldp:state/mldp:roots/mldp:root/mldp:bindings/" + "mldp:opaque-type-lspid/mldp:fec-label" { description "Augmentation for MLDP IPv4 bindings with opaque type LSP ID."; list recursive-fec { key "recur-root-address recur-rd"; description "List of recursive opaque values."; leaf recur-root-address { type inet:ip-address; Raza, et al. Expires September 14, 2017 [Page 49] Internet-Draft YANG Data Model for MPLS mLDP March 2017 description "Recursive root address."; reference "RFC6512: Using Multipoint LDP When the Backbone Has No Route to the Root"; } leaf recur-rd { type route-distinguisher; description "Route Distinguisher in the VPN-Recursive Opaque Value."; reference "RFC6512: Using Multipoint LDP When the Backbone Has No Route to the Root"; } uses mldp-ext-binding-label-state-attributes; } // fec-label } // IPv6 bindings opaque-type-lspid state augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/" + "ipv6/state/roots/root/bindings/opaque-type-lspid/" + "fec-label" { description "Augmentation for MLDP IPv6 bindings with opaque type LSP ID."; list recursive-fec { key "recur-root-address recur-rd"; config false; description "List of recursive opaque values."; leaf recur-root-address { type inet:ip-address; description "Recursive root address."; reference "RFC6512: Using Multipoint LDP When the Backbone Has No Route to the Root"; } leaf recur-rd { type route-distinguisher; description "Route Distinguisher in the VPN-Recursive Opaque Value."; reference "RFC6512: Using Multipoint LDP When the Backbone Has No Route to the Root"; Raza, et al. Expires September 14, 2017 [Page 50] Internet-Draft YANG Data Model for MPLS mLDP March 2017 } uses mldp-ext-binding-label-state-attributes; } // fec-label } /* * Per AF augmentation */ // IPv6 augmentation augment "/rt:routing/rt:control-plane-protocols/" + "ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families" { description "Augmentation for MLDP IPv6 address family."; container ipv6 { description "IPv6 information."; container state { config false; description "Operational state data."; container roots { description "IPv6 multicast LSP roots."; list root { key "root-address"; description "List of roots for configured multicast LSPs."; leaf root-address { type inet:ipv6-address; description "Root address."; } leaf is-self { type boolean; description "This is the root."; } list reachability { key "address interface"; description "A next hop for reachability to root, as a RIB view."; leaf address { type inet:ipv6-address; Raza, et al. Expires September 14, 2017 [Page 51] Internet-Draft YANG Data Model for MPLS mLDP March 2017 description "The next hop address to reach root."; } leaf interface { type ldp:mpls-interface-ref; description "Interface connecting to next-hop."; } leaf peer { type leafref { path "../../../../../../../../../ldp:peers/" + "ldp:peer/ldp:lsr-id"; } description "LDP peer from which this next hop can be reached."; } } container bindings { description "mLDP FEC to label bindings."; container opaque-type-lspid { description "The type of opaque value element is the generic LSP identifier"; reference "RFC6388: Label Distribution Protocol Extensions for Point-to-Multipoint and Multipoint-to-Multipoint Label Switched Paths."; list fec-label { key "lsp-id"; description "List of FEC to label bindings."; leaf lsp-id { type uint32; description "ID to identify the LSP."; } uses mldp-ext-binding-label-state-attributes; } // fec-label } // opaque-type-lspid } // bindings } // list root } // roots } // state Raza, et al. Expires September 14, 2017 [Page 52] Internet-Draft YANG Data Model for MPLS mLDP March 2017 container configured-leaf-lsps { description "Configured multicast LSPs."; container p2mp { description "Configured point-to-multipoint LSPs."; uses mldp-ipv6-configured-lsp-roots; } container mp2mp { description "Configured multipoint-to-multipoint LSPs."; uses mldp-ipv6-configured-lsp-roots; } } // configured-leaf-lsps } // ipv6 } /* * Global augmentation */ /* * Notifications */ augment "/mldp:mpls-mldp-fec-event/mldp:lsp-key-type" { description ""; case source-group-based { leaf source-address { type inet:ip-address; description "LSP source address."; } leaf group-address { type inet:ip-address; description "Multicast group address."; } } // case source-group } } Figure 15 Raza, et al. Expires September 14, 2017 [Page 53] Internet-Draft YANG Data Model for MPLS mLDP March 2017 10. Security Considerations This mLDP model shares the same security considerations as captured in LDP Yang model [I-D.ietf-mpls-ldp-yang]. 11. IANA Considerations This document does not extend mLDP protocol specifiction and hence there are no IANA considerations. Note to the RFC Editor: Please remove IANA section before the publication. 12. Acknowledgments The authors would like to acknowledge Ladislav Lhotka for his useful comments as the YANG Doctor. 13. References 13.1. Normative References [I-D.ietf-mpls-ldp-yang] Raza, K., Asati, R., Liu, X., Esale, S., Chen, X., and H. Shah, "YANG Data Model for MPLS LDP", draft-ietf-mpls-ldp- yang-00 (work in progress), November 2016. [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997, . [RFC5036] Andersson, L., Ed., Minei, I., Ed., and B. Thomas, Ed., "LDP Specification", RFC 5036, DOI 10.17487/RFC5036, October 2007, . [RFC5561] Thomas, B., Raza, K., Aggarwal, S., Aggarwal, R., and JL. Le Roux, "LDP Capabilities", RFC 5561, DOI 10.17487/RFC5561, July 2009, . [RFC6020] Bjorklund, M., Ed., "YANG - A Data Modeling Language for the Network Configuration Protocol (NETCONF)", RFC 6020, DOI 10.17487/RFC6020, October 2010, . Raza, et al. Expires September 14, 2017 [Page 54] Internet-Draft YANG Data Model for MPLS mLDP March 2017 [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, . [RFC6388] Wijnands, IJ., Ed., Minei, I., Ed., Kompella, K., and B. Thomas, "Label Distribution Protocol Extensions for Point- to-Multipoint and Multipoint-to-Multipoint Label Switched Paths", RFC 6388, DOI 10.17487/RFC6388, November 2011, . [RFC6389] Aggarwal, R. and JL. Le Roux, "MPLS Upstream Label Assignment for LDP", RFC 6389, DOI 10.17487/RFC6389, November 2011, . [RFC6512] Wijnands, IJ., Rosen, E., Napierala, M., and N. Leymann, "Using Multipoint LDP When the Backbone Has No Route to the Root", RFC 6512, DOI 10.17487/RFC6512, February 2012, . [RFC6536] Bierman, A. and M. Bjorklund, "Network Configuration Protocol (NETCONF) Access Control Model", RFC 6536, DOI 10.17487/RFC6536, March 2012, . [RFC6826] Wijnands, IJ., Ed., Eckert, T., Leymann, N., and M. Napierala, "Multipoint LDP In-Band Signaling for Point-to- Multipoint and Multipoint-to-Multipoint Label Switched Paths", RFC 6826, DOI 10.17487/RFC6826, January 2013, . [RFC7060] Napierala, M., Rosen, E., and IJ. Wijnands, "Using LDP Multipoint Extensions on Targeted LDP Sessions", RFC 7060, DOI 10.17487/RFC7060, November 2013, . [RFC7140] Jin, L., Jounay, F., Wijnands, IJ., and N. Leymann, "LDP Extensions for Hub and Spoke Multipoint Label Switched Path", RFC 7140, DOI 10.17487/RFC7140, March 2014, . [RFC7246] Wijnands, IJ., Ed., Hitchen, P., Leymann, N., Henderickx, W., Gulko, A., and J. Tantsura, "Multipoint Label Distribution Protocol In-Band Signaling in a Virtual Routing and Forwarding (VRF) Table Context", RFC 7246, DOI 10.17487/RFC7246, June 2014, . Raza, et al. Expires September 14, 2017 [Page 55] Internet-Draft YANG Data Model for MPLS mLDP March 2017 [RFC7438] Wijnands, IJ., Ed., Rosen, E., Gulko, A., Joorde, U., and J. Tantsura, "Multipoint LDP (mLDP) In-Band Signaling with Wildcards", RFC 7438, DOI 10.17487/RFC7438, January 2015, . [RFC7715] Wijnands, IJ., Ed., Raza, K., Atlas, A., Tantsura, J., and Q. Zhao, "Multipoint LDP (mLDP) Node Protection", RFC 7715, DOI 10.17487/RFC7715, January 2016, . 13.2. Informative References [I-D.ietf-rtgwg-policy-model] Shaikh, A., Shakir, R., D'Souza, K., and C. Chase, "Routing Policy Configuration Model for Service Provider Networks", draft-ietf-rtgwg-policy-model-01 (work in progress), April 2016. [I-D.iwijnand-mpls-mldp-multi-topology] Wijnands, I. and K. Raza, "mLDP Extensions for Multi Topology Routing", draft-iwijnand-mpls-mldp-multi- topology-03 (work in progress), June 2013. [I-D.openconfig-netmod-opstate] Shakir, R., Shaikh, A., and M. Hines, "Consistent Modeling of Operational State Data in YANG", draft-openconfig- netmod-opstate-01 (work in progress), July 2015. Appendix A. Additional Contributors Matthew Bocci Nokia matthew.bocci@nokia.com Authors' Addresses Kamran Raza Cisco Systems, Inc. Email: skraza@cisco.com Rajiv Asati Cisco Systems, Inc. Email: rajiva@cisco.com Raza, et al. Expires September 14, 2017 [Page 56] Internet-Draft YANG Data Model for MPLS mLDP March 2017 Sowmya Krishnaswamy Cisco Systems, Inc. Email: sowkrish@cisco.com Xufeng Liu Jabil Email: xufeng_liu@jabil.com Jeff Tantsura Email: jefftant.ietf@gmail.com Santosh Esale Juniper Networks Email: sesale@juniper.net Xia Chen Huawei Technologies Email: jescia.chenxia@huawei.com Loa Andersson Huawei Technologies Email: loa@pi.nu Himanshu Shah Ciena Corporation Email: hshah@ciena.com Raza, et al. Expires September 14, 2017 [Page 57]