--- 1/draft-ietf-i2rs-yang-dc-fabric-network-topology-00.txt 2017-11-22 23:13:09.430881920 -0800 +++ 2/draft-ietf-i2rs-yang-dc-fabric-network-topology-01.txt 2017-11-22 23:13:09.482883163 -0800 @@ -1,53 +1,53 @@ I2RS Working Group Y. Zhuang Internet-Draft D. Shi Intended status: Standards Track Huawei -Expires: February 24, 2018 R. Gu +Expires: May 26, 2018 R. Gu China Mobile H. Ananthakrishnan Packet Design - August 23, 2017 + November 22, 2017 A YANG Data Model for Fabric Topology in Data Center Network - draft-ietf-i2rs-yang-dc-fabric-network-topology-00 + draft-ietf-i2rs-yang-dc-fabric-network-topology-01 Abstract This document defines a YANG data model for fabric topology in Data Center Network. Status of This Memo This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet- - Drafts is at http://datatracker.ietf.org/drafts/current/. + Drafts is at https://datatracker.ietf.org/drafts/current/. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." - This Internet-Draft will expire on February 24, 2018. + This Internet-Draft will expire on May 26, 2018. Copyright Notice Copyright (c) 2017 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents - (http://trustee.ietf.org/license-info) in effect on the date of + (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2 @@ -56,25 +56,25 @@ 2.2. Tree diagram . . . . . . . . . . . . . . . . . . . . . . 4 3. Model Overview . . . . . . . . . . . . . . . . . . . . . . . 4 3.1. Topology Model structure . . . . . . . . . . . . . . . . 4 3.2. Fabric Topology Model . . . . . . . . . . . . . . . . . . 5 3.2.1. Fabric Topology . . . . . . . . . . . . . . . . . . . 5 3.2.2. Fabric node extension . . . . . . . . . . . . . . . . 6 3.2.3. Fabric termination-point extension . . . . . . . . . 7 4. Fabric YANG Module . . . . . . . . . . . . . . . . . . . . . 8 5. Security Consideration . . . . . . . . . . . . . . . . . . . 21 6. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 21 - 7. References . . . . . . . . . . . . . . . . . . . . . . . . . 21 - 7.1. Normative References . . . . . . . . . . . . . . . . . . 21 + 7. References . . . . . . . . . . . . . . . . . . . . . . . . . 22 + 7.1. Normative References . . . . . . . . . . . . . . . . . . 22 7.2. Informative References . . . . . . . . . . . . . . . . . 22 Appendix A. Non NMDA -state modules . . . . . . . . . . . . . . 22 - Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 27 + Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 28 1. Introduction Normally, a data center network is composed of single or multiple fabrics which are also known as PODs (a Point Of Delivery). These fabrics may be heterogeneous due to implementation of different technologies while DC network upgrading or enrolling new techniques and features. For example, Fabric A may use VXLAN while Fabric B may use VLAN within a DC network. Likewise, a legacy Fabric may use VXLAN while a new Fabric B implemented technique discussed in NVO3 WG @@ -634,21 +634,21 @@ description "fabric acl list"; leaf fabric-acl-name { type string; description "acl name"; } } } } - file "ietf-fabric-topology@2017-03-10.yang" + file "ietf-fabric-topology@2017-11-21.yang" module ietf-fabric-topology { yang-version 1.1; namespace "urn:ietf:params:xml:ns:yang:ietf-fabric-topology"; prefix fabric; import ietf-network { prefix nw; } import ietf-network-topology { prefix nt; } import ietf-fabric-types { prefix fabrictype; revision-date "2016-09-29"; } organization @@ -680,24 +680,38 @@ without modification, is permitted pursuant to, and subject to the license terms contained in, the Simplified BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info). This version of this YANG module is part of draft-zhuang-i2rs-yang-dc-fabric-network-topology; see the RFC itself for full legal notices."; + revision "2017-11-21"{ + description + "fix warnings."; + + reference + "draft-ietf-i2rs-yang-dc-fabric-network-topology-01"; + } + + revision "2017-06-29"{ + description + "update to NMDA compliant format"; + reference + "draft-zhuang-i2rs-yang-dc-fabric-network-topology-04"; + } + revision "2017-03-10" { description "remove the rpcs and add extra attributes"; - reference "draft-zhuang-i2rs-yang-dc-fabric-network-topology-03"; } revision "2016-09-29" { description "Initial revision of fabric topology."; reference "draft-zhuang-i2rs-yang-dc-fabric-network-topology-02"; } @@ -900,59 +917,72 @@ // augment statements augment "/nw:networks/nw:network/nw:network-types" { description "Introduce new network type for Fabric-based logical topology"; uses fabric-network-type; } augment "/nw:networks/nw:network/nw:node" { - when "/nw:networks/nw:network/nw:network-types/fabric-network" { + when "/nw:networks/nw:network/nw:network-types/fabric:fabric-network" { description "Augmentation parameters apply only for networks with fabric topology"; } description "Augmentation for fabric nodes created by faas."; container fabric-attribute { description "attributes for a fabric network"; uses fabric-attributes; } } augment "/nw:networks/nw:network/nw:node/nt:termination-point" { - when "/nw:networks/nw:network/nw:network-types/fabric-network" { + when "/nw:networks/nw:network/nw:network-types/fabric:fabric-network" { description "Augmentation parameters apply only for networks with fabric topology"; } description "Augmentation for port on fabric."; container fport-attribute { config false; description "attributes for fabric ports"; uses fabrictype:fabric-port; } } } 5. Security Consideration - TBD + The underlay topology is learnt from the physical network, while the + fabric topology is composed of a collection of the underlay + nodes. The fabric model doesn't change the connections of underlay + networks. While there are data nodes for fabric configuration, these + data nodes may be considered sensitive or vulnerable in some network + enviroments. Write operations (e.g., edit-config) to these data + nodes without proper protection can have a negative effect on network + operations. For example, misconfiguration of underlay nodes to a + fabric node may lead to inproper activities when management are + implemented at fabric layer by customers. 6. Acknowledgements + We wish to acknowledge the helpful contributions, comments, and + suggestions that were received from Alexander Clemm, Xufeng Liu, + Susan Hares, Wei Song, Luis M. Contreras and Benoit Claise. + 7. References 7.1. Normative References [I-D.draft-ietf-i2rs-yang-l3-topology] Clemm, A., Medved, J., Tkacik, T., Liu, X., Bryskin, I., Guo, A., Ananthakrishnan, H., Bahadur, N., and V. Beeram, "A YANG Data Model for Layer 3 Topologies", I-D draft- ietf-i2rs-yang-l3-topology-04, September 2016. @@ -984,30 +1014,30 @@ 7.2. Informative References [I-D.draft-ietf-i2rs-usecase-reqs-summary] Hares, S. and M. Chen, "Summary of I2RS Use Case Requirements", I-D draft-ietf-i2rs-usecase-reqs-summary- 01, May 2015. Appendix A. Non NMDA -state modules - file "ietf-fabric-topology-state@2017-06-29.yang" + file "ietf-fabric-topology-state@2017-11-21.yang" module ietf-fabric-topology-state { yang-version 1.1; namespace "urn:ietf:params:xml:ns:yang:ietf-fabric-topology-state"; prefix sfabric; - import ietf-network { prefix nw; } + import ietf-network-state { prefix nws; } import ietf-fabric-types { prefix fabrictype; revision-date "2016-09-29"; } - import ietf-fabric-topology {prefix fp;} + import ietf-fabric-topology {prefix fabric;} organization "IETF I2RS (Interface to the Routing System) Working Group"; contact "WG Web: WG List: WG Chair: Susan Hares @@ -1030,20 +1060,27 @@ without modification, is permitted pursuant to, and subject to the license terms contained in, the Simplified BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info). This version of this YANG module is part of draft-zhuang-i2rs-yang-dc-fabric-network-topology; see the RFC itself for full legal notices."; + revision "2017-11-21"{ + description + "fix warnings."; + reference + "draft-ietf-i2rs-yang-dc-fabric-network-topology-01"; + } + revision "2017-06-29"{ description "update to NMDA compliant format"; reference "draft-zhuang-i2rs-yang-dc-fabric-network-topology-04"; } //grouping statements grouping fabric-network-type { description "Identify the topology type to be fabric."; @@ -1160,32 +1199,30 @@ } description "bandwidth on the port"; } } grouping fabric-attributes { description "attributes of a fabric"; leaf fabric-id { - type fp:fabric-id; + type fabric:fabric-id; description "fabric id"; - } leaf name { type string; description "name of the fabric"; } - leaf type { type fabrictype:underlayer-network-type; description "The type of physical network that implements this fabric.Examples are vlan, and trill."; } container vni-capacity { description "number of vnis the fabric has"; leaf min { type int32; @@ -1220,35 +1257,36 @@ list device-links { key link-ref; description "include device links within the fabric"; uses link-attributes; } list device-ports { key port-ref; description "include device ports within the fabric"; uses port-attributes; + } } // augment statements - augment "/nw:networks/nw:network/nw:network-types" { + augment "/nws:networks/nws:network/nws:network-types" { description "Introduce new network type for Fabric-based logical topology"; uses fabric-network-type; } - augment "/nw:networks/nw:network/nw:node" { - when "/nw:networks/nw:network/nw:network-types/fabric-network" { + augment "/nws:networks/nws:network/nws:node" { + when "/nws:networks/nws:network/nws:network-types/sfabric:fabric-network" { description "Augmentation parameters apply only for networks with fabric topology."; } description "Augmentation for fabric nodes."; container fabric-attribute-state { config false; description "attributes for a fabric network";