<?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.19 (Ruby 3.3.3) -->
<?rfc comments="yes"?>
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" ipr="trust200902" docName="draft-poidt-teas-actn-poi-assurance-04" category="info" submissionType="IETF" tocInclude="true" sortRefs="true" symRefs="true" version="3">
  <!-- xml2rfc v2v3 conversion 3.23.2 -->
  <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-04"/>
    <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="2024" month="October" day="21"/>
    <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), provided in RFC YYYY, 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>
      <ul empty="true">
        <li>
          <t>RFC Editor: Please replace YYYY with the RFC number of draft-ietf-teas-actn-poi-applicability once it has been published. Please remove this note.</t>
        </li>
      </ul>
      <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 83?>

<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 (PNC-P) and optical (PNC-O) layers.</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>
      <t>TO DO - Complete the description of the pre-requisites of MDSC in the cases discussed.</t>
      <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 {: #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 {: #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 {: #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 {: #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 ({: #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 {: #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 {: #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>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>Multi-layer performance managent is in scope of the present document. In this context it is assumed that:
1. O-PNC is capable of monitoring the DWDM links optical performance, and alert MDSC when the pre-FEC BER value overcomes a user-specified threshold
2. 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. 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 multi-layer performance managent by the MDSC 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 the next section, including fast-reroute at the IP layer.</t>
    </section>
    <section anchor="resiliency">
      <name>Multi-layer Resiliency</name>
      <!-- (Comment by Paolo - The following is a new section) -->

<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>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="5" month="July" year="2024"/>
            <abstract>
              <t>   This document considers the applicability of Abstraction and Control
   of TE Networks (ACTN) architecture to Packet Optical Integration
   (POI) in the context of IP/MPLS and optical internetworking.  It
   identifies the YANG data models defined by the IETF to support this
   deployment architecture and specific scenarios relevant to Service
   Providers.

   Existing IETF protocols and data models are identified for each
   multi-technology (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-ietf-teas-actn-poi-applicability-12"/>
        </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>
      </references>
    </references>
    <?line 1082?>

<section numbered="false" anchor="acknowledgments">
      <name>Acknowledgments</name>
      <t>TODO acknowledge.</t>
    </section>
  </back>
  <!-- ##markdown-source:
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
rcyGthbmbhmEEw16yHcCYHKrl5LtOAMfW1+U1Bd9UPPt7dSj6QEFLl8H1Yzl
9mWT1l4UwXEJ17VG1/Zim2hYYb0bLpHtFRGtQ98ozNRUPE7cV1H067/q9+Md
icNGvh8nxbyI++yH9xXPKimTLYPZjcFAjaTyn6mt13GBguUZ7r/7Xop2ybjI
3TFuoxewbJ1eYEDF/XyujVy+kynrFXh28/UFbeeCZW0UwZEbuFf+a82H4cvM
QfXIgFdgXa+zxWoRz+bptYSz94g+4VXtXFE058OBEgNYAaAcWzvaQXRMuUgX
7eve5QYkd0c7E85MtH3FhuMXRzWlQhUFqrc227i1gYqkdZclsJcHbFX1L6IT
jO8WMJXi8HKkBA6slEL1w7r6SLRcklzwdrZVjtvP5/3j6FyBTJRfXrrwzQQV
XWhe5HvFbIbfqz698aG/BQnbh9/pBoADvtwCZgObcudztt3U+KfNZy6I2MXX
f5eA5kIvCYVMJ9pWhQ+eSOkzqcQY5A4Eu+TAFJnfw9KGcst9mOcc7vJNyc76
W7MzyRyUGgFSmY39RHI9OFfuXHPP9/e53eaCC7i6WCFole7mKikLlqolcNoK
xwEZhX0Ff5fqKPF2aksziHa4VOm+r5W7z2P2UUn+SmMt4P8t1uYM7HpTkrel
r5BrKtTTg5qDSmBztR2IzCWH4NVYC5UC2kwFUJeJ4rsdRC9nHZJ0ipWBMX3L
1C32q9NzYpZUPb57HZONsfCiTTlDaAEt5lRYOnrtV3jnxQmYfizFTOmIPSoR
qpdYU874IP4dipAgt1KdVm0a91Q3VZkMwqkwqh9s/TNzqqhbzpTOraRyPFcQ
7uNK3FYftq0AS3niuJWVKOVf+Ua+iqvWXeUtqAOBkIhyd/n6Ki9G3Xkc482b
mAHuaxaqtsL3bp6u7zbY+KONj3bcSeHeJeHgpUPQ6mHQi2WTVC5RnBPMQ2ob
sadswhk846v6ImUvQcaY++9MTmHrDg++oYTvELLlOjUtDYU/KHx12lEltyZQ
j1UBsaxhLcR122pReRX4WFvv2LJd148pz0nmPmtDUtYyW2QT45x1yhozfNsT
qxdKiIiKRcnwLijxYYoFEcvlEe4KACxuH5na+8NkwMVRAwW1eVFy+1/bRiPe
5tZ3u9po/jvaclyb2th2PNjG8Ox+dLBt3JcOm+YyuuO4utq467jWer7+H92S
sj/ALbD+8hC6w+PDw4HRp9x9QbaWujs4TvZ3fziCPuoc1ycmaHwnpzYSOm7+
3PF9WCp66d++GJx4qWw8fNZh2HyGX93aEa2evmC0d3jbkvjxYJzQ4Y939/Hn
9qN7yaPGlO8lj54M3tgNeK82vuf+C3fhl7BmeH3a7Zf4kHj7fNA0b1Bt/dHF
23B4t3F9lN3Y8BZzzV+juaizOLxFnRSyoq35tC9ecV+pn1jSxbUSlYH6Ek1U
oIsLO/BRxjxNKJfm8qjD1VUw7MiaQo3Wl5trwXqJ4nryjK023MT14HxEzUMR
SR3FGo+rDHvf5puoY23XDqsK6u9RT/ZStmS+wNs9bVgbVyQEwvl5wNDG7Xlw
6aIOfBKmQWAal8IhG5wBMKMzCtoSmlMOIGNFUCqneVNDrxx1V8KlU7Uz/FHn
RvKQRhLSQS2U1hEVGFmqSIsavdMwX3ZdF49ahLGOZ27ZPfzFoAMRFzow3OO3
iOq/8VOrt3tXWTIFJpboB4mPPFurGy/cEB5DgwietcfBLsAwbrZpJqy5BkMb
f9LidkuMOzb2ZbAbyFW8di/YpcvyjO4+p4XjW/Lo4tBsFoBzLvKVJSIvFzOE
35Gfb2Ag73pr9urfH3ZuG/+m3K6sAbMEPTGj9NYxBK20oK3kJVXYFP1s6lhf
7/KJbPUxV7zO3agTOv0Qf1lTkswhk74sIjzGThuPVygg+zLXNe21F1WRiTAp
zN2/M8kqiTwm6N5dampXTLdHsArk3p+QAEdJmdVSjrMyZS8MqLpIpmkzydC5
D6LjGZiyPZUczeutDVc5uOjCIItxsqoLqujK9zucrWyNFAYbfMkW6T0KwOkl
gTXepYLBSRp6gfvB+W2JS3qBC0NvmPXjIf+yw3t7shIBRBBSR8SNEChqEQjT
cjd3iVxkZFZuh9vGpWd9aaHvWhCIunIYNUVtOCilAZz4L6LouSear5MDBL3M
MIiba0qG9WM8ghreX86H6FSporCVq9BTUeXFpESRHpE6YzCNnt9P6IHjO8mx
0XblMPJ5hxdUG9cN+jkF5XPNwQSpU3SdKkCORmTh8M8rAr5t0armNPnq8il7
Zc2cfsZOmv/+jJ0IHX5K2AkjJ+geugU5uZulHzd/xOx/OBj7/eNjhb9qTej7
2/qWbI/a5vujn4L5/sVPx3xHRniMVu/Xyw0gmmOIDmPVSMZtbFX/eNNUNVC/
KdHhFC9f2q3z9jKKhvnZlv3Bbdn43T8eTTFk7TPWzA84AEv7hIHj6Mqbv/kn
a/XijFv6IIWRkd/OOzVQAVqRKoBnchVevuCiHjgICWs3i1Z6YR3f3itvzd0O
9YfL1yZlsNa94Fa+LMcL3ijMbY1BwZXpXLCFuGyNEfwJrcovBvFHNCsf8zpt
Z1fStNFbSbvWuJYpvFX975j6V6COHCYArNGuuNG8kKjApgdMqyKyWegNM9ZV
1Qff81GR7kIETEe8lriTzvgWkC9oNKI3zsViqgGFpIo0aKrMzrOcUhiMCUAq
fi3Wo3qrb7EzwnLg0SbdvhfsZCpsepm2htg0t3WesEtWy0ZhefTlA49rQHc7
4uK1fyCKnnIwCLrHMZbPvOwLtDZFrrsw2o/cmYjKKS6tVVa4u2Ff0ROnPVVK
svRKco5a4yDx02bUAgszCvOnOBy9Y5RNZcbdyD/qwiJcYBBH00ntFgrxrczl
dI2ZYKSP9+VO3rN8EytOOZ27W4Fkmbemy70Rn+YE3fXgQWIYjR6Re+0KGQfH
L2tsrKsMLSW50ZteWUzClzHle5Vt34kJ+qclzFNTfWZo01LWxpPQvclYfdTe
A0xFMdMrOLryVU3Qi6Ou7R+O82lxZWJOBB8NHOk4Edqarjaz31Eaw+TEnvKV
iTwB3sBccYlvp7FbcHXHegPRHGfJOeeUD6bqqtJLafRQosMGAae0MmzsK63i
FQSMppn5Mps6CG5fGRxRpzOO254XydSwQKfUwvSxJWbiYPCgRmK49UCtwtTQ
alwa2VwBxwEYpgfiNwM7fcJalG5VjZykcQcnebRawqrndStMUoWTC+9RcKoh
SoU3u7YFs4bdF35KM/tkLyBSiM9gGgVJji4pGT5KaDrhoZ00pyhGLICdEzxK
o90I7DgMpxke2inn5Sw1KALBC+FOULQpvOK1TbRPD0Dov8PBW4famj11Jytn
WyvLtjG6Y79dbdy136429u/o0+9q41MAEN0xEJ8WgIg3mbCPBs8Y12tqoVsM
RP/99bYLZRv5YnAk8ctBv3eiapNTtqVMGF5wOMHbA+Z0sVP7723a+BT4xJN7
jKP570fhkC/Nlu7gkU/HIdt2vIkiH4NDhp8HS9H6e5s2PgWHDId3H0fz3+/F
IcORRJzwFTPGj7n9QO5zyAz379ZvVxsf45AZPvyJhtA8+uFDaAhllp9PXq3l
uz8FvXHlieEXg9dtNVWeCJ7/xPVUmhCt1QMFne0YqDOuW4UnjJliMFnOPNQL
BgMcNkgcJAXSpTtJhYSCjcNmZAnl5QYmGFlDGEFi7gFTNJEevyyyqUdtFfpg
o9JOnO1Hm0AYlmqT+xdY4IdDwkF2QWMSuMNKVNXQODkrd/Le14WwuKPkYcnX
ART8SNNvJUNQS7P5EKBtg8mbqKDWe9B22+jjmjAjCwZ2pKiaM6CFgrsQF/NU
e85frp+zSS2DSWcLXHcL4fdUAOMVZRUayJTsGASbbKILxqxsRZhGbNJweGda
DEdbEWO4v3bTEMZnwjkMn1o7Vunkt5CJwBo+vCPrh63h9Z/o73C3knUQ13T2
aJs9EtAi3CsgVP1m2UCzx4ygdAIYkt0Axq/LRbTwVuFu+utEga+y6iLEgK8u
inkz3sOSX7JDPa7t6dcCDbcJPDlLNZWb2Hvb6A97F04zmW7jhTiu+kpH3hre
9YTpaEPrtiGE/k3MyTp6Jd9Oldz04vGwP95nnxSwwZIzhIB7d8bjXbmR2UEZ
iolqNjaBuG8G9gbmzsIumHJJCXBD6G9MzrobOLok14eWmsoPKBal+JWCTVjz
SC8QRgYcsgso1Yt3x+MBtiuFLyQmDQuqhCyA918NtSo6tXFG8CFlmiZcooWu
+h60A2wYgwYmeXX4214wyExhMhCENSw6XanmNl+1gq1KK0L1IfDuZ2J9t8sc
rX0MTNj++xSPcRj+THyo8OsbqTahGWQwszf9ISXqFeHF1+Lk06vY8c7WYrqa
CJHYh3MtjiZCppzTDPrn0VFuctGoKdRrug60twbRe82Ux01ZeQ5zFIddUjFy
+8bXoOL6JFrXYZ4szqaJFHWQw6WjbCX1BQTq43zIFd5PygnsSGApeODbjuqV
8HO7kkqhFNs8ZqtIjqUMG1b4GxoVNaw0yX/4j47ptaCdkW9n1NEOw4amHUUQ
m+3s+3b27zCeUbOdsW9nHLZzmzpNASLbPBbxT6A8r19X1aW/ZtH05mAYCDHk
6KYqvb4xp1kHCZUi/X1AXccV6S1/bvx6dY0+ca6kk8SnXD2EP9AYV9rM9lHx
ZZhYQ90UY96YQHXcBhcFuTWkcxKDvoIbbXfZPGdFUk53XXTkqqqLRYoBAqQc
wUBlIPHL2jmZGg3JFStzV6c5y5cr+ITyLF1csWgxdOttsqQwgcJFS2IyNW9j
8seqRHNUaU89qz9TDfCzyhQCS0D66pBUnXHBkcHA6NPxkI+OHtfE6duaY27U
TkFd1fi+DBRvt0CvArsOOdLZX5voItqpIjBVpJK03CLvwz/9GV3v3TqbtHCa
FkFDzWdVOypuKmYktCVe1LIo1OI0pbpzmFQAx0l9T18F7RwcUpDn+4kcFcPB
GLs6Ge7BCmkswB3xjk+BmYzuOK5PGBnoz5Tb8ir/dXNq5Y9P1R8ltfIWqn4x
GGOk3RZUfex5At+4F0U+BVWf3HFcHylhde13mHjozBGtofo/NDTJuag/ioeg
Acxv1fGmNu6LAwfj2BKI39TGfflko4Ng9MM5CDpx6H314Kh5HoD1W7VxL//A
w7v129XGR/EPdIu/H11+DL+427g+foptoIirIt/U4NcB4sHLASTeKszHgcMU
uzywoLiJqBToIignG4bvtkHrzsBOaaABT7tCsXiSUy27wlWwhUWYUd0PAjuw
Ok6YCap3g2zI4+uCVDfneLrosHau51A0wqqt6ZYp1Viq0zYGIMALadsBUt2c
AOnQDBDBkJHOnBSAxXykbqwMzsLXXVPh2pK0cHdq7ssmsutg7tKcIwor83Gy
QwCJKSxHUU7ObuPqw87CY6gNC4aGpXtnvoykNfc6YHCHCrtAv7J9xu24Aezd
3vmOfaQTQG9Aux8bNg9jzFQW7wgwu9twCDxsrfnJMGzlthYerUmDbedQ02ZH
LYEsMow1Szug79Y+2qaVjmhoAhUkFFrFDiNvGgwtcLRWclQUei3GvDlyjstp
Y7DsINa7Nhm/oMJJYf09Bd0/0/Q8lKQgNG318CaM3V1C/NBgdJ1AYMY3ceZY
JHHu5XwllJiuknn/opCSsydyCROw19El4gMzKmiK7qZ8nr2nivkr5yxZVSuq
xTBd5dMEa2DCfOfFjYKT6Xyq1cHkSngCdiiidzWf+7to6dLWnRwnJp/tsocD
q3i6iz6pEhUxgBb6ZKAS2hLfGUYYygp1V4FaV8oS3/JJ4lJA1edUcs4jBQ/P
qQ52R/FdjpBFwNWHohZys2Wj/GHzkiaezSTxlQwc8o93VpnbP3lvSln2rNbq
mLZ9Vwit8Okw0GBWUqEFTSsoTMdcV1ucLlKTQYqS0lz5FUJFNOo+yMbGDziV
nu96KNwn+1q6vMKEFAe/eOr1zKNaLxnBoDNcMN3J5LFYpDluQiknmZQlVhWc
gIjCDI1kgVWwqXkemCGcXw0qqE/3HDQqPwbJBRRNrPMzQ3CuwNxM2NZ4BmEN
OzGbCdzDk8o48hWOx+aFUWcpLjjtChDwfLRTgPsganiHOzwDWm3QxWi367I5
V5CELW9VgpmrWMzET9RabkMOWMNikiVmsiNdeegN6UWO+mnQr9wUrNVNizz8
Ogg7l/vBTOl/KlvLZ0BTuyp4deV+YVoJVPKq8ESQUcpLfrSNMfJ+aaW4BLnO
gTcEBde2nhCsAHXd/YPc9ErvHh7Fa576iqGUTRmOm/0oHTmr+PP9mvTOC3HJ
OI8MuUTeaS/mrp895yRpvmJcJsbxgv8RfsVf3/FFQnjdzzu+QmjPPzLyrwg0
GjhYxN3jvD3jhzTGd+HdQfAnjfFh1yu3u2PQEXPL9+/IYNPMIzTc9m575Zbv
o3jND/WkuU1kIjInBky3D0wXx/5apm/cVU32wX3hzq/CSC/zc236dP9ec4//
W3oSWwo7vG4/fd3Z8DX/7xYvIXJr9/vSgPfO0cKvezi+locdrL7Nw8LCxC+3
PbzRSQeLvfF1S7Bb+rmNXB9zTrTjiLqbHv7zH+l/1i2Kv//5j2ue78P3//rv
W5AM/unwa3ZLaIVC+OoXW8+EtAQyQfEUcz6ljjOrCZd092Rxk/skt5BqbNAa
1Kc/kdfoVm7BbTwcwJsY46FiFdWGW70nFu0faQvxr/DFnwzav3/HcX0stP9n
n9J2CPkXg7eYzdsViLd1G/fxfjyWfqWj1t/btLE5PaL581VnG9smqmwaR7Of
ZknSxs9WNP1y8NSGOqoWf6e1/T78Mfx88JzAB1LogWddyKVCuKL2b2jjXt6P
oe1XyupidiT3ulUbH8X7MfqJej+6cwM/rfzoPvud56NxmK51fbg39fjudGmc
jD6ruq7Hq5AL8UxEU53CSPc1/JNUgItiaX0dbQyVTdoRX990lbszFgESqdlh
3R8bvBB8q7b1d9A96WDfK+AUmsY7dCsbAzZZvcuwKSrtHIO+vuphsMxbuUji
tO0aWeM1kJJod8IzrIukGfh+1lWUZJ97ch6AoK9mCcgna+pl7us9k8d+IRv+
owDrsC4Te0+ldcBs9T46NgS9JFopbKLysHnpxT5eJAhcoMWFXOFGe6mORywt
c3dkCAjbov9jpuCLbUhiigUxCpsLwvKbnqThaIOHrpvnhm5HBKTsfMnds9CF
+hP0/npT2DpXsETYUFwOgT9P731sV0dwWN6aqgBUtoTcCowUTrOqXBFsGjWu
itK745YdtQDpVhGOhSYgli9VdI3acgku7d+jiTpFKmnTqPLQ9GX01tckJOhc
YriXSPvKhL7r7Wwu1Ynh9pRqWLD/b32pw45cBRkXzGaQDm6/xqrqRSafISvX
uHe8TVjq1T+Eficq+ynZAaVmNlnNE0my6CxhaW93imDLoUQUWFmZixkT5+Uu
iboxxYnlgrDnzfBYueFw0owbd0OZrqikKN0RpFUik1ad0K2uhBpIsbJ2CVa8
IuiGIlNLYj8f3pli2apkAw85JxFOyt8QN0sm8CWslL86TcQVX2cSxt4H9rQs
OXNTxSdaJQELQrU5NuEu6MELwgj53lRSKOQNx8UyU87BIcCgESNByYIvinKS
BktpZZ91r0ArOxWdv1rmh09gvRnUXOmy1whOODWX9LYkjq0DdGFL0TamSyJI
utPctDWpd0hoSacL/OFF6JaVxLUgT8jThAturaGMXQ8nJLkK0OmFu0ezlbRB
cdxSelgdBfKASTtxmiklSfjN7i92hJVcybU/KXqv0mkvOl8lcNrVaUqOsvbu
lRhhuWVGDx/iPS9Of9waqoMXVA+QiAtzz/LG1clb6On3tRs21lDdclyfyp7c
/5FKujz8iZR0eTR4G4Zd3KPG7qewJ7+447g+NR712BRHUJl21zbug0c92bLf
TW18jHIdX356POpe63KfsiHNf78Pf4A99ONU67hjlZCuNj4KHrX/E63Wcccq
Ih8fj2qZmIpLqfYQ3i8sDzWxKW3FPOxbVLzqBYMYjwaj+HmW4M3iFIKysaOg
3sV8vqrqMqmDWyA4mEIBktIULMYy+e17tD1UZnVRyQmTeFLS+9qq4llZYP1T
LlkcxAqvuSG7O1aYXoduCAdrXZW9pvIARSqZOorCM6iPU9nNdco3VlLEuCP8
Fe3sSxTNyWRCGve5KrCaRUyXks8TuiIcr+sudwfx0051Uktb3l4RpF17o7P4
gSjB4bxo1uutCsXzgjIHHlC5vZFNEd8uBJSsq3LRdSGKBfS2qaLRUW+XF+nq
Iptst0COvXl9pI6DBlc5i6WrAkK7Msgt8ONo2/EHg+BdI+VC8gBOvGvVjs+3
Cz9eX+qms2AH8sW6mh0ByndXdu1uqFGrZovCGw83Fd4QfBC4cgLyEI1Muor9
mf9bCklUrvz7fK7AKqIAqwUvjYQ/wtxuqozHJZ+dUy4vRgpzgXVFiSjTFNZU
K3noq4Th1Wwh/jJ+m05WJRrbzwQ94YhZGNXx82P3LT758vDNYfspe7muVkCl
J8WmxmyOfp/LQEMjXrFakF/hDwf5anGGGdt//WAG65ZSqAN2bag5iP4/WsdJ
zJQLAQA=

-->

</rfc>
