Internet-Draft | Flexi-Grid YANG | January 2024 |
Lopez de Vergara, et al. | Expires 1 August 2024 | [Page] |
This document defines a YANG module for managing flexi-grid optical networks. The model defined in this document specifies a flexi-grid traffic engineering database that is used to describe the topology of a flexi-grid network. It is based on and augments existing YANG models that describe network and traffic engineering topologies.¶
This note is to be removed before publishing as an RFC.¶
The latest revision of this draft can be found at https://ietf-ccamp-wg.github.io/draft-ietf-ccamp-flexigrid-yang/draft-ietf-ccamp-flexigrid-yang.html. Status information for this document may be found at https://datatracker.ietf.org/doc/draft-ietf-ccamp-flexigrid-yang/.¶
Discussion of this document takes place on the Common Control and Measurement Plane Working Group mailing list (mailto:ccamp@ietf.org), which is archived at https://mailarchive.ietf.org/arch/browse/ccamp/. Subscribe at https://www.ietf.org/mailman/listinfo/ccamp/.¶
Source for this draft and an issue tracker can be found at https://github.com/ietf-ccamp-wg/draft-ietf-ccamp-flexigrid-yang.¶
This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79.¶
Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet-Drafts is at https://datatracker.ietf.org/drafts/current/.¶
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."¶
This Internet-Draft will expire on 1 August 2024.¶
Copyright (c) 2024 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 (https://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 Revised BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Revised BSD License.¶
The flexible grid (flexi-grid) optical network technology defined by the International Telecommunication Union Telecommunication Standardization Sector (ITU-T) and documented in Recommendation ITU- T_G.694.1 [ITU-T_G.694.1] and ITU-T_G.872 [ITU-T_G.872] provides an enhanced Dense Wavelength Division Multiplexing (DWDM) grid by defining a set of nominal central frequencies, slot widths, and the concept of the "frequency slot". This technology increases both transport network scalability and flexibility, allowing the optimization of bandwidth usage.¶
[RFC7698] provides a framework for GMPLS-Based control of flexi-grid DWDM networks while [RFC7699] defines generalized labels for the use of GMPLS in flexi-grid networks.¶
[RFC8363] provides extensions to the OSPF-TE protocol so as to support GMPLS control of flexi-grid networks.¶
This document presents a YANG data model [RFC7950] for flexi-grid objects in the dynamic optical network, including nodes, transponders and links, as well as how such links interconnect nodes. This model is independent of control plane protocols.¶
This document identifies the flexi-grid components, parameters, and their values. It characterizes the features and the performances of the flexi-grid elements. For this, it augments [RFC8795], and imports the generic Layer 0 types and use of "media-channel" defined in [I-D.ietf-ccamp-rfc9093-bis].¶
An application example in Section 4 is also provided to better understand the utility of this YANG model.¶
A partner document defines a second YANG module that described flexi- grid tunnels, i.e., the paths from source to destination through a number of intermediate nodes [I-D.ietf-ccamp-flexigrid-tunnel-yang].¶
Impairment-aware traffic engineering topology is described in [I-D.ietf-ccamp-optical-impairment-topology-yang].¶
The YANG data model defined in this document conforms to the Network Management Datastore Architecture (NMDA) [RFC8342].¶
Refer to [RFC7698] and [RFC7699] for the key terms used in this document.¶
The following terms are defined in [RFC7950] and are not redefined here:¶
The following terms are defined in [RFC6241] and are not redefined here:¶
The terminology for describing YANG data models is found in [RFC7950].¶
A simplified graphical representation of the data model is used in this document. The meaning of the symbols in these diagrams is defined in [RFC8340].¶
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. It uses prefixes from [I-D.ietf-ccamp-rfc9093-bis], [RFC8345], and [RFC8795].¶
Prefix | YANG module | Reference |
---|---|---|
l0-types | ietf-layer0-types | [RFCYYYY] |
flexgt | ietf-flexi-grid-topology | RFC XXXX |
nw | ietf-network | [RFC8345] |
nt | ietf-network-topology | [RFC8345] |
tet | ietf-te-topology | [RFC8795] |
RFC Editor Note: Please replace XXXX with the RFC number assigned to this document. Please replace YYYY with the RFC numbers assigned to [I-D.ietf-ccamp-rfc9093-bis]. Please remove this note.¶
In order to explain how this model is used, we provide the following example. An optical network usually has multiple transponders, switches (nodes) and links. Figure 1 shows a simple topology.¶
In order to configure a flexi-grid network to interconnect transponders A and E, first of all we have to populate the flexi-grid topology YANG model with all elements in the network:¶
We define the transponders within nodes A and E as tunnel termination points (TTPs) and provide their internal local link connectivity towards the node interfaces. We also provide the identifiers, addresses and interfaces of nodes A and B.¶
We do the same for the nodes B, C and D, providing their identifiers, addresses and interfaces, as well as the internal connectivity matrix between interfaces.¶
Then, we also define the links 1 to 5 that interconnect nodes, indicating which flexi-grid labels are available.¶
Other information, such as the slot frequency and granularity are also provided.¶
This document describes the data model for flexi-grid topology. As a classic traffic engineering (TE) technology, flexi-grid provides WDM switching in transport network. Therefore the YANG module presented in this document augments from a more generic TE network topology data model, i.e., the ietf-te-topology, as specified in [RFC8795], following the guidelines provided in section 6 of [RFC8795].¶
Common types, identities, and groupings defined in [I-D.ietf-ccamp-rfc9093-bis] are reused in this document.¶
The figure below shows the augmentation relationship between YANG models.¶
The entities and TE attributes, such as node, termination points and links, are still applicable for describing a flexi-grid topology and the model presented in this document only specifies the technology- specific attributes/information.¶
The flexi-grid specific attributes and label format is defined in [RFC7699], including the grid type, nominal central frequency granularity, slot width granularity, n and m parameters. A collection of common data types have also been specified in [I-D.ietf-ccamp-rfc9093-bis], and used in this document for augmentation of the generic TE topology model.¶
The YANG module ietf-flexi-grid-topology defined in this document conforms to the Network Management Datastore Architecture (NMDA) defined in [RFC8342].¶
There are a few characteristics augmenting to the generic TE topology.¶
Following the guidelines in [RFC8795], a flexi-grid-topology network- type is specified as the indicator of flexi-grid in the topology as shown in Figure 3.¶
A flexi-grid-node presence container is specified, augmenting the generic TE node attributes, to indicate that the TE node is a Flexi- Grid node as shown in Figure 4.¶
It is assumed that all the flexi-grid nodes are reconfigurable.¶
No bandwidth augmentations are needed for this YANG module.¶
As described in Section 4.2 of [RFC7699], there is some overlap between bandwidth and label in Layer 0.¶
The flexi-grid label resource information described in Section 5.4, is sufficient to also describe the spectrum resources within a flexi- grid network. Therefore, the model does not define any augmentation for the te-bandwidth containers defined in [RFC8795].¶
The model augments all the occurrences of the label-restriction list in [RFC8795] with flexi-grid technology specific attributes using the flexi-grid-label-range-info grouping defined in [I-D.ietf-ccamp-rfc9093-bis].¶
Moreover, following the guidelines in [RFC8795], the model augments all the occurrences of the te-label container with the flexi-grid technology specific attributes using the flexi-grid-label-start-end, flexi-grid-label-hop and flexi-grid-label-step groupings defined in [I-D.ietf-ccamp-rfc9093-bis].¶
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 Transport Layer Security (TLS) [RFC8446].¶
The NETCONF access control model [RFC8341] 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 SSH [RFC6242] describes a method for invoking and running NETCONF within a 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.¶
A number of configuration data nodes defined in this document are writable/deletable (i.e., "config true"). These data nodes may be considered sensitive or vulnerable in some network environments.¶
There are a number of data nodes defined in this YANG module that are writable/creatable/deletable (i.e., config true, which is the default). These data nodes may be considered sensitive or vulnerable in some network environments. Write operations (e.g., edit-config) to these data nodes without proper protection can have a negative effect on network operations. These are the subtrees and data nodes and their sensitivity/vulnerability:¶
/nw:networks/nw:network/nw:network-types/tet:te-topology /nw:networks/nw:network/nt:link/tet:te/tet:te-link-attributes /nw:networks/nw:network/nw:node/nt:termination-point/tet:te /nw:networks/nw:network/nw:node/tet:te/tet:te-node-attributes /te-connectivity-matrices/te-connectivity-matrix/tet:path- constraints/tet:te-bandwidth/tet:technology /nw:networks/nw:network/nw:node/tet:te /tet:tunnel-termination-point/tet:local-link-connectivities /tet:label-restrictions/tet:label-restriction¶
IANA is requested to assigned a new URI from the "IETF XML Registry" [RFC3688] as follows:¶
URI: urn:ietf:params:xml:ns:yang:ietf-flexi-grid-topology Registrant Contact: The IESG XML: N/A; the requested URI is an XML namespace.¶
IANA is requested to assign a new YANG module name in the "YANG Module Names" registry [RFC6020] as follows:¶
Name: ietf-flexi-grid-topology Namespace: urn:ietf:params:xml:ns:yang:ietf-flexi-grid-topology Prefix: flexgt Reference: RFC XXXX¶
The work presented in this document has been partially funded by the European Commission under the project H2020 METRO-HAUL (Metro High bandwidth, 5G Application-aware optical network, with edge storage, compUte and low Latency), Grant Agreement number: 761727.¶
This work is also partially funded by the Spanish State Research Agency under the project AgileMon (AEI PID2019-104451RB-C21) and by the Spanish Ministry of Science, Innovation and Universities under the program for the training of university lecturers (Grant number: FPU19/05678).¶
Thanks to Adrian Farrel for reviewing this document and assisting with conversion to XML.¶