[Docs] [txt|pdf] [Tracker] [WG] [Email] [Nits]

Versions: 00 01 02 03

CCAMP Working Group                                     Y. Lee (Editor)
Internet Draft                                                 D. Dhody
Intended status: Standard Track                                  A. Guo
Expires: November 10, 2019                                       Huawei

                                                               V. Lopez
                                                             Telefonica

                                                                D. King
                                                        U. of Lancaster



                                                           May 10, 2019

                    A YANG Data Model for Layer 0 Types


                     draft-ietf-ccamp-layer0-types-00


Abstract

   This document defines a collection of common data types and
   groupings in YANG data modeling language.  These derived common
   types and groupings are intended to be imported by modules that
   model Layer 0 Traffic Engineering (TE) configuration and state
   capabilities such as Wavelength Switched Optical Networks (WSONs)
   and Spectrum Switched optical Networks (SSONs).

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 November 10, 2019.

Lee, et al.             Expires November 2019                  [Page 1]


Internet-Draft             WSON YANG Model                     May 2019


Copyright Notice



   Copyright (c) 2019 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. Requirements Language.....................................3
      1.2. Terminology...............................................3
      1.3. Prefixes in Data Node Names...............................3
   2. IETF-Layer0-Types YANG Module..................................7
   3. Security Considerations.......................................24
   4. IANA Considerations...........................................25
   5. References....................................................26
      5.1. Normative References.....................................26
      5.2. Informative References...................................26
   6. Contributors..................................................28
   Authors' Addresses...............................................28

1. Introduction

   YANG [RFC6020] and [RFC7950] is a data modeling language used to
   model configuration data, state data, Remote Procedure Calls, and
   notifications for network management protocols such as NETCONF
   [RFC6241].  The YANG language supports a small set of built-in data
   types and provides mechanisms to derive other types from the built-
   in types.

   This document introduces a collection of common data types derived
   from the built-in YANG data types.  The derived types and groupings
   are designed to be the common types applicable for modeling Traffic
   Engineering (TE) features for Layer 0 optical networks in model(s)
   defined outside of this document. Examples of Layer 0 optical


Lee, et al.             Expires November 2019                  [Page 2]


Internet-Draft             WSON YANG Model                     May 2019


   networks are Wavelength Switched Optical Networks (WSONs) [RFC6163]
   and Spectrum Switched optical Networks (SSONs) [RFC7698].

   [G.698.2] defines amplified multichannel Dense Wavelength Division
   Multiplexing (DWDM) applications with single channel optical
   interfaces.  The YANG data model defined in this document refers to
   the standard application mode defined in [G.698.2].

1.1. Requirements Language

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
   "OPTIONAL" in this document are to be interpreted as described in  BCP
   14 [RFC2119] [RFC8174] when, and only when, they appear in all
   capitals, as shown here.


1.2. Terminology

   Refer to [RFC7446] and [RFC7581] for the key terms used in this
   document.

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

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       |
      +-------------+-------------------------+-----------------+
      | layer0-type | ietf-layer0-types       | [RFCXXXX]       |
      +-------------+-------------------------+-----------------+

             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.

   YANG module "ietf-layer0-types" (defined in Section 3) references
   [RFC6163], [RFC7205], and [RFC7698].




Lee, et al.             Expires November 2019                  [Page 3]


Internet-Draft             WSON YANG Model                     May 2019


   3.  Overview

   This document defines one YANG module for common Layer 0 TE types:
   ietf-layer0-types for WSON and SSON specific types.

   3.1.  TE Types Module Contents

   The ietf-layer0-types module contains common Layer 0 TE types that
   are to be imported by layer 0 specific technology such as WSON and
   SSON.

   The ietf-layer0-types module contains the following YANG reusable
   types and groupings:


   Operational-mode:

      A type that represents operational-model type as defined in
      [G.698.2].

   Vendor-identifier:

      A type that represents vendor identifier as defined in [RFC7581].


   layer0-node-type:

      A base YANG identity for supported node type as defined in
      [RFC6163].

   wavelength-assignment:

      A base YANG identity for allocated wavelength assignment type as
      defined in [RFC6163].


   layer0-grid-type:

      A base YANG identity for the node type as defined in
      [RFC6163] & [RFC7698].

   term-type:

      A base YANG identity for the supported termination type as
      defined in [G.709].




Lee, et al.             Expires November 2019                  [Page 4]


Internet-Draft             WSON YANG Model                     May 2019


   layer0-bandwidth-type:

      A base YANG identity for the layer0 bandwidth type as
      defined in [G.709].


   dwdm-ch-spc-type:

      A base YANG identity for the DWDM channel spacing type as
      defined in [RFC6205].


   cwdm-ch-spc-type:

      A base YANG identity for the CWDM channel spacing type as
      defined in [RFC6205].


   FEC-type:

      A base YANG identity for the FEC type as defined in [G.709].


   wson-path-bandwidth:

      A YANG grouping that defines the WSON path bandwidth attributes
      as defined in [RFC6163].

   wson-link-bandwidth:

      A YANG grouping that defines WSON link bandwidth attributes as
      defined in [RFC6163].

   wson-link-label:

      A YANG grouping that defines the label for WSON links as defined
      In [RFC6205].

   wson-path-label:

      A YANG groupin that defines the label for WSON paths as defined
      In [RFC6205].

   layer0-label-restriction:

      A YANG grouping that defines the layer 0 label restriction
      applicable for both WSON and SSON and per priority level as


Lee, et al.             Expires November 2019                  [Page 5]


Internet-Draft             WSON YANG Model                     May 2019


      defined in [RFC3209].

   wson-label-step:

      A YANG grouping that defines label steps for WSON as defined in
      [TE-topo].

   flex-grid-node-attributes:

      A YANG grouping that defines Flex-grid node attrtibutes as
      defined in [RFC7698].

   flex-grid-path-bandwidth:

      A YANG grouping that defines flex-grid path bandwidth attributes
      as defined in [RFC7698].

   flex-grid-link-bandwidth:

      A YANG grouping that defines flex-grid link bandwidth attributes
      As defined in [RFC7698].

   flex-grid-link-label:

      A YANG grouping that defines flex-grid link label attributes as
      defined in [RFC7698].

   flex-grid-channel:

      A YANG grouping that defines flex-grid channel as defined in
      [RFC7698].

   flex-grid-path-label:

      A YANG grouping that defines flex-grid path label for both single
      channel and multiple carriers [RFC7698].

   flex-grid-label-restriction:

      A YANG grouping that defines flex-grid label restrictions and per
      priority level as defined in [RFC3209].

   flex-grid-label-step:

      A YANG grouping that defines flex-grid label steps as defined in
      [TE-topo].



Lee, et al.             Expires November 2019                  [Page 6]


Internet-Draft             WSON YANG Model                     May 2019



2. IETF-Layer0-Types YANG Module

<CODE BEGINS> file ietf-layer0-types@2019-05-09.yang

module ietf-layer0-types {
  namespace "urn:ietf:params:xml:ns:yang:ietf-layer0-types";
  prefix "layer0-types";

  organization
    "IETF CCAMP Working Group";
  contact
    "WG Web: <http://tools.ietf.org/wg/ccamp/>
     WG List: <mailto:ccamp@ietf.org>

     Editor: Aihua Guo
       <mailto:aihuaguo@huawei.com>

     Editor: Young Lee
       <mailto:leeyoung@huawei.com>

     Editor: Italo Busi
       <mailto:Italo.Busi@huawei.com>";

  description
    "This module defines Optical Layer 0 types. This module
     provides groupings that can be applicable to Layer 0
     Fixed Optical Networks (e.g., CWDM (Coarse Wavelength
     Division Multiplexing) and DWDM (Dense Wavelength Division
     Multiplexing)) and Flexi-grid 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 "2019-05-09" {
    description
      "Initial Version";
    reference


Lee, et al.             Expires November 2019                  [Page 7]


Internet-Draft             WSON YANG Model                     May 2019


      "RFC XXXX: A YANG Data Model for WSON (Wavelength Switched
       Optical Networks)";
  }

  typedef operational-mode {
    type string;
    description
      "Vendor-specific mode that guarantees interoperability.";
    reference "ITU-T G.698.2 (11/2018)";
  }

  typedef standard-mode {
    type string;
    description
      "ITU-T G.698.2 standard mode that guarantees interoperability.
       It must be an string with the following format:
       B-DScW-ytz(v) where all these attributes are conformant
       to the ITU-T recomendation";
    reference "ITU-T G.698.2 (11/2018)";
  }

  typedef vendor-identifier {
    type string;
    description
      "vendor identifier that uses vendor-specific mode";
    reference
      "RFC7581: Routing and Wavelength Assignment Information
       Encoding for Wavelength Switched Optical Networks";
  }

  typedef frequency-thz {
    type decimal64 {
      fraction-digits 5;
    }
    units THz;
    description
      "The DWDM frequency in THz, e.g., 193.12500";
    reference
      "RFC6205:Generalized Labels for Lambda-Switch-Capable (LSC)
       Label Switching Routers";
  }

  typedef frequency-ghz {
    type decimal64 {
      fraction-digits 5;


Lee, et al.             Expires November 2019                  [Page 8]


Internet-Draft             WSON YANG Model                     May 2019


    }
    units GHz;
    description
      "The DWDM frequency in GHz, e.g., 193125.00";
    reference
      "RFC6205: Generalized Labels for Lambda-Switch-Capable (LSC)
       Label Switching Routers";
  }

  identity layer0-node-type {
    description
      "layer0 node type.";
    reference
      "RFC6163: Framework for GMPLS and Path Computation Element
       (PCE) Control of Wavelength Switched Optical Networks
       (WSONs)";
  }

  identity flex-grid-node {
    base layer0-node-type;
    description
      "Flex Grid node";
  }

  identity wson-node-foadm {
    base layer0-node-type;
    description
      "Fixed OADM (Optical Add-Drop Multiplexer) node";
  }

  identity wson-node-roadm {
    base layer0-node-type;
    description
      "ROADM (Reconfigurable Optical Add-Drop Multiplexer)
       or OXC (Optical Cross Connect) node";
  }

  identity wson-node-ila {
    base layer0-node-type;
    description
      "ILA (In-Line Amplifier) node";
  }

  identity wavelength-assignment {
    description


Lee, et al.             Expires November 2019                  [Page 9]


Internet-Draft             WSON YANG Model                     May 2019


      "Wavelength selection base";
    reference
      "RFC6163: Framework for GMPLS and Path Computation Element
      (PCE) Control of Wavelength Switched Optical Networks
      (WSONs)";
  }

  identity unspecified-wavelength-assignment {
    base wavelength-assignment;
    description
      "No method specified";
  }

  identity first-fit-wavelength-asignment {
    base wavelength-assignment;
    description
      "All the available wavelengths are numbered,
       and this WA (Wavelength Assignment) method chooses
       the available wavelength with the lowest index";
  }

  identity random-wavelength-asignment {
    base wavelength-assignment;
    description
      "This WA method chooses an available
       wavelength randomly";
  }

  identity least-loaded-wavelength-asignment {
    base wavelength-assignment;
    description
      "This WA method selects the wavelength that
       has the largest residual capacity on the most loaded
       link along the route (in multi-fiber networks)";
  }

  identity layer0-grid-type {
    description
      "Layer0 grid type.";
    reference
      "RFC7698: Framework and Requirements for GMPLS-Based Control
       of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM)
       Networks &
       RFC6163: Framework for GMPLS and Path Computation Element
       (PCE) Control of Wavelength Switched Optical Networks


Lee, et al.             Expires November 2019                 [Page 10]


Internet-Draft             WSON YANG Model                     May 2019


      (WSONs)";
  }

  identity flex-grid-dwdm {
    base layer0-grid-type;
    description
      "Flex grid";
  }

  identity wson-grid-dwdm {
    base layer0-grid-type;
    description
      "DWDM grid";
  }

  identity wson-grid-cwdm {
    base layer0-grid-type;
    description
      "CWDM grid";
  }

  identity term-type {
    description
      "Termination type.";
  }

  identity term-phys {
    base term-type;
    description
      "Physical Layer Termination";
    reference
      "G.709: Interfaces for the Optical Transport Network (OTN)";
  }

  identity term-otu {
    base term-type;
    description
      "OTU (Optical Transport Unit) Termination";
  }

  identity term-odu {
    base term-type;
    description
      "ODU (Optical Data Unit) Termination";
  }


Lee, et al.             Expires November 2019                 [Page 11]


Internet-Draft             WSON YANG Model                     May 2019



  identity term-opu {
    base term-type;
    description
      "OPU (Optical Payload Unit) Termination";
  }

  identity term-section {
    base term-type;
    description
      "Section Layer Termination";
  }

  identity layer0-bandwidth-type {
    description
      "Bandwidth type carried by a single wavelength channel";
    reference
     "G.709: Interfaces for the Optical Transport Network (OTN)";
  }

  identity bw-otu1 {
    base layer0-bandwidth-type;
    description
      "OTU1 (2.66G)";
  }

  identity bw-otu1e {
    base layer0-bandwidth-type;
    description
      "OTU1e (11.04G)";
  }

  identity bw-otu1f {
    base layer0-bandwidth-type;
    description
      "OTU1f (11.27G)";
  }

  identity bw-otu2 {
    base layer0-bandwidth-type;
    description
      "OTU2 (10.70G)";
  }

  identity bw-otu2e {


Lee, et al.             Expires November 2019                 [Page 12]


Internet-Draft             WSON YANG Model                     May 2019


    base layer0-bandwidth-type;
    description
      "OTU2e (11.09G)";
  }

  identity bw-otu2f {
    base layer0-bandwidth-type;
    description
      "OTU2f (11.31G)";
  }

  identity bw-otu3 {
    base layer0-bandwidth-type;
    description
      "OTU3 (43.01G)";
  }

  identity bw-otu3e1 {
    base layer0-bandwidth-type;
    description
      "OTU3e1 (44.57G)";
  }

  identity bw-otu3e2 {
    base layer0-bandwidth-type;
    description
      "OTU3e2 (44.58G)";
  }

  identity bw-otu4 {
    base layer0-bandwidth-type;
    description
      "OTU4 (111.80G)";
  }

  identity bw-otucn {
    base layer0-bandwidth-type;
    description
      "OTUCn (beyond 100G)";
  }

  identity dwdm-ch-spc-type {
    description
      "DWDM channel spacing type";
    reference


Lee, et al.             Expires November 2019                 [Page 13]


Internet-Draft             WSON YANG Model                     May 2019


      "RFC6205: Generalized Labels for Lambda-Switch-Capable (LSC)
      Label Switching Routers";
  }

  identity dwdm-100ghz {
    base dwdm-ch-spc-type;
    description
      "100GHz channel spacing";
  }

  identity dwdm-50ghz {
    base dwdm-ch-spc-type;
    description
      "50GHz channel spacing";
  }

  identity dwdm-25ghz {
    base dwdm-ch-spc-type;
    description
      "25GHz channel spacing";
  }

  identity dwdm-12p5ghz {
    base dwdm-ch-spc-type;
    description
      "12.5GHz channel spacing";
  }

  identity  flex-ch-spc-type {
    description
      "Flex-grid channel spacing type";
    reference
      "RFC7581: Routing and Wavelength Assignment Information
       Encoding for Wavelength Switched Optical Networks";
  }

  identity flex-ch-spc-6p25ghz {
    base flex-ch-spc-type;
    description
      "6.25GHz channel spacing";
  }

  identity  flex-slot-width-granularity {
    description
      "Flex-grid slot width granularity";


Lee, et al.             Expires November 2019                 [Page 14]


Internet-Draft             WSON YANG Model                     May 2019


    reference
      "RFC7581: Routing and Wavelength Assignment Information
       Encoding for Wavelength Switched Optical Networks";
  }

  identity flex-swg-12p5ghz {
    base flex-slot-width-granularity;
    description
      "12.5GHz slot width granularity";
  }

  identity cwdm-ch-spc-type {
    description
      "CWDM channel spacing type";
    reference
      "RFC6205: Generalized Labels for Lambda-Switch-Capable (LSC)
       Label Switching Routers";
  }

  identity cwdm-20nm {
    base cwdm-ch-spc-type;
    description
      "20nm channel spacing";
  }

  identity fec-type {
    description
      "FEC (Forward Error Correction) type";
    reference
      "G.709: Interfaces for the Optical Transport Network (OTN)";
  }

  identity g-fec {
    base fec-type;
    description
      "G-FEC (Generic-FEC)";
  }
  identity e-fec {
    base fec-type;
    description
      "E-FEC (Enhanced-FEC)";
  }
  identity no-fec {
    base fec-type;
    description


Lee, et al.             Expires November 2019                 [Page 15]


Internet-Draft             WSON YANG Model                     May 2019


      "No FEC";
  }

  /* Groupings. */
  grouping wson-path-bandwidth {
    description "WSON (Wavelength Switched Optical Network)
                 path bandwidth attributes";
    reference
      "RFC6163";
    leaf bandwidth-type {
      type identityref {
        base layer0-bandwidth-type;
      }
      description "WSON bandwidth type";
    }
  }

  grouping wson-link-bandwidth {
    description "WSON link bandwidth attributes";
    reference
      "RFC6163";
    leaf-list supported-bandwidth-list {
      type identityref {
        base layer0-bandwidth-type;
      }
      description "WSON bandwidth type";
    }
  }

  grouping wson-link-label {
    description
      "Generic label for WSON links";
    reference
      "RFC6205";
    choice grid-type {
      description
        "Label for DWDM or CWDM grid";
      case dwdm {
        leaf dwdm-n {
          type int16;
          description
           "N is used to determine the Nominal Central Frequency.
             The set of nominal central frequencies can be
             built using the following expression
             f = 193.1 THz + N x 0.00625 THz,


Lee, et al.             Expires November 2019                 [Page 16]


Internet-Draft             WSON YANG Model                     May 2019


             where 193.1 THz is ITU-T 'anchor frequency'
             for transmission over the C band, N is a positive or
             negative integer including 0.";
          reference
            "RFC6205:Generalized Labels for Lambda-Switch-Capable
             (LSC) Label Switching Routers";
        }
      }
      case cwdm {
        leaf cwdm-n {
          type int16;
          description
            "N is a two's-complement integer to take either a
            positive, negative, or zero value. This value is
            used to compute the channel wavelength as such
            in G.694.2:
            Wavelength (nm) = 1471 nm + N * 20 nm";
          reference
            "RFC6205:Generalized Labels for Lambda-Switch-Capable
             (LSC) Label Switching Routers";

        }
      }
    }
  }

  grouping wson-path-label {
    description
      "Generic label for WSON paths";
    reference
      "RFC6205";
    choice grid-type {
      description
        "Label for DWDM or CWDM grid";
      case dwdm {
        choice single-or-super-channel {
          description "single or super channel";
          case single {
            leaf dwdm-n {
              type int16;
              description
               "N is used to determine the Nominal Central Frequency.
                The set of nominal central frequencies can be
                built using the following expression
                 f = 193.1 THz + N x 0.00625 THz,


Lee, et al.             Expires November 2019                 [Page 17]


Internet-Draft             WSON YANG Model                     May 2019


                where 193.1 THz is ITU-T 'anchor frequency'
                for transmission over the C band, N is a positive or
                negative integer including 0.";
             }
          }
          case super {
           leaf-list subcarrier-dwdm-n {
              type int16;
              description
                "List of subcarrier channels for super channel.
             Each of the channels is represented by an
             integer, n, a two's-complement integer to take
             either a positive, negative, or zero value.
             This value is used to compute the frequency as
             such in G.694.1:
             Frequency (THz) =
               193.1 THz + n * channel spacing (THz)";
           }
          }
        }

      }
      case cwdm {
        leaf cwdm-n {
          type int16;
          description
            "Represented by an integer, n, a two's-complement
          integer to take either a positive, negative, or
          zero value. This value is used to compute the
          channel wavelength as such in G.694.2:
          Wavelength (nm) = 1471 nm + n * 20 nm";
          reference
            "RFC6205:Generalized Labels for Lambda-Switch-Capable
            (LSC) Label Switching Routers";

        }
      }
    }
  }

  grouping layer0-label-restriction {
    description
      "layer0 label restriction.";
    reference
      "RFC3209";


Lee, et al.             Expires November 2019                 [Page 18]


Internet-Draft             WSON YANG Model                     May 2019



    leaf grid-type {
      type identityref {
        base layer0-grid-type;
      }
      description "Grid type";
    }
    leaf priority {
      type uint8;
      description "priority";
    }
  }

  grouping wson-label-step {
    description "Label step information for WSON";
    reference
      "draft-ietf-teas-yang-te-topo-20";
    choice layer0-grid-type {
      description
        "Grid type: DWDM, CWDM, etc.";
      case dwdm {
        leaf wson-dwdm {
          type identityref {
            base dwdm-ch-spc-type;
          }
          description
            "Label-step is the channel-spacing (GHz), e.g.,
             100, 50, 25, or 12.5 GHz for DWDM";
          reference
            "RFC6205:Generalized Labels for Lambda-Switch-Capable
            (LSC) Label Switching Routers";

        }
      }
      case cwdm {
        leaf wson-cwdm {
          type identityref {
            base cwdm-ch-spc-type;
          }
          description
            "label-step is the channel-spacing (nm), i.e., 20 nm
             for CWDM, which is the only value defined for CWDM";
          reference
            "RFC6205:Generalized Labels for Lambda-Switch-Capable
            (LSC) Label Switching Routers";


Lee, et al.             Expires November 2019                 [Page 19]


Internet-Draft             WSON YANG Model                     May 2019


        }
      }
    }
  }

  grouping flex-grid-node-attributes {
    description "Flex-grid node attributes";
    reference
      "RFC7698";
    container flex-grid-node {
      description "Flex-grid node attrtibutes";
      leaf node-type {
        type identityref {
          base layer0-node-type;
        }
        description "Flex-grid node type";
      }
    }
  }

  grouping flex-grid-path-bandwidth {
    description "Flex-grid path bandwidth attributes";
    reference
      "RFC7698";
    leaf bandwidth-type {
      type identityref {
        base layer0-bandwidth-type;
      }
      description "Flex-grid bandwidth type";
    }
  }

  grouping flex-grid-link-bandwidth {
    description "flex-grid link bandwidth attributes";
    reference
      "RFC7698";
    leaf-list supported-bandwidth-list {
      type identityref {
        base layer0-bandwidth-type;
      }
      description "Flex-grid bandwidth type";
    }
  }

  grouping flex-grid-link-label {


Lee, et al.             Expires November 2019                 [Page 20]


Internet-Draft             WSON YANG Model                     May 2019


    description "Flex-grid link label.";
    reference
      "RFC7698";
    leaf flex-n {
      type uint16;
      description
        "N is used to determine the Nominal Central Frequency.
         The set of nominal central frequencies can be
         built using the following expression
          f = 193.1 THz + N x 0.00625 THz,
         where 193.1 THz is ITU-T 'anchor frequency'
         for transmission over the C band, N is a positive or
         negative integer including 0.";
      reference
        "RFC7698: Framework and Requirements for GMPLS-Based
         Control of Flexi-Grid Dense Wavelength Division Multiplexing
         (DWDM) Networks";
    }
  }

  grouping flex-grid-channel {
    description "Flex-grid channel grouping.";
    reference
      "RFC7698";
    uses flex-grid-link-label;

    leaf flex-m {
      type uint16 {
       range "1..max";
     }
      description
        "M is used to determine the slot width. A slot width is
         constrained to be M x SWG (that is, M x 12.5 GHz),
         where M is an integer greater than or equal to 1.";
      reference
        "RFC7698: Framework and Requirements for GMPLS-Based
         Control of Flexi-Grid Dense Wavelength Division Multiplexing
         (DWDM) Networks";
    }
  }
  grouping flex-grid-path-label {
    description "Flex-grid path label.";
    reference
      "RFC7698";
      choice single-or-super-channel {


Lee, et al.             Expires November 2019                 [Page 21]


Internet-Draft             WSON YANG Model                     May 2019


       description "single of super channel";
        case single {
          uses flex-grid-channel;
       }
        case super {
         list subcarrier-flex-n {
         key flex-n;
         uses flex-grid-channel;
         description
            "List of subcarrier channels for flex-grid
             super channel.";
          }
        }
      }
  }

  grouping flex-grid-label-restriction {
    description
      "Flex Grid-specific label restriction";
    reference
      "RFC7698 & RFC3209";
    uses layer0-label-restriction;

    container flex-grid {
      description "flex-grid definition";
      leaf nominal-central-frequency-granularity {
        type identityref {
          base flex-ch-spc-type;
        }
        default flex-ch-spc-6p25ghz;
        description
          "It is the spacing between allowed nominal central
           frequencies. Default is 6.25 GHz";
        reference
          "RFC7698: Framework and Requirements for GMPLS-Based
           Control of Flexi-Grid Dense Wavelength Division Multiplexing
           (DWDM) Networks";

      }

      leaf slot-width-granularity {
        type identityref {
          base flex-slot-width-granularity;
        }
        default flex-swg-12p5ghz;


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


Internet-Draft             WSON YANG Model                     May 2019


        description
          "Minimum space between slot widths. Default is
          12.5 GHz";
        reference
          "RFC7698: Framework and Requirements for GMPLS-Based
           Control of Flexi-Grid Dense Wavelength Division Multiplexing
           (DWDM) Networks";

      }

      leaf min-slot-width-factor {
        type uint16 {
          range "1..max";
        }
        default 1;
        description
          "Minimum slot width is calculated by:
           Minimum slot width (GHz) =
            min-slot-width-factor * slot-width-granularity";
        reference
          "RFC8363: GMPLS OSPF-TE Extensions in Support of Flexi-Grid
           Dense Wavelength Division Multiplexing (DWDM) Networks";

      }

      leaf max-slot-width-factor {
        type uint16 {
          range "1..max";
        }
        description
          "Maximum slot width is calculated by:
           Maximum slot width (GHz) =
            max-slot-width-factor * slot-width-granularity";
        reference
          "RFC8363: GMPLS OSPF-TE Extensions in Support of Flexi-Grid
           Dense Wavelength Division Multiplexing (DWDM) Networks";
      }

    }
  }

  grouping flex-grid-label-step {
    description "Label step information for flex grid";
    reference
      "draft-ietf-teas-yang-te-topo-20";


Lee, et al.             Expires November 2019                 [Page 23]


Internet-Draft             WSON YANG Model                     May 2019


    leaf flex {
      type identityref {
        base flex-ch-spc-type;
      }
     default flex-ch-spc-6p25ghz;
      description
        "Label-step is the nominal central frequency
         granularity (GHz), e.g., 6.25 GHz";
      reference
        "RFC7698: Framework and Requirements for GMPLS-Based
         Control of Flexi-Grid Dense Wavelength Division Multiplexing
         (DWDM) Networks";
    }
  }
}
<CODE ENDS>



3. Security Considerations

   The YANG module specified in this document defines a schema for data
   that is designed to be accessed via network management protocols
   such as NETCONF [RFC6241] or RESTCONF [RFC8040]. The lowest NETCONF
   layer is the secure transport layer, and the mandatory-to-implement
   secure transport is Secure Shell (SSH) [RFC6242]. The lowest
   RESTCONF layer is HTTPS, and the mandatory-to-implement secure
   transport is TLS [RFC8446].

   The NETCONF access 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. The
   NETCONF Protocol over Secure Shell (SSH) [RFC6242] describes a
   method for invoking and running NETCONF within a Secure Shell (SSH)
   session as an SSH subsystem. The Network Configuration Access
   Control Model (NACM) [RFC8341] provides the means to restrict access
   for particular NETCONF or RESTCONF users to a preconfigured subset
   of all available NETCONF or RESTCONF protocol operations and
   content.

   The YANG module in this document defines optical layer0 type
   definitions (i.e., typedef, identity and grouping statements) in
   YANG data modeling language to be imported and used by other layer 0
   specific modules.  When imported and used, the resultant schema will
   have data nodes that can be writable, or readable.  The access to
   such data nodes may be onsidered sensitive or vulnerable in some


Lee, et al.             Expires November 2019                 [Page 24]


Internet-Draft             WSON YANG Model                     May 2019


   network environments. Write operations (e.g., edit-config) to these
   data nodes without proper protection can have a negative effect on
   network operations.

   The security considerations spelled out in the YANG 1.1
   specification [RFC7950] apply for this document as well.



4. IANA Considerations

   This document registers the following namespace URIs in the IETF XML
   registry [RFC3688]. Following the format in [RFC3688], registration
   is requested to be made as follows:

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


   This document registers the following YANG module in the YANG Module
   Names registry [RFC7950] & [RFC6020]:

   --------------------------------------------------------------------
      name:         ietf-layer0-types
      namespace:    urn:ietf:params:xml:ns:yang: ietf-layer0-types
      prefix:       layer0-types
      reference:    RFC XXXX (TDB)
   --------------------------------------------------------------------
















Lee, et al.             Expires November 2019                 [Page 25]


Internet-Draft             WSON YANG Model                     May 2019




5. References

   5.1. Normative References

   [RFC6020] Bjorklund, M., Ed., "YANG - A Data Modeling Language for
             the Network Configuration Protocol (NETCONF)", RFC 6020,
             October 2010.

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

   [RFC6242] M. Wasserman, "Using the NETCONF Protocol over Secure
             Shell (SSH)", RFC 6242, June 2011.

   [RFC6536] A. Bierman, M. Bjorklund, "Network Configuration Protocol
             (NETCONF) Access Control Model", RFC 6536, March 2012.

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

   [RFC8040] A. Bierman, M. Bjorklund, K. Watsen, "RESTCONF Protocol",
             RFC 8040, January 2017.

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

   [RFC8446] E. Rescorla, "The Transport Layer Security (TLS) Protocol
             Version 1.3", RFC8446, August 2018.



   5.2. Informative References

   [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
             Requirement Levels", BCP 14, RFC 2119, DOI
             10.17487/RFC2119, March 1997, <https://www.rfc-
             editor.org/info/rfc2119>.

   [RFC3209] D. Awduche, L. Berger, D. Gan, T. Li, V. Srinivasan, and
             G. Swallow, "RSVP-TE: Extensions to RSVP for LSP Tunnels",
             RFC 3209, December 2001.





Lee, et al.             Expires November 2019                 [Page 26]


Internet-Draft             WSON YANG Model                     May 2019


   [RFC3688] M. Mealling, "The IETF XML Registry", RFC 3688, January
             2004.

   [RFC6163] Y. Lee, Ed. G. Berstein, Ed., W. Imajuku, "Framework for
             GMPLS and Path Computation Element (PCE) Control of
             Wavelength Switched Optical Networks (WSONs)", RFC 6163,
             April 2011.

   [RFC6205] T. Otani, Ed., D. Li, Ed., "Generalized Labels for Lambda-
             Switch-Capable (LSC) Label Switching Routers", RFC 6205,
             March 2011.

   [RFC7205] A. Romanow, S. Botzko, M. Duckworth, R. Even, Ed.,"Use
             Cases for Telepresence Multistreams", RFC 7205, April
             2014.

   [RFC7446] Y. Lee, G. Bernstein, D. Li, W. Imajuku, "Routing and
             Wavelength Assignment Information Model for Wavelength
             Switched Optical Networks", RFC 7446, Feburary 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.

   [RFC7698] O. Gonzalez de Dios, Ed., R. Casellas, Ed., "Framework and
             Requirements for GMPLS-Based Control of Flexi-Grid Dense
             Wavelength Division Multiplexing (DWDM) Networks", RFC
             7698, November 2015.

   [RFC8174] B. Leiba, "Ambiguity of Uppercase vs Lowercase in RFC 2119
             Key Words", RFC 8174, May 2017.

   [RFC8363] X. Zhang, H. Zheng, R. Casellas, O. Gonzalez de Dios, D.
             Ceccarelli, "GMPLS OSPF-TE Extensions in Support of Flexi-
             Grid Dense Wavelength Division Multiplexing (DWDM)
             Networks", RFC 8363, May 2018.

   [G.698.2] "Amplified multichannel dense wavelength division
             multiplexing applications with single channel optical
             interfaces", ITU-T G.698.2, November, 2018.

   [G.709]  "Interfaces for the Optical Transport Network (OTN)", ITU-T
             G.709, June 2016.






Lee, et al.             Expires November 2019                 [Page 27]


Internet-Draft             WSON YANG Model                     May 2019


   [TE-topo] Xufeng Liu, Igor Bryskin, Vishnu Pavan Beeram, Tarek Saad,
             Himanshu Shah, Oscar Gonzalez De Dios, "YANG Data Model
             for Traffic Engineering (TE) Topologies", draft-ietf-teas-
             yang-te-topo, work in progress.



6. Contributors


Authors' Addresses

   Young Lee (ed.)
   Huawei Technologies
   5700 Tennyson Parkway, Suite 600
   Plano, TX 75024
   USA
   Email: leeyoung@huawei.com


   Dhruv Dhody
   Huawei Technologies
   Divyashree Techno Park, Whitefield
   Bangalore, Karnataka  560066
   India
   EMail: dhruv.ietf@gmail.com

   Aihua Guo
   Huawei Technologies
   Email: aihuaguo@huawei.com

   Victor Lopez
   Telefonica
   Email: victor.lopezalvarez@telefonica.com

   Daniel King
   University of Lancaster
   Email: d.king@lancaster.ac.uk

   Bin Yeong Yoon
   ETRI
   218 Gaijeongro, Yuseong-gu
   Daejeon, Korea



Lee, et al.             Expires November 2019                 [Page 28]


Internet-Draft             WSON YANG Model                     May 2019


   Email: byyun@etri.re.kr

   Ricard Vilalta
   CTTC
   Email: ricard.vilalta@cttc.es

   Italo Busi
   Huawei
   Email: Italo.Busi@huawei.com







































Lee, et al.             Expires November 2019                 [Page 29]


Html markup produced by rfcmarkup 1.129d, available from https://tools.ietf.org/tools/rfcmarkup/