<?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.23 (Ruby 3.3.6) -->
<?rfc comments="yes"?>
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" ipr="trust200902" docName="draft-poidt-teas-actn-poi-assurance-05" category="info" submissionType="IETF" tocInclude="true" sortRefs="true" symRefs="true" version="3">
  <!-- xml2rfc v2v3 conversion 3.27.0 -->
  <front>
    <title abbrev="ACTN POI Assurance">Applicability of Abstraction and Control of Traffic Engineered Networks (ACTN) for Packet Optical Integration (POI) service assurance</title>
    <seriesInfo name="Internet-Draft" value="draft-poidt-teas-actn-poi-assurance-05"/>
    <author initials="I." surname="Busi" fullname="Italo Busi">
      <organization>Huawei Technologies</organization>
      <address>
        <email>italo.busi@huawei.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="F." surname="Peruzzini" fullname="Fabio Peruzzini">
      <organization>TIM</organization>
      <address>
        <email>fabio.peruzzini@telecomitalia.it</email>
      </address>
    </author>
    <author initials="P." surname="Volpato" fullname="Paolo Volpato">
      <organization>Huawei Technologies</organization>
      <address>
        <email>paolo.volpato@huawei.com</email>
      </address>
    </author>
    <author initials="P." surname="Manna" fullname="Prasenjit Manna">
      <organization>Cisco</organization>
      <address>
        <email>prmanna@cisco.com</email>
      </address>
    </author>
    <date year="2025" month="February" day="26"/>
    <workgroup>TEAS WG</workgroup>
    <abstract>
      <?line 72?>

<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.</t>
      <t>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>
  <middle>
    <?line 81?>

<section anchor="introduction">
      <name>Introduction</name>
      <t>Service assurance is a critical aspect of Operations, Administration and Management (OAM). It consists of activities and processes whose target is to guarantee a specified Service Level Agreement (SLA) to the customer of a telecommunication service. Service assurance includes both fault management, for correcting or fixing the service anomalies and network faults, and performance management, for monitoring of the service and network parameters and early warning of potential service-related issues.</t>
      <t>In the scope of this document, service assurance is discussed in the context of a multi-layer, multi-domain network. In doing so, it leverages on the Abstraction and Control of TE Networks (ACTN) framework <xref target="RFC8453"/> and further expands the analysis of its applicability into multi-layer packet-optical integrated networks <xref target="I-D.ietf-teas-actn-poi-applicability"/> adding considerations specific to the fault and performance management scenarios.</t>
      <t>As already highlighted in <xref target="I-D.ietf-teas-actn-poi-applicability"/>, a multi-layer network is composed of an IP layer and an optical transport layer. A multi-domain network is composed of at least two different administrative domains (e.g. core and edge) under the control of the same organization (e.g. the same network operator). Service assurance applies to end-to-end L2VPN or L3VPN connectivity services configured over underlying transport optical paths that requires multi-layer coordination.</t>
      <t>To guarantee the SLAs associated to the VPN services, service assurance is performed through the collaboration of the different control entities part of the ACTN architecture <xref target="RFC8453"/>: the Multi-Domain Service Coordinator (MDSC), acting as the top-level controller, and the Provisioning Network Controllers (PNC) deployed both in the packet (P-PNC) and optical (O-PNC) layers.
This document aligns with the current field operations procedures adopted in the optical networks and assumes that the O-PNC provides the MDSC with the set of information necessary to provide the Root Cause Analysis (RCA) to correlate an event/alarm related to a failure in the optical network with the services impacted at the IP layer. The set of information shared by the O-PNC to the MDSC depends on local configuration adopted at the MDSC-PNC Interface (MPI) <xref target="RFC8453"/>. In general, this may include information about the optical path, tunnel, or fiber where the failure happened together with its location and its operational state (e.g., its "down" status), hiding further detailed information of the optical topology. This data is sufficent to allow the MDSC to perform the multi-layer correlation and discover which IP links, LSPs and VPNs are affected by the failure.</t>
      <t>The analysis of the YANG data models applicable to service assurance (fault and performance) is in scope of this document. The development of new YANG models/modules to support the missing functions is instead not in scope of the present document. To this extent, this document means to act as a framework that provides a gap analysis and suggests openings to future works to be addressed in other documents.</t>
      <t>The document has the following organization: section 2 lists the conventions and definitions used in the text. Section 3 discusses the reference network in scope for the relevant service assurance cases. Section 4 identifies the YANG data models applicable to service assurance and provides a gap analysis for the modules that are still missing. Section 5 identifies the possible faults, either in the optical or in IP layer (or both), in scope for this analysis. Section 6 deals with the performance management aspects of service assurance in a packet-optical integrated network. Finally, section 7 discusses the protection mechanisms available for the most typical fault scenarios of a multi-layer, multi-domain network.</t>
      <t>For each multi-technology scenario, the document analyzes how to use the interfaces and the data models of the ACTN architecture.</t>
      <t>A summary of the gaps identified in this analysis is provided in section 8.</t>
      <t>Understanding the level of standardization and the possible gaps will help assess the feasibility of integration between packet and optical DWDM domains (and optionally OTN layer) in an end-to-end multi-vendor service assurance perspective.</t>
    </section>
    <section anchor="conventions-and-definitions">
      <name>Conventions and Definitions</name>
      <section anchor="terminology">
        <name>Terminology</name>
        <t>TODO Terminology</t>
      </section>
    </section>
    <section anchor="ref-architecture">
      <name>Reference Network Architecture</name>
      <t>This document analyses several scenarios for service assurance in Packet and
Optical Integration (POI) in which ACTN hierarchy is deployed to
control a multi-layer and multi-domain network with two optical
domains and two packet domains, as shown in Figure 1 of <xref target="I-D.ietf-teas-actn-poi-applicability"/>, which is copied in <xref target="fig-ref-architecture"/> below.</t>
      <figure anchor="fig-ref-architecture">
        <name>Reference Network (copy of Figure 1 of RFC YYYY)</name>
        <artwork type="ascii-art" name="reference-architecture.txt"><![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>EDITORS NOTE: Replace RFC YYYY with the RFC number of <xref target="I-D.ietf-teas-actn-poi-applicability"/> once it has been published.</t>
      <t>In general, service assurance involves fault detection and localization; performance monitoring as well as re-routing (protection).</t>
      <t>Two cases will be considered:</t>
      <ol spacing="normal" type="1"><li>
          <t>using grey interfaces on routers' ports, as outlined in <xref target="I-D.ietf-teas-actn-poi-applicability"/></t>
        </li>
        <li>
          <t>using colored optical interfaces on routers' ports, as outlined in <xref target="I-D.mix-teas-actn-poi-extension"/></t>
        </li>
      </ol>
      <t>NOTE: It is not fully clear how much commonalities there are in service assurance for these two cases. This draft will start addressing both cases. At a later stage it will be assessed whether it is worthwhile keeping everything in a single draft or to split into two drafts.</t>
      <t>The MDSC is responsible for coordinating the whole multi-domain, multi-layer (packet and optical) network. MDSC interacts with different Provisioning Network Controllers (O/P-PNCs) through the MPI interface.
The MPI interface presents an abstracted topology to MDSC, hiding the technology-specific aspects of the network and the topology details (depending on the policy chosen regarding the level of abstraction supported).</t>
      <t>Following the assumptions of section 2.1.2 of <xref target="I-D.ietf-teas-actn-poi-applicability"/>, this document analyses scenarios where
the MDSC uses the partial summarization approach to coordinate multi-domain/multi-layer path computation.</t>
      <t>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.
That means the MDSC has the capability of performing multi-domain/single-layer path computation for the packet layer. The MDSC needs to delegate the O-PNCs to perform local path computation within their respective domains.
It uses the information received by the O-PNCs and its TE topology view of the multi-domain packet layer to perform multi-layer/multi-domain path computation.</t>
      <t>P-PNCs are responsible for setting up the TE paths between any two PEs or BRs in their respective controlled domains,
as requested by MDSC, and providing topology information to the MDSC.</t>
      <t>O-PNCs are responsible to provide to the MDSC an abstract TE topology view of their underlying optical network resources.
They perform single-domain local path computation, when requested by the MDSC. They also perform optical tunnel setup, when requested by the MDSC.</t>
      <t>No GMPLS-UNI interaction between IP and Optical equipment is considered.
This is also the assumption followed in this document: the MDSC performs the function of multi-layer/multi-domain path computation
through the same mechanisms described in <xref target="I-D.ietf-teas-actn-poi-applicability"/>.</t>
      <ul empty="true">
        <li>
          <t>TO DO: Complete the description of the pre-requisites of MDSC in the cases discussed.</t>
        </li>
      </ul>
      <t>The following list summarizes the main assumptions about how MDSC can handle the service assurance cases described in this document. Most of them have been already described in <xref target="I-D.ietf-teas-actn-poi-applicability"/></t>
      <ol spacing="normal" type="1"><li>
          <t>MDSC has acquired all the topology and status information of both the IP and optical layers.</t>
        </li>
        <li>
          <t>MDSC is fully aware of any multi-layer connections between the IP and the optical layers. It is also
aware of the multi-domain interconnection links between different IP domains.</t>
        </li>
        <li>
          <t>MDSC is aware of any topology or resource utilization change obtained in real time through coordination with the O/P-PNCs. This applies in the case of a fault or a maintenance activity involving either the IP or the DWDM layer.</t>
        </li>
        <li>
          <t>MDSC coordinates the IP and DWDM protections and, as a result, the re-routing of traffic at both the IP and DWDM layer.</t>
        </li>
        <li>
          <t>Before planned maintenance operation at the DWDM layer, MDSC instructs the P-PNC to move the affected IP traffic to an other link in an hitless way. This is done before the event takes place. MDSC also coordinates with P-PNC to revert
back the traffic on the original path when the maintenance event is concluded.</t>
        </li>
        <li>
          <t>When the O-PNC detects a degradation of optical performance (e.g. BER PRE-FEC values threshold crossing over
a certain period of time), it alerts the MDSC so that the MDSC relates the warning to an IP link.</t>
        </li>
        <li>
          <t>MDSC distinguishes between IP and Optical failures. For example, in the case of the failure of an IP port of a router,
the IP traffic may be switched to a stand-by port, reusing the same ROADM optical resources (lambda, optical path) and keeping the end-to-end IP connection. If a remote IP node fails, then a re-route of optical resources takes place together with a switch of the local IP port in order to establish a new connection with a different IP node used for protection.</t>
        </li>
      </ol>
      <section anchor="ref-network">
        <name>Reference Network</name>
        <t>The following network topology will be considered to analyze and discuss the scenarios in in <xref target="resiliency"/>.</t>
        <figure anchor="fig-ref-network">
          <name>Reference Network</name>
          <artwork type="ascii-art" name="reference-network.txt"><![CDATA[

│<xxxxxxxxxxxxxxxxxxxxxxx IP Link R1-R2 xxxxxxxxxxxxxxxxxxxxxxx>│
┌――――――――┐  ┌――――――――┐                     ┌――――――――┐  ┌――――――――┐
│      P1│--│P1    P3│\        ___        /│P3    P1│--│P1      │
│  R1    │  │ ROADM1 │ \  ____/   \____  / │ ROADM2 │  │   R2   │
│      P2│--│P2    P4│\ \/             \/ /│P4    P2│--│P2      │
└――――――――┘  └――――――――┘ \|    Optical    |/ └――――――――┘  └――――――――┘
                        |    Network    |
│<xx IP Link R1-R3 xx    \_____________/   xx IP Link R3-R2 xxx>│
                     x      |       |     x
                      x     |       |    x
                        x  ┌―――――――――┐  x
                         x │P3     P4│ x
                         x │ ROADM3  │ x
                         x │P1     P2│ x
                         x └―――――――――┘ x
                         x  |       |  x
                         x ┌―――――――――┐ x
                         x │P1     P2│ x
                         x │   R3    │ x
                         ˅ │         │ ˅
                         ― └―――――――――┘ ―





]]></artwork>
        </figure>
        <t>The network consists of three Points of Presence (POPs) geographically distributed.
It is assumed that every POP hosts a Router (R1, R2, and R3 respectively) connected to a ROADM (ROADM1, ROADM2, and ROADM3).
All the routers connect to their co-located ROADMs with two Ethernet links (e.g. 100GE) for redundancy.
In their normal operations, the routers may employ any local policy for traffic steering. For the scope of this document,
it is assumed that the path that R1 uses to steer the IP traffic to R2 goes from port P1 of R1 to port P1 of R2
(thus going through port P1 of R1, ports P1 and P3 of ROADM1, ports P3 and P1 of ROADM2, port P1 of R2).
R1 uses port P2 to steer the traffic to R3 instead. The IP link between R1 and R3 carries the IP services that are
directed to R3 and is used by R1 as a detour path (backup path) to reach R2 if a failure occurs in the primary path
across ROADM1 and ROADM2. The detour path also includes a second leg from R3 to R2. The detour path from R1 to R2, then includes: port P2 of R1, ports P2 and P4 or ROADM1, ports P3 and P1 of ROADM3, ports P1 and P2 of R3, ports P2 and P4 of ROADM3, ports P4 and P2 of ROADM2, and port P2 of R2.
The connection between all ROADMs is based on two fibers. The optical paths all cross an optical network.
For the scope of this document, it is assumed that some coordination mechanisms are employed at the optical layer so that
when a failure happens on an optical path (for example, between ROADM1 and ROADM2), an optical backup path
is activated. The mechanisms are assumed to be coordinated by O-PNC and MDSC, even if other methods may be also
considered (e.g. G-MPLS based). Further details are given in the use cases described in <xref target="resiliency"/>.</t>
      </section>
    </section>
    <section anchor="yang">
      <name>YANG Data Models for the MPIs</name>
      <t>The analysis of the data models potentially of interest for this document is still on-going. The set of YANG models identified so far includes the following items:</t>
      <ul spacing="normal">
        <li>
          <t>ietf-alarms defined in <xref target="RFC8632"/></t>
        </li>
        <li>
          <t>ietf-performance-monitoring defined in <xref target="I-D.yu-performance-monitoring-yang"/></t>
        </li>
        <li>
          <t>A YANG Data Model for Service Assurance <xref target="RFC9418"/></t>
        </li>
        <li>
          <t>A YANG Data Model for Network and VPN Service Performance Monitoring <xref target="RFC9375"/></t>
        </li>
      </ul>
      <t>The list will be progressively updated as the document evolves.</t>
    </section>
    <section anchor="fault">
      <name>Multi-layer Fault Management</name>
      <t>This section deals with the actions taken by the MDSC and the PNCs at the IP and optical layers to handle the occurence of a failure in a multi-layer network. This set of actions is referred to as fault management and consists of steps such as fault detection, fault localization, and fault recovery. Specifically, this section analyzes the detection and localization of a failure, while section <xref target="resiliency"/> further details the mechanisms for fault recovery.
Depending on the point where a failure occurs, three use cases are considered:
1. The failure occurs in the optical layer, for example a fiber cut that triggers a Loss of Signal (LOS) alarm. This is discussed in section <xref target="optical-fault"/>.
2. The failure occurs at the connection between a router and a ROADM (cross-layer link). Such a case is analyzed in section <xref target="edge-fault"/>.
3. The failure occurs in the IP layer, for example a router experiences a hardware failure on a port that connects to its optical counterpart. This case is discussed in section <xref target="router-fault"/>.</t>
      <section anchor="fault-reference-scenario">
        <name>Reference scenario for multi-layer faults</name>
        <t>The following figure illustrates the reference scenario useful to discuss the fault management cases.</t>
        <figure anchor="fig-failure-reference">
          <name>Reference scenario for multi-layer fault management</name>
          <artwork type="ascii-art" name="multi-layer-failure-reference-network.txt"><![CDATA[
┌―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――┐
│                             MDSC                              │
└―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――┘
   /\                          /\
   || 1                        || 2
   ||                          ||
┌――――――┐      ┌―――――――――――――――――――――――――――――――――――┐      ┌――――――┐
│P-PNC │      │              O-PNC                │      │P-PNC │
└――――――┘      └―――――――――――――――――――――――――――――――――――┘      └――――――┘
   /\             /\           /\
   || a           || b         || c
   ||             ||         _____
   ||             ||   _____/     \_______ 
┌――――――┐      ┌――――――┐/                   \┌――――――┐      ┌――――――┐
│  R1  │----->│ROADM1│      Optical        │ROADM2│----->│  R2  │
│      │<-----│      │      Network        │      │<-----│      │
└――――――┘      └――――――┘\___________________/└――――――┘      └――――――┘
]]></artwork>
        </figure>
        <t>The MDSC is responsible for the correlation of the events. The notification about a failure (alarm, state change, etc.) is sent from the P-PNC (upstream arrow labelled "1" in the figure) and/or the O-PNC (upstream arrow labelled "2"), depending on the case considered. It has to be noted that only a single P-PNC is present in the network. The second box marked with the label "P-PNC" is represented only to simplify the schematics. Actually the P-PNC on the left and the P-PNC on the right are the same element.</t>
        <t>In case of a failure in the IP layer, the router that detects it sends a corresponding notifiation message to the P-PNC. This is represented by the upstream arrow labbelled "a". Similarly, a failure in the optical layer can be notified through messages sent by a ROADM (upstream arrow "b") or by a node within the optical core network (upstream arrow "c"). Again, depending on the specific case multiple messages can be directed by the IP and/or optical nodes to the corresponding PNC.</t>
        <t>For simplicity, a router is connected to a ROADM via two unidirectional fibers, represented by the two arrows between them. ROADM 1 and ROADM 2 are considered to be the edge nodes of a larger optical core that may include several other components.
The two connections between a router and a ROADM carry, in addition to data traffic, the signaling messages generated by the physical transmission layer, for example Local Failure Indication (LFI) or Remote Failure Indication (RFI). These messages provide supplementary information that an IP or an optical node may consider for failure detection and for providing further details in the upstream notification to a PNC.</t>
      </section>
      <section anchor="optical-fault">
        <name>Optical Network Failures</name>
        <t>In this case, the O-PNC is fully responsible for the fault management (including failure detection, location and repair) within the optical domain.</t>
        <t>The detailed mechanisms used by the O-PNC for intra-domain fault management are outside the scope of this document. Optical data plane standards provide a comprehensive set of OAM tools, defined in <xref target="ITU-T_G.709"/> and <xref target="ITU-T_G.798"/>, that would assist O-PNC fault management, as described in <xref target="ITU-T_G.7710"/> and <xref target="ITU-T_G.874"/>.</t>
        <t>It is worth noting that the OAM tools, defined in <xref target="ITU-T_G.709"/> and <xref target="ITU-T_G.798"/>, are fully standardized for the ODU, OTU and FlexO sub-layers but only functionally standardized for the optical medial layer (i.e., OCh and OTSiA). This is not an issue since it is assumed that the optical NEs and O-PNC within a single domain are single-vendor.</t>
        <t>However, the level of standardization of the OAM tools management requirements is sufficient to allow defining standard requirements and data model at the MPI for multi-vendor, multi-domain and multi-layer fault management.</t>
        <t>Even if in this case the fault management is fully under the responsibility of the O-PNC, it is still needed to inform the MDSC that there is a failure within the optical domain and that the O-PNC is working on it.</t>
        <t>A failure within the optical network can cause secondary failure on multiple optical tunnels which can in turn cause failures on the multi-layer IP links and on the L2VPN and L3VPN services whose traffic is sent over the failed tunnels.</t>
        <t>For example, with a reference to Figure 7 of <xref target="I-D.ietf-teas-actn-poi-applicability"/>, a failure within the optical network can cause a failure on the optical tunnel between NE11 and NE12. As a consequence, also the IP link between PE13 and BR11 is failed and the L2VPN/L3VPN xxx is also affected.</t>
        <t>The O-PNC can report the operational status of the optical tunnels to the MDSC to let the MDSC know that the optical tunnel is down. The MDSC can then correlate the failure of the optical tunnel (e.g., the optical tunnel between NE11 and NE12 in Figure 7 of <xref target="I-D.ietf-teas-actn-poi-applicability"/>) with the secondary failures on the L2VPN/L3VPN whose traffic has been routed through that optical tunnel.</t>
        <ul empty="true">
          <li>
            <t>Comment: Need to discuss here why reporting the operational status of the optical tunnel is not sufficient to motivate the need for a more enhanced incident management as proposed in <xref target="I-D.feng-opsawg-incident-management"/></t>
          </li>
        </ul>
        <t>The MDSC should also inform the OSS/orchestration layer about the failures on the affected L2VPN/L3VPN services though mechanisms which are outside the scope of this document.</t>
        <ul empty="true">
          <li>
            <t>Comment: Need further discussion about the behavior of P-PNC. The P-PNC can also discover that the multi-layer IP link is down (e.g., using BFD). However, I think that the fault management process in P-PNC should be different from the case where the failed IP link is a single-layer IP link under P-PNC responsibility.</t>
          </li>
        </ul>
        <ul empty="true">
          <li>
            <t>Comment: The assumption in this text is that there are grey interfaces between the routers and the optical NEs. More investigation is needed for the scenarios where optical pluggable interfaces are used in the router. Three scenarios for WDM networks: grey interfaces, colored interfaces option 1 and colored interfaces option 2. To consider also the case with ODU switching.</t>
          </li>
        </ul>
      </section>
      <section anchor="edge-fault">
        <name>Cross-layer Link Failures</name>
        <t>The failures discussed in this section occur on the connection between a router and a ROADM.
A first case concerns the Tx fiber used by R1 to send traffic to ROADM1 (<xref target="fig-failure-ingress-link"/>).</t>
        <figure anchor="fig-failure-ingress-link">
          <name>Failure on the optical ingress link</name>
          <artwork type="ascii-art" name="multi-layer-failure-ingress-link.txt"><![CDATA[
┌―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――┐
│                             MDSC                              │
└―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――┘
   /\                          /\
   || IP Link down             || R1-ROADM1 Link Down
   ||                          ||
┌――――――┐      ┌―――――――――――――――――――――――――――――――――――┐      ┌――――――┐
│P-PNC │      │              O-PNC                │      │P-PNC │
└――――――┘      └―――――――――――――――――――――――――――――――――――┘      └――――――┘
   /\             /\                                        /\
   || RFI status  || LOS alarm                   LFI status ||
   || BFD Down    ||         _____                 BFD Down ||
   ||             ||   _____/     \_______                  ||
┌――――――┐  \/  ┌――――――┐/                   \┌――――――┐  LFI ┌――――――┐
│  R1  │--/\->│ROADM1│--------CSF--------->│ROADM2│----->│  R2  │
│      │<-----│      │<-------CSF----------│      │<-----│      │
└――――――┘  RFI └――――――┘\___________________/└――――――┘  RFI └――――――┘
]]></artwork>
        </figure>
        <t>The failure on that fiber is physically detected by ROADM1 that sends a corresponding notification to O-PNC and generates a Client Signal Fail (CSF) message along the optical path. Upon receiving CSF, ROADM2 sends a LFI to R2. If R2 is instructed to decode physical transmission messages, upon receiving LFI it generates a corresponding message to P-PNC, also informing of the loss of IP connectivity due to unreceived BFD messages.
At the physical level, R2 may generate on its Tx interface an RFI indication that is propagated downstream to the optical network (where a CSF is generated) and to R1. When receiving RFI on its Rx interface, R1 can also send a notification to P-PNC.
When O-PNC and P-PNC get the notifications sent by the network elements, they also instruct MDSC. O-PNC informs MDSC of the link R1-ROADM1 down, while P-PNC informs MDSC that the corresponding IP link is down due to missed BFD signalling in addition to the RFI status.
It is up to the MDSC to correlate the events and determine what IP services are affected (VPNs, P2P links, etc.).</t>
        <t>A second case is depicted in figure <xref target="fig-failure-egress-link"/>. The failure happens on the Rx fiber used by R2 to receive traffic from ROADM2.</t>
        <figure anchor="fig-failure-egress-link">
          <name>Failure on the optical egress link</name>
          <artwork type="ascii-art" name="multi-layer-failure-egress-link.txt"><![CDATA[
┌―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――┐
│                             MDSC                              │
└―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――┘
   /\                          /\
   || R2-ROADM2 Link Down      || R2-ROADM2 Link Down
   ||                          ||
┌――――――┐      ┌―――――――――――――――――――――――――――――――――――┐      ┌――――――┐
│P-PNC │      │              O-PNC                │      │P-PNC │
└――――――┘      └―――――――――――――――――――――――――――――――――――┘      └――――――┘
   /\                                         /\           /\
   || RFI status                   RFI status || LOS alarm ||
   || BFD Down               _____            ||           ||
   ||                  _____/     \_______    ||           ||
┌――――――┐      ┌――――――┐/                   \┌――――――┐  \/  ┌――――――┐
│  R1  │----->│ROADM1│-------------------->│ROADM2│--/\->│  R2  │
│      │<-----│      │<-------CSF----------│      │<-----│      │
└――――――┘  RFI └――――――┘\___________________/└――――――┘  RFI └――――――┘
]]></artwork>
        </figure>
        <t>R2 physically detects the absence of signal generating a corresponding LOS alarm to P-PNC. In turn, P-PNC signals MDSC of the corresponding event affecting the link between ROADM2 and R2.
R2 also propagates an RFI indication on the return fiber.
Upon detecting it, ROADM2 also informs O-PNC of the failure with a corresponding RFI status indication.
ROADM2 also propagates a CSF indication across the optical domain, translated to an RFI by ROADM1 towards R1.
The RFI is detected by R1 that may inform P-PNC about the remote failure with an RFI status indication, if instructed to do so, and with a BFD down event notification when detecting missing connectivity.
As noted, MDSC correlates the events to determine the affected services.</t>
        <t>A failure may also occur when the two unidirectional fibers connecting a router, e.g. R1, to a ROADM, e.g. ROADM2, are affected, for example for a simultaneous fiber cut, as shown in figure <xref target="fig-failure-bidir-link"/>.</t>
        <figure anchor="fig-failure-bidir-link">
          <name>Failure on the access link</name>
          <artwork type="ascii-art" name="multi-layer-failure-bidir-link.txt"><![CDATA[
┌―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――┐
│                             MDSC                              │
└―――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――――┘
   /\                          /\
   || R1-ROADM1 Link Down      || R1-ROADM1 Link Down
   ||                          ||
┌――――――┐      ┌―――――――――――――――――――――――――――――――――――┐      ┌――――――┐
│P-PNC │      │              O-PNC                │      │P-PNC │
└――――――┘      └―――――――――――――――――――――――――――――――――――┘      └――――――┘
   /\            /\                                        /\
   || LOS alarm  || LOS alarm                   LFI status ||
   ||            ||                               BFD down ||
   ||            ||    _____/     \_______                 ||
┌――――――┐      ┌――――――┐/                   \┌――――――┐  LFI ┌――――――┐
│  R1  │--\/->│ROADM1│--------CSF--------->│ROADM2│----->│  R2  │
│      │<-/\--│      │<-------CSF----------│      │<-----│      │
└――――――┘      └――――――┘\___________________/└――――――┘  RFI └――――――┘
]]></artwork>
        </figure>
        <t>Both Tx and Rx fibers are affected, then R1 and ROADM1 immediately detect physical LOS and inform P-PNC and O-PNC respectively.
ROADM1 also triggers a CSF indication towards the optical core that eventually gets to ROADM2, which sends a LFI to R2.
R2 may detect this signal, informning P-PNC. From the IP connectivity standpoint, after missing three BFD messages R2 also signals to P-PNC the lack of end-to-end connectivity. It then generates a RFI indication back to ROADM2, which in turn sends a CSF indication on the optical return path.
Both P-PNC and O-PNC inform MDSC of the event affecting the link between R1 and ROADM1 for its successive correlation.</t>
      </section>
      <section anchor="router-fault">
        <name>Router Node Failures</name>
        <t>In this case it is assumed that a router port experiences a hardware failure, for example R1's port connecting to ROADM1.
R1 may have internal mechanisms that detect the failure and trigger the relevant notification to P-PNC.
At the IP level the missing reception of the BFD messages against R2 triggers a BFD down notification to P-PNC. the same notification is sent by R2, confirming that the IP connectivity is lost.</t>
      </section>
    </section>
    <section anchor="performance">
      <name>Multi-layer Performance Management</name>
      <t>Network performance management refers to the set of operational actions
that are taken to solve issues affecting network performance and that may degrade the quality of the services offered to the network customers.</t>
      <t>For the scope of the present document, which focuses on multi-layer, multi-domain networks, two cases are of interest:
1. The optical layer detects, through performance data measurement, collection and analysis, that an abnormal condition (e.g. a physical signal degradation) has arised or is going to happen in either of the optical domains considered in <xref target="fig-ref-architecture"/>. The O-PNC provides relevant information to the MDSC (e.g. the fiber where the degration was detected), which triggers correlation analysis by the MDSC to detect if any services are impacted at the IP level and, if the case, to take corrective actions, through the P-PNC (e.g. traffic rerouting).
2. The IP layer detects, through performance data measurement, collection and analysis, that the Service Level Agreement (SLA) associated with transport of a VPN service is not conformant at least in one of the two IP domains represented in <xref target="fig-ref-architecture"/>. The P-PNC provides relevant information to the MDSC (e.g. the IP tunnel carrying the VPN service), which enables the MDSC to take reactive measures, through the support of the P-PNC (e.g. reroute the IP traffic on a different IP path). The MDSC can take further steps, such as to verify through the O-PNC if any failure or degradation has happened in the optical layer but this is out of the scope of case #2. The attention here is on the IP multi-domain, end-to-end performance management.</t>
      <t>The two cases are further detailed in the relevant subsections.</t>
      <section anchor="optical-performance-management">
        <name>Optical performance management</name>
        <t>Optical devices employ mechanisms for monitoring the condition of an
OTN link.  Among others, pre-Forward Error Correction (pre-FEC) Bit Error Rate (BER) allows to track bit errors on the optical wire,
notifying the transmitter side or a controlling agent when a
specified threshold is reached or passed.  The advantage of this
mechanism is to get an early warning on the optical path performance:
the exceeding of the specified threshold means that the receiver is
no longer able to correct all the errors on the channel.  As a
result, the transmitter or the controlling entity (e.g. an SDN
controller) may trigger counter-actions such as the switch to a
different optical path.</t>
        <t>In the context of multi-layer performance management, it is assumed that:
1.  The O-PNC is capable of monitoring the DWDM links optical performance, and alerting the MDSC when
the pre-FEC BER value overcomes a user-specified threshold
2.  The MDSC is capable of correlating the pre-FEC BEC threshold crossing alarm with a related IP link and take appropriate corrective actions, if programmed to do so.</t>
        <t>In this context, the assumption is that pre-FEC BER measurement is
done on the optical path between ROADM1 and ROADM2 of <xref target="fig-ref-network"/>.  Some IP services
(e.g.  L2/L3 VPNs) are active between R1 and R2, using the optical
path between ROADM1 and ROADM2 as a transport.  The sequence of steps
to handle the exception detected by the optical performance managent is expected to
be the following:</t>
        <ul spacing="normal">
          <li>
            <t>step 1.  ROADM2 detects a pre-FEC BER value at an ingress interface higher that the defined threshold.  A corresponding   alarm is sent to O-PNC</t>
          </li>
          <li>
            <t>step 2.  O-PNC forwards the alarm to MDSC</t>
          </li>
          <li>
            <t>step 3.  MDSC correlates the information of the optical path subject to pre-FEC BER issues and the IP services active on it.</t>
          </li>
        </ul>
        <t>Depending on how the MDSC in instructed to react, different choices
are possible.  At one extreme of the spectrum, the MDSC notes the
event and simply trigger a notification to the operator.  At the
other extreme, the MDSC may start the multi-layer resiliency
mechanisms described in <xref target="optical-fault"/>, as the case is equivalent to the handling of an optical failure.</t>
      </section>
      <section anchor="end-to-end-ip-performance-management">
        <name>End-to-end IP performance management</name>
        <t>Performance measurement at the IP layer may be based on a multiplicity of methods, including interface counters, passive and active mechanisms <xref target="RFC7799"/>. While the utilization of those mechanisms is not constrained by network topology, for example by the number of IP domains crossed by a measurement flow, in practice they are often enabled in limited environments (controlled domains) <xref target="RFC8799"/>.</t>
        <t>As a result, the applicability of such methods is often limited to a single IP domain due to the necessity of avoiding the exchange and disclosure of sensitive data across multiple administrative organizations.
With reference to <xref target="fig-ref-architecture"/>, it is then assumed that both IP domains, namely Packet domain 1 and 2, run separate performance measurement.
It is responsibility of each P-PNC to inform the MDSC in the case of service SLA degradation so that the MDSC enables a corrective action.</t>
      </section>
    </section>
    <section anchor="resiliency">
      <name>Multi-layer Resiliency</name>
      <t>The coordination of both the IP and the optical layer in the cases discussed in <xref target="resiliency"/>
requires the MDSC to be aware of some network capabilities and to exchange the corresponding information with
both the P-PNC and the O-PNC.</t>
      <t>To achieve maximum flexibility, a network operator may enable or disable these capabilities.
Once the network operator has configured the capabilities described in this section, the MDSC exchanges
the relevant configuration with the PNCs present in the network before the use cases described in <xref target="resiliency"/>
take place.</t>
      <t>The list of parameters that the MDSC may need to communicate to the PNCs includes:</t>
      <ul spacing="normal">
        <li>
          <t>IP service reversion: on/off</t>
        </li>
        <li>
          <t>Optical service reversion: on/off</t>
        </li>
        <li>
          <t>Hold-off time: time in ms (0 for immediate fast re-routing)</t>
        </li>
        <li>
          <t>Wait time before reversion: time in s</t>
        </li>
        <li>
          <t>Recovery method used in the optical layer: protection/restoration</t>
        </li>
      </ul>
      <section anchor="optical-resiliency">
        <name>Optical Network Failures</name>
        <t>Failures in the optical domain can be recovered by packet-based protection mechanisms as described in <xref target="I-D.ietf-teas-actn-poi-applicability"/>.</t>
        <t>This use case is characterized by a fault happening on the upper fiber connecting ROADM1 and ROADM2
(port P3 to port P3 as depicted in <xref target="fig-ref-network"/>), affecting the IP traffic between R1 and R2.
As a result, the MDSC and the domain controllers cooperate to find a backup path for the IP traffic.
If the optical layer does not employ any mechanisms, the case is typically solved through the Fast Rerouting
Mechanisms (FRR) enabled by the IP/MPLS control plane. With reference to figure <xref target="fig-ref-network"/>, this corresponds
to using the combination of the two detour paths R1-R3 and R3-R2.
For the scope of this document, the assumption is instead that the optical layer supports its own mechanisms that have
to interact with the IP layer. Two sub-cases are possible:</t>
        <ol spacing="normal" type="1"><li>
            <t>The optical layer supports restoration</t>
          </li>
          <li>
            <t>The optical layer supports protection.</t>
          </li>
        </ol>
        <section anchor="restoration">
          <name>Optical restoration</name>
          <t>As restoration typically sets an alternative path on the fly based on the availability of sufficient optical resources,
the time taken by the process to create an optical backup tends to be longer than the time taken by the IP/MPLS FRR process.
As a result, the interaction between the two layers follows the mimics shown in the next figure.</t>
          <figure anchor="fig-fault-restoration">
            <name>Fault detection with optical restoration</name>
            <artwork type="ascii-art" name="restoration.txt"><![CDATA[
  R1    ROADM1   P-PNC   O-PNC   MDSC   ROADM2    R2    ROADM3    R3
  |       |1a.Fault notification  |       |       |       |       |
  |       |-------------->|       |       |       |       |       |
  |       |       |       |2a.Fault notification  |       |       |
  |       |       |       |------>|       |       |       |       |
  |1b.Fault notification  |       |       |       |       |       |
  |-------------->|       |       |       |       |       |       |
  |       |       |2b.Fault notification  |       |       |       |
  |       |       |-------------->|       |       |       |       |
┌――――――┐
│3.FRR │
└――――――┘
  |4.IP service switched (backup path through R3) |       |       |
  |-------------->|       |       |       |       |       |       |
  |       |       |5.IP service switched  |       |       |       |
  |       |       |-------------->|       |       |       |       |
   ┌―――――――――――――┐                 ┌―――――――――――――┐
   │6.Restoration│<--------------->│6.Restoration│
   └―――――――――――――┘                 └―――――――――――――┘
  |       |7.Path ready   |   7.Path ready|       |       |       |
  |       |-------------->|<--------------|       |       |       |
  |       |       |       |8.Notification |       |       |       |
  |       |       |       |------>|       |       |       |       |
┌――――――――┐
│9.Revert│
└――――――――┘
  |10.IP service reverted |       |       |       |       |       |
  |-------------->|       |       |       |       |       |       |
  |       |       |11.IP service reverted |       |       |       |
  |       |       |-------------->|       |       |       |       |
]]></artwork>
          </figure>
          <t>More in details:</t>
          <ul spacing="normal">
            <li>
              <t>step 1a. The fault on the optical path (e.g. fiber cut, loss of signal, etc.) is detected by ROADM1 and notified to O-PNC</t>
            </li>
            <li>
              <t>step 2a. O-PNC notifies the fault to MDSC</t>
            </li>
            <li>
              <t>step 1b. R1 detects loss of end-to-end connectivity (e.g. 3 missed BFD messages) and notifies P-PNC. This step takes place almost simultaneously to 1a.</t>
            </li>
            <li>
              <t>step 2b. P-PNC notifies the issue to MDSC</t>
            </li>
            <li>
              <t>step 3. R1 starts a fast reroute process to enable a backup path at the IP/MPLS layer, using the already established detour through R3</t>
            </li>
            <li>
              <t>step 4. R1 notifies P-PNC of the IP service switch through the alternate path (R1-R3 and R3-R2)</t>
            </li>
            <li>
              <t>step 5. P-PNC notifies MDSC of the switch</t>
            </li>
            <li>
              <t>step 6. ROADM1 and ROADM2 enable the restoration process. Based on the mechanism adopted, there may be interaction between them</t>
            </li>
            <li>
              <t>step 7. Both ROADM1 and ROADM2 notify O-PNC of the availability of an optical backup path</t>
            </li>
            <li>
              <t>step 8. O-PNC notifies MDSC of the availability of an optical backup path</t>
            </li>
            <li>
              <t>step 9. R1 detects again end-to-end connectivity through the initial path R1-R2 and, if configured to do so, revert the service</t>
            </li>
            <li>
              <t>step 10. R1 notifies P-PNC of the switch to the initial path</t>
            </li>
            <li>
              <t>step 11. P-PNC notifies the switch to MDSC.</t>
            </li>
          </ul>
          <t>As noted in step 6., the restoration process may require an exchange of messages between ROADM1 and ROADM2.
This is not detailed in the present document as it is assumed that the relevant signaling is handled through O-PNC.</t>
          <t>In step 9., R1 detects again control traffic from R2. The decision whether to revert the service on the initial path
is local, e.g. it depends on the configuration made by the network operator.
Often, the IP equipment is configured to operate the reversion automatically, but there are cases where the network
operator may prefer differently.</t>
          <t>At the end of the process, multi-layer hitless reversion may take place, again based on the configuration adopted by the
network operator. If multi-layer hitless reversion is adopted, then the process described in <xref target="ref-hitless-reversion"/>
takes place.</t>
        </section>
        <section anchor="protection">
          <name>Optical protection</name>
          <t>Differently from the previous case, here optical protection is considered. This duration of this process is comparable
with IP/MPLS FRR, as it is pre-computed. As a consequence, when multi-layer coordination is enabled it is preferable
to hold-off FRR on R1 and wait that optical protection is completed.
The process is shown in the next figure.</t>
          <figure anchor="fig-fault-protection">
            <name>Fault detection with optical protection</name>
            <artwork type="ascii-art" name="protection.txt"><![CDATA[
  R1    ROADM1   P-PNC   O-PNC   MDSC   ROADM2    R2    ROADM3    R3
  |       |1a.Fault notification  |       |       |       |       |
  |       |-------------->|       |       |       |       |       |
  |       |       |       |2a.Fault notification  |       |       |
  |       |       |       |------>|       |       |       |       |
  |1b.Fault notification  |       |       |       |       |       |
  |-------------->|       |       |       |       |       |       |
  |       |       |2b.Fault notification  |       |       |       |
  |       |       |-------------->|       |       |       |       |
┌――――――┐
│3.Hold│
└――――――┘
   ┌―――――――――――――┐                 
   │4.Protection │------->|-------------->|
   └―――――――――――――┘                 
  |       |5.Path ready   |   5.Path ready|       |       |       |
  |       |-------------->|<--------------|       |       |       |
  |       |       |       |6.Notification |       |       |       |
  |       |       |       |------>|       |       |       |       |
┌――――――――┐
│7.IP Up │
└――――――――┘
]]></artwork>
          </figure>
          <t>The detailed process includes the following steps:</t>
          <ul spacing="normal">
            <li>
              <t>step 1a. The fault on the optical path (e.g. fiber cut, loss of signal, etc.) is detected by ROADM1 and notified to O-PNC</t>
            </li>
            <li>
              <t>step 2a. O-PNC notifies the fault to MDSC</t>
            </li>
            <li>
              <t>step 1b. R1 detects loss of end-to-end connectivity (e.g. 3 missed BFD messages) and notifies P-PNC. This step takes place almost simultaneously to 1a.</t>
            </li>
            <li>
              <t>step 2b. P-PNC notifies the issue to MDSC [Editor's note: is this step necessary?]</t>
            </li>
            <li>
              <t>step 3.  R1 is configured to hold the FRR process, thus it waits for the corresponding value set by the hold-off time parameter</t>
            </li>
            <li>
              <t>step 4.  Optical protection is started by ROADM1, potentially involving an exchange of messages with O-PNC and ROADM2</t>
            </li>
            <li>
              <t>step 5.  Both ROADM1 and ROADM2 notify O-PNC of the availability of an optical backup path</t>
            </li>
            <li>
              <t>step 6.  O-PNC notifies MDSC of the availability of an optical backup path</t>
            </li>
            <li>
              <t>step 7.  R1 detects again end-to-end connectivity with R2.</t>
            </li>
          </ul>
          <t>The IP traffic is recovered as soon as the optical protection is completed with no action taken by the IP routers.</t>
          <t>As in the previous use case, when the failure is fixed the network operator may desire to bring the service back
to the original configuration. If this is the case, multi-layer hitless reversion, as described
in <xref target="ref-hitless-reversion"/>, takes place to move the service back to the initial network setup.</t>
        </section>
      </section>
      <section anchor="optical-maintenance">
        <name>Optical Network Maintenance</name>
        <t>Before planned maintenance operation on the optical network takes place, the IP traffic affected by the maintenance operation should be moved hitlessly to another link. The MDSC and the P-PNC have to coordinate to reroute the traffic before the event happens. In such a case the IP traffic needs to be locked to the protection route until the maintenance event is finished, unless a fault occurs on such path.
In this example, it is supposed that the link undergoing maintenance activity is the one from ROADM1 to ROADM2, affecting the IP traffic steered from R1 to R2.
A few minutes before the maintenance window, the MDSC starts the process that brings to the hitless re-routing of the affected IP traffic. That means the IP backup path (through R3) is available and it is used only for the time requested by the optical plane to do maintenance. The path R1-R3 should not be overloaded, unless the network operator accepts some possible traffic losses.
At the optical layer, the maintenance activity has no impact on traffic as a new path is configured
upfront and the optical service does not revert to the original link until the maintenance window is finished.
At the of maintenance, the network configuration is moved back to the initial configuration using, if the network operator has chosen so, the multi-layer hitless reversion process discussed in <xref target="ref-hitless-reversion"/>.</t>
        <t>The next figure shows the process adopted to handle the maintenance window.</t>
        <figure anchor="fig-maintenance">
          <name>Maintenance window operation</name>
          <artwork type="ascii-art" name="maintenance.txt"><![CDATA[
  R1    ROADM1   P-PNC   O-PNC   MDSC   ROADM2    R2    ROADM3    R3
  |       |       |1.Switch to backup path|       |       |       |
  |       |       |<--------------|       |       |       |       |
  |2.Switch to backup path|       |       |       |       |       |
  |<--------------|       |       |       |       |       |       |
  |3.IP service switched  |       |       |       |       |       |
  |-------------->|       |       |       |       |       |       |
  |       |       |4.IP service switched  |       |       |       |
  |       |       |-------------->|       |       |       |       | 
  |       |       |       |5.Compute optical backup       |       |
  |       |       |       |<------|       |       |       |       | 
  |       |6.Enable optical backup|       |       |       |       |
  |       |<--------------|-------------->|       |       |       |
  |       |7.Acknowledge  |7.Acknowledge  |       |       |       |
  |       |-------------->|<--------------|       |       |       |
  |       |       |       |8.Acknowledge  |       |       |       |
  |       |       |       |------>|       |       |       |       | 
  |       |       |       |9.Switch to optical backup     |       |
  |       |       |       |<------|       |       |       |       | 
  |       |9.Switch to optical backup     |       |       |       |
  |       |<--------------|-------------->|       |       |       |
  |       |10.Acknowledge |10.Acknowledge |       |       |       |
  |       |-------------->|<--------------|       |       |       |
  |       |       |       |11.Acknowledge |       |       |       |
  |       |       |       |------>|       |       |       |       | 
  |       |       |12.Revert to initial path      |       |       |
  |       |       |<--------------|       |       |       |       |
  |13.Revert to initial path      |       |       |       |       |
  |<--------------|       |       |       |       |       |       |
  |14.IP service reverted |       |       |       |       |       |
  |-------------->|       |       |       |       |       |       |
  |       |       |15.IP service reverted |       |       |       |
  |       |       |-------------->|       |       |       |       | 
          ┌―――――――――――――――――――――――――――――――┐
          │     16.Maintenance window     │
          └―――――――――――――――――――――――――――――――┘
]]></artwork>
        </figure>
        <t>The steps include the following:</t>
        <ul spacing="normal">
          <li>
            <t>step 1. MDSC requires P-PNC to steer the IP service to a backup path (R1-R3-R2). This is necessary to avoid loss of service before maintenance starts</t>
          </li>
          <li>
            <t>step 2. P-PNC signals R1 to switch IP service to the backup path</t>
          </li>
          <li>
            <t>step 3. R1 switches to backup path and acks to P-PNC</t>
          </li>
          <li>
            <t>step 4. P-PNC acks to MDSC</t>
          </li>
          <li>
            <t>step 5. MDSC instructs O-PNC to enable the process to create an optical backup path</t>
          </li>
          <li>
            <t>step 6. O-PNC instructs ROADM1 and ROADM2 to enable a backup path</t>
          </li>
          <li>
            <t>step 7. ROADM1 and ROADM2 acknowledge to O-PNC</t>
          </li>
          <li>
            <t>step 8. O-PNC acknowledges to MDSC</t>
          </li>
          <li>
            <t>step 9. MDSC instructs O-PNC to disable the primary optical path, initially used, and switch to the optical backup path</t>
          </li>
          <li>
            <t>step 10. O-PNC instructs ROADM1 and ROADM2 to switch</t>
          </li>
          <li>
            <t>step 11. ROADM1 and ROADM2 acknowledge to O-PNC</t>
          </li>
          <li>
            <t>step 12. O-PNC acknowledges to MDSC</t>
          </li>
          <li>
            <t>step 13. MDSC requires P-PNC to move revert the IP service back to the primary path (R1-R2)</t>
          </li>
          <li>
            <t>step 14. P-PNC signals R1 to switch IP service to the primary path (carried over the optical backup path)</t>
          </li>
          <li>
            <t>step 15. R1 switches to backup path and acknowledges to P-PNC</t>
          </li>
          <li>
            <t>step 16. P-PNC acknowledges to MDSC</t>
          </li>
          <li>
            <t>step 17. The maintenance activity follows.</t>
          </li>
        </ul>
        <t>Once the activity is over, the network operator may wish to bring the whole configuration back to the IP and optical primary paths. In such a case, multi-layer hitless reversion may be performed, as described in <xref target="ref-hitless-reversion"/>.</t>
      </section>
      <section anchor="edge-resiliency">
        <name>Cross-layer Link Failures</name>
        <t>The approach described here leverages the multi-layer POI capabilities to address failures in links between IP routers and ROADMs, relying on optical network protection/restoration to handle most failure scenarios. The connectivity between a router and an edge ROADM is characterized by having N working ports and one spare port (N+1) to handle protection. Depending on the specific network configuration and protection scheme adopted, this approach may offer some cost advantages because it reduces the overall resources required for protection in the optical network. Since the number of failed links between IP routers and edge ROADMs is lower, this configuration can achieve higher availability at lower costs while recovering 100% of IP traffic.</t>
        <t>Following the previous examples, this case is characterized by having R1 configured with N ports working (say, P1-P3) and 1 spare port (PP) left as the protection of the other N.
In case of failure, for example of port P1, PP is dynamically activated and the traffic originally directed to P1 is steered to PP. PP receives the same configuration of P1 while P1 is brought in a down state.
Differently from ordinary LAG, the traffic is not redistributed over the surviving links. Since a backup port (PP) is enabled, the traffic keeps on flowing on N links instead of N-1.
If on the IP layer this scenario introduces the complexity of handling an extra port both on R1 and ROADM1, on the optical layer the configuration, as depicted in figure <xref target="fig-ref-network"/>, does not change as only N optical channels (e.g. lambdas) are used, as shown in figure <xref target="fig-N-1-port-prot-architecture"/>.</t>
        <figure anchor="fig-N-1-port-prot-architecture">
          <name>Use of N:1 protection on R1</name>
          <artwork type="ascii-art" name="N-1-port-prot-architecture.txt"><![CDATA[


┌――――――――――┐   ┌――――――――――┐
│        P1│---│P1        │
│          │   │       OP1│
│        P2│---│P2        │
│    R1    │   │  ROADM1  │
│        P3│---│P3        │
│          │   │       OP2│
│        PP│---│PP        │
└――――――――――┘   └――――――――――┘






]]></artwork>
        </figure>
        <t>Two sub-cases may be considered, depending on the availability of a Muxponder or a Transponder on ROADM1.
If a Muxponder is used, then the optical P1 and PP are hosted on the same optical complex (e.g. board) on the customer's edge of ROADM1. It is the optical complex that selects the input source of the signals and maps it on the proper lambda. If instead a Transpoder is used, then it's ROADM1's internal matrix that switches from the input source from P1 to PP, cross-connecting the signal to the output lambda.
It has to be noted that the mechanism to deal with the on-the-fly reconfiguration of a router's port is out of the scope of the present document and may be subject of a dedicated draft.</t>
        <t>The next figure shows the process adopted to handle N:1 port protection.</t>
        <figure anchor="fig-N-1-port-prot">
          <name>N:1 protection operation</name>
          <artwork type="ascii-art" name="N-1-port-prot.txt"><![CDATA[
  R1    ROADM1   P-PNC   O-PNC   MDSC   ROADM2    R2    ROADM3    R3
  |1.Port R1/P1 failure   |       |       |       |       |       |
  |-------------->|       |       |       |       |       |       |
  |       |       |2.Port R1/P1 failure   |       |       |       |
  |       |       |-------------->|       |       |       |       |
┌―――――――┐
│ 3.FRR │
└―――――――┘
  |4.IP service switched  |       |       |       |       |       |
  |-------------->|       |       |       |       |       |       |
  |       |       |5.IP service switched  |       |       |       |
  |       |       |-------------->|       |       |       |       |
┌―――――――┐
│6.PP Up│
└―――――――┘
  |7.Port R1/PP Up|       |       |       |       |       |       |
  |-------------->|       |       |       |       |       |       |
  |       |       |8.Port R1/PP Up|       |       |       |       |
  |       |       |-------------->|       |       |       |       |
  |       |       |       |9.Reconfigure access & connect new path|
  |       |       |       |<------|       |       |       |       |
  |       |10.Reconfigure access & connect new path       |       |
  |       |<--------------|       |       |       |       |       |
  |       |11.Acknowledge |       |       |       |       |       |
  |       |-------------->|       |       |       |       |       |
  |       |       |       |12.Acknowledge |       |       |       |
  |       |       |       |------>|       |       |       |       |
  |       |       |13.Switch back to initial path |       |       |
  |       |       |<--------------|       |       |       |       |
  |14.Switch back to initial path |       |       |       |       |
  |<--------------|       |       |       |       |       |       |
  |15.IP service switched |       |       |       |       |       |
  |-------------->|       |       |       |       |       |       |
  |       |       |16.IP service switched |       |       |       |
  |       |       |-------------->|       |       |       |       |
]]></artwork>
        </figure>
        <t>The sequence of steps is detailed.</t>
        <ul spacing="normal">
          <li>
            <t>step 1. R1 detects port P1 failure and notifies P-PNC</t>
          </li>
          <li>
            <t>step 2. P-PNC notifies MDSC of the failure</t>
          </li>
          <li>
            <t>step 3. R1 triggers FRR to protect the IP flows steering</t>
          </li>
          <li>
            <t>step 4. R1 informs P-PNC of the switch to the backup path</t>
          </li>
          <li>
            <t>step 5. P-PNC notifies MDSC of the traffic switch</t>
          </li>
          <li>
            <t>step 6. R1 handles the mechanism to replicate the configuration of P1 to PP</t>
          </li>
          <li>
            <t>step 7. R1 informs P-PNC that PP is up and ready to forward traffic</t>
          </li>
          <li>
            <t>step 8. P-PNC notifies MDSC that port PP is up and ready to forward traffic</t>
          </li>
          <li>
            <t>step 9. MDSC requires O-PNC to reconfigure ROADM1 access (both in the case of muxponder and transponder) and WDM connectivity if a transponder is used</t>
          </li>
          <li>
            <t>step 10. O-PNC signals ROADM1 to reconfigure access (muxponder/transponder) and WDM connectivity (transponder)</t>
          </li>
          <li>
            <t>step 11. ROADM1 acknowledges to O-PNC</t>
          </li>
          <li>
            <t>step 12. O-PNC acknowledges to MDSC</t>
          </li>
          <li>
            <t>step 13. MDSC requires P-PNC to revert to the initial (primary) path</t>
          </li>
          <li>
            <t>step 14. P-PNC notifies R1 to revert to initial (primary) path</t>
          </li>
          <li>
            <t>step 15. R1 notifies P-PNC of IP service switch and new port in use</t>
          </li>
          <li>
            <t>step 16. P-PNC notifies MDSC of service switch and new port in use</t>
          </li>
        </ul>
        <t>As in the previous cases, when port P1 on R1 is fixed, multilayer reversion <xref target="ref-hitless-reversion"/> to the initial configuration may happen. that is dependent on the network operator's preference.</t>
      </section>
      <section anchor="router-resiliency">
        <name>Router Node Failures</name>
        <t>As shown in <xref target="fig-ref-network"/>, in its normal operations R1 is dual-homed to R2 and R3. Even if highly unlikely due to the usual redundancy deployed in field, this case considers a full failure of R2 (node failure). The implications of such an event are useful to discuss the interaction between the IP and the optical layers through the MDSC coordination.
The underlying assumption is that it is not possible to R2 to communicate to P-PNC about the event causing the failure, so it is up to R1 to detect it and to communicate instead to P-PNC. The first reaction to the event is to perform a fast-rerouting action and move the traffic from the R1-R2 link to the R1-R3 link. As part of the assumption, the R1-R3 IP link has been previously dimensioned to carry a certain amount of traffic, so it is possible that after fast re-routing takes place some traffic previously carried on the R1-R2 IP link and now shifted to R1-R3 is discarded, for example because congestion occurs.
MDSC instructs the optical layer to find available optical resources, activate a new optical path between ROADM1 and ROADM3 and finally move the traffic previously associated to R1-R2 to the newly created optical path. When this second optical path is available, MDSC triggers a new switch of the traffic so that R1 can now steers the previous R1-R2 traffic to the new optical path. The final configuration is shown in figure <xref target="fig-node-prot-architecture"/>.</t>
        <figure anchor="fig-node-prot-architecture">
          <name>IP configuration after the creation of a second optical path</name>
          <artwork type="ascii-art" name="node-prot-architecture.txt"><![CDATA[

│<xxxxxxxxxxxxxxxxxxxxxxx IP Link R1-R2 xxxxxxxxxxxxxxxxxxxxxxx>│
┌――――――――┐  ┌――――――――┐                     ┌――――――――┐  ┌――――――――┐
│      P1│--│P1    P3│\        ___        /│P3    P1│--│P1      │
│  R1    │  │ ROADM1 │ \  ____/   \____  / │ ROADM2 │  │   R2   │
│      P2│--│P2    P4│\ \/             \/ /│P4    P2│--│P2      │
└――――――――┘  └――――――――┘ \|    Optical    |/ └――――――――┘  └――――――――┘
                        |    Network    |
│<xx IP Link R1-R3 xx    \_____________/   xx IP Link R3-R2 xxx>│
                     x      |       |     x
│<xX R1-R3 backup xx  x     |       |    x
                    x   x  ┌―――――――――┐  x
                     x   x │P3     P4│ x
                      x  x │ ROADM3  │ x
                      x  x │P1     P2│ x
                      x  x └―――――――――┘ x
                      x  x  |       |  x
                      x  x ┌―――――――――┐ x
                      x  x │P1     P2│ x
                      x  x │   R3    │ x
                      ˅  ˅ │         │ ˅
                      -  ― └―――――――――┘ ―





]]></artwork>
        </figure>
        <t>The next figure shows the process adopted to handle the node protection case.</t>
        <figure anchor="fig-node-prot">
          <name>Node protection operation</name>
          <artwork type="ascii-art" name="node-prot.txt"><![CDATA[
  R1    ROADM1   P-PNC   O-PNC   MDSC   ROADM2    R2    ROADM3    R3
┌―――――――――┐
│1.R2 down│
│ and FRR │
└―――――――――┘
  |2.R2 down + FRR|       |       |       |       |       |       |
  |-------------->|       |       |       |       |       |       |
  |       |       |3.R2 down + FRR|       |       |       |       |
  |       |       |-------------->|       |       |       |       |
  |4.IP service switched  |       |       |       |       |       |
  |-------------->|       |       |       |       |       |       |
  |       |       |5.IP service switched  |       |       |       |
  |       |       |-------------->|       |       |       |       |
  |       |       |       |6.Setup optical backup path    |       |
  |       |       |       |<------|       |       |       |       |
  |       |7.Setup path   |7.Setup path   |       |       |       |
  |       |<--------------|------------------------------>|       |
  |       |8.Acknowledge  |       |       |       |       |       |
  |       |-------------->|<------------------------------|       |
  |       |       |       |9.Backup path available|       |       |
  |       |       |       |------>|       |       |       |       |
  |       |       |10.Deploy new IP path and switch traffic       |
  |       |       |<--------------|       |       |       |       |
  |11.Deploy new path then switch |       |       |       |       |
  |<--------------|       |       |       |       |       |       |
  |12.IP service switched |       |       |       |       |       |
  |-------------->|       |       |       |       |       |       |
  |       |       |13.IP service switched |       |       |       |
  |       |       |-------------->|       |       |       |       |
]]></artwork>
        </figure>
        <ul spacing="normal">
          <li>
            <t>step 1. R1 detects R2's failure and triggers IP FRR finding R3 as the next hop</t>
          </li>
          <li>
            <t>step 2. R1 notifies P-PNC that R2 is down and FRR has started</t>
          </li>
          <li>
            <t>step 3. P-PNC notifies MDSC of the events</t>
          </li>
          <li>
            <t>step 4. Upon moving the R1-R2 traffic (or part of it) on R1-R3 path, R1 notifies P-PNC of the service switch</t>
          </li>
          <li>
            <t>step 5. P-PNC notifies MDSC of th eswitch</t>
          </li>
          <li>
            <t>step 6. MDSC requires O-PNC to compute a new optical path between ROADM1 and ROADM3</t>
          </li>
          <li>
            <t>step 7. O-PNC instructs both ROADM1 and ROADM3 to configure a new optical service</t>
          </li>
          <li>
            <t>step 8. Both ROADM1 and ROADM3 inform O-PNC that the backup path is available</t>
          </li>
          <li>
            <t>step 9. O-PNC informs MDSC that the backup path is available</t>
          </li>
          <li>
            <t>step 10. MDSC computes a new IP path between R1 and R3, provides the relevant information to P-PNC and triggers switch</t>
          </li>
          <li>
            <t>step 11. P-PNC transfers the information received to R1 and triggers R1 to switch traffic</t>
          </li>
          <li>
            <t>step 12. R1 informs P-PNC of the service switch</t>
          </li>
          <li>
            <t>step 13. P-PNC informs MDSC of the service switch.</t>
          </li>
        </ul>
      </section>
      <section anchor="ref-hitless-reversion">
        <name>Multi-layer hitless reversion</name>
        <t>In some cases, the mechanisms employed by the optical layer to revert to the original setup may cause disruption
at the IP layer, if proper coordination is not enabled. As this may cause traffic loss, if the optical reversion
is requested by the network operator, multi-layer coordination under the supervision of the MDSC is necessary.
The effect of multi-layer coordination is to bring the whole network, i.e. both the IP and the optical layers,
back to their initial configuration after the recovery from a failure. In particular, the process described in this section
relies on the hitless switching capability of the IP layer.
Depending on the specific configuration, the procedure can be enabled at the end of the use cases described in <xref target="resiliency"/>.
The decision whether to apply it or not has to be evaluated by the network operator considering different factors,
including the relative complexity of the process and the effects of its steps on the live traffic.</t>
        <t>To move back to the initial network configuration the MDSC has to follow a sequence of steps:</t>
        <ul spacing="normal">
          <li>
            <t>Force the IP layer to switch the traffic flow(s) on another path, e.g. an alternative/backup path</t>
          </li>
          <li>
            <t>Trigger the optical layer to coordinate the reversion to the initial setup, e.g. disable an optical backup path
and enable connectivity on the previously used primary path</t>
          </li>
          <li>
            <t>Force again the IP layer to switch back to the original path.
The actions on the IP layer are handled so that the IP traffic is switched only after the interface queues are emptied,
guaranteeing a hitless switching.</t>
          </li>
        </ul>
        <t>The mimics of the steps requested is shown in the next figure.</t>
        <figure anchor="fig-hitless-reversion">
          <name>hitless multi-layer reversion</name>
          <artwork type="ascii-art" name="hitless-multi-layer-reversion.txt"><![CDATA[
  R1    ROADM1   P-PNC   O-PNC   MDSC   ROADM2    R2    ROADM3    R3
  |       |1.Fiber back online notification       |       |       |
  |       |-------------->|       |       |       |       |       |
  |       |       |       |2.Fiber back online notification       |
  |       |       |       |------>|       |       |       |       |
  |       |       |3.Switch to backup path|       |       |       |
  |       |       |<--------------|       |       |       |       |
  |4.Switch to backup path|       |       |       |       |       |
  |<--------------|       |       |       |       |       |       |
  |5.Service switch notification  |       |       |       |       |
  |-------------->|       |       |       |       |       |       |
  |       |       |6.Service switch notification  |       |       |
  |       |       |-------------->|       |       |       |       |
  |       |       |       |7.Revert to primary    |       |       |
  |       |       |       |<------|       |       |       |       |
  |       |8.Revert to primary    |       |       |       |       |
  |       |<--------------|-------------->|       |       |       |
  |       |9.Acknowledge  |       |       |       |       |       |
  |       |-------------->|<--------------|       |       |       |
  |       |       |       |10.Acknowledge |       |       |       |
  |       |       |       |------>|       |       |       |       |
  |       |       |11.Revert to initial path      |       |       |
  |       |       |<--------------|       |       |       |       |
  |12.Revert to initial path      |       |       |       |       |
  |<--------------|       |       |       |       |       |       |
  |13.IP service reverted |       |       |       |       |       |
  |-------------->|       |       |       |       |       |       |
  |       |       |14.IP service reverted |       |       |       |
  |       |       |-------------->|       |       |       |       |
]]></artwork>
        </figure>
        <t>Figure 5.2 Diagram for hitless multi-layer reversion</t>
        <t>The steps illustrated in the previous figure are detailed here:</t>
        <ul spacing="normal">
          <li>
            <t>step 1. ROADM1 detects the optical signal is up again on the previously broken fiber and notifies O-PNC</t>
          </li>
          <li>
            <t>step 2. O-PNC notifies MDSC of the fiber up event</t>
          </li>
          <li>
            <t>step 3. MDSC requires P-PNC to move the affected IP service(s) to an alternative/backup path (this path may vary according to the scenarios explained later). Being a hitless switch, it is necessary to avoid loss of service</t>
          </li>
          <li>
            <t>step 4. P-PNC signals R1 to switch the IP service(s) to the alternative/backup path</t>
          </li>
          <li>
            <t>step 5. R1 switches the service(s) to the alternative/backup path and notifies P-PNC</t>
          </li>
          <li>
            <t>step 6. P-PNC confirms the switch to MDSC</t>
          </li>
          <li>
            <t>step 7. MDSC instructs O-PNC to disable the optical protection path (which may vary according to the scenarios detailed later) and activate again the optical primary path</t>
          </li>
          <li>
            <t>step 8. O-PNC instructs both ROADM1 and ROADM2 to disable the optical protection path and activate the primary one</t>
          </li>
          <li>
            <t>step 9. ROADM1 and ROADM2 acknowledge to O-PNC</t>
          </li>
          <li>
            <t>step 10. O-PNC acknowledges to MDSC</t>
          </li>
          <li>
            <t>step 11. MDSC requires P-PNC to revert the IP service(s) back to the primary path</t>
          </li>
          <li>
            <t>step 12. P-PNC signals R1 to switch the IP service(s) to primary path</t>
          </li>
          <li>
            <t>step 13. R1 switches and acknowledges to P-PNC</t>
          </li>
          <li>
            <t>step 14. P-PNC acknowledges to MDSC.</t>
          </li>
        </ul>
      </section>
    </section>
    <section anchor="conclusions">
      <name>Conclusions</name>
      <t>This section will provide a summary of the analysis and of the gaps identified in this draft once the analysis is mature.</t>
    </section>
    <section anchor="security-considerations">
      <name>Security Considerations</name>
      <t>TODO Security</t>
    </section>
    <section anchor="iana-considerations">
      <name>IANA Considerations</name>
      <t>This document has 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.709" target="https://www.itu.int/rec/T-REC-G.709/">
          <front>
            <title>Interfaces for the optical transport network</title>
            <author>
              <organization>International Telecommunication Union</organization>
            </author>
            <date year="2024" month="March"/>
          </front>
          <seriesInfo name="ITU-T Recommendation G.709, Amendment 3" value=""/>
        </reference>
        <reference anchor="ITU-T_G.798" target="https://www.itu.int/rec/T-REC-G.798/">
          <front>
            <title>Characteristics of optical transport network hierarchy equipment functional blocks</title>
            <author>
              <organization>International Telecommunication Union</organization>
            </author>
            <date year="2024" month="April"/>
          </front>
          <seriesInfo name="ITU-T Recommendation G.798" value=""/>
        </reference>
        <reference anchor="ITU-T_G.7710" target="https://www.itu.int/rec/T-REC-G.7710/">
          <front>
            <title>Common equipment management function requirements</title>
            <author>
              <organization>International Telecommunication Union</organization>
            </author>
            <date year="2022" month="November"/>
          </front>
          <seriesInfo name="ITU-T Recommendation G.7710, Amendment 1" value=""/>
        </reference>
        <reference anchor="ITU-T_G.874" target="https://www.itu.int/rec/T-REC-G.874/">
          <front>
            <title>Management aspects of optical transport network elements</title>
            <author>
              <organization>International Telecommunication Union</organization>
            </author>
            <date year="2024" month="January"/>
          </front>
          <seriesInfo name="ITU-T Recommendation G.874, Amendment 2" 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="I-D.ietf-teas-actn-poi-applicability">
          <front>
            <title>Applicability of Abstraction and Control of Traffic Engineered Networks (ACTN) to Packet Optical Integration (POI)</title>
            <author fullname="Fabio Peruzzini" initials="F." surname="Peruzzini">
              <organization>TIM</organization>
            </author>
            <author fullname="Jean-Francois Bouquier" initials="J." surname="Bouquier">
              <organization>Vodafone</organization>
            </author>
            <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="Daniele Ceccarelli" initials="D." surname="Ceccarelli">
              <organization>Cisco</organization>
            </author>
            <date day="25" month="February" year="2025"/>
            <abstract>
              <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.

   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>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-teas-actn-poi-applicability-14"/>
        </reference>
        <reference anchor="RFC8632">
          <front>
            <title>A YANG Data Model for Alarm Management</title>
            <author fullname="S. Vallin" initials="S." surname="Vallin"/>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <date month="September" year="2019"/>
            <abstract>
              <t>This document defines a YANG module for alarm management. It includes functions for alarm-list management, alarm shelving, and notifications to inform management systems. There are also operations to manage the operator state of an alarm and administrative alarm procedures. The module carefully maps to relevant alarm standards.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8632"/>
          <seriesInfo name="DOI" value="10.17487/RFC8632"/>
        </reference>
        <reference anchor="I-D.yu-performance-monitoring-yang">
          <front>
            <title>A YANG Data Model for Optical Performance Monitoring</title>
            <author fullname="Chaode Yu" initials="C." surname="Yu">
              <organization>Huawei Technologies</organization>
            </author>
            <date day="24" month="October" year="2022"/>
            <abstract>
              <t>   This document defines a YANG data model for performance Monitoring in
   optical networks which provides the functionalities of performance
   monitoring task management, TCA (Threshold Crossing Alert)
   configuration and performance data retrieval.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-yu-performance-monitoring-yang-00"/>
        </reference>
        <reference anchor="RFC9418">
          <front>
            <title>A YANG Data Model for Service Assurance</title>
            <author fullname="B. Claise" initials="B." surname="Claise"/>
            <author fullname="J. Quilbeuf" initials="J." surname="Quilbeuf"/>
            <author fullname="P. Lucente" initials="P." surname="Lucente"/>
            <author fullname="P. Fasano" initials="P." surname="Fasano"/>
            <author fullname="T. Arumugam" initials="T." surname="Arumugam"/>
            <date month="July" year="2023"/>
            <abstract>
              <t>This document specifies YANG modules for representing assurance graphs. These graphs represent the assurance of a given service by decomposing it into atomic assurance elements called subservices. The companion document, "Service Assurance for Intent-Based Networking Architecture" (RFC 9417), presents an architecture for implementing the assurance of such services.</t>
              <t>The YANG data models in this document conform to the Network Management Datastore Architecture (NMDA) defined in RFC 8342.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="9418"/>
          <seriesInfo name="DOI" value="10.17487/RFC9418"/>
        </reference>
        <reference anchor="RFC9375">
          <front>
            <title>A YANG Data Model for Network and VPN Service Performance Monitoring</title>
            <author fullname="B. Wu" initials="B." role="editor" surname="Wu"/>
            <author fullname="Q. Wu" initials="Q." role="editor" surname="Wu"/>
            <author fullname="M. Boucadair" initials="M." role="editor" surname="Boucadair"/>
            <author fullname="O. Gonzalez de Dios" initials="O." surname="Gonzalez de Dios"/>
            <author fullname="B. Wen" initials="B." surname="Wen"/>
            <date month="April" year="2023"/>
            <abstract>
              <t>The data model for network topologies defined in RFC 8345 introduces vertical layering relationships between networks that can be augmented to cover network and service topologies. This document defines a YANG module for performance monitoring (PM) of both underlay networks and overlay VPN services that can be used to monitor and manage network performance on the topology of both layers.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="9375"/>
          <seriesInfo name="DOI" value="10.17487/RFC9375"/>
        </reference>
        <reference anchor="I-D.feng-opsawg-incident-management">
          <front>
            <title>Incident Management for Network Services</title>
            <author fullname="Chong Feng" initials="C." surname="Feng">
         </author>
            <author fullname="Tong Hu" initials="T." surname="Hu">
              <organization>China Mobile (Hangzhou) Information
      Technology Co., Ltd</organization>
            </author>
            <author fullname="Luis M. Contreras" initials="L. M." surname="Contreras">
              <organization>Telefonica I+D</organization>
            </author>
            <author fullname="Thomas Graf" initials="T." surname="Graf">
              <organization>Swisscom</organization>
            </author>
            <author fullname="Qin Wu" initials="Q." surname="Wu">
              <organization>Huawei</organization>
            </author>
            <author fullname="Chaode Yu" initials="C." surname="Yu">
              <organization>Huawei</organization>
            </author>
            <author fullname="Nigel Davis" initials="N." surname="Davis">
              <organization>Ciena</organization>
            </author>
            <date day="30" month="January" year="2024"/>
            <abstract>
              <t>   A network incident refers to an unexpected interruption of a network
   service, degradation of a network service quality, or sub-health of a
   network service.  Different data sources including alarms, metrics
   and other anomaly information can be aggregated into few amount of
   network incidents by data correlation analysis and the service impact
   analysis.

   This document defines YANG Modules for the network incident lifecycle
   management.  The YANG modules are meant to provide a standard way to
   report, diagnose, and resolve network incidents for the sake of
   network service health and root cause analysis.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-feng-opsawg-incident-management-04"/>
        </reference>
      </references>
      <references anchor="sec-informative-references">
        <name>Informative References</name>
        <reference anchor="I-D.mix-teas-actn-poi-extension">
          <front>
            <title>Applicability of Abstraction and Control of Traffic Engineered Networks (ACTN) to Packet Optical Integration (POI) extensions to support Router Optical interfaces.</title>
            <author fullname="Gabriele Galimberti" initials="G." surname="Galimberti">
              <organization>Cisco</organization>
            </author>
            <author fullname="Jean-Francois Bouquier" initials="J." surname="Bouquier">
              <organization>Vodafone</organization>
            </author>
            <author fullname="Ori Gerstel" initials="O." surname="Gerstel">
              <organization>Cisco</organization>
            </author>
            <author fullname="Brent Foster" initials="B." surname="Foster">
              <organization>Cisco</organization>
            </author>
            <author fullname="Daniele Ceccarelli" initials="D." surname="Ceccarelli">
              <organization>Ericsson</organization>
            </author>
            <date day="24" month="October" year="2022"/>
            <abstract>
              <t>   This document extends the draft-ietf-teas-actn-poi-applicability to
   the use case where the DWDM optical coherent interface is equipped on
   the Packet device.  It identifies the YANG data models being defined
   by the IETF to support this deployment architecture and specific
   scenarios relevant for Service Providers.  Existing IETF protocols
   and data models are identified for each multi-layer (packet over
   optical) 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-mix-teas-actn-poi-extension-00"/>
        </reference>
        <reference anchor="RFC7799">
          <front>
            <title>Active and Passive Metrics and Methods (with Hybrid Types In-Between)</title>
            <author fullname="A. Morton" initials="A." surname="Morton"/>
            <date month="May" year="2016"/>
            <abstract>
              <t>This memo provides clear definitions for Active and Passive performance assessment. The construction of Metrics and Methods can be described as either "Active" or "Passive". Some methods may use a subset of both Active and Passive attributes, and we refer to these as "Hybrid Methods". This memo also describes multiple dimensions to help evaluate new methods as they emerge.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="7799"/>
          <seriesInfo name="DOI" value="10.17487/RFC7799"/>
        </reference>
        <reference anchor="RFC8799">
          <front>
            <title>Limited Domains and Internet Protocols</title>
            <author fullname="B. Carpenter" initials="B." surname="Carpenter"/>
            <author fullname="B. Liu" initials="B." surname="Liu"/>
            <date month="July" year="2020"/>
            <abstract>
              <t>There is a noticeable trend towards network behaviors and semantics that are specific to a particular set of requirements applied within a limited region of the Internet. Policies, default parameters, the options supported, the style of network management, and security requirements may vary between such limited regions. This document reviews examples of such limited domains (also known as controlled environments), notes emerging solutions, and includes a related taxonomy. It then briefly discusses the standardization of protocols for limited domains. Finally, it shows the need for a precise definition of "limited domain membership" and for mechanisms to allow nodes to join a domain securely and to find other members, including boundary nodes.</t>
              <t>This document is the product of the research of the authors. It has been produced through discussions and consultation within the IETF but is not the product of IETF consensus.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8799"/>
          <seriesInfo name="DOI" value="10.17487/RFC8799"/>
        </reference>
      </references>
    </references>
    <?line 1120?>

<section numbered="false" anchor="acknowledgments">
      <name>Acknowledgments</name>
      <t>TODO acknowledge.</t>
    </section>
  </back>
  <!-- ##markdown-source:
H4sIAAAAAAAAA+19a3PbWHbgd/wKrKd2W6omKVOy27Y26Ywsyx3P2hZLVmc2
Fae6IBKUMCYBBgD1mHFvTaVqvu2HfJhU5T/Nv8gv2fO891wApCi13d2baSXT
lkjgPs4997wf/X4/GheTLD/fj5f1tP80iuqsnqX78ddRHB8sFrNsnJxls6y+
iYtpfHBW1WUyrrMij5N8Eh8WeV0WM/zqtEym02wcH+XnWZ6mZTqJ36b1VVF+
qGCkrYPD07fb8bQo41Ey/pDW8fGihqFn8au8Ts/LhIbcGh2/2o6rtLzMxmmc
VNWyTPJxGiVnZ2V6uR8/wFFieCg+0O8eROMEBijKm/04y6dFFE2KcZ7MYQcT
WFHdXxTZpO7XaVL1YeE5/t13I/cfPo6q5dk8qyqYv75ZwGuvjk5fRjDZXoSL
Py+L5WI/Pj06eBf/9psoqmrY93fJrMjh0Zu0ihbZfvxPdTHuxVVR1mU6reC3
mzn/Mi7m8zSvq3+OomRZXxTlPsCiD/+LY17jqxqGip8vq4w+LEo4h79fJldp
Fp+m44u8mBXnWVrRl+k8yWawS3xlcAav/PqCnhzALG7YLK/249/0Xw7i58Xy
X5ZZWprZfpMmef8l7rzIqvABmvkfikkyhZ3Z6X6XTqeDM3n015fyRDAnD/4S
8KSIR2m5/P3vs9zs5/TVGzvgFJ8bLPS5X9fpLIXRcFtZMsjqxrCjBGAAK5st
krrYGEgLfGtwyW91wUkGL5MqzX+X1fGbJM8TP/xhVo2LYMByjk/8eoxf0EhR
XsBndXaZ4qG+Ov22f/rdN4MnD5/t03tyjRC9y2kyTitC/voijQvBfLhJebUA
pIlzvij0nscTtxgaI6crAq+dMrzmyxxGoWvzbQ7/pRcmcBf2YS/l+CLefbj7
iD6E+wTQwcuxz8uMT1JGzAm/T6vuxQf4CaIroD7tICnP03o/vqjrRbW/s3N1
dQXHsxxkeb1TpuOd0/7J0WGfXt6xEHj2NIDA17KVw4sESQcspoL9V0gzVkIi
vgBkw13cxCkg3oJWNV3mY4HB2awYf6g+FbwOFmU2uxu8nj29G4iePQ1A9GT4
MIDRIQwPA/u9ArIl52mw7bjEr0v68JNt/W1xmc7P0hJ3v7vx7mH5Fl2Gd4MF
vG2B8fTJowAWb/zWk2qRjutbUAX2+ElB8pskXyblzZ3wAfZgAbJ7J4DAyztR
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
tpTCHHBqA8xB9P8AAG0SlxodAQA=

-->

</rfc>
