idnits 2.17.1 draft-lee-ccamp-wson-yang-02.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 == Line 376 has weird spacing: '...pool-id uin...' == Line 386 has weird spacing: '... module ietf...' -- The document date (July 1, 2015) is 3220 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 109, but not defined == Missing Reference: 'RFC6163' is mentioned on line 144, but not defined == Missing Reference: 'Shared' is mentioned on line 350, but not defined == Missing Reference: 'H1-2A-245' is mentioned on line 669, but not defined ** Downref: Normative reference to an Informational RFC: RFC 7446 Summary: 1 error (**), 0 flaws (~~), 7 warnings (==), 1 comment (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 1 Network Working Group Y. Lee (Editor) 2 D. Dhody 3 Internet Draft Huawei 4 Intended status: Standard Track 5 A. Guo 6 Expires: January 2016 ADVA 8 V. Lopez 9 Telefonica 11 D. King 12 U. of Lancaster 14 July 1, 2015 16 A Yang Data Model for WSON Optical Networks 18 draft-lee-ccamp-wson-yang-02 20 Abstract 22 This document provides a YANG data model for the routing and 23 wavelength assignment (RWA) TE topology in wavelength switched 24 optical networks (WSONs). 26 Status of this Memo 28 This Internet-Draft is submitted to IETF in full conformance with 29 the provisions of BCP 78 and BCP 79. 31 Internet-Drafts are working documents of the Internet Engineering 32 Task Force (IETF), its areas, and its working groups. Note that 33 other groups may also distribute working documents as Internet- 34 Drafts. 36 Internet-Drafts are draft documents valid for a maximum of six 37 months and may be updated, replaced, or obsoleted by other documents 38 at any time. It is inappropriate to use Internet-Drafts as 39 reference material or to cite them other than as "work in progress." 41 The list of current Internet-Drafts can be accessed at 42 http://www.ietf.org/ietf/1id-abstracts.txt 43 The list of Internet-Draft Shadow Directories can be accessed at 44 http://www.ietf.org/shadow.html 46 This Internet-Draft will expire on January 1, 2016. 48 Copyright Notice 50 Copyright (c) 2015 IETF Trust and the persons identified as the 51 document authors. All rights reserved. 53 This document is subject to BCP 78 and the IETF Trust's Legal 54 Provisions Relating to IETF Documents 55 (http://trustee.ietf.org/license-info) in effect on the date of 56 publication of this document. Please review these documents 57 carefully, as they describe your rights and restrictions with 58 respect to this document. Code Components extracted from this 59 document must include Simplified BSD License text as described in 60 Section 4.e of the Trust Legal Provisions and are provided without 61 warranty as described in the Simplified BSD License. 63 Table of Contents 65 1. Introduction...................................................3 66 2. Routing and Wavelength Assignment Informational Model..........3 67 2.1. Connectivity Matrix Model.................................3 68 2.2. Resource Pool Model.......................................4 69 2.3. Port Label Restriction Model..............................8 70 2.4. Wavelength Availability on Links..........................9 71 3. YANG Model (Tree Structure)...................................10 72 4. WSON-RWA YANG Model...........................................11 73 5. Security Considerations.......................................17 74 6. IANA Considerations...........................................17 75 7. Acknowledgments...............................................17 76 8. References....................................................18 77 8.1. Normative References.....................................18 78 8.2. Informative References...................................18 79 9. Contributors..................................................18 80 Authors' Addresses...............................................18 82 1. Introduction 84 This document provides a YANG data model for the routing and 85 wavelength assignment (RWA) Traffic Engineering (TE) topology in 86 wavelength switched optical networks (WSONs). The YANG model 87 described in this document is a WSON technology-specific Yang model 88 based on the information model developed in [RFC7446] and the two 89 encoding drafts [WSON-Encode] and [Gen-Encode] that developed 90 protocol independent encodings based on [RFC7446]. This document 91 augments the generic TE topology draft [TE-TOPO]. 93 What is not in scope of this document is both impairment-aware WSON 94 and flex-grid. 96 2. Routing and Wavelength Assignment Informational Model 98 The relevant information model in this document comprises 100 - Connectivity Matrix Model (Section 2.1) 101 - Resource Pool Model (Section 2.2) 102 - Port Wavelength Restriction (Section 2.3) 103 - Wavelength Availability on Links (Section 2.4) 105 [Editor's Note: This version covers the corresponding YANG data 106 model for the first two sections (Sections 2.1 and 2.2) and leaves 107 the YANG model for Sections 2.3 and 2.4 in the later version.] 109 Sections 2.1 - 2.4 rehashes key information models from [RWA-Info] 110 to facilitate the development of the YANG model (Section 3). 112 2.1. Connectivity Matrix Model 114 The connectivity matrix (ConnectivityMatrix) represents either the 115 potential connectivity matrix for asymmetric switches (e.g. ROADMs 116 and such) or fixed connectivity for an asymmetric device such as a 117 multiplexer. 119 Note that multiple connectivity matrices are allowed and the Node_ID 120 would be an appropriate identifier for the node to point the 121 Connectivity matrix within the WSON RWA context. 123 ::= [...] 125 ::= 127 128 130 Where 132 is a unique identifier for the matrix. 134 can be either 0 or 1 depending upon whether the 135 connectivity is either fixed or switched. 137 represents the fixed or switched connectivity in that 138 Matrix(i, j) = 0 or 1 depending on whether input port i can connect 139 to output port j for one or more wavelengths. 141 2.2. Resource Pool Model 143 A WSON node may include regenerators or wavelength converters 144 arranged in a shared pool. As discussed in [RFC6163] this can 145 include Optical-Electronic-Optical (OEO) based Wavelength Division 146 Multiplexing (WDM) switches as well. There are a number of different 147 approaches used in the design of WDM switches containing regenerator 148 or converter pools. However, from the point of view of path 149 computation the following need to be known: 151 1. The nodes that support regeneration or wavelength conversion. 153 2. The accessibility and availability of a wavelength converter to 154 convert from a given input wavelength on a particular input port 155 to a desired output wavelength on a particular output port. 157 3. Limitations on the types of signals that can be converted and the 158 conversions that can be performed. 160 The following Figures show resource pool architecture of WSON. 162 I1 +-------------+ +-------------+ O1 163 ----->| | +--------+ | |-----> 164 I2 | +------+ Rb #1 +-------+ | O2 165 ----->| | +--------+ | |-----> 166 | | | | 167 | Resource | +--------+ | Resource | 168 | Pool +------+ +-------+ Pool | 169 | | + Rb #2 + | | 170 | Input +------+ +-------| Output | 171 | Connection | +--------+ | Connection | 172 | Matrix | . | Matrix | 173 | | . | | 174 | | . | | 175 IN | | +--------+ | | OM 176 ----->| +------+ Rb #P +-------+ |-----> 177 | | +--------+ | | 178 +-------------+ ^ ^ +-------------+ 179 | | 180 | | 181 | | 182 | | 184 Input wavelength Output wavelength 185 constraints for constraints for 186 each resource each resource 188 Note: Rb is a Resource Block. 190 Figure 1 Schematic diagram of resource pool model. 192 Since resources tend to be packaged together in blocks of similar 193 devices, e.g., on line cards or other types of modules, the 194 fundamental unit of identifiable resource in this document is the 195 "resource block". A resource block may contain one or more 196 resources. A resource is the smallest identifiable unit of 197 processing allocation. One can group together resources into blocks 198 if they have similar characteristics relevant to the optical system 199 being modeled, e.g., processing properties, accessibility, etc. 201 This leads to the following formal high level model: 203 ::= 205 [...] 207 [] 209 Where 211 ::= ... 213 [...] 215 [...] 217 [] 219 ::= 221 223 ::= 225 227 ::= [] 229 [] 231 ::= 233 235 [] 237 [] 239 ::= 241 [] 243 [] 245 [] 247 Where is a list of resource block identifiers 248 with the same characteristics. If this set is missing the 249 constraints are applied to the entire network element. 251 ::= 253 [] 255 [] 257 ::= [] 259 [] 261 [] 263 [] 265 := 267 [] 269 [] 271 ::= ... 273 ::=[]... 275 1. Number of Resources within the block 277 2. Regeneration capability 279 3. Fault and performance monitoring 281 4. Vendor Specific capability 283 Note that the code points for Fault and performance monitoring and 284 vendor specific capability are subject to further study. 286 2.3. Port Label Restriction Model 288 ::= 290 [] 292 [] 294 [] 296 [...] 298 [] 300 [...] 302 Note that these additional link characteristics only applies to line 303 side ports of WDM system or add/drop ports pertaining to Resource 304 Pool (e.g., Regenerator or Wavelength Converter Pool). The 305 advertisement of input/output tributary ports is not intended here. 307 ::= 309 311 ::= 313 ... 315 Where 317 MatrixID is the ID of the corresponding connectivity matrix. 319 LabelSet is a conceptual set of labels (wavelengths). 321 MaxNumChannels is the maximum number of channels that can be 322 simultaneously used (relative to either a port or a matrix). 324 LinkSet is a conceptual set of ports. 326 2.4. Wavelength Availability on Links 328 In the previously presented information model there are a limited 329 number of information elements that are dynamic, i.e., subject to 330 change with subsequent establishment and teardown of connections. 331 Depending on the protocol used to convey this overall information 332 model it may be possible to send this dynamic information separate 333 from the relatively larger amount of static information needed to 334 characterize WSON's and their network elements. 336 ::= 338 340 [] 342 AvailableLabels is a set of labels (wavelengths) currently available 343 on the link. Given this information and the port wavelength 344 restrictions one can also determine which wavelengths are currently 345 in use. This parameter could potential be used with other 346 technologies that GMPLS currently covers or may cover in the future. 348 SharedBackupLabels is a set of labels (wavelengths) currently used 349 for shared backup protection on the link. An example usage of this 350 information in a WSON setting is given in [Shared]. This parameter 351 could potential be used with other technologies that GMPLS currently 352 covers or may cover in the future. 354 3. YANG Model (Tree Structure) 356 (Editor's Note: This version is based on the augmentation of draft- 357 ietf-teas-yang-te-topo [TE-TOPO].) 359 module: ietf-wson-topology 360 augment /tet:te-topologies/tet:topology/tet:topology-types/tet:te- 361 topology: 362 +--rw wson-topology 363 augment /tet:te-topologies/tet:topology/tet:node/tet:te-node- 364 attributes/tet:connectivity-matrix: 365 +--rw wson-matrix 366 +--rw device-type? devicetype 367 +--rw dir? directionality 368 +--rw matrix-interface* [in-port-id] 369 +--rw in-port-id wson-interface-ref 370 +--rw out-port-id? wson-interface-ref 371 augment /tet:te-topologies/tet:topology/tet:node/tet:te-node- 372 attributes/tet:te-link: 373 +--rw wavelength-available-bitmap* boolean 374 augment /tet:te-topologies/tet:topology/tet:node: 375 +--rw resource-pool* [resource-pool-id] 376 +--rw resource-pool-id uint32 377 +--rw pool-state? boolean 378 +--rw matrix-interface* [in-port-id] 379 +--rw in-port-id wson-interface-ref 380 +--rw out-port-id? wson-interface-ref 382 4. WSON-RWA YANG Model 384 386 module ietf-wson-topology { 387 namespace "urn:ietf:params:xml:ns:yang:ietf-wson-topology"; 389 prefix wson; 391 import ietf-inet-types { 392 prefix inet; 393 } 395 import ietf-te-topology { 396 prefix "tet"; 397 } 399 organization 400 "IETF CCAMP Working Group"; 402 contact 403 "Editor: Young Lee "; 405 description 406 "This module contains a collection of YANG definitions for 407 RWA WSON. 409 Copyright (c) 2015 IETF Trust and the persons identified as 410 authors of the code. All rights reserved. 412 Redistribution and use in source and binary forms, with or 413 without modification, is permitted pursuant to, and subject 414 to the license terms contained in, the Simplified BSD 415 License set forth in Section 4.c of the IETF Trust's Legal 416 Provisions Relating to IETF Documents 417 (http://trustee.ietf.org/license-info)."; 419 revision 2015-07-01 { 420 description 421 "version 2."; 423 reference 424 "RFC XXX: A Yang Data Model for WSON Optical Networks "; 425 } 427 typedef wson-topology-id { 428 type inet:uri; 429 description 430 "The WSON Topology ID"; 431 } 433 typedef wson-node-id { 434 type inet:ip-address; 435 description 436 "The WSON Node ID"; 437 } 439 typedef devicetype { 440 type enumeration { 441 enum adm { 442 value 1; 443 description 444 "Device is ADM"; 445 } 447 enum roadm { 448 value 2; 449 description 450 "Device is ROAMD/OXC"; 451 } 452 } 453 description 454 "device type: fixed (ADM) or switched (ROADM/OXC)"; 455 } 456 typedef directionality { 457 type enumeration { 458 enum bidir { 459 value 0; 460 description 461 "bi-directional"; 462 } 463 enum input { 464 value 1; 465 description 466 "input direction"; 467 } 468 enum output { 469 value 2; 470 description 471 "output direction"; 472 } 473 } 474 description 475 "The directionality of link set"; 476 } 478 typedef wson-interface-ref { 479 type leafref { 480 path "/tet:te-topologies/tet:topology/tet:node" 481 + "/tet:te-node-attributes/tet:te-link" 482 + "/tet:te-link-id"; 483 } 484 description 485 "This type is used by data models that need to 486 reference WSON interface."; 487 } 489 augment "/tet:te-topologies/tet:topology/tet:topology-types" 490 + "/tet:te-topology" { 491 description "WSON augmentation."; 492 container wson-topology{ 493 description 494 "An empty WSON container to identify 495 the topology type."; 496 } 497 } 499 augment "/tet:te-topologies/tet:topology/tet:node" 500 +"/tet:te-node-attributes" 501 +"/tet:connectivity-matrix" { 502 when "/tet:te-topologies/tet:topology/tet:topology-types" 503 +"/tet:te-topology/wson-topology" { 504 description 505 "This augment is only valid for WSON."; 506 } 507 description "WSON Connectivity Matrix augmentation."; 508 container wson-matrix{ 509 description "WSON specific Matrix."; 510 leaf device-type { 511 type devicetype; 512 description 513 "device type: fixed (ADM) or switched 514 (ROADM/OXC)"; 515 } 516 leaf dir { 517 type directionality; 518 description 519 "bi-directionality or input or output 520 of link set"; 521 } 523 list matrix-interface { 524 key "in-port-id"; 526 description 527 "matrix-interface describes input-ports 528 and out-ports around a connectivity 529 matrix"; 531 leaf in-port-id { 532 type wson-interface-ref; 533 description 534 "The reference to in-port"; 535 } 536 leaf out-port-id { 537 type wson-interface-ref; 538 description 539 "The reference to out-port"; 540 } 541 } 542 } 543 } 545 augment "/tet:te-topologies/tet:topology/tet:node" 546 + "/tet:te-node-attributes/tet:te-link" { 548 when "/tet:te-topologies/tet:topology/tet:topology-types" 549 +"/tet:te-topology/wson-topology" { 550 description 551 "This augment is only valid for WSON."; 552 } 553 description "WSON Link augmentation."; 555 leaf-list wavelength-available-bitmap { 556 type boolean; 557 description 558 "array of bits (i.e., bitmap) that indicates 559 if a wavelength is available or not on each 560 channel."; 561 } 562 } 564 augment "/tet:te-topologies/tet:topology/tet:node" { 565 when "/tet:te-topologies/tet:topology/tet:topology-types" 566 +"/tet:te-topology/wson-topology" { 567 description 568 "This augment is only valid for WSON."; 569 } 570 description "WSON Node augmentation."; 572 list resource-pool { 573 key "resource-pool-id"; 574 description 575 "The resource pool list"; 577 leaf resource-pool-id { 578 type uint32; 579 description 580 "The resource pool ID"; 581 } 583 leaf pool-state { 584 type boolean; 585 description 586 "TRUE is state UP; FALSE is state down"; 587 } 589 list matrix-interface { 590 key "in-port-id"; 592 description 593 "pool is described as matrix-interface 594 with input-ports and output-ports 595 around the pool"; 597 leaf in-port-id { 598 type wson-interface-ref; 599 description 600 "The reference to in-interface"; 601 } 603 leaf out-port-id { 604 type wson-interface-ref; 605 description 606 "The reference to out-interface"; 607 } 608 } 609 } 610 } 611 } 613 615 5. Security Considerations 617 TDB 619 6. IANA Considerations 621 TDB 623 7. Acknowledgments 625 This document was prepared using 2-Word-v2.0.template.dot. 627 8. References 629 8.1. Normative References 631 [RFC7446] Y. Lee, G. Bernstein, D. Li, W. Imajuku, "Routing and 632 Wavelength Assignment Information Model for Wavelength 633 Switched Optical Networks", RFC 7446, Feburary 2015. 635 [Gen-Encode] G. Bernstein, Y. Lee, D. Li, W. Imajuku, "General 636 Network Element Constraint Encoding for GMPLS Controlled 637 Networks", work in progress: draft-ietf-ccamp-general- 638 constraint-encode. 640 [WSON-Encode] G. Bernstein, Y. Lee, D. Li, W. Imajuku, "Routing and 641 Wavelength Assignment Information Encoding for Wavelength 642 Switched Optical Networks", work in progress: draft-ietf- 643 ccamp-rwa-wson-encode. 645 [TE-TOPO] X. Liu, et al., "YANG Data Model for TE Topologies", work 646 in progress: draft-ietf-teas-yang-te-topo. 648 8.2. Informative References 650 9. Contributors 652 Xian Zhang 653 Huawei Technologies 654 Email: zhang.xian@huawei.com 656 Authors' Addresses 658 Young Lee (ed.) 659 Huawei Technologies 660 5340 Legacy Drive, Building 3 661 Plano, TX 75023 662 USA 664 Phone: (469) 277-5838 665 Email: leeyoung@huawei.com 666 Dhruv Dhody 667 Huawei Technologies India Pvt. Ltd, 668 Near EPIP Industrial Area, Kundalahalli Village, Whitefield, 669 Bangalore - 560 037 [H1-2A-245] 671 Email: dhruv.dhody@huawei.com 673 Aihua Guo 674 ADVA 675 Email: AGuo@advaoptical.com 677 Victor Lopez 678 Telefonica 679 Email: victor.lopezalvarez@telefonica.com 681 Daniel King 682 University of Lancaster 683 Email: d.king@lancaster.ac.uk