CCAMP Working Group                                     Y. Lee (Editor)
                                                               D. Dhody
                                                               X. Zhang
Internet Draft                                                   Huawei
Intended status: Standard Track                                  A. Guo
                                                                   ADVA
                                                               V. Lopez
                                                             Telefonica
                                                                D. King
                                                        U. of Lancaster
                                                                B. Yoon
                                                                   ETRI

Expires: September 15, 2016                              March 21, 2016

                A Yang Data Model for WSON Optical Networks


                     draft-ietf-ccamp-wson-yang-00.txt


Abstract

   This document provides a YANG data model for the routing and
   wavelength assignment (RWA) TE topology in wavelength switched
   optical networks (WSONs).



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 June 21, 2016.

Copyright Notice
Lee, et al.             Expires September 2016                 [Page 1]


Internet-Draft             WSON YANG Model                   March 2016




   Copyright (c) 2015 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
   2. Routing and Wavelength Assignment Informational Model..........3
      2.1. Connectivity Matrix Model.................................3
      2.2. Resource Pool Model.......................................4
      2.3. Port Label Restriction Model..............................8
      2.4. Wavelength Availability on Links..........................9
   3. YANG Model (Tree Structure)...................................10
   4. WSON-RWA YANG Model...........................................11
   5. Security Considerations.......................................17
   6. IANA Considerations...........................................17
   7. Acknowledgments...............................................17
   8. References....................................................18
      8.1. Normative References.....................................18
      8.2. Informative References...................................18
   9. Contributors..................................................18
   Authors' Addresses...............................................18

1. Introduction

   This document provides a YANG data model for the routing and
   wavelength assignment (RWA) Traffic Engineering (TE) topology in
   wavelength switched optical networks (WSONs). The YANG model
   described in this document is a WSON 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]. This document augments the
   generic TE topology draft [TE-TOPO].


Lee, et al.             Expires September 2016                 [Page 2]


Internet-Draft             WSON YANG Model                   March 2016


   What is not in scope of this document is both impairment-aware WSON
   and flex-grid.


2. Routing and Wavelength Assignment Informational Model

   The relevant information model in this document comprises

     - Connectivity Matrix Model (Section 2.1)
     - Resource Pool Model (Section 2.2)
     - Port Wavelength Restriction (Section 2.3)
     - Wavelength Availability on Links (Section 2.4)

   [Editor's Note: This version covers the corresponding YANG data
   model for the first two sections (Sections 2.1 and 2.2) and leaves
   the YANG model for Sections 2.3 and 2.4 in the later version.]

   Sections 2.1 - 2.4 rehashes key information models from [RWA-Info]
   to facilitate the development of the YANG model (Section 3).

2.1. Connectivity Matrix Model

   The connectivity matrix (ConnectivityMatrix) represents either the
   potential connectivity matrix for asymmetric switches (e.g. ROADMs
   and such) or fixed connectivity for an asymmetric device such as a
   multiplexer.

   Note that multiple connectivity matrices are allowed and the Node_ID
   would be an appropriate identifier for the node to point the
   Connectivity matrix within the WSON RWA context.

   <Node_Information> ::= <Node_ID> [<ConnectivityMatrix>...]

   <ConnectivityMatrix> ::= <MatrixID>

                            <ConnType>

                            <Matrix>

   Where

   <MatrixID> is a unique identifier for the matrix.

   <ConnType> can be either 0 or 1 depending upon whether the
   connectivity is either fixed or switched.




Lee, et al.             Expires September 2016                 [Page 3]


Internet-Draft             WSON YANG Model                   March 2016


   <Matrix> represents the fixed or switched connectivity in that
   Matrix(i, j) = 0 or 1 depending on whether input port i can connect
   to output port j for one or more wavelengths.



2.2. Resource Pool Model

   A WSON node may include regenerators or wavelength converters
   arranged in a shared pool. As discussed in [RFC6163] this can
   include Optical-Electronic-Optical (OEO) based Wavelength Division
   Multiplexing (WDM) switches as well. There are a number of different
   approaches used in the design of WDM switches containing regenerator
   or converter pools. However, from the point of view of path
   computation the following need to be known:

   1. The nodes that support regeneration or wavelength conversion.

   2. The accessibility and availability of a wavelength converter to
      convert from a given input wavelength on a particular input port
      to a desired output wavelength on a particular output port.

   3. Limitations on the types of signals that can be converted and the
      conversions that can be performed.



   The following Figures show resource pool architecture of WSON.





















Lee, et al.             Expires September 2016                 [Page 4]


Internet-Draft             WSON YANG Model                   March 2016



      I1   +-------------+                       +-------------+ O1
     ----->|             |      +--------+       |             |----->
      I2   |             +------+ Rb #1  +-------+             | O2
     ----->|             |      +--------+       |             |----->
           |             |                       |             |
           | Resource    |      +--------+       |  Resource   |
           | Pool        +------+        +-------+  Pool       |
           |             |      + Rb #2  +       |             |
           | Input       +------+        +-------|  Output     |
           | Connection  |      +--------+       |  Connection |
           | Matrix      |           .           |  Matrix     |
           |             |           .           |             |
           |             |           .           |             |
      IN   |             |      +--------+       |             | OM
     ----->|             +------+ Rb #P  +-------+             |----->
           |             |      +--------+       |             |
           +-------------+   ^               ^   +-------------+
                             |               |
                             |               |
                             |               |
                             |               |

                    Input wavelength      Output wavelength
                    constraints for       constraints for
                    each resource         each resource

   Note: Rb is a Resource Block.


            Figure 1 Schematic diagram of resource pool model.



   Since resources tend to be packaged together in blocks of similar
   devices, e.g., on line cards or other types of modules, the
   fundamental unit of identifiable resource in this document is the
   "resource block". A resource block may contain one or more
   resources. A resource is the smallest identifiable unit of
   processing allocation. One can group together resources into blocks
   if they have similar characteristics relevant to the optical system
   being modeled, e.g., processing properties, accessibility, etc.

   This leads to the following formal high level model:

   <Node_Information> ::= <Node_ID>



Lee, et al.             Expires September 2016                 [Page 5]


Internet-Draft             WSON YANG Model                   March 2016


                          [<ConnectivityMatrix>...]

                          [<ResourcePool>]

   Where

   <ResourcePool> ::= <ResourceBlockInfo>...

                     [<ResourceAccessibility>...]

                     [<ResourceWaveConstraints>...]

                     [<RBPoolState>]




   <ResourceAccessibility> ::= <PoolInputMatrix>

                               <PoolOutputMatrix>



   <ResourceWaveConstraints> ::= <InputWaveConstraints>

                                 <OutputOutputWaveConstraints>



   <RBSharedAccessWaveAvailability> ::= [<InAvailableWavelengths>]

                                        [<OutAvailableWavelengths>]



   <RBPoolState> ::=    <ResourceBlockID>

                        <NumResourcesInUse>

                        [<RBSharedAccessWaveAvailability>]

                        [<RBPoolState>]



   <ResourceBlockInfo> ::= <ResourceBlockSet>



Lee, et al.             Expires September 2016                 [Page 6]


Internet-Draft             WSON YANG Model                   March 2016


                           [<InputConstraints>]

                           [<ProcessingCapabilities>]

                           [<OutputConstraints>]

   Where  <ResourceBlockSet> is a list of resource block identifiers
   with the same characteristics. If this set is missing the
   constraints are applied to the entire network element.

   <InputConstraints> ::= <SharedInput>

                          [<OpticalInterfaceClassList>]

                          [<ClientSignalList>]

   <ProcessingCapabilities> ::= [<NumResources>]

                                [<RegenerationCapabilities>]

                                [<FaultPerfMon>]

                                [<VendorSpecific>]

   <OutputConstraints> := <SharedOutput>

                          [<OpticalInterfaceClassList>]

                          [<ClientSignalList>]

   <OpticalInterfaceClassList> ::= <OpticalInterfaceClass> ...



   <ClientSignalList>::=[<G-PID>]...

        1. Number of Resources within the block

        2. Regeneration capability

        3. Fault and performance monitoring

        4. Vendor Specific capability

     Note that the code points for Fault and performance monitoring and
     vendor specific capability are subject to further study.



Lee, et al.             Expires September 2016                 [Page 7]


Internet-Draft             WSON YANG Model                   March 2016




2.3. Port Label Restriction Model

   <LinkInfo> ::=  <LinkID>

                   [<AdministrativeGroup>]

                   [<InterfaceCapDesc>]

                   [<Protection>]

                   [<SRLG>...]

                   [<TrafficEngineeringMetric>]

                   [<PortLabelRestriction>...]

   Note that these additional link characteristics only applies to line
   side ports of WDM system or add/drop ports pertaining to Resource
   Pool (e.g., Regenerator or Wavelength Converter Pool). The
   advertisement of input/output tributary ports is not intended here.


   <PortLabelRestriction> ::= <MatrixID>

                              <Restriction parameters list>


   <Restriction parameters list> ::=

                              <LabelSet> ...


   Where

   MatrixID is the ID of the corresponding connectivity matrix.

     LabelSet is a conceptual set of labels (wavelengths).

     MaxNumChannels is the maximum number of channels that can be
     simultaneously used (relative to either a port or a matrix).

     LinkSet is a conceptual set of ports.




Lee, et al.             Expires September 2016                 [Page 8]


Internet-Draft             WSON YANG Model                   March 2016


2.4. Wavelength Availability on Links

   In the previously presented information model there are a limited
   number of information elements that are dynamic, i.e., subject to
   change with subsequent establishment and teardown of connections.
   Depending on the protocol used to convey this overall information
   model it may be possible to send this dynamic information separate
   from the relatively larger amount of static information needed to
   characterize WSON's and their network elements.

   <DynamicLinkInfo> ::=  <LinkID>

                          <AvailableLabels>

                          [<SharedBackupLabels>]

   AvailableLabels is a set of labels (wavelengths) currently available
   on the link. Given this information and the port wavelength
   restrictions one can also determine which wavelengths are currently
   in use. This parameter could potential be used with other
   technologies that GMPLS currently covers or may cover in the future.

   SharedBackupLabels is a set of labels (wavelengths) currently used
   for shared backup protection on the link. An example usage of this
   information in a WSON setting is given in [Shared]. This parameter
   could potential be used with other technologies that GMPLS currently
   covers or may cover in the future.






















Lee, et al.             Expires September 2016                 [Page 9]


Internet-Draft             WSON YANG Model                   March 2016


3. YANG Model (Tree Structure)

   (Editor's Note: This version is based on the augmentation of draft-
   ietf-teas-yang-te-topo [TE-TOPO].)



   module: ietf-wson-topology
   augment /tet:te-topologies/tet:topology/tet:topology-types/tet:te-
   topology:
       +--rw wson-topology
   augment /tet:te-topologies/tet:topology/tet:node/tet:te-node-
   attributes/tet:connectivity-matrix:
       +--rw wson-matrix
          +--rw device-type?        devicetype
          +--rw dir?                directionality
          +--rw matrix-interface* [in-port-id]
             +--rw in-port-id     wson-interface-ref
             +--rw out-port-id?   wson-interface-ref
   augment /tet:te-topologies/tet:topology/tet:node/tet:te-node-
   attributes/tet:te-link:
       +--rw wavelength-available-bitmap*   boolean
   augment /tet:te-topologies/tet:topology/tet:node:
       +--rw resource-pool* [resource-pool-id]
          +--rw resource-pool-id    uint32
          +--rw pool-state?         boolean
          +--rw matrix-interface* [in-port-id]
             +--rw in-port-id     wson-interface-ref
             +--rw out-port-id?   wson-interface-ref
















Lee, et al.             Expires September 2016                [Page 10]


Internet-Draft             WSON YANG Model                   March 2016








4. WSON-RWA YANG Model


   <CODE BEGINS> file "ietf-wson-topology@2015-10-14.yang"

   module   ietf-wson-topology {
      namespace "urn:ietf:params:xml:ns:yang:ietf-wson-topology";

      prefix wson;

      import ietf-inet-types {
      prefix inet;
      }

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

      organization
         "IETF CCAMP Working Group";

      contact
         "Editor:   Young Lee  <leeyoung@huawei.com>";

      description
         "This module contains a collection of YANG definitions for
         RWA WSON.

         Copyright (c) 2015 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



Lee, et al.             Expires September 2016                [Page 11]


Internet-Draft             WSON YANG Model                   March 2016


         Provisions Relating to IETF Documents
         (http://trustee.ietf.org/license-info).";

      revision 2015-10-14 {
         description
            "version 2.";

      reference
         "RFC XXX: A Yang Data Model for WSON Optical Networks ";
      }

      typedef wson-topology-id {
         type inet:uri;
         description
            "The WSON Topology ID";
      }

      typedef wson-node-id {
         type inet:ip-address;
         description
            "The WSON Node ID";
      }

      typedef devicetype {
         type enumeration {
            enum adm {
               value 1;
               description
                  "Device is ADM";
            }

            enum roadm {
               value 2;
               description
                  "Device is ROAMD/OXC";
            }
         }
         description
            "device type: fixed (ADM) or switched (ROADM/OXC)";
      }



Lee, et al.             Expires September 2016                [Page 12]


Internet-Draft             WSON YANG Model                   March 2016


      typedef directionality {
         type enumeration {
            enum bidir {
               value 0;
               description
                  "bi-directional";
            }
            enum input {
               value 1;
               description
                  "input direction";
            }
            enum output {
               value 2;
               description
                  "output direction";
            }
         }
         description
            "The directionality of link set";
      }



      typedef wson-interface-ref {
         type leafref {
         path "/tet:te-topologies/tet:topology/tet:node"
            + "/tet:te-node-attributes/tet:te-link"
            + "/tet:te-link-id";
         }
         description
            "This type is used by data models that need to
            reference WSON interface.";
      }

      augment "/tet:te-topologies/tet:topology/tet:topology-types"
            + "/tet:te-topology" {
         description "WSON augmentation.";
         container wson-topology{
            description
               "An empty WSON container to identify


Lee, et al.             Expires September 2016                [Page 13]


Internet-Draft             WSON YANG Model                   March 2016


               the topology type.";
         }
      }

      augment "/tet:te-topologies/tet:topology/tet:node"
            +"/tet:te-node-attributes"
            +"/tet:connectivity-matrix" {
         when "/tet:te-topologies/tet:topology/tet:topology-types"
            +"/tet:te-topology/wson-topology" {
            description
               "This augment is only valid for WSON.";
         }
         description "WSON Connectivity Matrix augmentation.";
         container wson-matrix{
            description "WSON specific Matrix.";
            leaf device-type {
               type devicetype;
               description
                  "device type: fixed (ADM) or switched
                  (ROADM/OXC)";
            }
            leaf dir {
               type directionality;
               description
                  "bi-directionality or input or output
                  of link set";
            }

            list matrix-interface {
               key "in-port-id";

               description
                  "matrix-interface describes input-ports
                  and out-ports around a connectivity
                  matrix";

               leaf in-port-id {
                  type wson-interface-ref;
                  description
                     "The reference to in-port";
               }


Lee, et al.             Expires September 2016                [Page 14]


Internet-Draft             WSON YANG Model                   March 2016



               leaf out-port-id {
                  type wson-interface-ref;
                  description
                     "The reference to out-port";
               }
            }
         }
      }

      augment "/tet:te-topologies/tet:topology/tet:node"
            + "/tet:te-node-attributes/tet:te-link"   {

         when "/tet:te-topologies/tet:topology/tet:topology-types"
            +"/tet:te-topology/wson-topology" {
            description
               "This augment is only valid for WSON.";
            }
         description "WSON Link augmentation.";

         leaf-list wavelength-available-bitmap {
            type boolean;
            description
               "array of bits (i.e., bitmap) that indicates
               if a wavelength is available or not on each
               channel.";
         }
      }

      augment "/tet:te-topologies/tet:topology/tet:node" {
         when "/tet:te-topologies/tet:topology/tet:topology-types"
            +"/tet:te-topology/wson-topology" {
         description
            "This augment is only valid for WSON.";
         }
         description "WSON Node augmentation.";

         list resource-pool {
            key "resource-pool-id";
            description
               "The resource pool list";


Lee, et al.             Expires September 2016                [Page 15]


Internet-Draft             WSON YANG Model                   March 2016



            leaf resource-pool-id {
               type uint32;
               description
                  "The resource pool ID";
            }

            leaf pool-state {
               type boolean;
               description
                  "TRUE is state UP; FALSE is state down";
            }

            list matrix-interface {
               key "in-port-id";

               description
                  "pool is described as matrix-interface
                  with input-ports and output-ports
                  around the pool";

               leaf in-port-id {
                  type wson-interface-ref;
                  description
                     "The reference to in-interface";
               }

               leaf out-port-id {
                  type wson-interface-ref;
                  description
                     "The reference to out-interface";
               }
            }
         }
      }
   }

   <CODE ENDS>






Lee, et al.             Expires September 2016                [Page 16]


Internet-Draft             WSON YANG Model                   March 2016


5. Security Considerations

   TDB



6. IANA Considerations

   TDB

7. Acknowledgments

   This document was prepared using 2-Word-v2.0.template.dot.




































Lee, et al.             Expires September 2016                [Page 17]


Internet-Draft             WSON YANG Model                   March 2016




8. References

   8.1. Normative References

   [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.

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



   8.2. Informative References



9. Contributors


Authors' Addresses

   Young Lee (ed.)
   Huawei Technologies
   5340 Legacy Drive, Building 3
   Plano, TX 75023
   USA

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


   Dhruv Dhody
   Huawei Technologies India Pvt. Ltd,
   Near EPIP Industrial Area,  Kundalahalli Village,  Whitefield,
   Bangalore -  560 037 [H1-2A-245]


Lee, et al.             Expires September 2016                [Page 18]


Internet-Draft             WSON YANG Model                   March 2016



   Email: dhruv.dhody@huawei.com

   Xian Zhang
   Huawei Technologies

   Email: zhang.xian@huawei.com

   Aihua Guo
   ADVA
   Email: AGuo@advaoptical.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
   Email: byyun@etri.re.kr




















Lee, et al.             Expires September 2016                [Page 19]