idnits 2.17.1 draft-ietf-ccamp-layer0-types-08.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- No issues found here. Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the IETF Trust and authors Copyright Line does not match the current year -- The document date (October 16, 2020) is 1288 days in the past. Is this intentional? Checking references for intended status: Proposed Standard ---------------------------------------------------------------------------- (See RFCs 3967 and 4897 for information about using normative references to lower-maturity documents in RFCs) == Missing Reference: 'RFCXXXX' is mentioned on line 112, but not defined == Unused Reference: 'RFC4203' is defined on line 840, but no explicit reference was found in the text == Unused Reference: 'RFC7699' is defined on line 854, but no explicit reference was found in the text == Unused Reference: 'ITU-Tg6942' is defined on line 888, but no explicit reference was found in the text == Unused Reference: 'ITU-Tg709' is defined on line 899, but no explicit reference was found in the text Summary: 0 errors (**), 0 flaws (~~), 6 warnings (==), 1 comment (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 CCAMP Working Group H. Zheng 3 Internet-Draft Huawei Technologies 4 Intended status: Standards Track Y. Lee 5 Expires: April 19, 2021 Samsung 6 A. Guo 7 Futurewei 8 V. Lopez 9 Telefonica 10 D. King 11 University of Lancaster 12 October 16, 2020 14 A YANG Data Model for Layer 0 Types 15 draft-ietf-ccamp-layer0-types-08 17 Abstract 19 This document defines a collection of common data types and groupings 20 in the YANG data modeling language. These derived common types and 21 groupings are intended to be imported by modules that model Layer 0 22 optical Traffic Engineering (TE) configuration and state capabilities 23 such as Wavelength Switched Optical Networks (WSONs) and Flexi-grid 24 Dense Wavelength Division Multiplexing (DWDM) Networks. 26 Status of This Memo 28 This Internet-Draft is submitted in full conformance with the 29 provisions of BCP 78 and BCP 79. 31 Internet-Drafts are working documents of the Internet Engineering 32 Task Force (IETF). Note that other groups may also distribute 33 working documents as Internet-Drafts. The list of current Internet- 34 Drafts is at https://datatracker.ietf.org/drafts/current/. 36 Internet-Drafts are draft documents valid for a maximum of six months 37 and may be updated, replaced, or obsoleted by other documents at any 38 time. It is inappropriate to use Internet-Drafts as reference 39 material or to cite them other than as "work in progress." 41 This Internet-Draft will expire on April 19, 2021. 43 Copyright Notice 45 Copyright (c) 2020 IETF Trust and the persons identified as the 46 document authors. All rights reserved. 48 This document is subject to BCP 78 and the IETF Trust's Legal 49 Provisions Relating to IETF Documents 50 (https://trustee.ietf.org/license-info) in effect on the date of 51 publication of this document. Please review these documents 52 carefully, as they describe your rights and restrictions with respect 53 to this document. Code Components extracted from this document must 54 include Simplified BSD License text as described in Section 4.e of 55 the Trust Legal Provisions and are provided without warranty as 56 described in the Simplified BSD License. 58 Table of Contents 60 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2 61 1.1. Terminology and Notations . . . . . . . . . . . . . . . . 3 62 1.2. Prefix in Data Node Names . . . . . . . . . . . . . . . . 3 63 2. Layer 0 Types Module Contents . . . . . . . . . . . . . . . . 3 64 3. YANG Code for Layer 0 Types . . . . . . . . . . . . . . . . . 5 65 4. Security Considerations . . . . . . . . . . . . . . . . . . . 17 66 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 17 67 6. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 18 68 7. Contributors . . . . . . . . . . . . . . . . . . . . . . . . 18 69 8. References . . . . . . . . . . . . . . . . . . . . . . . . . 18 70 8.1. Normative References . . . . . . . . . . . . . . . . . . 18 71 8.2. Informative References . . . . . . . . . . . . . . . . . 19 72 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 21 74 1. Introduction 76 YANG [RFC7950] is a data modeling language used to model 77 configuration data, state data, Remote Procedure Calls, and 78 notifications for network management protocols such as NETCONF 79 [RFC6241]. The YANG language supports a small set of built-in data 80 types and provides mechanisms to derive other types from the built-in 81 types. 83 This document introduces a collection of common data types derived 84 from the built-in YANG data types. The derived types and groupings 85 are designed to be the common types applicable for modeling Traffic 86 Engineering (TE) features as well as non-TE features (e.g., physical 87 network configuration aspect) for Layer 0 optical networks in 88 model(s) defined outside of this document. The applicability of 89 Layer 0 types specified in this document include Wavelength Switched 90 Optical Networks (WSONs) [RFC6163] and [ITU-Tg6982], and Flexi-grid 91 Dense Wavelength Division Multiplexing (DWDM) Networks [RFC7698] and 92 [ITU-Tg6941] . 94 1.1. Terminology and Notations 96 Refer to [RFC7446] and [RFC7581] for the key terms used in this 97 document, and the terminology for describing YANG data models can be 98 found in [RFC7950]. 100 The YANG data model in this document conforms to the Network 101 Management Datastore Architecture defined in [RFC8342]. 103 1.2. Prefix in Data Node Names 105 In this document, names of data nodes and other data model objects 106 are prefixed using the standard prefix associated with the 107 corresponding YANG imported modules. 109 +-------------+---------------------------+----------------------+ 110 | Prefix | YANG module | Reference | 111 +-------------+---------------------------+----------------------+ 112 | l0-types | ietf-layer0-types | [RFCXXXX] | 113 +-------------+---------------------------+----------------------+ 115 Note: The RFC Editor will replace XXXX with the number assigned to 116 the RFC once this document becomes an RFC. 118 YANG module ietf-layer0-types (defined in Section 3) references 119 [RFC6163], [RFC7205], and [RFC7698]. 121 2. Layer 0 Types Module Contents 123 This document defines YANG module for common Layer 0 types, ietf- 124 layer0-types. This module is used for WSON and Flexi-grid DWDM 125 networks. The ietf-layer0-types module contains the following YANG 126 reusable types and groupings: 128 l0-grid-type: 130 A base YANG identity for the grid type as defined in [RFC6163] and 131 [RFC7698]. 133 dwdm-ch-spc-type: 135 A base YANG identity for the DWDM channel spacing type as defined in 136 [RFC6205]. 138 cwdm-ch-spc-type: 140 A base YANG identity for the CWDM channel spacing type as defined in 141 [RFC6205]. 143 wson-label-start-end: 145 A YANG grouping that defines the label-start or label-end to specify 146 WSON label range as defined in [RFC6205]. 148 wson-label-hop: 150 A YANG grouping that defines the label hop for WSON as defined in 151 [RFC6205]. 153 l0-label-range-info: 155 A YANG grouping that defines the layer 0 label range information 156 applicable for both WSON per priority level as defined in [RFC6205]. 157 This grouping is used in the flexi-grid DWDM by adding more flexi- 158 grid-specific parameters. 160 wson-label-step: 162 A YANG grouping that defines label steps for WSON as defined in 163 [RFC8776]. 165 flexi-grid-label-start-end: 167 A YANG grouping that defines the label-start or label-end to specify 168 flexi-grid label range as defined in [RFC7698]. 170 flexi-grid-label-hop: 172 A YANG grouping that defines the label hop for both single channel 173 and multiple carriers in flexi-grid DWDM, as defined in [RFC7698]. 175 flexi-grid-label-range-info: 177 A YANG grouping that defines flexi-grid label range information and 178 per priority level as defined in [RFC7698] and [RFC8363]. 180 flexi-grid-label-step: 182 A YANG grouping that defines flexi-grid label steps as defined in 183 [RFC8776]. 185 3. YANG Code for Layer 0 Types 187 file "ietf-layer0-types@2020-10-16.yang" 188 module ietf-layer0-types { 189 yang-version 1.1; 190 namespace "urn:ietf:params:xml:ns:yang:ietf-layer0-types"; 192 prefix "l0-types"; 194 organization 195 "IETF CCAMP Working Group"; 196 contact 197 "WG Web: 198 WG List: 200 Editor: Haomian Zheng 201 203 Editor: Young Lee 204 206 Editor: Aihua Guo 207 209 Editor: Victor Lopez 210 212 Editor: Daniel King 213 "; 215 description 216 "This module defines Optical Layer 0 types. This module 217 provides groupings that can be applicable to Layer 0 218 Fixed Optical Networks (e.g., CWDM (Coarse Wavelength 219 Division Multiplexing) and DWDM (Dense Wavelength Division 220 Multiplexing)) and Flexi-grid Optical Networks. 222 Copyright (c) 2020 IETF Trust and the persons identified 223 as authors of the code. All rights reserved. 225 Redistribution and use in source and binary forms, with 226 or without modification, is permitted pursuant to, and 227 subject to the license terms contained in, the Simplified 228 BSD License set forth in Section 4.c of the IETF Trust's 229 Legal Provisions Relating to IETF Documents 230 (http://trustee.ietf.org/license-info). 231 This version of this YANG module is part of RFC XXXX; see 232 the RFC itself for full legal notices."; 234 revision "2020-10-16" { 235 description 236 "Initial Version"; 237 reference 238 "RFC XXXX: A YANG Data Model for Layer 0 Types"; 239 } 241 typedef dwdm-n { 242 type int16; 243 description 244 "The given value 'N' is used to determine the nominal 245 central frequency. 247 The nominal central frequency, 'f' is defined by: 248 f = 193100.000 GHz + N x channel-spacing (measured in GHz) 249 where 193100.000 GHz (193.100000 THz) is the ITU-T 'anchor 250 frequency' for transmission over the C band; and 251 where 'channel-spacing' is defined by the dwdm-ch-spc-type."; 252 reference 253 "RFC6205: Generalized Labels for 254 Lambda-Switch-Capable (LSC) Label Switching Routers, 255 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 256 DWDM frequency grid"; 257 } 259 typedef cwdm-n { 260 type int16; 261 description 262 "The given value 'N' is used to determine the nominal 263 central wavelength. 265 The nominal central wavelength is defined by: 266 Wavelength = 1471 nm + N x channel-spacing (measured in nm) 267 where 1471 nm is the ITU-T 'anchor wavelength' for 268 transmission over the C band; and 269 where 'channel-spacing' is defined by the cwdm-ch-spc-type."; 270 reference 271 "RFC6205: Generalized Labels for 272 Lambda-Switch-Capable (LSC) Label Switching Routers, 273 ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: 274 CWDM wavelength grid"; 275 } 277 typedef flexi-n { 278 type int16; 279 description 280 "The given value 'N' is used to determine the nominal 281 central frequency. 283 The nominal central frequency, 'f' is defined by, 284 f = 193100.000 GHz + N x channel-spacing (measured in GHz), 285 where 193100.000 GHz (193.100000 THz) is the ITU-T 'anchor 286 frequency' for transmission over the C band; and 287 where 'channel-spacing' is defined by the flexi-ch-spc-type. 289 Note that the term 'channel-spacing' can be alternated by the 290 term 'nominal central frequency granularity' defined in 291 clause 7 of ITU-T G.694.1."; 292 reference 293 "RFC7698: Framework and Requirements for GMPLS-Based Control 294 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 295 Networks. 296 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 297 DWDM frequency grid"; 298 } 300 typedef flexi-m { 301 type uint16; 302 description 303 "The given value 'M' is used to determine the slot width. 305 A slot width is defined by: 306 slot width = M x SWG (measured in GHz), 307 where SWG is defined by the flexi-slot-width-granularity."; 308 reference 309 "RFC7698: Framework and Requirements for GMPLS-Based Control 310 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 311 Networks. 312 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 313 DWDM frequency grid"; 314 } 316 identity l0-grid-type { 317 description 318 "Layer 0 grid type"; 319 reference 320 "RFC6163:Framework for GMPLS and Path Computation Element 321 (PCE) Control of Wavelength Switched Optical Networks (WSONs), 322 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 323 DWDM frequency grid, 324 ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: 325 CWDM wavelength grid"; 326 } 327 identity flexi-grid-dwdm { 328 base l0-grid-type; 329 description 330 "Flexi-grid"; 331 reference 332 "RFC7698: Framework and Requirements for GMPLS-Based Control 333 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 334 Networks, 335 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 336 DWDM frequency grid"; 337 } 339 identity wson-grid-dwdm { 340 base l0-grid-type; 341 description 342 "DWDM grid"; 343 reference 344 "RFC6163:Framework for GMPLS and Path Computation Element 345 (PCE) Control of Wavelength Switched Optical Networks (WSONs), 346 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 347 DWDM frequency grid"; 348 } 350 identity wson-grid-cwdm { 351 base l0-grid-type; 352 description 353 "CWDM grid"; 354 reference 355 "RFC6205: Generalized Labels for 356 Lambda-Switch-Capable (LSC) Label Switching Routers, 357 ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: 358 CWDM wavelength grid"; 359 } 361 identity dwdm-ch-spc-type { 362 description 363 "DWDM channel spacing type"; 364 reference 365 "RFC6205: Generalized Labels for 366 Lambda-Switch-Capable (LSC) Label Switching Routers, 367 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 368 DWDM frequency grid"; 369 } 371 identity dwdm-100ghz { 372 base dwdm-ch-spc-type; 373 description 374 "100GHz channel spacing"; 376 } 378 identity dwdm-50ghz { 379 base dwdm-ch-spc-type; 380 description 381 "50GHz channel spacing"; 382 } 384 identity dwdm-25ghz { 385 base dwdm-ch-spc-type; 386 description 387 "25GHz channel spacing"; 388 } 390 identity dwdm-12p5ghz { 391 base dwdm-ch-spc-type; 392 description 393 "12.5GHz channel spacing"; 394 } 396 identity flexi-ch-spc-type { 397 description 398 "Flexi-grid channel spacing type"; 399 reference 400 "RFC7698: Framework and Requirements for GMPLS-Based Control 401 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 402 Networks 403 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 404 DWDM frequency grid"; 405 } 407 identity flexi-ch-spc-6p25ghz { 408 base flexi-ch-spc-type; 409 description 410 "6.25GHz channel spacing"; 411 } 413 identity flexi-slot-width-granularity { 414 description 415 "Flexi-grid slot width granularity"; 416 } 418 identity flexi-swg-12p5ghz { 419 base flexi-slot-width-granularity; 420 description 421 "12.5GHz slot width granularity"; 422 } 423 identity cwdm-ch-spc-type { 424 description 425 "CWDM channel spacing type"; 426 reference 427 "RFC6205: Generalized Labels for 428 Lambda-Switch-Capable (LSC) Label Switching Routers, 429 ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: 430 CWDM wavelength grid"; 431 } 433 identity cwdm-20nm { 434 base cwdm-ch-spc-type; 435 description 436 "20nm channel spacing"; 437 } 439 /* Groupings. */ 441 grouping wson-label-start-end { 442 description 443 "The WSON label-start or label-end used to 444 specify WSON label range."; 445 choice grid-type { 446 description 447 "Label for DWDM or CWDM grid"; 448 case dwdm { 449 leaf dwdm-n { 450 when 'derived-from-or-self(../../../grid-type, 451 "wson-grid-dwdm")' 452 { 453 description 454 "Valid only when grid type is DWDM."; 455 } 456 type l0-types:dwdm-n; 457 description 458 "The central frequency of DWDM. "; 459 reference 460 "RFC6205: Generalized Labels for 461 Lambda-Switch-Capable (LSC) Label Switching Routers"; 462 } 463 } 464 case cwdm { 465 leaf cwdm-n { 466 when 'derived-from-or-self(../../../grid-type, 467 "wson-grid-cwdm")' 468 { 469 description 470 "Valid only when grid type is CWDM."; 472 } 473 type l0-types:cwdm-n; 474 description 475 "Channel wavelength computing input. "; 476 reference 477 "RFC6205: Generalized Labels for 478 Lambda-Switch-Capable (LSC) Label Switching Routers"; 479 } 480 } 481 } 482 reference 483 "RFC6205: Generalized Labels for 484 Lambda-Switch-Capable (LSC) Label Switching Routers"; 485 } 487 grouping wson-label-hop { 488 description 489 "Generic label hop information for WSON"; 490 choice grid-type { 491 description 492 "Label for DWDM or CWDM grid"; 493 case dwdm { 494 choice single-or-super-channel { 495 description "single or super channel"; 496 case single { 497 leaf dwdm-n { 498 type l0-types:dwdm-n; 499 description 500 "The given value 'N' is used to determine the 501 nominal central frequency."; 502 } 503 } 504 case super { 505 leaf-list subcarrier-dwdm-n { 506 type l0-types:dwdm-n; 507 description 508 "The given values 'N' are used to determine the 509 nominal central frequency for each subcarrier 510 channels."; 511 reference 512 "ITU-T Recommendation G.694.1: Spectral grids for 513 WDM applications: DWDM frequency grid"; 514 } 515 } 516 } 517 } 518 case cwdm { 519 leaf cwdm-n { 520 type l0-types:cwdm-n; 521 description 522 "The given value 'N' is used to determine the nominal 523 central wavelength."; 524 reference 525 "RFC6205: Generalized Labels for 526 Lambda-Switch-Capable (LSC) Label Switching Routers"; 527 } 528 } 529 } 530 reference 531 "RFC6205: Generalized Labels for 532 Lambda-Switch-Capable (LSC) Label Switching Routers"; 533 } 535 grouping l0-label-range-info { 536 description 537 "Information for layer 0 label range."; 538 leaf grid-type { 539 type identityref { 540 base l0-grid-type; 541 } 542 description "Grid type"; 543 } 544 leaf priority { 545 type uint8; 546 description 547 "Priority in Interface Switching Capability 548 Descriptor (ISCD)."; 549 reference 550 "RFC4203: OSPF Extensions in Support of Generalized 551 Multi-Protocol Label Switching (GMPLS)."; 552 } 553 reference 554 "RFC6205: Generalized Labels for 555 Lambda-Switch-Capable (LSC) Label Switching Routers"; 556 } 558 grouping wson-label-step { 559 description "Label step information for WSON"; 560 choice l0-grid-type { 561 description 562 "Grid type: DWDM, CWDM, etc."; 563 case dwdm { 564 leaf wson-dwdm-channel-spacing { 565 when 'derived-from-or-self(../../grid-type, 566 "wson-grid-dwdm")' 567 { 568 description 569 "Valid only when grid type is DWDM."; 570 } 571 type identityref { 572 base dwdm-ch-spc-type; 573 } 574 description 575 "Label-step is the channel-spacing (GHz), e.g., 576 100.000, 50.000, 25.000, or 12.500 GHz for DWDM"; 577 reference 578 "RFC6205: Generalized Labels for 579 Lambda-Switch-Capable (LSC) Label Switching Routers"; 580 } 581 } 582 case cwdm { 583 leaf wson-cwdm-channel-spacing { 584 when 'derived-from-or-self(../../grid-type, 585 "wson-grid-cwdm")' 586 { 587 description 588 "Valid only when grid type is CWDM."; 589 } 590 type identityref { 591 base cwdm-ch-spc-type; 592 } 593 description 594 "Label-step is the channel-spacing (nm), i.e., 20 nm 595 for CWDM, which is the only value defined for CWDM"; 596 reference 597 "RFC6205: Generalized Labels for 598 Lambda-Switch-Capable (LSC) Label Switching Routers"; 599 } 600 } 601 } 602 reference 603 "RFC6205: Generalized Labels for 604 Lambda-Switch-Capable (LSC) Label Switching Routers 605 ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: 606 CWDM wavelength grid"; 607 } 609 grouping flexi-grid-label-start-end { 610 description 611 "The Flexi-grid label-start or label-end used to 612 specify Flexi-grid label range."; 613 leaf flexi-n { 614 type l0-types:flexi-n; 615 description 616 "The given value 'N' is used to determine the nominal 617 central frequency."; 618 } 619 reference 620 "RFC7698: Framework and Requirements for GMPLS-Based Control 621 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 622 Networks"; 623 } 625 grouping flexi-grid-frequency-slot { 626 description "Flexi-grid frequency slot grouping."; 627 uses flexi-grid-label-start-end; 628 leaf flexi-m { 629 type l0-types:flexi-m; 630 description 631 "The given value 'M' is used to determine the slot width."; 632 } 633 reference 634 "RFC7698: Framework and Requirements for GMPLS-Based Control 635 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 636 Networks"; 637 } 639 grouping flexi-grid-label-hop { 640 description 641 "Generic label hop information for Flexi-grid"; 643 choice single-or-super-channel { 644 description "single or super channel"; 645 case single { 646 uses flexi-grid-frequency-slot; 647 } 648 case super { 649 list subcarrier-flexi-n { 650 key flexi-n; 651 uses flexi-grid-frequency-slot; 652 description 653 "List of subcarrier channels for flexi-grid 654 super channel."; 655 } 656 } 657 } 658 reference 659 "RFC7698: Framework and Requirements for GMPLS-Based Control 660 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 661 Networks"; 662 } 663 grouping flexi-grid-label-range-info { 664 description 665 "Info of Flexi-grid-specific label range"; 666 uses l0-label-range-info; 667 container flexi-grid { 668 description "flexi-grid definition"; 669 leaf slot-width-granularity { 670 type identityref { 671 base flexi-slot-width-granularity; 672 } 673 default flexi-swg-12p5ghz; 674 description 675 "Minimum space between slot widths. Default is 676 12.500 GHz"; 677 reference 678 "RFC7698: Framework and Requirements for GMPLS-Based 679 Control of Flexi-Grid Dense Wavelength Division 680 Multiplexing (DWDM) Networks"; 681 } 682 leaf min-slot-width-factor { 683 type uint16 { 684 range "1..max"; 685 } 686 default 1; 687 description 688 "Slot width range: two multipliers of the slot width , 689 granularity, each indicating the minimal and maximal slot 690 width supported by a port, respectively. 692 Minimum slot width is calculated by: 693 Minimum slot width (GHz) = 694 min-slot-width-factor * slot-width-granularity. 695 Minimum slot width should be smaller than or equal to 696 Maximum slot width. "; 697 reference 698 "RFC8363: GMPLS OSPF-TE Extensions in Support of Flexi-Grid 699 Dense Wavelength Division Multiplexing (DWDM) Networks"; 700 } 702 leaf max-slot-width-factor { 703 type uint16 { 704 range "1..max"; 705 } 706 description 707 "Slot width range: two multipliers of the slot width , 708 granularity, each indicating the minimal and maximal slot 709 width supported by a port, respectively. 711 Maximum slot width is calculated by: 712 Maximum slot width (GHz) = 713 max-slot-width-factor * slot-width-granularity 714 Maximum slot width should be bigger than or equal to 715 Minimum slot width. "; 716 reference 717 "RFC8363: GMPLS OSPF-TE Extensions in Support of Flexi-Grid 718 Dense Wavelength Division Multiplexing (DWDM) Networks"; 719 } 720 } 721 } 723 grouping flexi-grid-label-step { 724 description "Label step information for flexi-grid"; 725 leaf flexi-grid-channel-spacing { 726 type identityref { 727 base flexi-ch-spc-type; 728 } 729 default flexi-ch-spc-6p25ghz; 730 description 731 "Label-step is the nominal central frequency 732 granularity (GHz), e.g., 6.25 GHz"; 733 reference 734 "RFC7699: Generalized Labels for the Flexi-Grid in 735 Lambda Switch Capable (LSC) Label Switching Routers"; 736 } 737 leaf flexi-n-step { 738 type uint8; 739 description 740 "This attribute defines the multiplier for the supported 741 values of 'N'. 743 For example, given a grid with a nominal central frequency 744 granularity of 6.25 GHz, the granularity of the supported 745 values of the nominal central frequency could be 12.5 GHz. 746 In this case, the values of flexi-n should be even and this 747 constraints is reported by setting the flexi-n-step to 2. 749 This attribute is also known as central frequency 750 granularity in RFC8363."; 751 reference 752 "RFC8363: GMPLS OSPF-TE Extensions in Support of Flexi-Grid 753 Dense Wavelength Division Multiplexing (DWDM) Networks"; 754 } 755 } 756 } 758 760 4. Security Considerations 762 The YANG module specified in this document defines a schema for data 763 that is designed to be accessed via network management protocols such 764 as NETCONF [RFC6241] or RESTCONF [RFC8040]. The lowest NETCONF layer 765 is the secure transport layer, and the mandatory-to-implement secure 766 transport is Secure Shell (SSH) [RFC6242]. The lowest RESTCONF layer 767 is HTTPS, and the mandatory-to-implement secure transport is TLS 768 [RFC8446]. 770 The NETCONF access control model [RFC8341] provides the means to 771 restrict access for particular NETCONF users to a preconfigured 772 subset of all available NETCONF protocol operations and content. The 773 NETCONF Protocol over Secure Shell (SSH) [RFC6242] describes a method 774 for invoking and running NETCONF within a Secure Shell (SSH) session 775 as an SSH subsystem. The NETCONF access control model [RFC8341] 776 provides the means to restrict access for particular NETCONF or 777 RESTCONF users to a preconfigured subset of all available NETCONF or 778 RESTCONF protocol operations and content. 780 The objects in this YANG module are common data types and groupings. 781 No object in this module can be read or written to. These 782 definitions can be imported and used by other layer 0 specific 783 modules. It is critical consider how imported definitions will be 784 utilized and accessible via RPC operations, as the resultant schema 785 will have data nodes that can be writable, or readable, and will have 786 a significant effect on the network operations if used incorrectly or 787 maliciously. All of this consideration belongs in the document that 788 defines the modules that import from this YANG module. Therefore, it 789 is important to manage access to resultant data nodes that are 790 considered sensitive or vulnerable in some network environments. 792 The security considerations spelled out in the YANG 1.1 specification 793 [RFC7950] apply for this document as well. 795 5. IANA Considerations 797 It is proposed to IANA to assign new URIs from the "IETF XML 798 Registry" [RFC3688] as follows: 800 URI: urn:ietf:params:xml:ns:yang:ietf-layer0-types 801 Registrant Contact: The IESG 802 XML: N/A; the requested URI is an XML namespace. 804 This document registers following YANG modules in the YANG Module 805 Names registry [RFC7950]. 807 name: ietf-layer0-types 808 namespace: urn:ietf:params:xml:ns:yang:ietf-layer0-types 809 prefix: l0-types 810 reference: RFC XXXX(TBD) 812 6. Acknowledgements 814 The authors and the working group give their sincere thanks for 815 Robert Wilton for the YANG doctor review, and Tom Petch for his 816 comments during the model and document development. 818 7. Contributors 820 Dhruv Dhody 821 Huawei 822 Email: dhruv.ietf@gmail.com 824 Bin Yeong Yoon 825 ETRI 826 Email: byyun@etri.re.kr 828 Ricard Vilalta 829 CTTC 830 Email: ricard.vilalta@cttc.es 832 Italo Busi 833 Huawei 834 Email: Italo.Busi@huawei.com 836 8. References 838 8.1. Normative References 840 [RFC4203] Kompella, K., Ed. and Y. Rekhter, Ed., "OSPF Extensions in 841 Support of Generalized Multi-Protocol Label Switching 842 (GMPLS)", RFC 4203, DOI 10.17487/RFC4203, October 2005, 843 . 845 [RFC6241] Enns, R., Ed., Bjorklund, M., Ed., Schoenwaelder, J., Ed., 846 and A. Bierman, Ed., "Network Configuration Protocol 847 (NETCONF)", RFC 6241, DOI 10.17487/RFC6241, June 2011, 848 . 850 [RFC6242] Wasserman, M., "Using the NETCONF Protocol over Secure 851 Shell (SSH)", RFC 6242, DOI 10.17487/RFC6242, June 2011, 852 . 854 [RFC7699] Farrel, A., King, D., Li, Y., and F. Zhang, "Generalized 855 Labels for the Flexi-Grid in Lambda Switch Capable (LSC) 856 Label Switching Routers", RFC 7699, DOI 10.17487/RFC7699, 857 November 2015, . 859 [RFC7950] Bjorklund, M., Ed., "The YANG 1.1 Data Modeling Language", 860 RFC 7950, DOI 10.17487/RFC7950, August 2016, 861 . 863 [RFC8040] Bierman, A., Bjorklund, M., and K. Watsen, "RESTCONF 864 Protocol", RFC 8040, DOI 10.17487/RFC8040, January 2017, 865 . 867 [RFC8341] Bierman, A. and M. Bjorklund, "Network Configuration 868 Access Control Model", STD 91, RFC 8341, 869 DOI 10.17487/RFC8341, March 2018, 870 . 872 [RFC8342] Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K., 873 and R. Wilton, "Network Management Datastore Architecture 874 (NMDA)", RFC 8342, DOI 10.17487/RFC8342, March 2018, 875 . 877 [RFC8446] Rescorla, E., "The Transport Layer Security (TLS) Protocol 878 Version 1.3", RFC 8446, DOI 10.17487/RFC8446, August 2018, 879 . 881 8.2. Informative References 883 [ITU-Tg6941] 884 International Telecommunication Union, "Spectral grids for 885 WDM applications: DWDM frequency grid", ITU-T G.694.1, 886 February 2012. 888 [ITU-Tg6942] 889 International Telecommunication Union, "Spectral grids for 890 WDM applications: CWDM wavelength grid", ITU-T G.694.2, 891 December 2003. 893 [ITU-Tg6982] 894 International Telecommunication Union, "Amplified 895 multichannel dense wavelength division multiplexing 896 applications with single channel optical interfaces", 897 ITU-T G.698.2, November 2018. 899 [ITU-Tg709] 900 International Telecommunication Union, "Interfaces for the 901 optical transport network", ITU-T G.709, June 2016. 903 [RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, 904 DOI 10.17487/RFC3688, January 2004, 905 . 907 [RFC6163] Lee, Y., Ed., Bernstein, G., Ed., and W. Imajuku, 908 "Framework for GMPLS and Path Computation Element (PCE) 909 Control of Wavelength Switched Optical Networks (WSONs)", 910 RFC 6163, DOI 10.17487/RFC6163, April 2011, 911 . 913 [RFC6205] Otani, T., Ed. and D. Li, Ed., "Generalized Labels for 914 Lambda-Switch-Capable (LSC) Label Switching Routers", 915 RFC 6205, DOI 10.17487/RFC6205, March 2011, 916 . 918 [RFC7205] Romanow, A., Botzko, S., Duckworth, M., and R. Even, Ed., 919 "Use Cases for Telepresence Multistreams", RFC 7205, 920 DOI 10.17487/RFC7205, April 2014, 921 . 923 [RFC7446] Lee, Y., Ed., Bernstein, G., Ed., Li, D., and W. Imajuku, 924 "Routing and Wavelength Assignment Information Model for 925 Wavelength Switched Optical Networks", RFC 7446, 926 DOI 10.17487/RFC7446, February 2015, 927 . 929 [RFC7581] Bernstein, G., Ed., Lee, Y., Ed., Li, D., Imajuku, W., and 930 J. Han, "Routing and Wavelength Assignment Information 931 Encoding for Wavelength Switched Optical Networks", 932 RFC 7581, DOI 10.17487/RFC7581, June 2015, 933 . 935 [RFC7698] Gonzalez de Dios, O., Ed., Casellas, R., Ed., Zhang, F., 936 Fu, X., Ceccarelli, D., and I. Hussain, "Framework and 937 Requirements for GMPLS-Based Control of Flexi-Grid Dense 938 Wavelength Division Multiplexing (DWDM) Networks", 939 RFC 7698, DOI 10.17487/RFC7698, November 2015, 940 . 942 [RFC8363] Zhang, X., Zheng, H., Casellas, R., Gonzalez de Dios, O., 943 and D. Ceccarelli, "GMPLS OSPF-TE Extensions in Support of 944 Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 945 Networks", RFC 8363, DOI 10.17487/RFC8363, May 2018, 946 . 948 [RFC8776] Saad, T., Gandhi, R., Liu, X., Beeram, V., and I. Bryskin, 949 "Common YANG Data Types for Traffic Engineering", 950 RFC 8776, DOI 10.17487/RFC8776, June 2020, 951 . 953 Authors' Addresses 955 Haomian Zheng 956 Huawei Technologies 957 H1, Huawei Xiliu Beipo Village, Songshan Lake 958 Dongguan, Guangdong 523808 959 China 961 Email: zhenghaomian@huawei.com 963 Young Lee 964 Samsung 965 South Korea 967 Email: younglee.tx@gmail.com 969 Aihua Guo 970 Futurewei 972 Email: aihuaguo.ietf@gmail.com 974 Victor Lopez 975 Telefonica 977 Email: victor.lopezalvarez@telefonica.com 979 Daniel King 980 University of Lancaster 982 Email: d.king@lancaster.ac.uk