A Yang Data Model for Optical Impairment-aware Topology
draft-lee-ccamp-optical-impairment-topology-yang-00

CCAMP Working Group                                              Y. Lee
Internet Draft                                                 H. Zheng
Intended status: Standard Track                                  Huawei
Expires: April 23, 2019
                                                               N. Sambo
                                             Scuola Superiore Sant'Anna

                                                               V. Lopez
                                                             Telefonica

                                                          G. Galimberti
                                                                  Cisco

                                                       October 22, 2018

          A Yang Data Model for Optical Impairment-aware Topology

            draft-lee-ccamp-optical-impairment-topology-yang-00

Abstract

   This document provides a YANG data model for the impairment-aware TE
   topology in optical networks.

Status of this Memo

   This Internet-Draft is submitted to IETF in full conformance with
   the provisions of BCP 78 and BCP 79.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF), its areas, and its working groups.  Note that
   other groups may also distribute working documents as Internet-
   Drafts.

   Internet-Drafts are draft documents valid for a maximum of six
   months and may be updated, replaced, or obsoleted by other documents
   at any time.  It is inappropriate to use Internet-Drafts as
   reference material or to cite them other than as "work in progress."

   The list of current Internet-Drafts can be accessed at
   http://www.ietf.org/ietf/1id-abstracts.txt

   The list of Internet-Draft Shadow Directories can be accessed at
   http://www.ietf.org/shadow.html

   This Internet-Draft will expire on April 23, 2019.

Copyright Notice

Lee, et al.               Expires April 2019                   [Page 1]
Internet-Draft   Optical Impairment-Aware YANG Model       October 2018

   Copyright (c) 2018 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   This document is subject to BCP 78 and the IETF Trust's Legal
   Provisions Relating to IETF Documents
   (http://trustee.ietf.org/license-info) in effect on the date of
   publication of this document. Please review these documents
   carefully, as they describe your rights and restrictions with
   respect to this document.  Code Components extracted from this
   document must include Simplified BSD License text as described in
   Section 4.e of the Trust Legal Provisions and are provided without
   warranty as described in the Simplified BSD License.

Table of Contents

   1. Introduction...................................................2
      1.1. Terminology...............................................3
      1.2. Tree diagram..............................................4
      1.3. Prefixes in Data Node Names...............................4
   2. YANG Model (Tree Structure)....................................4
   3. Optical Impairment Topology YANG Model.........................6
   4. Security Considerations.......................................18
   5. IANA Considerations...........................................19
   6. Acknowledgments...............................................19
   7. References....................................................20
      7.1. Normative References.....................................20
      7.2. Informative References...................................20
   8. Contributors..................................................21
   Authors' Addresses...............................................21

1. Introduction

   In order to provision an optical connection (an optical path)
   through a wavelength switched optical networks (WSONs) or spectrum
   switched optical networks (SSONs), a combination of path continuity,
   resource availability, and impairment constraints must be met to
   determine viable and optimal paths through the network. The
   determination of appropriate paths is known as Impairment-Aware
   Routing and Wavelength Assignment (IA-RWA) [RFC6566] for WSON, while
   it is known as IA-Routing and Spectrum Assigment (IA-RSA) for SSON.

Lee, et al.               Expires April 2019                   [Page 2]
Internet-Draft   Optical Impairment-Aware YANG Model       October 2018

   This document provides a YANG data model for the impairment-aware
   Traffic Engineering (TE) topology in WSONs and SSONs. The YANG model
   described in this document is a WSON/SSON technology-specific Yang
   model based on the information model developed in [RFC7446] and the
   two encoding documents [RFC7581] and [RFC7579] that developed
   protocol independent encodings based on [RFC7446].

   The intent of this document is to provide a Yang data model, which
   can be utilized by an Multi Domain Service Coordinator (MDSC) to
   collect states of WSON impairment data from the Transport PNCs to
   enable impairment-aware optical path computation according to the
   ACTN Architecture [RFC8453]. The communication between controllers
   is done via a NETCONF [RFC8341]. Similarly, this model can also be
   exported by the MDSC to a Customer Network Controller (CNC), which
   can run an offline planning process to map latter the services in
   the network.

   This document augments the generic TE topology draft [TE-TOPO] where
   possible.

   This document defines one YANG module: ietf-optical-impairment-
   topology (Section 3) according to the new Network Management
   Datastore Architecture [RFC8342].

1.1. Terminology

   Refer to [RFC4847] and [RFC5253] for the key terms used in this
   document.

   The following terms are defined in [RFC7950] and are not redefined
   here:

   o client

   o server

   o augment

   o data model

   o data node

   The following terms are defined in [RFC6241] and are not redefined
   here:

   o  configuration data

Lee, et al.               Expires April 2019                   [Page 3]
Internet-Draft   Optical Impairment-Aware YANG Model       October 2018

   o  state data

   The terminology for describing YANG data models is found in
   [RFC7950].

1.2. Tree diagram

   A simplified graphical representation of the data model is used in
   Section 2 of this this document.  The meaning of the symbols in
   these diagrams is defined in [RFC8340].

1.3. Prefixes in Data Node Names

   In this document, names of data nodes and other data model objects
   are prefixed using the standard prefix associated with the
   corresponding YANG imported modules, as shown in Table 1.

   +------------------+----------------------------------+------------+
   | Prefix           | YANG module                      | Reference  |
   +------------------+----------------------------------+------------+
   | optical-imp-topo | ietf-optical-impairment-topology | [RFC XXXX] |
   | layer0-types     | ietf-layer0-types                | [WSON-topo]|
   | nw               | ietf-network                     | [RFC8345]  |
   | nt               | ietf-network-topology            | [RFC8345]  |
   | tet              | ietf-te-topology                 | [TE-TOPO]  |
   +------------------+----------------------------------+------------+

             Table 1: Prefixes and corresponding YANG modules

   Note: The RFC Editor will replace XXXX with the number assigned to
   the RFC once this draft becomes an RFC.

2. YANG Model (Tree Structure)

   module: ietf-optical-impairment-topology
     augment /nw:networks/nw:network/nw:network-types/tet:te-topology:
       +--rw optical-impairment-topology!
     augment /nw:networks/nw:network/nt:link/tet:te/tet:te-link-attributes:
       +--ro fiber-type?   fiber-type
       +--ro power?        int32
       +--ro pmd?          decimal64
       +--ro cd?           decimal64
       +--ro osnr?         decimal64

Lee, et al.               Expires April 2019                   [Page 4]
Internet-Draft   Optical Impairment-Aware YANG Model       October 2018

     augment /nw:networks/nw:network/nt:link/tet:te/tet:te-link-
   attributes/tet:underlay/tet:primary-path/tet:path-
   element/tet:type/tet:label/tet:label-hop/tet:te-label/tet:technology:
       +--:(optical-imp-topo)
          +--rw (grid-type)?
          |  +--:(flexi-grid)
          |  |  +--ro central-channel-freq?   decimal64
          |  |  +--ro slot-width?             decimal64
          |  +--:(dwdm)
          |  |  +--ro channel-freq?           decimal64
          |  +--:(cwdm)
          |     +--ro channel-wavelength?     uint32
          +--ro bit-rate?                     decimal64
          +--ro BER?                          decimal64
          +--ro pmd?                          decimal64
          +--ro cd?                           decimal64
          +--ro osnr?                         decimal64
          +--ro q-factor?                     decimal64
     augment /nw:networks/nw:network/nt:link/tet:te/tet:te-link-
   attributes/tet:underlay/tet:backup-path/tet:path-
   element/tet:type/tet:label/tet:label-hop/tet:te-label/tet:technology:
       +--:(optical-imp-topo)
          +--rw (grid-type)?
          |  +--:(flexi-grid)
          |  |  +--ro central-channel-freq?   decimal64
          |  |  +--ro slot-width?             decimal64
          |  +--:(dwdm)
          |  |  +--ro channel-freq?           decimal64
          |  +--:(cwdm)
          |     +--ro channel-wavelength?     uint32
          +--ro bit-rate?                     decimal64
          +--ro BER?                          decimal64
          +--ro pmd?                          decimal64
          +--ro cd?                           decimal64
          +--ro osnr?                         decimal64
          +--ro q-factor?                     decimal64
     augment /nw:networks/tet:te/tet:templates/tet:link-template/tet:te-link-
   attributes/tet:underlay/tet:primary-path/tet:path-
   element/tet:type/tet:label/tet:label-hop/tet:te-label/tet:technology:
       +--:(optical-imp-topo)
          +--rw (grid-type)?
          |  +--:(flexi-grid)
          |  |  +--ro central-channel-freq?   decimal64
          |  |  +--ro slot-width?             decimal64
          |  +--:(dwdm)
          |  |  +--ro channel-freq?           decimal64
          |  +--:(cwdm)
          |     +--ro channel-wavelength?     uint32
          +--ro bit-rate?                     decimal64

Lee, et al.               Expires April 2019                   [Page 5]
Internet-Draft   Optical Impairment-Aware YANG Model       October 2018

          +--ro BER?                          decimal64
          +--ro pmd?                          decimal64
          +--ro cd?                           decimal64
          +--ro osnr?                         decimal64
          +--ro q-factor?                     decimal64
     augment /nw:networks/tet:te/tet:templates/tet:link-template/tet:te-link-
   attributes/tet:underlay/tet:backup-path/tet:path-
   element/tet:type/tet:label/tet:label-hop/tet:te-label/tet:technology:
       +--:(optical-imp-topo)
          +--rw (grid-type)?
          |  +--:(flexi-grid)
          |  |  +--ro central-channel-freq?   decimal64
          |  |  +--ro slot-width?             decimal64
          |  +--:(dwdm)
          |  |  +--ro channel-freq?           decimal64
          |  +--:(cwdm)
          |     +--ro channel-wavelength?     uint32
          +--ro bit-rate?                     decimal64
          +--ro BER?                          decimal64
          +--ro pmd?                          decimal64
          +--ro cd?                           decimal64
          +--ro osnr?                         decimal64
          +--ro q-factor?                     decimal64
     augment /nw:networks/nw:network/nw:node/tet:te/tet:tunnel-termination-point:
       +--rw available-operational-mode*   layer0-types:operational-mode
       +--rw operational-mode?             layer0-types:operational-mode
       +--rw vendor-identifier?            layer0-types:vendor-identifier
       +--rw transponder-id?               uint32
       +--ro available-modulation*         identityref
       +--rw modulation-enabled?           boolean
       +--rw modulation-type?              identityref
       +--ro available-FEC*                identityref
       +--rw FEC-enabled?                  boolean
       +--rw FEC-type?                     identityref
       +--ro FEC-code-rate?                decimal64
       +--rw FEC-threshold?                decimal64
       +--ro power?                        int32
       +--ro power-min?                    int32
       +--ro power-max?                    int32
     augment /nw:networks/nw:network/nw:node/tet:te/tet:tunnel-termination-point:
       +--ro transponder-list* [carrier-id]
          +--ro carrier-id    uint32

3. Optical Impairment Topology YANG Model

<CODE BEGINS> file ietf-optical-impairment-topology@2018-10-22.yang

module   ietf-optical-impairment-topology {

Lee, et al.               Expires April 2019                   [Page 6]
Internet-Draft   Optical Impairment-Aware YANG Model       October 2018

  yang-version 1.1;

  namespace "urn:ietf:params:xml:ns:yang:ietf-optical-impairment-topology";

  prefix "optical-imp-topo";

  import ietf-network {
    prefix "nw";
  }

  import ietf-network-topology {
    prefix "nt";
  }

  import ietf-te-topology {
    prefix "tet";
  }

  import ietf-layer0-types {
    prefix "layer0-types";
  }

  organization
    "IETF CCAMP Working Group";

  contact
    "Editor:   Young Lee <leeyoung@huawei.com>
     Editor:   Haomian Zheng <zhenghaomian@huawei.com>
     Editor:   Nicola Sambo <nicosambo@gmail.com>
     Editor:   Victor Lopez <victor.lopezalvarez@telefonica.com>
     Editor:   Gabriele Galimberti <ggalimbe@cisco.com>";

  description
   "This module contains a collection of YANG definitions for
   impairment-aware optical networks.

   Copyright (c) 2018 IETF Trust and the persons identified as
   authors of the code.  All rights reserved.

   Redistribution and use in source and binary forms, with or
   without modification, is permitted pursuant to, and subject
   to the license terms contained in, the Simplified BSD
   License set forth in Section 4.c of the IETF Trust's Legal
   Provisions Relating to IETF Documents
   (http://trustee.ietf.org/license-info).";

  revision 2018-10-22 {
   description
      "version 0.";

Lee, et al.               Expires April 2019                   [Page 7]
Internet-Draft   Optical Impairment-Aware YANG Model       October 2018

      reference
        "RFC XXX: A Yang Data Model for Impairment-aware Optical Networks ";
  }

  identity modulation {
    description "base identity for modulation type";
  }
  identity QPSK {
   base modulation;
   description
      "QPSK (Quadrature Phase Shift Keying) modulation";
  }
  identity DP_QPSK {
    base modulation;
    description
     "DP-QPSK (Dual Polarization Quadrature
      Phase Shift Keying) modulation";
  }
  identity QAM8 {
    base modulation;
    description
       "8QAM (8-State Quadrature Amplitude Modulation) modulation";
  }
  identity QAM16 {
    base modulation;
    description
       "QAM16 (Quadrature Amplitude Modulation)";
  }
  identity  DP_QAM8 {
    base modulation;
    description
       "DP-QAM8 (Dual Polarization Quadrature Amplitude Modulation)";
  }
  identity DC_DP_QAM8 {
    base modulation;
    description
       "DC DP-QAM8 (Dual Polarization Quadrature Amplitude Modulation)";
  }
  identity  DP_QAM16 {
    base modulation;
    description
       "DP-QAM16 (Dual Polarization Quadrature Amplitude Modulation)";
  }
  identity DC_DP_QAM16 {
    base modulation;
    description
       "DC DP-QAM16 (Dual Polarization Quadrature Amplitude Modulation)";
  }

Lee, et al.               Expires April 2019                   [Page 8]
Internet-Draft   Optical Impairment-Aware YANG Model       October 2018

  identity FEC {
    description
     "Enumeration that defines the type of
      Forward Error Correction";
  }
  identity reed-solomon {
    base FEC;
   description
     "Reed-Solomon error correction";
  }
  identity hamming-code {
    base FEC;
   description
     "Hamming Code error correction";
  }
  identity golay {
    base FEC;
   description "Golay error correction";
  }

  typedef fiber-type {
        type enumeration {
            enum G.652 {
               description "G.652 Standard Singlemode Fiber";
            }
            enum G.654 {
               description "G.654 Cutoff Shifted Fiber";
            }
            enum G.653 {
               description "G.653 Dispersion Shifted Fiber";
            }
            enum G.655 {
               description "G.655 Non-Zero Dispersion Shifted Fiber";
            }
            enum G.656 {
               description "G.656 Non-Zero Dispersion for Wideband
                            Optical Transport";
            }
            enum G.657 {
               description "G.657 Bend-Insensitive Fiber";
            }
        }
   description
      "ITU-T based fiber-types";
  }

  grouping optical-label {

Lee, et al.               Expires April 2019                   [Page 9]
Internet-Draft   Optical Impairment-Aware YANG Model       October 2018

    description
      "Generic label for optical links and paths";
    choice grid-type {
      description
        "Label for Flexigrid, DWDM or CWDM grid";
      case flexi-grid {
        leaf central-channel-freq {
          type decimal64 {
            fraction-digits 5;
          }
          units THz;
          config false;
          description
            "The Flexi-grid central frequency in THz, e.g. 193.12500";
          reference
            "RFC7698";
        }
        leaf slot-width {
          type decimal64 {
            fraction-digits 5;
          }
          units GHz;
          config false;
          description
            "The Flexi-grid slot width in GHz, e.g. 50, 100, 150.";
          reference
            "RFC7698";
   }
      }
      case dwdm {
        leaf channel-freq {
          type decimal64 {
            fraction-digits 5;
          }
          units THz;
          config false;
          description
            "The DWDM frequency in THz, e.g. 193.12500";
          reference
            "RFC6205";
        }
      }
      case cwdm {
        leaf channel-wavelength {
          type uint32;
          units nm;
     config false;
          description
            "The CWDM wavelength in nanometer, e.g. 1511";

Lee, et al.               Expires April 2019                  [Page 10]
Internet-Draft   Optical Impairment-Aware YANG Model       October 2018

          reference
            "RFC6205";
        }
      }
    }
  }

  grouping transponder-attributes {
   description "Configuration of an optical transponder";

   leaf-list available-modulation {
     type identityref {
       base modulation;
     }
     config false;
     description
       "List determining all the available modulations";
   }
   leaf modulation-enabled {
     type boolean;
     description
       "Determines whether the modulation is enabled or not";
   }
   leaf modulation-type {
     type identityref {
       base modulation;
     }
     description
       "Modulation type of the transponder";
   }
   leaf-list available-FEC {
     type identityref {
       base FEC;
     }
     config false;
          description "List determining all the available FEC";
   }
   leaf FEC-enabled {
     type boolean;
          description
         "Determines whether the FEC is enabled or not";
   }
   leaf FEC-type {
     type identityref {
       base FEC;
     }
     description
       "FEC type of the transponder";

Lee, et al.               Expires April 2019                  [Page 11]
Internet-Draft   Optical Impairment-Aware YANG Model       October 2018

   }
   leaf FEC-code-rate {
     type decimal64 {
       fraction-digits 8;
       range "0..max";
     }
     config false;
     description "FEC-code-rate";
   }

        leaf FEC-threshold {
     type decimal64 {
       fraction-digits 8;
       range "0..max";
     }
     description "Threshold on the BER, for which FEC is able to correct errors";
   }
   leaf power {
          type int32;
          units "dBm";
          config false;
          description "per channel power";
        }
   leaf power-min {
          type int32;
          units "dBm";
          config false;
          description "minimum power of the transponder";
        }
   leaf power-max {
          type int32;
          units "dBm";
          config false;
          description "maximum power of the transponder";
        }
  }

  grouping sliceable-transponder-attributes {
   description
     "Configuration of a sliceable transponder.";
   list transponder-list {
     key "carrier-id";
     config false;
      description "List of carriers";
       leaf carrier-id {
         type uint32;
         config false;
        description "Identifier of the carrier";
       }

Lee, et al.               Expires April 2019                  [Page 12]
Internet-Draft   Optical Impairment-Aware YANG Model       October 2018

   }
  }

/*  grouping wson-node-attributes {
   description "WSON node attributes";
   container wson-node {
      description "WSON node attrtibutes.";
      leaf node-type {
       type identityref {
         base te-wson-types:wson-node-type;
       }
       description "WSON node type.";
      }
   }
  }
*/

  grouping optical-fiber-data {
      description "optical link (fiber) attributes with impairment data";

      leaf fiber-type {
    type fiber-type;
    config false;
    description "fiber-type";
      }

      leaf power {
         type int32;
    units "dBm";
         config false;
         description "Total Input Power Level at the line port of the link";
      }
      leaf pmd {
    type decimal64 {
            fraction-digits 8;
       range "0..max";
    }
    units "ps/(km)^0.5";
    config false;
            description "Polarization Mode Dispersion";
      }
      leaf cd {
    type decimal64 {
       fraction-digits 5;
    }
    units "ps/nm/km";
    config false;
       description "Cromatic Dispersion";
      }

Lee, et al.               Expires April 2019                  [Page 13]
Internet-Draft   Optical Impairment-Aware YANG Model       October 2018

      leaf osnr {
    type decimal64 {
            fraction-digits 5;
    }
    units "dB";
    config false;
       description "osnr";
      }
/*    leaf sigma {
    type decimal64 {
            fraction-digits 5;
    }
    units "dB";
    config false;
       description "sigma in the Gausian Noise Model";
      }
     */
  }

  grouping optical-impairment-data {
   description "optical impairment data per channel/wavelength";
     leaf bit-rate {
       type decimal64 {
         fraction-digits 8;
         range "0..max";
       }
       units "Gbit/s";
      config false;
       description "Gross bit rate";
     }
     leaf BER {
       type decimal64 {
        fraction-digits 18;
          range "0..max";
        }
        config false;
        description "BER";
     }
     leaf pmd {
       type decimal64 {
        fraction-digits 8;
        range "0..max";
       }
       units "ps/(km)^0.5";
       config false;
        description "Polarization Mode Dispersion";
     }
     leaf cd {
       type decimal64 {

Lee, et al.               Expires April 2019                  [Page 14]
Internet-Draft   Optical Impairment-Aware YANG Model       October 2018

        fraction-digits 5;
       }
       units "ps/nm/km";
       config false;
       description "Cromatic Dispersion";
     }
     leaf osnr {
       type decimal64 {
        fraction-digits 5;
       }
       units "dB";
       config false;
       description "osnr";
     }
     leaf q-factor {
       type decimal64 {
        fraction-digits 5;
       }
       units "dB";
       config false;
       description "q-factor";
     }
  }

  grouping wson-ttp-attributes {
    description
      "WSON tunnel termination point (e.g.tranponder) attributes";
      leaf-list available-operational-mode {
        type layer0-types:operational-mode;
        description "List of all vendor-specific supported
        mode identifiers";
      }

      leaf operational-mode {
        type layer0-types:operational-mode;
        description "Vendor-specific mode identifier";
      }

      leaf vendor-identifier {
          type layer0-types:vendor-identifier;
          description "vendor identifier that uses vendor-specific mode";
        }
  }

/* Data nodes */

  augment "/nw:networks/nw:network/nw:network-types"
    + "/tet:te-topology" {
    description "optical-impairment topology augmented";

Lee, et al.               Expires April 2019                  [Page 15]
Internet-Draft   Optical Impairment-Aware YANG Model       October 2018

    container optical-impairment-topology {
      presence "indicates an impairment-aware topology of optical networks";
      description
       "Container to identify impairment-aware topology type";
    }
  }

  augment "/nw:networks/nw:network/nt:link/tet:te"
    + "/tet:te-link-attributes"   {
    when "/nw:networks/nw:network/nw:network-types"
      +"/tet:te-topology/optical-imp-topo:optical-impairment-topology" {
      description
        "This augment is only valid for Optical Impairment.";
    }
    description "Optical Link augmentation for impairment data.";
    uses optical-fiber-data;
  }

    /* Augment label hop of underlay primary path of TE link */
  augment "/nw:networks/nw:network/nt:link/tet:te/"
        + "tet:te-link-attributes/"
        + "tet:underlay/tet:primary-path/tet:path-element/tet:type/"
        + "tet:label/tet:label-hop/tet:te-label/tet:technology" {
    when "../../../../../../../../"
       + "nw:network-types/tet:te-topology/"
       + "optical-imp-topo:optical-impairment-topology" {
      description "Augment optical TE label";
    }
    description "optical label.";
    case optical-imp-topo {
      uses optical-label;
     uses optical-impairment-data;
    }
  }

  /* Augment label hop of underlay backup path of TE link */
  augment "/nw:networks/nw:network/nt:link/tet:te/"
        + "tet:te-link-attributes/"
        + "tet:underlay/tet:backup-path/tet:path-element/tet:type/"
        + "tet:label/tet:label-hop/tet:te-label/tet:technology" {
    when "../../../../../../../../"
       + "nw:network-types/tet:te-topology/"
       + "optical-imp-topo:optical-impairment-topology" {
      description "Augment optical TE label";
    }
    description "optical label.";
    case optical-imp-topo {
      uses optical-label;
     uses optical-impairment-data;

Lee, et al.               Expires April 2019                  [Page 16]
Internet-Draft   Optical Impairment-Aware YANG Model       October 2018

    }
  }
    /* Augment label hop of underlay primary path of TE link template */
  augment "/nw:networks/tet:te/tet:templates/"
        + "tet:link-template/tet:te-link-attributes/"
        + "tet:underlay/tet:primary-path/tet:path-element/tet:type/"
        + "tet:label/tet:label-hop/tet:te-label/tet:technology" {
/*
    when "../../../../../../../../../"
       + "nw:network-types/tet:te-topology/"
       + "optical-imp-topo:optical-impairment-topology" {
          description "Augment Optical TE label";
    }
*/
    description "optical label.";
    case optical-imp-topo {
      uses optical-label;
     uses optical-impairment-data;
    }
  }

  /* Augment label hop of underlay backup path of TE link template */
  augment "/nw:networks/tet:te/tet:templates/"
        + "tet:link-template/tet:te-link-attributes/"
        + "tet:underlay/tet:backup-path/tet:path-element/tet:type/"
        + "tet:label/tet:label-hop/tet:te-label/tet:technology" {
/*
    when "../../../../../../../../../"
       + "nw:network-types/tet:te-topology/"
       + "optical-imp-topo:optical-impairment-topology" {
      description "Augment Optical TE label";
    }
*/
    description "optical label.";
    case optical-imp-topo {
      uses optical-label;
     uses optical-impairment-data;
    }
  }

/*
  augment "/nw:networks/nw:network/nw:node/tet:te"
    + "/tet:te-node-attributes" {
    when "/nw:networks/nw:network/nw:network-types"
      +"/tet:te-topology/optical-imp-topo:optical-impairment-topology" {
      description
        "This augment is only valid for WSON.";

Lee, et al.               Expires April 2019                  [Page 17]
Internet-Draft   Optical Impairment-Aware YANG Model       October 2018

    }
    description "WSON Node augmentation.";
    uses wson-node-attributes;
  }
*/

  augment "/nw:networks/nw:network/nw:node/tet:te"
    + "/tet:tunnel-termination-point" {
    when "/nw:networks/nw:network/nw:network-types"
      +"/tet:te-topology/optical-imp-topo:optical-impairment-topology" {
      description
        "This augment is only valid for Impairment with non-sliceable
        transponder model";
    }
    description
      "Tunnel termination point
      augmentation for non-sliceable transponder model.";

        uses wson-ttp-attributes;

        leaf transponder-id {
          type uint32;
          description "transponder identifier";
        }
    uses transponder-attributes;
  }

  augment "/nw:networks/nw:network/nw:node/tet:te"
    + "/tet:tunnel-termination-point" {
    when "/nw:networks/nw:network/nw:network-types"
      +"/tet:te-topology/optical-imp-topo:optical-impairment-topology" {
      description
        "This augment is only valid for optical impairment with sliceable
        transponder model";
    }
    description
      "Tunnel termination point augmentation for sliceable transponder model.";
    uses sliceable-transponder-attributes;
  }
}
<CODE ENDS>

4. Security Considerations

   The configuration, state, and action data defined in this document
   are designed to be accessed via a management protocol with a secure
   transport layer, such as NETCONF [RFC6241].  The NETCONF access

Lee, et al.               Expires April 2019                  [Page 18]
Internet-Draft   Optical Impairment-Aware YANG Model       October 2018

   control model [RFC6536] provides the means to restrict access for
   particular NETCONF users to a preconfigured subset of all available
   NETCONF protocol operations and content.

   A number of configuration data nodes defined in this document are
   read-only; however, these data nodes may be considered sensitive or
   vulnerable in some network environments (TBD).

5. IANA Considerations

   This document registers the following namespace URIs in the IETF XML
   registry [RFC3688]:

   --------------------------------------------------------------------
   URI: urn:ietf:params:xml:ns:yang:ietf-optical-impairment-topology
   Registrant Contact: The IESG.
   XML: N/A, the requested URI is an XML namespace.
   --------------------------------------------------------------------

   This document registers the following YANG modules in the YANG
   Module Names registry [RFC7950]:

   --------------------------------------------------------------------
   name:      ietf-optical-impairment-topology
   namespace: urn:ietf:params:xml:ns:yang:ietf-optical-impairment-
   topology

   reference: RFC XXXX (TDB)
   --------------------------------------------------------------------

6. Acknowledgments

   We thank Dieter Bella and Sergio Belotti for useful discussions and
   motivation for this work.

Lee, et al.               Expires April 2019                  [Page 19]
Internet-Draft   Optical Impairment-Aware YANG Model       October 2018

7. References

   7.1. Normative References

   7.2. Informative References

   [RFC6241] Enns, R., Ed., Bjorklund, M., Ed., Schoenwaelder, J., Ed.,
             and A. Bierman, Ed., "Network Configuration Protocol
             (NETCONF)", RFC 6241, June 2011.

   [RFC6566]  Y. Lee, G. Bernstein, D. Li, G. Martinelli, "A Framework
             for the Control of Wavelength Switched Optical Networks
             (WSONs) with Impairments", RFC 6566, March 2012.

   [RFC7446]  Y. Lee, G. Bernstein, D. Li, W. Imajuku, "Routing and
             Wavelength Assignment Information Model for Wavelength
             Switched Optical Networks", RFC 7446, Feburary 2015.

   [RFC7579]   G. Bernstein, Y. Lee, D. Li, W. Imajuku, "General
             Network Element Constraint Encoding for GMPLS Controlled
             Networks", RFC 7579, June 2015.

   [RFC7581]  G. Bernstein, Y. Lee, D. Li, W. Imajuku, "Routing and
             Wavelength Assignment Information Encoding for Wavelength
             Switched Optical Networks", RFC 7581, June 2015.

   [RFC7950] Bjorklund, M., Ed., "The YANG 1.1 Data Modeling Language",
             RFC 7950, August 2016.

   [RFC8341] Bierman, A. and M. Bjorklund, "Network Configuration
             Access Control Model", RFC 8341, March 2018.

   [RFC8342]  Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K.,
             and R. Wilton, "Network Management Datastore Architecture
             (NMDA)", RFC 8342, March 2018.

   [RFC8345]  A. Clemm, et al, "A YANG Data Model for Network
             Topologies", RFC 8345, March 2018.

   [TE-TOPO] X. Liu, et al., "YANG Data Model for TE Topologies", work
             in progress: draft-ietf-teas-yang-te-topo.

Lee, et al.               Expires April 2019                  [Page 20]
Internet-Draft   Optical Impairment-Aware YANG Model       October 2018

   [RFC8453] Ceccarelli, D. and Y. Lee, "Framework for Abstraction and
             Control of Traffic Engineered Networks", RFC 8453, August
             2018.

   [WSON-Topo] Y. Lee, Ed., "A Yang Data Model for WSON Optical
             Networks", draft-ietf-ccamp-wson-yang-13, work in
             progress.

8. Contributors

   Giovanni Martinelli
   Cisco
   Email: giomarti@cisco.com

   Jonas Martensson
   Acro

   Email: jonas.martensson@ri.se

   Gert Grammel
   Juniper

   Email: ggrammel@juniper.net

Authors' Addresses

   Young Lee
   Huawei Technologies
   5700 Tennyson Parkway, Suite 600
   Plano, TX 75024
   USA

   Phone: (469) 277-5838
   Email: leeyoung@huawei.com

   Haomian Zheng
   Huawei Technologies

   Email: zhenghaomian@huawei.com

   Nicola Sambo
   Scuola Superiore Sant'Anna

Lee, et al.               Expires April 2019                  [Page 21]
Internet-Draft   Optical Impairment-Aware YANG Model       October 2018

   Email: nicosambo@gmail.com

   Victor Lopez
   Telefonica

   Email: victor.lopezalvarez@telefonica.com

   G. Galimberti
   Cisco

   Email: ggalimbe@cisco.com

Lee, et al.               Expires April 2019                  [Page 22]