idnits 2.17.1 draft-lee-ccamp-optical-impairment-topology-yang-01.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 : ---------------------------------------------------------------------------- ** There are 34 instances of too long lines in the document, the longest one being 15 characters in excess of 72. Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the IETF Trust and authors Copyright Line does not match the current year == Line 278 has weird spacing: '...odating the o...' == Line 305 has weird spacing: '...scribed in GH...' == Line 317 has weird spacing: '...sceiver prope...' == Line 412 has weird spacing: '...t-index uin...' == Line 419 has weird spacing: '...variety str...' == (3 more instances...) -- The document date (February 28, 2019) is 1876 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: 'RFC4847' is mentioned on line 149, but not defined == Missing Reference: 'RFC5253' is mentioned on line 149, but not defined == Missing Reference: 'RFC8340' is mentioned on line 179, but not defined == Missing Reference: 'RFC XXXX' is mentioned on line 190, but not defined == Missing Reference: 'G.872' is mentioned on line 255, but not defined == Missing Reference: 'RFC6536' is mentioned on line 1373, but not defined ** Obsolete undefined reference: RFC 6536 (Obsoleted by RFC 8341) == Missing Reference: 'RFC3688' is mentioned on line 1384, but not defined == Unused Reference: 'WSON-Topo' is defined on line 1453, but no explicit reference was found in the text == Outdated reference: A later version (-28) exists of draft-ietf-ccamp-wson-yang-13 Summary: 2 errors (**), 0 flaws (~~), 16 warnings (==), 1 comment (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 1 CCAMP Working Group Y. Lee 2 Internet Draft H. Zheng 3 Intended Status: Standard Track I. Busi 4 Huawei 5 Expires: August 27, 2019 6 N. Sambo 7 Scuola Superiore Sant'Anna 9 V. Lopez 10 Telefonica 12 G. Galimberti 13 G. Martinelli 14 Cisco 16 Jean Luc Auge 17 Ester LE Rouzic 18 Julien Meuric 19 Orange 21 D. Beller 22 S. Belotti 23 E. Griseri 24 Nokia 26 Gert Grammel 27 Juniper 29 February 28, 2019 31 A Yang Data Model for Optical Impairment-aware Topology 33 draft-lee-ccamp-optical-impairment-topology-yang-01 35 Abstract 37 In order to provision an optical connection through optical 38 networks, a combination of path continuity, resource availability, 39 and impairment constraints must be met to determine viable and 40 optimal paths through the network. The determination of appropriate 41 paths is known as Impairment-Aware Routing and Wavelength Assignment 42 (IA-RWA) for WSON, while it is known as Impairment-Aware Routing and 43 Spectrum Assigment (IA-RSA) for SSON. 45 This document provides a YANG data model for the impairment-aware TE 46 topology in optical networks. 48 Status of this Memo 50 This Internet-Draft is submitted to IETF in full conformance with 51 the provisions of BCP 78 and BCP 79. 53 Internet-Drafts are working documents of the Internet Engineering 54 Task Force (IETF), its areas, and its working groups. Note that 55 other groups may also distribute working documents as Internet- 56 Drafts. 58 Internet-Drafts are draft documents valid for a maximum of six 59 months and may be updated, replaced, or obsoleted by other documents 60 at any time. It is inappropriate to use Internet-Drafts as 61 reference material or to cite them other than as "work in progress." 63 The list of current Internet-Drafts can be accessed at 64 http://www.ietf.org/ietf/1id-abstracts.txt 66 The list of Internet-Draft Shadow Directories can be accessed at 67 http://www.ietf.org/shadow.html 69 This Internet-Draft will expire on August 27, 2019. 71 Copyright Notice 73 Copyright (c) 2019 IETF Trust and the persons identified as the 74 document authors. All rights reserved. 76 This document is subject to BCP 78 and the IETF Trust's Legal 77 Provisions Relating to IETF Documents 78 (http://trustee.ietf.org/license-info) in effect on the date of 79 publication of this document. Please review these documents 80 carefully, as they describe your rights and restrictions with 81 respect to this document. Code Components extracted from this 82 document must include Simplified BSD License text as described in 83 Section 4.e of the Trust Legal Provisions and are provided without 84 warranty as described in the Simplified BSD License. 86 Table of Contents 87 1. Introduction...................................................3 88 1.1. Terminology...............................................4 89 1.2. Tree diagram..............................................4 90 1.3. Prefixes in Data Node Names...............................5 91 2. Reference Architecture.........................................6 92 2.1. Control Plane Architecture................................6 93 2.2. Transport Data Plane......................................7 94 2.3. OMS Media Links...........................................7 95 2.3.1. Optical Tributary Signal Group (OTSiG)...............8 96 2.4. Amplifiers................................................9 97 2.4.1. In-Line Amplifier...................................10 98 2.5. Transponders.............................................10 99 2.6. WSS/Filter...............................................10 100 2.7. Optical Fiber............................................10 101 3. YANG Model (Tree Structure)...................................11 102 4. Optical Impairment Topology YANG Model........................12 103 5. Security Considerations.......................................31 104 6. IANA Considerations...........................................31 105 7. Acknowledgments...............................................32 106 8. References....................................................33 107 8.1. Normative References.....................................33 108 8.2. Informative References...................................33 109 9. Contributors..................................................34 110 Authors' Addresses...............................................34 112 1. Introduction 114 In order to provision an optical connection (an optical path) 115 through a wavelength switched optical networks (WSONs) or spectrum 116 switched optical networks (SSONs), a combination of path continuity, 117 resource availability, and impairment constraints must be met to 118 determine viable and optimal paths through the network. The 119 determination of appropriate paths is known as Impairment-Aware 120 Routing and Wavelength Assignment (IA-RWA) [RFC6566] for WSON, while 121 it is known as IA-Routing and Spectrum Assigment (IA-RSA) for SSON. 123 This document provides a YANG data model for the impairment-aware 124 Traffic Engineering (TE) topology in WSONs and SSONs. The YANG model 125 described in this document is a WSON/SSON technology-specific Yang 126 model based on the information model developed in [RFC7446] and the 127 two encoding documents [RFC7581] and [RFC7579] that developed 128 protocol independent encodings based on [RFC7446]. 130 The intent of this document is to provide a Yang data model, which 131 can be utilized by a Multi-Domain Service Coordinator (MDSC) to 132 collect states of WSON impairment data from the Transport PNCs to 133 enable impairment-aware optical path computation according to the 134 ACTN Architecture [RFC8453]. The communication between controllers 135 is done via a NETCONF [RFC8341]. Similarly, this model can also be 136 exported by the MDSC to a Customer Network Controller (CNC), which 137 can run an offline planning process to map latter the services in 138 the network. 140 This document augments the generic TE topology draft [TE-TOPO] where 141 possible. 143 This document defines one YANG module: ietf-optical-impairment- 144 topology (Section 3) according to the new Network Management 145 Datastore Architecture [RFC8342]. 147 1.1. Terminology 149 Refer to [RFC4847] and [RFC5253] for the key terms used in this 150 document. 152 The following terms are defined in [RFC7950] and are not redefined 153 here: 155 o client 157 o server 159 o augment 161 o data model 163 o data node 165 The following terms are defined in [RFC6241] and are not redefined 166 here: 168 o configuration data 170 o state data 172 The terminology for describing YANG data models is found in 173 [RFC7950]. 175 1.2. Tree diagram 177 A simplified graphical representation of the data model is used in 178 Section 2 of this this document. The meaning of the symbols in 179 these diagrams is defined in [RFC8340]. 181 1.3. Prefixes in Data Node Names 183 In this document, names of data nodes and other data model objects 184 are prefixed using the standard prefix associated with the 185 corresponding YANG imported modules, as shown in Table 1. 187 +------------------+----------------------------------+------------+ 188 | Prefix | YANG module | Reference | 189 +------------------+----------------------------------+------------+ 190 | optical-imp-topo | ietf-optical-impairment-topology | [RFC XXXX] | 191 | layer0-types | ietf-layer0-types | [WSON-topo]| 192 | nw | ietf-network | [RFC8345] | 193 | nt | ietf-network-topology | [RFC8345] | 194 | tet | ietf-te-topology | [TE-TOPO] | 195 +------------------+----------------------------------+------------+ 197 Table 1: Prefixes and corresponding YANG modules 199 Note: The RFC Editor will replace XXXX with the number assigned to 200 the RFC once this draft becomes an RFC. 202 2. Reference Architecture 204 2.1. Control Plane Architecture 206 Figure 1 shows the control plane architecture. 208 Figure 1. Control Plane Architecture 210 The models developed in this document is an abstracted Yang model 211 that may be used in the interfaces colored in yellow in Figure 1. It 212 is not intended to support detailed device congiuration model. 213 Device configuration model is supported by the models presented in 214 [draft-ietf-ccamp-dwdm-if-parameter-yang]. 216 2.2. Transport Data Plane 218 This section provides the description of the reference optical 219 network architecture and its relevant components to support optical 220 impairment-aware path computation. 222 Figure 2 shows the reference architecture. 224 +-------------------+ +-------------------+ 225 | ROADM Node | | ROADM Node | 226 | | | | 227 | PA +-------+ BA | ILA ILA | PA +-------+ BA | 228 | +-+ | WSS/ | +-+ | _____ +--+ ____ +--+ _____ | +-+ | WSS/ | +-+ | 229 ---|-| |-|Filter |-| |-|-()____)--| |-()___)-| |-()____)--|-| |-|Filter |-| |-|--- 230 | +-+ | | +-+ | +--+ +--+ | +-+ | | +-+ | 231 | +-------+ | optical | +-------+ | 232 | | | | | fiber | | | | | 233 | | | | | | | | | | 234 | o-o-o | | o-o-o | 235 | transponders | | transponders | 236 +-------------------+ +-------------------+ 237 OTS Link OTS Link OTS Link 238 -----------> --------> -----------> 240 OMS Link 241 ----------------------------------------------> 243 PA: Pre-Amplifier 244 BA: Booster Amplifier 245 ILA: In-Line Amplifier 247 Figure 2. Reference Architecture for Optical Transport Network 249 BA (on the left side ROADM) is the ingress Amplifier and PA (on the 250 right side ROADM is the egress amplifier for the OMS link shown in 251 the Figure. 253 2.3. OMS Media Links 255 According to [G.872], OMS Media Link represents a media link between 256 two ROADM. Specifically, it originates at the ROADM's Filter in the 257 source ROADM and terminates at the ROADM's Filter in the destination 258 ROADM. 260 OTS Media Link represents a media link: 262 (i) between ROADM's BA and ILA; 263 (ii) between a pair of ILAs; 264 (iii) between ILA and ROADM's PA. 266 OMS Media link can be decomposed of a number of elements, which are 267 basically OTS links type (i), (ii), and (iii) as discussed above. 268 OMS Media link would give an abstracted view of impairment data 269 (e.g., power, OSNR, etc.) to the network controller. 271 2.3.1. Optical Tributary Signal Group (OTSiG) 273 The Media Channel and Network Media Channel are well modelled by the 274 RFC7698, RFC7699 and RFC7792 reflecting the ITU-T Recommendations 275 G.694.1 and G.698.2. 277 Some work is in progress in ITU-T SG15/Q12 to define Network Media 278 Channel (group) that is capable of accommodating the optical 279 tributary signals (OTSi) belonging to optical tributary signal group 280 (OTSiG). ( see new ITU-T Draft Recommendation G.807)). 282 Currently, no models exist (in the IETF nor ITU-T SG15) that define 283 how the optical tributary signals are described inside the Network 284 Media Channel Group in terms of OTSi identifier, OTSi carrier 285 frequency and OTSi signal width. 287 There are several options how the mentioned parameters can be 288 described. One option is to use the description defined in draft- 289 ggalimbe-ccamp-flexigrid-carrier-label. 291 A second option is to describe the OTsi carrier frequency relative 292 to the anchor frequency 193.1THz based on a well-defined granularity 293 (e.g. OTSi carrier frequency = 193100 (GHz) + K * granularity (GHz) 294 where K is a signed integer value). 296 A third option is to explicitly describe the OTSi carrier frequency 297 and the OTSi signal width in GHz with a certain accuracy. 299 It is proposed to use the third option which is independent of the 300 n, m values alredy define in ITU-T Recommendation G.694.1. 302 The OTSi carrier frequency is described in GHz with 3 fractional 303 digits (decimal 64 fraction digits 3). 305 The OTSi signal width is described in GHz with 3 fractional digits 306 (decimal 64 fraction digits 3) and includes the signal roll off as 307 well as some guard band. 309 The accuracy of 0.001 GHz does not impose a requirement on the 310 optical transceiver components (optical transmitter) in terms of 311 carrier frequency tuneability precision. Today's components 312 typically provide a tunability precision in the range of 1..1.5GHz 313 (carrier frequency offset compared to the configured nominal carrier 314 frequency). Future components may provide a better precision as 315 technology evolves. 317 If needed, a controller may retrieve the transceiver properties in 318 terms of carrier frequency tuneability precision in order to be 319 capable of properly configuring the underlying transceiver. 321 [Note from the Editor]: 323 As this description is arbitrarily proposed by the authors to cover 324 a lack of information in IETF and ITU-T, a liaison request to ITU-T 325 is needed. 327 The authors are willing to contribute to Liaison editing and to 328 consider any feedback and proposal from ITU-T. 330 2.4. Amplifiers 332 There are three basic types of amplifiers. ILA is In-Line Amplifier 333 which is a separate node type while Pre-Amplifier and Booster 334 Amplifier are integral elements of ROADM node. From a data modeling 335 perspective, Pre-Amplifier and Booster Amplifier are internal 336 functions of a ROADM node and as such these elements are hidden 337 within ROADM node. In this document, we would avoid internal node 338 details, but attempt to abstract as much as possible. 340 One modeling consideration of the ROADM internal is to model power 341 parameter through the ROADM, factoring the output power from the 342 Pre-Amplifier minus the ROADM power loss would give the input power 343 to the Booster Amplifier. In other words, Power_in (@ ROADM Booster) 344 = Power_out (@ ROADM Pre-Amplifier) - Power_loss (@ ROADM 345 WSS/Filter). 347 2.4.1. In-Line Amplifier 349 (Need to explain details including VOA) 351 2.5. Transponders 353 A Transponder is the element that sends and receives the optical 354 signal from a fiber. A transponder is typically characterized by its 355 data rate and the maximum distance the signal can travel. Channel 356 frequency, per channel input power, FEC and Modulation are also 357 associated with a transponder. From a path computation point of 358 view, the selection of the compatible source and destination 359 transponders is an important factor for optical signal to traverse 360 through the fiber. There are three main approaches to determine 361 optical signal compatibility. Application Code based on G.682.2 is 362 one approach that only checks the code at both ends of the 363 interface. Another approach is organization codes that are specific 364 to an organization or a vendor. The third approach is specify all 365 the relevant parameters explicitly, e.g., FEC type, Modulation type, 366 etc. 368 2.6. WSS/Filter 370 WSS separates the incoming light input spectrally as well as 371 spatially, then chooses the wavelength that is of interest by 372 deflecting it from the original optical path and then couple it to 373 another optical fibre port. WSS/Filter is internal to ROADM. So this 374 document does not model the inside of ROADM. 376 2.7. Optical Fiber 378 There are various optical fiber types defined by ITU-T. There are 379 several fiber-level parameters that need to be factored in, such as, 380 fiber-type, length, loss coefficient, pmd, connectors (in/out). 382 ITU-T G.652 defines Standard Singlemode Fiber; G.654 Cutoff Shifted 383 Fiber; G.655 Non-Zero Dispersion Shifted Fiber; G.656 Non-Zero 384 Dispersion for Wideband Optical Transport; G.657 Bend-Insensitive 385 Fiber. There may be other fiber-types that need to be considered. 387 3. YANG Model (Tree Structure) 389 module: ietf-optical-impairment-topology 390 augment /nw:networks/nw:network/nw:network-types/tet:te-topology: 391 +--rw optical-impairment-topology! 392 augment /nw:networks/nw:network/nt:link/tet:te/tet:te-link-attributes: 393 +--ro OMS-attributes 394 +--ro generalized-snr? decimal64 395 +--ro equalization-mode identityref 396 +--ro (power-param)? 397 | +--:(channel-power) 398 | | +--ro nominal-channel-power? decimal64 399 | +--:(power-spectral-density) 400 | +--ro nominal-power-spectral-density? decimal64 401 +--ro network-media-channel-group* [i] 402 | +--ro i int16 403 | +--ro current-channels* [flex-n] 404 | | +--ro flex-n uint16 405 | | +--ro flex-m? uint16 406 | +--ro OTSiG-container* [carrier-id] 407 | +--ro carrier-id int16 408 | +--ro OTSi-carrier-frequency? decimal64 409 | +--ro OTSi-signal-width? decimal64 410 | +--ro channel-delta-power? decimal64 411 +--ro OMS-elements* [elt-index] 412 +--ro elt-index uint16 413 +--ro uid? string 414 +--ro type identityref 415 +--ro element 416 +--ro (element)? 417 +--:(amplifier) 418 | +--ro amplifier 419 | +--ro type_variety string 420 | +--ro operational 421 | +--ro actual-gain decimal64 422 | +--ro tilt-target decimal64 423 | +--ro out-voa decimal64 424 | +--ro in-voa decimal64 425 | +--ro (power-param)? 426 | +--:(channel-power) 427 | | +--ro nominal-channel-power? decimal64 428 | +--:(power-spectral-density) 429 | +--ro nominal-power-spectral-density? decimal64 430 +--:(fiber) 431 | +--ro fiber 432 | +--ro type_variety string 433 | +--ro length decimal64 434 | +--ro loss_coef decimal64 435 | +--ro total_loss decimal64 436 | +--ro pmd? decimal64 437 | +--ro conn_in? decimal64 438 | +--ro conn_out? decimal64 439 +--:(concentratedloss) 440 +--ro concentratedloss 441 +--ro loss? decimal64 442 augment /nw:networks/nw:network/nw:node/tet:te/tet:tunnel-termination-point: 443 +--ro transponders-list* [transponder-id] 444 +--ro transponder-id uint32 445 +--ro (mode)? 446 | +--:(G.692.2) 447 | | +--ro G.692.2? layer0-types:standard-mode 448 | +--:(organizational_mode) 449 | | +--ro operational-mode? layer0-types:operational-mode 450 | | +--ro organization-identifier? layer0-types:vendor-identifier 451 | +--:(explicit_mode) 452 | +--ro available-modulation* identityref 453 | +--ro modulation-type? identityref 454 | +--ro available-baud-rates* uint32 455 | +--ro configured-baud-rate? uint32 456 | +--ro available-FEC* identityref 457 | +--ro FEC-type? identityref 458 | +--ro FEC-code-rate? decimal64 459 | +--ro FEC-threshold? decimal64 460 +--ro power? int32 461 +--ro power-min? int32 462 +--ro power-max? int32 463 augment /nw:networks/nw:network/nw:node/tet:te/tet:tunnel-termination-point: 464 +--ro transponder-list* [carrier-id] 465 +--ro carrier-id uint32 467 4. Optical Impairment Topology YANG Model 469 file ietf-optical-impairment-topology@2018-02-27.yang 471 module ietf-optical-impairment-topology { 472 yang-version 1.1; 474 namespace "urn:ietf:params:xml:ns:yang:ietf-optical-impairment-topology"; 476 prefix "optical-imp-topo"; 477 import ietf-network { 478 prefix "nw"; 479 } 481 import ietf-network-topology { 482 prefix "nt"; 483 } 485 import ietf-te-topology { 486 prefix "tet"; 487 } 489 import ietf-layer0-types { 490 prefix "layer0-types"; 491 } 493 organization 494 "IETF CCAMP Working Group"; 496 contact 497 "Editor: Young Lee 498 Editor: Haomian Zheng 499 Editor: Nicola Sambo 500 Editor: Victor Lopez 501 Editor: Gabriele Galimberti 502 Editor: Auge Jean-Luc 503 Editor: Le Rouzic Esther 504 Editor: Julien Meuric 505 Editor: Italo Busi "; 507 description 508 "This module contains a collection of YANG definitions for 509 impairment-aware optical networks. 511 Copyright (c) 2019 IETF Trust and the persons identified as 512 authors of the code. All rights reserved. 514 Redistribution and use in source and binary forms, with or 515 without modification, is permitted pursuant to, and subject 516 to the license terms contained in, the Simplified BSD 517 License set forth in Section 4.c of the IETF Trust's Legal 518 Provisions Relating to IETF Documents 519 (http://trustee.ietf.org/license-info)."; 521 revision 2019-02-27 { 522 description 523 "Initial Version"; 524 reference 525 "RFC XXXX: A Yang Data Model for Impairment-aware 526 Optical Networks"; 527 } 529 identity modulation { 530 description "base identity for modulation type"; 531 } 533 identity QPSK { 534 base modulation; 535 description 536 "QPSK (Quadrature Phase Shift Keying) modulation"; 537 } 539 identity DP_QPSK { 540 base modulation; 541 description 542 "DP-QPSK (Dual Polarization Quadrature 543 Phase Shift Keying) modulation"; 544 } 545 identity QAM8 { 546 base modulation; 547 description 548 "8QAM (8-State Quadrature Amplitude Modulation) modulation"; 549 } 550 identity QAM16 { 551 base modulation; 552 description 553 "QAM16 (Quadrature Amplitude Modulation)"; 554 } 555 identity DP_QAM8 { 556 base modulation; 557 description 558 "DP-QAM8 (Dual Polarization Quadrature Amplitude Modulation)"; 559 } 560 identity DC_DP_QAM8 { 561 base modulation; 562 description 563 "DC DP-QAM8 (Dual Polarization Quadrature Amplitude Modulation)"; 564 } 565 identity DP_QAM16 { 566 base modulation; 567 description 568 "DP-QAM16 (Dual Polarization Quadrature Amplitude Modulation)"; 569 } 570 identity DC_DP_QAM16 { 571 base modulation; 572 description 573 "DC DP-QAM16 (Dual Polarization Quadrature Amplitude Modulation)"; 575 } 577 identity FEC { 578 description 579 "Enumeration that defines the type of 580 Forward Error Correction"; 581 } 582 identity reed-solomon { 583 base FEC; 584 description 585 "Reed-Solomon error correction"; 586 } 587 identity hamming-code { 588 base FEC; 589 description 590 "Hamming Code error correction"; 591 } 592 identity golay { 593 base FEC; 594 description "Golay error correction"; 595 } 597 typedef fiber-type { 598 type enumeration { 599 enum G.652 { 600 description "G.652 Standard Singlemode Fiber"; 601 } 602 enum G.654 { 603 description "G.654 Cutoff Shifted Fiber"; 604 } 605 enum G.653 { 606 description "G.653 Dispersion Shifted Fiber"; 607 } 608 enum G.655 { 609 description "G.655 Non-Zero Dispersion Shifted Fiber"; 610 } 611 enum G.656 { 612 description "G.656 Non-Zero Dispersion for Wideband 613 Optical Transport"; 614 } 615 enum G.657 { 616 description "G.657 Bend-Insensitive Fiber"; 617 } 618 } 619 description 620 "ITU-T based fiber-types"; 621 } 622 grouping transponder-attributes { 623 description "Configuration of an optical transponder"; 625 leaf-list available-modulation { 626 type identityref { 627 base modulation; 628 } 629 config false; 630 description 631 "List determining all the available modulations"; 632 } 634 leaf modulation-type { 635 type identityref { 636 base modulation; 637 } 638 config false; 639 description 640 "Modulation configured for the transponder"; 641 } 643 leaf-list available-baud-rates { 644 type uint32; 645 units Bd; 646 config false; 647 description 648 "list of available baud-rates. Baud-rate is the unit for 649 symbol rate or modulation rate in symbols per second or 650 pulses per second. It is the number of distinct symbol 651 changes (signaling events) made to the transmission medium 652 per second in a digitally modulated signal or a line code"; 653 } 655 leaf configured-baud-rate { 656 type uint32; 657 units Bd; 658 config false; 659 description "configured baud-rate"; 660 } 662 leaf-list available-FEC { 663 type identityref { 664 base FEC; 665 } 666 config false; 667 description "List determining all the available FEC"; 668 } 670 leaf FEC-type { 671 type identityref { 672 base FEC; 673 } 674 config false; 675 description 676 "FEC type configured for the transponder"; 677 } 679 leaf FEC-code-rate { 680 type decimal64 { 681 fraction-digits 8; 682 range "0..max"; 683 } 684 config false; 685 description "FEC-code-rate"; 686 } 688 leaf FEC-threshold { 689 type decimal64 { 690 fraction-digits 8; 691 range "0..max"; 692 } 693 config false; 694 description 695 "Threshold on the BER, for which FEC is able to correct errors"; 696 } 698 } 700 grouping sliceable-transponder-attributes { 701 description 702 "Configuration of a sliceable transponder."; 703 list transponder-list { 704 key "carrier-id"; 705 config false; 706 description "List of carriers"; 707 leaf carrier-id { 708 type uint32; 709 config false; 710 description "Identifier of the carrier"; 711 } 712 } 713 } 715 grouping optical-fiber-data { 716 description 717 "optical link (fiber) attributes with impairment data"; 718 leaf fiber-type { 719 type fiber-type; 720 config false; 721 description "fiber-type"; 722 } 724 leaf span-length { 725 type decimal64 { 726 fraction-digits 2; 727 } 728 units "km"; 729 config false; 730 description "the lenght of the fiber span in km"; 731 } 733 leaf input-power { 734 type decimal64 { 735 fraction-digits 2; 736 } 737 units "dBm"; 738 config false; 739 description 740 "Average input power level estimated at the receiver 741 of the link"; 742 } 744 leaf output-power { 745 type decimal64 { 746 fraction-digits 2; 747 } 748 units "dBm"; 749 description 750 "Mean launched power at the transmitter of the link"; 751 } 753 leaf pmd { 754 type decimal64 { 755 fraction-digits 8; 756 range "0..max"; 757 } 758 units "ps/(km)^0.5"; 759 config false; 760 description 761 "Polarization Mode Dispersion"; 762 } 764 leaf cd { 765 type decimal64 { 766 fraction-digits 5; 767 } 768 units "ps/nm/km"; 769 config false; 770 description 771 "Cromatic Dispersion"; 772 } 774 leaf osnr { 775 type decimal64 { 776 fraction-digits 5; 777 } 778 units "dB"; 779 config false; 780 description 781 "Optical Signal-to-Noise Ratio (OSNR) estimated 782 at the receiver"; 783 } 785 leaf sigma { 786 type decimal64 { 787 fraction-digits 5; 788 } 789 units "dB"; 790 config false; 791 description 792 "sigma in the Gausian Noise Model"; 793 } 794 } 796 grouping optical-channel-data { 797 description 798 "optical impairment data per channel/wavelength"; 799 leaf bit-rate { 800 type decimal64 { 801 fraction-digits 8; 802 range "0..max"; 803 } 804 units "Gbit/s"; 805 config false; 806 description 807 "Gross bit rate"; 808 } 810 leaf BER { 811 type decimal64 { 812 fraction-digits 18; 813 range "0..max"; 814 } 815 config false; 816 description 817 "BER (Bit Error Rate)"; 819 } 821 leaf ch-input-power { 822 type decimal64 { 823 fraction-digits 2; 824 } 825 units "dBm"; 826 config false; 827 description 828 "Per channel average input power level 829 estimated at the receiver of the link"; 830 } 832 leaf ch-pmd { 833 type decimal64 { 834 fraction-digits 8; 835 range "0..max"; 836 } 837 units "ps/(km)^0.5"; 838 config false; 839 description 840 "per channel Polarization Mode Dispersion"; 841 } 843 leaf ch-cd { 844 type decimal64 { 845 fraction-digits 5; 846 } 847 units "ps/nm/km"; 848 config false; 849 description 850 "per channel Cromatic Dispersion"; 851 } 853 leaf ch-osnr { 854 type decimal64 { 855 fraction-digits 5; 856 } 857 units "dB"; 858 config false; 859 description 860 "per channel Optical Signal-to-Noise Ratio 861 (OSNR) estimated at the receiver"; 862 } 864 leaf q-factor { 865 type decimal64 { 866 fraction-digits 5; 867 } 868 units "dB"; 869 config false; 870 description 871 "q-factor estimated at the receiver"; 872 } 873 } 875 grouping standard_mode { 876 description 877 "ITU-T G.698.2 standard mode that guarantees interoperability. 878 It must be an string with the following format: 879 B-DScW-ytz(v) where all these attributes are conformant 880 to the ITU-T recomendation"; 882 leaf standard_mode { 883 type layer0-types:standard-mode; 884 config false; 885 description 886 "G.698.2 standard mode"; 887 } 888 } 890 grouping organizational_mode { 891 description 892 "Transponder operational mode supported by organizations or 893 vendor"; 895 leaf operational-mode { 896 type layer0-types:operational-mode; 897 config false; 898 description 899 "configured organization- or vendor-specific 900 application identifiers (AI) supported by the transponder"; 901 } 903 leaf organization-identifier { 904 type layer0-types:vendor-identifier; 905 config false; 906 description 907 "organization identifier that uses organizational 908 mode"; 910 } 911 } 913 /* 914 * Identities 915 */ 916 identity type-element { 917 description 918 "Base identity for element type"; 919 } 921 identity Fiber { 922 base type-element; 923 description 924 "Fiber element"; 925 } 927 identity Roadm { 928 base type-element; 929 description 930 "Roadm element"; 931 } 933 identity Edfa { 934 base type-element; 935 description 936 "Edfa element"; 937 } 939 identity Concentratedloss { 940 base type-element; 941 description 942 "Concentratedloss element"; 943 } 945 identity type-power-mode { 946 description 947 "power equalization mode used within the OMS and its elements"; 948 } 950 identity power-spectral-density { 951 base type-power-mode; 952 description 953 "all elements must use power spectral density (W/Hz)"; 954 } 956 identity channel-power { 957 base type-power-mode; 958 description 959 "all elements must use power (dBm)"; 960 } 962 /* 963 * Groupings 964 */ 965 grouping amplifier-params { 966 description "describes parameters for an amplifier"; 967 container amplifier{ 968 description "amplifier type, operatonal parameters are described"; 969 leaf type_variety { 970 type string ; 971 mandatory true ; 972 description 973 "String identifier of amplifier type referencing 974 a specification in a separate equipment catalog"; 975 } 976 container operational { 977 description "amplifier operationnal parameters"; 978 leaf actual-gain { 979 type decimal64 { 980 fraction-digits 2; 981 } 982 units dB ; 983 mandatory true ; 984 description ".."; 985 } 986 leaf tilt-target { 987 type decimal64 { 988 fraction-digits 2; 989 } 990 mandatory true ; 991 description ".."; 992 } 993 leaf out-voa { 994 type decimal64 { 995 fraction-digits 2; 996 } 997 units dB; 998 mandatory true; 999 description ".."; 1000 } 1001 leaf in-voa { 1002 type decimal64 { 1003 fraction-digits 2; 1004 } 1005 units dB; 1006 mandatory true; 1007 description ".."; 1008 } 1009 uses power-param; 1010 } 1011 } 1012 } 1014 grouping fiber-params { 1015 description "String identifier of fiber type referencing a specification in a 1016 separate equipment catalog"; 1017 container fiber { 1018 description "fiber characteristics"; 1019 leaf type_variety { 1020 type string ; 1021 mandatory true ; 1022 description "fiber type"; 1023 } 1024 leaf length { 1025 type decimal64 { 1026 fraction-digits 2; 1027 } 1028 units km; 1029 mandatory true ; 1030 description "length of fiber"; 1031 } 1032 leaf loss_coef { 1033 type decimal64 { 1034 fraction-digits 2; 1035 } 1036 units dB/km; 1037 mandatory true ; 1038 description "loss coefficient of the fiber"; 1039 } 1040 leaf total_loss { 1041 type decimal64 { 1042 fraction-digits 2; 1043 } 1044 units dB; 1045 mandatory true ; 1046 description 1047 "includes all losses: fiber loss and conn_in and conn_out losses"; 1048 } 1049 leaf pmd{ 1050 type decimal64 { 1051 fraction-digits 2; 1052 } 1053 units sqrt(ps); 1054 description "pmd of the fiber"; 1055 } 1056 leaf conn_in{ 1057 type decimal64 { 1058 fraction-digits 2; 1059 } 1060 units dB; 1061 description "connector-in"; 1062 } 1063 leaf conn_out{ 1064 type decimal64 { 1065 fraction-digits 2; 1066 } 1067 units dB; 1068 description "connector-out"; 1069 } 1070 } 1071 } 1073 grouping roadm-params{ 1074 description "roadm parameters description"; 1075 container roadm{ 1076 description "roadm parameters"; 1077 leaf type_variety { 1078 type string ; 1079 mandatory true ; 1080 description "String identifier of roadm type referencing a specification in a 1081 separate equipment catalog"; 1082 } 1083 leaf loss { 1084 type decimal64 { 1085 fraction-digits 2; 1086 } 1087 units dB ; 1088 description ".."; 1089 } 1090 } 1091 } 1093 grouping concentratedloss-params{ 1094 description "concentrated loss"; 1095 container concentratedloss{ 1096 description "concentrated loss"; 1097 leaf loss { 1098 type decimal64 { 1099 fraction-digits 2; 1100 } 1101 units dB ; 1102 description ".."; 1103 } 1104 } 1105 } 1107 grouping power-param{ 1108 description 1109 "optical power or PSD after the ROADM or after the out-voa"; 1110 choice power-param { 1111 description 1112 "select the mode: channel power or power spectral density"; 1114 case channel-power { 1115 /* when "../../equalization-mode='channel-power'"; */ 1116 leaf nominal-channel-power{ 1117 type decimal64 { 1118 fraction-digits 1; 1119 } 1120 units dBm ; 1121 description 1122 " Reference channel power after the ROADM or after the out-voa. "; 1123 } 1124 } 1125 case power-spectral-density{ 1126 /* when "../../equalization-mode='power-spectral-density'"; */ 1127 leaf nominal-power-spectral-density{ 1128 type decimal64 { 1129 fraction-digits 16; 1130 } 1131 units W/Hz ; 1132 description 1133 " Reference power spectral density after the ROADM or after the out-voa. 1134 Typical value : 3.9 E-14, resolution 0.1nW/MHz"; 1135 } 1136 } 1137 } 1138 } 1140 grouping oms-general-optical-params { 1141 description "OMS link optical parameters"; 1142 leaf generalized-snr { 1143 type decimal64 { 1144 fraction-digits 5; 1145 } 1146 units "dB@0.1nm"; 1147 description "generalized snr"; 1148 } 1149 leaf equalization-mode{ 1150 type identityref { 1151 base type-power-mode; 1152 } 1153 mandatory true; 1154 description "equalization mode"; 1155 } 1156 uses power-param; 1157 } 1159 grouping network-media-channel-group { 1160 description "network media channel group"; 1161 list network-media-channel-group { 1162 key "i"; 1163 description 1164 "list of network media channel group's member"; 1165 leaf i { 1166 type int16; 1167 description "index of network media channel group member"; 1168 } 1170 list current-channels { 1171 key "flex-n"; 1172 description 1173 "list of media channels in the OMS"; 1175 uses layer0-types:flex-grid-channel; 1176 } 1178 list OTSiG-container { 1179 key "carrier-id"; 1180 description 1181 "list of OTSi under OTSi-G"; 1182 leaf carrier-id { 1183 type int16; 1184 description "carrier-id under OTSi-G"; 1185 } 1186 leaf OTSi-carrier-frequency { 1187 type decimal64 { 1188 fraction-digits 3; 1189 } 1190 units GHz; 1191 config false; 1192 description 1193 "OTSi carrier frequency"; 1194 } 1195 leaf OTSi-signal-width { 1196 type decimal64 { 1197 fraction-digits 3; 1198 } 1199 units GHz; 1200 config false; 1201 description 1202 "OTSi signal width"; 1203 } 1204 leaf channel-delta-power { 1205 type decimal64 { 1206 fraction-digits 2; 1207 } 1208 units dB; 1209 config false; 1210 description 1211 "optional ; delta power to ref channel input-power applied to this 1212 channel"; 1213 } 1214 } 1215 } 1216 } 1218 grouping oms-element { 1219 description "OMS description"; 1220 list OMS-elements { 1221 key "elt-index"; 1222 description 1223 "defines the spans and the amplifier blocks of the amplified lines"; 1224 leaf elt-index { 1225 type uint16; 1226 description 1227 "ordered list of Index of OMS element (whether it's a Fiber, an EDFA or a 1228 Concentratedloss)"; 1229 } 1230 leaf uid { 1231 type string; 1232 description 1233 "unique id of the element if it exists"; 1234 } 1235 leaf type { 1236 type identityref { 1237 base type-element; 1238 } 1239 mandatory true; 1240 description "element type"; 1241 } 1243 container element { 1244 description "element of the list of elements of the OMS"; 1245 choice element { 1246 description "OMS element type"; 1247 case amplifier { 1248 /* when "../../type = 'Edfa'"; */ 1249 uses amplifier-params ; 1250 } 1251 case fiber { 1252 /* when "../../type = 'Fiber'"; */ 1253 uses fiber-params ; 1254 } 1255 case concentratedloss { 1256 /* when "../../type = 'Concentratedloss'"; */ 1257 uses concentratedloss-params ; 1258 } 1259 } 1261 } 1262 } 1263 } 1265 /* Data nodes */ 1267 augment "/nw:networks/nw:network/nw:network-types" 1268 + "/tet:te-topology" { 1269 description "optical-impairment topology augmented"; 1270 container optical-impairment-topology { 1271 presence "indicates an impairment-aware topology of optical networks"; 1272 description 1273 "Container to identify impairment-aware topology type"; 1274 } 1275 } 1277 augment "/nw:networks/nw:network/nt:link/tet:te" 1278 + "/tet:te-link-attributes" { 1279 when "/nw:networks/nw:network/nw:network-types" 1280 +"/tet:te-topology/optical-imp-topo:optical-impairment-topology" { 1281 description 1282 "This augment is only valid for Optical Impairment."; 1283 } 1284 description "Optical Link augmentation for impairment data."; 1285 container OMS-attributes { 1286 config false; 1287 description "OMS attributes"; 1288 uses oms-general-optical-params; 1289 uses network-media-channel-group; 1290 uses oms-element; 1291 } 1292 } 1294 augment "/nw:networks/nw:network/nw:node/tet:te" 1295 + "/tet:tunnel-termination-point" { 1296 when "/nw:networks/nw:network/nw:network-types" 1297 +"/tet:te-topology/optical-imp-topo:optical-impairment-topology" { 1298 description 1299 "This augment is only valid for Impairment with non-sliceable 1300 transponder model"; 1301 } 1302 description 1303 "Tunnel termination point augmentation for non-sliceable 1304 transponder model."; 1305 list transponders-list { 1306 key "transponder-id"; 1307 config false; 1308 description "list of transponders"; 1309 leaf transponder-id { 1310 type uint32; 1311 description "transponder identifier"; 1312 } 1314 choice mode { 1315 description "standard mode, organizational mode or explicit mode"; 1317 case G.692.2 { 1318 uses standard_mode; 1319 } 1321 case organizational_mode { 1322 uses organizational_mode; 1323 } 1325 case explicit_mode { 1326 uses transponder-attributes; 1327 } 1328 } 1330 leaf power { 1331 type int32; 1332 units "dBm"; 1333 config false; 1334 description "per channel power"; 1335 } 1337 leaf power-min { 1338 type int32; 1339 units "dBm"; 1340 config false; 1341 description "minimum power of the transponder"; 1342 } 1344 leaf power-max { 1345 type int32; 1346 units "dBm"; 1347 config false; 1348 description "maximum power of the transponder"; 1349 } 1350 } 1351 } 1353 augment "/nw:networks/nw:network/nw:node/tet:te" 1354 + "/tet:tunnel-termination-point" { 1355 when "/nw:networks/nw:network/nw:network-types" 1356 +"/tet:te-topology/optical-imp-topo:optical-impairment-topology" { 1357 description 1358 "This augment is only valid for optical impairment with sliceable 1359 transponder model"; 1360 } 1361 description 1362 "Tunnel termination point augmentation for sliceable transponder model."; 1363 uses sliceable-transponder-attributes; 1364 } 1365 } 1366 1368 5. Security Considerations 1370 The configuration, state, and action data defined in this document 1371 are designed to be accessed via a management protocol with a secure 1372 transport layer, such as NETCONF [RFC6241]. The NETCONF access 1373 control model [RFC6536] provides the means to restrict access for 1374 particular NETCONF users to a preconfigured subset of all available 1375 NETCONF protocol operations and content. 1377 A number of configuration data nodes defined in this document are 1378 read-only; however, these data nodes may be considered sensitive or 1379 vulnerable in some network environments (TBD). 1381 6. IANA Considerations 1383 This document registers the following namespace URIs in the IETF XML 1384 registry [RFC3688]: 1386 -------------------------------------------------------------------- 1387 URI: urn:ietf:params:xml:ns:yang:ietf-optical-impairment-topology 1388 Registrant Contact: The IESG. 1389 XML: N/A, the requested URI is an XML namespace. 1390 -------------------------------------------------------------------- 1392 This document registers the following YANG modules in the YANG 1393 Module Names registry [RFC7950]: 1395 -------------------------------------------------------------------- 1396 name: ietf-optical-impairment-topology 1397 namespace: urn:ietf:params:xml:ns:yang:ietf-optical-impairment- 1398 topology 1399 reference: RFC XXXX (TDB) 1400 -------------------------------------------------------------------- 1402 7. Acknowledgments 1404 We thank Dieter Bella and Sergio Belotti for useful discussions and 1405 motivation for this work. 1407 8. References 1409 8.1. Normative References 1411 8.2. Informative References 1413 [RFC6241] Enns, R., Ed., Bjorklund, M., Ed., Schoenwaelder, J., Ed., 1414 and A. Bierman, Ed., "Network Configuration Protocol 1415 (NETCONF)", RFC 6241, June 2011. 1417 [RFC6566] Y. Lee, G. Bernstein, D. Li, G. Martinelli, "A Framework 1418 for the Control of Wavelength Switched Optical Networks 1419 (WSONs) with Impairments", RFC 6566, March 2012. 1421 [RFC7446] Y. Lee, G. Bernstein, D. Li, W. Imajuku, "Routing and 1422 Wavelength Assignment Information Model for Wavelength 1423 Switched Optical Networks", RFC 7446, Feburary 2015. 1425 [RFC7579] G. Bernstein, Y. Lee, D. Li, W. Imajuku, "General 1426 Network Element Constraint Encoding for GMPLS Controlled 1427 Networks", RFC 7579, June 2015. 1429 [RFC7581] G. Bernstein, Y. Lee, D. Li, W. Imajuku, "Routing and 1430 Wavelength Assignment Information Encoding for Wavelength 1431 Switched Optical Networks", RFC 7581, June 2015. 1433 [RFC7950] Bjorklund, M., Ed., "The YANG 1.1 Data Modeling Language", 1434 RFC 7950, August 2016. 1436 [RFC8341] Bierman, A. and M. Bjorklund, "Network Configuration 1437 Access Control Model", RFC 8341, March 2018. 1439 [RFC8342] Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K., 1440 and R. Wilton, "Network Management Datastore Architecture 1441 (NMDA)", RFC 8342, March 2018. 1443 [RFC8345] A. Clemm, et al, "A YANG Data Model for Network 1444 Topologies", RFC 8345, March 2018. 1446 [TE-TOPO] X. Liu, et al., "YANG Data Model for TE Topologies", work 1447 in progress: draft-ietf-teas-yang-te-topo. 1449 [RFC8453] Ceccarelli, D. and Y. Lee, "Framework for Abstraction and 1450 Control of Traffic Engineered Networks", RFC 8453, August 1451 2018. 1453 [WSON-Topo] Y. Lee, Ed., "A Yang Data Model for WSON Optical 1454 Networks", draft-ietf-ccamp-wson-yang-13, work in 1455 progress. 1457 9. Contributors 1459 Jonas Martensson 1460 Acro 1462 Email: jonas.martensson@ri.se 1464 Authors' Addresses 1466 Young Lee 1467 Huawei Technologies 1469 Email: leeyoung@huawei.com 1471 Haomian Zheng 1472 Huawei Technologies 1474 Email: zhenghaomian@huawei.com 1476 Italo Busi 1477 Huawei Technologies 1479 Email: Italo.Busi@huawei.com 1481 Nicola Sambo 1482 Scuola Superiore Sant'Anna 1484 Email: nicosambo@gmail.com 1486 Victor Lopez 1487 Telefonica 1489 Email: victor.lopezalvarez@telefonica.com 1490 G. Galimberti 1491 Cisco 1493 Email: ggalimbe@cisco.com 1495 Giovanni Martinelli 1496 Cisco 1497 Email: giomarti@cisco.com 1499 AUGE Jean Luc 1500 Orange 1502 Email: jeanluc.auge@orange.com 1504 LE ROUZIC Esther 1505 Orange 1507 Email: esther.lerouzic@orange.com 1509 Julien Meuric 1510 Orange 1512 Email: julien.meuric@orange.com 1514 Dieter Beller 1515 Nokia 1517 Email: dieter.beller@nokia.com 1519 Sergio Belotti 1520 Nokia 1522 Email: Sergio.belotti@nokia.com 1524 Griseri Enrico 1525 Nokia 1527 Email: enrico.griseri@nokia.com 1529 Gert Grammel 1530 Juniper 1532 Email: ggrammel@juniper.net