<?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.29 (Ruby 3.2.3) -->
<?rfc comments="yes"?>
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" ipr="trust200902" docName="draft-ietf-teas-actn-poi-assurance-00" category="info" submissionType="IETF" tocInclude="true" sortRefs="true" symRefs="true" version="3">
  <!-- xml2rfc v2v3 conversion 3.30.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-ietf-teas-actn-poi-assurance-00"/>
    <author initials="I." surname="Busi" fullname="Italo Busi">
      <organization>Huawei Technologies</organization>
      <address>
        <email>italo.busi@huawei.com</email>
      </address>
    </author>
    <author initials="J.-F." surname="Bouquier" fullname="Jean-Francois Bouquier">
      <organization>Vodafone</organization>
      <address>
        <email>jeff.bouquier@vodafone.com</email>
      </address>
    </author>
    <author initials="F." surname="Peruzzini" fullname="Fabio Peruzzini">
      <organization>TIM</organization>
      <address>
        <email>fabio.peruzzini@telecomitalia.it</email>
      </address>
    </author>
    <author initials="P." surname="Volpato" fullname="Paolo Volpato">
      <organization>Huawei Technologies</organization>
      <address>
        <email>paolo.volpato@huawei.com</email>
      </address>
    </author>
    <author initials="P." surname="Manna" fullname="Prasenjit Manna">
      <organization>Cisco</organization>
      <address>
        <email>prmanna@cisco.com</email>
      </address>
    </author>
    <date year="2025" month="July" day="23"/>
    <workgroup>TEAS WG</workgroup>
    <abstract>
      <?line 72?>

<t>This document extends the analysis of the applicability of Abstraction and Control of TE Networks (ACTN) architecture to Packet Optical Integration (POI) to cover multi-layer service assurance scenarios. Specifically, the ACTN architecture enables the detection and handling of different failures that may happen either at the optical or the packet layer. It is assumed that the underlying transport optical network carries end-to-end IP services such as L2VPN or L3VPN connectivity services, with specific Service Level Agreement (SLA) requirements.</t>
      <t>Existing IETF protocols and data models are identified for each
   multi-layer (packet over optical) service assurance scenario with a specific focus on
   the MPI (Multi-Domain Service Coordinator to Provisioning Network
   Controllers Interface) in the ACTN architecture.</t>
    </abstract>
  </front>
  <middle>
    <?line 81?>

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

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





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


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






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

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





]]></artwork>
        </figure>
        <t>The next figure shows the process adopted to handle the node protection case.</t>
        <figure anchor="fig-node-prot">
          <name>Node protection operation</name>
          <artwork type="ascii-art" name="node-prot.txt"><![CDATA[
  R1    ROADM1   P-PNC   O-PNC   MDSC   ROADM2    R2    ROADM3    R3
┌―――――――――┐
│1.R2 down│
│ and FRR │
└―――――――――┘
  |2.R2 down + FRR|       |       |       |       |       |       |
  |-------------->|       |       |       |       |       |       |
  |       |       |3.R2 down + FRR|       |       |       |       |
  |       |       |-------------->|       |       |       |       |
  |4.IP service switched  |       |       |       |       |       |
  |-------------->|       |       |       |       |       |       |
  |       |       |5.IP service switched  |       |       |       |
  |       |       |-------------->|       |       |       |       |
  |       |       |       |6.Setup optical backup path    |       |
  |       |       |       |<------|       |       |       |       |
  |       |7.Setup path   |7.Setup path   |       |       |       |
  |       |<--------------|------------------------------>|       |
  |       |8.Acknowledge  |       |       |       |       |       |
  |       |-------------->|<------------------------------|       |
  |       |       |       |9.Backup path available|       |       |
  |       |       |       |------>|       |       |       |       |
  |       |       |10.Deploy new IP path and switch traffic       |
  |       |       |<--------------|       |       |       |       |
  |11.Deploy new path then switch |       |       |       |       |
  |<--------------|       |       |       |       |       |       |
  |12.IP service switched |       |       |       |       |       |
  |-------------->|       |       |       |       |       |       |
  |       |       |13.IP service switched |       |       |       |
  |       |       |-------------->|       |       |       |       |
]]></artwork>
        </figure>
        <ul spacing="normal">
          <li>
            <t>step 1. R1 detects R2's failure and triggers IP FRR finding R3 as the next hop</t>
          </li>
          <li>
            <t>step 2. R1 notifies P-PNC that R2 is down and FRR has started</t>
          </li>
          <li>
            <t>step 3. P-PNC notifies MDSC of the events</t>
          </li>
          <li>
            <t>step 4. Upon moving the R1-R2 traffic (or part of it) on R1-R3 path, R1 notifies P-PNC of the service switch</t>
          </li>
          <li>
            <t>step 5. P-PNC notifies MDSC of th eswitch</t>
          </li>
          <li>
            <t>step 6. MDSC requires O-PNC to compute a new optical path between ROADM1 and ROADM3</t>
          </li>
          <li>
            <t>step 7. O-PNC instructs both ROADM1 and ROADM3 to configure a new optical service</t>
          </li>
          <li>
            <t>step 8. Both ROADM1 and ROADM3 inform O-PNC that the backup path is available</t>
          </li>
          <li>
            <t>step 9. O-PNC informs MDSC that the backup path is available</t>
          </li>
          <li>
            <t>step 10. MDSC computes a new IP path between R1 and R3, provides the relevant information to P-PNC and triggers switch</t>
          </li>
          <li>
            <t>step 11. P-PNC transfers the information received to R1 and triggers R1 to switch traffic</t>
          </li>
          <li>
            <t>step 12. R1 informs P-PNC of the service switch</t>
          </li>
          <li>
            <t>step 13. P-PNC informs MDSC of the service switch.</t>
          </li>
        </ul>
      </section>
      <section anchor="ref-hitless-reversion">
        <name>Multi-layer hitless reversion</name>
        <t>In some cases, the mechanisms employed by the optical layer to revert to the original setup may cause disruption
at the IP layer, if proper coordination is not enabled. As this may cause traffic loss, if the optical reversion
is requested by the network operator, multi-layer coordination under the supervision of the MDSC is necessary.
The effect of multi-layer coordination is to bring the whole network, i.e. both the IP and the optical layers,
back to their initial configuration after the recovery from a failure. In particular, the process described in this section
relies on the hitless switching capability of the IP layer.
Depending on the specific configuration, the procedure can be enabled at the end of the use cases described in <xref target="resiliency"/>.
The decision whether to apply it or not has to be evaluated by the network operator considering different factors,
including the relative complexity of the process and the effects of its steps on the live traffic.</t>
        <t>To move back to the initial network configuration the MDSC has to follow a sequence of steps:</t>
        <ul spacing="normal">
          <li>
            <t>Force the IP layer to switch the traffic flow(s) on another path, e.g. an alternative/backup path</t>
          </li>
          <li>
            <t>Trigger the optical layer to coordinate the reversion to the initial setup, e.g. disable an optical backup path
and enable connectivity on the previously used primary path</t>
          </li>
          <li>
            <t>Force again the IP layer to switch back to the original path.
The actions on the IP layer are handled so that the IP traffic is switched only after the interface queues are emptied,
guaranteeing a hitless switching.</t>
          </li>
        </ul>
        <t>The mimics of the steps requested is shown in the next figure.</t>
        <figure anchor="fig-hitless-reversion">
          <name>hitless multi-layer reversion</name>
          <artwork type="ascii-art" name="hitless-multi-layer-reversion.txt"><![CDATA[
  R1    ROADM1   P-PNC   O-PNC   MDSC   ROADM2    R2    ROADM3    R3
  |       |1.Fiber back online notification       |       |       |
  |       |-------------->|       |       |       |       |       |
  |       |       |       |2.Fiber back online notification       |
  |       |       |       |------>|       |       |       |       |
  |       |       |3.Switch to backup path|       |       |       |
  |       |       |<--------------|       |       |       |       |
  |4.Switch to backup path|       |       |       |       |       |
  |<--------------|       |       |       |       |       |       |
  |5.Service switch notification  |       |       |       |       |
  |-------------->|       |       |       |       |       |       |
  |       |       |6.Service switch notification  |       |       |
  |       |       |-------------->|       |       |       |       |
  |       |       |       |7.Revert to primary    |       |       |
  |       |       |       |<------|       |       |       |       |
  |       |8.Revert to primary    |       |       |       |       |
  |       |<--------------|-------------->|       |       |       |
  |       |9.Acknowledge  |       |       |       |       |       |
  |       |-------------->|<--------------|       |       |       |
  |       |       |       |10.Acknowledge |       |       |       |
  |       |       |       |------>|       |       |       |       |
  |       |       |11.Revert to initial path      |       |       |
  |       |       |<--------------|       |       |       |       |
  |12.Revert to initial path      |       |       |       |       |
  |<--------------|       |       |       |       |       |       |
  |13.IP service reverted |       |       |       |       |       |
  |-------------->|       |       |       |       |       |       |
  |       |       |14.IP service reverted |       |       |       |
  |       |       |-------------->|       |       |       |       |
]]></artwork>
        </figure>
        <t>Figure 5.2 Diagram for hitless multi-layer reversion</t>
        <t>The steps illustrated in the previous figure are detailed here:</t>
        <ul spacing="normal">
          <li>
            <t>step 1. ROADM1 detects the optical signal is up again on the previously broken fiber and notifies O-PNC</t>
          </li>
          <li>
            <t>step 2. O-PNC notifies MDSC of the fiber up event</t>
          </li>
          <li>
            <t>step 3. MDSC requires P-PNC to move the affected IP service(s) to an alternative/backup path (this path may vary according to the scenarios explained later). Being a hitless switch, it is necessary to avoid loss of service</t>
          </li>
          <li>
            <t>step 4. P-PNC signals R1 to switch the IP service(s) to the alternative/backup path</t>
          </li>
          <li>
            <t>step 5. R1 switches the service(s) to the alternative/backup path and notifies P-PNC</t>
          </li>
          <li>
            <t>step 6. P-PNC confirms the switch to MDSC</t>
          </li>
          <li>
            <t>step 7. MDSC instructs O-PNC to disable the optical protection path (which may vary according to the scenarios detailed later) and activate again the optical primary path</t>
          </li>
          <li>
            <t>step 8. O-PNC instructs both ROADM1 and ROADM2 to disable the optical protection path and activate the primary one</t>
          </li>
          <li>
            <t>step 9. ROADM1 and ROADM2 acknowledge to O-PNC</t>
          </li>
          <li>
            <t>step 10. O-PNC acknowledges to MDSC</t>
          </li>
          <li>
            <t>step 11. MDSC requires P-PNC to revert the IP service(s) back to the primary path</t>
          </li>
          <li>
            <t>step 12. P-PNC signals R1 to switch the IP service(s) to primary path</t>
          </li>
          <li>
            <t>step 13. R1 switches and acknowledges to P-PNC</t>
          </li>
          <li>
            <t>step 14. P-PNC acknowledges to MDSC.</t>
          </li>
        </ul>
      </section>
    </section>
    <section anchor="conclusions">
      <name>Conclusions</name>
      <t>This section will provide a summary of the analysis and of the gaps identified in this draft once the analysis is mature.</t>
    </section>
    <section anchor="security-considerations">
      <name>Security Considerations</name>
      <t>TODO Security</t>
    </section>
    <section anchor="iana-considerations">
      <name>IANA Considerations</name>
      <t>This document has no IANA actions.</t>
    </section>
  </middle>
  <back>
    <references anchor="sec-combined-references">
      <name>References</name>
      <references anchor="sec-normative-references">
        <name>Normative References</name>
        <reference anchor="ITU-T_G.709" target="https://www.itu.int/rec/T-REC-G.709/">
          <front>
            <title>Interfaces for the optical transport network</title>
            <author>
              <organization>International Telecommunication Union</organization>
            </author>
            <date year="2024" month="March"/>
          </front>
          <seriesInfo name="ITU-T Recommendation G.709, Amendment 3" value=""/>
        </reference>
        <reference anchor="ITU-T_G.798" target="https://www.itu.int/rec/T-REC-G.798/">
          <front>
            <title>Characteristics of optical transport network hierarchy equipment functional blocks</title>
            <author>
              <organization>International Telecommunication Union</organization>
            </author>
            <date year="2024" month="April"/>
          </front>
          <seriesInfo name="ITU-T Recommendation G.798" value=""/>
        </reference>
        <reference anchor="ITU-T_G.7710" target="https://www.itu.int/rec/T-REC-G.7710/">
          <front>
            <title>Common equipment management function requirements</title>
            <author>
              <organization>International Telecommunication Union</organization>
            </author>
            <date year="2022" month="November"/>
          </front>
          <seriesInfo name="ITU-T Recommendation G.7710, Amendment 1" value=""/>
        </reference>
        <reference anchor="ITU-T_G.874" target="https://www.itu.int/rec/T-REC-G.874/">
          <front>
            <title>Management aspects of optical transport network elements</title>
            <author>
              <organization>International Telecommunication Union</organization>
            </author>
            <date year="2024" month="January"/>
          </front>
          <seriesInfo name="ITU-T Recommendation G.874, Amendment 2" value=""/>
        </reference>
        <reference anchor="RFC8453">
          <front>
            <title>Framework for Abstraction and Control of TE Networks (ACTN)</title>
            <author fullname="D. Ceccarelli" initials="D." role="editor" surname="Ceccarelli"/>
            <author fullname="Y. Lee" initials="Y." role="editor" surname="Lee"/>
            <date month="August" year="2018"/>
            <abstract>
              <t>Traffic Engineered (TE) networks have a variety of mechanisms to facilitate the separation of the data plane and control plane. They also have a range of management and provisioning protocols to configure and activate network resources. These mechanisms represent key technologies for enabling flexible and dynamic networking. The term "Traffic Engineered network" refers to a network that uses any connection-oriented technology under the control of a distributed or centralized control plane to support dynamic provisioning of end-to- end connectivity.</t>
              <t>Abstraction of network resources is a technique that can be applied to a single network domain or across multiple domains to create a single virtualized network that is under the control of a network operator or the customer of the operator that actually owns the network resources.</t>
              <t>This document provides a framework for Abstraction and Control of TE Networks (ACTN) to support virtual network services and connectivity services.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8453"/>
          <seriesInfo name="DOI" value="10.17487/RFC8453"/>
        </reference>
        <reference anchor="I-D.ietf-teas-actn-poi-applicability">
          <front>
            <title>Applicability of Abstraction and Control of Traffic Engineered Networks (ACTN) to Packet Optical Integration (POI)</title>
            <author fullname="Fabio Peruzzini" initials="F." surname="Peruzzini">
              <organization>FiberCop</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="4" month="July" year="2025"/>
            <abstract>
              <t>   This document explores the applicability of the Abstraction and
   Control of TE Networks (ACTN) architecture to Packet Optical
   Integration (POI) within the context of IP/MPLS and optical
   internetworking.  It examines the YANG data models defined by the
   IETF that enable an ACTN-based deployment architecture and highlights
   specific scenarios pertinent to Service Providers.

   Existing IETF protocols and data models are identified for each
   multi-technology scenario (packet over optical), particularly
   emphasising the Multi-Domain Service Coordinator to Provisioning
   Network Controller Interface (MPI) within the ACTN architecture

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

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

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

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-feng-opsawg-incident-management-04"/>
        </reference>
      </references>
      <references anchor="sec-informative-references">
        <name>Informative References</name>
        <reference anchor="I-D.mix-teas-actn-poi-extension">
          <front>
            <title>Applicability of Abstraction and Control of Traffic Engineered Networks (ACTN) to Packet Optical Integration (POI) extensions to support Router Optical interfaces.</title>
            <author fullname="Gabriele Galimberti" initials="G." surname="Galimberti">
              <organization>Cisco</organization>
            </author>
            <author fullname="Jean-Francois Bouquier" initials="J." surname="Bouquier">
              <organization>Vodafone</organization>
            </author>
            <author fullname="Ori Gerstel" initials="O." surname="Gerstel">
              <organization>Cisco</organization>
            </author>
            <author fullname="Brent Foster" initials="B." surname="Foster">
              <organization>Cisco</organization>
            </author>
            <author fullname="Daniele Ceccarelli" initials="D." surname="Ceccarelli">
              <organization>Ericsson</organization>
            </author>
            <date day="24" month="October" year="2022"/>
            <abstract>
              <t>   This document extends the draft-ietf-teas-actn-poi-applicability to
   the use case where the DWDM optical coherent interface is equipped on
   the Packet device.  It identifies the YANG data models being defined
   by the IETF to support this deployment architecture and specific
   scenarios relevant for Service Providers.  Existing IETF protocols
   and data models are identified for each multi-layer (packet over
   optical) scenario with a specific focus on the MPI (Multi-Domain
   Service Coordinator to Provisioning Network Controllers Interface)in
   the ACTN architecture.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-mix-teas-actn-poi-extension-00"/>
        </reference>
        <reference anchor="RFC7799">
          <front>
            <title>Active and Passive Metrics and Methods (with Hybrid Types In-Between)</title>
            <author fullname="A. Morton" initials="A." surname="Morton"/>
            <date month="May" year="2016"/>
            <abstract>
              <t>This memo provides clear definitions for Active and Passive performance assessment. The construction of Metrics and Methods can be described as either "Active" or "Passive". Some methods may use a subset of both Active and Passive attributes, and we refer to these as "Hybrid Methods". This memo also describes multiple dimensions to help evaluate new methods as they emerge.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="7799"/>
          <seriesInfo name="DOI" value="10.17487/RFC7799"/>
        </reference>
        <reference anchor="RFC8799">
          <front>
            <title>Limited Domains and Internet Protocols</title>
            <author fullname="B. Carpenter" initials="B." surname="Carpenter"/>
            <author fullname="B. Liu" initials="B." surname="Liu"/>
            <date month="July" year="2020"/>
            <abstract>
              <t>There is a noticeable trend towards network behaviors and semantics that are specific to a particular set of requirements applied within a limited region of the Internet. Policies, default parameters, the options supported, the style of network management, and security requirements may vary between such limited regions. This document reviews examples of such limited domains (also known as controlled environments), notes emerging solutions, and includes a related taxonomy. It then briefly discusses the standardization of protocols for limited domains. Finally, it shows the need for a precise definition of "limited domain membership" and for mechanisms to allow nodes to join a domain securely and to find other members, including boundary nodes.</t>
              <t>This document is the product of the research of the authors. It has been produced through discussions and consultation within the IETF but is not the product of IETF consensus.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8799"/>
          <seriesInfo name="DOI" value="10.17487/RFC8799"/>
        </reference>
      </references>
    </references>
    <?line 1120?>

<section numbered="false" anchor="acknowledgments">
      <name>Acknowledgments</name>
      <t>TODO acknowledge.</t>
    </section>
  </back>
  <!-- ##markdown-source:
H4sIAAAAAAAAA+19a3PbWHbgd/wKrKd2W6omKVOy27Y26Ywsyx3P2hZLVmc2
Fae6IBKUMCYBBgD1mHFvTaVqvu2HfJhU5T/Nv8gv2fO891wApCi13d2baSXT
lkjgPs4997wf/X4/GheTLD/fj5f1tP80iuqsnqX78ddRHB8sFrNsnJxls6y+
iYtpfHBW1WUyrrMij5N8Eh8WeV0WM/zqtEym02wcH+XnWZ6mZTqJ36b1VVF+
qGCkrYPD07fb8bQo41Ey/pDW8fGihqFn8au8Ts/LhIbcGh2/2o6rtLzMxmmc
VNWyTPJxGiVnZ2V6uR8/wFFieCg+0O8eROMEBijKm/04y6dFFE2KcZ7MYQcT
WFHdz1LYVp0mVR/WnfcXRdZ3A/cfPoyq5dk8qyqYvr5ZwFuvjk5fRjDXXoRr
Py+L5WI/Pj06eBf/9psoqmrY9nfJrMjh0Zu0ihbZfvxPdTHuxVVR1mU6reC3
mzn/Mi7m8zSvq3+OomRZXxTlPoCiD/+LY17iqxqGip8vq4w+LEo4hr9fJldp
Fp+m44u8mBXnWVrRl+k8yWawSXxlcAav/PqCnhzALG7YLK/249/0Xw7i58Xy
X5ZZWprZfpMmef8l7rzIqvABmvkfikkyhZ3Z6X6XTqeDM3n015fyRDAnD/4S
0KSIR2m5/P3vs9zs5/TVGzvgFJ8bLPS5X9fpLIXRcFtZMsjqxrCjBGAAK5st
krrYGEgLfGtwyW91wUkGL5MqzX+X1fGbJM8TP/xhVo2LYMByjk/8eoxf0EhR
XsBndXaZ4qG+Ov22f/rdN4MnD5/t03tyixC7y2kyTivC/foijQtBfLhIebUA
pIlzvif0nscTtxgaI6cbAq+dMrzmyxxGoVvzbQ7/pRcmcBX2YS/l+CLefbj7
iD6E6wTQwbuxz8uMT1JGzAm/T6vuxQf4CaIroD7tICnP03o/vqjrRbW/s3N1
dQXHsxxkeb1TpuOd0/7J0WGfXt6xEHj2NIDA17KVw4sEKQcspoL9V0gyVkIi
vgBkw13cxCkg3oJWNV3mY4HB2awYf6g+FbwOFmU2uxu8nj29G4iePQ1A9GT4
MIDRIQwPA/u9ArIl52mw7bjEr0v68JNt/W1xmc7P0hJ3v7vx7mH5Fl2Gd4MF
vG2B8fTJowAWb/zWk2qRjutbUAX2+ElB8pskXyblzZ3wAfZgAbJ7J4DAyztR
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
gFMbYA6i/weZAbhmGR0BAA==

-->

</rfc>
