]> A YANG Data Model for Optical Transport Network (OTN) Tunnels and Label Switched Paths Huawei Technologies
H1, Huawei Xiliu Beipo Village, Songshan Lake Dongguan Guangdong 523808 China zhenghaomian@huawei.com
Huawei Technologies
italo.busi@huawei.com
Nokia
sergio.belotti@nokia.com
Nokia
victor.lopez@nokia.com
CAICT
xuyunbin@caict.ac.cn
Routing CCAMP Working Group This document describes the YANG data model for tunnels in OTN TE networks. The model can be used to do the configuration in order to establish the tunnel in OTN network. This work is independent with the control plane protocols. About This Document The latest revision of this draft can be found at . Status information for this document may be found at . Discussion of this document takes place on the CCAMP Working Group Working Group mailing list (), which is archived at . Subscribe at . Source for this draft and an issue tracker can be found at .
Introduction OTN networks, specified in , can carry various types of client signals. In many cases, the client signal is carried over an OTN tunnel across connected domains in a multi-domain network. This document provides YANG model for creating OTN tunnel. The model augments the generic TE Tunnel model specified in .
Editorial Note (To be removed by RFC Editor)
  • Note to the RFC Editor: This section is to be removed prior to publication.
This document contains placeholder values that need to be replaced with finalized values at the time of publication. This note summarizes all of the substitutions that are needed. Please apply the following replacements:
  • XXXX --> the assigned RFC number for this I-D
  • YYYY --> the assigned RFC number fpr
  • ZZZZ --> the assigned RFC number for
  • 2026-05-19 --> the actual date of the publication of this document
Terminology and Notations Refer to for the OTN specific terms terms used in this document. The following terms are defined in and are not redefined here:
  • client
  • server
  • augment
  • data model
  • data node
The following terms are defined in and are not redefined here:
  • configuration data
  • state data
The terminology for describing YANG data models is found in .
Tree Diagram A simplified graphical representation of the data model is used in of this this document. The meaning of the symbols in these diagrams is defined in .
Prefix 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 the following table. Prefixes and corresponding YANG modules
Prefix YANG module Reference
l1-types ietf-layer1-types [RFC YYYY]
otn-tnl ietf-otn-tunnel RFC XXXX
te ietf-te [RFC ZZZZ]
OTN Tunnel Model Description
Overview of OTN Tunnel Model This document aims to describe the data model for OTN tunnel. The OTN tunnel model is using TE tunnel as a basic model and augments it with OTN-specific parameters, including the bandwidth information and label information. shows the augmentation relationship.
Relationship between OTN and TE tunnel models TE generic ietf-te Augments OTN ietf-otn-tunnel
It is also worth noting that the OTN tunnel provisioning is usually based on the OTN topology. Therefore the OTN tunnel model is usually used together with OTN topology model specified in . The OTN tunnel model also imports a few type modules, including ietf-layer1-types, ietf-te-types and ietf-inet-types. The OTN-specific attributes in , including the Tributary Slot (TS) and Tributary Port Number (TPN), can be used to represent the bandwidth and label information. These attributes have been specified in and used in this document for augmentation of the generic TE tunnel model. More scenarios and model applications can be found in and .
Bandwidth Augmentation The model augments all the occurrences of the te-bandwidth container with the OTN technology specific attributes using the otn-link- bandwidth and otn-path-bandwidth groupings defined in .
Label Augmentation The model augments all the occurrences of the label-restriction list with OTN technology specific attributes using the otn-label-range- info grouping defined in . Moreover, the model augments all the occurrences of the te-label container with the OTN technology specific attributes using the otn- label-start-end, otn-label-hop and otn-label-step groupings defined in .
OTN Tunnel YANG Code
WG List: Editor: Haomian Zheng Editor: Italo Busi Editor: Sergio Belotti Editor: Victor Lopez Editor: Yunbin Xu "; description "This module defines a model for OTN Tunnel Services. Copyright (c) 2026 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 Revised BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info). All revisions of IETF and IANA published modules can be found at the YANG Parameters registry group (https://www.iana.org/assignments/yang-parameters). This version of this YANG module is part of RFC XXXX; see the RFC itself for full legal notices."; revision 2026-05-19 { description "Initial version"; reference "RFC XXXX: A YANG Data Model for Optical Transport Network (OTN) Tunnels and Label Switched Paths"; } /* * Data nodes */ /* * Augment TE bandwidth */ augment "/te:te/te:globals/te:named-path-constraints/" + "te:named-path-constraint/" + "te:te-bandwidth/te:technology" { description "Augment TE bandwidth of the named path constraint."; case otn { uses l1-types:otn-path-bandwidth; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:te-bandwidth/te:technology" { description "Augment TE bandwidth of the tunnel."; case otn { uses l1-types:otn-path-bandwidth; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:te-bandwidth/te:technology" { description "Augment TE bandwidth of the primary path."; case otn { uses l1-types:otn-path-bandwidth; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:computed-paths-properties/" + "te:computed-path-properties/te:path-properties/" + "te:te-bandwidth/te:technology" { description "Augment TE bandwidth of primary path's computed path properties."; case otn { uses l1-types:otn-path-bandwidth; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:primary-reverse-path/" + "te:te-bandwidth/te:technology" { description "Augment TE bandwidth of the primary reverse path."; case otn { uses l1-types:otn-path-bandwidth; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:primary-reverse-path/" + "te:computed-paths-properties/" + "te:computed-path-properties/te:path-properties/" + "te:te-bandwidth/te:technology" { description "Augment TE bandwidth of the primary reverse path's computed path properties."; case otn { uses l1-types:otn-path-bandwidth; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-paths/te:secondary-path/" + "te:te-bandwidth/te:technology" { description "Augment TE bandwidth of the secondary path."; case otn { uses l1-types:otn-path-bandwidth; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-paths/te:secondary-path/" + "te:computed-paths-properties/" + "te:computed-path-properties/te:path-properties/" + "te:te-bandwidth/te:technology" { description "Augment TE bandwidth of the secondary path's computed path properties."; case otn { uses l1-types:otn-path-bandwidth; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-reverse-paths/" + "te:secondary-reverse-path/" + "te:te-bandwidth/te:technology" { description "Augment TE bandwidth of the secondary reverse path."; case otn { uses l1-types:otn-path-bandwidth; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-reverse-paths/" + "te:secondary-reverse-path/" + "te:computed-paths-properties/" + "te:computed-path-properties/te:path-properties/" + "te:te-bandwidth/te:technology" { description "Augment TE bandwidth of the secondary reverse path's computed path properties."; case otn { uses l1-types:otn-path-bandwidth; } } /* * Augment TE label range information */ augment "/te:te/te:globals/te:named-path-constraints/" + "te:named-path-constraint/te:path-in-segment/" + "te:label-restrictions/te:label-restriction" { description "Augment TE label range information for the ingress segment of the named path constraint."; uses l1-types:otn-label-range-info; } augment "/te:te/te:globals/te:named-path-constraints/" + "te:named-path-constraint/te:path-out-segment/" + "te:label-restrictions/" + "te:label-restriction" { description "Augment TE label range information for the egress segment of the named path constraint."; uses l1-types:otn-label-range-info; } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:path-in-segment/te:label-restrictions/" + "te:label-restriction" { description "Augment TE label range information for the ingress segment of the primary path."; uses l1-types:otn-label-range-info; } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:path-out-segment/te:label-restrictions/" + "te:label-restriction" { description "Augment TE label range information for the egress segment of the primary path."; uses l1-types:otn-label-range-info; } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:primary-reverse-path/" + "te:path-in-segment/te:label-restrictions/" + "te:label-restriction" { description "Augment TE label range information for the ingress segment of the primary reverse path."; uses l1-types:otn-label-range-info; } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:primary-reverse-path/" + "te:path-out-segment/te:label-restrictions/" + "te:label-restriction" { description "Augment TE label range information for the egress segment of the primary reverse path."; uses l1-types:otn-label-range-info; } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-paths/te:secondary-path/" + "te:path-in-segment/te:label-restrictions/" + "te:label-restriction" { description "Augment TE label range information for the ingress segment of the secondary path."; uses l1-types:otn-label-range-info; } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-paths/te:secondary-path/" + "te:path-out-segment/te:label-restrictions/" + "te:label-restriction" { description "Augment TE label range information for the egress segment of the secondary path."; uses l1-types:otn-label-range-info; } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-reverse-paths/te:secondary-reverse-path/" + "te:path-in-segment/te:label-restrictions/" + "te:label-restriction" { description "Augment TE label range information for the ingress segment of the secondary reverse path."; uses l1-types:otn-label-range-info; } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-reverse-paths/te:secondary-reverse-path/" + "te:path-out-segment/te:label-restrictions/" + "te:label-restriction" { description "Augment TE label range information for the egress segment of the secondary reverse path."; uses l1-types:otn-label-range-info; } /* * Augment TE label. */ augment "/te:te/te:globals/te:named-path-constraints/" + "te:named-path-constraint/" + "te:explicit-route-objects/" + "te:route-object-exclude-always/te:type/te:label/" + "te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the explicit route objects always excluded by the path computation with the named path constraint."; case otn { uses l1-types:otn-label-hop; } } augment "/te:te/te:globals/te:named-path-constraints/" + "te:named-path-constraint/" + "te:explicit-route-objects/" + "te:route-object-include-exclude/te:type/te:label/" + "te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the explicit route objects included or excluded by the path computation with the named path constraint."; case otn { uses l1-types:otn-label-hop; } } augment "/te:te/te:globals/te:named-path-constraints/" + "te:named-path-constraint/te:path-in-segment/" + "te:label-restrictions/" + "te:label-restriction/te:label-start/" + "te:te-label/te:technology" { description "Augment TE label range start for the ingress segment of the named path constraint."; case otn { uses l1-types:otn-label-start-end; } } augment "/te:te/te:globals/te:named-path-constraints/" + "te:named-path-constraint/te:path-in-segment/" + "te:label-restrictions/" + "te:label-restriction/te:label-end/" + "te:te-label/te:technology" { description "Augment TE label range end for the ingress segment of the named path constraint."; case otn { uses l1-types:otn-label-start-end; } } augment "/te:te/te:globals/te:named-path-constraints/" + "te:named-path-constraint/te:path-in-segment/" + "te:label-restrictions/te:label-restriction/" + "te:label-step/te:technology" { description "Augment TE label range step for the ingress segment of the named path constraint."; case otn { uses l1-types:otn-label-step; } } augment "/te:te/te:globals/te:named-path-constraints/" + "te:named-path-constraint/te:path-out-segment/" + "te:label-restrictions/" + "te:label-restriction/te:label-start/" + "te:te-label/te:technology" { description "Augment TE label range start for the egress segment of the named path constraint."; case otn { uses l1-types:otn-label-start-end; } } augment "/te:te/te:globals/te:named-path-constraints/" + "te:named-path-constraint/te:path-out-segment/" + "te:label-restrictions/" + "te:label-restriction/te:label-end/" + "te:te-label/te:technology" { description "Augment TE label range end for the egress segment of the named path constraint."; case otn { uses l1-types:otn-label-start-end; } } augment "/te:te/te:globals/te:named-path-constraints/" + "te:named-path-constraint/te:path-out-segment/" + "te:label-restrictions/te:label-restriction/" + "te:label-step/te:technology" { description "Augment TE label range step for the egress segment of the named path constraint."; case otn { uses l1-types:otn-label-step; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:optimizations/te:algorithm/te:metric/" + "te:optimization-metric/" + "te:explicit-route-exclude-objects/" + "te:route-object-exclude-object/te:type/te:label/" + "te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the optimization of the explicit route objects excluded by the path computation of the primary path."; case otn { uses l1-types:otn-label-hop; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:optimizations/te:algorithm/te:metric/" + "te:optimization-metric/" + "te:explicit-route-include-objects/" + "te:route-object-include-object/te:type/te:label/" + "te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the optimization of the explicit route objects included by the path computation of the primary path."; case otn { uses l1-types:otn-label-hop; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:explicit-route-objects/" + "te:route-object-exclude-always/te:type/te:label/" + "te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the explicit route objects always excluded by the path computation of the primary path."; case otn { uses l1-types:otn-label-hop; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:explicit-route-objects/" + "te:route-object-include-exclude/te:type/te:label/" + "te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the explicit route objects included or excluded by the path computation of the primary path."; case otn { uses l1-types:otn-label-hop; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:path-in-segment/te:label-restrictions/" + "te:label-restriction/te:label-start/" + "te:te-label/te:technology" { description "Augment TE label range start for the ingress segment of the primary path."; case otn { uses l1-types:otn-label-start-end; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:path-in-segment/te:label-restrictions/" + "te:label-restriction/te:label-end/" + "te:te-label/te:technology" { description "Augment TE label range end for the ingress segment of the primary path."; case otn { uses l1-types:otn-label-start-end; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:path-in-segment/te:label-restrictions/" + "te:label-restriction/te:label-step/te:technology" { description "Augment TE label range step for the ingress segment of the primary path."; case otn { uses l1-types:otn-label-step; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:path-out-segment/te:label-restrictions/" + "te:label-restriction/te:label-start/" + "te:te-label/te:technology" { description "Augment TE label range start for the egress segment of the primary path."; case otn { uses l1-types:otn-label-start-end; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:path-out-segment/te:label-restrictions/" + "te:label-restriction/te:label-end/" + "te:te-label/te:technology" { description "Augment TE label range end for the egress segment of the primary path."; case otn { uses l1-types:otn-label-start-end; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:path-out-segment/te:label-restrictions/" + "te:label-restriction/te:label-step/te:technology" { description "Augment TE label range end for the egress segment of the primary path."; case otn { uses l1-types:otn-label-step; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:computed-paths-properties/" + "te:computed-path-properties/te:path-properties/" + "te:path-route-objects/te:path-route-object/" + "te:type/te:label/" + "te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the route object of the computed primary path."; case otn { uses l1-types:otn-label-hop; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:primary-reverse-path/" + "te:optimizations/te:algorithm/te:metric/" + "te:optimization-metric/" + "te:explicit-route-exclude-objects/" + "te:route-object-exclude-object/te:type/te:label/" + "te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the optimization of the explicit route objects excluded by the path computation of the primary reverse path."; case otn { uses l1-types:otn-label-hop; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:primary-reverse-path/" + "te:optimizations/te:algorithm/te:metric/" + "te:optimization-metric/" + "te:explicit-route-include-objects/" + "te:route-object-include-object/te:type/te:label/" + "te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the optimization of the explicit route objects included by the path computation of the primary reverse path."; case otn { uses l1-types:otn-label-hop; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:primary-reverse-path/" + "te:explicit-route-objects/" + "te:route-object-exclude-always/" + "te:type/te:label/" + "te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the explicit route objects always excluded by the path computation of the primary reverse path."; case otn { uses l1-types:otn-label-hop; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:primary-reverse-path/" + "te:explicit-route-objects/" + "te:route-object-include-exclude/" + "te:type/te:label/" + "te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the explicit route objects included or excluded by the path computation of the primary reverse path."; case otn { uses l1-types:otn-label-hop; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:primary-reverse-path/" + "te:path-in-segment/te:label-restrictions/" + "te:label-restriction/te:label-start/" + "te:te-label/te:technology" { description "Augment TE label range start for the ingress segment of the primary reverse path."; case otn { uses l1-types:otn-label-start-end; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:primary-reverse-path/" + "te:path-in-segment/te:label-restrictions/" + "te:label-restriction/te:label-end/" + "te:te-label/te:technology" { description "Augment TE label range end for the ingress segment of the primary reverse path."; case otn { uses l1-types:otn-label-start-end; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:primary-reverse-path/" + "te:path-in-segment/te:label-restrictions/" + "te:label-restriction/te:label-step/te:technology" { description "Augment TE label range step for the ingress segment of the primary reverse path."; case otn { uses l1-types:otn-label-step; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:primary-reverse-path/" + "te:path-out-segment/te:label-restrictions/" + "te:label-restriction/te:label-start/" + "te:te-label/te:technology" { description "Augment TE label range start for the egress segment of the primary reverse path."; case otn { uses l1-types:otn-label-start-end; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:primary-reverse-path/" + "te:path-out-segment/te:label-restrictions/" + "te:label-restriction/te:label-end/" + "te:te-label/te:technology" { description "Augment TE label range end for the egress segment of the primary reverse path."; case otn { uses l1-types:otn-label-start-end; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:primary-reverse-path/" + "te:path-out-segment/te:label-restrictions/" + "te:label-restriction/te:label-step/te:technology" { description "Augment TE label range step for the egress segment of the primary reverse path."; case otn { uses l1-types:otn-label-step; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:primary-paths/te:primary-path/" + "te:primary-reverse-path/" + "te:computed-paths-properties/" + "te:computed-path-properties/te:path-properties/" + "te:path-route-objects/te:path-route-object/te:type/" + "te:label/te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the route object of the computed primary reverse path."; case otn { uses l1-types:otn-label-hop; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-paths/te:secondary-path/" + "te:optimizations/te:algorithm/te:metric/" + "te:optimization-metric/" + "te:explicit-route-exclude-objects/" + "te:route-object-exclude-object/te:type/te:label/" + "te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the optimization of the explicit route objects excluded by the path computation of the secondary path."; case otn { uses l1-types:otn-label-hop; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-paths/te:secondary-path/" + "te:optimizations/te:algorithm/te:metric/" + "te:optimization-metric/" + "te:explicit-route-include-objects/" + "te:route-object-include-object/te:type/te:label/" + "te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the optimization of the explicit route objects included by the path computation of the secondary path."; case otn { uses l1-types:otn-label-hop; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-paths/te:secondary-path/" + "te:explicit-route-objects/" + "te:route-object-exclude-always/te:type/te:label/" + "te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the explicit route objects always excluded by the path computation of the secondary path."; case otn { uses l1-types:otn-label-hop; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-paths/te:secondary-path/" + "te:explicit-route-objects/" + "te:route-object-include-exclude/te:type/te:label/" + "te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the explicit route objects included or excluded by the path computation of the secondary path."; case otn { uses l1-types:otn-label-hop; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-paths/te:secondary-path/" + "te:path-in-segment/te:label-restrictions/" + "te:label-restriction/te:label-start/" + "te:te-label/te:technology" { description "Augment TE label range start for the ingress segment of the secondary path."; case otn { uses l1-types:otn-label-start-end; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-paths/te:secondary-path/" + "te:path-in-segment/te:label-restrictions/" + "te:label-restriction/te:label-end/" + "te:te-label/te:technology" { description "Augment TE label range end for the ingress segment of the secondary path."; case otn { uses l1-types:otn-label-start-end; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-paths/te:secondary-path/" + "te:path-in-segment/te:label-restrictions/" + "te:label-restriction/te:label-step/te:technology" { description "Augment TE label range step for the ingress segment of the secondary path."; case otn { uses l1-types:otn-label-step; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-paths/te:secondary-path/" + "te:path-out-segment/te:label-restrictions/" + "te:label-restriction/te:label-start/" + "te:te-label/te:technology" { description "Augment TE label range start for the egress segment of the secondary path."; case otn { uses l1-types:otn-label-start-end; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-paths/te:secondary-path/" + "te:path-out-segment/te:label-restrictions/" + "te:label-restriction/te:label-end/" + "te:te-label/te:technology" { description "Augment TE label range end for the egress segment of the secondary path."; case otn { uses l1-types:otn-label-start-end; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-paths/te:secondary-path/" + "te:path-out-segment/te:label-restrictions/" + "te:label-restriction/te:label-step/te:technology" { description "Augment TE label range step for the egress segment of the secondary path."; case otn { uses l1-types:otn-label-step; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-paths/te:secondary-path/" + "te:computed-paths-properties/" + "te:computed-path-properties/" + "te:path-properties/te:path-route-objects/" + "te:path-route-object/te:type/te:label/" + "te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the route object of the computed secondary path."; case otn { uses l1-types:otn-label-hop; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-reverse-paths/te:secondary-reverse-path/" + "te:optimizations/te:algorithm/te:metric/" + "te:optimization-metric/" + "te:explicit-route-exclude-objects/" + "te:route-object-exclude-object/te:type/te:label/" + "te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the optimization of the explicit route objects excluded by the path computation of the secondary reverse path."; case otn { uses l1-types:otn-label-hop; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-reverse-paths/te:secondary-reverse-path/" + "te:optimizations/te:algorithm/te:metric/" + "te:optimization-metric/" + "te:explicit-route-include-objects/" + "te:route-object-include-object/te:type/te:label/" + "te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the optimization of the explicit route objects included by the path computation of the secondary reverse path."; case otn { uses l1-types:otn-label-hop; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-reverse-paths/te:secondary-reverse-path/" + "te:explicit-route-objects/" + "te:route-object-exclude-always/te:type/te:label/" + "te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the explicit route objects always excluded by the path computation of the secondary reverse path."; case otn { uses l1-types:otn-label-hop; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-reverse-paths/te:secondary-reverse-path/" + "te:explicit-route-objects/" + "te:route-object-include-exclude/te:type/te:label/" + "te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the explicit route objects included or excluded by the path computation of the secondary reverse path."; case otn { uses l1-types:otn-label-hop; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-reverse-paths/te:secondary-reverse-path/" + "te:path-in-segment/te:label-restrictions/" + "te:label-restriction/te:label-start/" + "te:te-label/te:technology" { description "Augment TE label range start for the ingress segment of the secondary reverse path."; case otn { uses l1-types:otn-label-start-end; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-reverse-paths/te:secondary-reverse-path/" + "te:path-in-segment/te:label-restrictions/" + "te:label-restriction/te:label-end/" + "te:te-label/te:technology" { description "Augment TE label range end for the ingress segment of the secondary reverse path."; case otn { uses l1-types:otn-label-start-end; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-reverse-paths/te:secondary-reverse-path/" + "te:path-in-segment/te:label-restrictions/" + "te:label-restriction/te:label-step/te:technology" { description "Augment TE label range step for the ingress segment of the secondary reverse path."; case otn { uses l1-types:otn-label-step; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-reverse-paths/te:secondary-reverse-path/" + "te:path-out-segment/te:label-restrictions/" + "te:label-restriction/te:label-start/" + "te:te-label/te:technology" { description "Augment TE label range start for the egress segment of the secondary reverse path."; case otn { uses l1-types:otn-label-start-end; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-reverse-paths/te:secondary-reverse-path/" + "te:path-out-segment/te:label-restrictions/" + "te:label-restriction/te:label-end/" + "te:te-label/te:technology" { description "Augment TE label range end for the egress segment of the secondary reverse path."; case otn { uses l1-types:otn-label-start-end; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-reverse-paths/te:secondary-reverse-path/" + "te:path-out-segment/te:label-restrictions/" + "te:label-restriction/te:label-step/te:technology" { description "Augment TE label range step for the egress segment of the secondary reverse path."; case otn { uses l1-types:otn-label-step; } } augment "/te:te/te:tunnels/te:tunnel/" + "te:secondary-reverse-paths/te:secondary-reverse-path/" + "te:computed-paths-properties/" + "te:computed-path-properties/" + "te:path-properties/te:path-route-objects/" + "te:path-route-object/te:type/te:label/" + "te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the route object of the computed secondary reverse path."; case otn { uses l1-types:otn-label-hop; } } augment "/te:te/te:lsps/" + "te:lsp/te:lsp-actual-route-information/" + "te:lsp-actual-route-information/te:type/te:label/" + "te:label-hop/te:te-label/te:technology" { description "Augment TE label hop for the record route of the LSP."; case otn { uses l1-types:otn-label-hop; } } } ]]>
IANA Considerations IANA is requested to register the following URI in the "ns" registry within the "IETF XML Registry" group : IANA is requested to register the following YANG module in the "YANG Module Names" registry within the "YANG Parameters" registry group.
Security Considerations This section is modeled after the template described in . The "ietf-otn-tunnel" YANG module defines a data model that is designed to be accessed via YANG-based management protocols, such as NETCONF and RESTCONF . These protocols have to use a secure transport layer (e.g., SSH , TLS , and QUIC ) and have to use mutual authentication. The Network Configuration Access Control Model (NACM) 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. 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 can 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. Specifically, the following subtrees and data nodes have particular sensitivities/vulnerabilities:
  • "otnt:otn-bandwidth"
  • This subtree specifies the configurations of OTN technology-specific information under any occurrence of the tet:te-bandwidth container, as defined in (e.g., "/te:te/te:tunnels/te:tunnel/te:te-bandwidth/te:technology/otnt:otn/otnt:otn-bandwidth"). By configuring the OTN bandwidth attributes, an attacker may create an unauthorized OTN traffic path. By removing or modifying it, a malicious attacker may cause OTN traffic to be disabled or misrouted.
  • "otnt:otn-label-range"
  • This subtree specifies the configurations of OTN technology-specific label range information under any occurrence of the tet:label-restriction container, as defined in (e.g., "/te:te/te:tunnels/te:tunnel/te:primary-paths/te:primary-path/te:path-in-segment/te:label-restrictions/te:label-restriction/otnt:otn-label-range"). By configuring the OTN label range attributes, an attacker may create an unauthorized OTN traffic path. By removing or modifying, a malicious attacker may cause OTN traffic to be disabled or misrouted.
  • "otnt:otn-label"
  • This subtree specifies the configurations of OTN technology-specific label information under any occurrence of the tet:te-label container, as defined in (e.g., "/te:te/te:tunnels/te:tunnel/te:primary-paths/te:primary-path/te:explicit-route-objects/te:route-object-include-exclude/te:type/te:label/te:label-hop/te:te-label/te:technology/otnt:otn/otnt:otn-label"). By configuring, removing or modifying the OTN label attributes, a malicious attacker may cause OTN traffic to be disabled or misrouted.
Some of the readable data nodes in this YANG module may be considered sensitive or vulnerable in some network environments. It is thus important to control read access (e.g., via get, get-config, or notification) to these data nodes. Specifically, the following subtrees and data nodes have particular sensitivities/vulnerabilities:
  • "otnt:otn-bandwidth"
  • This subtree specifies the configurations of OTN technology-specific information under any occurrence of the tet:te-bandwidth container, as defined in (e.g., "/te:te/te:tunnels/te:tunnel/te:te-bandwidth/te:technology/otnt:otn/otnt:otn-bandwidth"). Unauthorized access to this data node can disclose the OTN bandwidth information of OTN tunnels and LSPs.
  • "otnt:otn-label-range"
  • This subtree specifies the configurations of OTN technology-specific label range information under any occurrence of the tet:label-restriction container, as defined in (e.g., "/te:te/te:tunnels/te:tunnel/te:primary-paths/te:primary-path/te:path-in-segment/te:label-restrictions/te:label-restriction/otnt:otn-label-range"). Unauthorized access to this data node can disclose the state information of OTN tunnels and LSPs.
  • "otnt:otn-label"
  • This subtree specifies the configurations of OTN technology-specific label information under any occurrence of the tet:te-label container, as defined in (e.g., "/te:te/te:tunnels/te:tunnel/te:primary-paths/te:primary-path/te:explicit-route-objects/te:route-object-include-exclude/te:type/te:label/te:label-hop/te:te-label/te:technology/otnt:otn/otnt:otn-label"). Unauthorized access to this data node can disclose the state information of OTN tunnels and LSPs.
This YANG module does not define RPC operations. This YANG module uses groupings from other YANG modules that define nodes that may be considered sensitive or vulnerable in network environments. Refer to the Security Considerations of for information as to which nodes may be considered sensitive or vulnerable in network environments. Finally, the YANG module described in this document augments the "ietf-te" YANG module by adding data nodes. The security considerations for the subtrees described in those RFCs apply equally to the new data nodes that this module adds.
References Normative References Interfaces for the optical transport network ITU-T Recommendation G.709 A YANG Data Model for Traffic Engineering Tunnels, Label Switched Paths, and Interfaces Cisco Systems Inc Cisco Systems Inc Alef Edge Juniper Networks Individual This document defines a YANG data model for the provisioning and management of Traffic Engineering (TE) tunnels, Label Switched Paths (LSPs), and interfaces. The model covers data pertinent to TE tunnels, TE LSPs, and TE interfaces that are independent of any technology or dataplane encapsulation. The model is divided into two YANG modules that address both device-specific and device-independent data, supporting configuration, operational state, Remote Procedure Calls (RPCs), and event notifications. Common YANG Data Types for Layer 1 Networks Huawei Technologies Huawei Technologies This document defines a collection of common data types, identities, and groupings in the YANG data modeling language. These derived common data types, identities, and groupings are intended to be imported by modules that model Layer 1 configuration and state capabilities. The Layer 1 types are representative of Layer 1 client signals applicable to transport networks, such as Optical Transport Networks (OTN). The Optical Transport Network (OTN) data structures are included in this document as Layer 1 types. A YANG Data Model for Optical Transport Network Topology Huawei Technologies Huawei Technologies Individual Nokia Telefonica This document defines a YANG data model for representing, retrieving, and manipulating Optical Transport Network (OTN) topologies. It is independent of control plane protocols and captures topological and resource-related information pertaining to OTN. The YANG 1.1 Data Modeling Language YANG is a data modeling language used to model configuration data, state data, Remote Procedure Calls, and notifications for network management protocols. This document describes the syntax and semantics of version 1.1 of the YANG language. YANG version 1.1 is a maintenance release of the YANG language, addressing ambiguities and defects in the original specification. There are a small number of backward incompatibilities from YANG version 1. This document also specifies the YANG mappings to the Network Configuration Protocol (NETCONF). Network Configuration Protocol (NETCONF) The Network Configuration Protocol (NETCONF) defined in this document provides mechanisms to install, manipulate, and delete the configuration of network devices. It uses an Extensible Markup Language (XML)-based data encoding for the configuration data as well as the protocol messages. The NETCONF protocol operations are realized as remote procedure calls (RPCs). This document obsoletes RFC 4741. [STANDARDS-TRACK] GMPLS Signaling Extensions for Control of Evolving G.709 Optical Transport Networks ITU-T Recommendation G.709 [G709-2012] introduced new Optical channel Data Unit (ODU) containers (ODU0, ODU4, ODU2e, and ODUflex) and enhanced Optical Transport Network (OTN) flexibility. This document updates the ODU-related portions of RFC 4328 to provide extensions to GMPLS signaling to control the full set of OTN features, including ODU0, ODU4, ODU2e, and ODUflex. YANG - A Data Modeling Language for the Network Configuration Protocol (NETCONF) YANG is a data modeling language used to model configuration and state data manipulated by the Network Configuration Protocol (NETCONF), NETCONF remote procedure calls, and NETCONF notifications. [STANDARDS-TRACK] Network Configuration Access Control Model The standardization of network configuration interfaces for use with the Network Configuration Protocol (NETCONF) or the RESTCONF protocol requires a structured and secure operating environment that promotes human usability and multi-vendor interoperability. There is a need for standard mechanisms to restrict NETCONF or RESTCONF protocol access for particular users to a preconfigured subset of all available NETCONF or RESTCONF protocol operations and content. This document defines such an access control model. This document obsoletes RFC 6536. Informative References YANG Tree Diagrams This document captures the current syntax used in YANG module tree diagrams. The purpose of this document is to provide a single location for this definition. This syntax may be updated from time to time based on the evolution of the YANG language. Transport Northbound Interface Applicability Statement Huawei Old Dog Consulting Huawei CAICT This document provides an analysis of the applicability of the YANG models defined by the IETF (in particular in the Traffic Engineering Architecture and Signaling (TEAS) and Common Control and Measurement Plane (CCAMP) working groups) to support ODU transit services, transparent client services, and Ethernet Private Line/Ethernet Virtual Private Line (EPL/EVPL) services over Optical Transport Network (OTN) in single and multi-domain network scenarios. This document also describes how existing YANG models can be used through several worked examples and JSON fragments. Applicability of YANG models for Abstraction and Control of Traffic Engineered Networks Samsung Huawei Cisco ETRI Nokia Abstraction and Control of TE Networks (ACTN) refers to the set of virtual network operations needed to orchestrate, control and manage large-scale multi-domain TE networks, so as to facilitate network programmability, automation, efficient resource sharing, and end-to- end virtual service aware connectivity and network function virtualization services. This document explains how the different types of YANG models defined in the Operations and Management Area and in the Routing Area are applicable to the ACTN framework. This document also shows how the ACTN architecture can be satisfied using classes of data model that have already been defined, and discusses the applicability of specific data models that are under development. It also highlights where new data models may need to be developed. The IETF XML Registry This document describes an IANA maintained registry for IETF standards which use Extensible Markup Language (XML) related items such as Namespaces, Document Type Declarations (DTDs), Schemas, and Resource Description Framework (RDF) Schemas. Guidelines for Authors and Reviewers of Documents Containing YANG Data Models This document provides guidelines for authors and reviewers of specifications containing YANG data models, including IANA-maintained YANG modules. Recommendations and procedures are defined, which are intended to increase interoperability and usability of Network Configuration Protocol (NETCONF) and RESTCONF protocol implementations that utilize YANG modules. This document obsoletes RFC 8407; it also updates RFC 8126 by providing additional guidelines for writing the IANA considerations for RFCs that specify IANA-maintained YANG modules. RESTCONF Protocol This document describes an HTTP-based protocol that provides a programmatic interface for accessing data defined in YANG, using the datastore concepts defined in the Network Configuration Protocol (NETCONF). The Secure Shell (SSH) Authentication Protocol The Secure Shell Protocol (SSH) is a protocol for secure remote login and other secure network services over an insecure network. This document describes the SSH authentication protocol framework and public key, password, and host-based client authentication methods. Additional authentication methods are described in separate documents. The SSH authentication protocol runs on top of the SSH transport layer protocol and provides a single authenticated tunnel for the SSH connection protocol. [STANDARDS-TRACK] The Transport Layer Security (TLS) Protocol Version 1.3 This document specifies version 1.3 of the Transport Layer Security (TLS) protocol. TLS allows client/server applications to communicate over the Internet in a way that is designed to prevent eavesdropping, tampering, and message forgery. This document updates RFCs 5705 and 6066, and obsoletes RFCs 5077, 5246, and 6961. This document also specifies new requirements for TLS 1.2 implementations. QUIC: A UDP-Based Multiplexed and Secure Transport This document defines the core of the QUIC transport protocol. QUIC provides applications with flow-controlled streams for structured communication, low-latency connection establishment, and network path migration. QUIC includes security measures that ensure confidentiality, integrity, and availability in a range of deployment circumstances. Accompanying documents describe the integration of TLS for key negotiation, loss detection, and an exemplary congestion control algorithm. JSON Encoding of Data Modeled with YANG This document defines encoding rules for representing configuration data, state data, parameters of Remote Procedure Call (RPC) operations or actions, and notifications defined using YANG as JavaScript Object Notation (JSON) text.
OTN Tunnel YANG Tree This appendix presents the complete tree of the YANG data model defined in module "ietf-otn-tunnel.yang", defined in . See for an explanation of the symbols used.
JSON Examples This appendix contains an example of an instance data tree in JSON encoding . The example instantiates the "ietf-otn-tunnel" model to setup an protected ODU2 tunnel between nodes D1 and D2 within the OTN topology shown in Figure 2 of . The protected ODU2 tunnel has a primary LSP, instatiating the D1-D2 primary TE and a secondary LSP, instantiating the D1-D3-D2 secondary TE path.
Acknowledgments The authors would like to thank Yu Chaode for his comments and discussions during the development of this document. The authors would like to thank Radek Krejci for his YANG Doctor eview. The authors would like to thank Dhruv Dhody for his Routing Area Directorate review.
Contributors Futurewei
aihuaguo.ietf@gmail.com
Google
ansha@google.com
Infinera
rrao@infinera.com
China Mobile
liyunbo@chinamobile.com
Nokia
dieter.beller@nokia.com
China Unicom
zhengyanlei@chinaunicom.cn
Huawei Technologies
Huawei Technologies
China Mobile
wangleiyj@chinamobile.com
Telefonica
oscar.gonzalezdedios@telefonica.com