Internet DRAFT - draft-ietf-trill-yang-oam
draft-ietf-trill-yang-oam
Internet Draft Deepak Kumar
T. Senevirathne
Norman Finn
Samer Salam
CISCO
Liang Xia
Weiguo Hao
Huawei
Category: Standard Track
Expires October 2017 March 31, 2017
YANG Data Model for TRILL Operations, Administration,
and Maintenance (OAM)
draft-ietf-trill-yang-oam-05.txt
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 May 04, 2016.
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
publication of this document. Please review these documents
Kumar, Deepak Expires October 2, 2017 [Page 1]
Internet Draft TRILL OAM YANG March 31, 2017
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 presents YANG Data model for TRILL OAM. It extends the
Generic YANG model for OAM defined in with TRILL technology
specifics. Table of Contents.
Kumar, Deepak Expires October 2, 2017 [Page 2]
Internet Draft TRILL OAM YANG March 31, 2017
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3
2. Conventions used in this document . . . . . . . . . . . . . . . 3
2.1. Terminology . . . . . . . . . . . . . . . . . . . . . . . 3
3. Architecture of OAM YANG Model and Relationship to TRILL OAM . 4
4. TRILL extensions to Generic YANG Model . . . . . . . . . . . . 4
4.1 MEP Address . . . . . . . . . . . . . . . . . . . . . . . . 5
4.2 Flow Entropy . . . . . . . . . . . . . . . . . . . . . . . . 5
4.3 Context-id . . . . . . . . . . . . . . . . . . . . . . . . . 5
4.5 RPC definition . . . . . . . . . . . . . . . . . . . . . . . 5
5. OAM data hierarchy . . . . . . . . . . . . . . . . . . . . . . 6
6. OAM YANG module . . . . . . . . . . . . . . . . . . . . . . . . 9
7. Base Mode for TRILL OAM . . . . . . . . . . . . . . . . . . . . 19
8. Security Considerations . . . . . . . . . . . . . . . . . . . 19
9. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 19
10. References . . . . . . . . . . . . . . . . . . . . . . . . . 20
10.1. Normative References . . . . . . . . . . . . . . . . . . 20
10.2. Informative References . . . . . . . . . . . . . . . . . 20
11. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 20
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 21
1. Introduction
Fault Management for TRILL is defined in [TRILLOAMFM]. TRILL Fault
Management utilizes the [8021Q] CFM model and extends CFM with
technology specific details. Those technology specific extensions are
flow-entropy for multipath support, MEP addressing on TRILL
identifiers, and so on. The extensions are explained in detail in
[TRILLOAMFM]. In this document, we extend the YANG model defined in
[GENYANGOAM] with TRILL OAM specifics.
2. 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]. In this document,
these words will appear with that interpretation only when in ALL
CAPS. Lower case uses of these words are not to be interpreted as
carrying RFC-2119 significance.
2.1. Terminology
CCM - Continuity Check Message [8021Q]
ECMP - Equal Cost Multipath
LBM - Loopback Message [8021Q]
MP - Maintenance Point [8021Q]
MEP - Maintenance End Point [RFC7174] [8021Q] [RFC6371]
Kumar, Deepak Expires October 2, 2017 [Page 3]
Internet Draft TRILL OAM YANG March 31, 2017
MIP - Maintenance Intermediate Point [RFC7174] [8021Q] [RFC6371]
MA - Maintenance Association [8021Q] [RFC7174]
MD - Maintenance Domain [8021Q]
MTV - Multi-destination Tree Verification Message
OAM - Operations, Administration, and Maintenance [RFC6291]
TRILL - Transparent Interconnection of Lots of Links [RFC6325]
3. Architecture of OAM YANG Model and Relationship to TRILL OAM
+-+-+-+-+-+
| CO |
|OAM YANG |
+-+-+-+-+-+
|
O
|
+--------------------------------------------------+
| | | |
+-+-+-+-+-+ +-+-+-+-+-+ +-+-+-+-+-+ +-+-+-+-+-+
| TRILL | | NVO3 | | MPLS-TP | . . .| foo |
|OAM YANG | |OAM YANG | |OAM YANG | |OAM YANG |
+-+-+-+-+-+ +-+-+-+-+-+ +-+-+-+-+-+ +-+-+-+-+-+
| | | |
+----------------------------------------------------+
| Uniform API |
+----------------------------------------------------+
Figure 1 Relationship of TRILL OAM YANG model to
Generic Connection Oriented OAM YANG model
4. TRILL extensions to Generic YANG Model
The Technology parameter is defined in the [GENYANGOAM] as an
identity. This allows easy extension of the YANG model by other
technologies. Technology-specific extensions are applied only when
the Technology parameter is set to the specific type. "trill" is
defined as an identity that augments the base "technology-types".
identity trill { base goam:technology-types; description
"trill type"; }
Figure 2 Trill identity type.
Kumar, Deepak Expires October 2, 2017 [Page 4]
Internet Draft TRILL OAM YANG March 31, 2017
4.1 MEP Address
In TRILL, the MEP address is the 2 octet RBridge Nickname. In
[GENYANGOAM] MEP address is defined as a combination choice and case
statement. We augment this to include TRILL RBridge nickname. augment
"/goam:domains/goam:domain/goam:MAs/goam:MA/goam:MEP/goam:mep-
address" { case mep-address-trill { leaf mep-address-trill {
when "/goam:domains/goam:domain/goam:technology='trill'";
type tril-rb-nickname; } } }
Figure 3 Augment MEP address
4.2 Flow Entropy
In TRILL, flow-entropy is defined as a 96 octet field. [GENYANGOAM]
defines a placeholder for flow-entropy. This allows other
technologies to easily augment that to include technology-specific
augmentations. Below figure depicts an example of augmenting flow-
entropy to include TRILL flow-entropy. augment
"/goam:domains/goam:domain/goam:MAs/goam:MA/goam:flow-entropy" {
case flow-entropy-trill { leaf flow-entropy-trill { type
flow-entropy-trill; } } }
Figure 4 TRILL flow-entropy
4.3 Context-id
In TRILL, context-id is either 12 bit VLAN identifier or 24 bit fine-
grained label. [GENYANGOAM] defines a placeholder for context-id.
This allows other technologies to easily augment that to include
technology specific extensions. The snippet below depicts an example
of augmenting context-id to include the TRILL context-id.
augment
"/goam:domains/goam:domain/goam:MAs/goam:MA/goam:MEP/goam:context-id"
{ case context-id-vlan { leaf context-id-vlan { type
vlan; } } case context-id-fgl { leaf context-id-fgl {
type fgl; } } }
Figure 5 TRILL context-id
4.5 RPC definition
The rpc model facilitates issuing commands to a NETCONF server (in
this case to the device that needs to execute the OAM command) and
obtaining a response. Grouping statement command-ext-trill defines
the input extensions for TRILL.
Kumar, Deepak Expires October 2, 2017 [Page 5]
Internet Draft TRILL OAM YANG March 31, 2017
Continuity-check (CCM)[RFC7455]], continuity-verification
(LBM/LBR)[RFC7455], and traceroute (PTM/PTR)[RFC7455] are defined in
Generic Lime Model[GENYANGOAM].
Multicast Tree Verification (MTV) [RFC7455] rpc command, defined in
TRILL YANG model, is TRILL specific and allows to verify connectivity
as well as data-plane and control-plane integrity of TRILL multicast
forwarding.
5. OAM data hierarchy
The complete data hierarchy related to the OAM YANG model is
presented below. The following notations are used within the data
tree and carry the meaning as noted below. Each node is printed as:
<status> <flags> <name> <opts> <type>
<status> is one of: + for current x for deprecated o
for obsolete
<flags> is one of: rw for configuration data ro for non-
configuration data -x for rpcs -n for notifications
<name> is the name of the node
If the node is augmented into the tree from another module, its
name is printed as <prefix>:<name>.
<opts> is one of: ? for an optional leaf or choice ! for a
presence container * for a leaf-list or list [<keys>] for a
list's keys
<type> is the name of the type for leafs and leaf-lists
module: ietf-trill-oam
augment /goam:domains/goam:domain/goam:MAs/goam:MA/goam:MEP/goam:mep-address:
+--:(mep-address-trill)
+--rw mep-address-trill? tril-rb-nickname
augment /goam:domains/goam:domain/goam:MAs/goam:MA/goam:connectivity-context:
+--:(connectivity-context-vlan)
| +--rw connectivity-context-vlan? vlan
+--:(connectivity-context-fgl)
+--rw connectivity-context-fgl? fgl
augment /goam:domains/goam:domain/goam:MAs/goam:MA:
+--rw flow-entropy-trill? flow-entropy-trill
augment /goam:domains/goam:domain/goam:MAs/goam:MA/goam:MEP:
+--rw flow-entropy-trill? flow-entropy-trill
augment /goam:domains/goam:domain/goam:MAs/goam:MA/goam:MEP/goam:session:
Kumar, Deepak Expires October 2, 2017 [Page 6]
Internet Draft TRILL OAM YANG March 31, 2017
+--rw flow-entropy-trill? flow-entropy-trill
augment /goam:continuity-check/goam:input:
+---- (out-of-band)?
| +--:(ipv4-address)
| | +---- ipv4-address? inet:ipv4-address
| +--:(ipv6-address)
| | +---- ipv6-address? inet:ipv6-address
| +--:(trill-nickname)
| +---- trill-nickname? tril-rb-nickname
+---- diagnostic-vlan? boolean
augment /goam:continuity-check/goam:input:
+---- flow-entropy-trill? flow-entropy-trill
augment /goam:continuity-check/goam:output:
+---- upstream-rbridge? tril-rb-nickname
+---- next-hop-rbridge* tril-rb-nickname
augment /goam:continuity-verification/goam:input:
+---- (out-of-band)?
| +--:(ipv4-address)
| | +---- ipv4-address? inet:ipv4-address
| +--:(ipv6-address)
| | +---- ipv6-address? inet:ipv6-address
| +--:(trill-nickname)
| +---- trill-nickname? tril-rb-nickname
+---- diagnostic-vlan? boolean
augment /goam:continuity-verification/goam:input:
+---- flow-entropy-trill? flow-entropy-trill
augment /goam:continuity-verification/goam:output:
+--:(monitor-stats-resp)
| +---- tx-packt-count? oam-counter32
| +---- rx-packet-count? oam-counter32
| +---- min-delay? oam-counter32
| +---- average-delay? oam-counter32
| +---- max-delay? oam-counter32
+---- upstream-rbridge? tril-rb-nickname
+---- next-hop-rbridge* tril-rb-nickname
augment /goam:traceroute/goam:input:
+---- (out-of-band)?
| +--:(ipv4-address)
| | +---- ipv4-address? inet:ipv4-address
| +--:(ipv6-address)
| | +---- ipv6-address? inet:ipv6-address
| +--:(trill-nickname)
| +---- trill-nickname? tril-rb-nickname
+---- diagnostic-vlan? boolean
augment /goam:traceroute/goam:input:
+---- flow-entropy-trill? flow-entropy-trill
augment /goam:traceroute/goam:output/goam:response:
+--:(monitor-stats-ext)
Kumar, Deepak Expires October 2, 2017 [Page 7]
Internet Draft TRILL OAM YANG March 31, 2017
| +---- tx-packt-count? oam-counter32
| +---- rx-packet-count? oam-counter32
| +---- min-delay? oam-counter32
| +---- average-delay? oam-counter32
| +---- max-delay? oam-counter32
+---- upstream-rbridge? tril-rb-nickname
+---- next-hop-rbridge* tril-rb-nickname
rpcs:
+---x mtv
+---w input
| +---w technology identityref
| +---w MD-name-string MD-name-string
| +---w MA-name-string? MA-name-string
| +---w (out-of-band)?
| | +--:(ipv4-address)
| | | +---w ipv4-address? inet:ipv4-address
| | +--:(ipv6-address)
| | | +---w ipv6-address? inet:ipv6-address
| | +--:(trill-nickname)
| | +---w trill-nickname? tril-rb-nickname
| +---w diagnostic-vlan? boolean
| +---w (flow-entropy)?
| | +--:(flow-entropy-null)
| | | +---w flow-entropy-null? empty
| | +--:(flow-entropy-trill)
| | +---w flow-entropy-trill? flow-entropy-trill
| +---w max-hop-count? uint8
| +---w type? identityref
| +---w scope* tril-rb-nickname
| +---w ecmp-choice? enumeration
| +---w outgoing-interfaces* [interface]
| | +---w interface if:interface-ref
| +---w source-mep
| | +---w (mep-address)?
| | | +--:(mac-address)
| | | | +---w mac-address? yang:mac-address
| | | +--:(ipv4-address)
| | | | +---w ipv4-address? inet:ipv4-address
| | | +--:(ipv6-address)
| | | +---w ipv6-address? inet:ipv6-address
| | +---w mep-id? tril-rb-nickname
| +---w destination-mep
| +---w (mep-address)?
| | +--:(mac-address)
| | | +---w mac-address? yang:mac-address
| | +--:(ipv4-address)
| | | +---w ipv4-address? inet:ipv4-address
| | +--:(ipv6-address)
Kumar, Deepak Expires October 2, 2017 [Page 8]
Internet Draft TRILL OAM YANG March 31, 2017
| | +---w ipv6-address? inet:ipv6-address
| +---w mep-id? tril-rb-nickname
+--ro output
+--ro response* [mep-address mep-id]
+--ro hop-count? uint8
+--ro mep-id tril-rb-nickname
+--ro mep-address tril-rb-nickname
+--ro next-hop-rbridge* tril-rb-nickname
+--ro upstream-rbridge? tril-rb-nickname
+--ro multicast-receiver-count? uint32
+--ro tx-packt-count? oam-counter32
+--ro rx-packet-count? oam-counter32
+--ro min-delay? oam-counter32
+--ro average-delay? oam-counter32
+--ro max-delay? oam-counter32
6. OAM YANG module
<CODE BEGINS> file "ietf-trill-oam.yang"
module ietf-trill-oam {
namespace "urn:ietf:params:xml:ns:yang:ietf-trill-oam";
prefix trilloam;
import ietf-conn-oam {
prefix goam;
}
import ietf-inet-types {
prefix inet;
}
import ietf-interfaces {
prefix if;
}
import ietf-yang-types {
prefix yang;
}
organization "IETF TRILL Working Group";
contact
"
WG List: mailto:trill@ietf.org
Editor: Deepak Kumar dekumar@cisco.com";
description
"This YANG module defines the configuration for TRILL,
OAM Fault Management statistics and rpc";
revision 2016-07-17 {
Kumar, Deepak Expires October 2, 2017 [Page 9]
Internet Draft TRILL OAM YANG March 31, 2017
description
"Initial revision.";
reference "draft-ietf-trill-yang-oam";
}
identity trill {
base goam:technology-types;
description
"trill type";
}
typedef oam-counter32 {
type yang:zero-based-counter32;
description
"defines 32 bit counter for OAM";
}
typedef tril-rb-nickname {
type uint16;
description
"Trill Rbridge Nickname";
}
typedef flow-entropy-trill {
type binary {
length "1..96";
}
description
"Flow entropy as defined in RFC7455";
}
typedef vlan {
type uint16 {
range "0..4095";
}
description
"Vlan Identifier.";
}
typedef fgl {
type uint32;
description
"Fine Grain Label";
}
identity trill-mtv {
base goam:command-sub-type;
description
Kumar, Deepak Expires October 2, 2017 [Page 10]
Internet Draft TRILL OAM YANG March 31, 2017
"identfies this command as multicast tree verification comand";
}
identity trill-ping {
base goam:command-sub-type;
description
"identifies the command as TRILL Loopback Request";
}
identity trill-trace-route {
base goam:command-sub-type;
description
"identifies the command as TRILL Pathtrace Request.";
}
grouping command-ext-trill {
description
"group the rpc command extensions for trill";
choice out-of-band {
case ipv4-address {
leaf ipv4-address {
type inet:ipv4-address;
description
"ip version 4 address of the device where out of
band reply should be sent.";
}
}
case ipv6-address {
leaf ipv6-address {
type inet:ipv6-address;
description
"ip version 6 address of the device where out of
band reply should be sent.";
}
}
case trill-nickname {
leaf trill-nickname {
type tril-rb-nickname;
description
"TRILL Rbridge Nickname of the device where out of
band reply should be sent.";
}
}
description
"presence of this node indicate out of band request needed";
}
leaf diagnostic-vlan {
type boolean;
Kumar, Deepak Expires October 2, 2017 [Page 11]
Internet Draft TRILL OAM YANG March 31, 2017
description
"indicates whether to include diagnostic VLAN/fgl TLV or not
in the request. actual value is the VLAN/FGL specified
in the command";
}
}
grouping monitor-stats-trill {
leaf tx-packt-count {
type oam-counter32;
description
"Transmitted Packet count";
}
leaf rx-packet-count {
type oam-counter32;
description
"Received packet count, zero for one way message (CCM).";
}
leaf min-delay {
type oam-counter32;
units milliseconds;
description
"Delay is specified in milliseconds, zero for one
way message (CCM).";
}
leaf average-delay {
type oam-counter32;
units millisecond;
description
"average delay in milliseconds, zero for one way
message (CCM).";
}
leaf max-delay {
type oam-counter32;
units millisecond;
description
"Maximum delay in milliseconds, zero for one way
message (CCM).";
}
description
"Monitor Statistics";
}
augment "/goam:domains/goam:domain/goam:MAs/goam:MA/goam:MEP/goam:mep-address" {
case mep-address-trill {
leaf mep-address-trill {
when "/goam:domains/goam:domain/goam:technology='trill'" {
description
Kumar, Deepak Expires October 2, 2017 [Page 12]
Internet Draft TRILL OAM YANG March 31, 2017
"Technology TRILL";
}
type tril-rb-nickname;
description
"MEP Address TRILL Rbridge Nickname.";
}
}
description
"Extend Generic OAM Maintenance Point Address.";
}
augment "/goam:domains/goam:domain/goam:MAs/goam:MA/goam:connectivity-context" {
case connectivity-context-vlan {
leaf connectivity-context-vlan {
type vlan;
description
"Connectivity context Vlan Identifier.";
}
}
case connectivity-context-fgl {
leaf connectivity-context-fgl {
type fgl;
description
"connectivity context Fine Grain Label.";
}
}
description
"Extends connectivity context.";
}
augment "/goam:domains/goam:domain/goam:MAs/goam:MA" {
leaf flow-entropy-trill {
type flow-entropy-trill;
description
"connectivity context flow entropy.";
}
description
"Extends Flow Entropy.";
}
augment
"/goam:domains/goam:domain/goam:MAs/goam:MA/goam:MEP" {
leaf flow-entropy-trill {
type flow-entropy-trill;
description
"Flow Entropy TRILL";
}
description
Kumar, Deepak Expires October 2, 2017 [Page 13]
Internet Draft TRILL OAM YANG March 31, 2017
"Extends Flow Entropy defined under Generic OAM MEP.";
}
augment
"/goam:domains/goam:domain/goam:MAs/goam:MA/goam:MEP/goam:session" {
leaf flow-entropy-trill {
type flow-entropy-trill;
description
"Flow Entropy TRILL";
}
description
"Extends Flow Entropy defined under Generic OAM Session.";
}
augment "/goam:continuity-check/goam:input" {
uses command-ext-trill;
description
"Extends continuity check input.";
}
augment "/goam:continuity-check/goam:input" {
leaf flow-entropy-trill {
type flow-entropy-trill;
description
"Flow Entropy TRILL";
}
description
"Extends continuity check input Flow entropy.";
}
augment "/goam:continuity-check/goam:output" {
description
"adds trill specific items on the response";
leaf upstream-rbridge {
type tril-rb-nickname;
description
"Trill Rbridge nickname.";
}
leaf-list next-hop-rbridge {
type tril-rb-nickname;
description
"nickname of the next hop RBRdige";
}
}
augment "/goam:continuity-verification/goam:input" {
uses command-ext-trill;
description
"Extends continuity check input.";
}
augment "/goam:continuity-verification/goam:input" {
Kumar, Deepak Expires October 2, 2017 [Page 14]
Internet Draft TRILL OAM YANG March 31, 2017
leaf flow-entropy-trill {
type flow-entropy-trill;
description
"Flow Entropy TRILL";
}
description
"Extends continuity check input Flow entropy.";
}
augment "/goam:continuity-verification/goam:output" {
description
"adds trill specific items on the response";
case monitor-stats-resp {
uses monitor-stats-trill;
}
leaf upstream-rbridge {
type tril-rb-nickname;
description
"Trill Rbridge nickname.";
}
leaf-list next-hop-rbridge {
type tril-rb-nickname;
description
"nickname of the next hop RBRdige";
}
}
augment "/goam:traceroute/goam:input" {
uses command-ext-trill;
description
"Extends path disovery Input.";
}
augment "/goam:traceroute/goam:input" {
leaf flow-entropy-trill {
type flow-entropy-trill;
description
"Flow entropy TRILL.";
}
description
"Extends path discovery input flow entropy.";
}
augment "/goam:traceroute/goam:output/goam:response" {
description
"adds trill specific items on the response";
case monitor-stats-ext {
uses monitor-stats-trill;
}
Kumar, Deepak Expires October 2, 2017 [Page 15]
Internet Draft TRILL OAM YANG March 31, 2017
leaf upstream-rbridge {
type tril-rb-nickname;
description
"Upstream Rbridge nickname.";
}
leaf-list next-hop-rbridge {
type tril-rb-nickname;
description
"nickname of the next hop RBRdige";
}
}
rpc mtv {
description
"Generates Trace-route and return response. Starts with TTL
of one and increment by one at each hop. Untill destination
reached or TTL reach max valune";
input {
uses goam:maintenance-domain-id {
description
"Specifies the MA-domain";
}
uses goam:ma-identifier {
description
"identfies the Maintenance association";
}
uses command-ext-trill {
description
"defines extensions needed for trill.
We are using this structure so mtv command is in line
with ping and trace-route";
}
choice flow-entropy {
case flow-entropy-null {
leaf flow-entropy-null {
type empty;
description
"Empty flow entropy";
}
}
case flow-entropy-trill {
leaf flow-entropy-trill {
type flow-entropy-trill;
description
"Flow Entroy TRILL";
}
}
Kumar, Deepak Expires October 2, 2017 [Page 16]
Internet Draft TRILL OAM YANG March 31, 2017
description
"Flow Entropy choices.";
}
leaf max-hop-count {
type uint8;
default "255";
description
"Defines maximum value of hop count";
}
leaf type {
type identityref {
base goam:command-sub-type;
}
description
"defines different command types";
}
leaf-list scope {
type tril-rb-nickname;
description
"This list contain rbridges that needed to respond
Empty list indicate all Rbridges needed to respond";
reference "RFC7455";
}
leaf ecmp-choice {
type enumeration {
enum "ecmp-use-platform-hash" {
value 0;
description
"Use Platform hashing to send packet on
specified interface.";
}
enum "ecmp-use-round-robin" {
value 1;
description
"Use round robin hashing.";
}
}
description
"Ecmp Choice enumeration.";
}
list outgoing-interfaces {
key "interface";
leaf interface {
Kumar, Deepak Expires October 2, 2017 [Page 17]
Internet Draft TRILL OAM YANG March 31, 2017
type if:interface-ref;
description
"Interface";
}
description
"List of Outgoing Interface.";
}
container source-mep {
uses goam:mep-address;
description
"Source MEP Container.";
leaf mep-id {
type tril-rb-nickname;
description
"Trill Rbridge Nickname";
}
}
container destination-mep {
uses goam:mep-address;
leaf mep-id {
type tril-rb-nickname;
description
"MEP Identifier.";
}
description
"Destination MEP Identifier.";
}
}
output {
list response {
key "mep-address mep-id";
leaf hop-count {
type uint8;
description
"unsigned integer 1-255";
}
leaf mep-id {
type tril-rb-nickname;
description
"Maintenance Endpoint Identifier.";
}
leaf mep-address {
type tril-rb-nickname;
description
"Maintenance Endpoint Address.";
}
leaf-list next-hop-rbridge {
type tril-rb-nickname;
Kumar, Deepak Expires October 2, 2017 [Page 18]
Internet Draft TRILL OAM YANG March 31, 2017
description
"list of downstream rbridges. There is no perticular
order";
}
leaf upstream-rbridge {
type tril-rb-nickname;
description
"Upstream Rbridge Nickname.";
}
leaf multicast-receiver-count {
type uint32;
description
"number of ports that are interested in this multicast
stream";
}
uses monitor-stats-trill;
description
"Output list.";
}
}
}
}
<CODE ENDS>
7. Base Mode for TRILL OAM The Base Mode defines default configuration
that MUST be present in the devices that comply with this document.
Base Mode allows users to have a zero-touch experience. Details of
TRILL Base Mode for OAM are defined in RFC7455 Appendix B.
8. Security Considerations
There are no security considerations relevant to this document.
9. IANA Considerations
This document registers the following namespace URI in the IETF XML
registry. URI:urn:ietf:params:xml:ns:yang:ietf-trill-oam
Kumar, Deepak Expires October 2, 2017 [Page 19]
Internet Draft TRILL OAM YANG March 31, 2017
10. References
10.1. Normative References
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[RFC2234] Crocker, D. and Overell, P.(Editors), "Augmented BNF for
Syntax Specifications: ABNF", RFC 2234, Internet Mail
Consortium and Demon Internet Ltd., November 1997.
[8021Q] IEEE, "Media Access Control (MAC) Bridges and Virtual
Bridged Local Area Networks", IEEE Std 802.1Q-2011,
August, 2011.
[RFC7174] Salam, S., et.al., "Transparent Interconnect of Lots of
Links (TRILL) OAM Framework", May, 2014.
[RFC7455] Senevirathne, T., et.al, "Transparent Interconnect of Lots
of Links(TRILL): Fault Management", March, 2015
10.2. Informative References
[RFC7174] TRILL OAM Framework
[Y1731] ITU, "OAM functions and mechanisms for Ethernet based
networks", ITU-T G.8013/Y.1731, July, 2011.
[RFC6291] Andersson, L., et.al., "Guidelines for the use of the "OAM"
Acronym in the IETF" RFC 6291, June 2011.
[RFC6325] Perlman, R., et.al., "Routing Bridges (RBridges): Base
Protocol Specification", RFC 6325, July 2011.
[GENYANGOAM] Senevirathne, T., et.al., "YANG Data Model for
Operations, Administration and Maintenance (OAM)", Work in
Progress, March, 2014.
11. Acknowledgments
Giles Heron came up with the idea of developing a YANG
model as a way of creating a unified OAM API set
(interface), work in this document is largely an
inspiration of that. Alexander Clemm provided many
valuable tips, comments and remarks that helped to refine
the YANG model presented in this document.
Kumar, Deepak Expires October 2, 2017 [Page 20]
Internet Draft TRILL OAM YANG March 31, 2017
Authors' Addresses
Authors' Addresses
Tissa Senevirathne
CISCO Systems
375 East Tasman Drive.
San Jose, CA 95134
USA.
Phone: 408-853-2291
Email: tsenevir@cisco.com
Norman Finn
CISCO Systems
510 McCarthy Blvd
Milpitas, CA 95035.
Email: nfinn@cisco.com
Deepak Kumar
CISCO Systems
510 McCarthy Blvd
Milpitas, CA 95035.
Email: dekumar@cisco.com
Samer Salam
CISCO Systems
595 Burrard St. Suite 2123
Vancouver, BC V7X 1J1, Canada
Email: ssalam@cisco.com
Liang Xia
Huawei technologies
Email: frank.xialiang@huawei.com
Weiguo Hao
Huawei Technologies
101 Software Avenue
Nanjing 210012, China
Email: haoweiguo@huawei.com
Kumar, Deepak Expires October 2, 2017 [Page 21]