idnits 2.17.1 draft-ietf-ccamp-layer0-types-04.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 (May 8, 2020) is 1448 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 Summary: 0 errors (**), 0 flaws (~~), 2 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: November 9, 2020 Samsung 6 A. Guo 7 Futurewei 8 V. Lopez 9 Telefonica 10 D. King 11 University of Lancaster 12 May 8, 2020 14 A YANG Data Model for Layer 0 Types 15 draft-ietf-ccamp-layer0-types-04 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 November 9, 2020. 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 . . . . . . . . . . . . . . . . . 6 65 4. Security Considerations . . . . . . . . . . . . . . . . . . . 17 66 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 18 67 6. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 18 68 7. Contributors . . . . . . . . . . . . . . . . . . . . . . . . 18 69 8. References . . . . . . . . . . . . . . . . . . . . . . . . . 19 70 8.1. Normative References . . . . . . . . . . . . . . . . . . 19 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 Operational-mode: 130 A type that represents operational mode as defined in [ITU-Tg6982]. 132 layer0-node-type: 134 A base YANG identity for supported node type as defined in [RFC6163]. 136 wavelength-assignment: 138 A base YANG identity for allocated wavelength assignment type as 139 defined in [RFC6163]. 141 layer0-grid-type: 143 A base YANG identity for the grid type as defined in [RFC6163] and 144 [RFC7698]. 146 term-type: 148 A base YANG identity for the supported termination type as defined in 149 [ITU-Tg709]. 151 layer0-bandwidth-type: 153 A base YANG identity for the layer 0 bandwidth type as defined in 154 [ITU-Tg709]. 156 dwdm-ch-spc-type: 158 A base YANG identity for the DWDM channel spacing type as defined in 159 [RFC6205]. 161 cwdm-ch-spc-type: 163 A base YANG identity for the CWDM channel spacing type as defined in 164 [RFC6205]. 166 FEC-type: 168 A base YANG identity for the FEC type as defined in [ITU-Tg709]. 170 wson-path-bandwidth: 172 A YANG grouping that defines the WSON path bandwidth attributes as 173 defined in [RFC6163]. 175 wson-link-bandwidth: 177 A YANG grouping that defines WSON link bandwidth attributes as 178 defined in [RFC6163]. 180 wson-label-start-end: 182 A YANG grouping that defines the label-start and label-end for WSON 183 as defined in [RFC6205]. 185 wson-label-hop: 187 A YANG grouping that defines the label hop for WSON as defined in 188 [RFC6205]. 190 layer0-label-range-info: 192 A YANG grouping that defines the layer 0 label range information 193 applicable for both WSON per priority level as defined in [RFC6205]. 194 This grouping is used in the flexi-grid DWDM by adding more flexi- 195 grid-specific parameters. 197 wson-label-step: 199 A YANG grouping that defines label steps for WSON as defined in 200 [I-D.ietf-teas-yang-te-types]. 202 flexi-grid-node-attributes: 204 A YANG grouping that defines flexi-grid node attributes as defined in 205 [RFC7698]. 207 flexi-grid-path-bandwidth: 209 A YANG grouping that defines flexi-grid path bandwidth attributes as 210 defined in [RFC7698]. 212 flexi-grid-link-bandwidth: 214 A YANG grouping that defines flexi-grid link bandwidth attributes as 215 defined in [RFC7698]. 217 flexi-grid-label-start-end: 219 A YANG grouping that defines the label-start and label-end for flexi- 220 grid as defined in [RFC7698]. 222 flexi-grid-channel: 224 A YANG grouping that defines flexi-grid channel as defined in 225 [RFC7698]. 227 flexi-grid-label-hop: 229 A YANG grouping that defines the label hop for both single channel 230 and multiple carriers in flexi-grid DWDM, as defined in [RFC7698]. 232 flexi-grid-label-range-info: 234 A YANG grouping that defines flexi-grid label range information and 235 per priority level as defined in [RFC7698] and [RFC8363]. 237 flexi-grid-label-step: 239 A YANG grouping that defines flexi-grid label steps as defined in 240 [I-D.ietf-teas-yang-te-types]. 242 3. YANG Code for Layer 0 Types 244 file "ietf-layer0-types@2020-05-08.yang" 245 module ietf-layer0-types { 246 yang-version 1.1; 247 namespace "urn:ietf:params:xml:ns:yang:ietf-layer0-types"; 248 prefix "l0-types"; 250 organization 251 "IETF CCAMP Working Group"; 252 contact 253 "WG Web: 254 WG List: 256 Editor: Haomian Zheng 257 259 Editor: Young Lee 260 262 Editor: Aihua Guo 263 265 Editor: Victor Lopez 266 268 Editor: Daniel King 269 "; 271 description 272 "This module defines Optical Layer 0 types. This module 273 provides groupings that can be applicable to Layer 0 274 Fixed Optical Networks (e.g., CWDM (Coarse Wavelength 275 Division Multiplexing) and DWDM (Dense Wavelength Division 276 Multiplexing)) and Flexi-grid Optical Networks. 278 Copyright (c) 2020 IETF Trust and the persons identified 279 as authors of the code. All rights reserved. 281 Redistribution and use in source and binary forms, with 282 or without modification, is permitted pursuant to, and 283 subject to the license terms contained in, the Simplified 284 BSD License set forth in Section 4.c of the IETF Trust's 285 Legal Provisions Relating to IETF Documents 286 (http://trustee.ietf.org/license-info). 288 This version of this YANG module is part of RFC XXXX; see 289 the RFC itself for full legal notices."; 291 revision "2020-05-08" { 292 description 293 "Initial Version"; 294 reference 295 "RFC XXXX: A YANG Data Model for Layer 0 Types"; 296 } 298 typedef dwdm-n { 299 type int16; 300 description 301 "The given value 'N' is used to determine the nominal 302 central frequency. 303 The nominal central frequency, 'f' is defined by, 304 f = 193100.000 GHz + N x channel-spacing (measured in GHz), 305 where 193100.000 GHz (193.100000 THz) is the ITU-T 'anchor 306 frequency' for transmission over the C band; and 307 where 'channel-spacing' is defined by the dwdm-ch-spc-type."; 308 reference 309 "RFC6205: Generalized Labels for 310 Lambda-Switch-Capable (LSC) Label Switching Routers, 311 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 312 DWDM frequency grid"; 313 } 315 typedef cwdm-n { 316 type int16; 317 description 318 "The given value 'N' is used to compute the channel 319 wavelength as per the formula: 320 Wavelength (nm) = 1471 + N x channel-spacing (measured in nm), 321 where 1471 nm is the ITU-T 'anchor wavelength' 322 for transmission over the C band; and 323 where 'channel-spacing' is defined by the cwdm-ch-spc-type. "; 324 reference 325 "RFC6205: Generalized Labels for 326 Lambda-Switch-Capable (LSC) Label Switching Routers, 327 ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: 328 CWDM wavelength grid"; 329 } 331 typedef flexi-n { 332 type int16; 333 description 334 "The given value 'N' is used to determine the nominal 335 central frequency. 336 The nominal central frequency, 'f' is defined by, 337 f = 193100.000 GHz + N x channel-spacing (measured in GHz), 338 where 193100.000 GHz (193.100000 THz) is the ITU-T 'anchor 339 frequency' for transmission over the C band; and 340 where 'channel-spacing' is defined by the flexi-ch-spc-type. 342 Note that the term 'chanel-spacing' can be alternated by the 343 term 'nominal central frequency granularity' defined in 344 clause 7 of ITU-T G.694.1."; 345 reference 346 "RFC7698: Framework and Requirements for GMPLS-Based Control 347 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 348 Networks. 349 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 350 DWDM frequency grid"; 351 } 353 typedef flexi-m { 354 type int16; 355 description 356 "M is used to determine the slot width. A slot width is 357 constrained to be M x SWG (that is, M x 12.500 GHz), 358 where M is a positive integer."; 359 reference 360 "RFC7698: Framework and Requirements for GMPLS-Based Control 361 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 362 Networks. 363 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 364 DWDM frequency grid"; 365 } 367 identity l0-grid-type { 368 description 369 "Layer 0 grid type"; 370 reference 371 "RFC6163:Framework for GMPLS and Path Computation Element 372 (PCE) Control of Wavelength Switched Optical Networks (WSONs), 373 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 374 DWDM frequency grid, 375 ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: 376 CWDM wavelength grid"; 377 } 379 identity flexi-grid-dwdm { 380 base l0-grid-type; 381 description 382 "Flexi-grid"; 383 reference 384 "RFC7698: Framework and Requirements for GMPLS-Based Control 385 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 386 Networks, 387 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 388 DWDM frequency grid"; 389 } 391 identity wson-grid-dwdm { 392 base l0-grid-type; 393 description 394 "DWDM grid"; 395 reference 396 "RFC6163:Framework for GMPLS and Path Computation Element 397 (PCE) Control of Wavelength Switched Optical Networks (WSONs), 398 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 399 DWDM frequency grid"; 400 } 402 identity wson-grid-cwdm { 403 base l0-grid-type; 404 description 405 "CWDM grid"; 406 reference 407 "RFC6205: Generalized Labels for 408 Lambda-Switch-Capable (LSC) Label Switching Routers, 409 ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: 410 CWDM wavelength grid"; 411 } 413 identity dwdm-ch-spc-type { 414 description 415 "DWDM channel spacing type"; 416 reference 417 "RFC6205: Generalized Labels for 418 Lambda-Switch-Capable (LSC) Label Switching Routers, 419 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 420 DWDM frequency grid"; 421 } 423 identity dwdm-100ghz { 424 base dwdm-ch-spc-type; 425 description 426 "100GHz channel spacing"; 427 } 429 identity dwdm-50ghz { 430 base dwdm-ch-spc-type; 431 description 432 "50GHz channel spacing"; 433 } 435 identity dwdm-25ghz { 436 base dwdm-ch-spc-type; 437 description 438 "25GHz channel spacing"; 439 } 441 identity dwdm-12p5ghz { 442 base dwdm-ch-spc-type; 443 description 444 "12.5GHz channel spacing"; 445 } 447 identity flexi-ch-spc-type { 448 description 449 "Flexi-grid channel spacing type"; 450 reference 451 "RFC7698: Framework and Requirements for GMPLS-Based Control 452 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 453 Networks 454 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 455 DWDM frequency grid"; 456 } 458 identity flexi-ch-spc-6p25ghz { 459 base flexi-ch-spc-type; 460 description 461 "6.25GHz channel spacing"; 462 } 464 identity flexi-slot-width-granularity { 465 description 466 "Flexi-grid slot width granularity"; 467 } 469 identity flexi-swg-12p5ghz { 470 base flexi-slot-width-granularity; 471 description 472 "12.5GHz slot width granularity"; 473 } 475 identity cwdm-ch-spc-type { 476 description 477 "CWDM channel spacing type"; 479 reference 480 "RFC6205: Generalized Labels for 481 Lambda-Switch-Capable (LSC) Label Switching Routers, 482 ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: 483 CWDM wavelength grid"; 484 } 486 identity cwdm-20nm { 487 base cwdm-ch-spc-type; 488 description 489 "20nm channel spacing"; 490 } 492 /* Groupings. */ 494 grouping wson-label-start-end { 495 description 496 "The WSON label-start or label-end used to 497 specify WSON label range."; 498 choice grid-type { 499 description 500 "Label for DWDM or CWDM grid"; 501 case dwdm { 502 leaf dwdm-n { 503 type l0-types:dwdm-n; 504 description 505 "The central frequency of DWDM. "; 506 reference 507 "RFC6205: Generalized Labels for 508 Lambda-Switch-Capable (LSC) Label Switching Routers"; 509 } 510 } 511 case cwdm { 512 leaf cwdm-n { 513 type l0-types:cwdm-n; 514 description 515 "Channel wavelength computing input. "; 516 reference 517 "RFC6205: Generalized Labels for 518 ambda-Switch-Capable (LSC) Label Switching Routers"; 519 } 520 } 521 } 522 reference 523 "RFC6205: Generalized Labels for 524 Lambda-Switch-Capable (LSC) Label Switching Routers"; 525 } 526 grouping wson-label-hop { 527 description 528 "Generic label hop information for WSON"; 529 choice grid-type { 530 description 531 "Label for DWDM or CWDM grid"; 532 case dwdm { 533 choice single-or-super-channel { 534 description "single or super channel"; 535 case single { 536 leaf dwdm-n { 537 type l0-types:dwdm-n; 538 description 539 "The central frequency of DWDM. "; 540 } 541 } 542 case super { 543 leaf-list subcarrier-dwdm-n { 544 type l0-types:dwdm-n; 545 description 546 "List of center frequencies for each subcarrier 547 channels."; 548 reference 549 "ITU-T Recommendation G.694.1: Spectral grids for 550 WDM applications: DWDM frequency grid"; 551 } 552 } 553 } 554 } 555 case cwdm { 556 leaf cwdm-n { 557 type l0-types:cwdm-n; 558 description 559 "Channel wavelength computing input. "; 560 reference 561 "RFC6205: Generalized Labels for 562 Lambda-Switch-Capable (LSC) Label Switching Routers"; 563 } 564 } 565 } 566 reference 567 "RFC6205: Generalized Labels for 568 Lambda-Switch-Capable (LSC) Label Switching Routers"; 569 } 571 grouping l0-label-range-info { 572 description 573 "Information for layer 0 label range."; 575 leaf grid-type { 576 type identityref { 577 base l0-grid-type; 578 } 579 description "Grid type"; 580 } 581 leaf priority { 582 type uint8; 583 description 584 "Priority in Interface Switching Capability 585 Descriptor (ISCD)."; 586 reference "RFC4203."; 587 } 588 reference 589 "RFC6205: Generalized Labels for 590 Lambda-Switch-Capable (LSC) Label Switching Routers"; 591 } 593 grouping wson-label-step { 594 description "Label step information for WSON"; 595 choice l0-grid-type { 596 description 597 "Grid type: DWDM, CWDM, etc."; 598 case dwdm { 599 leaf wson-dwdm-channel-spacing { 600 type identityref { 601 base dwdm-ch-spc-type; 602 } 603 description 604 "Label-step is the channel-spacing (GHz), e.g., 605 100.000, 50.000, 25.000, or 12.500 GHz for DWDM"; 606 reference 607 "RFC6205: Generalized Labels for 608 Lambda-Switch-Capable (LSC) Label Switching Routers"; 609 } 610 } 611 case cwdm { 612 leaf wson-cwdm-channel-spacing { 613 type identityref { 614 base cwdm-ch-spc-type; 615 } 616 description 617 "label-step is the channel-spacing (nm), i.e., 20 nm 618 for CWDM, which is the only value defined for CWDM"; 619 reference 620 "RFC6205: Generalized Labels for 621 Lambda-Switch-Capable (LSC) Label Switching Routers"; 622 } 624 } 625 } 626 reference 627 "RFC6205: Generalized Labels for 628 Lambda-Switch-Capable (LSC) Label Switching Routers 629 ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: 630 CWDM wavelength grid"; 631 } 633 grouping flexi-grid-label-start-end { 634 description 635 "Label-start and Label-end information for Flexi-grid."; 636 leaf flexi-n { 637 type l0-types:flexi-n; 638 description 639 "The central frequency in Flexi-grid."; 640 } 641 reference 642 "RFC7698: Framework and Requirements for GMPLS-Based Control 643 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 644 Networks"; 645 } 647 grouping flexi-grid-frequency-slot { 648 description "Flexi-grid frequency slot grouping."; 649 uses flexi-grid-label-start-end; 650 leaf flexi-m { 651 type l0-types:flexi-m; 652 description 653 "M is used to determine the slot width. A slot width is 654 constrained to be M x SWG (that is, M x 12.500 GHz), 655 where M is a positive integer."; 656 } 657 reference 658 "RFC7698: Framework and Requirements for GMPLS-Based Control 659 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 660 Networks"; 661 } 662 grouping flexi-grid-label-hop { 663 description "Flexi-grid path label."; 664 choice single-or-super-channel { 665 description "single of super channel"; 666 case single { 667 uses flexi-grid-frequency-slot; 668 } 669 case super { 670 list subcarrier-flexi-n { 671 key flexi-n; 672 uses flexi-grid-frequency-slot; 673 description 674 "List of subcarrier channels for flexi-grid 675 super channel."; 676 } 677 } 678 } 679 reference 680 "RFC7698: Framework and Requirements for GMPLS-Based Control 681 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 682 Networks"; 683 } 685 grouping flexi-grid-label-range-info { 686 description 687 "Info of Flexi-grid-specific label range"; 688 uses l0-label-range-info; 689 container flexi-grid { 690 description "flexi-grid definition"; 691 leaf slot-width-granularity { 692 type identityref { 693 base flexi-slot-width-granularity; 694 } 695 default flexi-swg-12p5ghz; 696 description 697 "Minimum space between slot widths. Default is 698 12.500 GHz"; 699 reference 700 "RFC7698: Framework and Requirements for GMPLS-Based Control 701 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 702 Networks"; 703 } 704 leaf min-slot-width-factor { 705 type uint16 { 706 range "1..max"; 707 } 708 default 1; 709 description 710 "Slot width range: two multipliers of the slot width , 711 granularity, each indicating the minimal and maximal slot 712 width supported by a port, respectively. 714 Minimum slot width is calculated by: 715 Minimum slot width (GHz) = 716 min-slot-width-factor * slot-width-granularity"; 717 reference 718 "RFC8363: GMPLS OSPF-TE Extensions in Support of Flexi-Grid 719 Dense Wavelength Division Multiplexing (DWDM) Networks"; 721 } 723 leaf max-slot-width-factor { 724 type uint16 { 725 range "1..max"; 726 } 727 description 728 "Slot width range: two multipliers of the slot width , 729 granularity, each indicating the minimal and maximal slot 730 width supported by a port, respectively. 732 Maximum slot width is calculated by: 733 Maximum slot width (GHz) = 734 max-slot-width-factor * slot-width-granularity"; 735 reference 736 "RFC8363: GMPLS OSPF-TE Extensions in Support of Flexi-Grid 737 Dense Wavelength Division Multiplexing (DWDM) Networks"; 738 } 739 } 740 } 742 grouping flexi-grid-label-step { 743 description "Label step information for flexi-grid"; 744 leaf flexi-grid-channel-spacing { 745 type identityref { 746 base flexi-ch-spc-type; 747 } 748 default flexi-ch-spc-6p25ghz; 749 description 750 "Label-step is the nominal central frequency 751 granularity (GHz), e.g., 6.25 GHz"; 752 reference 753 "RFC7699: Generalized Labels for the Flexi-Grid in 754 Lambda Switch Capable (LSC) Label Switching Routers"; 755 } 756 leaf flexi-n-step { 757 type uint8; 758 description 759 "This attribute defines the granularity of supported values 760 for the nominal central frequency as a multiplier of the 761 channel-spacing. 763 For example, given a grid with a nominal central frequency 764 granularity of 6.25 GHz, the granularity of the supported 765 values of the nominal central frequency could be 12.5 GHz. 766 In this case, the values of flexi-n should be even and this 767 constraints is reported by setting the flexi-n-step to 2. 769 This attribute is also known as central frequency granularity 770 in RFC8363. "; 771 reference 772 "RFC8363: GMPLS OSPF-TE Extensions in Support of Flexi-Grid 773 Dense Wavelength Division Multiplexing (DWDM) Networks"; 774 } 775 } 776 } 778 780 4. Security Considerations 782 The YANG module specified in this document defines a schema for data 783 that is designed to be accessed via network management protocols such 784 as NETCONF [RFC6241] or RESTCONF [RFC8040]. The lowest NETCONF layer 785 is the secure transport layer, and the mandatory-to-implement secure 786 transport is Secure Shell (SSH) [RFC6242]. The lowest RESTCONF layer 787 is HTTPS, and the mandatory-to-implement secure transport is TLS 788 [RFC8446]. 790 The NETCONF access control model [RFC8341] provides the means to 791 restrict access for particular NETCONF users to a preconfigured 792 subset of all available NETCONF protocol operations and content. The 793 NETCONF Protocol over Secure Shell (SSH) [RFC6242] describes a method 794 for invoking and running NETCONF within a Secure Shell (SSH) session 795 as an SSH subsystem. The NETCONF access control model [RFC8341] 796 provides the means to restrict access for particular NETCONF or 797 RESTCONF users to a preconfigured subset of all available NETCONF or 798 RESTCONF protocol operations and content. 800 The YANG module in this document defines optical layer 0 type 801 definitions (i.e., typedef, identity and grouping statements) in YANG 802 data modeling language to be imported and used by other layer 0 803 specific modules. When imported and used, the resultant schema will 804 have data nodes that can be writable, or readable. The access to 805 such data nodes may be considered sensitive or vulnerable in some 806 network environments. Write operations (e.g., edit-config) to these 807 data nodes without proper protection can have a negative effect on 808 network operations. 810 The security considerations spelled out in the YANG 1.1 specification 811 [RFC7950] apply for this document as well. 813 5. IANA Considerations 815 It is proposed that IANA should assign new URIs from the "IETF XML 816 Registry" [RFC3688] as follows: 818 URI: urn:ietf:params:xml:ns:yang:ietf-layer0-types 819 Registrant Contact: The IESG 820 XML: N/A; the requested URI is an XML namespace. 822 This document registers following YANG modules in the YANG Module 823 Names registry [RFC7950]. 825 name: ietf-layer0-types 826 namespace: urn:ietf:params:xml:ns:yang:ietf-layer0-types 827 prefix: l0-types 828 reference: RFC XXXX(TBD) 830 6. Acknowledgements 832 The authors and the working group give their sincere thanks for 833 Robert Wilton for the YANG doctor review, and Tom Petch for his 834 comments during the model and document development. 836 7. Contributors 838 Dhruv Dhody 839 Huawei 840 Email: dhruv.ietf@gmail.com 842 Bin Yeong Yoon 843 ETRI 844 Email: byyun@etri.re.kr 846 Ricard Vilalta 847 CTTC 848 Email: ricard.vilalta@cttc.es 850 Italo Busi 851 Huawei 852 Email: Italo.Busi@huawei.com 854 8. References 856 8.1. Normative References 858 [RFC6241] Enns, R., Ed., Bjorklund, M., Ed., Schoenwaelder, J., Ed., 859 and A. Bierman, Ed., "Network Configuration Protocol 860 (NETCONF)", RFC 6241, DOI 10.17487/RFC6241, June 2011, 861 . 863 [RFC6242] Wasserman, M., "Using the NETCONF Protocol over Secure 864 Shell (SSH)", RFC 6242, DOI 10.17487/RFC6242, June 2011, 865 . 867 [RFC7950] Bjorklund, M., Ed., "The YANG 1.1 Data Modeling Language", 868 RFC 7950, DOI 10.17487/RFC7950, August 2016, 869 . 871 [RFC8040] Bierman, A., Bjorklund, M., and K. Watsen, "RESTCONF 872 Protocol", RFC 8040, DOI 10.17487/RFC8040, January 2017, 873 . 875 [RFC8341] Bierman, A. and M. Bjorklund, "Network Configuration 876 Access Control Model", STD 91, RFC 8341, 877 DOI 10.17487/RFC8341, March 2018, 878 . 880 [RFC8342] Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K., 881 and R. Wilton, "Network Management Datastore Architecture 882 (NMDA)", RFC 8342, DOI 10.17487/RFC8342, March 2018, 883 . 885 [RFC8446] Rescorla, E., "The Transport Layer Security (TLS) Protocol 886 Version 1.3", RFC 8446, DOI 10.17487/RFC8446, August 2018, 887 . 889 8.2. Informative References 891 [I-D.ietf-teas-yang-te-types] 892 Saad, T., Gandhi, R., Liu, X., Beeram, V., and I. Bryskin, 893 "Traffic Engineering Common YANG Types", draft-ietf-teas- 894 yang-te-types-13 (work in progress), November 2019. 896 [ITU-Tg6941] 897 International Telecommunication Union, "Spectral grids for 898 WDM applications: DWDM frequency grid", ITU-T G.694.1, 899 February 2012. 901 [ITU-Tg6982] 902 International Telecommunication Union, "Amplified 903 multichannel dense wavelength division multiplexing 904 applications with single channel optical interfaces", 905 ITU-T G.698.2, November 2018. 907 [ITU-Tg709] 908 International Telecommunication Union, "Interfaces for the 909 optical transport network", ITU-T G.709, June 2016. 911 [RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, 912 DOI 10.17487/RFC3688, January 2004, 913 . 915 [RFC6163] Lee, Y., Ed., Bernstein, G., Ed., and W. Imajuku, 916 "Framework for GMPLS and Path Computation Element (PCE) 917 Control of Wavelength Switched Optical Networks (WSONs)", 918 RFC 6163, DOI 10.17487/RFC6163, April 2011, 919 . 921 [RFC6205] Otani, T., Ed. and D. Li, Ed., "Generalized Labels for 922 Lambda-Switch-Capable (LSC) Label Switching Routers", 923 RFC 6205, DOI 10.17487/RFC6205, March 2011, 924 . 926 [RFC7205] Romanow, A., Botzko, S., Duckworth, M., and R. Even, Ed., 927 "Use Cases for Telepresence Multistreams", RFC 7205, 928 DOI 10.17487/RFC7205, April 2014, 929 . 931 [RFC7446] Lee, Y., Ed., Bernstein, G., Ed., Li, D., and W. Imajuku, 932 "Routing and Wavelength Assignment Information Model for 933 Wavelength Switched Optical Networks", RFC 7446, 934 DOI 10.17487/RFC7446, February 2015, 935 . 937 [RFC7581] Bernstein, G., Ed., Lee, Y., Ed., Li, D., Imajuku, W., and 938 J. Han, "Routing and Wavelength Assignment Information 939 Encoding for Wavelength Switched Optical Networks", 940 RFC 7581, DOI 10.17487/RFC7581, June 2015, 941 . 943 [RFC7698] Gonzalez de Dios, O., Ed., Casellas, R., Ed., Zhang, F., 944 Fu, X., Ceccarelli, D., and I. Hussain, "Framework and 945 Requirements for GMPLS-Based Control of Flexi-Grid Dense 946 Wavelength Division Multiplexing (DWDM) Networks", 947 RFC 7698, DOI 10.17487/RFC7698, November 2015, 948 . 950 [RFC8363] Zhang, X., Zheng, H., Casellas, R., Gonzalez de Dios, O., 951 and D. Ceccarelli, "GMPLS OSPF-TE Extensions in Support of 952 Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 953 Networks", RFC 8363, DOI 10.17487/RFC8363, May 2018, 954 . 956 Authors' Addresses 958 Haomian Zheng 959 Huawei Technologies 960 H1, Huawei Xiliu Beipo Village, Songshan Lake 961 Dongguan, Guangdong 523808 962 China 964 Email: zhenghaomian@huawei.com 966 Young Lee 967 Samsung 968 South Korea 970 Email: younglee.tx@gmail.com 972 Aihua Guo 973 Futurewei 975 Email: aihuaguo@futurewei.com 977 Victor Lopez 978 Telefonica 980 Email: victor.lopezalvarez@telefonica.com 982 Daniel King 983 University of Lancaster 985 Email: d.king@lancaster.ac.uk