Network Working Group Xufeng Liu
Internet Draft Ericsson
Intended status: Standards Track Vishnu Pavan Beeram
Juniper Networks
Alexander Clemm
Cisco
Igor Bryskin
Aihua Guo
ADVA Optical Networking
Expires: April 27, 2015 October 27, 2014
A Yang module for Traffic Engineering Database (TED)
draft-liu-yang-ted-00
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), its areas, and its working groups. Note that
other groups may also distribute working documents as Internet-
Drafts.
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."
The list of current Internet-Drafts can be accessed at
http://www.ietf.org/ietf/1id-abstracts.txt
The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html
This Internet-Draft will expire on April 27, 2015.
Copyright Notice
Copyright (c) 2014 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
publication of this document. Please review these documents
Liu, et al Expires April 27, 2015 [Page 1]
Internet-Draft YANG - TED October 2014
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.
Abstract
This document defines a YANG module for Traffic Engineering
Database.
Conventions used in this document
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 RFC-2119 [RFC2119].
Table of Contents
1. Introduction...................................................2
2. Tree Structure.................................................3
3. TED Yang Module................................................4
4. Security Considerations.......................................16
5. IANA Considerations...........................................16
6. Normative References..........................................16
7. Acknowledgments...............................................17
1. Introduction
MPLS-TE and GMPLS based Traffic-Engineering (TE) systems provide
tools to establish paths through a network in a controlled manner.
TE paths are computed by examining the Traffic Engineering Database
(TED) and selecting a sequence of links and nodes that are capable
of catering to the requirements of the path to be established. The
TED contains all the relevant information that a Path computation
function needs and is typically constructed from information
distributed by link-state protocols like OSPF-TE, ISIS-TE and BGP-
LS.
This document defines a YANG [RFC6020] [RFC6021] module for Traffic
Engineering Database. This "TED" module contains a set of groupings
capturing data related to traffic engineering and can be used as a
helper-module for other YANG modules that define OSPF-Topology, ISIS
Topology or Abstract TE Topology.
Liu, et al Expires April 27, 2015 [Page 2]
Internet-Draft YANG - TED October 2014
2. Tree Structure
The structure of the groupings in this module are depicted below.
Brackets enclose list keys, "rw" means configuration data, "ro"
means operational state data, and "?" designates optional nodes.
module: ted
grouping ted-node-attributes
+--rw te-router-id-ipv4? inet:ipv4-address
+--rw te-router-id-ipv6? inet:ipv6-address
+--rw ipv4-local-address* [ipv4-prefix]
| +--rw ipv4-prefix inet:ipv4-prefix
+--rw ipv6-local-address* [ipv6-prefix]
| +--rw ipv6-prefix inet:ipv6-prefix
| +--rw prefix-option? uint8
+--rw pcc-capabilities? pcc-capabilities
grouping ted-link-attributes
+--rw link-index? uint64
+--rw information-source? enumeration
+--rw credibility-preference? uint16
+--rw admin-status? enumeration
+--rw oper-status? enumeration
+--rw area-id? binary
+--rw color? uint32
+--rw max-link-bandwidth? decimal64
+--rw max-resv-link-bandwidth? decimal64
+--rw unreserved-bandwidth* [priority]
| +--rw priority uint8
| +--rw bandwidth? decimal64
+--rw te-default-metric? uint32
+--rw link-protection-type? enumeration
+--rw interface-switching-capabilities* [switching-capability]
| +--rw switching-capability ted:switching-capabilities
| +--rw encoding? ted:encoding-type
| +--rw max-lsp-bandwidth* [priority]
| | +--rw priority uint8
| | +--rw bandwidth? decimal64
| +--rw packet-switch-capable
| | +--rw minimum-lsp-bandwidth? decimal64
| | +--rw interface-mtu? uint16
| +--rw time-division-multiplex-capable
| +--rw minimum-lsp-bandwidth? decimal64
| +--rw indication? enumeration
Liu, et al Expires April 27, 2015 [Page 3]
Internet-Draft YANG - TED October 2014
+--rw srlg
| +--rw srlg-values* [srlg-value]
| +--rw srlg-value uint32
+--rw alt-information-sources* [information-source]
+--rw information-source enumeration
+--rw credibility-preference? uint16
+--rw link-index? uint64
+--rw color? uint32
+--rw max-link-bandwidth? decimal64
+--rw max-resv-link-bandwidth? decimal64
+--rw unreserved-bandwidth* [priority]
| +--rw priority uint8
| +--rw bandwidth? decimal64
+--rw te-default-metric? uint32
+--rw link-protection-type? enumeration
+--rw interface-switching-capabilities* [switching-capability]
| +--rw switching-capability ted:switching-capabilities
| +--rw encoding? ted:encoding-type
| +--rw max-lsp-bandwidth* [priority]
| | +--rw priority uint8
| | +--rw bandwidth? decimal64
| +--rw packet-switch-capable
| | +--rw minimum-lsp-bandwidth? decimal64
| | +--rw interface-mtu? uint16
| +--rw time-division-multiplex-capable
| +--rw minimum-lsp-bandwidth? decimal64
| +--rw indication? enumeration
+--rw srlg
+--rw srlg-values* [srlg-value]
+--rw srlg-value uint32
3. TED Yang Module
module ted {
yang-version 1;
namespace "urn:TBD:params:xml:ns:yang:network:ted";
// replace with IANA namespace when assigned
prefix ted;
import ietf-inet-types {
prefix "inet";
}
organization "TBD";
contact "TBD";
Liu, et al Expires April 27, 2015 [Page 4]
Internet-Draft YANG - TED October 2014
description
"Helper module to hold trafic engineering attributes for
any topology on which trafic engineering is enabled.";
revision 2014-10-27 {
description
"Initial revision";
reference
"RFC 4220: Traffic Engineering Link Management Information
Base.
RFC 6825: Traffic Engineering Database Management Information
Base in Support of MPLS-TE/GMPLS.
RFC 4802: Generalized Multiprotocol Label Switching (GMPLS)
Traffic Engineering Management Information Base";
}
typedef switching-capabilities {
type enumeration {
enum "psc-1" {
value 1;
description
"Packet-Switch Capable-1 (PSC-1)";
}
enum "evpl" {
value 30;
description
"Ethernet Virtual Private Line (EVPL)";
}
enum "l2sc" {
value 51;
description
"Layer-2 Switch Capable (L2SC)";
}
enum "tdm" {
value 100;
description
"Time-Division-Multiplex Capable (TDM)";
}
enum "otn-tdm" {
value 110;
description
"OTN-TDM Capable";
}
enum "lsc" {
value 150;
Liu, et al Expires April 27, 2015 [Page 5]
Internet-Draft YANG - TED October 2014
description
"Lambda-Switch Capable (LSC)";
}
enum "fsc" {
value 200;
description
"Fiber-Switch Capable (FSC)";
}
}
description
"Switching Capabilities of an interface.";
reference
"RFC 5307: IS-IS Extensions in Support of Generalized
Multi-Protocol Label Switching (GMPLS).
RFC 3812: Multiprotocol Label Switching (MPLS) Traffic
Engineering (TE) Management Information Base (MIB).
RFC 7074: Revised Definition of the GMPLS Switching
Capability and Type Fields.
RFC 7138: Traffic Engineering Extensions to OSPF
for GMPLS Control of Evolving G.709 Optical Transport
Networks.
RFC 7139: GMPLS Signaling Extensions for Control of Evolving
G.709 Optical Transport Networks.";
}
typedef encoding-type {
type enumeration {
enum "not-gmpls" {
value 0;
description
"GMPLS is not in use";
}
enum "packet" {
value 1;
description
"Packet";
}
enum "ethernet" {
value 2;
description
"Ethernet";
}
enum "pdh" {
value 3;
description
Liu, et al Expires April 27, 2015 [Page 6]
Internet-Draft YANG - TED October 2014
"PDH";
}
enum "sdh-sonet" {
value 5;
description
"SDH or SONET";
}
enum "digital-wrapper" {
value 7;
description
"Digital Wrapper";
}
enum "lambda" {
value 8;
description
"Lambda";
}
enum "fiber" {
value 9;
description
"Fiber";
}
enum "fiber-channel" {
value 11;
description
"Fiber Channel";
}
enum "oduk" {
value 12;
description
"G.709 OKUk (Digital Path)";
}
enum "optical-channel" {
value 13;
description
"G.709 Optical Channel";
}
}
description
"Encoding type of an interface.";
reference
"RFC 3471: Generalized Multi-Protocol Label Switching (GMPLS)
Signaling Functional Description.
RFC 4328: Generalized Multi-Protocol Label Switching (GMPLS)
Signaling Extensions for G.709 Optical Transport Networks
Control.";
Liu, et al Expires April 27, 2015 [Page 7]
Internet-Draft YANG - TED October 2014
}
typedef pcc-capabilities {
type bits {
bit path-computation-with-gmpls-link-constraints {
position 0;
description "Link constraints";
}
bit bidirectional-path-computation {
position 1;
description "Bidirectional";
}
bit diverse-path-computation {
position 2;
description "Diverse";
}
bit load-balanced-path-computation {
position 3;
description "Load balanced";
}
bit synchronized-path-computation {
position 4;
description "Synchronized";
}
bit support-for-multiple-objective-functions {
position 5;
description "Multiple objective functions";
}
bit support-for-additive-path-constraints {
position 6;
description "Additive path constraints";
}
bit support-for-request-prioritization {
position 7;
description "Request prioritization";
}
bit support-for-multiple-requests-per-message {
position 8;
description "Multiple requests per message";
}
}
description
"Path Computation Capabilities.";
reference
"RFC 5088, draft-ietf-pce-disco-protoc-isis-07.txt
OSPF/ISIS Protocol Extensions for Path Computation Element
Liu, et al Expires April 27, 2015 [Page 8]
Internet-Draft YANG - TED October 2014
(PCE) Discovery.";
}
grouping ted-node-attributes {
description
"Identifier to uniquely identify a node in TED";
reference
"RFC 5305, RFC 6119: IPv6 Traffic Engineering in IS-IS/OSPF";
leaf te-router-id-ipv4 {
type inet:ipv4-address;
description
"Globally unique IPv4 Traffic Engineering Router ID.";
}
leaf te-router-id-ipv6 {
type inet:ipv6-address;
description
"Globally unique IPv6 Traffic Engineering Router ID";
}
list ipv4-local-address {
key "ipv4-prefix";
description
"List of IPv4 Local Address(OSPF). RFC 5786";
leaf ipv4-prefix {
type inet:ipv4-prefix;
description
"Local IPv4 address for the node";
}
}
list ipv6-local-address {
key "ipv6-prefix";
description
"List of IPv6 Local Address.";
reference
"RFC 5786: Advertising a Router's Local Addresses
in OSPF Traffic Engineering (TE) Extensions";
leaf ipv6-prefix {
type inet:ipv6-prefix;
description
"Local IPv6 address for the node";
}
leaf prefix-option {
type uint8;
description
"IPv6 prefix option.";
}
Liu, et al Expires April 27, 2015 [Page 9]
Internet-Draft YANG - TED October 2014
}
leaf pcc-capabilities {
type pcc-capabilities;
description
"OSPF/ISIS PCC capabilities";
}
}
grouping ted-link-info-attributes {
description
"Advertised TE informaton attributes.";
leaf information-source {
type enumeration {
enum "unknown" {
description "The source is unknown";
}
enum "locally-configured" {
description "Configured TE link";
}
enum "ospfv2" {
description "OSPFv2";
}
enum "ospfv3" {
description "OSPFv3";
}
enum "isis" {
description "ISIS";
}
enum "other" {
description "Other source";
}
}
description
"Indicates the source of the information about the link";
}
leaf credibility-preference {
type uint16;
description
"The preference value to calculate the traffic engineering
database credibility value used for tie-break selection
between different information-source values.
Higher value is more preferable.";
}
leaf link-index {
type uint64;
description
Liu, et al Expires April 27, 2015 [Page 10]
Internet-Draft YANG - TED October 2014
"The link identifier. If OSPF is used, this represents an
ospfLsdbID. If IS-IS is used, this represents an isisLSPID.
If a locally configured link is used, this object represents
an unique value, which is locally defined in a router.";
}
leaf color {
type uint32;
description
"Administrative group or color of the link";
}
leaf max-link-bandwidth {
type decimal64 {
fraction-digits 2;
}
description
"Maximum bandwidth that can be see on this link in this
direction. Units in bytes per second";
}
leaf max-resv-link-bandwidth {
type decimal64 {
fraction-digits 2;
}
description
"Maximum amount of bandwidth that can be reserved in this
direction in this link. Units in bytes per second";
}
list unreserved-bandwidth {
key "priority";
max-elements "8";
description
"Unreserved bandwidth for 0-7 priority levels. Units in
bytes per second";
leaf priority {
type uint8 {
range "0..7";
}
description "Priority";
}
leaf bandwidth {
type decimal64 {
fraction-digits 2;
}
description
"Unreserved bandwidth for this level";
}
Liu, et al Expires April 27, 2015 [Page 11]
Internet-Draft YANG - TED October 2014
}
leaf te-default-metric {
type uint32;
description
"Traffic Engineering Metric";
}
leaf link-protection-type {
type enumeration {
enum "unprotected" {
description "unprotected";
}
enum "extra-traffic" {
description "Extra traffic";
}
enum "shared" {
description "Shared";
}
enum "1-for-1" {
description "One for one protection";
}
enum "1-plus-1" {
description "One plus one protection";
}
enum "enhanced" {
description "Enhanced protection";
}
}
description
"Link Protection Type desired for this link";
}
list interface-switching-capabilities {
key "switching-capability";
description
"List of interface capabilities for this interface";
leaf switching-capability {
type ted:switching-capabilities;
description
"Switching Capability for this interface";
}
leaf encoding {
type ted:encoding-type;
description
"Encoding supported by this interface";
}
list max-lsp-bandwidth {
key "priority";
Liu, et al Expires April 27, 2015 [Page 12]
Internet-Draft YANG - TED October 2014
max-elements "8";
description
"Maximum LSP Bandwidth at priorities 0-7";
leaf priority {
type uint8 {
range "0..7";
}
description "Priority";
}
leaf bandwidth {
type decimal64 {
fraction-digits 2;
}
description
"Max LSP Bandwidth for this level";
}
}
container packet-switch-capable {
when "../switching-capability = PSC-1 or "
+"../switching-capability = PSC-2 or "
+"../switching-capability = PSC-3 or "
+"../switching-capability = PSC-4" {
description "Valid only for PSC";
}
description
"Interface has packet-switching capabilities";
leaf minimum-lsp-bandwidth {
type decimal64 {
fraction-digits 2;
}
description
"Minimum LSP Bandwidth. Units in bytes per second";
}
leaf interface-mtu {
type uint16;
description
"Interface MTU";
}
}
container time-division-multiplex-capable {
when "../switching-capability = TDM" {
description "Valid only for TDM";
}
description
"Interface has time-division multiplex capabilities";
Liu, et al Expires April 27, 2015 [Page 13]
Internet-Draft YANG - TED October 2014
leaf minimum-lsp-bandwidth {
type decimal64 {
fraction-digits 2;
}
description
"Minimum LSP Bandwidth. Units in bytes per second";
}
leaf indication {
type enumeration {
enum "standard" {
description "Indicates support of standard SONET/SDH";
}
enum "arbitrary" {
description "Indicates support of arbitrary
SONET/SDH";
}
}
description
"Indication whether the interface supports Standard or
Arbitrary SONET/SDH";
}
}
}
container srlg {
description
"Shared Risk Link Group Attributes";
uses srlg-attributes;
}
}
grouping ted-link-attributes {
description
"TED Attributes associated with the link.";
reference
"RFC 3630, RFC 3784: IS-IS / OSPF Traffic Engineering (TE)";
leaf admin-status {
type enumeration {
enum up {
value 1;
description
"Enabled.";
}
enum down {
value 2;
description
"Disabled.";
Liu, et al Expires April 27, 2015 [Page 14]
Internet-Draft YANG - TED October 2014
}
enum testing {
value 3;
description
"In some test mode.";
}
}
description
"The desired state of the link.";
}
leaf oper-status {
type enumeration {
enum up {
value 1;
description
"Operational up";
}
enum down {
value 2;
description
"Operational down.";
}
enum testing {
value 3;
description
"In some test mode";
}
enum unknown {
value 4;
description
"Status cannot be determined for some reason.";
}
}
description
"The current operational state of the link.";
}
leaf area-id {
type binary {
length 1..13;
}
description
"This object indicates the area identifier of the IGP.
If OSPF is used to advertise LSA, this represents an
ospfArea. If IS-IS is used, this represents an area address.
Otherwise, this is zero.";
}
Liu, et al Expires April 27, 2015 [Page 15]
Internet-Draft YANG - TED October 2014
uses ted-link-info-attributes;
list alt-information-sources {
key "information-source";
description
"A list of information sources";
uses ted-link-info-attributes;
}
}
grouping srlg-attributes {
description
"Shared Risk Link Group Attributes";
reference
"RFC 5307, RFC 4203: ISIS / OSPF Extensions in Support of
Generalized Multi-Protocol Label Switching (GMPLS)";
list srlg-values {
key "srlg-value";
description
"List of Shared Risk Link Group this interface belongs to.";
leaf srlg-value {
type uint32;
description
"Shared Risk Link Group value";
}
}
}
}
4. Security Considerations
The YANG module by itself does not create any security implications.
5. IANA Considerations
TBD
6. Normative References
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[RFC6020] Bjorklund, M., "YANG - A Data Modeling language for the
Network Configuration Protocol (NETCONF)", RFC 6020,
October 2010.
[RFC6021] Schoenwaelder, J., "Common YANG Data Types", RFC 6021,
October 2010.
Liu, et al Expires April 27, 2015 [Page 16]
Internet-Draft YANG - TED October 2014
7. Acknowledgments
The authors of this draft would like to thank the
authors/contributors of <draft-clemm-i2rs-yang-network-topo> for
laying the foundation for Topology specific YANG modules.
Authors' Addresses
Xufeng Liu
Ericsson
Xufeng.liu@ericsson.com
Vishnu Pavan Beeram
Juniper Networks
Email: vbeeram@juniper.net
Alexander Clemm
Cisco
alex@cisco.com
Igor Bryskin
ADVA Optical Networking
Email: ibryskin@advaoptical.com
Aihua Guo
ADVA Optical Networking
Email: aguo@advaoptical.com
Liu, et al Expires April 27, 2015 [Page 17]