CCAMP Working Group J.E. Lopez de Vergara Internet Draft Universidad Autonoma de Madrid Intended status: Standards Track D. Perdices Expires: July 10, 2020 Naudit HPCN V. Lopez Telefonica I+D/GCTO D. King Lancaster University Y. Lee SKKU H. Zheng Huawei Technologies January 8, 2020 YANG data model for Flexi-Grid Optical Networks draft-ietf-ccamp-flexigrid-yang-05.txt Status of this Memo This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79. This document may not be modified, and derivative works of it may not be created, except to publish it as an RFC and to translate it into languages other than English. 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 January 8, 2020. Copyright Notice Copyright (c) 2020 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 Lopez de Vergara, et al. Expires July 10, 2020 [Page 1] Internet-Draft A YANG data model for Flexi-Grid Jan 2020 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. Abstract This document defines a YANG model for managing flexi-grid optical Networks. The model described in this document defines a flexi-grid traffic engineering database. A complementary module is referenced to detail the flexi-grid media channels. This module is grounded on other defined YANG abstract models. Table of Contents 1. Introduction .............................................. 2 2. Conventions used in this document ......................... 3 2.1. Terminology .......................................... 3 2.2. Tree diagram ......................................... 4 2.3. Prefixes in Data Node Names .......................... 4 3. Flexi-grid network topology model overview ................ 4 4. Main building blocks of the Flexi-grid TED................. 5 4.1 Formal Syntax ......................................... 8 5. Example of use ............................................ 9 6. Flexi-grid TED YANG Model.................................. 10 6.1. YANG Model - Tree .................................... 10 6.2. YANG Model - Code .................................... 31 6.3. License .............................................. 71 7. Security Considerations ................................... 71 8. IANA Considerations ....................................... 72 9. References ................................................ 73 9.1. Normative References ................................. 73 9.2. Informative References ............................... 74 10. Contributors ............................................. 75 11. Acknowledgments .......................................... 75 Authors' Addresses ........................................... 75 1. Introduction Internet-based traffic is dramatically increasing every year. Moreover, such traffic is also becoming more dynamic. Thus, transport networks need to evolve from current DWDM systems towards elastic optical networks, based on flexi-grid transmission and switching technologies [RFC7698]. This technology aims at increasing both transport network scalability and flexibility, allowing the optimization of bandwidth usage. Lopez de Vergara, et al. Expires July 10, 2020 [Page 2] Internet-Draft A YANG data model for Flexi-Grid Jan 2020 This document presents a YANG [RFC7950] model for flexi-grid objects in the dynamic optical network, including the nodes, transponders and links between them, as well as how such links interconnect nodes and transponders. The YANG model for flexi-grid networks allows the representation of the flexi-grid optical layer of a network, combined with the underlying physical layer. This document identifies the flexi-grid components, parameters and their values, characterizes the features and the performances of the flexi-grid elements. An application example is provided towards the end of the document to better understand their utility. 2. Conventions used in this document The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC2119]. In this document, these words will appear with that interpretation only when in ALL CAPS. Lower case uses of these words are not to be interpreted as carrying RFC-2119 significance. In this document, the characters ">>" preceding an indented line(s) indicates a compliance requirement statement using the key words listed above. This convention aids reviewers in quickly identifying or finding the explicit compliance requirements of this RFC. 2.1. Terminology Refer to [RFC7446] and [RFC7581] 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 o state data Lopez de Vergara, et al. Expires July 10, 2020 [Page 3] Internet-Draft A YANG data model for Flexi-Grid Jan 2020 The terminology for describing YANG data models is found in [RFC7950]. 2.2. Tree diagram A simplified graphical representation of the data model is used in chapter 6 of this this document. The meaning of the symbols in these diagrams is defined in [RFC8340]. 2.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 | [Layer0-Types] | | flexi-grid | ietf-flexi-grid-topology| RFCXXXX | | 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. 3. Flexi-grid network topology model overview YANG is a data modeling language used to model configuration data manipulated by the NETCONF protocol. Several YANG models have already been specified for network configurations. For instance, the work in [RFC8345] has proposed a generic YANG model for network/service topologies and inventories. The work in [TE-TOPO] presents a data model to represent, retrieve and manipulate Traffic Engineering (TE) Topologies. These models serve as base models that other technology specific models can augment. A YANG model has also been proposed in [I-D.draft-dharini-ccamp-dwdm-if-yang] to manage single channel optical interface parameters of DWDM applications, and in [I-D.draft-ietf-ccamp-wson-yang] another model has been specified for the routing and wavelength assignment TE topology in wavelength switched optical networks (WSONs). None of them are specific for flexi-grid technology. Then, as stated before, we propose a model to describe a flexi-grid topology that is split in two YANG sub-modules: Lopez de Vergara, et al. Expires July 10, 2020 [Page 4] Internet-Draft A YANG data model for Flexi-Grid Jan 2020 o Flexi-grid-topology: In order to be compatible with existing proposals, we augment the definitions contained in [RFC8345] and [TE-TOPO], by defining the different elements we can find in a flexi-grid network: a node, a transponder and a link. For that, each of those elements is defined as a container that includes a group of attributes. References to the elements are provided to be later used in the definition of a media channel. Data types for the type of modulation, the flexi-grid technology, the FEC, etc. are defined in [Layer0-Types]. o Media-channel: This module defines the whole path from a source transponder to the destination through a number of intermediate nodes and links. For this, it takes the information defined before in the flexi-grid topology. This module is described in [I-D.draft-ietf-ccamp-flexigrid-media-channel-yang]. The following section provides a detailed view of the first module. 4. Main building blocks of the Flexi-grid topology This section details the defined YANG module. It is listed below in section 6. The description of the three main components, flexi-grid-node, flexi-grid-transponder and flexi-grid-link is provided below. flexi-grid-sliceable-transponders are also defined. ::= : This element designates a node in the network. ::= : Contains the configuration of a node. ::= : Contains all the attributes related to the node configuration, such as its interfaces or its management addresses. ::= [ / ] Lopez de Vergara, et al. Expires July 10, 2020 [Page 5] Internet-Draft A YANG data model for Flexi-Grid Jan 2020 : The list containing all the information of the interfaces. : Determines the interface name. : Port number of the interface. : Boolean value that defines whether the interface is input or not. : Boolean value that defines whether the interface is output or not. : Description of the usage of the interface. : Determines if the interface is numbered or unnumbered. ::= : An interface with its own IP address. : Only available if is "numbered-interface". Determines the IP address of the interface. ::=