idnits 2.17.1 draft-ietf-ccamp-layer0-types-07.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 (September 21, 2020) is 1284 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 835, but no explicit reference was found in the text == Unused Reference: 'RFC7699' is defined on line 849, 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: March 25, 2021 Samsung 6 A. Guo 7 Futurewei 8 V. Lopez 9 Telefonica 10 D. King 11 University of Lancaster 12 September 21, 2020 14 A YANG Data Model for Layer 0 Types 15 draft-ietf-ccamp-layer0-types-07 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 March 25, 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 . . . . . . . . . . . . . . . . . . . 16 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 [I-D.ietf-teas-yang-te-types]. 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 [I-D.ietf-teas-yang-te-types]. 185 3. YANG Code for Layer 0 Types 187 file "ietf-layer0-types@2020-09-21.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-09-21" { 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 "../../../grid-type = 'wson-grid-dwdm'" { 451 description 452 "Valid only when grid type is DWDM."; 453 } 454 type l0-types:dwdm-n; 455 description 456 "The central frequency of DWDM. "; 457 reference 458 "RFC6205: Generalized Labels for 459 Lambda-Switch-Capable (LSC) Label Switching Routers"; 460 } 461 } 462 case cwdm { 463 leaf cwdm-n { 464 when "../../../grid-type = 'wson-grid-cwdm'" { 465 description 466 "Valid only when grid type is CWDM."; 467 } 468 type l0-types:cwdm-n; 469 description 470 "Channel wavelength computing input. "; 472 reference 473 "RFC6205: Generalized Labels for 474 Lambda-Switch-Capable (LSC) Label Switching Routers"; 475 } 476 } 477 } 478 reference 479 "RFC6205: Generalized Labels for 480 Lambda-Switch-Capable (LSC) Label Switching Routers"; 481 } 483 grouping wson-label-hop { 484 description 485 "Generic label hop information for WSON"; 486 choice grid-type { 487 description 488 "Label for DWDM or CWDM grid"; 489 case dwdm { 490 choice single-or-super-channel { 491 description "single or super channel"; 492 case single { 493 leaf dwdm-n { 494 type l0-types:dwdm-n; 495 description 496 "The given value 'N' is used to determine the 497 nominal central frequency."; 498 } 499 } 500 case super { 501 leaf-list subcarrier-dwdm-n { 502 type l0-types:dwdm-n; 503 description 504 "The given values 'N' are used to determine the 505 nominal central frequency for each subcarrier 506 channels."; 507 reference 508 "ITU-T Recommendation G.694.1: Spectral grids for 509 WDM applications: DWDM frequency grid"; 510 } 511 } 512 } 513 } 514 case cwdm { 515 leaf cwdm-n { 516 type l0-types:cwdm-n; 517 description 518 "The given value 'N' is used to determine the nominal 519 central wavelength."; 521 reference 522 "RFC6205: Generalized Labels for 523 Lambda-Switch-Capable (LSC) Label Switching Routers"; 524 } 525 } 526 } 527 reference 528 "RFC6205: Generalized Labels for 529 Lambda-Switch-Capable (LSC) Label Switching Routers"; 530 } 532 grouping l0-label-range-info { 533 description 534 "Information for layer 0 label range."; 535 leaf grid-type { 536 type identityref { 537 base l0-grid-type; 538 } 539 description "Grid type"; 540 } 541 leaf priority { 542 type uint8; 543 description 544 "Priority in Interface Switching Capability 545 Descriptor (ISCD)."; 546 reference 547 "RFC4203: OSPF Extensions in Support of Generalized 548 Multi-Protocol Label Switching (GMPLS)."; 549 } 550 reference 551 "RFC6205: Generalized Labels for 552 Lambda-Switch-Capable (LSC) Label Switching Routers"; 553 } 555 grouping wson-label-step { 556 description "Label step information for WSON"; 557 choice l0-grid-type { 558 description 559 "Grid type: DWDM, CWDM, etc."; 560 case dwdm { 561 leaf wson-dwdm-channel-spacing { 562 when "../../grid-type = 'wson-grid-dwdm'" { 563 description 564 "Valid only when grid type is DWDM."; 565 } 566 type identityref { 567 base dwdm-ch-spc-type; 568 } 569 description 570 "Label-step is the channel-spacing (GHz), e.g., 571 100.000, 50.000, 25.000, or 12.500 GHz for DWDM"; 572 reference 573 "RFC6205: Generalized Labels for 574 Lambda-Switch-Capable (LSC) Label Switching Routers"; 575 } 576 } 577 case cwdm { 578 leaf wson-cwdm-channel-spacing { 579 when "../../grid-type = 'wson-grid-cwdm'" { 580 description 581 "Valid only when grid type is CWDM."; 582 } 583 type identityref { 584 base cwdm-ch-spc-type; 585 } 586 description 587 "Label-step is the channel-spacing (nm), i.e., 20 nm 588 for CWDM, which is the only value defined for CWDM"; 589 reference 590 "RFC6205: Generalized Labels for 591 Lambda-Switch-Capable (LSC) Label Switching Routers"; 592 } 593 } 594 } 595 reference 596 "RFC6205: Generalized Labels for 597 Lambda-Switch-Capable (LSC) Label Switching Routers 598 ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: 599 CWDM wavelength grid"; 600 } 602 grouping flexi-grid-label-start-end { 603 description 604 "The Flexi-grid label-start or label-end used to 605 specify Flexi-grid label range."; 606 leaf flexi-n { 607 type l0-types:flexi-n; 608 description 609 "The given value 'N' is used to determine the nominal 610 central frequency."; 611 } 612 reference 613 "RFC7698: Framework and Requirements for GMPLS-Based Control 614 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 615 Networks"; 616 } 617 grouping flexi-grid-frequency-slot { 618 description "Flexi-grid frequency slot grouping."; 619 uses flexi-grid-label-start-end; 620 leaf flexi-m { 621 type l0-types:flexi-m; 622 description 623 "The given value 'M' is used to determine the slot width."; 624 } 625 reference 626 "RFC7698: Framework and Requirements for GMPLS-Based Control 627 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 628 Networks"; 629 } 631 grouping flexi-grid-label-hop { 632 description 633 "Generic label hop information for Flexi-grid"; 635 choice single-or-super-channel { 636 description "single or super channel"; 637 case single { 638 uses flexi-grid-frequency-slot; 639 } 640 case super { 641 list subcarrier-flexi-n { 642 key flexi-n; 643 uses flexi-grid-frequency-slot; 644 description 645 "List of subcarrier channels for flexi-grid 646 super channel."; 647 } 648 } 649 } 650 reference 651 "RFC7698: Framework and Requirements for GMPLS-Based Control 652 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 653 Networks"; 654 } 656 grouping flexi-grid-label-range-info { 657 description 658 "Info of Flexi-grid-specific label range"; 659 uses l0-label-range-info; 660 container flexi-grid { 661 description "flexi-grid definition"; 662 leaf slot-width-granularity { 663 type identityref { 664 base flexi-slot-width-granularity; 666 } 667 default flexi-swg-12p5ghz; 668 description 669 "Minimum space between slot widths. Default is 670 12.500 GHz"; 671 reference 672 "RFC7698: Framework and Requirements for GMPLS-Based 673 Control of Flexi-Grid Dense Wavelength Division 674 Multiplexing (DWDM) Networks"; 675 } 676 leaf min-slot-width-factor { 677 type uint16 { 678 range "1..max"; 679 } 680 default 1; 681 description 682 "Slot width range: two multipliers of the slot width , 683 granularity, each indicating the minimal and maximal slot 684 width supported by a port, respectively. 686 Minimum slot width is calculated by: 687 Minimum slot width (GHz) = 688 min-slot-width-factor * slot-width-granularity. 689 Minimum slot width should be smaller than or equal to 690 Maximum slot width. "; 691 reference 692 "RFC8363: GMPLS OSPF-TE Extensions in Support of Flexi-Grid 693 Dense Wavelength Division Multiplexing (DWDM) Networks"; 694 } 696 leaf max-slot-width-factor { 697 type uint16 { 698 range "1..max"; 699 } 700 description 701 "Slot width range: two multipliers of the slot width , 702 granularity, each indicating the minimal and maximal slot 703 width supported by a port, respectively. 705 Maximum slot width is calculated by: 706 Maximum slot width (GHz) = 707 max-slot-width-factor * slot-width-granularity 708 Maximum slot width should be bigger than or equal to 709 Minimum slot width. "; 710 reference 711 "RFC8363: GMPLS OSPF-TE Extensions in Support of Flexi-Grid 712 Dense Wavelength Division Multiplexing (DWDM) Networks"; 713 } 715 } 716 } 718 grouping flexi-grid-label-step { 719 description "Label step information for flexi-grid"; 720 leaf flexi-grid-channel-spacing { 721 type identityref { 722 base flexi-ch-spc-type; 723 } 724 default flexi-ch-spc-6p25ghz; 725 description 726 "Label-step is the nominal central frequency 727 granularity (GHz), e.g., 6.25 GHz"; 728 reference 729 "RFC7699: Generalized Labels for the Flexi-Grid in 730 Lambda Switch Capable (LSC) Label Switching Routers"; 731 } 732 leaf flexi-n-step { 733 type uint8; 734 description 735 "This attribute defines the multiplier for the supported 736 values of 'N'. 738 For example, given a grid with a nominal central frequency 739 granularity of 6.25 GHz, the granularity of the supported 740 values of the nominal central frequency could be 12.5 GHz. 741 In this case, the values of flexi-n should be even and this 742 constraints is reported by setting the flexi-n-step to 2. 744 This attribute is also known as central frequency 745 granularity in RFC8363."; 746 reference 747 "RFC8363: GMPLS OSPF-TE Extensions in Support of Flexi-Grid 748 Dense Wavelength Division Multiplexing (DWDM) Networks"; 749 } 750 } 751 } 753 755 4. Security Considerations 757 The YANG module specified in this document defines a schema for data 758 that is designed to be accessed via network management protocols such 759 as NETCONF [RFC6241] or RESTCONF [RFC8040]. The lowest NETCONF layer 760 is the secure transport layer, and the mandatory-to-implement secure 761 transport is Secure Shell (SSH) [RFC6242]. The lowest RESTCONF layer 762 is HTTPS, and the mandatory-to-implement secure transport is TLS 763 [RFC8446]. 765 The NETCONF access control model [RFC8341] provides the means to 766 restrict access for particular NETCONF users to a preconfigured 767 subset of all available NETCONF protocol operations and content. The 768 NETCONF Protocol over Secure Shell (SSH) [RFC6242] describes a method 769 for invoking and running NETCONF within a Secure Shell (SSH) session 770 as an SSH subsystem. The NETCONF access control model [RFC8341] 771 provides the means to restrict access for particular NETCONF or 772 RESTCONF users to a preconfigured subset of all available NETCONF or 773 RESTCONF protocol operations and content. 775 The objects in this YANG module are common data types and groupings. 776 No object in this module can be read or written to. These 777 definitions can be imported and used by other layer 0 specific 778 modules. It is critical consider how imported definitions will be 779 utilized and accessible via RPC operations, as the resultant schema 780 will have data nodes that can be writable, or readable, and will have 781 a significant effect on the network operations if used incorrectly or 782 maliciously. All of this consideration belongs in the document that 783 defines the modules that import from this YANG module. Therefore, it 784 is important to manage access to resultant data nodes that are 785 considered sensitive or vulnerable in some network environments. 787 The security considerations spelled out in the YANG 1.1 specification 788 [RFC7950] apply for this document as well. 790 5. IANA Considerations 792 It is proposed to IANA to assign new URIs from the "IETF XML 793 Registry" [RFC3688] as follows: 795 URI: urn:ietf:params:xml:ns:yang:ietf-layer0-types 796 Registrant Contact: The IESG 797 XML: N/A; the requested URI is an XML namespace. 799 This document registers following YANG modules in the YANG Module 800 Names registry [RFC7950]. 802 name: ietf-layer0-types 803 namespace: urn:ietf:params:xml:ns:yang:ietf-layer0-types 804 prefix: l0-types 805 reference: RFC XXXX(TBD) 807 6. Acknowledgements 809 The authors and the working group give their sincere thanks for 810 Robert Wilton for the YANG doctor review, and Tom Petch for his 811 comments during the model and document development. 813 7. Contributors 815 Dhruv Dhody 816 Huawei 817 Email: dhruv.ietf@gmail.com 819 Bin Yeong Yoon 820 ETRI 821 Email: byyun@etri.re.kr 823 Ricard Vilalta 824 CTTC 825 Email: ricard.vilalta@cttc.es 827 Italo Busi 828 Huawei 829 Email: Italo.Busi@huawei.com 831 8. References 833 8.1. Normative References 835 [RFC4203] Kompella, K., Ed. and Y. Rekhter, Ed., "OSPF Extensions in 836 Support of Generalized Multi-Protocol Label Switching 837 (GMPLS)", RFC 4203, DOI 10.17487/RFC4203, October 2005, 838 . 840 [RFC6241] Enns, R., Ed., Bjorklund, M., Ed., Schoenwaelder, J., Ed., 841 and A. Bierman, Ed., "Network Configuration Protocol 842 (NETCONF)", RFC 6241, DOI 10.17487/RFC6241, June 2011, 843 . 845 [RFC6242] Wasserman, M., "Using the NETCONF Protocol over Secure 846 Shell (SSH)", RFC 6242, DOI 10.17487/RFC6242, June 2011, 847 . 849 [RFC7699] Farrel, A., King, D., Li, Y., and F. Zhang, "Generalized 850 Labels for the Flexi-Grid in Lambda Switch Capable (LSC) 851 Label Switching Routers", RFC 7699, DOI 10.17487/RFC7699, 852 November 2015, . 854 [RFC7950] Bjorklund, M., Ed., "The YANG 1.1 Data Modeling Language", 855 RFC 7950, DOI 10.17487/RFC7950, August 2016, 856 . 858 [RFC8040] Bierman, A., Bjorklund, M., and K. Watsen, "RESTCONF 859 Protocol", RFC 8040, DOI 10.17487/RFC8040, January 2017, 860 . 862 [RFC8341] Bierman, A. and M. Bjorklund, "Network Configuration 863 Access Control Model", STD 91, RFC 8341, 864 DOI 10.17487/RFC8341, March 2018, 865 . 867 [RFC8342] Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K., 868 and R. Wilton, "Network Management Datastore Architecture 869 (NMDA)", RFC 8342, DOI 10.17487/RFC8342, March 2018, 870 . 872 [RFC8446] Rescorla, E., "The Transport Layer Security (TLS) Protocol 873 Version 1.3", RFC 8446, DOI 10.17487/RFC8446, August 2018, 874 . 876 8.2. Informative References 878 [I-D.ietf-teas-yang-te-types] 879 Saad, T., Gandhi, R., Liu, X., Beeram, V., and I. Bryskin, 880 "Traffic Engineering Common YANG Types", draft-ietf-teas- 881 yang-te-types-13 (work in progress), November 2019. 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 Authors' Addresses 950 Haomian Zheng 951 Huawei Technologies 952 H1, Huawei Xiliu Beipo Village, Songshan Lake 953 Dongguan, Guangdong 523808 954 China 956 Email: zhenghaomian@huawei.com 958 Young Lee 959 Samsung 960 South Korea 962 Email: younglee.tx@gmail.com 964 Aihua Guo 965 Futurewei 967 Email: aihuaguo.ietf@gmail.com 969 Victor Lopez 970 Telefonica 972 Email: victor.lopezalvarez@telefonica.com 974 Daniel King 975 University of Lancaster 977 Email: d.king@lancaster.ac.uk