<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE rfc [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">
]>
<?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
<!-- generated by https://github.com/cabo/kramdown-rfc version 1.7.39 (Ruby 3.4.9) -->
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" ipr="trust200902" docName="draft-ietf-teas-actn-poi-applicability-19" category="info" consensus="true" submissionType="IETF" tocInclude="true" sortRefs="true" symRefs="true" version="3">
  <!-- xml2rfc v2v3 conversion 3.33.0 -->
  <front>
    <title abbrev="ACTN POI">Applicability of Abstraction and Control of Traffic Engineered Networks (ACTN) to Packet Optical Integration (POI)</title>
    <seriesInfo name="Internet-Draft" value="draft-ietf-teas-actn-poi-applicability-19"/>
    <author initials="F." surname="Peruzzini" fullname="Fabio Peruzzini">
      <organization>FiberCop</organization>
      <address>
        <email>fabio.peruzzini@fibercop.com</email>
      </address>
    </author>
    <author initials="J.-F." surname="Bouquier" fullname="Jean-Francois Bouquier">
      <organization>Vodafone</organization>
      <address>
        <email>jeff.bouquier@vodafone.com</email>
      </address>
    </author>
    <author initials="I." surname="Busi" fullname="Italo Busi">
      <organization>Huawei</organization>
      <address>
        <email>italo.busi@huawei.com</email>
      </address>
    </author>
    <author initials="D." surname="King" fullname="Daniel King">
      <organization>Old Dog Consulting</organization>
      <address>
        <email>daniel@olddog.co.uk</email>
      </address>
    </author>
    <author initials="D." surname="Ceccarelli" fullname="Daniele Ceccarelli">
      <organization>Cisco</organization>
      <address>
        <email>daniele.ietf@gmail.com</email>
      </address>
    </author>
    <date year="2026" month="June" day="11"/>
    <area>Routing</area>
    <workgroup>TEAS Working Group</workgroup>
    <keyword>ACTN</keyword>
    <keyword>POI</keyword>
    <keyword>packet optical integration</keyword>
    <keyword>YANG</keyword>
    <keyword>DWDM</keyword>
    <abstract>
      <?line 131?>

<t>This document explores the applicability of the Abstraction and Control
of TE Networks (ACTN) architecture to Packet Optical Integration (POI)
within the context of IP/MPLS and optical internetworking. It examines
the YANG data models defined by the IETF that enable an ACTN-based
deployment architecture and highlights specific scenarios pertinent
to Service Providers.</t>
      <t>Existing IETF protocols and data models are identified for each
multi-technology scenario (packet over optical), particularly
emphasising the Multi-Domain Service Coordinator to Provisioning
Network Controller Interface (MPI) within the ACTN architecture</t>
    </abstract>
    <note removeInRFC="true">
      <name>About This Document</name>
      <t>
        The latest revision of this draft can be found at <eref target="https://IETF-TEAS-WG.github.io/actn-poi/draft-ietf-teas-actn-poi-applicability.html"/>.
        Status information for this document may be found at <eref target="https://datatracker.ietf.org/doc/draft-ietf-teas-actn-poi-applicability/"/>.
      </t>
      <t>
        Discussion of this document takes place on the
        Traffic Engineering Architecture and Signaling Working Group mailing list (<eref target="mailto:teas@ietf.org"/>),
        which is archived at <eref target="https://mailarchive.ietf.org/arch/browse/teas/"/>.
        Subscribe at <eref target="https://www.ietf.org/mailman/listinfo/teas/"/>.
      </t>
      <t>Source for this draft and an issue tracker can be found at
        <eref target="https://github.com/IETF-TEAS-WG/actn-poi"/>.</t>
    </note>
  </front>
  <middle>
    <?line 145?>

<section anchor="intro">
      <name>Introduction</name>
      <t>The full automation of management and control for Service Providers'
transport  networks, spanning IP/MPLS, optical, and microwave
technologies, is crucial to addressing customer demands for high-bandwidth
applications, such as ultra-fast  mobile broadband for 5G and fiber
connectivity services. The Abstraction and  Control of TE Networks (ACTN)
architecture and interfaces enable the automation  and efficient
operation of complex optical and IP/MPLS networks using standardized
interfaces and data models. This approach supports a broad spectrum of
network services that can be requested by upper-layer applications,
meeting diverse  service-level requirements from a network perspective,
such as physical diversity, latency, bandwidth, and topology.</t>
      <t>Packet Optical Integration (POI) represents an advanced application of
traffic engineering. In wide-area networks, packet networks based on the
Internet Protocol (IP), often augmented with Multiprotocol Label
Switching (MPLS) or Segment Routing  (SR), are typically implemented over
an optical transport network utilizing Dense Wavelength Division
Multiplexing (DWDM), occasionally with an optional Optical Transport
Network (OTN) layer.</t>
      <t>There are significant technical differences between the packet and optical technologies
(e.g., routers versus optical switches) and their associated network engineering
and planning approaches (e.g., inter-domain peering optimization in IP
networks versus managing physical impairments in DWDM systems or
operating on vastly different time scales). Additionally, customer
requirements often differ between packet and optical networks, and it is
common for Service Providers to use different vendors for each domain. As
a result, the operation of these complex packet and optical networks is
often siloed, as each technology domain requires specialized skill sets.</t>
      <t>As a consequence, in many existing network deployments, packet and optical networks are engineered and operated independently.</t>
      <t>This separation is inefficient for several reasons.
Firstly, integrating packet and optical
networks can significantly reduce capital expenditures (CAPEX) and
operational expenditures (OPEX).
Secondly, multi-technology topology insights can optimize troubleshooting (e.g., alarm correlation) and enhance network operation (e.g., coordination of maintenance events). Additionally, detailed inventory and planning information can also improve service assurance quality, such as detecting constraint violations or lack of resource diversity.
Thirdly, multi-technology traffic engineering enables more efficient use of
available network capacity (e.g., coordination of restoration).
Furthermore, provisioning workflows can be simplified or automated across
layers, facilitating capabilities such as bandwidth-on-demand and
streamlined maintenance activities.</t>
      <t>The ACTN framework facilitates seamless integration of packet and optical
networks across multiple technologies and vendors.
This is achieved through separated Provisioning Network Controllers (PNCs) for both packet and optical domains,
which hide the complexities of the technical differences between the packet and optical technologies while
providing sufficient abstract information that allows the Multi-Domain Service Coordinator (MDSC)
to provide multi-layer coordination between packet and optical networks.</t>
      <t>This document uses packet-based Traffic Engineered (TE) service
examples. These are described as "TE-path" in this document. Unless
otherwise stated, these TE services may be instantiated using
Resource Reservation Protocol (RSVP) Traffic Engineering (TE)-based or
Segment Routing Traffic Engineering (SR-TE)-based, forwarding plane
mechanisms.</t>
      <t>This document assumes familiarity with the ACTN architecture defined in
<xref target="RFC8453"/>, the TE topology model defined in <xref target="RFC8795"/>, and the
basic operation of IP/MPLS and optical transport networks.</t>
      <t>This document outlines key scenarios for Packet Optical Integration (POI)
from the perspective of the packet service layer and highlights the
necessary coordination between packet and optical layers to enhance POI
deployment and operation. These scenarios emphasize multi-domain packet
networks functioning as clients of optical networks.</t>
      <t>This document analyzes the scenario in which packet networks support
multi-domain TE paths. The optical networks may
consist of a DWDM network, an OTN network (without a DWDM layer), or a
multi-layer OTN/DWDM network. Additionally, DWDM networks can be either
fixed-grid or flexible-grid.</t>
      <t>Multi-technology and multi-domain scenarios, based on the reference
network described in <xref target="reference-network"/> and very relevant for Service
Providers, are described in <xref target="discovery"/> and <xref target="config"/>.</t>
      <t>For each scenario, existing IETF protocols and data models,
identified in <xref target="restconf"/> and <xref target="yang"/>, are analyzed with a particular
focus on the MPI in the ACTN architecture.</t>
      <t>For each multi-technology scenario, the document analyzes how to use the
interfaces and data models of the ACTN architecture.</t>
      <t>A summary of the gaps identified in this analysis is provided in
<xref target="conclusions"/>.</t>
      <t>Understanding the degree of standardization and identifying potential
gaps are crucial for evaluating the feasibility of integrating packet and
optical DWDM domains (with an optional OTN layer) from an end-to-end,
multi-vendor service provisioning perspective.</t>
      <section anchor="terms">
        <name>Terminology</name>
        <t>This document uses the ACTN terminology defined in <xref target="RFC8453"/>.</t>
        <t>In addition, this document uses the following terminology.</t>
        <dl>
          <dt>Customer service:</dt>
          <dd>
            <t>The end-to-end service from Customer Edge (CE) to CE.</t>
          </dd>
          <dt>Network service:</dt>
          <dd>
            <t>Per <xref target="RFC8309"/>, a network service provides
Connectivity between customer sites and the Internet or between
customer sites across the operator's network and across
the Internet. In the context of this document, a network service
is enabled by Provider Edge (PE) to PE configuration, including
both the network service layer (VRFs, RT import/export policies
configuration) and the network transport layer (e.g., RSVP-TE
Label Switched Paths (LSPs)). This includes the configuration
(on the PE side) of the interface towards the CE (e.g., VLAN, IP
address, routing protocol, etc.).</t>
          </dd>
          <dt>Technology domain:</dt>
          <dd>
            <t>Short for "switching technology domain", defined as "region" in
<xref target="RFC5212"/>, where the term "region" is applied to (GMPLS) control
domains.</t>
          </dd>
          <dt>PNC Domain:</dt>
          <dd>
            <t>A portion of the network controlled by one PNC instance, where
capabilities are defined by the technologies supported by both the PNC
instance and its managed network elements.</t>
          </dd>
          <dt>Optical PNC (O-PNC):</dt>
          <dd>
            <t>A PNC controlling an optical network domain.</t>
          </dd>
          <dt>Packet PNC (P-PNC):</dt>
          <dd>
            <t>A PNC controlling a packet network domain.</t>
          </dd>
          <dt>Muxponder:</dt>
          <dd>
            <t>An optical device that aggregates multiple lower-rate client signals
into a single higher-speed optical signal, combining multiplexing and
transponder functionalities to maximize network efficiency.</t>
          </dd>
          <dt>Port:</dt>
          <dd>
            <t>The physical entity that transmits and receives physical signals.</t>
          </dd>
          <dt>Interface:</dt>
          <dd>
            <t>A bidirectional link interface, as defined in <xref section="3.6.1" sectionFormat="of" target="RFC4397"/>.</t>
          </dd>
          <dt>Link:</dt>
          <dd>
            <t>A bidirectional data link, as defined in <xref section="3.5.1" sectionFormat="of" target="RFC4397"/>.</t>
          </dd>
          <dt>Intra-domain link:</dt>
          <dd>
            <t>A link between two adjacent nodes that belong to the same PNC domain.</t>
          </dd>
          <dt>Inter-domain link:</dt>
          <dd>
            <t>A link between two adjacent nodes that belong to different PNC domains.</t>
          </dd>
          <dt>Ethernet link:</dt>
          <dd>
            <t>A link between two Ethernet interfaces.</t>
          </dd>
          <dt>Single-technology Ethernet link:</dt>
          <dd>
            <t>An Ethernet link between two Ethernet interfaces on physically adjacent
IP routers.</t>
          </dd>
          <dt>Multi-technology Ethernet link:</dt>
          <dd>
            <t>An Ethernet link between two Ethernet interfaces on logically adjacent
IP routers, supported by two cross-technology Ethernet links
interconnected through an optical tunnel.</t>
          </dd>
          <dt>Cross-technology Ethernet link:</dt>
          <dd>
            <t>An Ethernet link connecting an Ethernet interface on an IP router to an
Ethernet interface on a physically adjacent optical node.</t>
          </dd>
          <dt>Inter-domain Ethernet link:</dt>
          <dd>
            <t>An Ethernet link between two Ethernet interfaces on physically adjacent
IP routers that belong to different P-PNC domains.</t>
          </dd>
          <dt>Single-technology intra-domain Ethernet link:</dt>
          <dd>
            <t>An Ethernet link between two Ethernet interfaces on physically adjacent
IP routers that belong to the same P-PNC domain.</t>
          </dd>
          <dt>Multi-technology intra-domain Ethernet link:</dt>
          <dd>
            <t>An Ethernet link between two Ethernet interfaces on logically adjacent
IP routers within the same P-PNC domain, supported by two
cross-technology Ethernet links interconnected through an optical tunnel.</t>
          </dd>
          <dt>IP link:</dt>
          <dd>
            <t>A link between two IP interfaces.</t>
          </dd>
          <dt>Inter-domain IP link:</dt>
          <dd>
            <t>An IP link supported by an inter-domain Ethernet link.</t>
          </dd>
          <dt>Single-technology intra-domain IP link:</dt>
          <dd>
            <t>An IP link supported by a single-technology intra-domain Ethernet link.</t>
          </dd>
          <dt>Multi-technology intra-domain IP link:</dt>
          <dd>
            <t>An IP link supported by a multi-technology intra-domain Ethernet link.</t>
          </dd>
        </dl>
      </section>
    </section>
    <section anchor="reference-network">
      <name>Reference Network Architecture</name>
      <t>This document examines various deployment scenarios for Packet and
Optical Integration (POI), where the ACTN hierarchy is implemented to
manage a multi-technology, multi-domain network comprising two optical
domains and two packet domains, as illustrated in <xref target="fig-ref-network"/>:</t>
      <figure anchor="fig-ref-network">
        <name>Reference Network</name>
        <artwork type="ascii-art"><![CDATA[
                              +----------+
                              |   MDSC   |
                              +-----+----+
                                    |
                  +-----------+-----+------+-----------+
                  |           |            |           |
             +----+----+ +----+----+  +----+----+ +----+----+
             | P-PNC 1 | | O-PNC 1 |  | O-PNC 2 | | P-PNC 2 |
             +----+----+ +----+----+  +----+----+ +----+----+
                  |           |            |           |
                  |           \            /           |
        +-------------------+  \          /  +-------------------+
   CE1 / PE1             BR1 \  |        /  / BR2             PE2 \ CE2
   o--/---o               o---\-|-------|--/---o               o---\--o
      \   :               :   / |       |  \   :               :   /
       \  : PKT domain 1  :  /  |       |   \  : PKT domain 2  :  /
        +-:---------------:-+   |       |    +-:---------------:--+
          :               :     |       |      :               :
          :               :     |       |      :               :
        +-:---------------:------+     +-------:---------------:--+
       /  :               :       \   /        :               :   \
      /   o...............o        \ /         o...............o    \
      \     optical domain 1       / \       optical domain 2       /
       \                          /   \                            /
        +------------------------+     +--------------------------+
]]></artwork>
      </figure>
      <t>The ACTN architecture, as defined in <xref target="RFC8453"/>, is utilized to manage
this multi-technology, multi-domain network. In this topology, each
Packet PNC (P-PNC) is responsible for controlling its respective packet
domain, while each Optical PNC (O-PNC) is tasked with managing its
optical domain. The packet domains controlled by the P-PNCs can represent
Autonomous Systems (ASes), as defined in <xref target="RFC1930"/>, or Interior
Gateway Protocol (IGP) areas within the same operator network.</t>
      <t>The IP routers between the packet domains can be either AS Boundary
Routers (ASBR) or Area Border Router (ABR): in this document, the
generic term Border Router (BR) is used to represent either an ASBR
or an ABR.</t>
      <t>The Multi-Domain Service Coordinator (MDSC) is responsible for
orchestrating the entire multi-domain, multi-technology network,
encompassing both packet and optical domains. A standardized interface,
the Multi-Domain Service Coordinator to Provisioning Network Controller
Interface (MPI), enables the MDSC to interact with various Provisioning
Network Controllers (O-PNCs and P-PNCs).</t>
      <t>The MPI interface provides the MDSC with an abstracted topology,
concealing technology-specific details of the network and selectively
hiding topology information based on the chosen abstraction policy. The
level of abstraction is determined by the configuration parameters of the
P-PNC and O-PNC, such as offering potential connectivity information
between any Provider Edge (PE) and Border Router (BR) within a packet
network.</t>
      <t>In the reference network of <xref target="fig-ref-network"/>, it is assumed that:</t>
      <ul spacing="normal">
        <li>
          <t>The domain boundaries of the packet and optical domains are
congruent. In other words, each optical domain exclusively supports
connectivity between IP routers within a single packet domain.</t>
        </li>
        <li>
          <t>There are no physical links directly connecting optical domains.
Inter-domain physical links exist only under the following conditions:  </t>
          <ul spacing="normal">
            <li>
              <t>between packet domains (i.e., between BRs belonging to
different packet domains): these links are called inter-domain
Ethernet or IP links within this document;</t>
            </li>
            <li>
              <t>between packet and optical domains (i.e., between routers and
optical nodes): these links are called cross-technology Ethernet links
within this document;</t>
            </li>
            <li>
              <t>between customer sites and the packet network (i.e., between
CE devices and PE routers): these links are called access
links within this document.</t>
            </li>
          </ul>
        </li>
        <li>
          <t>All the physical interfaces at inter-domain links are Ethernet
physical interfaces.</t>
        </li>
      </ul>
      <t>Scenarios using coherent optical interfaces on the IP routers are outside the scope of this document.</t>
      <t>This document analyzes scenarios in which all multi-technology IP links
supported by the optical network are intra-domain (intra-AS/intra-area),
such as PE-BR, PE-P, BR-P, and P-P IP links. Consequently, inter-domain
IP links are always single-technology connections, supported by
single-technology Ethernet links between physically adjacent IP routers.</t>
      <t>As described in <xref target="RFC7424"/>, in order to increase the bandwidth between two adjacent routers, multiple Ethernet links can be setup between adjacent routers using either Link Aggregation Groups (LAGs) <xref target="IEEE_802.1AX"/> or Equal Cost Multi-Path (ECMP) <xref target="RFC2991"/>.</t>
      <t>Therefore, if inter-domain links between optical domains exist, they
would be utilized to support multi-domain optical services, which fall
outside the scope of this document.</t>
      <t>The optical nodes within the optical domains can be either:</t>
      <ul spacing="normal">
        <li>
          <t>Wavelength Division Multiplexing (WDM) nodes, as defined in
<xref target="I-D.ietf-ccamp-optical-impairment-topology-yang"/>, with an integrated
Reconfigurable Optical Add-Drop Multiplexer (ROADM) function with or
without integrated optical transponders;</t>
        </li>
        <li>
          <t>OTN nodes, with an integrated OTN cross-connect function and with or
without integrated ROADM functions or optical transponders.</t>
        </li>
      </ul>
      <section anchor="mdsc-overview">
        <name>Multi-domain Service Coordinator (MDSC) functions</name>
        <t>The MDSC in <xref target="fig-ref-network"/> is responsible for coordinating multiple
packet and optical domains in a multi-domain, multi-technology
environment. It facilitates multi-layer and multi-domain L2/L3 VPN
network services as requested by the Operational Support System/Orchestration layer.</t>
        <t>From an implementation perspective, the functions associated with
MDSC described in <xref target="RFC8453"/> may be grouped differently.</t>
        <ol spacing="normal" type="1"><li>
            <t>The service-related and network-related functions are combined into a
single, monolithic implementation. This implementation manages
end-customer service requests received through the Customer MDSC
Interface (CMI) and adapts the corresponding network models. An example
of this architecture is illustrated in Figure 2 of <xref target="RFC8453"/>.</t>
          </li>
          <li>
            <t>An implementation may opt to separate the service-related and
network-related functions into distinct functional entities, as outlined
in <xref target="RFC8309"/> and Section 4.2 of <xref target="RFC8453"/>. In this approach, the
MDSC is decomposed into a top-level Service Orchestrator, which
interfaces with the customer through the Customer MDSC Interface (CMI),
and a Network Orchestrator, which interfaces southbound with the PNCs.
The interface between the Service Orchestrator and the Network
Orchestrator is not specified in <xref target="RFC8453"/>.</t>
          </li>
          <li>
            <t>Another implementation may choose to split the MDSC functions into a
"higher-level MDSC" (MDSC-H) and "lower-level MDSCs" (MDSC-Ls). The
MDSC-H is responsible for multi-technology coordination across packet and
optical domains, while the MDSC-Ls handle domain-specific coordination.
Specifically, an Optical MDSC-L manages multi-domain coordination between
the O-PNCs, and a Packet MDSC-L manages multi-domain coordination between
the P-PNCs. This approach is illustrated, for example, in Figure 9 of
<xref target="RFC8453"/>.</t>
          </li>
          <li>
            <t>An alternative implementation may choose to integrate the MDSC and
P-PNC functions in a single entity.</t>
          </li>
        </ol>
        <t>In current service provider network deployments, the MDSC's Northbound
Interface (NBI) typically connects to an OSS/Orchestration layer rather
than a Customer Network Controller (CNC). In this scenario, the MDSC is limited to performing Network
Orchestration functions, as described in <xref target="RFC8309"/> (point 2 above).
Consequently, the MDSC handles network service requests received from the
OSS and/or Orchestration.</t>
        <t>The functionality of the OSS and/or Orchestration layer, as well as its
interface with the MDSC, is typically operator-specific and falls outside
the scope of this draft. Therefore, this document assumes that the OSS
and/or Orchestration layer requests the MDSC to provision L2/L3 VPN
network services through mechanisms not covered in this document.</t>
        <t>There are two prominent workflow cases when the MDSC multi-technology
coordination is initiated:</t>
        <ul spacing="normal">
          <li>
            <t>Initiated by request from the OSS and/or Orchestration  layer to setup
L2/L3 VPN network services that require multi-layer/multi-domain
coordination;</t>
          </li>
          <li>
            <t>The MDSC initiates these workflows to perform multi-layer and
multi-domain optimizations and/or maintenance activities (e.g., rerouting
LSPs and their associated services when a resource, such as a fiber, is
placed in maintenance mode during a maintenance window). Unlike service
fulfilment, these workflows are not triggered by a network service
provisioning request from the OSS or Orchestration layer.</t>
          </li>
        </ul>
        <t>The latter workflow cases are outside the scope of this document.</t>
        <t>This document examines use cases in which multi-layer coordination is
initiated by a network service request from the OSS and/or Orchestration
layer.</t>
        <section anchor="vpn-overview">
          <name>Multi-domain L2/L3 VPN Network Services</name>
          <t><xref target="fig-vpn-topo"/> and <xref target="fig-vpn-path"/> provide an example of a hub &amp; spoke
multi-domain L2/L3 VPN with three PEs where the hub PE (PE13) and one
spoke
PE (PE14) are within the same packet domain, and the other spoke PE
(PE23) is within a different packet domain.</t>
          <figure anchor="fig-vpn-topo">
            <name>Multi-domain VPN topology example</name>
            <artwork type="ascii-art"><![CDATA[
     ------
    | CE13 |    Packet Domain 1              Packet Domain 2
     ------ ____________________            __________________
     ( |                         )         (                  )
    (  | PE13     P15       BR11  )       (  BR21       P24     )
   (   |____         ___       ____ )      ( ____      ___       )
  (    /    \ _ _ _ /   \ _ _ /    \________/    \    /   \     )
 (     \____/       \___/     \___ /        \____/    \_ _/     )
(   PE14  :\_ _               /      )  (    /  :      : \__     )
(    ____  :   \__ P16    ___/      )  (  __/_             _\__  )
 (  /    \  :  /   \- - -/    \__________/    \ :_ _ _ :_ /    \  )
 (  \____/     \___/     \____/     )  ( \____/           \____/ )
   (  / :   :    :         :  BR12  )   (   :    :     :     |  )
    (/                              )   ( BR22           PE23|   )
 ------ :   :    :         :       )      ( :     :    :     |  )
| CE14 | (__ ____ _________ _____)           (_____ ___ _ ------
 ------ :   :    :         :                :      :   : | CE23 |
                                                          ------
        :   :    :         :                :      :   :
       _ ___ ____ _________ ________         ______ ___ _______
      ( :   :    :         :        )       :      :   :       )
     (      ____  :      ____        )     (      ____  .. ..   )
    (   :  /    \_ _ _ _/    \ NE12   )   ( :    /    \ _    :   )
   (  NE11 \____/ :     \____/         )  ( NE21 \____/   \     )
   (    :  /    \    _ _ /  \          )  ( :     /        \ :   )
   (   ___/      \:_|        \____    )  (   .___/         _\__  )
   (  /    \_ _ /    \ _ _ _ /    \   )  (   /    \ _ _ _ /    \  )
    ( \____/    \____/       \____/  )    (  \____/       \____/  )
     ( NE13      NE14         NE15   )     (  NE22         NE23  )
      (_____________________________)       (___________________)

             Optical Domain 1                  Optical Domain 2


       _____  = Inter-domain links
       .. ..  = Cross-layer links
       _ _ _  = Intra-domain links
]]></artwork>
          </figure>
          <figure anchor="fig-vpn-path">
            <name>Multi-domain VPN TE paths example</name>
            <artwork type="ascii-art"><![CDATA[
     ------
    | CE13 |    Packet Domain 1              Packet Domain 2
     ------ ____________________            _________________
     ( |                         )         (                 )
    (  | PE13     P15       BR11  )       (  BR21       P24    )
   (   |____         ___       ____ )      ( ____     ___       )
  (    / H  \       /   \     /    \________/..  \   / ..\ ..  )
 (     \____/.....  \___/     \___ / .. .. ..___:/   \___/   : )
(   PE14  :      :              .. .. )  (             :        )
(    ____  :    _:_ P16   ____ :     )  ( ____  :          __:_ )
 (  / S  \  :  / ..\     /   ..__________/    \        :  /  S \ )
 (  \____/     \__:/     \____/     )  ( \____/ :         \____/ )
   (  / :   :     :          :BR12  )   (              :     |  )
    (/  :         :                 )   ( BR22  :        PE23|   )
 ------ :   :     :          :     )      (            :     | )
| CE14 |:(__ _____:__________ ___)           (__:______ __ ------
 ------ :   :      :         :                         :  | CE23 |
        :           :                           :          ------
        :   :       :        :                         :
       _:___________:________ ______         ___:______ _______
      ( :   :       :        :      )       (          : .. .. )
     (  :   ____    :    ____        )     (     :____          )
    (   :  / .. \.. : ../ .. \ NE12   )   (      /..  \      :   )
   (  NE11 \____/   :   \____/         )  ( NE21 \__:_/          )
   (    :           :                  )  (                  :  )
   (   _:__      ___:         ____    )  (    ____  : ..  ____  )
   (  / :..\..../...:\       /    \   )  (   /    \      /.. :\  )
    ( \____/    \____/       \____/  )    (  \____/      \____/  )
     ( NE13      NE14         NE15   )     (  NE22        NE23  )
      (_____________________________)       (__________________)

             Optical Domain 1                  Optical Domain 2


        H / S = Hub VRF / Spoke VRF

       .....  = Intra-domain TE Path 1 {PE13, P16, NE14, NE13, PE14}
       .. ..  = Inter-domain TE Path 2 {PE13, NE11, NE12, BR12,
                BR11, BR21, NE21, NE23, P24, PE23}
]]></artwork>
          </figure>
          <t>There are many options to implement multi-domain L2/L3 VPNs,
including:</t>
          <ol spacing="normal" type="1"><li>
              <t>BGP-Labeled Unicast (BGP-LU) (<xref target="RFC8277"/>)</t>
            </li>
            <li>
              <t>Inter-domain RSVP-TE</t>
            </li>
            <li>
              <t>Inter-domain SR-TE</t>
            </li>
          </ol>
          <t>This document explores inter-domain TE options where the TE tunnel model,
as defined in <xref target="I-D.ietf-teas-yang-te"/>, applies at the MPI for both
intra-domain and inter-domain TE configurations. The assessment of
alternative options is beyond the scope of this draft.</t>
          <t>It is also assumed that:</t>
          <ul spacing="normal">
            <li>
              <t>the bandwidth of each intra-domain TE path is managed by its
respective P-PNC;</t>
            </li>
            <li>
              <t>technology-specific mechanisms are employed for inter-domain TE path
stitching. In the case of inter-domain SR-TE, a Segment Identifier (SID)
is used in Segment Routing (SR) to define a segment (a portion of the
path) within a network. A binding SID, a special type of SID, acts as a
reference to a precomputed SR policy or path.</t>
            </li>
            <li>
              <t>each packet domain in <xref target="fig-vpn-topo"/> employs technology-specific
local protection mechanisms, such as Fast Reroute (FRR) for MPLS-TE or
Topology Independent Loop-Free Alternate (TI-LFA) for SR-TE. These
mechanisms operate with an awareness of the multi-technology TE path
properties, such as the Shared Risk Link Group (SRLG) path properties defined in <xref target="RFC8001"/>.</t>
            </li>
          </ul>
          <t>For inter-domain TE paths, it is assumed that each packet domain in
<xref target="fig-vpn-topo"/> and <xref target="fig-vpn-path"/> employs the same TE technology. The
stitching between two domains is achieved using inter-domain TE
mechanisms.</t>
          <t>In this scenario, a key function of the MDSC is to identify the
multi-domain and multi-layer TE paths for carrying L2/L3 VPN traffic
between PEs in different packet domains. The MDSC then relays this
information to the P-PNCs to ensure that the forwarding tables of the PEs
(e.g., VRF) are correctly configured, allowing the L2/L3 VPN traffic to
be routed over the designated multi-domain and multi-layer TE paths.</t>
          <t>The selection of the TE path should consider both the TE requirements and
the binding requirements of the L2/L3 VPN network service.</t>
          <t>In general, the binding requirements for a network service (e.g., L2/L3 VPN)
depend on the service isolation requirements (e.g., as discussed in <xref section="8" sectionFormat="of" target="RFC9543"/>)
and can be categorized into three main cases:</t>
          <ol spacing="normal" type="1"><li>
              <t>The L2/L3 VPN is bound to a set of dedicated TE tunnels, which neither
share resources with other services, nor compete for bandwidth with
other tunnels, ensuring deterministic latency performance.</t>
            </li>
            <li>
              <t>The L2/L3 VPN is bound to a set of dedicated TE tunnels, which can
compete for bandwidth with other tunnels.</t>
            </li>
            <li>
              <t>The L2/L3 VPN is bound to a set of TE tunnels which can be shared with other services.</t>
            </li>
            <li>
              <t>The customer does not require isolation and may request a VPN service
where the associated tunnels are shared across multiple VPNs.</t>
            </li>
          </ol>
          <t>For each TE path required to support the L2/L3 VPN network service,
it is possible that:</t>
          <ol spacing="normal" type="1"><li>
              <t>A TE path that meets the TE and binding requirements already
exists in the network.</t>
            </li>
            <li>
              <t>An existing TE path could be modified (e.g., through bandwidth
increase) to meet the TE and binding requirements:  </t>
              <ol spacing="normal" type="a"><li>
                  <t>The TE path characteristics can be modified only in the packet
layer.</t>
                </li>
                <li>
                  <t>One or more new underlay optical tunnels need to be setup to
support the requested changes of the overlay TE paths (multi-layer
coordination is required).</t>
                </li>
              </ol>
            </li>
            <li>
              <t>A new TE path needs to be setup to meet the TE and binding
requirements:  </t>
              <ol spacing="normal" type="a"><li>
                  <t>The new TE path reuses existing underlay optical tunnels;</t>
                </li>
                <li>
                  <t>One or more new underlay optical tunnels need to be setup to
support the setup of the new TE path  (multi-layer
coordination is required).</t>
                </li>
              </ol>
            </li>
          </ol>
          <t>This document examines scenarios in which a single TE path is used to
carry VPN traffic between PEs. Scenarios involving multiple parallel TE
paths for load-balancing VPN traffic between PEs are possible but are
beyond the scope of this document.</t>
        </section>
        <section anchor="path-computation-overview">
          <name>Multi-domain and Multi-layer Path Computation</name>
          <t>When establishing a new TE path, the MDSC is responsible for coordinating
the path computation across multiple layers and domains.</t>
          <t>Based on the MDSC's knowledge of the underlying network topology and
configuration, there are three possible approaches for multi-layer and multi-domain path
computation:</t>
          <ol spacing="normal" type="1"><li>
              <t>Full Summarization: In this approach, the MDSC maintains an abstracted
TE topology view of all its packet and optical underlying domains.  </t>
              <t>
In this case, the MDSC lacks sufficient TE topology information to
perform multi-layer/multi-domain path computation. It delegates the
P-PNCs and O-PNCs to compute local paths within their respective
domains, then uses the returned information to compute the optimal
multi-domain/multi-layer path.  </t>
              <t>
This approach presents an issue for the P-PNC, as it lacks the ability
to perform single-domain/multi-layer path computation. It cannot
retrieve topology information from the O-PNCs or delegate optical path
computation to the O-PNCs. A possible solution is to include a CNC
function within the P-PNC to request the MDSC for multi-domain
optical path computation, as shown in Figure 10 of <xref target="RFC8453"/>.  </t>
              <t>
Another solution could involve relying on the MDSC recursive hierarchy,
as defined in Section 4.1 of <xref target="RFC8453"/>, where each IP and optical
domain pair has a "lower-level MDSC" (MDSC-L) for multi-layer
correlation, and a "higher-level MDSC" (MDSC-H) for multi-domain
coordination.  </t>
              <t>
In this case, the MDSC-H obtains an abstract view of the underlying
multi-layer domain topologies from its MDSC-L. Each MDSC-L gets the
full IP domain topology from the P-PNC and an abstracted view of the
optical domain topology from its O-PNC. Topology abstraction occurs
at the MPIs between MDSC-L and O-PNC, as well as between MDSC-L and
MDSC-H.</t>
            </li>
            <li>
              <t>Partial summarization: In this approach, the MDSC has complete
visibility of the TE topology of the packet network domains and an
abstracted view of the TE topology of the optical network domains.  </t>
              <t>
The MDSC can then only perform multi-domain/single-layer path
computation for the packet layer, where the path can be computed
optimally for the two packet domains.  </t>
              <t>
The MDSC still needs to delegate the O-PNCs to perform local path
computation within their domains. It uses the information from the
O-PNCs and its TE topology view of the multi-domain packet layer to
perform multi-layer/multi-domain path computation.</t>
            </li>
            <li>
              <t>Full knowledge: In this approach, the MDSC has a complete and
enough detailed view of the TE topology of all the network domains
(both optical and packet).  </t>
              <t>
In such a case, the MDSC has all the information needed to perform
multi-domain/multi-layer path computation without relying on PNCs.  </t>
              <t>
This approach, however, may present scalability issues. As discussed
in
Section 2.2 of <xref target="I-D.ietf-teas-yang-path-computation"/>, performing
path
computation for optical networks in the MDSC is particularly
challenging,
as optimal paths also depend on vendor-specific optical attributes,
which may vary across domains if provided by different vendors.</t>
            </li>
          </ol>
          <t>This document examines scenarios where the MDSC adopts the partial
summarization approach to enable multi-domain and multi-layer path
computation.</t>
          <t>Typically, O-PNCs are responsible for optical path computation within
their respective domains. When setting up a network service, they must
consider connection requirements such as bandwidth, amplification,
wavelength continuity, and non-linear impairments that may impact the
network service path.</t>
          <t>The methods and types of path requirements and impairments, such as
those detailed in <xref target="I-D.ietf-ccamp-optical-impairment-topology-yang"/>,
used by the O-PNC for optical path computation, are not exposed at the
MPI and therefore are out of scope for this document.</t>
        </section>
      </section>
      <section anchor="packet-pnc-overview">
        <name>IP/MPLS Domain Controller and IP router Functions</name>
        <t>Each packet domain in <xref target="fig-ref-network"/>, corresponding to either an
IGP area or an Autonomous System (AS) within the same operator network,
is controlled by a packet domain controller (P-PNC).</t>
        <t>P-PNCs are responsible for establishing TE paths between any two PEs
or BRs within their controlled domains, as requested by the MDSC. They
also provide topology information to the MDSC to enable efficient
network coordination.</t>
        <t>For example, in inter-domain SR-TE, setting up a bidirectional
SR-TE path from PE13 in Domain 1 to PE23 in Domain 2, as shown in
<xref target="fig-vpn-path"/>, requires the MDSC to coordinate the following actions:</t>
        <ul spacing="normal">
          <li>
            <t>P-PNC1: Push a SID list to PE13, including the Binding SID
associated with the SR-TE path in Domain 2, with PE23 as the target
destination (forward direction).</t>
          </li>
          <li>
            <t>P-PNC2: Push a SID list to PE23, including the Binding SID
associated with the SR-TE path in Domain 1, with PE13 as the target
destination (reverse direction).</t>
          </li>
        </ul>
        <t>With reference to <xref target="fig-p-pnc"/>, P-PNCs are responsible for the
following:</t>
        <ol spacing="normal" type="1"><li>
            <t>To expose to MDSC their respective detailed TE topology</t>
          </li>
          <li>
            <t>To perform single-layer, single-domain local TE path computation,
when requested by the MDSC, between two PEs (for single-domain
end-to-end TE path) or between PEs and BRs for an inter-domain TE
path selected by the MDSC.</t>
          </li>
          <li>
            <t>To configure the routers in their respective domain to setup a TE
path;</t>
          </li>
          <li>
            <t>To configure the VRF and PE-CE interfaces (Service access points)
for the intra-domain and inter-domain network services requested by
the MDSC.</t>
          </li>
        </ol>
        <figure anchor="fig-p-pnc">
          <name>Domain Controller &amp; node Functions</name>
          <artwork type="ascii-art"><![CDATA[
          +------------------+            +------------------+
          |                  |            |                  |
          |      P-PNC1      |            |      P-PNC2      |
          |                  |            |                  |
          +--|-----------|---+            +--|-----------|---+
             | 1.TE      | 2.VPN             | 1.TE      | 2.VPN
             | Path      | Provisioning      | Path      | Provisioning
             | Config    |                   | Config    |
             V           V                   V           V
           +---------------------+         +---------------------+
      CE  / PE     TE path 1    BR\       / BR     TE path 2   PE \  CE
      o--/---o..................o--\-----/--o..................o---\--o
         \                         /     \                         /
          \        Domain 1       /       \       Domain 2        /
           +---------------------+         +---------------------+

                              End-to-end TE path
             <------------------------------------------------->
]]></artwork>
        </figure>
        <t>When requesting a new TE path setup, the MDSC provides the P-PNCs
with the explicit path to be created or modified. In other words, the
MDSC communicates the complete list of nodes involved in the path
(strict mode). The P-PNC is then responsible for setting up the
explicit TE path. For example:</t>
        <ul spacing="normal">
          <li>
            <t>with SR-TE, the P-PNC pushes to headend PE or BR the list of SIDs
to create the explicit SR-TE path, provided by the MDSC;</t>
          </li>
          <li>
            <t>with RSVP-TE, the P-PNC requests the headend PE or BR to start
signaling the explicit RSVP-TE path, provided by the MDSC.</t>
          </li>
        </ul>
        <t>To scale in large SR-TE packet domains, the MDSC can provide the P-PNC
with a loose path and per-domain TE constraints. The P-PNC can then
select the complete path within its domain.</t>
        <t>In this case, the P-PNC must signal back to the MDSC which path it has chosen, allowing the MDSC to track relevant resource utilization.</t>
        <t>From the <xref target="fig-vpn-path"/> example, the TE path requested by the MDSC
touches PE13 - P16 - BR12 - BR21 - PE23. P-PNC2 is aware of two
paths with the same topology metric, e.g., BR21 - P24 - PE23 and
BR21 - BR22 - PE23, but with different loads. It may prefer to steer
traffic on the latter as it is less loaded.</t>
        <t>For the purposes of this document, it is assumed that the MDSC always
provides the explicit list of all hops to the P-PNCs to set up or
modify the TE path.</t>
      </section>
      <section anchor="optical-pnc-overview">
        <name>Optical Domain Controller and NE Functions</name>
        <t>The optical network provides underlay connectivity services to
IP/MPLS networks. The packet and optical multi-layer coordination
is handled by the MDSC, as shown in <xref target="fig-ref-network"/>.</t>
        <t>The O-PNC is responsible to:</t>
        <ul spacing="normal">
          <li>
            <t>Provide the MDSC with an abstract TE topology view of its underlying
optical network resources;</t>
          </li>
          <li>
            <t>perform single-domain local path computation when requested by
the MDSC;</t>
          </li>
          <li>
            <t>Perform optical tunnel set up when requested by the MDSC.</t>
          </li>
        </ul>
        <t>The mechanisms used by the O-PNC to perform intra-domain topology
discovery and path setup are typically vendor-specific and outside
the scope of this document.</t>
        <t>Depending on the optical network type, TE topology abstraction, path
computation, and path setup can be single-layer (either OTN or DWDM)
or multi-layer OTN/DWDM. In the latter case, multi-layer coordination
between the OTN and DWDM layers is handled by the O-PNC.</t>
      </section>
    </section>
    <section anchor="mpi">
      <name>Interface Protocols and YANG Data Models for the MPIs</name>
      <t>This section describes general assumptions applicable to all MPI
interfaces between each PNC (Optical or Packet) and the MDSC, to
support the scenarios discussed in this document.</t>
      <section anchor="restconf">
        <name>RESTCONF Protocol at the MPIs</name>
        <t>The RESTCONF protocol, as defined in <xref target="RFC8040"/>, using the JSON
representation from <xref target="RFC7951"/>, is assumed to be used at these
interfaces. Additionally, extensions to RESTCONF, as defined in
<xref target="RFC8527"/>, to comply with the Network Management Datastore
Architecture (NMDA) from <xref target="RFC8342"/>, are assumed to be used at
these MPI and MDSC NBI interfaces.</t>
      </section>
      <section anchor="yang">
        <name>YANG Data Models at the MPIs</name>
        <t>The data models used on these interfaces are assumed to use the YANG
1.1 Data Modeling Language, as defined in <xref target="RFC7950"/>.</t>
        <t>This section describes the YANG data models applicable to the Packet
and Optical MPIs. Some of these YANG data models may be optional,
depending on the specific network configuration detailed in
<xref target="discovery"/> and <xref target="config"/>.</t>
        <section anchor="common-yang">
          <name>Common YANG Data Models at the MPIs</name>
          <t>As required in <xref target="RFC8040"/>, the "ietf-yang-library" YANG module
defined in <xref target="RFC8525"/> is used to allow the MDSC to discover the
set of YANG modules supported by each PNC at its MPI.</t>
          <t>Both Optical and Packet PNCs can use the following common topology
YANG data models at the MPI:</t>
          <ul spacing="normal">
            <li>
              <t>The Base Network Model, defined in the "ietf-network" YANG module
of <xref target="RFC8345"/>;</t>
            </li>
            <li>
              <t>The Base Network Topology Model, defined in the "ietf-network-topology"
YANG module of <xref target="RFC8345"/>, which augments the Base Network Model;</t>
            </li>
            <li>
              <t>The TE Topology Model, defined in the "ietf-te-topology" YANG
module of <xref target="RFC8795"/>, which augments the Base Network Topology
Model.</t>
            </li>
          </ul>
          <t>Optical and Packet PNCs can use the common TE Tunnel Model, defined
in the "ietf-te" YANG module of <xref target="I-D.ietf-teas-yang-te"/>, at the MPI.</t>
          <t>All common YANG data models are generic and augmented by
technology-specific YANG modules, as described in the following
sections.</t>
          <t>Both Optical and Packet PNCs can also use the Ethernet Topology
Model, defined in the "ietf-eth-te-topology" YANG module of
<xref target="I-D.ietf-ccamp-eth-client-te-topo-yang"/>, which augments the TE
Topology Model with Ethernet technology-specific information.</t>
          <t>Both Optical and Packet PNCs can use the following common
notifications YANG data models at the MPI:</t>
          <ul spacing="normal">
            <li>
              <t>Dynamic Subscription to YANG Events and Datastores over RESTCONF
as defined in <xref target="RFC8650"/>;</t>
            </li>
            <li>
              <t>Subscription to YANG Notifications for Datastores updates as
defined in <xref target="RFC8641"/>.</t>
            </li>
          </ul>
          <t>PNCs and MDSCs comply with subscription requirements as stated in
<xref target="RFC7923"/>.</t>
        </section>
        <section anchor="optical-yang">
          <name>YANG models at the Optical MPIs</name>
          <t>The Optical PNC can use the following technology-specific topology
YANG data models, which augment the generic TE Topology Model:</t>
          <ul spacing="normal">
            <li>
              <t>The Wavelength Switched Optical Network (WSON) Topology Model,
defined in the "ietf-wson-topology" YANG module of <xref target="RFC9094"/>;</t>
            </li>
            <li>
              <t>the Flexi-grid Topology Model, defined in the
"ietf-flexi-grid-topology" YANG module of
<xref target="I-D.ietf-ccamp-flexigrid-yang"/>;</t>
            </li>
            <li>
              <t>the OTN Topology Model, as defined in the "ietf-otn-topology" YANG
module of <xref target="I-D.ietf-ccamp-otn-topo-yang"/>.</t>
            </li>
          </ul>
          <t>The optical PNC can use the following technology-specific tunnel YANG
data models, which augments the generic TE Tunnel Model:</t>
          <ul spacing="normal">
            <li>
              <t>The WDM Tunnel Model, defined in the "ietf-wdm-tunnel" YANG module
of <xref target="I-D.ietf-ccamp-wdm-tunnel-yang"/>;</t>
            </li>
            <li>
              <t>the OTN Tunnel Model, defined in the "ietf-otn-tunnel" YANG module
of <xref target="I-D.ietf-ccamp-otn-tunnel-model"/>.</t>
            </li>
          </ul>
          <t>The optical PNC can use the generic Path Computation YANG RPC,
defined in the "ietf-te-path-computation" YANG module of
<xref target="I-D.ietf-teas-yang-path-computation"/>.</t>
          <t>Note that technology-specific augmentations of the generic path
computation RPC for WSON, Flexi-grid, and OTN path computation RPCs
have been identified as a gap.</t>
          <t>The optical PNC can use the following client signal YANG data models:</t>
          <ul spacing="normal">
            <li>
              <t>the Constant Bit Rate (CBR) Client Signal Model, defined in the
"ietf-trans-client-service" YANG module of
<xref target="I-D.ietf-ccamp-client-signal-yang"/>;</t>
            </li>
            <li>
              <t>the Ethernet Client Signal Model, defined in the
"ietf-eth-tran-service" YANG module of
<xref target="I-D.ietf-ccamp-client-signal-yang"/>.</t>
            </li>
          </ul>
        </section>
        <section anchor="packet-yang">
          <name>YANG data models at the Packet MPIs</name>
          <t>The Packet PNC can use the following technology-specific topology
YANG data models:</t>
          <ul spacing="normal">
            <li>
              <t>The L3 Topology Model, defined in the "ietf-l3-unicast-topology"
YANG module of <xref target="RFC8346"/>, which augments the Base Network Topology
Model;</t>
            </li>
            <li>
              <t>the Packet TE Topology Mode, defined in the "ietf-te-topology-packet"
YANG module of <xref target="I-D.ietf-teas-yang-l3-te-topo"/>, which augments the
generic TE
Topology Model;</t>
            </li>
            <li>
              <t>The MPLS-TE Topology Model, defined in the "ietf-te-mpls-topology"
YANG module of <xref target="I-D.ietf-teas-yang-te-mpls-topology"/>, which augments
the TE Packet
Topology Model with or without the L3 TE Topology Model, defined
in "ietf-l3-te-topology" YANG module of
<xref target="I-D.ietf-teas-yang-l3-te-topo"/>;</t>
            </li>
            <li>
              <t>the SR Topology Model, defined in the "ietf-sr-mpls-topology" YANG
module of <xref target="I-D.ietf-teas-yang-sr-te-topo"/>.</t>
            </li>
          </ul>
          <t>The Packet PNC can use the following technology-specific tunnel YANG
data models, which augments the generic TE Tunnel Model:</t>
          <ul spacing="normal">
            <li>
              <t>The MPLS-TE Tunnel Model, defined in the "ietf-te-mpls" YANG
modules of <xref target="I-D.ietf-teas-yang-te-mpls"/>;</t>
            </li>
            <li>
              <t>the SR-TE Tunnel Model which is to be defined as described in
<xref target="conclusions"/>.</t>
            </li>
          </ul>
          <t>The packet PNC can use the following network service YANG data
models:</t>
          <ul spacing="normal">
            <li>
              <t>L3VPN Network Model (L3NM), defined in the "ietf-l3vpn-ntw" YANG
module of <xref target="RFC9182"/>;</t>
            </li>
            <li>
              <t>L3NM TE Service Mapping, defined in the "ietf-l3nm-te-service-mapping"
YANG module of <xref target="I-D.ietf-teas-te-service-mapping-yang"/>;</t>
            </li>
            <li>
              <t>L2VPN Network Model (L2NM), defined in the "ietf-l2vpn-ntw" YANG
module of <xref target="RFC9291"/>;</t>
            </li>
            <li>
              <t>L2NM TE Service Mapping, defined in the "ietf-l2nm-te-service-mapping"
YANG module of <xref target="I-D.ietf-teas-te-service-mapping-yang"/>.</t>
            </li>
          </ul>
        </section>
      </section>
      <section anchor="pcep">
        <name>Path Computation Element Protocol (PCEP)</name>
        <t><xref target="RFC8637"/> examines the applicability of a Path Computation Element
(PCE) <xref target="RFC5440"/> and PCE Communication Protocol (PCEP) to the ACTN
framework. It further describes how the PCE architecture applies to
ACTN and lists the PCEP extensions needed to use PCEP as an ACTN
interface. The stateful PCE <xref target="RFC8231"/>, PCE-Initiation <xref target="RFC8281"/>,
stateful Hierarchical PCE (H-PCE) <xref target="RFC8751"/>, and PCE as a central
controller (PCECC) <xref target="RFC8283"/> are key extensions enabling the use of
PCE/PCEP for ACTN.</t>
        <t>Since PCEP supports path computation in both packet and optical
networks, it is well-suited for inter-layer path computation.
<xref target="RFC5623"/> describes a framework for applying the PCE-based
architecture to interlayer (G)MPLS traffic engineering. Furthermore,
section 6.1 of <xref target="RFC8751"/> outlines H-PCE applicability for
inter-layer or POI.</t>
        <t><xref target="RFC8637"/> lists various PCEP extensions that apply to ACTN. It also
lists the PCEP extension for the optical network and POI.</t>
        <t>Note that PCEP can be used in conjunction with the YANG data models
described in the rest of this document. Depending on whether ACTN is
deployed in a greenfield or brownfield, two options are possible:</t>
        <ol spacing="normal" type="1"><li>
            <t>The MDSC uses a single RESTCONF/YANG interface to each PNC to
discover all TE information and request TE tunnels. It may perform
full multi-layer path computation or delegate path computation to
the underlying PNCs.  </t>
            <t>
This approach is desirable for operators from a multi-vendor
integration perspective as it is simple. Only one type of
interface (RESTCONF) is needed, using the relevant YANG data models
depending on the operator use case considered. The benefits of
having only one protocol for the MPI between MDSC and PNC have
already been highlighted in <xref target="I-D.ietf-teas-yang-path-computation"/>.</t>
          </li>
          <li>
            <t>The MDSC uses the RESTCONF/YANG interface towards each PNC to
discover all the TE information and requests the creation of TE
tunnels. However, it uses PCEP for hierarchical path computation.  </t>
            <t>
As mentioned in Option 1, from an operator perspective, this
option can add integration complexity to have two protocols
instead of one unless the RESTCONF/YANG interface is added to an
existing PCEP deployment (brownfield scenario).</t>
          </li>
        </ol>
        <t><xref target="discovery"/> and <xref target="config"/> of this draft analyze the case where a
single
RESTCONF/YANG interface is deployed at the MPI (i.e., option 1
above).</t>
      </section>
    </section>
    <section anchor="discovery">
      <name>Inventory, Service and Network Topology Discovery</name>
      <t>In this scenario, the MDSC needs to discover the underlying PNCs:</t>
      <ul spacing="normal">
        <li>
          <t>the network topology, at both optical and IP layers, in terms of
nodes and links, including the access links, inter-domain IP links
as well as cross-technology Ethernet links;</t>
        </li>
        <li>
          <t>the optical tunnels supporting multi-technology intra-domain IP links;</t>
        </li>
        <li>
          <t>both intra-domain and inter-domain L2/L3 VPN network services
deployed within the network;</t>
        </li>
        <li>
          <t>the TE paths supporting those L2/L3 VPN network services;</t>
        </li>
        <li>
          <t>the hardware inventory information of IP and optical equipment.</t>
        </li>
      </ul>
      <t>The O-PNC and P-PNC could discover and report the hardware network
inventory information of the equipment used by the different
management layers. In the context of POI, the inventory information
of IP and optical equipment can complement the topology views and
facilitate the packet/optical multi-layer view, e.g., by providing a
mapping between the lowest-level link termination points (LTPs) in
the topology view and corresponding ports in the network inventory view.</t>
      <t>The MDSC could also discover the entire network inventory information
of both IP and optical equipment and correlate this information with
the links reported in the network topology.</t>
      <t>Reporting the entire inventory and detailed topology information of
packet and optical networks to the MDSC may present scalability
issues as a potential drawback. The analysis of the scalability of
this approach and mechanisms to address potential issues is outside
the scope of this document.</t>
      <t>Each PNC provides the MDSC the topology view of the domain it
controls, as described in <xref target="optical-topology-discovery"/> and
<xref target="packet-topology-discovery"/>. The MDSC uses this
information to discover the complete topology view of the multi-layer
multi-domain networks it controls.</t>
      <t>The MDSC should also maintain up-to-date inventory, service, and
network topology databases of IP and optical layers through notifications
over the MPIs from the PNCs when any network inventory, topology, or
service change occurs.</t>
      <t>It should also be possible to correlate information from IP and
optical layers (e.g., which port, lambda/Optical Tributary Signal
(OTSi), and direction are used by a specific IP service on the WDM node).</t>
      <t>In particular, for the cross-technology Ethernet links, it is key for
MDSC to
automatically correlate the information from the PNC network
databases about the physical ports from the routers (single link or
bundle links for LAG) to client ports in the
ROADM.</t>
      <t>The analysis of multi-layer fault management is outside the scope of
this document. However, the discovered information should be
sufficient for the MDSC to correlate optical and IP layer alarms to
speed-up troubleshooting easily.</t>
      <t>Alarms and event notifications are required between MDSC and PNCs so
that any network changes are reported almost in real-time to the MDSC
(e.g., node or link failure). As specified in <xref target="RFC7923"/>, MDSC must
subscribe to specific objects from PNC YANG datastores for
notifications.</t>
      <section anchor="optical-topology-discovery">
        <name>Optical Topology Discovery</name>
        <t>The WSON Topology Model and the Flexi-grid Topology model can be used
to report the DWDM network topology (e.g., WDM nodes and OMS links),
depending on whether the DWDM optical network is based on fixed-grid
or flexible-grid or a mix of fixed-grid and flexible-grid.</t>
        <t>It is worth noting that, as described in Appendix I of <xref target="ITU-T_G.694.1"/>,
a fixed-grid can also be described as a flexible grid
with constraints: for example, a 50GHz fixed-grid can be described as
a flexible-grid which supports only m=4 and values of n which are
only multiplier of 8.</t>
        <t>As a consequence:</t>
        <ul spacing="normal">
          <li>
            <t>A flexible-grid DWDM network topology can only be reported using
the Flexi-grid Topology model;</t>
          </li>
          <li>
            <t>A fixed-grid DWDM network topology, can be reported using either
the WSON Topology model or the Flexi-grid Topology model;</t>
          </li>
          <li>
            <t>A mixed fixed and flexible grid DWDM network topology can be
reported using either the Flexi-grid Topology model or both WSON
and Flexi-grid topology models.</t>
          </li>
        </ul>
        <t>Clarifying how both WSON and Flexi-grid topology models could be used
together (e.g., through multi-inheritance as described in
<xref target="I-D.ietf-teas-te-topology-profiles"/>)
has been identified as a gap.</t>
        <t>The OTN Topology Model is used to report the OTN network topology
(e.g., OTN switching nodes and links), when the OTN switching layer
is deployed within the optical domain.</t>
        <t>To allow the MDSC to discover the complete multi-layer and multi-domain
network topology and to correlate it with the hardware
inventory information, the O-PNCs report an abstract optical network
topology where:</t>
        <ul spacing="normal">
          <li>
            <t>one TE node is reported for each optical node deployed within the
optical network domain; and</t>
          </li>
          <li>
            <t>one TE link is reported for each OMS link and, optionally, for
each OTN link.</t>
          </li>
        </ul>
        <t>Since the MDSC delegates optical path computation to its underlay O-PNCs,
the following information can be abstracted and not reported at
the MPI:</t>
        <ul spacing="normal">
          <li>
            <t>the optical parameters required for optical path computation, such
as those detailed in
<xref target="I-D.ietf-ccamp-optical-impairment-topology-yang"/>;</t>
          </li>
          <li>
            <t>the underlay Optical Transmission Section (OTS) links and In-Line
Amplifiers (ILAs) of Optical Multiplex Section (OMS) links;</t>
          </li>
          <li>
            <t>the physical connectivity between the optical transponders and the
ROADMs.</t>
          </li>
        </ul>
        <t>The OTN Topology Model also reports the CBR client LTPs that
terminate the cross-technology Ethernet links: one CBR client LTP is
reported for
each CBR or multi-function client interface on the optical nodes (see
sections 4.4 and 5.1 of <xref target="I-D.ietf-ccamp-transport-nbi-app-statement"/>
for the description of multi-function
client interfaces).</t>
        <t>The Ethernet Topology Model reports the Ethernet client LTPs that
terminate the cross-technology Ethernet links: one Ethernet client LTP is
reported
for each Ethernet or multi-function client interface on the optical
nodes.</t>
        <t>The optical transponders and, optionally, the OTN access cards, are
abstracted at MPI by the O-PNC as Trail Termination Points (TTPs),
defined in <xref target="RFC8795"/>, within the optical network topology. This
abstraction is valid independently of the fact that optical
transponders are physically integrated within the same WDM node or
are physically located on a device external to the WDM node since it
both cases the optical transponders and the WDM node are under the
control of the same O-PNC and abstracted as a single WDM TE Node at the
O-MPI.</t>
        <t>The association between the Ethernet or CBR client LTPs terminating
the Ethernet cross-technology Ethernet links and the optical TTPs is
reported using
the Inter Layer Lock-id (ILL) identifiers, defined in <xref target="RFC8795"/>.</t>
        <t>For example, with a reference to <xref target="fig-optical-topo"/>, the ILL values X
and Y are
used to associate the client LTPs (7-0) in NE11 and (8-0) in NE12
with the corresponding optical TTPs (7) in NE11 and (8) in NE12,
respectively.</t>
        <figure anchor="fig-optical-topo">
          <name>Multi-layer optical topology discovery</name>
          <artwork type="ascii-art"><![CDATA[
         +----------------------------------------------------------+
        /                                                          /
       /            <X>                      <Y>                  /
      /    +------O------+                +------O------+        /
     /     |    (7-0)    |                |    (8-0)    |       /
    /      |             |                |             |      /
   /       |    NE11     |                |     NE12    |     /
  /        +-------------+                +-------------+    /
 /                Ethernet or OTN Topology (O-PNC 1)        /
+-----------------------------------------------------------+



         +----------------------------------------------------------+
        /    <X> (7)                            (8) <Y>            /
       /         ---                            ---               /
      /    +-----\ /-----+                +-----\ /-----+        /
     /     |      V      |                |      V      |       /
    /      |             |                |             |      /
   /       |    NE11     |                |    NE12     |     /
  /        +-------------+                +-------------+    /
 /                   Optical Topology (O-PNC 1)             /
+----------------------------------------------------------+

Legend:
=======
  O   LTP
 ---
 \ /  TTP
  V
<   > Inter-Layer Lock-id reported by the PNC
]]></artwork>
        </figure>
        <t>The intra-domain optical links are discovered by O-PNCs, using
mechanisms which are outside the scope of this document, and reported
at the MPIs within the optical network topology.</t>
        <t>In the case of a multi-layer DWDM/OTN network domain, multi-layer
intra-domain OTN links are supported by underlay WDM tunnels: this
relationship is reported by the mechanisms described in
<xref target="optical-path-discovery"/>.</t>
      </section>
      <section anchor="optical-path-discovery">
        <name>Optical Path Discovery</name>
        <t>The WDM Tunnel Model is used to report all the WDM tunnels
established within the optical network.</t>
        <t>When the OTN switching layer is deployed within the optical domain,
the OTN Tunnel Model is used to report all the OTN tunnels
established within the optical network.</t>
        <t>The Ethernet client signal model and the Transparent CBR client
signal model are used to report all the connectivity services
provided by the underlay optical tunnels between Ethernet or CBR
client LTPs, depending on whether the connectivity service is frame-based
or transparent. The underlay optical tunnels can be either WDM
tunnels or, when the optional OTN switching layer is deployed, OTN
tunnels.</t>
        <t>The WDM tunnels can be used to support either Ethernet or CBR client
signals or multi-layer intra-domain OTN links. In the latter case,
the hierarchical-link container, defined in <xref target="I-D.ietf-teas-yang-te"/>,
associates
the underlay WDM tunnel with the supported multi-layer intra-domain
OTN link, and it allows discovery of the multi-layer path supporting
all the connectivity services provided by the optical network.</t>
        <t>The O-PNCs report in their operational datastores all the Ethernet
and CBR client connectivities and all the optical tunnels deployed
within their optical domain regardless of the mechanisms being used to
set them up, such as the mechanisms described in
<xref target="multi-technology-link-setup"/>, as well
as other mechanism (e.g., static configuration), which are outside
the scope of this document.</t>
      </section>
      <section anchor="packet-topology-discovery">
        <name>Packet Topology Discovery</name>
        <t>The L3 Topology Model is used to report the IP network topology.</t>
        <t>The L3 Topology Model, SR Topology Model, TE Topology Model and the
TE Packet Topology Model are used together to report the SR-TE
network topology, as described in Figure 2 of
<xref target="I-D.ietf-teas-yang-sr-te-topo"/>.</t>
        <t>The TE Topology Model, TE Packet Topology Model and MPLS-TE Topology
Model are used together to report the MPLS-TE network topology, as
described in <xref target="I-D.ietf-teas-yang-te-mpls-topology"/>.</t>
        <t>As described in <xref target="I-D.ietf-teas-yang-l3-te-topo"/>, the relationship
between the IP network
topology and the MPLS-TE network topology depend on whether the two
network topologies are congruent or not: in the latter case, the L3
TE Topology Model is used, together with the L3 Topology Model to
provide the association between the two network topologies.</t>
        <t>To allow the MDSC to discover the complete multi-layer and multi-domain
network topology and to correlate it with the hardware
inventory information as well as to perform multi-domain TE path
computation, the P-PNCs report the full packet network, including all
the information that the MDSC requires to perform TE path
computation. In particular, one TE node is reported for each IP router
and one TE link is reported for each intra-domain IP link. The packet
topology also reports the IP LTPs terminating the inter-domain IP
links.</t>
        <t>The Ethernet Topology Model is used to report the intra-domain
Ethernet links supporting the intra-domain IP links as well as the
Ethernet LTPs that might terminate cross-technology Ethernet links,
inter-domain
Ethernet links or access links, as described in detail in
<xref target="inter-domain-link-discovery"/>
and in <xref target="multi-technology-link-discovery"/>.</t>
        <t>All the intra-domain Ethernet and IP links are discovered by the
P-PNCs, using mechanisms, such as Link Layer Discovery Protocol (LLDP)
<xref target="IEEE_802.1AB"/>, which are outside the scope of this document, and
reported at the MPIs within the Ethernet or the packet network topology.</t>
      </section>
      <section anchor="te-path-discovery">
        <name>TE Path Discovery</name>
        <t>This document assumes that the discovery of existing TE paths, including their
bandwidth, at the MPI is done using the generic TE tunnel YANG data
model, defined in <xref target="I-D.ietf-teas-yang-te"/>, with packet
technology-specific (e.g.,
MPLS-TE or SR-TE) augmentations.</t>
        <t>Note that technology-specific augmentations of the generic path TE
tunnel model for SR-TE path setup and discovery is outlined in
section 1 of <xref target="I-D.ietf-teas-yang-te"/> but are currently identified as a
gap in
<xref target="conclusions"/>.</t>
        <t>To enable MDSC to discover the full end-to-end TE path configuration,
the technology-specific augmentation of the <xref target="I-D.ietf-teas-yang-te"/>
should allow
the P-PNC to report the TE path within its domain (e.g., the SID list
assigned to an SR-TE path).</t>
        <t>For example, considering the L3VPN in <xref target="fig-vpn-topo"/>, the TE path 1 in
one
direction (PE13-P16-PE14) and the TE path in the reverse direction
(between PE14 and PE13) should be reported by the P-PNC1 to the MDSC
as TE primary and primary-reverse paths of the same TE tunnel
instance. The bandwidth of these TE paths represents the bandwidth
allocated by P-PNC1 to the two TE paths, which can be symmetric or
asymmetric in the two directions.</t>
        <t>The P-PNCs use the TE tunnel model to report, at the MPI, all the TE
paths established within their packet domain regardless of the
mechanism being used to set them up; i.e., independently on whether
the mechanisms described in <xref target="te-path-config"/> or other means, such as
static configuration, which are outside the scope of this document,
are used.</t>
      </section>
      <section anchor="inter-domain-link-discovery">
        <name>Inter-domain Link Discovery</name>
        <t>In the reference network of <xref target="fig-ref-network"/>, there are three types of
inter-domain links:</t>
        <ul spacing="normal">
          <li>
            <t>Inter-domain Ethernet links supporting inter-domain IP links
between two adjacent IP domains;</t>
          </li>
          <li>
            <t>Cross-technology Ethernet links between an IP domain and an adjacent
optical
domain;</t>
          </li>
          <li>
            <t>Access links between a CE device and a PE router.</t>
          </li>
        </ul>
        <t>All the three types of links are Ethernet links.</t>
        <t>It is worth noting that the P-PNC may not be aware whether an
Ethernet interface terminates a cross-technology Ethernet link, an
inter-domain
Ethernet link or an access link. The TE Topology Model supports the
discovery for all these types of links with no need for the P-PNC to
know the type of inter-domain link.</t>
        <t>There are two possible models to report the access links between CEs
and PEs: the TE Topology Model, defined in <xref target="RFC8795"/>, or the Service
Attachment Points (SAP) Model, defined in  <xref target="RFC9408"/>.</t>
        <t>Although the discovery of access links is outside the scope of this
document, clarifying the relationship between these two models has
been identified as a gap.</t>
        <t>The inter-domain Ethernet links and cross-technology Ethernet links are
discovered
by the MDSC using the plug-id attribute, as described in section 4.3
of <xref target="RFC8795"/>.</t>
        <t>A more detailed description of how the plug-id can be used to discover
inter-domain links is also provided in section 5.1.4 of
<xref target="I-D.ietf-ccamp-transport-nbi-app-statement"/>.</t>
        <t>The plug-id attribute can also be used to discover the access-links,
but the analysis of the access-link discovery is outside the scope of
this document.</t>
        <t>This document considers the following two options for discovering
inter-domain links:</t>
        <ol spacing="normal" type="1"><li>
            <t>Static configuration</t>
          </li>
          <li>
            <t>LLDP <xref target="IEEE_802.1AB"/> automatic discovery</t>
          </li>
        </ol>
        <t>Other link discovery options are possible but not described in this
document.</t>
        <t>As outlined in <xref target="I-D.ietf-ccamp-transport-nbi-app-statement"/>, the
encoding of the plug-id namespace and the specific LLDP information
reported within the plug-id value, such as the Chassis ID and Port ID
mandatory TLVs, is implementation-specific and needs to be consistent
across all PNCs within the network.</t>
        <t>The static configuration requires an administrative burden to
configure network-wide unique identifiers, making it more viable for
inter-domain Ethernet links. For cross-technology Ethernet links, the
automatic discovery solution based on LLDP snooping is preferable when
possible.</t>
        <t>The routers exchange standard LLDP packets as defined in <xref target="IEEE_802.1AB"/>,
and the optical nodes snoop the LLDP packets received from the local
Ethernet interface and report the extracted information, such as the
Chassis ID, Port ID, and System Name TLVs, to the O-PNCs.</t>
        <t>Note that the optical nodes do not actively participate in the LLDP
packet exchange and do not send any LLDP packets.</t>
        <section anchor="cross-technology-link-discovery">
          <name>Cross-technology Ethernet link Discovery</name>
          <t>The MDSC can discover a cross-technology Ethernet link by matching
the plug-id values of the two LTPs reported by adjacent O-PNC and
P-PNCs. In case LLDP snooping is used, the P-PNC reports the LLDP
information sent by the corresponding Ethernet interface on the IP
router, while the O-PNC reports the LLDP information received by the
corresponding Ethernet interface on the optical node, e.g., between
LTP 5-0 on PE13 and LTP 7-0 on NE11, as shown in
<xref target="fig-cross-technology-link"/>.</t>
          <figure anchor="fig-cross-technology-link">
            <name>Cross-technology Ethernet link discovery</name>
            <artwork type="ascii-art"><![CDATA[
        +-----------------------------------------------------------+
       /             Ethernet Topology (P-PNC)                     /
      /    +-------------+                +-------------+         /
     /     |    PE13     |                |    BR11     |        /
    /      |             |                |             |       /
   /       |    (5-0)    |                |    (6-0)    |      /
  /        +------O------+                +------O------+     /
 /       {PE13,5} ^                              ^ {BR11,6}  /
+-----------------:------------------------------:----------+
                  :                              :
                  :                              :
                  :                              :
                  :                              :
         +--------:------------------------------:------------------+
        /         :                              :                 /
       / {PE13,5} v                              v {BR11,6}       /
      /    +------O------+                +------O------+        /
     /     |    (7-0)    |                |    (8-0)    |       /
    /      |             |                |             |      /
   /       |    NE11     |                |     NE12    |     /
  /        +-------------+                +-------------+    /
 /                Ethernet or OTN Topology (O-PNC)          /
+----------------------------------------------------------+

  O   LTP
<...> Link discovered by the MDSC
{   } LTP Plug-id reported by the PNC
]]></artwork>
          </figure>
          <t>As described in <xref target="optical-topology-discovery"/>, the LTP terminating
a cross-technology Ethernet link is reported by an O-PNC in the
Ethernet topology, the OTN topology model, or both, depending on the
type of corresponding physical port on the optical node.</t>
          <t>It is worth noting that the discovery of cross-technology Ethernet
links is based solely on the LLDP information sent by the Ethernet
interfaces of the routers and snooped by the Ethernet interfaces of
the optical nodes. Therefore, the MDSC can discover these links even
before optical paths, supporting overlay multi-technology IP links,
are set up.</t>
        </section>
        <section anchor="ip-inter-domain-link-discovery">
          <name>Inter-domain IP Link Discovery</name>
          <t>The MDSC can discover an inter-domain Ethernet link supporting an
inter-domain IP link by matching the plug-id values of the two
Ethernet LTPs reported by adjacent P-PNCs. The P-PNCs report the
LLDP information being sent and received from the corresponding
Ethernet interfaces, e.g., between Ethernet LTP 3-1 on BR11 and
Ethernet LTP 4-1 on BR21, as shown in <xref target="fig-inter-domain-link"/>.</t>
          <figure anchor="fig-inter-domain-link">
            <name>Inter-domain Ethernet and IP link discovery</name>
            <artwork type="ascii-art"><![CDATA[
        +--------------------------+     +-------------------------+
       /  IP Topology (P-PNC 1)   /     /  IP Topology (P-PNC 2)  /
      /   +-------------+        /     /   +-------------+       /
     /    |    BR11     |       /     /    |    BR21     |      /
    /     |        (3-2)O<................>O(4-2)        |     /
   /      |             |\    /     /     /|             |    /
  /       +-------------+|   /     /      |+-------------+   /
 /                       |  /     /       |                 /
+------------------------|-+     +-------------------------+
                         |                |
          Supporting LTP |                | Supporting LTP
                         |                |
                         |                |
          +--------------|----------+    +|------------------------+
         /               V         /    / V                       /
        / +-------------+/        /    /  \+-------------+       /
       /  |     {1}(3-1)O<................>O(4-1){1}     |      /
      /   |             |\      /    /    /|             |     /
     /    |    BR11     |V(*)  /    /  (*)V|     BR21    |    /
    /     |             |/    /    /      \|             |   /
   /      |     {2}(3-0)O<~~~~~~~~~~~~~~~~>O(4-0){3}     |  /
  /       +-------------+   /    /         +-------------+ /
 / Eth. Topology (P-PNC 1) /    / Eth. Topology (P-PNC 2) /
+-------------------------+    +-------------------------+

Notes:
=====
(*) Supporting LTP
{1} {BR11,3,BR21,4}
{2} {BR11,3}
{3} {BR21,4}

Legend:
=======
  O   LTP
----> Supporting LTP
<...> Link discovered by the MDSC
<~~~> Link inferred by the MDSC
{   } LTP Plug-id reported by the PNC
]]></artwork>
          </figure>
          <t>Different information is required to be encoded by the P-PNC within
the plug-id attribute of the Ethernet LTPs to discover cross-technology
Ethernet
links and inter-domain Ethernet links.</t>
          <t>If the P-PNC does not know a priori whether an Ethernet interface
on an IP router terminates a cross-technology Ethernet link or an
inter-domain Ethernet link, it must report at the MPI two Ethernet
LTPs representing the same Ethernet interface, e.g., both Ethernet
LTP 3-0 and Ethernet LTP 3-1, supported by LTP 3-0, as shown in
<xref target="fig-inter-domain-link"/>.</t>
          <ul spacing="normal">
            <li>
              <t>The physical Ethernet LTP (e.g., LTP 3-0 in BR11, as shown in
<xref target="fig-inter-domain-link"/>) represents the physical adjacency between
the Ethernet interface on an IP router and the Ethernet interface on
its physically adjacent node. This node can be either an IP router
(in the case of a single-technology Ethernet link) or an optical node
(in the case of a cross-technology Ethernet link). Therefore, as
described in <xref target="cross-technology-link-discovery"/>, the P-PNC reports,
within the plug-id attribute of this LTP, the LLDP information sent
by the corresponding Ethernet interface on the IP router, such as
{BR11,3} and {BR21,4} plug-id values reported by the Ethernet LTP
3-0 on BR11 and the Ethernet LTP 4-0 on BR21, as shown in
<xref target="fig-inter-domain-link"/>.</t>
            </li>
            <li>
              <t>The logical Ethernet LTP (e.g., LTP 3-1 in BR11, as shown in
<xref target="fig-inter-domain-link"/>), supported by a physical Ethernet LTP (e.g.,
LTP 3-0 in BR11, as shown in <xref target="fig-inter-domain-link"/>), is used to
discover the logical adjacency between Ethernet interfaces on IP routers,
which can be either single-technology or multi-technology. Therefore,
the P-PNC reports, within the plug-id attribute of this LTP, the LLDP
information sent and received by the corresponding Ethernet interface
on the IP router, such as the {BR11,3,BR21,4} plug-id values reported
by the Ethernet LTP 3-1 on BR11 and the Ethernet LTP 4-1 on BR21, as
shown in <xref target="fig-inter-domain-link"/>.</t>
            </li>
          </ul>
          <t>It is worth noting that in the case of inter-domain Ethernet links,
the MDSC cannot discover, using the LLDP information reported in the
plug-id attributes, the physical adjacency between two Ethernet
interfaces on physically adjacent IP routers, because these plug-id
values do not match, such as the {BR11,3} and {BR21,4} plug-id values
shown in <xref target="fig-inter-domain-link"/>. However, the MDSC may infer the
physical intra-domain Ethernet links if it knows a priori, using
mechanisms outside the scope of this document, that the Ethernet
interfaces on the IP routers either terminate a cross-technology or
single-technology (intra-domain or inter-domain) Ethernet link, e.g.,
as shown in <xref target="fig-inter-domain-link"/>.</t>
          <t>The P-PNC can omit to report the physical Ethernet LTPs when it
knows, through mechanisms outside the scope of this document, that
the corresponding Ethernet interfaces terminate inter-domain Ethernet
links.</t>
          <t>The MDSC can then discover an inter-domain IP link between the two IP
LTPs supported by the two Ethernet LTPs terminating an inter-domain
Ethernet link, discovered as described in
<xref target="ip-inter-domain-link-discovery"/>,
e.g., between IP LTP 3-2 on BR21 and IP LTP 4-2 on BR22, supported
respectively by Ethernet LTP 3-1 on BR11 and Ethernet LTP 4-1 on BR21,
as shown in <xref target="fig-inter-domain-link"/>.</t>
        </section>
      </section>
      <section anchor="multi-technology-link-discovery">
        <name>Multi-technology IP Link Discovery</name>
        <t>A multi-technology intra-domain IP link and its supporting
multi-technology
intra-domain Ethernet link are discovered by the P-PNC like any other
intra-domain IP and Ethernet links, as described in
<xref target="packet-topology-discovery"/>, and
reported at the MPI within the packet and the Ethernet network
topologies, e.g., as shown in <xref target="fig-multi-technology-link"/>.</t>
        <figure anchor="fig-multi-technology-link">
          <name>Multi-technology intra-domain Ethernet and IP link discovery</name>
          <artwork type="ascii-art"><![CDATA[
        +-----------------------------------------------------------+
       /                    IP Topology (P-PNC 1)                  /
      /    +---------+                        +---------+         /
     /     |  PE13   |                        |   BR11  |        /
    /      |    (5-2)O<======================>O(6-2)    |       /
   /       |         |              |         |         |      /
  /        +---------+              |         +---------+     /
 /                                  |                        /
+-----------------------------------|-----------------------+
                                    |
                                    | Supporting Link
                                    |
        +---------------------------|-------------------------------+
       / Ethernet Topology (P-PNC 1)|                              /
      /    +-------------+          |     +-------------+         /
     /     |    PE13     |          V     |    BR11     |        /
    /      |        (5-1)O<==============>O(6-1)        |       /
   /       |    (5-0)    |\              /|    (6-0)    |      /
  /        +------O------+|(*)        (*)|+------O------+     /
 /                ^ \<----+              +----->/^           /
+-----------------:------------------------------:----------+
                  :                              :
                  :                              :
                  :                              :
        +---------:------------------------------:------------------+
       /          :   Ethernet or OTN Topology   :                 /
      /           V          (O-PNC 1)           V                /
     /     +------O------+    ETH/CBR     +------O------+        /
    /      |    (7-0)    |  client sig.   |    (8-0)    |       /
   /       |      X----------+-------------------X      |      /
  /        |    NE11     |   |            |     NE12    |     /
 /         +-------------+   |            +-------------+    /
+----------------------------|------------------------------+
                             | Underlay
                             | tunnel
                             |
         +----------------------------------------------------------+
        /        (7)         |                  (8)                /
       /         ---         |                  ---               /
      /    +-----\ /-----+   v            +-----\ /-----+        /
     /     |      V      |                |      V      |       /
    /      |      X======|================|======X      |      /
   /       |    NE11     |  Opt. Tunnel   |    NE12     |     /
  /        +-------------+                +-------------+    /
 /                   Optical Topology (O-PNC 1)             /
+----------------------------------------------------------+

Notes:
=====
(*) Supporting LTP

Legend:
=======
  O   LTP
 ---
 \ /  TTP
  V
----> Supporting LTP or Supporting Link or Underlay tunnel
<===> Link discovered by the PNC and reported at the MPI
<...> Link discovered by the MDSC
x---x Ethernet/CBR client signal
X===X Optical tunnel
]]></artwork>
        </figure>
        <t>The Ethernet interface 5 on the P13 router is terminating two Ethernet
abstract links:</t>
        <ul spacing="normal">
          <li>
            <t>The multi-technology intra-domain Ethernet link between logical
Ethernet LTP 5-1 on PE13 and the logical Ethernet LTP 6-1 on BR11;</t>
          </li>
          <li>
            <t>The cross-technology Ethernet link, which is supporting that
multi-technology intra-domain Ethernet link, between the physical
Ethernet LTPs 5-0 on PE13 and the physical Ethernet LTP 7-0 on the
optical NE11.</t>
          </li>
        </ul>
        <t>The P-PNC does not report any plug-id information on the logical
Ethernet LTPs terminating intra-domain Ethernet links, such as the
LTP 5-1 on PE13 and LTP 6-1 in BR11 shown in
<xref target="fig-multi-technology-link"/>, since these
links are discovered by the PNC.</t>
        <t>In addition, the P-PNC also reports the physical Ethernet LTPs that
terminate the cross-technology Ethernet links supporting the
multi-technology intra-domain Ethernet links, e.g., the Ethernet LTP 5-0
on PE13 and the
Ethernet LTP 6-0 on BR11, shown in <xref target="fig-multi-technology-link"/>.</t>
        <t>The MDSC discovers, using the mechanisms described in
<xref target="inter-domain-link-discovery"/>,
which cross-technology Ethernet links support the multi-technology
intra-domain
Ethernet links, e.g., the link between LTP 5-0 on PE13 and LTP 7-0 on
NE11, shown in <xref target="fig-multi-technology-link"/>.</t>
        <t>The MDSC also discovers, from the information provided by the O-PNC
and described in <xref target="optical-path-discovery"/>, which optical tunnels
support the
multi-technology intra-domain IP links and therefore the path within the
optical network that supports a multi-technology intra-domain IP link,
e.g., as shown in <xref target="fig-multi-technology-link"/>.</t>
        <section anchor="single-technology-link-discovery">
          <name>Intra-domain single-technology IP Links</name>
          <t>It is worth noting that the P-PNC may not be aware of whether an
Ethernet interface on the IP router terminates a multi-technology or a
single-technology intra-domain Ethernet link.</t>
          <t>In this case, the P-PNC, always reports two Ethernet LTPs for each
Ethernet interface on the IP router, e.g., the Ethernet LTP 1-0 and 1-1
on PE13, shown in <xref target="fig-intra-domain-link"/>.</t>
          <figure anchor="fig-intra-domain-link">
            <name>Single-technology intra-domain Ethernet and IP link discovery</name>
            <artwork type="ascii-art"><![CDATA[
        +-----------------------------------------------------------+
       /                    IP Topology (P-PNC 1)                  /
      /    +---------+                        +---------+         /
     /     |  PE13   |                        |    P16  |        /
    /      |    (1-2)O<======================>O(2-2)    |       /
   /       |         |            |           |         |      /
  /        +---------+            |           +---------+     /
 /                                |                          /
+---------------------------------|-------------------------+
                                  |
                                  | Supporting Link
                                  |
                                  |
          +-----------------------|---------------------------------+
         /                        |                                /
        /  +---------+            v           +---------+         /
       /   |    (1-1)O<======================>O(2-1)    |        /
      /    |         |\                      /|         |       /
     /     |  PE13   |V(*)                (*)V|    P16  |      /
    /      |         |/                      \|         |     /
   /       | {1}(1-0)O<~~~~~~~~~~~~~~~~~~~~~~>O(2-0){2} |    /
  /        +---------+                        +---------+   /
 /                   Ethernet Topology (P-PNC 1)           /
+---------------------------------------------------------+

Notes:
=====
(*) Supporting LTP
{1} {PE13,1}
{2} {P16,2}

Legend:
=======
  O   LTP
----> Supporting LTP
<===> Link discovered by the PNC and reported at the MPI
<~~~> Link inferred by the MDSC
{   } LTP Plug-id reported by the PNC
]]></artwork>
          </figure>
          <t>It is worth noting that in the case of intra-domain single-technology
Ethernet links, the MDSC cannot discover, using the LLDP information
reported in the plug-id attributes, the physical adjacency between
two Ethernet interfaces on physically adjacent IP routers, because
the plug-id values do not match, such as {PE13,1} and {P16,2}, as shown
in <xref target="fig-intra-domain-link"/>. However, the MDSC may infer the physical
intra-domain Ethernet links, e.g., between LTP 1-0 on PE13 and LTP 2-0
on P16, as shown in <xref target="fig-intra-domain-link"/>, if it knows a priori,
using mechanisms outside the scope of this document, that all Ethernet
interfaces on the IP routers terminate either a cross-technology or
single-technology (intra-domain or inter-domain) Ethernet link, e.g.,
as shown in <xref target="fig-intra-domain-link"/>.</t>
          <t>The P-PNC can omit reporting the physical Ethernet LTP if it knows,
through mechanisms outside the scope of this document, that the
intra-domain Ethernet link is single-technology.</t>
        </section>
      </section>
      <section anchor="lag-discovery">
        <name>LAG Discovery</name>
        <t>The P-PNCs can discover the configuration of LAG groups within its
domain and report each intra-domain LAG as an Ethernet bundle link
within the Ethernet topology exposed at the MPI.</t>
        <t>This is done by bundling multiple single-domain Ethernet links, as
shown in <xref target="fig-lag"/>. For example, the Ethernet bundled link between
Ethernet LTP 5-1 on BR21 and Ethernet LTP 6-1 on P24 is built from
the Ethernet links set up respectively:</t>
        <ul spacing="normal">
          <li>
            <t>between the Ethernet LTP 1-1 on BR21 and the Ethernet LTP 2-1 on
P24; and</t>
          </li>
          <li>
            <t>between the Ethernet LTP 3-1 on BR21 and the Ethernet LTP 4-1 on
P24.</t>
          </li>
        </ul>
        <figure anchor="fig-lag">
          <name>LAG</name>
          <artwork type="ascii-art"><![CDATA[
        +-----------------------------------------------------------+
       /                    IP Topology (P-PNC 2)                  /
      /    +---------+                        +---------+         /
     /     |  BR21   |                        |    P24  |        /
    /      |    (5-2)O<======================>O(6-2)    |       /
   /       |         |            |           |         |      /
  /        +---------+            |           +---------+     /
 /                                |                          /
+---------------------------------|-------------------------+
                                  |
                                  | Supporting Link
                                  |
                                  |
          +-----------------------|---------------------------------+
         /                        |                                /
        /  +---------+            v           +---------+         /
       /   |    (5-1)O<======================>O(6-1)    |        /
      /    |  BR21   |  Bundled Link          |    P24  |       /
     /     |         |                        |         |      /
    /      |    (3-1)O<======================>O(4-1)    |     /
   /       |    (1-1)O<======================>O(2-1)    |    /
  /        +---------+                        +---------+   /
 /                   Ethernet Topology (P-PNC 2)           /
+---------------------------------------------------------+

Legend:
=======
  O   LTP
<===> Link discovered by the PNC and reported at the MPI
]]></artwork>
        </figure>
        <t>The mechanisms used by the MDSC to discover single-technology and
multi-technology intra-domain LAG links are the same, with the only
difference being whether the bundled links are single-technology or
multi-technology.</t>
        <t>However, the mechanisms used by the MDSC to discover single-technology
inter-domain LAG links between two BRs are different and outside the
scope of this document, as they do not imply cross-technology
coordination
between packet and optical domains.</t>
        <t>As described in <xref target="packet-topology-discovery"/>, the mechanisms used by the
P-PNC to discover the configuration of LAG groups within its domain, such
as LLDP <xref target="IEEE_802.1AB"/>, are outside the scope of this document.</t>
        <t>It is worth noting that according to <xref target="IEEE_802.1AB"/>, LLDP can be
configured on a LAG group (Aggregated Port) and/or on any number of its
LAG members (Aggregation Ports).</t>
        <t>If LLDP is enabled on both LAG members and groups, two types of LLDP
packets are transmitted by the routers and received by the optical
nodes on some cross-technology Ethernet links: one sent for the LLDP
session
configured at LAG member (Aggregation Port) level and another one for
the LLDP session configured at LAG group (Aggregated Port) level. This
could cause some issues when LLDP snooping is used to discover the
cross-technology Ethernet links, as defined in
<xref target="cross-technology-link-discovery"/>.</t>
        <t>The cross-technology Ethernet link discovery is based only on the LLDP
session
configured on the LAG members (Aggregation Ports) to allow discovery
of these links independently from the configuration of the underlay
optical tunnel or from the LAG group.</t>
        <t>To avoid any ambiguity on how the optical nodes can identify which LLDP
packets belong to which LLDP session, the P-PNC can disable the LLDP
sessions on the LAG groups configured by the MDSC (e.g., the
multi-technology single-domain LAG groups configured using the mechanisms
described in <xref target="lag-setup"/>), keeping the LLDP sessions on the LAG
members enabled.</t>
        <t>Another option is to rely on other mechanisms (e.g., the Port type
field in the Link Aggregation TLV defined in Annex F of <xref target="IEEE_802.1AX"/>)
that allow the optical node to identify which LLDP packets
belong to which LLDP session: the O-PNC can then use only the LLDP
information from the LLDP sessions configured on the LAG members to
support the cross-technology Ethernet link discovery mechanisms defined
in <xref target="cross-technology-link-discovery"/>.</t>
      </section>
      <section anchor="vpn-discovery">
        <name>L2/L3 VPN Network Services Discovery</name>
        <t>The P-PNC reports the L2/L3 VPN services configured within its
domain, using the L2NM and L3NM network service models, and which
packet TE tunnels (e.g., MPLS-TE or SR-TE) are used by each L2/L3 VPN
service, using the L2NM and L3NM TE service mapping models.</t>
        <t>The MDSC can use the information mentioned above together with the
packet TE path, packet topology, multi-technology IP links, optical
topology and optical path information discovered as described in the
previous sections, to discover the multi-technology path used to carry
the
traffic for each L2/L3 VPN service.</t>
      </section>
      <section anchor="inventory-discovery">
        <name>Inventory Discovery</name>
        <t>There are no YANG data models in IETF that could be used to report at
the MPI the whole inventory information discovered by a PNC.</t>
        <t><xref target="RFC8345"/> had foreseen some work for inventory as an augmentation of
the network model, but no YANG data model has been developed so far.</t>
        <t>There are also no YANG data models in IETF that could be used to
correlate topology information, e.g., a link termination point (LTP),
with inventory information, e.g., the physical port supporting an
LTP, if any.</t>
        <t>Inventory information through MPI and correlation with topology
information is identified as a gap requiring further work and outside
of the scope of this draft.</t>
      </section>
    </section>
    <section anchor="config">
      <name>Establishment of L2/L3 VPN Services with TE Requirements</name>
      <t>In this scenario the MDSC needs to setup a multi-domain L2VPN or a
multi-domain L3VPN with some SLA requirements.</t>
      <t>The MDSC receives the request to setup a L2/L3 VPN network service
from the OSS/Orchestration layer (see <xref target="additional-scenarios"/>).</t>
      <t>The MDSC translates the L2/L3 VPN SLA requirements into TE
requirements (e.g., bandwidth, TE metric bounds, SRLG disjointness,
nodes/links/domains inclusion/exclusion) and find the TE paths that
meet these TE requirements (see <xref target="vpn-overview"/>).</t>
      <t>For example, considering the L3VPN in <xref target="fig-vpn-topo"/> and
<xref target="fig-vpn-path"/>, the MDSC
finds that:</t>
      <ul spacing="normal">
        <li>
          <t>PE13-P16-PE14 TE path already exists but does not have enough bandwidth
to support the new L3VPN, as described in <xref target="te-path-discovery"/>, and
that:  </t>
          <ul spacing="normal">
            <li>
              <t>the IP link(s) between PE13 and P16 do not have enough bandwidth
 to support increasing the bandwidth of that TE path, as
 described in <xref target="packet-topology-discovery"/>;</t>
            </li>
            <li>
              <t>a new underlay optical tunnel could be setup to increase the
 bandwidth of the IP link(s) between PE13 and P16 to support
 increasing the bandwidth of that overlay TE path, as described
 in <xref target="optical-path-computation"/>. The dimensioning of the underlay
optical
 tunnel is decided by the MDSC based on the TE requirements
 (e.g., the bandwidth) requested by the TE path and on its
 multi-layer optimization policy, which is an internal MDSC
 implementation issue;</t>
            </li>
          </ul>
        </li>
        <li>
          <t>a new multi-domain TE path needs to be setup between PE13 and
PE23, e.g., either because existing TE paths between PE13 and
PE23 are not able to meet the TE and binding requirements of
the L2/L3 VPN service or because there is no TE path between
PE13 and PE23.</t>
        </li>
      </ul>
      <t>As described in <xref target="path-computation-overview"/>, with partial
summarization, the MDSC will use the TE topology information provided
by the P-PNCs and the results of the path computation requests sent to
the O-PNCs, as described in <xref target="optical-path-computation"/>, to compute
the multi-layer/multi-domain path between PE13 and PE23.</t>
      <t>For example, the multi-layer/multi-domain performed by the MDSC could
require the setup of:</t>
      <ul spacing="normal">
        <li>
          <t>a new underlay optical tunnel between PE13 and BR11, supporting a
new IP link, as described in <xref target="multi-technology-link-setup"/>;</t>
        </li>
        <li>
          <t>a new underlay optical tunnel between BR21 and P24 to increase the
bandwidth of the IP link(s) between BR21 and P24, as described in
<xref target="multi-technology-link-setup"/>.</t>
        </li>
      </ul>
      <t>When setting up the L2/L3 VPN network service requires multi-domain
and multi-layer coordination, the MDSC is also responsible for
coordinating the network configuration needed to realize the requested
network service across the appropriate optical and packet domains.</t>
      <t>The MDSC would therefore request:</t>
      <ul spacing="normal">
        <li>
          <t>the O-PNC1 to setup a new optical tunnel between the ROADMs
connected to PE13 and P16, as described in
<xref target="multi-technology-link-setup"/>;</t>
        </li>
        <li>
          <t>the P-PNC1 to update the configuration of the existing IP link, in
case of LAG, or configure a new IP link, in case of ECMP, between
PE13 and P16, as described in <xref target="multi-technology-link-setup"/>;</t>
        </li>
        <li>
          <t>the P-PNC1 to update the bandwidth of the selected TE path between
PE13 and PE14, as described in <xref target="te-path-config"/>.</t>
        </li>
      </ul>
      <t>After that, the MDSC requests P-PNC2 to set up a TE path between BR21
and PE23, with an explicit path (BR21, P24, PE23) to constrain the
new TE path to use the underlay optical tunnel setup between BR21 and
P24, as described in <xref target="te-path-config"/>. The P-PNC2 properly configures
the routers within its domain to set up the requested path and returns
the information needed for multi-domain TE path stitching. For example,
in inter-domain SR-TE, the P-PNC2, knowing the node and adjacency SIDs
assigned within its domain, can install the proper SR policy or
hierarchical policies within BR21 and return to the MDSC the binding
SID assigned to this policy in BR21.</t>
      <t>Then the MDSC requests P-PNC1 to set up a TE path between PE13 and
BR11, with an explicit path (PE13, BR11) to constrain the new TE path
to use the underlay optical tunnel setup between PE13 and BR11,
specifying which inter-domain link should be used to send traffic to
BR21 and the information for multi-domain TE path stitching, as
described in <xref target="te-path-discovery"/> (e.g., in inter-domain SR-TE, the
binding SID assigned by P-PNC2 to the corresponding SR policy in BR21).
The P-PNC1 properly configures the routers within its domain to set up
the requested path and the multi-domain TE path stitching. For example,
in inter-domain SR-TE, the P-PNC1, knowing the node and adjacency SIDs
assigned within its domain and the PE SID assigned by P-PNC1 to the
inter-domain link between BR11 and BR21, along with the binding SID
assigned by P-PNC2, installs the proper policy or policies within PE13.</t>
      <t>Once the TE paths have been selected and, if needed, set up or modified,
the MDSC can request both P-PNCs to configure the L3VPN and its binding
with the selected TE paths, as described in <xref target="vpn-setup"/>.</t>
      <section anchor="optical-path-computation">
        <name>Optical Path Computation</name>
        <t>As described in <xref target="path-computation-overview"/>, optical path
computation is usually performed by the O-PNCs.</t>
        <t>When performing multi-layer/multi-domain path computation, the MDSC
can delegate single-domain optical path computation to the O-PNC.</t>
        <t>As described in <xref target="optical-topology-discovery"/>, <xref target="inter-domain-link-discovery"/>,
and <xref target="multi-technology-link-discovery"/>, there is a one-to-one
relationship between a multi-layer intra-domain IP link and its underlay
optical tunnel. Therefore, the properties of an optical path between
two optical TTPs, as computed by the O-PNC, can be used by the MDSC to
infer the properties of the associated multi-layer single-domain IP link.</t>
        <t>As discussed in <xref target="I-D.ietf-teas-yang-path-computation"/>, there are two
options to request an O-PNC to perform optical path computation: either
via a "compute-only" TE tunnel path, using the generic TE tunnel YANG
data model defined in <xref target="I-D.ietf-teas-yang-te"/>, or via the path
computation RPC defined in <xref target="I-D.ietf-teas-yang-path-computation"/>.</t>
        <t>This draft assumes that the path computation RPC is used.</t>
        <t>There are no YANG data models in IETF that could be used to augment
the generic path computation RPC with technology-specific attributes.</t>
        <t>Optical technology-specific augmentation for the path computation RPC
is identified as a gap requiring further work outside of this draft's
scope.</t>
      </section>
      <section anchor="multi-technology-link-setup">
        <name>Multi-technology IP Link Setup</name>
        <t>As described in <xref target="optical-path-computation"/>, there is a one-to-one
relationship between a multi-technology intra-domain IP link and its
underlay optical tunnel.</t>
        <t>Therefore, to set up a new multi-technology intra-domain IP link,
the MDSC requires the O-PNC to set up the optical tunnel (using either
the WDM Tunnel model or the OTN Tunnel model, if optional OTN switching
is supported) within the optical network and steer client traffic
between the two cross-technology Ethernet links over that optical tunnel,
using either the Ethernet Client Signal Model (for frame-based transport)
or the Transparent CBR Client Signal Model (for transparent transport).</t>
        <t>For example, with reference to <xref target="fig-multi-technology-link-2"/>, the
MDSC can request O-PNC1 to set up an optical tunnel between optical
TTPs (7) on NE11 and (8) on NE12 and steer client traffic over this
tunnel between LTP (7-0) on NE11 and LTP (8-0) on NE12.</t>
        <figure anchor="fig-multi-technology-link-2">
          <name>Multi-technology IP link setup</name>
          <artwork type="ascii-art"><![CDATA[
        +-----------------------------------------------------------+
       /                    IP Topology (P-PNC 1)                  /
      /    +---------+                        +---------+         /
     /     |  PE13   |                        |   BR11  |        /
    /      |    (5-2)O<======================>O(6-2)    |       /
   /       |         |              |         |         |      /
  /        +---------+              |         +---------+     /
 /                                  |                        /
+-----------------------------------|-----------------------+
                                    |
                                    | Supporting Link
                                    |
        +---------------------------|-------------------------------+
       / Ethernet Topology (P-PNC 1)|                              /
      /    +-------------+          |     +-------------+         /
     /     |    PE13     |          V     |    BR11     |        /
    /      |        (5-1)O<==============>O(6-1)        |       /
   /       |    (5-0)    |\              /|    (6-0)    |      /
  /        +------O------+|(*)        (*)|+------O------+     /
 /                ^ \<----+              +----->/^           /
+-----------------:------------------------------:----------+
                  :                              :
                  :                              :
                  :                              :
        +---------:------------------------------:------------------+
       /          :   Ethernet or OTN Topology   :                 /
      /           V          (O-PNC 1)           V                /
     /     +------O------+    ETH/CBR     +------O------+        /
    /      |    (7-0)    |  client sig.   |    (8-0)    |       /
   /       |      X----------+-------------------X      |      /
  /        |    NE11     |   |            |     NE12    |     /
 /         +-------------+   |            +-------------+    /
+----------------------------|------------------------------+
                             | Underlay
                             | tunnel
                             |
         +----------------------------------------------------------+
        /        (7)         |                  (8)                /
       /         ---         |                  ---               /
      /    +-----\ /-----+   v            +-----\ /-----+        /
     /     |      V      |                |      V      |       /
    /      |      X======|================|======X      |      /
   /       |    NE11     |  Opt. Tunnel   |    NE12     |     /
  /        +-------------+                +-------------+    /
 /                   Optical Topology (O-PNC 1)             /
+----------------------------------------------------------+

Notes:
=====
(*) Supporting LTP

Legend:
=======
  O   LTP
 ---
 \ /  TTP
  V
----> Supporting LTP or Supporting Link or Underlay tunnel
<===> Link discovered by the PNC and reported at the MPI
<...> Link discovered by the MDSC
x---x Ethernet/CBR client signal
X===X Optical tunnel
]]></artwork>
        </figure>
        <t>Note: <xref target="fig-multi-technology-link-2"/> is an exact copy of
<xref target="fig-multi-technology-link"/>.</t>
        <t>After the optical tunnel has been set up and the client traffic
steering configured, the two IP routers can exchange Ethernet frames
between themselves, including LLDP messages.</t>
        <t>If LLDP <xref target="IEEE_802.1AB"/> or any other discovery mechanisms, outside
the scope of this document, are used between the adjacency of the two
IP routers' ports, the P-PNC can automatically discover the underlay
multi-technology single-domain Ethernet link set up by the MDSC and
report it to the P-PNC, as described in <xref target="multi-technology-link-discovery"/>.</t>
        <t>Otherwise, if no automatic discovery mechanisms are used, the MDSC
can configure this multi-technology single-domain Ethernet link at
the MPI of the P-PNC.</t>
        <t>The two Ethernet LTPs terminating this multi-technology single-domain
Ethernet link are supported by the two underlay Ethernet LTPs
terminating the two cross-technology Ethernet links, e.g., LTP 5-1 on
PE13 and 6-1 on BR11, as shown in <xref target="fig-multi-technology-link-2"/>.</t>
        <t>After the multi-technology single-domain Ethernet link has been
configured by the MDSC or discovered by the P-PNC, the corresponding
multi-technology single-domain IP link can also be configured either
by the MDSC or the P-PNC.</t>
        <t>This document assumes that the IP link is configured by the P-PNC.</t>
        <t>It is worth noting that if LAG is not supported within the domain
controlled by the P-PNC, the P-PNC can configure the multi-technology
single-domain IP link as soon as the underlay multi-technology
single-domain Ethernet link is either discovered by the P-PNC or
configured by the MDSC at the MPI. However, if LAG is supported, the
P-PNC lacks enough information to determine whether the discovered or
configured multi-technology single-domain Ethernet link would be:</t>
        <ol spacing="normal" type="1"><li>
            <t>Used to support a multi-technology single-domain IP link;</t>
          </li>
          <li>
            <t>Used to create a new LAG group;</t>
          </li>
          <li>
            <t>Added to an existing LAG group.</t>
          </li>
        </ol>
        <t>The MDSC can request the P-PNC to configure a new multi-technology
single-domain IP link, supported by the just discovered or configured
multi-technology single-domain Ethernet link, by creating an IP link
within the running datastore of the P-PNC MPI. Only the IP link, IP
LTPs, and the reference to the supporting multi-technology single-domain
Ethernet link are configured by the MDSC. All other configuration is
provided by the P-PNC.</t>
        <t>For example, with reference to <xref target="fig-multi-technology-link-2"/>, the
MDSC can request P-PNC1 to set up a multi-technology single-domain
IP link between IP LTP 5-2 on PE13 and IP LTP 6-2 on BR11, supported
by the multi-technology single-domain Ethernet link between ETH LTP
5-1 on PE13 and ETH LTP 6-1 on BR11.</t>
        <t>The P-PNC configures the requested multi-technology single-domain
IP link and, once finished, reports it to the MDSC within the IP
topology exposed at its MPI.</t>
        <section anchor="lag-setup">
          <name>Multi-technology LAG Setup</name>
          <t>The P-PNC configures a new LAG group between two routers when the
MDSC creates a new Ethernet bundled link at the MPI (using the
bundled-link container defined in <xref target="RFC8795"/>), bundling the
multi-technology single-domain Ethernet link(s) being created, as
described above.</t>
          <t>When a new LAG link is created, it is recommended to configure the
minimum number of active member links required to consider the LAG
link as up. For example, a LAG link with three members can be
considered up when only one member link fails and down when at least
two member links fail.</t>
          <t>The attribute required to configure the minimum number of active
member links is missing in <xref target="I-D.ietf-ccamp-eth-client-te-topo-yang"/>
and is identified as a gap in <xref target="conclusions"/>.</t>
          <t>It is worth noting that a new LAG group can be created to bundle one
or more multi-technology single-domain Ethernet link(s).</t>
          <t>For example, with reference to <xref target="fig-lag"/>, the MDSC can request
P-PNC2 to set up an Ethernet bundled link between Ethernet LTP 5-1 on
BR21 and Ethernet LTP 6-1 on P24, bundling the multi-technology
single-domain Ethernet link between Ethernet LTP 1-1 on BR21 and
Ethernet LTP 2-1 on P24.</t>
          <t>It is also worth noting that the MDSC needs to create the Ethernet
LTPs terminating the Ethernet bundled link.</t>
          <t>The MDSC can request the P-PNC to configure a new multi-technology
single-domain IP link, supported by the just configured Ethernet
bundled link, following the same procedure described in
<xref target="multi-technology-link-setup"/> above.</t>
          <t>For example, with a reference to <xref target="fig-lag"/>, the MDSC can request the
P-PNC2 to setup a multi-technology single-domain IP Link between IP LTP
5-2 on BR21 and IP LTP 6-2 on P24 supported by the Ethernet bundle link
between ETH LTP 5-1 on BR21 and the Ethernet LTP 6-1 on P24.</t>
        </section>
        <section anchor="multi-technology-lag-update">
          <name>Multi-technology LAG Update</name>
          <t>The P-PNC adds new member(s) to an existing LAG group when the MDSC
updates the configuration of an existing Ethernet bundled link at the
MPI, adding the multi-technology single-domain Ethernet link(s) being
created, as described above.</t>
          <t>When member links are added or removed from a LAG link, the minimum
number of active member links required to consider the LAG link as up
may also need to be updated.</t>
          <t>For example, with reference to <xref target="fig-lag"/>, the MDSC can request
P-PNC2 to add the multi-technology single-domain Ethernet link set up
between Ethernet LTP 3-1 on BR21 and Ethernet LTP 4-1 on P24 to the
existing Ethernet bundle link set up between Ethernet LTP 5-1 on node
BR21 and Ethernet LTP 6-1 on node P24.</t>
          <t>After the LAG configuration has been updated, the P-PNC can also update
the bandwidth information of the multi-technology single-domain IP link
supported by the updated Ethernet bundled link.</t>
        </section>
        <section anchor="multi-technology-path-properties">
          <name>Multi-technology TE path properties Configuration</name>
          <t>The MDSC can discover the TE path properties (e.g., the list of
SRLGs, the delay) of a multi-technology IP link from the TE properties
of:</t>
          <ul spacing="normal">
            <li>
              <t>the IP LTPs terminating the multi-technology IP link (e.g., the list of
SRLGs reported by the P-PNC using the packet TE topology model);</t>
            </li>
            <li>
              <t>the optical path (e.g., the list of SRLGs reported by the O-PNC
using the WDM or OTN tunnel model); and</t>
            </li>
            <li>
              <t>the cross-domain links (e.g., the list of SRLGs reported by the O-PNC
and P-PNC respectively, using the WSON and/or flexi-grid, the
OTN and the packet TE topology models).</t>
            </li>
          </ul>
          <t>The MDSC can also report this information to the P-PNC by properly
configuring the multi-technology IP link properties using the packet TE
topology model at the packet PNC MPI.</t>
          <t>This information is used by the P-PNC at least when computing the
local protection path, as described in <xref target="te-path-config"/>, e.g., to
ensure
that the local protection path is SRLG disjoint with the primary
path.</t>
          <t>It is worth noting that the list of SRLGs for a multi-technology IP link
can be quite long. Implementation-specific mechanisms can be
implemented by the MDSC or by the O-PNC to summarize the SRLGs of an
optical tunnel. These mechanisms are implementation-specific and have
no impact on the YANG models nor on the interoperability at the MPI,
but cares have to be taken to avoid missing information.</t>
        </section>
      </section>
      <section anchor="te-path-config">
        <name>TE Path Setup and Update</name>
        <t>This document assumes that TE path setup and update at
the MPI could be done using the generic TE tunnel YANG data model,
defined in <xref target="I-D.ietf-teas-yang-te"/>, with packet technology-specific
augmentations, described in <xref target="packet-yang"/>.</t>
        <t>When a new TE path needs to be setup, the MDSC can use the
<xref target="I-D.ietf-teas-yang-te"/> model to request the P-PNC to set it up,
properly specifying the path constraints, such as the explicit path,
to ensure the P-PNC sets up a TE path that meets the end-to-end TE
and binding constraints and uses the optical tunnels set up by the
MDSC to support this new TE path.</t>
        <t>The <xref target="I-D.ietf-teas-yang-te"/> model supports requesting the setup of
both end-to-end as well as segment TE tunnels (within one domain).</t>
        <t>In the latter case, the technology-specific augmentations should
allow the configuration of the information needed for multi-domain TE
path stitching.</t>
        <t>For example, the SR-TE specific augmentations of the
<xref target="I-D.ietf-teas-yang-te"/>
model should be defined to allow the MDSC to configure the binding
SIDs to be used for the multi-domain SR-TE path stitching and to
allow the P-PNC to report the binding SID assigned to the segment TE
paths. Note that the assigned binding SID should be persistent in
case IP router or P-PNC rebooting.</t>
        <t>The MDSC can also use the <xref target="I-D.ietf-teas-yang-te"/> model to request the
P-PNC to
increase the bandwidth allocated to an existing TE path, and, if
needed, also on its reverse TE path. The <xref target="I-D.ietf-teas-yang-te"/> model
supports
both symmetric and asymmetric bandwidth configuration in the two
directions.</t>
        <t>The MDSC also request the P-PNC to configure local protection mechanisms.
For example, the FRR local protection, as defined in <xref target="RFC4090"/> in case
of MPLS-TE domain or the TI-LFA local protection, as defined in
<xref target="I-D.ietf-rtgwg-segment-routing-ti-lfa"/> in case of SR-TE domain. The
mechanisms to request the configuration TI-LFA local protection for SR-TE
paths using the <xref target="I-D.ietf-teas-yang-te"/> are a gap in the current YANG
models.</t>
        <t>The requested local protection mechanisms within the P-PNC domain are
configured by the P-PNC through implementation specific mechanisms
which are outside the scope of this document.</t>
        <t>The P-PNC takes into account the multi-layer TE path properties
(e.g., SRLG information), configured by the MDSC as described in
<xref target="multi-technology-path-properties"/>, when computing the protection
configuration (e.g., in
case of SR-TE domains, the TI-LFA post-convergence path or, in case of
MPLS-TE domain, the FRR backup tunnel) for multi-technology single-domain
IP links.</t>
        <t>SR-TE path setup and update (e.g., bandwidth increase) through MPI is
identified as a gap requiring further work, which is outside of the
scope of this draft.</t>
      </section>
      <section anchor="vpn-setup">
        <name>L2/L3 VPN Network Service Setup</name>
        <t>The MDSC can use the L2NM and L3NM network service models to request
the P-PNCs to setup L2/L3 VPN services, and the L2NM and L3NM TE
service mapping models to request the P-PNCs to configure the PE
routers to steer the L2/L3 VPN traffic to the selected TE tunnels
(e.g., MPLS-TE or SR-TE).</t>
        <t>It is worth noting that the L2NM and L3NM TE service mapping models,
defined in <xref target="I-D.ietf-teas-te-service-mapping-yang"/>, provide a list
of TE tunnel(s) that should be used to forward L2/L3 VPN traffic
between the two PEs terminating the listed TE tunnel(s). If the list
contains more than one TE tunnel for the same pair of PEs, these TE
tunnels are used to load balance the associated L2/L3 VPN traffic
between the same set of two PEs.</t>
        <t>The possibility to request splitting the traffic between multiple TE
tunnels for the same PE pair in a way other than load balancing is
identified as a gap requiring further work and is outside the scope
of this draft.</t>
      </section>
    </section>
    <section anchor="conclusions">
      <name>Conclusions and Gaps</name>
      <t>The analysis provided in this document shows that the IETF YANG models
described in <xref target="yang"/> provide useful support for Packet Optical Integration
(POI) scenarios for resource discovery (network topology, service,
tunnels, and network inventory discovery), as well as for supporting
multi-layer/multi-domain L2/L3 VPN network services.</t>
      <t>The following gaps were identified that may need to be addressed by
the relevant IETF Working Groups:</t>
      <ul spacing="normal">
        <li>
          <t>how both WSON and Flexi-grid topology models could be used
together (through multi-inheritance): this gap has been identified
in <xref target="optical-topology-discovery"/>;</t>
        </li>
        <li>
          <t>network inventory model: this gap has been identified in
<xref target="inventory-discovery"/> and the solution in
<xref target="I-D.ietf-ivy-network-inventory-yang"/> has been proposed to
resolve it;</t>
        </li>
        <li>
          <t>technology-specific augmentations of the path computation RPC,
defined in <xref target="I-D.ietf-teas-yang-path-computation"/> for optical networks:
this gap has been
identified in <xref target="optical-path-computation"/> and the solution in
<xref target="I-D.ietf-ccamp-optical-path-computation-yang"/>
has been proposed to resolve it;</t>
        </li>
        <li>
          <t>relationship between common discovery mechanisms applicable to
access links, inter-domain IP links and cross-technology Ethernet links
and the
UNI topology discovery mechanism defined in <xref target="RFC9408"/>: this gap has
been identified in <xref target="packet-topology-discovery"/>;</t>
        </li>
        <li>
          <t>a mechanism applicable to the P-PNC NBI to configure the SR-TE
paths. Technology-specific augmentations of TE Tunnel model,
defined in <xref target="I-D.ietf-teas-yang-te"/>, are foreseen in section 1 of
<xref target="I-D.ietf-teas-yang-te"/>
but not yet defined: this gap has been identified in <xref target="te-path-config"/>;</t>
        </li>
        <li>
          <t>an attribute, which is used to configure the minimum number of
active member links required to consider the LAG link as being up,
is missing from the topology model defined in
<xref target="I-D.ietf-ccamp-eth-client-te-topo-yang"/>: this
gap has been identified in <xref target="lag-setup"/>;</t>
        </li>
        <li>
          <t>a mechanism to configure splitting the L2/L3 VPN traffic, between
multiple TE tunnels for the same PEs pair, in a different way than
load balancing: this gap has been identified in <xref target="vpn-setup"/>;</t>
        </li>
        <li>
          <t>a mechanism to report client connectivity constraints imposed by
some muxponder design: this gap has been identified in <xref target="muxponder"/>.</t>
        </li>
      </ul>
      <t>Although not applicable to this document, it has been noted that being
able to use WSON and Flexi-grid topology models together (through
multi-inheritance) is not only useful for mixed fixed-grid and
flexible-grid DWDM network topologies but also the only viable option
for a mixed CWDM and DWDM network topology.</t>
      <t>Although not applicable to this document, it has been noted that the
WDM tunnel model would also support optical tunnel setup in the case
of a mixed CWDM and DWDM network topology.</t>
      <t>Although not analyzed in this document, it has been noted that the TE
Tunnel model, defined in <xref target="I-D.ietf-teas-yang-te"/>, needs enhancement
to support scenarios where multiple parallel TE paths are used in
load-balancing to carry traffic between two end-points (e.g., VPN
traffic between two PEs).</t>
    </section>
    <section anchor="security">
      <name>Security Considerations</name>
      <t>This document highlights how the ACTN architecture can deploy packet
over optical infrastructure services. It highlights how existing IETF
protocols and data models may be used for multi-layer services. It
reuses several existing IETF protocols and data models for the MPI
interfaces between each PNC (Optical or Packet) and the MDSC,
including:</t>
      <ul spacing="normal">
        <li>
          <t>RESTCONF</t>
        </li>
        <li>
          <t>NETCONF</t>
        </li>
        <li>
          <t>PCEP</t>
        </li>
        <li>
          <t>YANG</t>
        </li>
      </ul>
      <t>Several existing authentication and encryption practices and
techniques may be used to help secure these MPI interfaces. These
mechanisms include using Transport Layer Security (TLS) to provide
secure transport for RESTCONF, NETCONF and PCEP. Furthermore, access
control techniques can also provide additional security. NETCONF
supports an Access Control Model (NACM), and RESTCONF supports Role
Based Access Control (RBAC), which should also ensure that MDSC to
PNC communication is based on authorised use and granular control of
connectivity and resource requests.</t>
      <section anchor="lldp-snooping-security-considerations">
        <name>LLDP Snooping Security Considerations</name>
        <t>Earlier in the document, LLDP is discussed as a mechanism for the PNCs to
discover the intra-domain Ethernet and IP links. While LLDP provides
valuable information for network management and troubleshooting, it also
presents several security issues:</t>
        <ul spacing="normal">
          <li>
            <t>Eavesdropping: LLDP transmissions are not encrypted. Potentially, LLDP
packets could be captured using a packet sniffer. An attacker can
leverage this information to gain insights into the network topology,
device types, and configurations, which could be used for further
attacks;</t>
          </li>
          <li>
            <t>Unauthorized Access: Information disclosed by LLDP can include device
types, software versions, and network configuration details. This might
help an attacker identify vulnerable devices or configurations that can
be exploited to gain unauthorized access or escalate privileges within
the network;</t>
          </li>
          <li>
            <t>Data Manipulation: If an attacker gains access to a network device,
they could manipulate LLDP information to advertise false device
information, leading to potential misconfigurations or trust
relationships being exploited. This can disrupt network operations or
redirect traffic to malicious devices;</t>
          </li>
          <li>
            <t>Denial of Service (DoS): By flooding the network with fake LLDP
packets, an attacker could overwhelm network devices or management
systems, potentially leading to a denial of service where legitimate
network traffic is disrupted;</t>
          </li>
          <li>
            <t>Spoofing: An attacker could spoof LLDP packets to impersonate other
network devices. Potentially, this might lead to incorrect network
mappings or trust relationships being established with malicious devices;</t>
          </li>
          <li>
            <t>Lack of Authentication: LLDP does not include mechanisms for
authenticating the source of LLDP messages, which means that devices
accept LLDP information from any source as legitimate.</t>
          </li>
        </ul>
        <t>To mitigate these security issues, network administrators might implement
several security measures, including:</t>
        <ul spacing="normal">
          <li>
            <t>Disabling LLDP on ports where it is not needed, especially those facing
untrusted networks;</t>
          </li>
          <li>
            <t>Using network segmentation and Access Control Lists (ACLs) to limit who
can send and receive LLDP packets;</t>
          </li>
          <li>
            <t>Using IEEE 802.1AE MAC Security (MACsec) <xref target="IEEE_802.1AE"/> to provide
data origin authentication, integrity, and confidentiality for Ethernet
frames, reducing the risk of LLDP spoofing or tampering on protected
links;</t>
          </li>
          <li>
            <t>Employing network monitoring and anomaly detection systems to identify
unusual LLDP traffic patterns that may indicate an attack;</t>
          </li>
          <li>
            <t>Regularly updating and patching network devices to address known
vulnerabilities that could be exploited through information gathered via
LLDP.</t>
          </li>
        </ul>
      </section>
    </section>
    <section anchor="operational-considerations">
      <name>Operational Considerations</name>
      <t>This document has identified the need and enabling components for
automating the management and control of multi-layer Service Providers'
transport networks, combining the optical and microwave transport layer
with the packet (IP/MPLS) layer to create a more efficient and scalable
network infrastructure. This approach is particularly beneficial for
Service Providers and large enterprises dealing with high bandwidth
demands and looking for cost-effective ways to expand their networks.
However, integrating these two traditionally separate network layers
involves several operational considerations:</t>
      <ul spacing="normal">
        <li>
          <t>Network Design and Capacity Planning: Deciding the degree of
integration between the packet and optical layers is critical.
Furthermore, this includes determining whether to pursue a loose
integration (keeping layers distinct but coordinated) or a tight
integration (combining layers more closely, potentially at the hardware
level) coordinated via the MDSC. Accurate forecasting and planning will
also be essential to ensure that the integrated ACTN infrastructure can
handle future capacity demand without excessive over-provisioning;</t>
        </li>
        <li>
          <t>System Interoperability: Networks often comprise equipment from various
vendors. Ensuring that packet and optical devices can interoperate
seamlessly and the PNCs can manage them is crucial for a successful
integration. The Service Provider must also check with the vendors to
ensure they support the IETF-based technologies outlined in this
document;</t>
        </li>
        <li>
          <t>Performance Monitoring: The integrated POI network will require
comprehensive monitoring solutions that can provide visibility to the
PNCs across both packet and optical layers. Identifying and diagnosing
issues may become more complex with integrated layers. Telemetry data may
also be required to collect lower-layer networking health and consider
network and service performance. This topic is further discussed in <xref target="I-D.poidt-teas-actn-poi-assurance"/>;</t>
        </li>
        <li>
          <t>Fault Management and Recovery: The POI networks should be resilient,
including considerations for automatic protection switching and fast
reroute mechanisms that span both layers. Fault isolation and recovery
may become more challenging, as issues in one layer can have cascading
effects on the other. Effective fault management strategies must be in
place to quickly identify and rectify such issues. This topic is further
discussed in <xref target="I-D.poidt-teas-actn-poi-assurance"/>;</t>
        </li>
      </ul>
      <t>Specific Security Considerations are discussed in <xref target="security"/>.</t>
    </section>
    <section anchor="iana-considerations">
      <name>IANA Considerations</name>
      <t>This document requires no IANA actions.</t>
    </section>
  </middle>
  <back>
    <references anchor="sec-combined-references">
      <name>References</name>
      <references anchor="sec-normative-references">
        <name>Normative References</name>
        <reference anchor="ITU-T_G.694.1" target="https://www.itu.int/rec/T-REC-G.694.1-202010-I">
          <front>
            <title>Spectral grids for WDM applications: DWDM frequency grid</title>
            <author>
              <organization>International Telecommunication Union</organization>
            </author>
            <date year="2020" month="October"/>
          </front>
          <seriesInfo name="ITU-T Recommendation G.694.1" value=""/>
        </reference>
        <reference anchor="IEEE_802.1AB" target="https://ieeexplore.ieee.org/document/7433915">
          <front>
            <title>IEEE Standard for Local and metropolitan area networks - Station and Media Access Control Connectivity Discovery</title>
            <author>
              <organization>Institute of Electrical and Electronics Engineers</organization>
            </author>
            <date year="2016" month="March"/>
          </front>
          <seriesInfo name="IEEE 802.1AB-2016" value=""/>
        </reference>
        <reference anchor="IEEE_802.1AX" target="https://ieeexplore.ieee.org/document/7055197">
          <front>
            <title>IEEE Standard for Local and metropolitan area networks - Link Aggregation</title>
            <author>
              <organization>Institute of Electrical and Electronics Engineers</organization>
            </author>
            <date year="2014" month="December"/>
          </front>
          <seriesInfo name="IEEE 802.1AX-2014" value=""/>
        </reference>
        <reference anchor="RFC8453">
          <front>
            <title>Framework for Abstraction and Control of TE Networks (ACTN)</title>
            <author fullname="D. Ceccarelli" initials="D." role="editor" surname="Ceccarelli"/>
            <author fullname="Y. Lee" initials="Y." role="editor" surname="Lee"/>
            <date month="August" year="2018"/>
            <abstract>
              <t>Traffic Engineered (TE) networks have a variety of mechanisms to facilitate the separation of the data plane and control plane. They also have a range of management and provisioning protocols to configure and activate network resources. These mechanisms represent key technologies for enabling flexible and dynamic networking. The term "Traffic Engineered network" refers to a network that uses any connection-oriented technology under the control of a distributed or centralized control plane to support dynamic provisioning of end-to- end connectivity.</t>
              <t>Abstraction of network resources is a technique that can be applied to a single network domain or across multiple domains to create a single virtualized network that is under the control of a network operator or the customer of the operator that actually owns the network resources.</t>
              <t>This document provides a framework for Abstraction and Control of TE Networks (ACTN) to support virtual network services and connectivity services.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8453"/>
          <seriesInfo name="DOI" value="10.17487/RFC8453"/>
        </reference>
        <reference anchor="RFC8795">
          <front>
            <title>YANG Data Model for Traffic Engineering (TE) Topologies</title>
            <author fullname="X. Liu" initials="X." surname="Liu"/>
            <author fullname="I. Bryskin" initials="I." surname="Bryskin"/>
            <author fullname="V. Beeram" initials="V." surname="Beeram"/>
            <author fullname="T. Saad" initials="T." surname="Saad"/>
            <author fullname="H. Shah" initials="H." surname="Shah"/>
            <author fullname="O. Gonzalez de Dios" initials="O." surname="Gonzalez de Dios"/>
            <date month="August" year="2020"/>
            <abstract>
              <t>This document defines a YANG data model for representing, retrieving, and manipulating Traffic Engineering (TE) Topologies. The model serves as a base model that other technology-specific TE topology models can augment.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8795"/>
          <seriesInfo name="DOI" value="10.17487/RFC8795"/>
        </reference>
        <reference anchor="RFC5212">
          <front>
            <title>Requirements for GMPLS-Based Multi-Region and Multi-Layer Networks (MRN/MLN)</title>
            <author fullname="K. Shiomoto" initials="K." surname="Shiomoto"/>
            <author fullname="D. Papadimitriou" initials="D." surname="Papadimitriou"/>
            <author fullname="JL. Le Roux" initials="JL." surname="Le Roux"/>
            <author fullname="M. Vigoureux" initials="M." surname="Vigoureux"/>
            <author fullname="D. Brungard" initials="D." surname="Brungard"/>
            <date month="July" year="2008"/>
            <abstract>
              <t>Most of the initial efforts to utilize Generalized MPLS (GMPLS) have been related to environments hosting devices with a single switching capability. The complexity raised by the control of such data planes is similar to that seen in classical IP/MPLS networks. By extending MPLS to support multiple switching technologies, GMPLS provides a comprehensive framework for the control of a multi-layered network of either a single switching technology or multiple switching technologies.</t>
              <t>In GMPLS, a switching technology domain defines a region, and a network of multiple switching types is referred to in this document as a multi-region network (MRN). When referring in general to a layered network, which may consist of either single or multiple regions, this document uses the term multi-layer network (MLN). This document defines a framework for GMPLS based multi-region / multi-layer networks and lists a set of functional requirements. This memo provides information for the Internet community.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="5212"/>
          <seriesInfo name="DOI" value="10.17487/RFC5212"/>
        </reference>
        <reference anchor="I-D.ietf-teas-yang-te">
          <front>
            <title>A YANG Data Model for Traffic Engineering Tunnels, Label Switched Paths, and Interfaces</title>
            <author fullname="Tarek Saad" initials="T." surname="Saad">
              <organization>Cisco Systems Inc</organization>
            </author>
            <author fullname="Rakesh Gandhi" initials="R." surname="Gandhi">
              <organization>Cisco Systems Inc</organization>
            </author>
            <author fullname="Xufeng Liu" initials="X." surname="Liu">
              <organization>Alef Edge</organization>
            </author>
            <author fullname="Vishnu Pavan Beeram" initials="V. P." surname="Beeram">
              <organization>Juniper Networks</organization>
            </author>
            <author fullname="Igor Bryskin" initials="I." surname="Bryskin">
              <organization>Individual</organization>
            </author>
            <date day="26" month="March" year="2026"/>
            <abstract>
              <t>   This document defines a YANG data model for the provisioning and
   management of Traffic Engineering (TE) tunnels, Label Switched Paths
   (LSPs), and interfaces.  The model covers data pertinent to TE
   tunnels, TE LSPs, and TE interfaces that are independent of any
   technology or dataplane encapsulation.  The model is divided into two
   YANG modules that address both device-specific and device-independent
   data, supporting configuration, operational state, Remote Procedure
   Calls (RPCs), and event notifications.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-teas-yang-te-44"/>
        </reference>
        <reference anchor="I-D.ietf-teas-yang-path-computation">
          <front>
            <title>A YANG Data Model for requesting path computation</title>
            <author fullname="Italo Busi" initials="I." surname="Busi">
              <organization>Huawei Technologies</organization>
            </author>
            <author fullname="Sergio Belotti" initials="S." surname="Belotti">
              <organization>Nokia</organization>
            </author>
            <author fullname="Oscar Gonzalez de Dios" initials="O. G." surname="de Dios">
              <organization>Telefonica</organization>
            </author>
            <author fullname="Anurag Sharma" initials="A." surname="Sharma">
              <organization>Google</organization>
            </author>
            <author fullname="Yan Shi" initials="Y." surname="Shi">
              <organization>China Unicom</organization>
            </author>
            <date day="12" month="May" year="2026"/>
            <abstract>
              <t>   In certain scenarios — particularly within hierarchical Software-
   Defined Networking (SDN) environments—the topology information
   provided by a Traffic Engineering (TE) network provider may be
   insufficient for a client to perform end-to-end multi-domain path
   computation.  In such cases, the client may need to delegate the
   computation of specific intra-domain paths to the TE provider,
   leveraging the resulting path segments to construct optimal multi-
   domain end-to-end paths.

   This document defines a mechanism to enable path computation requests
   by augmenting the Remote Procedure Calls (RPCs) specified in RFC
   YYYY.  The augmented RPCs support path computation on demand,
   allowing clients to request intra-domain TE path computations from
   the provider while maintaining control over inter-domain path
   selection.

   Additionally, this document outlines several use cases in which such
   path computation requests are beneficial, particularly in
   environments where YANG-based management protocols—such as NETCONF or
   RESTCONF—are used for network automation and control.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-teas-yang-path-computation-28"/>
        </reference>
        <reference anchor="RFC8040">
          <front>
            <title>RESTCONF Protocol</title>
            <author fullname="A. Bierman" initials="A." surname="Bierman"/>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <author fullname="K. Watsen" initials="K." surname="Watsen"/>
            <date month="January" year="2017"/>
            <abstract>
              <t>This document describes an HTTP-based protocol that provides a programmatic interface for accessing data defined in YANG, using the datastore concepts defined in the Network Configuration Protocol (NETCONF).</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8040"/>
          <seriesInfo name="DOI" value="10.17487/RFC8040"/>
        </reference>
        <reference anchor="RFC7951">
          <front>
            <title>JSON Encoding of Data Modeled with YANG</title>
            <author fullname="L. Lhotka" initials="L." surname="Lhotka"/>
            <date month="August" year="2016"/>
            <abstract>
              <t>This document defines encoding rules for representing configuration data, state data, parameters of Remote Procedure Call (RPC) operations or actions, and notifications defined using YANG as JavaScript Object Notation (JSON) text.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="7951"/>
          <seriesInfo name="DOI" value="10.17487/RFC7951"/>
        </reference>
        <reference anchor="RFC8527">
          <front>
            <title>RESTCONF Extensions to Support the Network Management Datastore Architecture</title>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <author fullname="J. Schoenwaelder" initials="J." surname="Schoenwaelder"/>
            <author fullname="P. Shafer" initials="P." surname="Shafer"/>
            <author fullname="K. Watsen" initials="K." surname="Watsen"/>
            <author fullname="R. Wilton" initials="R." surname="Wilton"/>
            <date month="March" year="2019"/>
            <abstract>
              <t>This document extends the RESTCONF protocol defined in RFC 8040 in order to support the Network Management Datastore Architecture (NMDA) defined in RFC 8342.</t>
              <t>This document updates RFC 8040 by introducing new datastore resources, adding a new query parameter, and requiring the usage of the YANG library (described in RFC 8525) by RESTCONF servers implementing the NMDA.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8527"/>
          <seriesInfo name="DOI" value="10.17487/RFC8527"/>
        </reference>
        <reference anchor="RFC8342">
          <front>
            <title>Network Management Datastore Architecture (NMDA)</title>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <author fullname="J. Schoenwaelder" initials="J." surname="Schoenwaelder"/>
            <author fullname="P. Shafer" initials="P." surname="Shafer"/>
            <author fullname="K. Watsen" initials="K." surname="Watsen"/>
            <author fullname="R. Wilton" initials="R." surname="Wilton"/>
            <date month="March" year="2018"/>
            <abstract>
              <t>Datastores are a fundamental concept binding the data models written in the YANG data modeling language to network management protocols such as the Network Configuration Protocol (NETCONF) and RESTCONF. This document defines an architectural framework for datastores based on the experience gained with the initial simpler model, addressing requirements that were not well supported in the initial model. This document updates RFC 7950.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8342"/>
          <seriesInfo name="DOI" value="10.17487/RFC8342"/>
        </reference>
        <reference anchor="RFC7950">
          <front>
            <title>The YANG 1.1 Data Modeling Language</title>
            <author fullname="M. Bjorklund" initials="M." role="editor" surname="Bjorklund"/>
            <date month="August" year="2016"/>
            <abstract>
              <t>YANG is a data modeling language used to model configuration data, state data, Remote Procedure Calls, and notifications for network management protocols. This document describes the syntax and semantics of version 1.1 of the YANG language. YANG version 1.1 is a maintenance release of the YANG language, addressing ambiguities and defects in the original specification. There are a small number of backward incompatibilities from YANG version 1. This document also specifies the YANG mappings to the Network Configuration Protocol (NETCONF).</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="7950"/>
          <seriesInfo name="DOI" value="10.17487/RFC7950"/>
        </reference>
        <reference anchor="RFC8525">
          <front>
            <title>YANG Library</title>
            <author fullname="A. Bierman" initials="A." surname="Bierman"/>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <author fullname="J. Schoenwaelder" initials="J." surname="Schoenwaelder"/>
            <author fullname="K. Watsen" initials="K." surname="Watsen"/>
            <author fullname="R. Wilton" initials="R." surname="Wilton"/>
            <date month="March" year="2019"/>
            <abstract>
              <t>This document describes a YANG library that provides information about the YANG modules, datastores, and datastore schemas used by a network management server. Simple caching mechanisms are provided to allow clients to minimize retrieval of this information. This version of the YANG library supports the Network Management Datastore Architecture (NMDA) by listing all datastores supported by a network management server and the schema that is used by each of these datastores.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8525"/>
          <seriesInfo name="DOI" value="10.17487/RFC8525"/>
        </reference>
        <reference anchor="RFC8345">
          <front>
            <title>A YANG Data Model for Network Topologies</title>
            <author fullname="A. Clemm" initials="A." surname="Clemm"/>
            <author fullname="J. Medved" initials="J." surname="Medved"/>
            <author fullname="R. Varga" initials="R." surname="Varga"/>
            <author fullname="N. Bahadur" initials="N." surname="Bahadur"/>
            <author fullname="H. Ananthakrishnan" initials="H." surname="Ananthakrishnan"/>
            <author fullname="X. Liu" initials="X." surname="Liu"/>
            <date month="March" year="2018"/>
            <abstract>
              <t>This document defines an abstract (generic, or base) YANG data model for network/service topologies and inventories. The data model serves as a base model that is augmented with technology-specific details in other, more specific topology and inventory data models.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8345"/>
          <seriesInfo name="DOI" value="10.17487/RFC8345"/>
        </reference>
        <reference anchor="RFC8650">
          <front>
            <title>Dynamic Subscription to YANG Events and Datastores over RESTCONF</title>
            <author fullname="E. Voit" initials="E." surname="Voit"/>
            <author fullname="R. Rahman" initials="R." surname="Rahman"/>
            <author fullname="E. Nilsen-Nygaard" initials="E." surname="Nilsen-Nygaard"/>
            <author fullname="A. Clemm" initials="A." surname="Clemm"/>
            <author fullname="A. Bierman" initials="A." surname="Bierman"/>
            <date month="November" year="2019"/>
            <abstract>
              <t>This document provides a RESTCONF binding to the dynamic subscription capability of both subscribed notifications and YANG-Push.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8650"/>
          <seriesInfo name="DOI" value="10.17487/RFC8650"/>
        </reference>
        <reference anchor="RFC8641">
          <front>
            <title>Subscription to YANG Notifications for Datastore Updates</title>
            <author fullname="A. Clemm" initials="A." surname="Clemm"/>
            <author fullname="E. Voit" initials="E." surname="Voit"/>
            <date month="September" year="2019"/>
            <abstract>
              <t>This document describes a mechanism that allows subscriber applications to request a continuous and customized stream of updates from a YANG datastore. Providing such visibility into updates enables new capabilities based on the remote mirroring and monitoring of configuration and operational state.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8641"/>
          <seriesInfo name="DOI" value="10.17487/RFC8641"/>
        </reference>
        <reference anchor="RFC7923">
          <front>
            <title>Requirements for Subscription to YANG Datastores</title>
            <author fullname="E. Voit" initials="E." surname="Voit"/>
            <author fullname="A. Clemm" initials="A." surname="Clemm"/>
            <author fullname="A. Gonzalez Prieto" initials="A." surname="Gonzalez Prieto"/>
            <date month="June" year="2016"/>
            <abstract>
              <t>This document provides requirements for a service that allows client applications to subscribe to updates of a YANG datastore. Based on criteria negotiated as part of a subscription, updates will be pushed to targeted recipients. Such a capability eliminates the need for periodic polling of YANG datastores by applications and fills a functional gap in existing YANG transports (i.e., Network Configuration Protocol (NETCONF) and RESTCONF). Such a service can be summarized as a "pub/sub" service for YANG datastore updates. Beyond a set of basic requirements for the service, various refinements are addressed. These refinements include: periodicity of object updates, filtering out of objects underneath a requested a subtree, and delivery QoS guarantees.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="7923"/>
          <seriesInfo name="DOI" value="10.17487/RFC7923"/>
        </reference>
        <reference anchor="RFC8346">
          <front>
            <title>A YANG Data Model for Layer 3 Topologies</title>
            <author fullname="A. Clemm" initials="A." surname="Clemm"/>
            <author fullname="J. Medved" initials="J." surname="Medved"/>
            <author fullname="R. Varga" initials="R." surname="Varga"/>
            <author fullname="X. Liu" initials="X." surname="Liu"/>
            <author fullname="H. Ananthakrishnan" initials="H." surname="Ananthakrishnan"/>
            <author fullname="N. Bahadur" initials="N." surname="Bahadur"/>
            <date month="March" year="2018"/>
            <abstract>
              <t>This document defines a YANG data model for Layer 3 network topologies.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8346"/>
          <seriesInfo name="DOI" value="10.17487/RFC8346"/>
        </reference>
      </references>
      <references anchor="sec-informative-references">
        <name>Informative References</name>
        <reference anchor="IEEE_802.1AE" target="https://standards.ieee.org/standard/802_1AE-2018.html">
          <front>
            <title>IEEE Standard for Local and metropolitan area networks - Media Access Control (MAC) Security</title>
            <author>
              <organization>Institute of Electrical and Electronics Engineers</organization>
            </author>
            <date year="2018" month="December"/>
          </front>
          <seriesInfo name="IEEE 802.1AE-2018" value=""/>
        </reference>
        <reference anchor="RFC8309">
          <front>
            <title>Service Models Explained</title>
            <author fullname="Q. Wu" initials="Q." surname="Wu"/>
            <author fullname="W. Liu" initials="W." surname="Liu"/>
            <author fullname="A. Farrel" initials="A." surname="Farrel"/>
            <date month="January" year="2018"/>
            <abstract>
              <t>The IETF has produced many modules in the YANG modeling language. The majority of these modules are used to construct data models to model devices or monolithic functions.</t>
              <t>A small number of YANG modules have been defined to model services (for example, the Layer 3 Virtual Private Network Service Model (L3SM) produced by the L3SM working group and documented in RFC 8049).</t>
              <t>This document describes service models as used within the IETF and also shows where a service model might fit into a software-defined networking architecture. Note that service models do not make any assumption of how a service is actually engineered and delivered for a customer; details of how network protocols and devices are engineered to deliver a service are captured in other modules that are not exposed through the interface between the customer and the provider.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8309"/>
          <seriesInfo name="DOI" value="10.17487/RFC8309"/>
        </reference>
        <reference anchor="RFC4397">
          <front>
            <title>A Lexicography for the Interpretation of Generalized Multiprotocol Label Switching (GMPLS) Terminology within the Context of the ITU-T's Automatically Switched Optical Network (ASON) Architecture</title>
            <author fullname="I. Bryskin" initials="I." surname="Bryskin"/>
            <author fullname="A. Farrel" initials="A." surname="Farrel"/>
            <date month="February" year="2006"/>
            <abstract>
              <t>Generalized Multiprotocol Label Switching (GMPLS) has been developed by the IETF to facilitate the establishment of Label Switched Paths (LSPs) in a variety of data plane technologies and across several architectural models. The ITU-T has specified an architecture for the control of Automatically Switched Optical Networks (ASON).</t>
              <t>This document provides a lexicography for the interpretation of GMPLS terminology within the context of the ASON architecture.</t>
              <t>It is important to note that GMPLS is applicable in a wider set of contexts than just ASON. The definitions presented in this document do not provide exclusive or complete interpretations of GMPLS concepts. This document simply allows the GMPLS terms to be applied within the ASON context. This memo provides information for the Internet community.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="4397"/>
          <seriesInfo name="DOI" value="10.17487/RFC4397"/>
        </reference>
        <reference anchor="RFC1930">
          <front>
            <title>Guidelines for creation, selection, and registration of an Autonomous System (AS)</title>
            <author fullname="J. Hawkinson" initials="J." surname="Hawkinson"/>
            <author fullname="T. Bates" initials="T." surname="Bates"/>
            <date month="March" year="1996"/>
            <abstract>
              <t>This memo discusses when it is appropriate to register and utilize an Autonomous System (AS), and lists criteria for such. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="6"/>
          <seriesInfo name="RFC" value="1930"/>
          <seriesInfo name="DOI" value="10.17487/RFC1930"/>
        </reference>
        <reference anchor="RFC7424">
          <front>
            <title>Mechanisms for Optimizing Link Aggregation Group (LAG) and Equal-Cost Multipath (ECMP) Component Link Utilization in Networks</title>
            <author fullname="R. Krishnan" initials="R." surname="Krishnan"/>
            <author fullname="L. Yong" initials="L." surname="Yong"/>
            <author fullname="A. Ghanwani" initials="A." surname="Ghanwani"/>
            <author fullname="N. So" initials="N." surname="So"/>
            <author fullname="B. Khasnabish" initials="B." surname="Khasnabish"/>
            <date month="January" year="2015"/>
            <abstract>
              <t>Demands on networking infrastructure are growing exponentially due to bandwidth-hungry applications such as rich media applications and inter-data-center communications. In this context, it is important to optimally use the bandwidth in wired networks that extensively use link aggregation groups and equal-cost multipaths as techniques for bandwidth scaling. This document explores some of the mechanisms useful for achieving this.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="7424"/>
          <seriesInfo name="DOI" value="10.17487/RFC7424"/>
        </reference>
        <reference anchor="RFC2991">
          <front>
            <title>Multipath Issues in Unicast and Multicast Next-Hop Selection</title>
            <author fullname="D. Thaler" initials="D." surname="Thaler"/>
            <author fullname="C. Hopps" initials="C." surname="Hopps"/>
            <date month="November" year="2000"/>
            <abstract>
              <t>The effect of multipath routing on a forwarder is that the forwarder potentially has several next-hops for any given destination and must use some method to choose which next-hop should be used for a given data packet. This memo summarizes current practices, problems, and solutions. This memo provides information for the Internet community.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="2991"/>
          <seriesInfo name="DOI" value="10.17487/RFC2991"/>
        </reference>
        <reference anchor="I-D.ietf-ccamp-optical-impairment-topology-yang">
          <front>
            <title>A YANG Data Model for Optical Impairment-aware Topology</title>
            <author fullname="Dieter Beller" initials="D." surname="Beller">
              <organization>Nokia</organization>
            </author>
            <author fullname="Esther Le Rouzic" initials="E." surname="Le Rouzic">
              <organization>Orange</organization>
            </author>
            <author fullname="Sergio Belotti" initials="S." surname="Belotti">
              <organization>Nokia</organization>
            </author>
            <author fullname="Gabriele Galimberti" initials="G." surname="Galimberti">
              <organization>Nokia</organization>
            </author>
            <author fullname="Italo Busi" initials="I." surname="Busi">
              <organization>Huawei Technologies</organization>
            </author>
            <date day="27" month="February" year="2026"/>
            <abstract>
              <t>   In order to provision an optical connection through optical networks,
   a combination of path continuity, resource availability, and
   impairment constraints must be met to determine viable and optimal
   paths through the network.  The determination of appropriate paths is
   known as Impairment-Aware Routing and Wavelength Assignment (IA-RWA)
   for a Wavelength Switched Optical Network (WSON), while it is known
   as Impairment-Aware Routing and Spectrum Assignment (IA-RSA) for a
   Spectrum Switched Optical Network (SSON).

   This document provides a YANG data model for the impairment-aware
   Traffic Engineering topology (TE topology) in optical networks.  It
   augments the technology agnostic YANG Data Model for TE topologies.
   The topology YANG model provides read-only topology data including
   optical impairments that can be used for example by a Path
   Computation Engine (PCE) for calculating an optically feasible path
   for a new connection before it is established through an optical
   network.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-ccamp-optical-impairment-topology-yang-23"/>
        </reference>
        <reference anchor="RFC8277">
          <front>
            <title>Using BGP to Bind MPLS Labels to Address Prefixes</title>
            <author fullname="E. Rosen" initials="E." surname="Rosen"/>
            <date month="October" year="2017"/>
            <abstract>
              <t>This document specifies a set of procedures for using BGP to advertise that a specified router has bound a specified MPLS label (or a specified sequence of MPLS labels organized as a contiguous part of a label stack) to a specified address prefix. This can be done by sending a BGP UPDATE message whose Network Layer Reachability Information field contains both the prefix and the MPLS label(s) and whose Next Hop field identifies the node at which said prefix is bound to said label(s). This document obsoletes RFC 3107.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8277"/>
          <seriesInfo name="DOI" value="10.17487/RFC8277"/>
        </reference>
        <reference anchor="RFC8001">
          <front>
            <title>RSVP-TE Extensions for Collecting Shared Risk Link Group (SRLG) Information</title>
            <author fullname="F. Zhang" initials="F." role="editor" surname="Zhang"/>
            <author fullname="O. Gonzalez de Dios" initials="O." role="editor" surname="Gonzalez de Dios"/>
            <author fullname="C. Margaria" initials="C." surname="Margaria"/>
            <author fullname="M. Hartley" initials="M." surname="Hartley"/>
            <author fullname="Z. Ali" initials="Z." surname="Ali"/>
            <date month="January" year="2017"/>
            <abstract>
              <t>This document provides extensions for Resource Reservation Protocol - Traffic Engineering (RSVP-TE), including GMPLS, to support automatic collection of Shared Risk Link Group (SRLG) information for the TE link formed by a Label Switched Path (LSP).</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8001"/>
          <seriesInfo name="DOI" value="10.17487/RFC8001"/>
        </reference>
        <reference anchor="RFC9543">
          <front>
            <title>A Framework for Network Slices in Networks Built from IETF Technologies</title>
            <author fullname="A. Farrel" initials="A." role="editor" surname="Farrel"/>
            <author fullname="J. Drake" initials="J." role="editor" surname="Drake"/>
            <author fullname="R. Rokui" initials="R." surname="Rokui"/>
            <author fullname="S. Homma" initials="S." surname="Homma"/>
            <author fullname="K. Makhijani" initials="K." surname="Makhijani"/>
            <author fullname="L. Contreras" initials="L." surname="Contreras"/>
            <author fullname="J. Tantsura" initials="J." surname="Tantsura"/>
            <date month="March" year="2024"/>
            <abstract>
              <t>This document describes network slicing in the context of networks built from IETF technologies. It defines the term "IETF Network Slice" to describe this type of network slice and establishes the general principles of network slicing in the IETF context.</t>
              <t>The document discusses the general framework for requesting and operating IETF Network Slices, the characteristics of an IETF Network Slice, the necessary system components and interfaces, and the mapping of abstract requests to more specific technologies. The document also discusses related considerations with monitoring and security.</t>
              <t>This document also provides definitions of related terms to enable consistent usage in other IETF documents that describe or use aspects of IETF Network Slices.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="9543"/>
          <seriesInfo name="DOI" value="10.17487/RFC9543"/>
        </reference>
        <reference anchor="I-D.ietf-ccamp-eth-client-te-topo-yang">
          <front>
            <title>A YANG Data Model for Ethernet TE Topology</title>
            <author fullname="Chaode Yu" initials="C." surname="Yu">
              <organization>Huawei Technologies</organization>
            </author>
            <author fullname="Haomian Zheng" initials="H." surname="Zheng">
              <organization>Huawei Technologies</organization>
            </author>
            <author fullname="Aihua Guo" initials="A." surname="Guo">
              <organization>Futurewei</organization>
            </author>
            <author fullname="Italo Busi" initials="I." surname="Busi">
              <organization>Huawei Technologies</organization>
            </author>
            <author fullname="Yunbin Xu" initials="Y." surname="Xu">
              <organization>CAICT</organization>
            </author>
            <author fullname="Yang Zhao" initials="Y." surname="Zhao">
              <organization>China Mobile</organization>
            </author>
            <author fullname="Xufeng Liu" initials="X." surname="Liu">
              <organization>Alef Edge</organization>
            </author>
            <date day="13" month="April" year="2026"/>
            <abstract>
              <t>   This document describes a YANG data model for Ethernet networks when
   used either as a client-layer network of an underlay transport
   network (e.g., an Optical Transport Network (OTN)) or as a transport
   network itself.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-ccamp-eth-client-te-topo-yang-11"/>
        </reference>
        <reference anchor="RFC9094">
          <front>
            <title>A YANG Data Model for Wavelength Switched Optical Networks (WSONs)</title>
            <author fullname="H. Zheng" initials="H." surname="Zheng"/>
            <author fullname="Y. Lee" initials="Y." surname="Lee"/>
            <author fullname="A. Guo" initials="A." surname="Guo"/>
            <author fullname="V. Lopez" initials="V." surname="Lopez"/>
            <author fullname="D. King" initials="D." surname="King"/>
            <date month="August" year="2021"/>
            <abstract>
              <t>This document provides a YANG data model for the routing and wavelength assignment (RWA) TE topology in Wavelength Switched Optical Networks (WSONs). The YANG data model defined in this document conforms to the Network Management Datastore Architecture (NMDA).</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="9094"/>
          <seriesInfo name="DOI" value="10.17487/RFC9094"/>
        </reference>
        <reference anchor="I-D.ietf-ccamp-flexigrid-yang">
          <front>
            <title>A YANG Data Model for Flexi-Grid Optical Networks</title>
            <author fullname="Universidad Autonoma de Madrid" initials="U. A." surname="de Madrid">
              <organization>Naudit HPCN</organization>
            </author>
            <author fullname="Daniel Perdices Burrero" initials="D. P." surname="Burrero">
              <organization>Universidad Autonoma de Madrid</organization>
            </author>
            <author fullname="Daniel King" initials="D." surname="King">
              <organization>Old Dog Consulting</organization>
            </author>
            <author fullname="Young Lee" initials="Y." surname="Lee">
              <organization>Samsung</organization>
            </author>
            <author fullname="Haomian Zheng" initials="H." surname="Zheng">
              <organization>Huawei Technologies</organization>
            </author>
            <date day="2" month="February" year="2026"/>
            <abstract>
              <t>   This document defines a YANG module for managing flexi-grid optical
   networks.  The model defined in this document specifies a flexi-grid
   traffic engineering database that is used to describe the topology of
   a flexi-grid network.  It is based on and augments existing YANG
   models that describe network and traffic engineering topologies.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-ccamp-flexigrid-yang-19"/>
        </reference>
        <reference anchor="I-D.ietf-ccamp-otn-topo-yang">
          <front>
            <title>A YANG Data Model for Optical Transport Network Topology</title>
            <author fullname="Haomian Zheng" initials="H." surname="Zheng">
              <organization>Huawei Technologies</organization>
            </author>
            <author fullname="Italo Busi" initials="I." surname="Busi">
              <organization>Huawei Technologies</organization>
            </author>
            <author fullname="Xufeng Liu" initials="X." surname="Liu">
              <organization>Alef Edge</organization>
            </author>
            <author fullname="Sergio Belotti" initials="S." surname="Belotti">
              <organization>Nokia</organization>
            </author>
            <author fullname="Oscar Gonzalez de Dios" initials="O. G." surname="de Dios">
              <organization>Telefonica</organization>
            </author>
            <date day="7" month="November" year="2024"/>
            <abstract>
              <t>   This document defines a YANG data model for representing, retrieving,
   and manipulating Optical Transport Network (OTN) topologies.  It is
   independent of control plane protocols and captures topological and
   resource-related information pertaining to OTN.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-ccamp-otn-topo-yang-20"/>
        </reference>
        <reference anchor="I-D.ietf-ccamp-wdm-tunnel-yang">
          <front>
            <title>A YANG Data Model for WDM Tunnels</title>
            <author fullname="Aihua Guo" initials="A." surname="Guo">
              <organization>Futurewei Technologies</organization>
            </author>
            <author fullname="Sergio Belotti" initials="S." surname="Belotti">
              <organization>Nokia</organization>
            </author>
            <author fullname="Gabriele Galimberti" initials="G." surname="Galimberti">
              <organization>Individual</organization>
            </author>
            <author fullname="Universidad Autonoma de Madrid" initials="U. A." surname="de Madrid">
              <organization>Naudit HPCN</organization>
            </author>
            <author fullname="Daniel Perdices Burrero" initials="D. P." surname="Burrero">
              <organization>Universidad Autonoma de Madrid</organization>
            </author>
            <date day="22" month="April" year="2026"/>
            <abstract>
              <t>   This document defines a YANG data model for the provisioning and
   management of Traffic Engineering (TE) tunnels and Label Switched
   Paths (LSPs) in Optical Networks (Wavelength Switched Optical
   Networks (WSON) and Flexi-Grid Dense Wavelength Division Multiplexing
   (DWDM) Networks).

   The YANG data model defined in this document conforms to the Network
   Management Datastore Architecture (NMDA).

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-ccamp-wdm-tunnel-yang-08"/>
        </reference>
        <reference anchor="I-D.ietf-ccamp-otn-tunnel-model">
          <front>
            <title>A YANG Data Model for Optical Transport Network (OTN) Tunnels and Label Switched Paths</title>
            <author fullname="Haomian Zheng" initials="H." surname="Zheng">
              <organization>Huawei Technologies</organization>
            </author>
            <author fullname="Italo Busi" initials="I." surname="Busi">
              <organization>Huawei Technologies</organization>
            </author>
            <author fullname="Sergio Belotti" initials="S." surname="Belotti">
              <organization>Nokia</organization>
            </author>
            <author fullname="Victor Lopez" initials="V." surname="Lopez">
              <organization>Nokia</organization>
            </author>
            <author fullname="Yunbin Xu" initials="Y." surname="Xu">
              <organization>CAICT</organization>
            </author>
            <date day="27" month="May" year="2026"/>
            <abstract>
              <t>   This document describes the YANG data model for tunnels in OTN TE
   networks.  The model can be used to do the configuration in order to
   establish the tunnel in OTN network.  This work is independent with
   the control plane protocols.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-ccamp-otn-tunnel-model-25"/>
        </reference>
        <reference anchor="I-D.ietf-ccamp-client-signal-yang">
          <front>
            <title>A YANG Data Model for Transport Network Client Signals</title>
            <author fullname="Haomian Zheng" initials="H." surname="Zheng">
              <organization>Huawei Technologies</organization>
            </author>
            <author fullname="Aihua Guo" initials="A." surname="Guo">
              <organization>Futurewei</organization>
            </author>
            <author fullname="Italo Busi" initials="I." surname="Busi">
              <organization>Huawei Technologies</organization>
            </author>
            <author fullname="Anton Snitser" initials="A." surname="Snitser">
              <organization>Cisco</organization>
            </author>
            <author fullname="Chaode Yu" initials="C." surname="Yu">
              <organization>Huawei Technologies</organization>
            </author>
            <date day="4" month="February" year="2026"/>
            <abstract>
              <t>   A transport network is a server-layer network to provide connectivity
   services to its client.  The topology and tunnel information in the
   transport layer has already been defined by generic Traffic-
   engineered models and technology-specific models (e.g., OTN, WSON).
   However, how the client signals are accessing to the network has not
   been described.  These information is necessary to both client and
   provider.

   This draft describes how the client signals are carried over
   transport network and defines YANG data models which are required
   during configuration procedure.  More specifically, several client
   signal (of transport network) models including ETH, STM-n, FC and so
   on, are defined in this draft.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-ccamp-client-signal-yang-17"/>
        </reference>
        <reference anchor="I-D.ietf-teas-yang-l3-te-topo">
          <front>
            <title>YANG Data Model for Layer 3 TE Topologies</title>
            <author fullname="Xufeng Liu" initials="X." surname="Liu">
              <organization>Alef Edge</organization>
            </author>
            <author fullname="Igor Bryskin" initials="I." surname="Bryskin">
              <organization>Individual</organization>
            </author>
            <author fullname="Vishnu Pavan Beeram" initials="V. P." surname="Beeram">
              <organization>Juniper Networks</organization>
            </author>
            <author fullname="Tarek Saad" initials="T." surname="Saad">
              <organization>Cisco Systems Inc</organization>
            </author>
            <author fullname="Himanshu Shah" initials="H." surname="Shah">
              <organization>Ciena</organization>
            </author>
            <author fullname="Oscar Gonzalez de Dios" initials="O. G." surname="de Dios">
              <organization>Telefonica</organization>
            </author>
            <date day="7" month="July" year="2024"/>
            <abstract>
              <t>   This document defines a YANG data model for layer 3 traffic
   engineering topologies.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-teas-yang-l3-te-topo-18"/>
        </reference>
        <reference anchor="I-D.ietf-teas-yang-te-mpls-topology">
          <front>
            <title>A YANG Data Model for MPLS-TE Topology</title>
            <author fullname="Italo Busi" initials="I." surname="Busi">
              <organization>Huawei Technologies</organization>
            </author>
            <author fullname="Aihua Guo" initials="A." surname="Guo">
              <organization>Futurewei Inc.</organization>
            </author>
            <author fullname="Xufeng Liu" initials="X." surname="Liu">
              <organization>Alef Edge</organization>
            </author>
            <author fullname="Tarek Saad" initials="T." surname="Saad">
              <organization>Cisco Systems, Inc.</organization>
            </author>
            <author fullname="Rakesh Gandhi" initials="R." surname="Gandhi">
              <organization>Cisco Systems, Inc.</organization>
            </author>
            <date day="1" month="March" year="2026"/>
            <abstract>
              <t>   This document defines a YANG data model for representing, retrieving,
   and manipulating MPLS-TE network topologies.  It is based on and
   augments existing YANG models that describe network and traffic
   engineering packet network topologies.

   This document also defines a collection of common YANG data types and
   groupings specific to MPLS-TE.  These common types and groupings are
   intended to be imported by modules that model MPLS-TE technology-
   specific configuration and state capabilities.

   The YANG models defined in this document can also be used for MPLS
   Transport Profile (MPLS-TP) network topologies.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-teas-yang-te-mpls-topology-04"/>
        </reference>
        <reference anchor="I-D.ietf-teas-yang-sr-te-topo">
          <front>
            <title>YANG Data Model for SR and SR TE Topologies on MPLS Data Plane</title>
            <author fullname="Xufeng Liu" initials="X." surname="Liu">
              <organization>Alef Edge</organization>
            </author>
            <author fullname="Igor Bryskin" initials="I." surname="Bryskin">
              <organization>Individual</organization>
            </author>
            <author fullname="Vishnu Pavan Beeram" initials="V. P." surname="Beeram">
              <organization>Juniper Networks</organization>
            </author>
            <author fullname="Tarek Saad" initials="T." surname="Saad">
              <organization>Juniper Networks</organization>
            </author>
            <author fullname="Himanshu Shah" initials="H." surname="Shah">
              <organization>Ciena</organization>
            </author>
            <author fullname="Stephane Litkowski" initials="S." surname="Litkowski">
              <organization>Cisco</organization>
            </author>
            <date day="4" month="July" year="2024"/>
            <abstract>
              <t>   This document defines a YANG data model for Segment Routing (SR)
   topology and Segment Routing (SR) traffic engineering (TE) topology,
   using MPLS data plane.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-teas-yang-sr-te-topo-19"/>
        </reference>
        <reference anchor="I-D.ietf-teas-yang-te-mpls">
          <front>
            <title>A YANG Data Model for MPLS Traffic Engineering Tunnels</title>
            <author fullname="Tarek Saad" initials="T." surname="Saad">
              <organization>Cisco Systems Inc</organization>
            </author>
            <author fullname="Rakesh Gandhi" initials="R." surname="Gandhi">
              <organization>Cisco Systems Inc</organization>
            </author>
            <author fullname="Xufeng Liu" initials="X." surname="Liu">
              <organization>IBM Corporation</organization>
            </author>
            <author fullname="Vishnu Pavan Beeram" initials="V. P." surname="Beeram">
              <organization>Juniper Networks</organization>
            </author>
            <author fullname="Igor Bryskin" initials="I." surname="Bryskin">
              <organization>Individual</organization>
            </author>
            <date day="26" month="May" year="2023"/>
            <abstract>
              <t>   This document defines a YANG data model for the configuration and
   management of Multiprotocol Label Switching (MPLS) Traffic
   Engineering (TE) tunnels, Label Switched Paths (LSPs) and interfaces.
   The model augments the TE generic YANG model for MPLS packet
   dataplane technology.

   This model covers data for configuration, operational state, remote
   procedural calls, and event notifications.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-teas-yang-te-mpls-04"/>
        </reference>
        <reference anchor="RFC9182">
          <front>
            <title>A YANG Network Data Model for Layer 3 VPNs</title>
            <author fullname="S. Barguil" initials="S." surname="Barguil"/>
            <author fullname="O. Gonzalez de Dios" initials="O." role="editor" surname="Gonzalez de Dios"/>
            <author fullname="M. Boucadair" initials="M." role="editor" surname="Boucadair"/>
            <author fullname="L. Munoz" initials="L." surname="Munoz"/>
            <author fullname="A. Aguado" initials="A." surname="Aguado"/>
            <date month="February" year="2022"/>
            <abstract>
              <t>As a complement to the Layer 3 Virtual Private Network Service Model (L3SM), which is used for communication between customers and service providers, this document defines an L3VPN Network Model (L3NM) that can be used for the provisioning of Layer 3 Virtual Private Network (L3VPN) services within a service provider network. The model provides a network-centric view of L3VPN services.</t>
              <t>The L3NM is meant to be used by a network controller to derive the configuration information that will be sent to relevant network devices. The model can also facilitate communication between a service orchestrator and a network controller/orchestrator.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="9182"/>
          <seriesInfo name="DOI" value="10.17487/RFC9182"/>
        </reference>
        <reference anchor="I-D.ietf-teas-te-service-mapping-yang">
          <front>
            <title>Traffic Engineering (TE) and Service Mapping YANG Data Model</title>
            <author fullname="Young Lee" initials="Y." surname="Lee">
              <organization>Samsung Electronics</organization>
            </author>
            <author fullname="Dhruv Dhody" initials="D." surname="Dhody">
              <organization>Huawei</organization>
            </author>
            <author fullname="Giuseppe Fioccola" initials="G." surname="Fioccola">
              <organization>Huawei</organization>
            </author>
            <author fullname="Qin Wu" initials="Q." surname="Wu">
              <organization>Huawei</organization>
            </author>
            <author fullname="Daniele Ceccarelli" initials="D." surname="Ceccarelli">
              <organization>Cisco</organization>
            </author>
            <author fullname="Jeff Tantsura" initials="J." surname="Tantsura">
              <organization>Nvidia</organization>
            </author>
            <date day="12" month="October" year="2025"/>
            <abstract>
              <t>   This document provides a YANG data model to map customer service
   models (e.g., L3VPN Service Delivery model) to Traffic Engineering
   (TE) models (e.g., the TE Tunnel or the Virtual Network (VN) model).
   These models are referred to as the TE Service Mapping Model and are
   applicable generically to the operator's need for seamless control
   and management of their VPN services with underlying TE support.

   The models are principally used for monitoring and diagnostics of the
   management systems to show how the service requests are mapped onto
   underlying network resources and TE models.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-teas-te-service-mapping-yang-18"/>
        </reference>
        <reference anchor="RFC9291">
          <front>
            <title>A YANG Network Data Model for Layer 2 VPNs</title>
            <author fullname="M. Boucadair" initials="M." role="editor" surname="Boucadair"/>
            <author fullname="O. Gonzalez de Dios" initials="O." role="editor" surname="Gonzalez de Dios"/>
            <author fullname="S. Barguil" initials="S." surname="Barguil"/>
            <author fullname="L. Munoz" initials="L." surname="Munoz"/>
            <date month="September" year="2022"/>
            <abstract>
              <t>This document defines an L2VPN Network Model (L2NM) that can be used to manage the provisioning of Layer 2 Virtual Private Network (L2VPN) services within a network (e.g., a service provider network). The L2NM complements the L2VPN Service Model (L2SM) by providing a network-centric view of the service that is internal to a service provider. The L2NM is particularly meant to be used by a network controller to derive the configuration information that will be sent to relevant network devices.</t>
              <t>Also, this document defines a YANG module to manage Ethernet segments and the initial versions of two IANA-maintained modules that include a set of identities of BGP Layer 2 encapsulation types and pseudowire types.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="9291"/>
          <seriesInfo name="DOI" value="10.17487/RFC9291"/>
        </reference>
        <reference anchor="RFC8637">
          <front>
            <title>Applicability of the Path Computation Element (PCE) to the Abstraction and Control of TE Networks (ACTN)</title>
            <author fullname="D. Dhody" initials="D." surname="Dhody"/>
            <author fullname="Y. Lee" initials="Y." surname="Lee"/>
            <author fullname="D. Ceccarelli" initials="D." surname="Ceccarelli"/>
            <date month="July" year="2019"/>
            <abstract>
              <t>Abstraction and Control of TE Networks (ACTN) refers to the set of virtual network (VN) operations needed to orchestrate, control, and manage large-scale multidomain TE networks so as to facilitate network programmability, automation, efficient resource sharing, and end-to-end virtual service-aware connectivity and network function virtualization services.</t>
              <t>The Path Computation Element (PCE) is a component, application, or network node that is capable of computing a network path or route based on a network graph and applying computational constraints. The PCE serves requests from Path Computation Clients (PCCs) that communicate with it over a local API or using the Path Computation Element Communication Protocol (PCEP).</t>
              <t>This document examines the applicability of PCE to the ACTN framework.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8637"/>
          <seriesInfo name="DOI" value="10.17487/RFC8637"/>
        </reference>
        <reference anchor="RFC5440">
          <front>
            <title>Path Computation Element (PCE) Communication Protocol (PCEP)</title>
            <author fullname="JP. Vasseur" initials="JP." role="editor" surname="Vasseur"/>
            <author fullname="JL. Le Roux" initials="JL." role="editor" surname="Le Roux"/>
            <date month="March" year="2009"/>
            <abstract>
              <t>This document specifies the Path Computation Element (PCE) Communication Protocol (PCEP) for communications between a Path Computation Client (PCC) and a PCE, or between two PCEs. Such interactions include path computation requests and path computation replies as well as notifications of specific states related to the use of a PCE in the context of Multiprotocol Label Switching (MPLS) and Generalized MPLS (GMPLS) Traffic Engineering. PCEP is designed to be flexible and extensible so as to easily allow for the addition of further messages and objects, should further requirements be expressed in the future. [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="5440"/>
          <seriesInfo name="DOI" value="10.17487/RFC5440"/>
        </reference>
        <reference anchor="RFC8231">
          <front>
            <title>Path Computation Element Communication Protocol (PCEP) Extensions for Stateful PCE</title>
            <author fullname="E. Crabbe" initials="E." surname="Crabbe"/>
            <author fullname="I. Minei" initials="I." surname="Minei"/>
            <author fullname="J. Medved" initials="J." surname="Medved"/>
            <author fullname="R. Varga" initials="R." surname="Varga"/>
            <date month="September" year="2017"/>
            <abstract>
              <t>The Path Computation Element Communication Protocol (PCEP) provides mechanisms for Path Computation Elements (PCEs) to perform path computations in response to Path Computation Client (PCC) requests.</t>
              <t>Although PCEP explicitly makes no assumptions regarding the information available to the PCE, it also makes no provisions for PCE control of timing and sequence of path computations within and across PCEP sessions. This document describes a set of extensions to PCEP to enable stateful control of MPLS-TE and GMPLS Label Switched Paths (LSPs) via PCEP.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8231"/>
          <seriesInfo name="DOI" value="10.17487/RFC8231"/>
        </reference>
        <reference anchor="RFC8281">
          <front>
            <title>Path Computation Element Communication Protocol (PCEP) Extensions for PCE-Initiated LSP Setup in a Stateful PCE Model</title>
            <author fullname="E. Crabbe" initials="E." surname="Crabbe"/>
            <author fullname="I. Minei" initials="I." surname="Minei"/>
            <author fullname="S. Sivabalan" initials="S." surname="Sivabalan"/>
            <author fullname="R. Varga" initials="R." surname="Varga"/>
            <date month="December" year="2017"/>
            <abstract>
              <t>The Path Computation Element Communication Protocol (PCEP) provides mechanisms for Path Computation Elements (PCEs) to perform path computations in response to Path Computation Client (PCC) requests.</t>
              <t>The extensions for stateful PCE provide active control of Multiprotocol Label Switching (MPLS) Traffic Engineering Label Switched Paths (TE LSPs) via PCEP, for a model where the PCC delegates control over one or more locally configured LSPs to the PCE. This document describes the creation and deletion of PCE-initiated LSPs under the stateful PCE model.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8281"/>
          <seriesInfo name="DOI" value="10.17487/RFC8281"/>
        </reference>
        <reference anchor="RFC8751">
          <front>
            <title>Hierarchical Stateful Path Computation Element (PCE)</title>
            <author fullname="D. Dhody" initials="D." surname="Dhody"/>
            <author fullname="Y. Lee" initials="Y." surname="Lee"/>
            <author fullname="D. Ceccarelli" initials="D." surname="Ceccarelli"/>
            <author fullname="J. Shin" initials="J." surname="Shin"/>
            <author fullname="D. King" initials="D." surname="King"/>
            <date month="March" year="2020"/>
            <abstract>
              <t>A stateful Path Computation Element (PCE) maintains information on the current network state received from the Path Computation Clients (PCCs), including computed Label Switched Paths (LSPs), reserved resources within the network, and pending path computation requests. This information may then be considered when computing the path for a new traffic-engineered LSP or for any associated/dependent LSPs. The path-computation response from a PCE helps the PCC to gracefully establish the computed LSP.</t>
              <t>The Hierarchical Path Computation Element (H-PCE) architecture allows the optimum sequence of interconnected domains to be selected and network policy to be applied if applicable, via the use of a hierarchical relationship between PCEs.</t>
              <t>Combining the capabilities of stateful PCE and the hierarchical PCE would be advantageous. This document describes general considerations and use cases for the deployment of stateful, but not stateless, PCEs using the hierarchical PCE architecture.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8751"/>
          <seriesInfo name="DOI" value="10.17487/RFC8751"/>
        </reference>
        <reference anchor="RFC8283">
          <front>
            <title>An Architecture for Use of PCE and the PCE Communication Protocol (PCEP) in a Network with Central Control</title>
            <author fullname="A. Farrel" initials="A." role="editor" surname="Farrel"/>
            <author fullname="Q. Zhao" initials="Q." role="editor" surname="Zhao"/>
            <author fullname="Z. Li" initials="Z." surname="Li"/>
            <author fullname="C. Zhou" initials="C." surname="Zhou"/>
            <date month="December" year="2017"/>
            <abstract>
              <t>The Path Computation Element (PCE) is a core component of Software- Defined Networking (SDN) systems. It can compute optimal paths for traffic across a network and can also update the paths to reflect changes in the network or traffic demands.</t>
              <t>PCE was developed to derive paths for MPLS Label Switched Paths (LSPs), which are supplied to the head end of the LSP using the Path Computation Element Communication Protocol (PCEP).</t>
              <t>SDN has a broader applicability than signaled MPLS traffic-engineered (TE) networks, and the PCE may be used to determine paths in a range of use cases including static LSPs, segment routing, Service Function Chaining (SFC), and most forms of a routed or switched network. It is, therefore, reasonable to consider PCEP as a control protocol for use in these environments to allow the PCE to be fully enabled as a central controller.</t>
              <t>This document briefly introduces the architecture for PCE as a central controller, examines the motivations and applicability for PCEP as a control protocol in this environment, and introduces the implications for the protocol. A PCE-based central controller can simplify the processing of a distributed control plane by blending it with elements of SDN and without necessarily completely replacing it.</t>
              <t>This document does not describe use cases in detail and does not define protocol extensions: that work is left for other documents.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8283"/>
          <seriesInfo name="DOI" value="10.17487/RFC8283"/>
        </reference>
        <reference anchor="RFC5623">
          <front>
            <title>Framework for PCE-Based Inter-Layer MPLS and GMPLS Traffic Engineering</title>
            <author fullname="E. Oki" initials="E." surname="Oki"/>
            <author fullname="T. Takeda" initials="T." surname="Takeda"/>
            <author fullname="JL. Le Roux" initials="JL." surname="Le Roux"/>
            <author fullname="A. Farrel" initials="A." surname="Farrel"/>
            <date month="September" year="2009"/>
            <abstract>
              <t>A network may comprise multiple layers. It is important to globally optimize network resource utilization, taking into account all layers rather than optimizing resource utilization at each layer independently. This allows better network efficiency to be achieved through a process that we call inter-layer traffic engineering. The Path Computation Element (PCE) can be a powerful tool to achieve inter-layer traffic engineering.</t>
              <t>This document describes a framework for applying the PCE-based architecture to inter-layer Multiprotocol Label Switching (MPLS) and Generalized MPLS (GMPLS) traffic engineering. It provides suggestions for the deployment of PCE in support of multi-layer networks. This document also describes network models where PCE performs inter-layer traffic engineering, and the relationship between PCE and a functional component called the Virtual Network Topology Manager (VNTM). This memo provides information for the Internet community.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="5623"/>
          <seriesInfo name="DOI" value="10.17487/RFC5623"/>
        </reference>
        <reference anchor="I-D.ietf-teas-te-topology-profiles">
          <front>
            <title>Profiles for Traffic Engineering (TE) Topology Data Model and Applicability to non-TE-centric Use Cases</title>
            <author fullname="Italo Busi" initials="I." surname="Busi">
              <organization>Huawei</organization>
            </author>
            <author fullname="Xufeng Liu" initials="X." surname="Liu">
              <organization>Alef Edge</organization>
            </author>
            <author fullname="Igor Bryskin" initials="I." surname="Bryskin">
              <organization>Individual</organization>
            </author>
            <author fullname="Tarek Saad" initials="T." surname="Saad">
              <organization>Cisco Systems Inc</organization>
            </author>
            <author fullname="Oscar Gonzalez de Dios" initials="O. G." surname="de Dios">
              <organization>Telefonica</organization>
            </author>
            <date day="2" month="March" year="2026"/>
            <abstract>
              <t>   This document describes how profiles of the Topology YANG data model,
   defined in RFC8795, can be used to address applications in Traffic
   Engineering aware (TE-aware) deployments, irrespective of whether
   they are TE-centric or not.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-teas-te-topology-profiles-05"/>
        </reference>
        <reference anchor="I-D.ietf-ccamp-transport-nbi-app-statement">
          <front>
            <title>Transport Northbound Interface Applicability Statement</title>
            <author fullname="Italo Busi" initials="I." surname="Busi">
              <organization>Huawei</organization>
            </author>
            <author fullname="Daniel King" initials="D." surname="King">
              <organization>Old Dog Consulting</organization>
            </author>
            <author fullname="Haomian Zheng" initials="H." surname="Zheng">
              <organization>Huawei</organization>
            </author>
            <author fullname="Yunbin Xu" initials="Y." surname="Xu">
              <organization>CAICT</organization>
            </author>
            <date day="10" month="July" year="2023"/>
            <abstract>
              <t>   This document provides an analysis of the applicability of the YANG
   models defined by the IETF (in particular in the Traffic Engineering
   Architecture and Signaling (TEAS) and Common Control and Measurement
   Plane (CCAMP) working groups) to support ODU transit services,
   transparent client services, and Ethernet Private Line/Ethernet
   Virtual Private Line (EPL/EVPL) services over Optical Transport
   Network (OTN) in single and multi-domain network scenarios.

   This document also describes how existing YANG models can be used
   through several worked examples and JSON fragments.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-ccamp-transport-nbi-app-statement-17"/>
        </reference>
        <reference anchor="RFC9408">
          <front>
            <title>A YANG Network Data Model for Service Attachment Points (SAPs)</title>
            <author fullname="M. Boucadair" initials="M." role="editor" surname="Boucadair"/>
            <author fullname="O. Gonzalez de Dios" initials="O." surname="Gonzalez de Dios"/>
            <author fullname="S. Barguil" initials="S." surname="Barguil"/>
            <author fullname="Q. Wu" initials="Q." surname="Wu"/>
            <author fullname="V. Lopez" initials="V." surname="Lopez"/>
            <date month="June" year="2023"/>
            <abstract>
              <t>This document defines a YANG data model for representing an abstract view of the provider network topology that contains the points from which its services can be attached (e.g., basic connectivity, VPN, network slices). Also, the model can be used to retrieve the points where the services are actually being delivered to customers (including peer networks).</t>
              <t>This document augments the 'ietf-network' data model defined in RFC 8345 by adding the concept of Service Attachment Points (SAPs). The SAPs are the network reference points to which network services, such as Layer 3 Virtual Private Network (L3VPN) or Layer 2 Virtual Private Network (L2VPN), can be attached. One or multiple services can be bound to the same SAP. Both User-to-Network Interface (UNI) and Network-to-Network Interface (NNI) are supported in the SAP data model.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="9408"/>
          <seriesInfo name="DOI" value="10.17487/RFC9408"/>
        </reference>
        <reference anchor="RFC4090">
          <front>
            <title>Fast Reroute Extensions to RSVP-TE for LSP Tunnels</title>
            <author fullname="P. Pan" initials="P." role="editor" surname="Pan"/>
            <author fullname="G. Swallow" initials="G." role="editor" surname="Swallow"/>
            <author fullname="A. Atlas" initials="A." role="editor" surname="Atlas"/>
            <date month="May" year="2005"/>
            <abstract>
              <t>This document defines RSVP-TE extensions to establish backup label-switched path (LSP) tunnels for local repair of LSP tunnels. These mechanisms enable the re-direction of traffic onto backup LSP tunnels in 10s of milliseconds, in the event of a failure.</t>
              <t>Two methods are defined here. The one-to-one backup method creates detour LSPs for each protected LSP at each potential point of local repair. The facility backup method creates a bypass tunnel to protect a potential failure point; by taking advantage of MPLS label stacking, this bypass tunnel can protect a set of LSPs that have similar backup constraints. Both methods can be used to protect links and nodes during network failure. The described behavior and extensions to RSVP allow nodes to implement either method or both and to interoperate in a mixed network. [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="4090"/>
          <seriesInfo name="DOI" value="10.17487/RFC4090"/>
        </reference>
        <reference anchor="I-D.ietf-rtgwg-segment-routing-ti-lfa">
          <front>
            <title>Topology Independent Fast Reroute using Segment Routing</title>
            <author fullname="Ahmed Bashandy" initials="A." surname="Bashandy">
              <organization>Individual</organization>
            </author>
            <author fullname="Stephane Litkowski" initials="S." surname="Litkowski">
              <organization>Cisco Systems</organization>
            </author>
            <author fullname="Clarence Filsfils" initials="C." surname="Filsfils">
              <organization>Cisco Systems</organization>
            </author>
            <author fullname="Pierre Francois" initials="P." surname="Francois">
              <organization>INSA Lyon</organization>
            </author>
            <author fullname="Bruno Decraene" initials="B." surname="Decraene">
              <organization>Orange</organization>
            </author>
            <author fullname="Daniel Voyer" initials="D." surname="Voyer">
              <organization>Bell Canada</organization>
            </author>
            <date day="12" month="February" year="2025"/>
            <abstract>
              <t>   This document presents Topology Independent Loop-free Alternate Fast
   Reroute (TI-LFA), aimed at providing protection of node and adjacency
   segments within the Segment Routing (SR) framework.  This Fast
   Reroute (FRR) behavior builds on proven IP Fast Reroute concepts
   being LFAs, remote LFAs (RLFA), and remote LFAs with directed
   forwarding (DLFA).  It extends these concepts to provide guaranteed
   coverage in any two-connected networks using a link-state IGP.  An
   important aspect of TI-LFA is the FRR path selection approach
   establishing protection over the expected post-convergence paths from
   the point of local repair, reducing the operational need to control
   the tie-breaks among various FRR options.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-rtgwg-segment-routing-ti-lfa-21"/>
        </reference>
        <reference anchor="I-D.ietf-ivy-network-inventory-yang">
          <front>
            <title>A Base YANG Data Model for Network Inventory</title>
            <author fullname="Chaode Yu" initials="C." surname="Yu">
              <organization>Huawei Technologies</organization>
            </author>
            <author fullname="Sergio Belotti" initials="S." surname="Belotti">
              <organization>Nokia</organization>
            </author>
            <author fullname="Jean-Francois Bouquier" initials="J." surname="Bouquier">
              <organization>Vodafone</organization>
            </author>
            <author fullname="Fabio Peruzzini" initials="F." surname="Peruzzini">
              <organization>FiberCop</organization>
            </author>
            <author fullname="Phil Bedard" initials="P." surname="Bedard">
              <organization>Cisco</organization>
            </author>
            <date day="27" month="May" year="2026"/>
            <abstract>
              <t>   This document defines a base YANG data model for reporting network
   inventory.  The scope of this base model is set to be application-
   and technology-agnostic.  The base data model can be augmented with
   application- and technology-specific details.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-ivy-network-inventory-yang-18"/>
        </reference>
        <reference anchor="I-D.ietf-ccamp-optical-path-computation-yang">
          <front>
            <title>YANG Data Models for requesting Path Computation in WDM Optical Networks</title>
            <author fullname="Italo Busi" initials="I." surname="Busi">
              <organization>Huawei Technologies</organization>
            </author>
            <author fullname="Aihua Guo" initials="A." surname="Guo">
              <organization>Futurewei Technologies</organization>
            </author>
            <author fullname="Sergio Belotti" initials="S." surname="Belotti">
              <organization>Nokia</organization>
            </author>
            <date day="27" month="February" year="2026"/>
            <abstract>
              <t>   This document provides a mechanism to request path computation in
   Wavelength-Division Multiplexing (WDM) optical networks composed of
   Wavelength Switched Optical Networks (WSON) and Flexi-Grid Dense
   Wavelength Division Multiplexing (DWDM) switched technologies.  This
   model augments the Remote Procedure Calls (RPCs) defined in RFC YYYY.

   [RFC EDITOR NOTE: Please replace RFC YYYY with the RFC number of
   draft-ietf-teas-yang-path-computation once it has been published.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-ccamp-optical-path-computation-yang-08"/>
        </reference>
        <reference anchor="I-D.poidt-teas-actn-poi-assurance">
          <front>
            <title>Applicability of Abstraction and Control of Traffic Engineered Networks (ACTN) for Packet Optical Integration (POI) service assurance</title>
            <author fullname="Italo Busi" initials="I." surname="Busi">
              <organization>Huawei Technologies</organization>
            </author>
            <author fullname="Jean-Francois Bouquier" initials="J." surname="Bouquier">
              <organization>Vodafone</organization>
            </author>
            <author fullname="Fabio Peruzzini" initials="F." surname="Peruzzini">
              <organization>TIM</organization>
            </author>
            <author fullname="Paolo Volpato" initials="P." surname="Volpato">
              <organization>Huawei Technologies</organization>
            </author>
            <author fullname="Prasenjit Manna" initials="P." surname="Manna">
              <organization>Cisco</organization>
            </author>
            <date day="26" month="February" year="2025"/>
            <abstract>
              <t>   This document extends the analysis of the applicability of
   Abstraction and Control of TE Networks (ACTN) architecture to Packet
   Optical Integration (POI) to cover multi-layer service assurance
   scenarios.  Specifically, the ACTN architecture enables the detection
   and handling of different failures that may happen either at the
   optical or the packet layer.  It is assumed that the underlying
   transport optical network carries end-to-end IP services such as
   L2VPN or L3VPN connectivity services, with specific Service Level
   Agreement (SLA) requirements.

   Existing IETF protocols and data models are identified for each
   multi-layer (packet over optical) service assurance scenario with a
   specific focus on the MPI (Multi-Domain Service Coordinator to
   Provisioning Network Controllers Interface) in the ACTN architecture.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-poidt-teas-actn-poi-assurance-05"/>
        </reference>
        <reference anchor="I-D.ietf-teas-actn-vn-yang">
          <front>
            <title>A YANG Data Model for Virtual Network (VN) Operations</title>
            <author fullname="Young Lee" initials="Y." surname="Lee">
              <organization>Samsung Electronics</organization>
            </author>
            <author fullname="Dhruv Dhody" initials="D." surname="Dhody">
              <organization>Huawei</organization>
            </author>
            <author fullname="Daniele Ceccarelli" initials="D." surname="Ceccarelli">
              <organization>Cisco</organization>
            </author>
            <author fullname="Igor Bryskin" initials="I." surname="Bryskin">
              <organization>Individual</organization>
            </author>
            <author fullname="Bin Yeong Yoon" initials="B. Y." surname="Yoon">
              <organization>ETRI</organization>
            </author>
            <date day="22" month="June" year="2024"/>
            <abstract>
              <t>   A Virtual Network (VN) is a network provided by a service provider to
   a customer for the customer to use in any way it wants as though it
   was a physical network.  This document provides a YANG data model
   generally applicable to any mode of VN operations.  This includes VN
   operations as per the Abstraction and Control of TE Networks (ACTN)
   framework.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-teas-actn-vn-yang-29"/>
        </reference>
      </references>
    </references>
    <?line 2657?>

<section anchor="additional-scenarios">
      <name>Additional Scenarios</name>
      <section anchor="ossorchestration-layer">
        <name>OSS/Orchestration Layer</name>
        <t>The OSS/Orchestration layer is a vital part of the architecture
framework for a service provider:</t>
        <ul spacing="normal">
          <li>
            <t>to abstract (through MDSC and PNCs) the underlying transport
network complexity to the Business Systems Support layer;</t>
          </li>
          <li>
            <t>to coordinate NFV, Transport (e.g. IP, optical and microwave
networks), Fixed Access, Core and Radio domains enabling full
automation of end-to-end services to the end customers;</t>
          </li>
          <li>
            <t>to enable catalogue-driven service provisioning from external
applications (e.g. Customer Portal for Enterprise Business
services), orchestrating the design and lifecycle management of
these end-to-end transport connectivity services, consuming IP
and/or optical transport connectivity services upon request.</t>
          </li>
        </ul>
        <t>As discussed in <xref target="mdsc-overview"/>, in this document, the MDSC interfaces
with the OSS/Orchestration layer and, therefore, it performs the
functions of the Network Orchestrator, defined in <xref target="RFC8309"/>.</t>
        <t>The OSS/Orchestration layer requests the creation of a network
service to the MDSC specifying its end-points (PEs and the interfaces
towards the CEs) as well as the network service SLA and then proceeds
to configuring accordingly the end-to-end customer service between
the CEs in the case of an operator managed service.</t>
        <section anchor="mdsc-nbi">
          <name>MDSC NBI</name>
          <t>As explained in <xref target="reference-network"/>, the OSS/Orchestration layer can
request
the MDSC to setup L2/L3VPN network services (with or without TE
requirements).</t>
          <t>Although the OSS/Orchestration layer interface is usually
operator-specific, typically it would be using a RESTCONF/YANG interface
with a more abstracted version of the MPI YANG data models used for
network configuration (e.g. L3NM, L2NM).</t>
          <t><xref target="fig-service-request"/> shows an example of possible control flow between
the
OSS/Orchestration layer and the MDSC to instantiate L2/L3 VPN network
services, using the YANG data models under the definition in
<xref target="I-D.ietf-teas-actn-vn-yang"/>,
<xref target="RFC9291"/>, <xref target="RFC9182"/> and
<xref target="I-D.ietf-teas-te-service-mapping-yang"/>.</t>
          <figure anchor="fig-service-request">
            <name>Service Request Process</name>
            <artwork type="ascii-art"><![CDATA[
               +-------------------------------------------+
               |                                           |
               |          OSS/Orchestration layer          |
               |                                           |
               +-----------------------+-------------------+
                                       |
                 1.VN    2. L2/L3NM &  |            ^
                   |          TSM      |            |
                   |           |       |            |
                   |           |       |            |
                   v           v       |      3. Update VN
                                       |
               +-----------------------+-------------------+
               |                                           |
               |                  MDSC                     |
               |                                           |
               +-------------------------------------------+
]]></artwork>
          </figure>
          <ul spacing="normal">
            <li>
              <t>The VN YANG data model, defined in <xref target="I-D.ietf-teas-actn-vn-yang"/>,
whose primary focus is
the CMI, can also provide VN Service configuration from an
orchestrated network service point of view when the L2/L3 VPN
network service has TE requirements. However, this model is not
used to setup L2/L3 VPN service with no TE requirements.  </t>
              <ul spacing="normal">
                <li>
                  <t>It provides the profile of VN in terms of VN members, each of
 which corresponds to an edge-to-edge link between customer
 end-points (VNAPs). It also provides the mappings between the
 VNAPs with the LTPs and the connectivity matrix with the VN
 member. The associated traffic matrix (e.g., bandwidth,
 latency, protection level, etc.) of VN member is expressed
 (i.e., via the TE-topology's connectivity matrix).</t>
                </li>
                <li>
                  <t>The model also provides VN-level preference information (e.g.,
 VN member diversity) and VN-level admin-status and
 operational-status.</t>
                </li>
              </ul>
            </li>
            <li>
              <t>The L2NM and L3NM YANG data models, defined in <xref target="RFC9291"/> and
<xref target="RFC9182"/>, whose primary focus is the MPI, can also be used to
provide L2VPN and L3VPN network service configuration from an
orchestrated connectivity service point of view.</t>
            </li>
            <li>
              <t>The TE &amp; Service Mapping YANG data model
<xref target="I-D.ietf-teas-te-service-mapping-yang"/> provides TE-service
mapping.</t>
            </li>
            <li>
              <t>TE-service mapping provides the mapping between a L2/L3 VPN
instance and the corresponding VN instances.</t>
            </li>
            <li>
              <t>The TE-service mapping also provides the binding requirements
as to how each L2/L3 VPN/VN instance is created concerning the
underlay TE tunnels (e.g., whether they require a new and
isolated set of TE underlay tunnels or not).</t>
            </li>
            <li>
              <t>Site mapping provides the site reference information across
L2/L3 VPN Site ID, VN Access Point ID, and the LTP of the
access link.</t>
            </li>
          </ul>
        </section>
      </section>
      <section anchor="multi-layer-and-multi-domain-resiliency">
        <name>Multi-layer and Multi-domain Resiliency</name>
        <section anchor="maintenance-window">
          <name>Maintenance Window</name>
          <t>Before planned maintenance operation on DWDM network takes place, IP
traffic should be moved hitless to another link.</t>
          <t>MDSC must reroute IP traffic before the events takes place. It should
be possible to lock IP traffic to the protection route until the
maintenance event is finished, unless a fault occurs on such path.</t>
        </section>
        <section anchor="router-port-failure">
          <name>Router Port Failure</name>
          <t>The focus is on client-side protection scheme between IP router and
reconfigurable ROADM. Scenario here is to define only one port in the
routers and in the ROADM muxponder board at both ends as back-up
ports to recover any other port failure on client-side of the ROADM
(either on the IP router port side or on the muxponder side or on the
link
between them). When client-side port failure occurs, alarms are
raised to MDSC by IP-PNC and O-PNC (port status down, LOS etc.). MDSC
checks with OP-PNC(s) that there is no optical failure in the optical
layer.</t>
          <t>There can be two cases here:</t>
          <ol spacing="normal" type="1"><li>
              <t>LAG was defined between the IP routers at the two ends. MDSC, after
checking
that optical layer is fine between the two edge WDM nodes, triggers
the WDM edge node re-configuration so that the IP router's back-up port
with its
associated muxponder port can reuse the WDM tunnel that was already in
use previously by the failed IP router port and adds the new link to
the LAG on the failure side.  </t>
              <t>
While the ROADM reconfiguration takes place, IP/MPLS traffic is
using the reduced bandwidth of the IP link bundle, discarding
lower priority traffic if required. Once back-up port has been
reconfigured to reuse the existing WDM tunnel and the new link has
been added
to the LAG then original Bandwidth is recovered between the end
routers.  </t>
              <t>
Note: in this LAG scenario it is assumed that BFD is running at LAG
level so that there is nothing triggered at MPLS level when one of
the link member of the LAG fails.</t>
            </li>
            <li>
              <t>If there is no LAG then the scenario is not clear since an IP router
port failure would automatically trigger (through BFD failure)
first a sub-50ms protection at MPLS level :FRR (MPLS RSVP-TE case)
or TI-LFA (MPLS based SR-TE case) through a protection port. At
the same time MDSC, after checking that optical network connection
is still fine, would trigger the reconfiguration of the back-up
port of the IP router and of the muxponder to re-use the same
WDM tunnel as the one used originally for the failed IP router port. Once
everything has been correctly configured, MDSC Global PCE could
suggest to the operator to trigger a possible re-optimization of
the back-up MPLS path to go back to the  MPLS primary path through
the back-up port of the IP router and the original WDM tunnel if overall
cost, latency etc. is improved. However, in this scenario, there
is a need for protection port PLUS back-up port in the IP router
which does not lead to clear port savings.</t>
            </li>
          </ol>
        </section>
      </section>
      <section anchor="muxponder">
        <name>Muxponders</name>
        <t>The setup of a client connectivity service between two transponders
is relatively clear and its implementation simple.</t>
        <t>There is a one to one relationship between the transponder's client
and trunk (or DWDM) port. The client port bitrate determines the
trunk port bit rate which will also determine the Baud-rate, the
modulation format, the FEC etc.</t>
        <t>The controller, when asked to set up a client connectivity service,
needs to find a WDM tunnel suitable to comply the DWDM port
parameters.</t>
        <t>The setup of a client connectivity service between two muxponders is
different since there is a one to many relationship between the
muxponder's trunk (or DWDM) port and client ports. For example, there
might be a 100Gb/s trunk port shared by ten 10GE client ports.</t>
        <t>The controller, when asked to set a 10GE client connectivity service
between two muxponder's client ports, needs first to check whether
there is already an existing WDM tunnel between the two muxponders
and then take different actions:</t>
        <ol spacing="normal" type="1"><li>
            <t>if the WDM tunnel already exists, the controller needs only to
enable the 10GE client ports to establish the 10GE client
connectivity service;</t>
          </li>
          <li>
            <t>if the WDM tunnel does not exist, the controller has to first
establish the WDM tunnel, finding a proper optical path matching
the optical parameters of the two muxponders' trunk ports (e.g.,
an OTSi carrying an OTU4), and then enable the 10GE client ports
to establish the 10GE client connectivity service.</t>
          </li>
        </ol>
        <t>Since multiple client connectivity services are sharing the same WDM
tunnel, a multiplexing label shall be assigned to each client
connectivity service. The multiplexing label can either be a standard
label (e.g., an OTN timeslot) or a vendor-specific label. The
multiplexing label can be either configurable (flexible
configuration) or assigned by design to each muxponder's client port
(fixed configuration). In the former case, any muxponder client port
can be connected with any other client port of the peer muxponder
(for example client port 1 on one muxponder can be connected with
client port 5 on the peer muxponder) while in the latter case only
client ports with the same port number can be connected (for example
client port 2 on one muxponder can be connected only with client port
2 on the peer muxponder and not with any other client port).</t>
        <t>In case of flexible configuration, since the two muxponders are under
the control of the same O-PNC, the configuration of the multiplexing
label, regardless of whether it is a standard or vendor-specific
label, can be done by the O-PNC using mechanisms which are
vendor-specific and outside the scope of this document. The MDSC can just
request the O-PNC to setup a client connectivity service over a WDM
tunnel.</t>
        <t>In case of fixed configuration, the multiplexing label is assigned by
the muxponder but the O-PNC and MDSC needs to be aware of the
connectivity constraints to avoid try and fail.</t>
        <t>It is worth noting that the current WSON and Flexi-grid topology
models in <xref target="RFC9094"/> and <xref target="I-D.ietf-ccamp-flexigrid-yang"/> do not
provide sufficient
information to the MDSC about this connectivity constraint and this
is identified as a gap.</t>
      </section>
    </section>
    <section numbered="false" anchor="acknowledgments">
      <name>Acknowledgments</name>
      <t>Some of this analysis work was supported in part by the European
Commission funded H2020-ICT-2016-2 METRO-HAUL project (G.A. 761727).</t>
      <t>The authors would like to thank Young Lee for his valuable input on the initial discussions which have triggered this work as well as for his contribution to the first drafts of this document.</t>
      <t>The authors would like to thank Adrian Farrel for his review and comments to this document.</t>
      <t>Previous versions of document were prepared using
2-Word-v2.0.template.dot.</t>
      <t>This document was prepared using kramdown.</t>
    </section>
    <section anchor="contributors" numbered="false" toc="include" removeInRFC="false">
      <name>Contributors</name>
      <contact initials="S." surname="Belotti" fullname="Sergio Belotti">
        <organization>Nokia</organization>
        <address>
          <email>sergio.belotti@nokia.com</email>
        </address>
      </contact>
      <contact initials="G." surname="Galimberti" fullname="Gabriele Galimberti">
        <organization/>
        <address>
          <email>ggalimbe56@gmail.com</email>
        </address>
      </contact>
      <contact initials="Y." surname="Zheng" fullname="Yanlei Zheng">
        <organization>China Unicom</organization>
        <address>
          <email>zhengyanlei@chinaunicom.cn</email>
        </address>
      </contact>
      <contact initials="A." surname="Snitser" fullname="Anton Snitser">
        <organization>Cisco</organization>
        <address>
          <email>asnizar@cisco.com</email>
        </address>
      </contact>
      <contact initials="W. C. P." surname="Correia" fullname="Washington Costa Pereira Correia">
        <organization>TIM Brasil</organization>
        <address>
          <email>wcorreia@timbrasil.com.br</email>
        </address>
      </contact>
      <contact initials="M." surname="Scharf" fullname="Michael Scharf">
        <organization>Hochschule Esslingen - University of Applied Sciences</organization>
        <address>
          <email>michael.scharf@hs-esslingen.de</email>
        </address>
      </contact>
      <contact initials="J." surname="Tantsura" fullname="Jeff Tantsura">
        <organization>Nvidia</organization>
        <address>
          <email>jefftant.ietf@gmail.com</email>
        </address>
      </contact>
      <contact initials="P." surname="Volpato" fullname="Paolo Volpato">
        <organization>Huawei</organization>
        <address>
          <email>paolo.volpato@huawei.com</email>
        </address>
      </contact>
      <contact initials="B." surname="Foster" fullname="Brent Foster">
        <organization>Cisco</organization>
        <address>
          <email>brfoster@cisco.com</email>
        </address>
      </contact>
      <contact initials="O." surname="Gonzalez de Dios" fullname="Oscar Gonzalez de Dios">
        <organization>Telefonica</organization>
        <address>
          <email>oscar.gonzalezdedios@telefonica.com</email>
        </address>
      </contact>
    </section>
  </back>
  <!-- ##markdown-source:
H4sIAAAAAAAAA+y9a3MbR5Yg+p0R/A+1csQ2sQZIkZL8oLt7TFGUWrN6MES1
3XPDMY4iUCSrBaAwVQVStKT97fc8M09mZQGg7O7pe9ecaZkEqvJx8uR5P0aj
0fZWW7bT4jD78/ZWlh0tFtNynJ+X07K9zaqL7Oi8aet83JbVPMvnk+y4mrd1
NcWv3tb5xUU5zk7ml+W8KOpigiO8Ktqbqn7XZDtHx29fDbK2yk7z8buizV4v
Whh6mj2ft8VlndOQO6evnw+2t/Lz87q4PszwlQw+2t4a5/BQVd8eZuX8otre
2t6aVON5PoOFTmDedlQW7cWoLfJmBKubjxZVOcrt4kf7325vNcvzWdk0MFN7
u4BXn5+8fZplX2T5tKkOs3vlfFIsCvhn3t4bZveKSdlWdZlP8Y/nR4/hP1UN
v715+/Te9tZ8OTsv6kNYCCwN/jOu5k0xb5bNYdbWy2J7C9b/ALZSFzkM/aZa
tuX8Et5DaFzW1XIBn749OTrLfoQP4KvsGX4ID7wrbuGZCQyZjQgC9AtBAf67
YOBVArzSA4++/o+jV8/olyc/PnkJayjmS1xclrkpo1PCmY/q8VXZFuN2WRd0
qmfl5Tyf8nqzjGF1L15nls3ycgpfINS/R/jvVjW/kcOA8MVV2y6aw709fA4/
Kq+LXX1uDz/YO6+rm6bYwxH26M3Lsr1ansO7eDQjhM/ox2d7eqT0yBTg3bRm
ePvoLg+wW1bupb3NEGT3qp1N7yFm5cv2qqoJaiP8J8sY0Z7Ck4C9Rb385Zdy
XvJXsBX4pgRUOK4W/FHBcLnAx3cX+vj3F/jQuFrsjquZGbucA8b8++jpbva4
Wv7XsixqO+e/F/l89LTO5+OqbKInaOofqkl+Uc2LYOq/FxcXu+fy8PfX8kg0
MU/wvM2nVfZ42dj9/GWZ3xRlMGSJz+2ew3PfX9G3ydGe5POymGb/G/DEDPd6
OsmeVJdILJrltHVfytATeun7ajqZVJcw7O7yXc/ARXZcjMdwpaZTu9zjshlX
iSEZ276/xM94uXRN27o8X7apEz4r6ks44sfFtGpbO8Or6l2ZBzM09OjuOT/6
/RwfSILkWX5e09KfwY1CktGGgL285M8ffWUXGg3yH/l8WpTZ/3NVBIA9virn
efbXeSnvuEF/wQdv6aXvx/jQkp7ZHc87Qx/NWyC8Z/OybQLE6gI1b+blL3n9
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
wgZYa62cL6njHyVag66Imbp5HTT6ZMNUTk1cUVpor4pO3pOXq5ECzwq4YhNJ
obldsCnFWs+cndpO5Hw7CDBMMzTdDbPPKqmwvUXqv6bFc2riigMbulwa7H6B
r+ayXfT0SnYEp5hp2gv1nCH9nZlTV4F3PbskMMFkFHKLZa35/dTUMZC+bot5
VM3gZIV/MCooFaaZ4zXQem/bW8+fnVKZu0xqvsXF9LAW3WBtCbwhuVzDin15
tLqxyZ/k+oPck6D/NgW2CWdzsyW6kP2T/waexgpNAYs2y7E1gjtFEpCOkNXs
Fr3ujW/T16MqB6mAQlFMK21fxjiSxZ9GWbgpp3ZAAIK+B9tb9AhjKgkXFNMJ
r7pAGGr8cmA/Owh0K+uXZBfk0HeXtZtySy/EdaZ+LxaeGwkloKPbP8xOlw1y
7bPnT7IpVt+idWBci4sGoWEee585couobAS7cf0Wg03QA7Q38fe2eX3JpuBJ
gVZNKU4tTr7MwW2wa5Z60LPUg99sqftuqfvrlloX3JY8WuqPJdFGEy7AZ7ZA
CoAHtuK+EH1yh+XcW5XQMBxMPakRE1LyamQ5/3ZkzhBxPTBuiNjsfQuekJLn
ZZ6+dcPAp40W0h1qFGyH5jIc0iNKJhiYXkxsWMW6fG/EDznv+sDZa0ru1Oje
+206Ry+bmaTCUsI65RVOMW3nbo7v+obDQDOuYzY6PrGVIHa0qgNXL8sov7vB
Toui4ayOJepk3Vo4S71L3WZ/1fNE/dsvbfBZ6nv7fiI+vbewtn6UeJ/pSf/7
fIn73//s+b8cuSrY+PMxsf/O91GI3sdsfxewU34/2EUXwJrvOyOQBV9/tym6
a77vDHRMuNez8/D76N0fen5Pfh+8m66h/OW673UMuBVU65z+UDpCuPD4jQ98
ffwm+B5xAV75CV/XgbTW+W7np6JC5iP6Pv11UOg8W1Veem/d9xY27rEoZHUv
+l75XXKQzwfwuty5kw59jd74Y3LkVT9/joNRiX1pJGpX/P2fVGbMy733vINK
CFrHPcW011gJglq4zCW59hh9gGGhIKG14mEnjyU6tSlSp3b+5m5x1NaVGQKu
NlvOKXJCyzeJjWQqzVi5vpxYoifebY0Q3WlAVwadCUNNudaNGDrLRkObQm5u
REFag9uBAGA3MwKlSGS0XRElvSl1AUIPNwi7KvJJweU0SWKmh3T1IOw01Kaa
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

-->

</rfc>
