<?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.17 (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-03" category="info" submissionType="IETF" tocInclude="true" sortRefs="true" symRefs="true" version="3">
  <!-- xml2rfc v2v3 conversion 3.22.0 -->
  <front>
    <title abbrev="ACTN POI Assurance">Applicability of Abstraction and Control of Traffic Engineered Networks (ACTN) for Packet Optical Integration (POI) service assurance</title>
    <seriesInfo name="Internet-Draft" value="draft-poidt-teas-actn-poi-assurance-03"/>
    <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="July" day="08"/>
    <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, for end-to-end customer L2VPN or L3VPN connectivity services setup over underlying transport optical paths, with specific Service Level Agreement (SLA) requirements.</t>
      <t>EDITORS NOTE: Replace RFC YYYY with the RFC number of draft-ietf-teas-actn-poi-applicability once it has been published.</t>
      <t>Existing IETF protocols and data models are identified for each
   multi-layer (packet over optical) service assurance scenario with a specific focus on
   the MPI (Multi-Domain Service Coordinator to Provisioning Network
   Controllers Interface) in the ACTN architecture.</t>
    </abstract>
  </front>
  <middle>
    <?line 83?>

<section anchor="introduction">
      <name>Introduction</name>
      <t>TODO Complete the Introduction</t>
      <t>Multi-layer and multi-domain service assurance scenarios, based on the reference
   network described in section 2 of <xref target="I-D.ietf-teas-actn-poi-applicability"/> and very relevant for Service
   Providers, are described in sections <xref target="fault"/>, <xref target="performance"/> and <xref target="resiliency"/>.</t>
      <t>This document is focusing on service assurance for end-to-end L2VPN or L3VPN connectivity services setup over underlying transport optical paths that requires multi-layer coordination</t>
      <t>For each scenario, existing IETF YANG data models,
   identified in section <xref target="yang"/>, are analyzed with a particular
   focus on the MPI in the ACTN architecture.</t>
      <t>For each multi-layer scenario, the document analyzes how to use the
   interfaces and data models of the ACTN architecture.</t>
      <t>A summary of the gaps identified in this analysis is provided in
   <xref target="conclusions"/>.</t>
      <t>Understanding the level of standardization and the possible gaps will
   help assess the feasibility of integration between packet and optical
   DWDM domains (and optionally OTN layer) from 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>TODO YANG Data Models</t>
      <t>Initial set of YANG models that are potentially in the scope of this analysis:</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>
      </ul>
    </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>TODO Describe performance monitoring and performance degradation detection performed by the O-PNC and how this information is reported to the MDSC: see for example the degradation scenario in https://github.com/italobusi/draft-poidt-teas-actn-poi-assurance/files/10885907/2023.03.draft-poidt-teas-poi-assurance.pptx (slide 7)</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>
      <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="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="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 1070?>

<section numbered="false" anchor="acknowledgments">
      <name>Acknowledgments</name>
      <t>TODO acknowledge.</t>
    </section>
  </back>
  <!-- ##markdown-source:
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
22v7AAA=

-->

</rfc>
