Internet DRAFT - draft-dontula-lsr-yang-dynamic-flooding
draft-dontula-lsr-yang-dynamic-flooding
Internet Engineering Task Force S. Dontula
Internet-Draft ATT
Intended status: Standards Track T. Li
Expires: April 1, 2021 Arista Networks
A. Siddiqui
ATT
September 28, 2020
YANG Data Model for Dynamic Flooding
draft-dontula-lsr-yang-dynamic-flooding-04
Abstract
This document defines YANG data models that can be used to configure
and manage Dynamic Flooding for IS-IS and OSPF.
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 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 April 1, 2021.
Copyright Notice
Copyright (c) 2020 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
(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.
Dontula, et al. Expires April 1, 2021 [Page 1]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
Table of Contents
1. Requirements Language . . . . . . . . . . . . . . . . . . . . 2
2. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2
2.1. Tree Diagrams . . . . . . . . . . . . . . . . . . . . . . 2
3. OSPF Data Model . . . . . . . . . . . . . . . . . . . . . . . 2
3.1. Tree Diagram . . . . . . . . . . . . . . . . . . . . . . 3
3.2. OSPF YANG Module . . . . . . . . . . . . . . . . . . . . 4
4. IS-IS Data Model . . . . . . . . . . . . . . . . . . . . . . 14
4.1. Tree Diagram . . . . . . . . . . . . . . . . . . . . . . 14
4.2. IS-IS YANG Module . . . . . . . . . . . . . . . . . . . . 16
5. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 25
6. Security Considerations . . . . . . . . . . . . . . . . . . . 25
7. RFC Editor Considerations . . . . . . . . . . . . . . . . . . 25
8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 25
9. References . . . . . . . . . . . . . . . . . . . . . . . . . 25
9.1. Normative References . . . . . . . . . . . . . . . . . . 25
9.2. Informative References . . . . . . . . . . . . . . . . . 26
9.3. URIs . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 27
1. Requirements Language
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in BCP 14 [1] [RFC2119]
[RFC8174] when, and only when, they appear in all capitals, as shown
here.
2. Introduction
This document defines a YANG [RFC7950] data model for IS-IS
[ISO10589] and OSPF [RFC2328] routing protocols.
The YANG data models in this document conform to the Network
Management Datastore Architecture defined in [RFC8342].
2.1. Tree Diagrams
Tree diagrams used in this document follow the notation defined in
[RFC8340].
3. OSPF Data Model
Dontula, et al. Expires April 1, 2021 [Page 2]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
3.1. Tree Diagram
module: ietf-dynamic-flooding-ospf
augment /rt:routing/rt:control-plane-protocols
/rt:control-plane-protocol/ospf:ospf/ospf:areas
/ospf:area:
+--rw dynamic-flooding {dynamic-flooding-ospf}?
+--rw enable? boolean
+--rw area-leader
+--rw enable? boolean
+--rw priority? uint8
+--rw algorithm? uint8
augment /rt:routing/rt:control-plane-protocols
/rt:control-plane-protocol/ospf:ospf/ospf:areas/ospf:area
/ospf:database/ospf:area-scope-lsa-type
/ospf:area-scope-lsas/ospf:area-scope-lsa/ospf:version
/ospf:ospfv2/ospf:ospfv2/ospf:body/ospf:opaque:
+--ro area-leader-tlv {dynamic-flooding-ospf}?
| +--ro priority? uint8
| +--ro algorithm? uint8
+--ro dynamic-flooding-tlv {dynamic-flooding-ospf}?
+--ro algorithms* uint8
augment /rt:routing/rt:control-plane-protocols
/rt:control-plane-protocol/ospf:ospf/ospf:areas/ospf:area
/ospf:database/ospf:area-scope-lsa-type
/ospf:area-scope-lsas/ospf:area-scope-lsa/ospf:version
/ospf:ospfv2/ospf:ospfv2/ospf:body:
+--ro ospfv2-dynamic-flooding-opaque-lsa {dynamic-flooding-ospf}?
+--ro ospfv2-area-router-id-tlv
| +--ro start-index? uint16
| +--ro last-flag? bits
| +--ro ospfv2-router-id-tlv-entry* []
| +--ro connection-type? uint8
| +--ro number-of-ids? uint16
| +--ro originating-router-id* yang:dotted-quad
+--ro flooding-path-tlv
+--ro start-index? uint16
+--ro indices* uint16
augment /rt:routing/rt:control-plane-protocols
/rt:control-plane-protocol/ospf:ospf/ospf:areas/ospf:area
/ospf:database/ospf:area-scope-lsa-type
/ospf:area-scope-lsas/ospf:area-scope-lsa/ospf:version
/ospf:ospfv2/ospf:ospfv2/ospf:body/ospf:opaque
/ospf:extended-link-opaque/ospf:extended-link-tlv:
+--ro ospf-link-attributes-bits-tlv {dynamic-flooding-ospf}?
+--ro link-attributes-bits? bits
augment /rt:routing/rt:control-plane-protocols
Dontula, et al. Expires April 1, 2021 [Page 3]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
/rt:control-plane-protocol/ospf:ospf/ospf:areas/ospf:area
/ospf:database/ospf:area-scope-lsa-type
/ospf:area-scope-lsas/ospf:area-scope-lsa/ospf:version
/ospf:ospfv3/ospf:ospfv3/ospf:body
/ospf:router-information:
+--ro area-leader-tlv {dynamic-flooding-ospf}?
| +--ro priority? uint8
| +--ro algorithm? uint8
+--ro dynamic-flooding-tlv {dynamic-flooding-ospf}?
+--ro algorithms* uint8
augment /rt:routing/rt:control-plane-protocols
/rt:control-plane-protocol/ospf:ospf/ospf:areas/ospf:area
/ospf:database/ospf:area-scope-lsa-type
/ospf:area-scope-lsas/ospf:area-scope-lsa/ospf:version
/ospf:ospfv3/ospf:ospfv3/ospf:body:
+--ro ospfv3-dynamic-flooding-opaque-lsa {dynamic-flooding-ospf}?
+--ro ospfv3-area-router-id-tlv
| +--ro start-index? uint16
| +--ro last-flag? bits
| +--ro ospfv3-router-id-tlv-entry* []
| +--ro connection-type? uint8
| +--ro number-of-ids? uint16
| +--ro router-id
| | +--ro originating-router-id* yang:dotted-quad
| +--ro designated-router-id
| +--ro originating-router-id-list* []
| +--ro originating-router-id? yang:dotted-quad
| +--ro inteface-id? yang:dotted-quad
+--ro flooding-path-tlv
+--ro start-index? uint16
+--ro indices* uint16
3.2. OSPF YANG Module
<CODE BEGINS> file "ietf-dynamic-flooding-ospf@2019-09-01.yang"
module ietf-dynamic-flooding-ospf {
yang-version 1.1;
namespace "urn:ietf:params:xml:ns:yang:ietf-dynamic-flooding-ospf";
prefix ospf-dynflood;
import ietf-ospf {
prefix ospf;
reference
"RFC AAAA: YANG Data Model for OSPF Protocol";
}
Dontula, et al. Expires April 1, 2021 [Page 4]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
import ietf-yang-types {
prefix yang;
reference
"RFC 6991: Common YANG Data Types";
}
import ietf-routing {
prefix rt;
reference
"RFC 8349 - A YANG Data Model for Routing
Management (NMDA Version)";
}
organization
"IETF LSR - Link State Routing Working Group";
contact
"
WG Web:
<https://datatracker.ietf.org/group/lsr/about/>
WG List:
<mailto: lsr@ietf.org>
Editor: Srinath Dontula
<mailto: sd947e@att.com>
Author: Tony Li
<mailto: tony.li@tony.li>
Author: Athar Siddiqui
<mailto: athar@att.com>
";
description
"
Copyright (c) 2019 IETF Trust and the persons identified as
authors of the code. All rights reserved.
Redistribution and use in source and binary forms, with or
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
(https://trustee.ietf.org/license-info).
This version of this YANG module is part of RFC XXXX
(https://www.rfc-editor.org/info/rfcXXXX); see the RFC itself
for full legal notices.
";
revision 2019-09-01 {
description
"Initial draft version.";
Dontula, et al. Expires April 1, 2021 [Page 5]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
reference
"RFC XXXX: YANG Data Model for Dynamic Flooding";
}
feature dynamic-flooding-ospf {
description
"Support for OSPF dynamic flooding";
reference
" RFC YYYY: Dynamic Flooding on Dense Graphs";
}
identity ospfv2-dynamic-flooding-opaque-lsa {
base ospf:ospfv2-opaque-lsa-type;
description
"OSPFv2 Dynamic Flooding Opaque LSA - Type 10";
}
identity ospfv3-dynamic-flooding-opaque-lsa {
base ospf:ospfv3-lsa-type;
description
"OSPFv3 Dynamic Flooding LSA - Type 16";
}
grouping ospf-area-leader-tlv {
description
"Area leader TLV for OSPFv2/OSPFv3.
A TLV of RI LSA";
leaf priority {
type uint8;
description
"Router's priority for Area leader";
}
leaf algorithm {
type uint8;
description
"Router's Algorithm to calculate the Flooding
Topology.";
}
}
grouping dynamic-flooding-tlv {
description
"Dynamic-flooding TLV for OSPFv2/OSPFv3.
A TLV of RI LSA";
leaf-list algorithms {
type uint8;
description
"List of Algorithms supported by the
Dontula, et al. Expires April 1, 2021 [Page 6]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
advertising node";
}
}
grouping ospfv2-area-router-id-tlv-entry {
description
"ospfv2 area router ID TLV enties";
leaf connection-type {
type uint8;
description
"Defines the connection type ";
}
leaf number-of-ids {
type uint16;
description
"the number of ID present in this TLV entry";
}
leaf-list originating-router-id {
type yang:dotted-quad;
description
"list of the originating-router-ids";
}
}
grouping ospfv2-area-router-id-tlv {
description
"definition for OSPFv2 Dynamic flooding area
router-ID TLV";
leaf start-index {
type uint16;
description
"Starting index of the first
router/designated router ID";
}
leaf last-flag {
type bits {
bit last-router-designated-router-id {
description
"when set, this TLV is the
last Index in the full list
of router IDs for the area";
reference
"RFC XXXX: Dynamic Flooding
on Dense Graphs";
}
}
description
"last flag";
Dontula, et al. Expires April 1, 2021 [Page 7]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
}
list ospfv2-router-id-tlv-entry {
description
"list of ospfv2 router-ID TLV entries";
uses ospfv2-area-router-id-tlv-entry;
}
}
grouping ospfv3-area-router-id-tlv-entry {
description
"ospfv3 area router ID TLV enties";
leaf connection-type {
type uint8;
description
"Defines the connection type ";
}
leaf number-of-ids {
type uint16;
description
"the number of ID present in this
TLV entry";
}
container router-id {
when '../connection-type = 1' {
description
"Only applies when
connection type is Router";
}
description
"originating-router-id";
leaf-list originating-router-id {
type yang:dotted-quad;
description
"list of the
originating-router-ids";
}
}
container designated-router-id {
when '../connection-type = 2' {
description
"Only applies when
connection type is designated Router";
}
description
"originating-router-id";
list originating-router-id-list {
description
"originating-router-id";
Dontula, et al. Expires April 1, 2021 [Page 8]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
leaf originating-router-id {
type yang:dotted-quad;
description
"originating-router-ids";
}
leaf inteface-id {
type yang:dotted-quad;
description
"interface-ids";
}
}
}
}
grouping ospfv3-area-router-id-tlv {
description
"definition for OSPFv3 Dynamic flooding area
router-ID TLV";
leaf start-index {
type uint16;
description
"Starting index of the first
router/designated router ID";
}
leaf last-flag {
type bits {
bit last-router-designated-router-id {
description
"when set, this TLV is the
last Index in the full list
of router IDs for the area";
reference
"RFC XXXX: Dynamic
Flooding on Dense Graphs";
}
}
description
"dynamic flooding area router-ID
flag definitions";
}
list ospfv3-router-id-tlv-entry {
description
"list of OSPFv3 router-ID TLV entries";
uses ospfv3-area-router-id-tlv-entry;
}
}
grouping flooding-path-tlv {
Dontula, et al. Expires April 1, 2021 [Page 9]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
description
"definition for OSPFv2/OSPFv3 Flooding Path TLV";
leaf start-index {
type uint16;
description
"Starting index of the first
router/designated router ID";
}
leaf-list indices {
type uint16;
description
"index of the next router ID in the
path";
}
}
grouping flooding-request-bit {
description
"definition for adding Floding request bit (FR-bit) to
LLS type-1 extended options. Need to be defined";
}
grouping link-attribute-bits-tlv {
description
"definition for link-attribute-bits-tlv, a sub-tlv for
OSPFv2 Extended link TLV and a sub-tlv for OSPFv3
router-link TLV";
leaf link-attributes-bits {
type bits {
bit LEEF {
description
"when set, conveys which edges
are currently enabled in the
flooding topology";
}
}
description
"link-attributes-bits";
}
}
/*
* Dynamic flooding config augmentation to OSPF Module
*/
grouping area-leader-configuration {
description
"Enable area leader capability";
Dontula, et al. Expires April 1, 2021 [Page 10]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
leaf enable {
type boolean;
default "false";
description
"Enable area leader capability";
}
leaf priority {
type uint8;
description
"Area leader priority";
}
leaf algorithm {
type uint8;
description
"Dynamic flooding algorithm selection";
}
}
augment
"/rt:routing/rt:control-plane-protocols/"
+ "rt:control-plane-protocol/ospf:ospf/ospf:areas/ospf:area" {
if-feature "dynamic-flooding-ospf";
description
"Dynamic-flooding config model
augmentation";
container dynamic-flooding {
description
"to Enable/Disable dynamic flooding
for this specific OSPF area";
leaf enable {
type boolean;
description
"Enable/Disable dynamic-flooding";
}
container area-leader {
description
"Area leader configuration parameters";
uses area-leader-configuration;
}
}
}
/*
* Dynamic flooding state augmentation to OSPF2 module
*/
augment
"/rt:routing/rt:control-plane-protocols/"
Dontula, et al. Expires April 1, 2021 [Page 11]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
+ "rt:control-plane-protocol/ospf:ospf/ospf:areas/"
+ "ospf:area/ospf:database/ospf:area-scope-lsa-type/"
+ "ospf:area-scope-lsas/ospf:area-scope-lsa/"
+ "ospf:version/ospf:ospfv2/ospf:ospfv2/ospf:body/ospf:opaque" {
if-feature "dynamic-flooding-ospf";
description
"dynamic flooding TLVs augmentation";
container area-leader-tlv {
description
"Area-leader-tlv";
uses ospf-area-leader-tlv;
}
container dynamic-flooding-tlv {
description
"dynamic-flooding-tlv";
uses dynamic-flooding-tlv;
}
}
augment "/rt:routing/rt:control-plane-protocols/"
+ "rt:control-plane-protocol/ospf:ospf/ospf:areas/"
+ "ospf:area/ospf:database/ospf:area-scope-lsa-type/"
+ "ospf:area-scope-lsas/ospf:area-scope-lsa/"
+ "ospf:version/ospf:ospfv2/ospf:ospfv2/ospf:body" {
if-feature "dynamic-flooding-ospf";
description
"ospfv2-dynamic-flooding-opaque-lsa augmentation";
container ospfv2-dynamic-flooding-opaque-lsa {
description
"OSPFv2 Dynamic flooding opaque LSA.";
// uses unknown-tlvs;
container ospfv2-area-router-id-tlv {
description
"ospfv2-area-router-id-tlv";
uses ospfv2-area-router-id-tlv;
}
container flooding-path-tlv {
description
"ospf flooding-path-tlv";
uses flooding-path-tlv;
}
}
}
augment "/rt:routing/rt:control-plane-protocols/"
+ "rt:control-plane-protocol/ospf:ospf/ospf:areas/"
+ "ospf:area/ospf:database/ospf:area-scope-lsa-type/"
+ "ospf:area-scope-lsas/ospf:area-scope-lsa/"
Dontula, et al. Expires April 1, 2021 [Page 12]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
+ "ospf:version/ospf:ospfv2/ospf:ospfv2/ospf:body/"
+ "ospf:opaque/ospf:extended-link-opaque/"
+ "ospf:extended-link-tlv" {
if-feature "dynamic-flooding-ospf";
description
"ospf-link-attributes-bits-tlv augmentation";
container ospf-link-attributes-bits-tlv {
description
"ospf link attributes bits tlv.";
uses link-attribute-bits-tlv;
}
}
/*
* Dynamic flooding state augmentation to OSPF3 module
*/
augment "/rt:routing/rt:control-plane-protocols/"
+ "rt:control-plane-protocol/ospf:ospf/ospf:areas/"
+ "ospf:area/ospf:database/ospf:area-scope-lsa-type/"
+ "ospf:area-scope-lsas/ospf:area-scope-lsa/"
+ "ospf:version/ospf:ospfv3/ospf:ospfv3/ospf:body/"
+ "ospf:router-information" {
if-feature "dynamic-flooding-ospf";
description
"dynamic flooding TLVs augmentation";
container area-leader-tlv {
description
"Area-leader-tlv";
uses ospf-area-leader-tlv;
}
container dynamic-flooding-tlv {
description
"dynamic-flooding-tlv";
uses dynamic-flooding-tlv;
}
}
augment "/rt:routing/rt:control-plane-protocols/"
+ "rt:control-plane-protocol/ospf:ospf/ospf:areas/"
+ "ospf:area/ospf:database/ospf:area-scope-lsa-type/"
+ "ospf:area-scope-lsas/ospf:area-scope-lsa/"
+ "ospf:version/ospf:ospfv3/ospf:ospfv3/ospf:body" {
if-feature "dynamic-flooding-ospf";
description
"ospfv3-dynamic-flooding-opaque-lsa
augmentation";
container ospfv3-dynamic-flooding-opaque-lsa {
Dontula, et al. Expires April 1, 2021 [Page 13]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
description
"ospfv3-dynamic-flooding-opaque-lsa
definition";
// uses unknown-tlvs;
container ospfv3-area-router-id-tlv {
description
"ospfv3-area-router-id-tlv";
uses ospfv3-area-router-id-tlv;
}
container flooding-path-tlv {
description
"ospf flooding-path-tlv";
uses flooding-path-tlv;
}
}
}
}
<CODE ENDS>
4. IS-IS Data Model
This data model augments the IS-IS YANG model
[I-D.ietf-isis-yang-isis-cfg] with extensions to support Dynamic
Flooding [I-D.ietf-lsr-dynamic-flooding].
4.1. Tree Diagram
module: ietf-isis-dynflood
augment /rt:routing/rt:control-plane-protocols
/rt:control-plane-protocol/isis:isis:
+--rw area-leader
| +--rw config
| +--rw enable {area-leader}?
| | +--rw value? boolean
| | +--rw level-1
| | | +--rw value? boolean
| | +--rw level-2
| | +--rw value? boolean
| +--rw priority {area-leader}?
| | +--rw value? uint8
| | +--rw level-1
| | | +--rw value? uint8
| | +--rw level-2
| | +--rw value? uint8
| +--rw algorithm {dynamic-flooding}?
| +--rw value? uint8
| +--rw level-1
Dontula, et al. Expires April 1, 2021 [Page 14]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
| | +--rw value? uint8
| +--rw level-2
| +--rw value? uint8
+--rw dynamic-flooding
+--rw config
+--rw enable {dynamic-flooding}?
+--rw value? boolean
+--rw level-1
| +--rw value? boolean
+--rw level-2
+--rw value? boolean
augment /rt:routing/rt:control-plane-protocols
/rt:control-plane-protocol/isis:isis:
+--rw area-leader-state
| +--rw area-leader? string
+--rw area-node-ids {dynamic-flooding}?
| +--rw area-node-ids
| +--rw node-index* [index]
| +--rw index uint16
| +--rw node-id? isis:extended-system-id
+--rw dynamic-flooding-paths {dynamic-flooding}?
| +--ro paths* []
| +--ro path* uint16
+--rw dynamic-flooding-topology {dynamic-flooding}?
| +--ro paths* []
| +--ro path* string
+--rw dynamic-flooding-interfaces {dynamic-flooding}?
+--ro interfaces* []
+--ro inteface? string
+--ro temporary? boolean
augment /rt:routing/rt:control-plane-protocols
/rt:control-plane-protocol/isis:isis/isis:database
/isis:levels/isis:lsp/isis:router-capabilities
/isis:router-capability:
+--ro area-leader
| +--ro priority? uint8
| +--ro algorithm? uint8
+--ro dynamic-flooding
+--ro algorithms* uint8
augment /rt:routing/rt:control-plane-protocols
/rt:control-plane-protocol/isis:isis/isis:database
/isis:levels/isis:lsp:
+--ro area-node-ids
| +--ro starting-index? uint8
| +--ro flags? bits
| +--ro nodes* isis:extended-system-id
+--ro flooding-path
+--ro nodes* uint16
Dontula, et al. Expires April 1, 2021 [Page 15]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
4.2. IS-IS YANG Module
<CODE BEGINS> file "ietf-isis-dynflood@2019-09-01.yang"
module ietf-isis-dynflood {
yang-version 1.1;
// IETF:
namespace "urn:ietf:params:xml:ns:yang:ietf-isis-dynflood";
// OpenConfig:
// namespace "http://openconfig.net/yang/openconfig-isis-dynflood";
prefix isis-dynflood;
// OpenConfig:
// import openconfig-network-instance {
// prefix oc-netinst;
// }
// NB: This module is currently under development and is intended to
// augment the IETF IS-IS module (currently
// draft-ietf-isis-yang-isis-cfg-36). While that is in process, we are
// developing against the openconfig model, and references to IETF
// paths are commented out.
// IETF:
import ietf-routing {
prefix "rt";
reference
"RFC 8349 - A YANG Data Model for Routing Management
(NMDA Version)";
}
import ietf-isis {
prefix "isis";
reference
"RFC ZZZZ: YANG Data Model for IS-IS Protocol";
}
organization "IETF LSR Working Group";
contact "WG List: <mailto:lsr@ietf.org>";
description "
First draft of a YANG model for IS-IS dynamic flooding.
Copyright (c) 2019 IETF Trust and the persons identified as
authors of the code. All rights reserved.
Redistribution and use in source and binary forms, with or
Dontula, et al. Expires April 1, 2021 [Page 16]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
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
(https://trustee.ietf.org/license-info).
This version of this YANG module is part of RFC XXXX
(https://www.rfc-editor.org/info/rfcXXXX); see the RFC itself
for full legal notices.
The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL', 'SHALL
NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED', 'NOT RECOMMENDED',
'MAY', and 'OPTIONAL' in this document are to be interpreted as
described in BCP 14 (RFC 2119) (RFC 8174) when, and only when,
they appear in all capitals, as shown here.
Authors:
Srinath Dontula
<mailto:sd947e@att.com>
Tony Li
<mailto:tony.li@tony.li>";
revision 2019-09-01 {
description "Initial revision";
reference "RFC XXXX";
}
// OpenConfig:
// typedef extended-system-id {
// type string {
// pattern
// '[0-9A-Fa-f]{4}\.[0-9A-Fa-f]{4}\.[0-9A-Fa-f]{4}\.'
// +'[0-9][0-9]';
// }
// description
// "This type defines IS-IS system-id using pattern. The extended
// system-id contains the pseudonode number in addition to the
// system-id.
// An example system-id is 0143.0438.AEF0.00";
// }
feature area-leader {
description "Election of a leader for the area.";
}
feature dynamic-flooding {
if-feature area-leader;
Dontula, et al. Expires April 1, 2021 [Page 17]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
description "Compute a reduced flooding topology.";
}
grouping area-leader-global-cfg {
description "Enable area leader capability";
leaf value {
type boolean;
default false;
description "Enable area leader capability";
}
}
grouping area-leader-priority-cfg {
description "Set the area leader priority";
leaf value {
type uint8;
default 200;
description "Area leader priority";
}
}
grouping area-leader-algorithm-cfg {
description "Select the flooding topology computation algorithm";
leaf value {
type uint8;
default 0;
description "Dynamic flooding algorithm selection";
}
}
grouping area-leader-parameters {
description "Area leader configuration parameters";
container area-leader {
description "Area leader configuration parameters";
container config {
description "Area leader configuration";
container enable {
if-feature area-leader;
description "Area leader global enable configuration";
uses area-leader-global-cfg;
container level-1 {
description "level-1 specific configuration";
uses area-leader-global-cfg;
}
container level-2 {
description "level-2 specific configuration";
uses area-leader-global-cfg;
}
Dontula, et al. Expires April 1, 2021 [Page 18]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
}
container priority {
if-feature area-leader;
description "Area leader priority configuration";
uses area-leader-priority-cfg;
container level-1 {
description "level-1 specific configuration";
uses area-leader-priority-cfg;
}
container level-2 {
description "level-2 specific configuration";
uses area-leader-priority-cfg;
}
}
container algorithm {
if-feature dynamic-flooding;
description "Area leader algorithm configuration";
uses area-leader-algorithm-cfg;
container level-1 {
description "level-1 specific configuration";
uses area-leader-algorithm-cfg;
}
container level-2 {
description "level-2 specific configuration";
uses area-leader-algorithm-cfg;
}
}
}
}
}
grouping dynamic-flooding-global-cfg {
description "Enable dynamic flooding capability";
leaf value {
type boolean;
default false;
description "Enable dynamic flooding capability";
}
}
grouping dynamic-flooding-parameters {
description "Dynamic flooding configuration parameters";
container dynamic-flooding {
description "Dynamic flooding configuration parameters";
container config {
description "Dynamic flooding configuration";
Dontula, et al. Expires April 1, 2021 [Page 19]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
container enable {
if-feature dynamic-flooding;
description "Dynamic flooding global enable configuration";
uses dynamic-flooding-global-cfg;
container level-1 {
description "level-1 specific configuration";
uses dynamic-flooding-global-cfg;
}
container level-2 {
description "level-2 specific configuration";
uses dynamic-flooding-global-cfg;
}
}
}
}
}
// IETF:
augment "/rt:routing/rt:control-plane-protocols/"
+"rt:control-plane-protocol/isis:isis" {
// OpenConfig:
// augment "/oc-netinst:network-instances/" +
// "oc-netinst:network-instance/oc-netinst:protocols/" +
// "oc-netinst:protocol/oc-netinst:isis/oc-netinst:global" {
description
"Area leader and dynamic flooding configuration additions";
uses area-leader-parameters;
uses dynamic-flooding-parameters;
}
grouping dynamic-flooding-paths {
description "List of paths in the topology";
list paths {
config false;
description "A list of paths";
leaf-list path {
type uint16;
description "A list of node indicies";
}
}
}
grouping dynamic-flooding-topology {
description "List of paths in the topology";
list paths {
config false;
description "A list of paths";
leaf-list path {
Dontula, et al. Expires April 1, 2021 [Page 20]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
type string;
description "A list of node names";
}
}
}
grouping dynamic-flooding-interfaces {
description "List of flooding topology interfaces";
list interfaces {
config false;
description "List of interfaces and their temporary status";
leaf inteface {
type string;
description "Interface name";
}
leaf temporary {
type boolean;
description "Set for partition repair or new adjacencies";
}
}
}
grouping area-leader-state {
description "Area leader state information";
container area-leader-state {
description "Area leader election result";
leaf area-leader {
type string;
description "Hostname of the area leader";
}
}
}
grouping dynamic-flooding-state {
description "State information for dynamic flooding";
container area-node-ids {
if-feature dynamic-flooding;
description "Area node ids and indices";
container area-node-ids {
description "List of nodes and indices";
list node-index {
key index;
description "List of nodes and their indices";
leaf index {
type uint16;
description "Index for the node";
}
leaf node-id {
Dontula, et al. Expires April 1, 2021 [Page 21]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
// OpenConfig:
// type extended-system-id;
// IETF:
type isis:extended-system-id;
description "Node id for the node";
}
}
}
}
container dynamic-flooding-paths {
if-feature dynamic-flooding;
description "Flooding topology with explicit paths";
uses dynamic-flooding-paths;
}
container dynamic-flooding-topology {
if-feature dynamic-flooding;
description "Flooding topology with system names";
uses dynamic-flooding-topology;
}
container dynamic-flooding-interfaces {
if-feature dynamic-flooding;
description "Interfaces on the flooding topology";
uses dynamic-flooding-interfaces;
}
}
// IETF:
augment "/rt:routing/rt:control-plane-protocols/"
+"rt:control-plane-protocol/isis:isis" {
// OpenConfig:
// augment "/oc-netinst:network-instances/" +
// "oc-netinst:network-instance/oc-netinst:protocols/" +
// "oc-netinst:protocol/oc-netinst:isis/" +
// "oc-netinst:levels/oc-netinst:level/oc-netinst:state" {
description "Area leader and dynamic flooding state additions";
uses area-leader-state;
uses dynamic-flooding-state;
}
grouping subtlv27-area-leader {
description "Router capability subTLV for area leader capability";
container area-leader {
description "Area leader subTLV for router capabilities";
leaf priority {
type uint8;
description "Area leader priority";
}
leaf algorithm {
Dontula, et al. Expires April 1, 2021 [Page 22]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
type uint8;
description
"Algorithm index for computing the flooding topology";
}
}
}
grouping subtlv28-dynamic-flooding {
description "Dynamic flooding capability subTLV";
container dynamic-flooding {
description "Dynamic flooding capability subTLV";
leaf-list algorithms {
type uint8;
description "Supported algorithm indices for distributed mode";
}
}
}
// OpenConfig:
// augment "/oc-netinst:network-instances/" +
// "oc-netinst:network-instance/" +
// "oc-netinst:protocols/oc-netinst:protocol/oc-netinst:isis/" +
// "oc-netinst:levels/oc-netinst:level/" +
// "oc-netinst:link-state-database/" +
// "oc-netinst:lsp/oc-netinst:tlvs/oc-netinst:tlv/" +
// "oc-netinst:router-capabilities/oc-netinst:capability/" +
// "oc-netinst:subtlvs/oc-netinst:subtlv" {
// IETF:
augment "/rt:routing/rt:control-plane-protocols"
+"/rt:control-plane-protocol/isis:isis"
+"/isis:database/isis:levels/isis:lsp/isis:router-capabilities/" +
"isis:router-capability" {
description
"Additional router capability subTLVs for dynamic flooding";
uses subtlv27-area-leader;
uses subtlv28-dynamic-flooding;
}
grouping tlv17-area-node-ids {
description "TLV 17: Area Node IDs";
container area-node-ids {
description "Dynamic flooding node id assignment TLV";
leaf starting-index {
type uint8;
description "Starting index for the node ids in this TLV.";
}
leaf flags {
type bits {
Dontula, et al. Expires April 1, 2021 [Page 23]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
bit last {
position 0;
description
"Set if this is the highest set of indices in the area.";
}
}
description "Flags field in the TLV.";
}
leaf-list nodes {
// OpenConfig:
// type extended-system-id;
// IETF:
type isis:extended-system-id;
description "Nodes being assigned indices";
}
}
}
grouping tlv18-flooding-path {
description "Flooding topology path TLV";
container flooding-path {
description "Dynamic flooding path TLV";
leaf-list nodes {
type uint16;
description "Nodes in the path";
}
}
}
// OpenConfig:
// augment "/oc-netinst:network-instances/" +
// "oc-netinst:network-instance/oc-netinst:protocols/" +
// "oc-netinst:protocol/oc-netinst:isis/" +
// "oc-netinst:levels/oc-netinst:level/" +
// "oc-netinst:link-state-database/" +
// "oc-netinst:lsp/oc-netinst:tlvs/oc-netinst:tlv" {
// IETF:
augment "/rt:routing/rt:control-plane-protocols" +
"/rt:control-plane-protocol/isis:isis/isis:database/isis:levels/" +
"isis:lsp" {
description "Additional TLVs for dynamic flooding";
uses tlv17-area-node-ids;
uses tlv18-flooding-path;
}
}
<CODE ENDS>
Dontula, et al. Expires April 1, 2021 [Page 24]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
5. Acknowledgements
The authors would like to thank Derek Yeung, Nidhi Bhaskar, Tom
Petch, and Kavitha Prasad for their comments and assistance.
6. Security Considerations
This document introduces no new security issues.
7. RFC Editor Considerations
In the body of this document, please replace the following strings
with RFC numbers for the associated document once it is published.
AAAA YANG Data Model for OSPF Protocol [I-D.ietf-ospf-yang]
XXXX This document
YYYY Dynamic Flooding on Dense Graphs
[I-D.ietf-lsr-dynamic-flooding]
ZZZZ YANG Data Model for IS-IS Protocol
[I-D.ietf-isis-yang-isis-cfg]
Please replace "2019-09-01" with the date of publication.
8. IANA Considerations
This document registers two URIs in the IETF XML registry [RFC3688].
The following registrations are requested:
URI: urn:ietf:params:xml:ns:yang:ietf-dynamic-flooding-ospf
Registrant Contact: The IESG.
XML: N/A, the requested URI is an XML namespace.
URI: urn:ietf:params:xml:ns:yang:ietf-isis-dynflood
Registrant Contact: The IESG.
XML: N/A, the requested URI is an XML namespace.
9. References
9.1. Normative References
[I-D.ietf-isis-yang-isis-cfg]
Litkowski, S., Yeung, D., Lindem, A., Zhang, Z., and L.
Lhotka, "YANG Data Model for IS-IS Protocol", draft-ietf-
isis-yang-isis-cfg-42 (work in progress), October 2019.
Dontula, et al. Expires April 1, 2021 [Page 25]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
[I-D.ietf-lsr-dynamic-flooding]
Li, T., Psenak, P., Ginsberg, L., Chen, H., Przygienda,
T., Cooper, D., Jalil, L., Dontula, S., and G. Mishra,
"Dynamic Flooding on Dense Graphs", draft-ietf-lsr-
dynamic-flooding-07 (work in progress), June 2020.
[I-D.ietf-ospf-yang]
Yeung, D., Qu, Y., Zhang, Z., Chen, I., and A. Lindem,
"YANG Data Model for OSPF Protocol", draft-ietf-ospf-
yang-29 (work in progress), October 2019.
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119,
DOI 10.17487/RFC2119, March 1997,
<https://www.rfc-editor.org/info/rfc2119>.
[RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688,
DOI 10.17487/RFC3688, January 2004,
<https://www.rfc-editor.org/info/rfc3688>.
[RFC7950] Bjorklund, M., Ed., "The YANG 1.1 Data Modeling Language",
RFC 7950, DOI 10.17487/RFC7950, August 2016,
<https://www.rfc-editor.org/info/rfc7950>.
[RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC
2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174,
May 2017, <https://www.rfc-editor.org/info/rfc8174>.
[RFC8342] Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K.,
and R. Wilton, "Network Management Datastore Architecture
(NMDA)", RFC 8342, DOI 10.17487/RFC8342, March 2018,
<https://www.rfc-editor.org/info/rfc8342>.
9.2. Informative References
[ISO10589]
International Organization for Standardization,
"Intermediate System to Intermediate System Intra-Domain
Routing Exchange Protocol for use in Conjunction with the
Protocol for Providing the Connectionless-mode Network
Service (ISO 8473)", ISO/IEC 10589:2002, Nov. 2002.
[RFC2328] Moy, J., "OSPF Version 2", STD 54, RFC 2328,
DOI 10.17487/RFC2328, April 1998,
<https://www.rfc-editor.org/info/rfc2328>.
Dontula, et al. Expires April 1, 2021 [Page 26]
Internet-Draft YANG Data Model for Dynamic Flooding September 2020
[RFC8340] Bjorklund, M. and L. Berger, Ed., "YANG Tree Diagrams",
BCP 215, RFC 8340, DOI 10.17487/RFC8340, March 2018,
<https://www.rfc-editor.org/info/rfc8340>.
9.3. URIs
[1] https://tools.ietf.org/html/bcp14
Authors' Addresses
Srinath Dontula
ATT
200 S. Laurel Ave
Middletown, New Jersey 07748
United States of America
Email: sd947e@att.com
Tony Li
Arista Networks
5453 Great America Parkway
Santa Clara, California 95054
United States of America
Email: tony.li@tony.li
Athar Siddiqui
ATT
200 S. Laurel Ave
Middletown, New Jersey 07748
United States of America
Email: athar@att.com
Dontula, et al. Expires April 1, 2021 [Page 27]
