idnits 2.17.1 draft-lee-ccamp-wson-yang-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: ---------------------------------------------------------------------------- == The page length should not exceed 58 lines per page, but there was 4 longer pages, the longest (page 11) being 61 lines Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- ** There are 103 instances of too long lines in the document, the longest one being 13 characters in excess of 72. ** There is 1 instance of lines with control characters in the document. Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the IETF Trust and authors Copyright Line does not match the current year == Line 365 has weird spacing: '...pool-id uin...' == Line 375 has weird spacing: '... module ietf...' -- The document date (December 16, 2015) is 3054 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: 'RWA-Info' is mentioned on line 103, but not defined == Missing Reference: 'RFC6163' is mentioned on line 138, but not defined == Missing Reference: 'Shared' is mentioned on line 340, but not defined == Missing Reference: 'H1-2A-245' is mentioned on line 657, but not defined ** Downref: Normative reference to an Informational RFC: RFC 7446 Summary: 3 errors (**), 0 flaws (~~), 8 warnings (==), 1 comment (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 1 CCAMP Working Group Y. Lee (Editor) 2 D. Dhody 3 X. Zhang 4 Internet Draft Huawei 5 Intended status: Standard Track A. Guo 6 ADVA 7 V. Lopez 8 Telefonica 9 D. King 10 U. of Lancaster 11 B. Yoon 12 ETRI 14 Expires: June 15, 2016 December 16, 2015 16 A Yang Data Model for WSON Optical Networks 18 draft-lee-ccamp-wson-yang-04.txt 20 Abstract 22 This document provides a YANG data model for the routing and wavelength assignment 23 (RWA) TE topology in wavelength switched optical networks (WSONs). 25 Status of this Memo 27 This Internet-Draft is submitted to IETF in full conformance with the provisions 28 of BCP 78 and BCP 79. 30 Internet-Drafts are working documents of the Internet Engineering Task Force 31 (IETF), its areas, and its working groups. Note that other groups may also 32 distribute working documents as Internet-Drafts. 34 Internet-Drafts are draft documents valid for a maximum of six months and may be 35 updated, replaced, or obsoleted by other documents at any time. It is 36 inappropriate to use Internet-Drafts as reference material or to cite them other 37 than as "work in progress." 39 The list of current Internet-Drafts can be accessed at 40 http://www.ietf.org/ietf/1id-abstracts.txt 42 The list of Internet-Draft Shadow Directories can be accessed at 43 http://www.ietf.org/shadow.html 45 This Internet-Draft will expire on June 16, 2016. 47 Copyright Notice 48 Copyright (c) 2015 IETF Trust and the persons identified as the document authors. 49 All rights reserved. 51 This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating 52 to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of 53 publication of this document. Please review these documents carefully, as they 54 describe your rights and restrictions with respect to this document. Code 55 Components extracted from this document must include Simplified BSD License text 56 as described in Section 4.e of the Trust Legal Provisions and are provided without 57 warranty as described in the Simplified BSD License. 59 Table of Contents 61 1. Introduction ................................................... 2 62 2. Routing and Wavelength Assignment Informational Model.............. 3 63 2.1. Connectivity Matrix Model .................................... 3 64 2.2. Resource Pool Model ......................................... 4 65 2.3. Port Label Restriction Model ................................. 8 66 2.4. Wavelength Availability on Links .............................. 8 67 3. YANG Model (Tree Structure)....................................... 9 68 4. WSON-RWA YANG Model ............................................ 10 69 5. Security Considerations ......................................... 15 70 6. IANA Considerations ............................................ 15 71 7. Acknowledgments ............................................... 15 72 8. References ................................................... 16 73 8.1. Normative References ....................................... 16 74 8.2. Informative References ..................................... 16 75 9. Contributors .................................................. 16 76 Authors' Addresses ............................................... 16 78 1. Introduction 80 This document provides a YANG data model for the routing and wavelength assignment 81 (RWA) Traffic Engineering (TE) topology in wavelength switched optical networks 82 (WSONs). The YANG model described in this document is a WSON technology-specific 83 Yang model based on the information model developed in [RFC7446] and the two 84 encoding documents [RFC7581] and [RFC7579] that developed protocol independent 85 encodings based on [RFC7446]. This document augments the generic TE topology draft 86 [TE-TOPO]. 88 What is not in scope of this document is both impairment-aware WSON and flex-grid. 90 2. Routing and Wavelength Assignment Informational Model 92 The relevant information model in this document comprises 94 - Connectivity Matrix Model (Section 2.1) 95 - Resource Pool Model (Section 2.2) 96 - Port Wavelength Restriction (Section 2.3) 97 - Wavelength Availability on Links (Section 2.4) 99 [Editor's Note: This version covers the corresponding YANG data model for the 100 first two sections (Sections 2.1 and 2.2) and leaves the YANG model for Sections 101 2.3 and 2.4 in the later version.] 103 Sections 2.1 - 2.4 rehashes key information models from [RWA-Info] to facilitate 104 the development of the YANG model (Section 3). 106 2.1. Connectivity Matrix Model 108 The connectivity matrix (ConnectivityMatrix) represents either the potential 109 connectivity matrix for asymmetric switches (e.g. ROADMs and such) or fixed 110 connectivity for an asymmetric device such as a multiplexer. 112 Note that multiple connectivity matrices are allowed and the Node_ID would be an 113 appropriate identifier for the node to point the Connectivity matrix within the 114 WSON RWA context. 116 ::= [...] 118 ::= 120 122 124 Where 126 is a unique identifier for the matrix. 128 can be either 0 or 1 depending upon whether the connectivity is either 129 fixed or switched. 131 represents the fixed or switched connectivity in that Matrix(i, j) = 0 or 132 1 depending on whether input port i can connect to output port j for one or more 133 wavelengths. 135 2.2. Resource Pool Model 137 A WSON node may include regenerators or wavelength converters arranged in a shared 138 pool. As discussed in [RFC6163] this can include Optical-Electronic-Optical (OEO) 139 based Wavelength Division Multiplexing (WDM) switches as well. There are a number 140 of different approaches used in the design of WDM switches containing regenerator 141 or converter pools. However, from the point of view of path computation the 142 following need to be known: 144 1. The nodes that support regeneration or wavelength conversion. 146 2. The accessibility and availability of a wavelength converter to convert from a 147 given input wavelength on a particular input port to a desired output 148 wavelength on a particular output port. 150 3. Limitations on the types of signals that can be converted and the conversions 151 that can be performed. 153 The following Figures show resource pool architecture of WSON. 155 I1 +-------------+ +-------------+ O1 156 ----->| | +--------+ | |-----> 157 I2 | +------+ Rb #1 +-------+ | O2 158 ----->| | +--------+ | |-----> 159 | | | | 160 | Resource | +--------+ | Resource | 161 | Pool +------+ +-------+ Pool | 162 | | + Rb #2 + | | 163 | Input +------+ +-------| Output | 164 | Connection | +--------+ | Connection | 165 | Matrix | . | Matrix | 166 | | . | | 167 | | . | | 168 IN | | +--------+ | | OM 169 ----->| +------+ Rb #P +-------+ |-----> 170 | | +--------+ | | 171 +-------------+ ^ ^ +-------------+ 172 | | 173 | | 174 | | 175 | | 177 Input wavelength Output wavelength 178 constraints for constraints for 179 each resource each resource 181 Note: Rb is a Resource Block. 183 Figure 1 Schematic diagram of resource pool model. 185 Since resources tend to be packaged together in blocks of similar devices, e.g., 186 on line cards or other types of modules, the fundamental unit of identifiable 187 resource in this document is the "resource block". A resource block may contain 188 one or more resources. A resource is the smallest identifiable unit of processing 189 allocation. One can group together resources into blocks if they have similar 190 characteristics relevant to the optical system being modeled, e.g., processing 191 properties, accessibility, etc. 193 This leads to the following formal high level model: 195 ::= 197 [...] 199 [] 201 Where 203 ::= ... 205 [...] 207 [...] 209 [] 211 ::= 213 215 ::= 217 219 ::= [] 221 [] 223 ::= 225 227 [] 229 [] 231 ::= 233 [] 235 [] 237 [] 239 Where is a list of resource block identifiers with the same 240 characteristics. If this set is missing the constraints are applied to the entire 241 network element. 243 ::= 245 [] 247 [] 249 ::= [] 251 [] 253 [] 255 [] 257 := 259 [] 261 [] 263 ::= ... 265 ::=[]... 267 1. Number of Resources within the block 269 2. Regeneration capability 271 3. Fault and performance monitoring 273 4. Vendor Specific capability 275 Note that the code points for Fault and performance monitoring and vendor 276 specific capability are subject to further study. 278 2.3. Port Label Restriction Model 280 ::= 282 [] 284 [] 286 [] 288 [...] 290 [] 292 [...] 294 Note that these additional link characteristics only applies to line side ports of 295 WDM system or add/drop ports pertaining to Resource Pool (e.g., Regenerator or 296 Wavelength Converter Pool). The advertisement of input/output tributary ports is 297 not intended here. 299 ::= 301 303 ::= 305 ... 307 Where 309 MatrixID is the ID of the corresponding connectivity matrix. 311 LabelSet is a conceptual set of labels (wavelengths). 313 MaxNumChannels is the maximum number of channels that can be simultaneously used 314 (relative to either a port or a matrix). 316 LinkSet is a conceptual set of ports. 318 2.4. Wavelength Availability on Links 320 In the previously presented information model there are a limited number of 321 information elements that are dynamic, i.e., subject to change with subsequent 322 establishment and teardown of connections. Depending on the protocol used to 323 convey this overall information model it may be possible to send this dynamic 324 information separate from the relatively larger amount of static information 325 needed to characterize WSON's and their network elements. 327 ::= 329 331 [] 333 AvailableLabels is a set of labels (wavelengths) currently available on the link. 334 Given this information and the port wavelength restrictions one can also determine 335 which wavelengths are currently in use. This parameter could potential be used 336 with other technologies that GMPLS currently covers or may cover in the future. 338 SharedBackupLabels is a set of labels (wavelengths) currently used for shared 339 backup protection on the link. An example usage of this information in a WSON 340 setting is given in [Shared]. This parameter could potential be used with other 341 technologies that GMPLS currently covers or may cover in the future. 343 3. YANG Model (Tree Structure) 345 (Editor's Note: This version is based on the augmentation of draft-ietf-teas-yang- 346 te-topo [TE-TOPO].) 348 module: ietf-wson-topology 349 augment /tet:te-topologies/tet:topology/tet:topology-types/tet:te-topology: 351 +--rw wson-topology 352 augment /tet:te-topologies/tet:topology/tet:node/tet:te-node- 353 attributes/tet:connectivity-matrix: 354 +--rw wson-matrix 355 +--rw device-type? devicetype 356 +--rw dir? directionality 357 +--rw matrix-interface* [in-port-id] 358 +--rw in-port-id wson-interface-ref 359 +--rw out-port-id? wson-interface-ref 360 augment /tet:te-topologies/tet:topology/tet:node/tet:te-node-attributes/tet:te- 361 link: 362 +--rw wavelength-available-bitmap* boolean 363 augment /tet:te-topologies/tet:topology/tet:node: 364 +--rw resource-pool* [resource-pool-id] 365 +--rw resource-pool-id uint32 366 +--rw pool-state? boolean 367 +--rw matrix-interface* [in-port-id] 368 +--rw in-port-id wson-interface-ref 369 +--rw out-port-id? wson-interface-ref 371 4. WSON-RWA YANG Model 373 file "ietf-wson-topology@2015-10-14.yang" 375 module ietf-wson-topology { 376 namespace "urn:ietf:params:xml:ns:yang:ietf-wson-topology"; 378 prefix wson; 380 import ietf-inet-types { 381 prefix inet; 382 } 384 import ietf-te-topology { 385 prefix "tet"; 386 } 388 organization 389 "IETF CCAMP Working Group"; 391 contact 392 "Editor: Young Lee "; 394 description 395 "This module contains a collection of YANG definitions for 396 RWA WSON. 398 Copyright (c) 2015 IETF Trust and the persons identified as 399 authors of the code. All rights reserved. 401 Redistribution and use in source and binary forms, with or 402 without modification, is permitted pursuant to, and subject 403 to the license terms contained in, the Simplified BSD 404 License set forth in Section 4.c of the IETF Trust's Legal 405 Provisions Relating to IETF Documents 406 (http://trustee.ietf.org/license-info)."; 408 revision 2015-10-14 { 409 description 410 "version 2."; 412 reference 413 "RFC XXX: A Yang Data Model for WSON Optical Networks "; 414 } 416 typedef wson-topology-id { 417 type inet:uri; 418 description 419 "The WSON Topology ID"; 420 } 422 typedef wson-node-id { 423 type inet:ip-address; 424 description 425 "The WSON Node ID"; 426 } 428 typedef devicetype { 429 type enumeration { 430 enum adm { 431 value 1; 432 description 433 "Device is ADM"; 434 } 436 enum roadm { 437 value 2; 438 description 439 "Device is ROAMD/OXC"; 440 } 441 } 442 description 443 "device type: fixed (ADM) or switched (ROADM/OXC)"; 444 } 446 typedef directionality { 447 type enumeration { 448 enum bidir { 449 value 0; 450 description 451 "bi-directional"; 452 } 453 enum input { 454 value 1; 455 description 456 "input direction"; 457 } 458 enum output { 459 value 2; 460 description 461 "output direction"; 462 } 463 } 464 description 465 "The directionality of link set"; 466 } 468 typedef wson-interface-ref { 469 type leafref { 470 path "/tet:te-topologies/tet:topology/tet:node" 471 + "/tet:te-node-attributes/tet:te-link" 472 + "/tet:te-link-id"; 473 } 474 description 475 "This type is used by data models that need to 476 reference WSON interface."; 477 } 479 augment "/tet:te-topologies/tet:topology/tet:topology-types" 480 + "/tet:te-topology" { 481 description "WSON augmentation."; 482 container wson-topology{ 483 description 484 "An empty WSON container to identify 485 the topology type."; 486 } 487 } 489 augment "/tet:te-topologies/tet:topology/tet:node" 490 +"/tet:te-node-attributes" 491 +"/tet:connectivity-matrix" { 492 when "/tet:te-topologies/tet:topology/tet:topology-types" 493 +"/tet:te-topology/wson-topology" { 494 description 495 "This augment is only valid for WSON."; 497 } 498 description "WSON Connectivity Matrix augmentation."; 499 container wson-matrix{ 500 description "WSON specific Matrix."; 501 leaf device-type { 502 type devicetype; 503 description 504 "device type: fixed (ADM) or switched 505 (ROADM/OXC)"; 506 } 507 leaf dir { 508 type directionality; 509 description 510 "bi-directionality or input or output 511 of link set"; 512 } 514 list matrix-interface { 515 key "in-port-id"; 517 description 518 "matrix-interface describes input-ports 519 and out-ports around a connectivity 520 matrix"; 522 leaf in-port-id { 523 type wson-interface-ref; 524 description 525 "The reference to in-port"; 526 } 528 leaf out-port-id { 529 type wson-interface-ref; 530 description 531 "The reference to out-port"; 532 } 533 } 534 } 535 } 537 augment "/tet:te-topologies/tet:topology/tet:node" 538 + "/tet:te-node-attributes/tet:te-link" { 540 when "/tet:te-topologies/tet:topology/tet:topology-types" 541 +"/tet:te-topology/wson-topology" { 542 description 543 "This augment is only valid for WSON."; 544 } 545 description "WSON Link augmentation."; 547 leaf-list wavelength-available-bitmap { 548 type boolean; 549 description 550 "array of bits (i.e., bitmap) that indicates 551 if a wavelength is available or not on each 552 channel."; 554 } 555 } 557 augment "/tet:te-topologies/tet:topology/tet:node" { 558 when "/tet:te-topologies/tet:topology/tet:topology-types" 559 +"/tet:te-topology/wson-topology" { 560 description 561 "This augment is only valid for WSON."; 562 } 563 description "WSON Node augmentation."; 565 list resource-pool { 566 key "resource-pool-id"; 567 description 568 "The resource pool list"; 570 leaf resource-pool-id { 571 type uint32; 572 description 573 "The resource pool ID"; 574 } 576 leaf pool-state { 577 type boolean; 578 description 579 "TRUE is state UP; FALSE is state down"; 580 } 582 list matrix-interface { 583 key "in-port-id"; 585 description 586 "pool is described as matrix-interface 587 with input-ports and output-ports 588 around the pool"; 590 leaf in-port-id { 591 type wson-interface-ref; 592 description 593 "The reference to in-interface"; 594 } 596 leaf out-port-id { 597 type wson-interface-ref; 598 description 599 "The reference to out-interface"; 600 } 601 } 602 } 603 } 604 } 606 608 5. Security Considerations 610 TDB 612 6. IANA Considerations 614 TDB 616 7. Acknowledgments 618 This document was prepared using 2-Word-v2.0.template.dot. 620 8. References 622 8.1. Normative References 624 [RFC7446] Y. Lee, G. Bernstein, D. Li, W. Imajuku, "Routing and Wavelength 625 Assignment Information Model for Wavelength Switched Optical Networks", 626 RFC 7446, Feburary 2015. 628 [RFC7579] G. Bernstein, Y. Lee, D. Li, W. Imajuku, "General Network Element 629 Constraint Encoding for GMPLS Controlled Networks", RFC 7579, June 630 2015. 632 [RFC7581] G. Bernstein, Y. Lee, D. Li, W. Imajuku, "Routing and Wavelength 633 Assignment Information Encoding for Wavelength Switched Optical 634 Networks", RFC 7581, June 2015. 636 [TE-TOPO] X. Liu, et al., "YANG Data Model for TE Topologies", work in progress: 637 draft-ietf-teas-yang-te-topo. 639 8.2. Informative References 641 9. Contributors 643 Authors' Addresses 645 Young Lee (ed.) 646 Huawei Technologies 647 5340 Legacy Drive, Building 3 648 Plano, TX 75023 649 USA 651 Phone: (469) 277-5838 652 Email: leeyoung@huawei.com 654 Dhruv Dhody 655 Huawei Technologies India Pvt. Ltd, 656 Near EPIP Industrial Area, Kundalahalli Village, Whitefield, 657 Bangalore - 560 037 [H1-2A-245] 659 Email: dhruv.dhody@huawei.com 660 Xian Zhang 661 Huawei Technologies 663 Email: zhang.xian@huawei.com 665 Aihua Guo 666 ADVA 667 Email: AGuo@advaoptical.com 669 Victor Lopez 670 Telefonica 671 Email: victor.lopezalvarez@telefonica.com 673 Daniel King 674 University of Lancaster 675 Email: d.king@lancaster.ac.uk 677 Bin Yeong Yoon 678 ETRI 679 218 Gaijeongro, Yuseong-gu 680 Daejeon, Korea 681 Email: byyun@etri.re.kr