idnits 2.17.1 draft-galimbe-ccamp-iv-yang-05.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 doesn't use any RFC 2119 keywords, yet seems to have RFC 2119 boilerplate text. -- The document date (March 1, 2018) is 2247 days in the past. Is this intentional? Checking references for intended status: Informational ---------------------------------------------------------------------------- == Missing Reference: 'RFC6566' is mentioned on line 158, but not defined == Missing Reference: 'ITU.G680' is mentioned on line 157, but not defined == Missing Reference: 'RFC6241' is mentioned on line 887, but not defined == Missing Reference: 'RFC6242' is mentioned on line 889, but not defined == Missing Reference: 'RFC6536' is mentioned on line 889, but not defined ** Obsolete undefined reference: RFC 6536 (Obsoleted by RFC 8341) == Missing Reference: 'RFC3688' is mentioned on line 897, but not defined == Missing Reference: 'RFC6020' is mentioned on line 911, but not defined == Unused Reference: 'ITU.G694.1' is defined on line 953, but no explicit reference was found in the text == Unused Reference: 'ITU.G709' is defined on line 964, but no explicit reference was found in the text == Unused Reference: 'ITU.G7710' is defined on line 969, but no explicit reference was found in the text == Unused Reference: 'ITU.G798' is defined on line 974, but no explicit reference was found in the text == Unused Reference: 'ITU.G8201' is defined on line 980, but no explicit reference was found in the text == Unused Reference: 'ITU.G826' is defined on line 986, but no explicit reference was found in the text == Unused Reference: 'ITU.G872' is defined on line 992, but no explicit reference was found in the text == Unused Reference: 'ITU.G874' is defined on line 997, but no explicit reference was found in the text == Unused Reference: 'ITU.G874.1' is defined on line 1002, but no explicit reference was found in the text == Unused Reference: 'ITU.G959.1' is defined on line 1008, but no explicit reference was found in the text == Unused Reference: 'RFC2578' is defined on line 1018, but no explicit reference was found in the text == Unused Reference: 'RFC2579' is defined on line 1024, but no explicit reference was found in the text == Unused Reference: 'RFC2580' is defined on line 1029, but no explicit reference was found in the text == Unused Reference: 'RFC2863' is defined on line 1034, but no explicit reference was found in the text == Unused Reference: 'RFC3591' is defined on line 1038, but no explicit reference was found in the text == Unused Reference: 'RFC6205' is defined on line 1043, but no explicit reference was found in the text == Unused Reference: 'I-D.ietf-ccamp-dwdm-if-mng-ctrl-fwk' is defined on line 1050, but no explicit reference was found in the text == Unused Reference: 'RFC2629' is defined on line 1056, but no explicit reference was found in the text == Unused Reference: 'RFC4054' is defined on line 1066, but no explicit reference was found in the text == Unused Reference: 'RFC4181' is defined on line 1071, but no explicit reference was found in the text == Outdated reference: A later version (-13) exists of draft-ietf-ccamp-dwdm-if-mng-ctrl-fwk-00 -- Obsolete informational reference (is this intentional?): RFC 2629 (Obsoleted by RFC 7749) Summary: 1 error (**), 0 flaws (~~), 30 warnings (==), 2 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 Internet Engineering Task Force G.Galimberti, Ed. 3 Internet-Draft Cisco 4 Intended status: Informational R.Kunze 5 Expires: September 2, 2018 Deutsche Telekom 6 D. Hiremagalur, Ed. 7 G. Grammel, Ed. 8 Juniper 9 March 1, 2018 11 A YANG model to manage the optical parameters for in a WDM network 12 draft-galimbe-ccamp-iv-yang-05 14 Abstract 16 This memo defines a Yang model that translate the information model 17 to support Impairment-Aware (IA) Routing and Wavelength Assignment 18 (RWA) functionality. The information model is defined in draft-ietf- 19 ccamp-wson-iv-info and draft-martinelli-ccamp-wson-iv-encode. This 20 document defines proper encoding and extend to the models defined in 21 draft-lee-ccamp-wson-yang tu support Impairment-Aware (IA) Routing 22 and Wavelength Assignment (RWA) functions 24 The Yang model defined in this memo can be used for Optical 25 Parameters monitoring and/or configuration of the multivendor 26 Endpoints and ROADMs 28 Copyright Notice 30 Copyright (c) 2014 IETF Trust and the persons identified as the 31 document authors. All rights reserved. 33 Status of This Memo 35 This Internet-Draft is submitted in full conformance with the 36 provisions of BCP 78 and BCP 79. 38 Internet-Drafts are working documents of the Internet Engineering 39 Task Force (IETF). Note that other groups may also distribute 40 working documents as Internet-Drafts. The list of current Internet- 41 Drafts is at https://datatracker.ietf.org/drafts/current/. 43 Internet-Drafts are draft documents valid for a maximum of six months 44 and may be updated, replaced, or obsoleted by other documents at any 45 time. It is inappropriate to use Internet-Drafts as reference 46 material or to cite them other than as "work in progress." 48 This Internet-Draft will expire on September 2, 2018. 50 Copyright Notice 52 Copyright (c) 2018 IETF Trust and the persons identified as the 53 document authors. All rights reserved. 55 This document is subject to BCP 78 and the IETF Trust's Legal 56 Provisions Relating to IETF Documents 57 (https://trustee.ietf.org/license-info) in effect on the date of 58 publication of this document. Please review these documents 59 carefully, as they describe your rights and restrictions with respect 60 to this document. Code Components extracted from this document must 61 include Simplified BSD License text as described in Section 4.e of 62 the Trust Legal Provisions and are provided without warranty as 63 described in the Simplified BSD License. 65 Table of Contents 67 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3 68 2. The Internet-Standard Management Framework . . . . . . . . . 3 69 3. Conventions . . . . . . . . . . . . . . . . . . . . . . . . . 4 70 4. Definition . . . . . . . . . . . . . . . . . . . . . . . . . 4 71 5. Applicability . . . . . . . . . . . . . . . . . . . . . . . . 4 72 6. Properties . . . . . . . . . . . . . . . . . . . . . . . . . 4 73 7. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 4 74 7.1. Optical Parameters Description . . . . . . . . . . . . . 5 75 7.1.1. Optical path from point Ss to Rs . . . . . . . . . . 6 76 7.1.2. Rs and Ss Configuration . . . . . . . . . . . . . . . 7 77 7.1.3. Table of Application Codes . . . . . . . . . . . . . 7 78 7.2. Use Cases . . . . . . . . . . . . . . . . . . . . . . . . 7 79 7.3. Optical Parameters for impairment validation in a WDM 80 network . . . . . . . . . . . . . . . . . . . . . . . . . 7 81 8. Structure of the Yang Module . . . . . . . . . . . . . . . . 8 82 9. Yang Module . . . . . . . . . . . . . . . . . . . . . . . . . 9 83 10. Security Considerations . . . . . . . . . . . . . . . . . . . 20 84 11. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 20 85 12. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 20 86 13. Contributors . . . . . . . . . . . . . . . . . . . . . . . . 20 87 14. References . . . . . . . . . . . . . . . . . . . . . . . . . 21 88 14.1. Normative References . . . . . . . . . . . . . . . . . . 21 89 14.2. Informative References . . . . . . . . . . . . . . . . . 23 90 Appendix A. Change Log . . . . . . . . . . . . . . . . . . . . . 24 91 Appendix B. Open Issues . . . . . . . . . . . . . . . . . . . . 24 92 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 24 94 1. Introduction 96 This memo defines a Yang model that translates the existing mib 97 module defined in draft-ietf-ccamp-wson-iv-info and draft-martinelli- 98 ccamp-wson-iv-encode to provide the network impairment information to 99 an SDN controller. One of the key SDN controller features is to 100 support multi vendor network and support the service calculation and 101 deployment in multilayer topologies, for the DWDM layer it is 102 fundamentad that the SDN controller is aware of the optical 103 impairments to verify the feasibility of new circuits before their 104 provisioning. Although SDN controller will not apply exhaustive and 105 accurate algorithms and the optical channel feasibility verification 106 may have a degree of unreliability this function can work on a 107 multivendor common set of parameter and algorithms to ensure the 108 operator the best change to set a circuit. This document follows the 109 same impairment definition and applicability of draft-ietf-ccamp- 110 wson-iv-info. 112 The optical impairments related to the DWDM Transceiver are described 113 by draft draft-dharini-ccamp-if-param-yang. Applications are defined 114 in G.698.2 [ITU.G698.2] using optical interface parameters at the 115 single-channel connection points between optical transmitters and the 116 optical multiplexer, as well as between optical receivers and the 117 optical demultiplexer in the DWDM system. This Recommendation uses a 118 methodology which explicitly specify the details of the optical 119 network between reference point Ss and Rs, e.g., the passive and 120 active elements or details of the design. 122 This draft refers and supports the draft-ietf-ccamp-dwdm-if-mng-ctrl- 123 fwk 125 The building of a yang model describing the optical parameters allows 126 the different vendors and operator to retrieve, provision and 127 exchange information across multi-vendor domains in a standardized 128 way. In addition to the parameters specified in ITU recommendations 129 the Yang models support also the "vendor specific parameters". 131 2. The Internet-Standard Management Framework 133 For a detailed overview of the documents that describe the current 134 Internet-Standard Management Framework, please refer to section 7 of 135 RFC 3410 [RFC3410]. 137 This memo specifies a Yang model for optical interfaces. 139 3. Conventions 141 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", 142 "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this 143 document are to be interpreted as described in RFC 2119 [RFC2119] In 144 the description of OIDs the convention: Set (S) Get (G) and Trap (T) 145 conventions will describe the action allowed by the parameter. 147 4. Definition 149 For a detailed definition this draft refers to draft-ietf-ccamp-wson- 150 iv-info. 152 5. Applicability 154 This document targets at Scenario C defined in [RFC6566] section 155 4.1.1. as approximate impairment estimation. The Approximate 156 concept refer to the fact that this Information Model covers 157 information mainly provided by [ITU.G680] Computational Model. 158 Although the [RFC6566] provides no or little approximation the 159 parameters described in this draft can be applied to the algorithms 160 verifying the circuit feasibility in the new coherent non compensated 161 DWDM networks In this case the impairments verification can reach a 162 good reliability and accuracy. This draft does not address 163 computational matters but provides all the information suitable to 164 cover most of the full coherent network algoritms, not being 165 exhaustive the information can give a acceptable or even good 166 approximation in therm of connection feasibility. This may not be 167 true for legacy compensated network. 169 6. Properties 171 For the signal properties this traft refers the draft-ietf-ccamp- 172 wson-iv-info Ch.2.3 with some extension of the parameters. 174 7. Overview 175 Figure 1 shows a set of reference points, for single-channel 176 connection between transmitters (Tx) and receivers (Rx). Here the 177 DWDM network elements include an OM and an OD (which are used as a 178 pair with the opposing element), one or more optical amplifiers and 179 may also include one or more OADMs. 181 +-------------------------------------------------+ 182 Ss | DWDM Network | Rs 183 +--+ | | | \ / | | | +--+ 184 Tx L1--|->| \ / |--|-->Rx L1 185 +---+ | | | +------+ | | | +--+ 186 +---+ | | | | | | | | +--+ 187 Tx L2--|->| OM |------------>|ROADM |-- -------->| OD |--|-->Rx L2 188 +---+ | | | DWDM | | DWDM | | | +--+ 189 +---+ | | | Link +------+ Link | | | +--+ 190 Tx L3--|->| / | ^ \ |--|-->Rx L3 191 +---+ | | / | | \ | | +--+ 192 +-----------------------|--|----------------------+ 193 +--+ +--+ 194 | | 195 Rs v | Ss 196 +-----+ +-----+ 197 |RxLx | |TxLx | 198 +-----+ +-----+ 199 Ss = reference point at the DWDM network element tributary output 200 Rs = reference point at the DWDM network element tributary input 201 Lx = Lambda x 202 OM = Optical Mux 203 OD = Optical Demux 204 ROADM = Reconfigurable Optical Add Drop Mux 206 from Fig. 5.1/G.698.2 208 Figure 1: External transponder in WDM netwoks 210 7.1. Optical Parameters Description 212 The link between the external transponders through a WDM network 213 media channels are managed at the edges, i.e. at the transmitters 214 (Tx) and receivers (Rx) attached to the S and R reference points 215 respectively. The set of parameters that could be managed are 216 defined by the "application code" notation 218 The definitions of the optical parameters are provided below to 219 increase the readability of the document, where the definition is 220 ended by (R) the parameter can be retrieve with a read, when (W) it 221 can be provisioned by a write, (R,W) can be either read or written. 223 7.1.1. Optical path from point Ss to Rs 225 The following parameters for the optical path from point S and R are 226 defined in G.698.2 [ITU.G698.2]. 228 Maximum and minimum (residual) chromatic dispersion: 229 These parameters define the maximum and minimum value of the 230 optical path "end to end chromatic dispersion" (in ps/nm) that the 231 system shall be able to tolerate. (R) 233 Minimum optical return loss at Ss: 234 These parameter defines minimum optical return loss (in dB) of the 235 cable plant at the source reference point (Ss), including any 236 connectors (R) 238 Maximum discrete reflectance between Ss and Rs: 239 Optical reflectance is defined to be the ratio of the reflected 240 optical power present at a point, to the optical power incident to 241 that point. Control of reflections is discussed extensively in 242 ITU-T Rec. G.957 (R) 244 Maximum differential group delay: 245 Differential group delay (DGD) is the time difference between the 246 fractions of a pulse that are transmitted in the two principal 247 states of polarization of an optical signal. For distances 248 greater than several kilometres, and assuming random (strong) 249 polarization mode coupling, DGD in a fibre can be statistically 250 modelled as having a Maxwellian distribution. (R) 252 Maximum polarization dependent loss: 253 The polarization dependent loss (PDL) is the difference (in dB) 254 between the maximum and minimum values of the channel insertion 255 loss (or gain) of the black link from point SS to RS due to a 256 variation of the state of polarization (SOP) over all SOPs. (R) 258 Maximum inter-channel crosstalk: 259 Inter-channel crosstalk is defined as the ratio of total power in 260 all of the disturbing channels to that in the wanted channel, 261 where the wanted and disturbing channels are at different 262 wavelengths. The parameter specify the isolation of a link 263 conforming to the "black link" approach such that under the worst- 264 case operating conditions the inter-channel crosstalk at any 265 reference point RS is less than the maximum inter-channel 266 crosstalk value (R) 268 Maximum interferometric crosstalk: 269 This parameter places a requirement on the isolation of a link 270 conforming to the "black link" approach such that under the worst 271 case operating conditions the interferometric crosstalk at any 272 reference point RS is less than the maximum interferometric 273 crosstalk value. (R) 275 Maximum optical path OSNR penalty: 276 The optical path OSNR penalty is defined as the difference between 277 the Lowest OSNR at Rs and Lowest OSNR at Ss that meets the BER 278 requirement (R) 280 Maximum ripple: 281 Although is defined in G.698.2 (R). 283 7.1.2. Rs and Ss Configuration 285 For the Rs and Ss configuration this draft refers the draft-dharini- 286 ccamp-dwdm-if-param-yang while for the Rs-Ss extended parameters for 287 coherent transmission interfaces refer to draft-dharini-ccamp-dwdm- 288 if-param-yang 290 7.1.3. Table of Application Codes 292 For Application Codes configuration this draft refers the draft- 293 dharini-ccamp-dwdm-if-param-yang 295 7.2. Use Cases 297 The use cases are described in draft-ietf-ccamp-dwdm-if-mng-ctrl-fwk 299 7.3. Optical Parameters for impairment validation in a WDM network 301 The ietf-opt-parameters-wdm is an augment to the ????. It allows the 302 user to get and set the application Optical Parameters of a DWDM 303 network. 305 module: ietf-opt-parameters-wdm 306 augment /if:interfaces/if:interface: 307 +--rw optical-transport 308 | +--rw attenuator-value? attenuator-t 309 | +--rw offset? decimal64 310 | +--rw channel-power-ref? decimal64 311 | +--rw tilt-calibration? tilt-t 312 +--rw opwr-threshold-warning 313 | +--rw opwr-min? dbm-t 314 | +--rw opwr-min-clear? dbm-t 315 | +--rw opwr-max? dbm-t 316 +--rw gain-degrade-alarm 317 | +--rw gain-degrade-low? dbm-t 318 | +--rw gain-degrade-high? dbm-t 319 +--rw power-degrade-high-alarm 320 | +--rw gain-degrade-high? dbm-t 321 +--rw power-degrade-low-alarm 322 | +--ro power-degrade-low? dbm-t 323 +--rw noise 324 | +--rw noise? decimal64 325 +--rw noise-sigma 326 | +--rw noise? decimal64 327 +--rw chromatic-dispersion 328 | +--rw noise-sigma? decimal64 329 +--rw chromatic-dispersion-slope 330 | +--rw chromatic-dispersion-slope? decimal64 331 +--rw pmd 332 | +--rw pmd? decimal64 333 +--rw pdl 334 | +--rw pdl? decimal64 335 +--rw drop-power 336 | +--rw drop-power? decimal64 337 +--rw drop-power-sigma 338 | +--rw noise? decimal64 339 +--rw ripple 340 | +--rw drop-power-sigma? decimal64 341 +--ro ch-noise-figure 342 | +--ro ch-noise-figure* [ch-noise-fig] 343 | +--ro ch-noise-fig ch-noise-figure-point 344 | +--ro input-to-output? decimal64 345 | +--ro input-to-drop? decimal64 346 | +--ro add-to-output? decimal64 347 +--rw dgd 348 | +--rw dgd? decimal64 349 +--ro ch-isolation 350 | +--ro ch-isolation* [ch-isolat] 351 | +--ro ch-isolat ch-isolation-cross 352 | +--ro ad-ch-isol? decimal64 353 | +--ro no-ad-ch-iso? decimal64 354 +--rw ch-extinction 355 +--rw cer? decimal64 357 8. Structure of the Yang Module 359 ietf-opt-parameters-wdm is a top level model for the support of this 360 feature. 362 9. Yang Module 364 The ietf-opt-parameters-wdm is defined as an extension to ietf 365 interfaces ????. 367 file "ietf-opt-parameters-wdm.yang" 369 module ietf-opt-parameters-wdm { 370 namespace "urn:ietf:params:xml:ns:yang:ietf-opt-parameters-wdm"; 371 prefix iietf-opt-parameters-wdm; 373 import ietf-interfaces { 374 prefix if; 375 } 377 import iana-if-type { 378 prefix ianaift; 379 } 381 organization 382 "IETF CCAMP 383 Working Group"; 385 contact 386 "WG Web: 387 WG List: 389 Editor: Gabriele Galimberti 390 "; 392 description 393 "This module contains a collection of YANG definitions for 394 collecting and configuring Optical Parameters 395 in Optical Networks and calculate the circuit feasibility. 397 Copyright (c) 2016 IETF Trust and the persons identified 398 as authors of the code. All rights reserved. 400 Redistribution and use in source and binary forms, with or 401 without modification, is permitted pursuant to, and 402 subject to the license terms contained in, the Simplified 403 BSD License set forth in Section 4.c of the IETF Trust's 404 Legal Provisions Relating to IETF Documents 405 (http://trustee.ietf.org/license-info)."; 407 revision "2018-03-06" { 408 description 409 "Revision 1.0"; 410 reference 411 ""; 412 } 413 revision "2016-10-30" { 414 description 415 "Initial revision."; 416 reference 417 "RFC XXXX: A YANG Data Model for Optical Paramenters 418 of DWDM Networks 419 "; 420 } 422 typedef tilt-t { 423 type decimal64 { 424 fraction-digits 2; 425 range "-5..5"; 426 } 427 description "Tilt Type"; 428 } 430 typedef signal-output-power-t { 431 type decimal64 { 432 fraction-digits 2; 433 range "-10..30"; 434 } 435 description " 436 Amplifier Power provisioning "; 437 } 439 typedef active-channel-t { 440 type union { 441 type uint8 { 442 range "0..200"; 443 } 444 } 445 description " 446 Number of channels active on a span - and on an amplifier"; 447 } 449 typedef dbm-t { 450 type decimal64 { 451 fraction-digits 2; 452 range "-50..-30 | -10..5 | 10000000"; 453 } 454 description " 455 Amplifier Power in dBm "; 456 } 458 typedef attenuator-t { 459 type decimal64 { 460 fraction-digits 2; 461 range "-15..-5"; 462 } 463 description " 464 Attenuation value (attenuator) applied after the Amplifier"; 465 } 467 typedef ch-noise-figure-point { 468 type decimal64 { 469 fraction-digits 2; 470 range "-15..-5"; 471 } 472 description " 473 Amplifier noise figure of point power"; 474 } 476 typedef ch-isolation-cross { 477 type decimal64 { 478 fraction-digits 2; 479 range "-15..-5"; 480 } 481 description " 482 cross channel isolation value"; 483 } 485 grouping opwr-threshold-warning-grp { 486 description " 487 Minimum Optical Power threshold 488 - this is used to rise Power alarm "; 490 leaf opwr-min { 491 type dbm-t; 492 units "dBm"; 493 default -1; 494 description "Minimum Power Value"; 495 } 497 leaf opwr-min-clear { 498 type dbm-t; 499 units "dBm"; 500 default -1; 501 description "threshold to clear Minimum Power value Alarm"; 502 } 504 leaf opwr-max { 505 type dbm-t; 506 units "dBm"; 507 default 1; 508 description " 509 Maximum Optical Power threshold 510 - this is used to rise Power alarm "; 511 } 512 } 514 grouping gain-degrade-alarm-grp { 515 description " 516 Low Optical Power gain threshold 517 - this is used to rise Power alarm "; 519 leaf gain-degrade-low { 520 type dbm-t; 521 units "dBm"; 522 default -1; 523 description "Low Gain Degrade Value"; 524 } 526 leaf gain-degrade-high { 527 type dbm-t; 528 units "dBm"; 529 default 1; 530 description " 531 High Optical Power gain threshold 532 - this is used to rise Power alarm "; 533 } 534 } 536 grouping power-degrade-high-alarm-grp { 537 description " 538 High Optical Power gain alarm "; 540 leaf gain-degrade-high { 541 type dbm-t; 542 units "dBm"; 543 default 1; 544 description "Low Gain Degrade Value"; 545 } 547 } 549 grouping power-degrade-low-alarm-grp { 550 description " 551 Low Optical Power gain alarm "; 553 leaf power-degrade-low { 554 type dbm-t; 555 units "dBm"; 556 default -1; 557 config false; 558 description "High Gain Degrade Value"; 559 } 560 } 562 grouping noise-grp { 563 description "Noise feasibility"; 564 leaf noise { 565 type decimal64 { 566 fraction-digits 2; 567 } 568 units "dB"; 569 description "Noise feasibility - reference ITU-T G.680 570 OSNR added to the signal by the OMS. The noise is intended 571 per channel and is independent of the number of active 572 channels in OMS"; 573 } 574 } 576 grouping noise-sigma-grp { 577 description "Noise sigma feasibility"; 578 leaf noise-sigma { 579 type decimal64 { 580 fraction-digits 2; 581 } 582 units "dB"; 583 description "Noise Sigma feasibility - accuracy of the 584 OSNR added to 585 the signal by the OMS"; 586 } 587 } 589 grouping chromatic-dispersion-grp { 590 description "Chromatic Dispersion"; 591 leaf chromatic-dispersion { 592 type decimal64 { 593 fraction-digits 2; 594 } 595 units "ps/nm"; 596 description "Chromatic Dispersion (CD) related to the OMS"; 597 } 598 } 600 grouping chromatic-dispersion-slope-grp { 601 description "Chromatic Dispersion slope"; 602 leaf chromatic-dispersion-slope { 603 type decimal64 { 604 fraction-digits 2; 605 } 606 units "ps/nm^2"; 607 description "Chromatic Dispersion (CD) Slope related to 608 the OMS"; 609 } 610 } 612 grouping pmd-grp { 613 description "Polarization Mode Dispersion"; 614 leaf pmd { 615 type decimal64 { 616 fraction-digits 2; 617 } 618 units "ps"; 619 description "Polarization Mode Dispersion (PMD) related 620 to OMS"; 621 } 622 } 624 grouping pdl-grp { 625 description "Polarization Dependent Loss"; 626 leaf pdl { 627 type decimal64 { 628 fraction-digits 2; 629 } 630 units "dB"; 631 description "Polarization Dependent Loss (PDL) related to 632 the OMS"; 633 } 634 } 636 grouping drop-power-grp { 637 description "Drop power at DWDM if RX feasibility"; 638 leaf drop-power { 639 type decimal64 { 640 fraction-digits 2; 642 } 643 units "dBm"; 644 description "Drop Power value at the DWDM Transceiver RX 645 side"; 646 } 647 } 649 grouping drop-power-sigma-grp { 650 description "Drop power sigma at DWDM if RX feasibility "; 651 leaf drop-power-sigma { 652 type decimal64 { 653 fraction-digits 2; 654 } 655 units "db"; 656 description "Drop Power Sigma value at the DWDM Transceiver 657 RX side"; 658 } 659 } 661 grouping ripple-grp { 662 description "Channel Ripple"; 663 leaf ripple { 664 type decimal64 { 665 fraction-digits 2; 666 } 667 units "db"; 668 description "Channel Ripple"; 669 } 670 } 672 grouping ch-noise-figure-grp { 673 list ch-noise-figure { 674 key "ch-noise-fig"; 675 description "Channel signal-spontaneous noise figure"; 677 leaf ch-noise-fig { 678 type ch-noise-figure-point; 679 description "Channel signal-spontaneous noise 680 figure point"; 681 } 683 leaf input-to-output { 684 type decimal64 { 685 fraction-digits 2; 686 } 687 units "dB"; 688 description "from input port to output port"; 689 } 691 leaf input-to-drop { 692 type decimal64 { 693 fraction-digits 2; 694 } 695 units "dB"; 696 description "from input port to drop port"; 697 } 699 leaf add-to-output { 700 type decimal64 { 701 fraction-digits 2; 702 } 703 units "dB"; 704 description "from add port to output port"; 705 } 706 } 707 description "Channel signal-spontaneous noise figure"; 708 } 710 grouping dgd-grp { 711 description "Differential Group Delay"; 712 leaf dgd { 713 type decimal64 { 714 fraction-digits 2; 715 } 716 units "db"; 717 description "differential group delay"; 718 } 719 } 721 grouping ch-isolation-grp { 722 list ch-isolation { 723 key "ch-isolat"; 724 description "adjacent and not adjacent channel isolation"; 726 leaf ch-isolat { 727 type ch-isolation-cross; 728 description "channel isolation from adjacent"; 729 } 731 leaf ad-ch-isol { 732 type decimal64 { 733 fraction-digits 2; 734 } 735 units "dB"; 736 description "adjecent channel isolation"; 737 } 739 leaf no-ad-ch-iso { 740 type decimal64 { 741 fraction-digits 2; 742 } 743 units "dB"; 744 description "non adjecent channel isolation"; 745 } 746 } 747 description "djacent and not adjacent channel isolation"; 748 } 750 grouping ch-extinction-grp { 751 description "Channel Extinsion"; 752 leaf cer { 753 type decimal64 { 754 fraction-digits 2; 755 } 756 units "db"; 757 description "channel extinction"; 758 } 759 } 761 grouping att-coefficient-grp { 762 description "Attenuation coefficient (for a fibre segment)"; 763 leaf att { 764 type decimal64 { 765 fraction-digits 2; 766 } 767 units "db"; 768 description "Attenuation coefficient (for a fibre segment)"; 769 } 770 } 772 augment "/if:interfaces/if:interface" { 773 when "if:type = 'ianaift:opticalTransport'" { 774 description "Specific optical-transport Interface Data"; 775 } 776 description "Specific optical-transport Interface Data"; 777 container optical-transport { 778 description "Specific optical-transport Data"; 780 leaf attenuator-value { 781 type attenuator-t; 782 description "External attenuator value "; 783 } 785 leaf offset { 786 type decimal64 { 787 fraction-digits 2; 788 range "-30..30"; 789 } 790 description "Raman and power amplifiers offset"; 791 } 793 leaf channel-power-ref { 794 type decimal64 { 795 fraction-digits 2; 796 range "-10..15"; 797 } 798 description "Optical power per channel"; 799 } 801 leaf tilt-calibration { 802 type tilt-t; 803 description "Amplifier Tilt tuning"; 804 } 805 } 806 container opwr-threshold-warning { 807 description "Optical power threshold warning"; 808 uses opwr-threshold-warning-grp; 809 } 810 container gain-degrade-alarm { 811 description "Gain degrade alarm"; 812 uses gain-degrade-alarm-grp; 813 } 814 container power-degrade-high-alarm { 815 description "Power degrade high aparm"; 816 uses power-degrade-high-alarm-grp; 817 } 818 container power-degrade-low-alarm { 819 description "Power degrade low alarm"; 820 uses power-degrade-low-alarm-grp; 821 } 822 container noise { 823 description "Channel Noise feasibility"; 824 uses noise-grp; 825 } 826 container noise-sigma { 827 description "Channel Noise sigma feasibility"; 828 uses noise-grp; 829 } 830 container chromatic-dispersion { 831 description "Chromatic Dispersion"; 832 uses noise-sigma-grp; 833 } 835 container chromatic-dispersion-slope { 836 description "Chromatic Dispersion slope"; 837 uses chromatic-dispersion-slope-grp; 838 } 839 container pmd { 840 description "Polarization Mode Dispersion"; 841 uses pmd-grp; 842 } 843 container pdl { 844 description "Polarization Dependent Loss"; 845 uses pdl-grp; 846 } 847 container drop-power { 848 description "Drop power at DWDM if RX feasibility"; 849 uses drop-power-grp; 850 } 851 container drop-power-sigma { 852 description "Drop power sigma at DWDM if RX feasibility"; 853 uses noise-grp; 854 } 855 container ripple { 856 description "Channel Ripple"; 857 uses drop-power-sigma-grp; 858 } 859 container ch-noise-figure { 860 config false; 861 description "Channel signal-spontaneous noise figure"; 862 uses ch-noise-figure-grp; 863 } 864 container dgd { 865 description "Differential Group Delay"; 866 uses dgd-grp; 867 } 868 container ch-isolation { 869 config false; 870 description "adjacent and not adjacent channel isolation"; 871 uses ch-isolation-grp; 872 } 873 container ch-extinction { 874 description "Channel Extinsion"; 875 uses ch-extinction-grp; 876 } 878 } 879 } 880 } 882 884 10. Security Considerations 886 The YANG module defined in this memo is designed to be accessed via 887 the NETCONF protocol [RFC6241]. he lowest NETCONF layer is the secure 888 transport layer and the mandatory-to-implement secure transport is 889 SSH [RFC6242]. The NETCONF access control model [RFC6536] provides 890 the means to restrict access for particular NETCONF users to a pre- 891 configured subset of all available NETCONF protocol operation and 892 content. 894 11. IANA Considerations 896 This document registers a URI in the IETF XML registry [RFC3688]. 897 Following the format in [RFC3688], the following registration is 898 requested to be made: 900 URI: urn:ietf:params:xml:ns:yang:ietf-interfaces:ietf-ext-xponder- 901 wdm-if 903 Registrant Contact: The IESG. 905 XML: N/A, the requested URI is an XML namespace. 907 This document registers a YANG module in the YANG Module Names 908 registry [RFC6020]. 910 This document registers a YANG module in the YANG Module Names 911 registry [RFC6020]. 913 prefix: ietf-ext-xponder-wdm-if reference: RFC XXXX 915 12. Acknowledgements 917 Marco Cardani. 919 13. Contributors 920 Dean Bogdanovic 921 Juniper Networks 922 Westford 923 U.S.A. 924 email deanb@juniper.net 926 Walid Wakim 927 Cisco 928 9501 Technology Blvd 929 ROSEMONT, ILLINOIS 60018 930 UNITED STATES 931 email wwakim@cisco.com 933 Marco Cardani 934 Cisco 935 vis S.Maria Molgora, 48c 936 20871 - Vimercate 937 Monza Brianza 938 Italy 939 email mcardani@cisco.com 941 Giovanni Martinelli 942 Cisco 943 vis S.Maria Molgora, 48c 944 20871 - Vimercate 945 Monza Brianza 946 Italy 947 email giomarti@cisco.com 949 14. References 951 14.1. Normative References 953 [ITU.G694.1] 954 International Telecommunications Union, "Spectral grids 955 for WDM applications: DWDM frequency grid", 956 ITU-T Recommendation G.694.1, June 2002. 958 [ITU.G698.2] 959 International Telecommunications Union, "Amplified 960 multichannel dense wavelength division multiplexing 961 applications with single channel optical interfaces", 962 ITU-T Recommendation G.698.2, November 2009. 964 [ITU.G709] 965 International Telecommunications Union, "Interface for the 966 Optical Transport Network (OTN)", ITU-T Recommendation 967 G.709, March 2003. 969 [ITU.G7710] 970 International Telecommunications Union, "Common equipment 971 management function requirements", ITU-T Recommendation 972 G.7710, May 2008. 974 [ITU.G798] 975 International Telecommunications Union, "Characteristics 976 of optical transport network hierarchy equipment 977 functional blocks", ITU-T Recommendation G.798, October 978 2010. 980 [ITU.G8201] 981 International Telecommunications Union, "Error performance 982 parameters and objectives for multi-operator international 983 paths within the Optical Transport Network (OTN)", 984 ITU-T Recommendation G.8201, April 2011. 986 [ITU.G826] 987 International Telecommunications Union, "End-to-end error 988 performance parameters and objectives for international, 989 constant bit-rate digital paths and connections", 990 ITU-T Recommendation G.826, November 2009. 992 [ITU.G872] 993 International Telecommunications Union, "Architecture of 994 optical transport networks", ITU-T Recommendation G.872, 995 November 2001. 997 [ITU.G874] 998 International Telecommunications Union, "Management 999 aspects of optical transport network elements", 1000 ITU-T Recommendation G.874, July 2010. 1002 [ITU.G874.1] 1003 International Telecommunications Union, "Optical transport 1004 network (OTN): Protocol-neutral management information 1005 model for the network element view", ITU-T Recommendation 1006 G.874.1, January 2002. 1008 [ITU.G959.1] 1009 International Telecommunications Union, "Optical transport 1010 network physical layer interfaces", ITU-T Recommendation 1011 G.959.1, November 2009. 1013 [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate 1014 Requirement Levels", BCP 14, RFC 2119, 1015 DOI 10.17487/RFC2119, March 1997, 1016 . 1018 [RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J. 1019 Schoenwaelder, Ed., "Structure of Management Information 1020 Version 2 (SMIv2)", STD 58, RFC 2578, 1021 DOI 10.17487/RFC2578, April 1999, 1022 . 1024 [RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J. 1025 Schoenwaelder, Ed., "Textual Conventions for SMIv2", 1026 STD 58, RFC 2579, DOI 10.17487/RFC2579, April 1999, 1027 . 1029 [RFC2580] McCloghrie, K., Ed., Perkins, D., Ed., and J. 1030 Schoenwaelder, Ed., "Conformance Statements for SMIv2", 1031 STD 58, RFC 2580, DOI 10.17487/RFC2580, April 1999, 1032 . 1034 [RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group 1035 MIB", RFC 2863, DOI 10.17487/RFC2863, June 2000, 1036 . 1038 [RFC3591] Lam, H-K., Stewart, M., and A. Huynh, "Definitions of 1039 Managed Objects for the Optical Interface Type", RFC 3591, 1040 DOI 10.17487/RFC3591, September 2003, 1041 . 1043 [RFC6205] Otani, T., Ed. and D. Li, Ed., "Generalized Labels for 1044 Lambda-Switch-Capable (LSC) Label Switching Routers", 1045 RFC 6205, DOI 10.17487/RFC6205, March 2011, 1046 . 1048 14.2. Informative References 1050 [I-D.ietf-ccamp-dwdm-if-mng-ctrl-fwk] 1051 Kunze, R., Grammel, G., Beller, D., and G. Galimberti, "A 1052 framework for Management and Control of DWDM optical 1053 interface parameters", draft-ietf-ccamp-dwdm-if-mng-ctrl- 1054 fwk-00 (work in progress), April 2016. 1056 [RFC2629] Rose, M., "Writing I-Ds and RFCs using XML", RFC 2629, 1057 DOI 10.17487/RFC2629, June 1999, 1058 . 1060 [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, 1061 "Introduction and Applicability Statements for Internet- 1062 Standard Management Framework", RFC 3410, 1063 DOI 10.17487/RFC3410, December 2002, 1064 . 1066 [RFC4054] Strand, J., Ed. and A. Chiu, Ed., "Impairments and Other 1067 Constraints on Optical Layer Routing", RFC 4054, 1068 DOI 10.17487/RFC4054, May 2005, 1069 . 1071 [RFC4181] Heard, C., Ed., "Guidelines for Authors and Reviewers of 1072 MIB Documents", BCP 111, RFC 4181, DOI 10.17487/RFC4181, 1073 September 2005, . 1075 Appendix A. Change Log 1077 This optional section should be removed before the internet draft is 1078 submitted to the IESG for publication as an RFC. 1080 Note to RFC Editor: please remove this appendix before publication as 1081 an RFC. 1083 Appendix B. Open Issues 1085 Note to RFC Editor: please remove this appendix before publication as 1086 an RFC. 1088 Authors' Addresses 1090 Gabriele Galimberti (editor) 1091 Cisco 1092 Via Santa Maria Molgora, 48 c 1093 20871 - Vimercate 1094 Italy 1096 Phone: +390392091462 1097 Email: ggalimbe@cisco.com 1099 Ruediger Kunze 1100 Deutsche Telekom 1101 Dddd, xx 1102 Berlin 1103 Germany 1105 Phone: +49xxxxxxxxxx 1106 Email: RKunze@telekom.de 1107 Dharini Hiremagalur (editor) 1108 Juniper 1109 1194 N Mathilda Avenue 1110 Sunnyvale - 94089 California 1111 USA 1113 Email: dharinih@juniper.net 1115 Gert Grammel (editor) 1116 Juniper 1117 Oskar-Schlemmer Str. 15 1118 80807 Muenchen 1119 Germany 1121 Phone: +49 1725186386 1122 Email: ggrammel@juniper.net