Skip to main content

YANG Data Model for TRILL Operations, Administration, and Maintenance (OAM)
draft-ietf-trill-yang-oam-02

The information below is for an old version of the document.
Document Type
This is an older version of an Internet-Draft whose latest revision state is "Expired".
Authors Deepak Kumar , Tissa Senevirathne , Norman Finn , Samer Salam , Liang Xia , Hao Weiguo
Last updated 2015-11-01
Replaces draft-tissa-trill-yang-oam
RFC stream Internet Engineering Task Force (IETF)
Formats
Reviews
Additional resources Mailing list discussion
Stream WG state WG Document
Document shepherd Susan Hares
IESG IESG state I-D Exists
Consensus boilerplate Unknown
Telechat date (None)
Responsible AD (None)
Send notices to (None)
draft-ietf-trill-yang-oam-02
Internet Draft                                           Deepak Kumar
                                                         T. Senevirathne
                                                         Norman Finn
                                                         Samer Salam
                                                            CISCO
                                                         Liang Xia
                                                         Weiguo Hao
                                                            Huawei
Category: Standard Track                                    
Expires November 2015                                  November 01, 2015

         YANG Data Model for TRILL Operations, Administration, 
and Maintenance (OAM)

                    draft-ietf-trill-yang-oam-02.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) 2015 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 May 4, 2016                   [Page 1]
Internet Draft               TRILL PM YANG              November 1, 2015

   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 [GENYANGOAM] with TRILL
   technology specifics. Table of Contents.

 

Kumar, Deepak             Expires May 4, 2016                   [Page 2]
Internet Draft               TRILL PM YANG              November 1, 2015

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 
      PM  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  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 . . . . . . . . . . . . . . . . . . . . . . . .  8
   7. Base Mode for TRILL OAM . . . . . . . . . . . . . . . . . . . . 17
   8.  Security Considerations  . . . . . . . . . . . . . . . . . . . 17
   9.  IANA Considerations  . . . . . . . . . . . . . . . . . . . . . 17
   10.  References  . . . . . . . . . . . . . . . . . . . . . . . . . 18
     10.1.  Normative References  . . . . . . . . . . . . . . . . . . 18
     10.2.  Informative References  . . . . . . . . . . . . . . . . . 18
   11.  Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 18
   Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 18

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]
 

Kumar, Deepak             Expires May 4, 2016                   [Page 3]
Internet Draft               TRILL PM YANG              November 1, 2015

      MEP - Maintenance End Point [TRLOAMFRM] [8021Q] [RFC6371]
      MIP - Maintenance Intermediate Point [TRLOAMFRM] [8021Q] [RFC6371]
      MA - Maintenance Association [8021Q] [TRLOAMFRM]
      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 PM

                             +-+-+-+-+-+
                             |  Gen    |
                             |OAM YANG |
                             +-+-+-+-+-+
                                  | 
                                  O
                                  |
          +--------------------------------------------------+
          |                |               |                 | 
      +-+-+-+-+-+     +-+-+-+-+-+     +-+-+-+-+-+       +-+-+-+-+-+
      | TRILL   |     | NVO3    |     | MPLS    |  . . .|  foo    |
      |OAM YANG |     |OAM YANG |     |OAM YANG |       |OAM YANG |
      +-+-+-+-+-+     +-+-+-+-+-+     +-+-+-+-+-+       +-+-+-+-+-+ 
            |               |               |               |   
          +----------------------------------------------------+
          |             Uniform API                            |
          +----------------------------------------------------+

            Figure 1 Relationship of TRILL OAM YANG model to 
                             Generic 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 May 4, 2016                   [Page 4]
Internet Draft               TRILL PM YANG              November 1, 2015

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. Multicast Tree Verification (MTV)
 

Kumar, Deepak             Expires May 4, 2016                   [Page 5]
Internet Draft               TRILL PM YANG              November 1, 2015

   [TRILLOAMFM] 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:mp-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/goam:flow-entropy:
      +--:(flow-entropy-trill)
         +--rw flow-entropy-trill?   flow-entropy-trill
   augment 
   /goam:domains/goam:domain/goam:MAs/goam:MA/goam:
   MEP/goam:flow-entropy:
      +--:(flow-entropy-trill)
 

Kumar, Deepak             Expires May 4, 2016                   [Page 6]
Internet Draft               TRILL PM YANG              November 1, 2015

         +--rw flow-entropy-trill?   flow-entropy-trill
   augment /goam:domains/goam:domain/goam:MAs/goam:MA/goam:MEP/goam:
   session/goam:flow-entropy:
      +--:(flow-entropy-trill)
         +--rw flow-entropy-trill?   flow-entropy-trill
   augment /goam:continuity-check/goam:input:
      +--ro (out-of-band)?
      |  +--:(ipv4-address)
      |  |  +--ro ipv4-address?      inet:ipv4-address
      |  +--:(ipv6-address)
      |  |  +--ro ipv6-address?      inet:ipv6-address
      |  +--:(trill-nickname)
      |     +--ro trill-nickname?    tril-rb-nickname
      +--ro diagnostic-vlan?   boolean
   augment /goam:continuity-check/goam:input/goam:flow-entropy:
      +--:(flow-entropy-trill)
         +--ro flow-entropy-trill?   flow-entropy-trill
   augment /goam:continuity-check/goam:output:
      +--ro upstream-rbridge?   tril-rb-nickname
      +--ro next-hop-rbridge*   tril-rb-nickname
   augment /goam:path-discovery/goam:input:
      +--ro (out-of-band)?
      |  +--:(ipv4-address)
      |  |  +--ro ipv4-address?      inet:ipv4-address
      |  +--:(ipv6-address)
      |  |  +--ro ipv6-address?      inet:ipv6-address
      |  +--:(trill-nickname)
      |     +--ro trill-nickname?    tril-rb-nickname
      +--ro diagnostic-vlan?   boolean
   augment /goam:path-discovery/goam:input/goam:flow-entropy:
      +--:(flow-entropy-trill)
         +--ro flow-entropy-trill?   flow-entropy-trill
   augment /goam:path-discovery/goam:output/goam:response:
      +--ro upstream-rbridge?   tril-rb-nickname
      +--ro next-hop-rbridge*   tril-rb-nickname
   rpcs:
      +---x mtv    
         +--ro input     
         |  +--ro technology             identityref
         |  +--ro MD-name-string         MD-name-string
         |  +--ro MA-name-string?        MA-name-string
         |  +--ro (out-of-band)?
         |  |  +--:(ipv4-address)
         |  |  |  +--ro ipv4-address?          inet:ipv4-address
         |  |  +--:(ipv6-address)
         |  |  |  +--ro ipv6-address?          inet:ipv6-address
         |  |  +--:(trill-nickname)
         |  |     +--ro trill-nickname?        tril-rb-nickname
 

Kumar, Deepak             Expires May 4, 2016                   [Page 7]
Internet Draft               TRILL PM YANG              November 1, 2015

         |  +--ro diagnostic-vlan?       boolean
         |  +--ro (flow-entropy)?
         |  |  +--:(flow-entropy-null)
         |  |  |  +--ro flow-entropy-null?     empty
         |  |  +--:(flow-entropy-trill)
         |  |     +--ro flow-entropy-trill?    flow-entropy-trill
         |  +--ro max-hop-count?         uint8
         |  +--ro type?                  identityref
         |  +--ro scope*                 tril-rb-nickname
         |  +--ro ecmp-choice?           goam:ecmp-choices
         |  +--ro outgoing-interfaces* [interface]
         |  |  +--ro interface    if:interface-ref
         |  +--ro source-mep
         |  |  +--ro (mp-address)?
         |  |  |  +--:(mac-address)
         |  |  |  |  +--ro mac-address?    yang:mac-address
         |  |  |  +--:(ipv4-address)
         |  |  |  |  +--ro ipv4-address?   inet:ipv4-address
         |  |  |  +--:(ipv6-address)
         |  |  |     +--ro ipv6-address?   inet:ipv6-address
         |  |  +--ro mep-id?         tril-rb-nickname
         |  +--ro destination-mep
         |     +--ro (mp-address)?
         |     |  +--:(mac-address)
         |     |  |  +--ro mac-address?    yang:mac-address
         |     |  +--:(ipv4-address)
         |     |  |  +--ro ipv4-address?   inet:ipv4-address
         |     |  +--:(ipv6-address)
         |     |     +--ro ipv6-address?   inet:ipv6-address
         |     +--ro 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

 

Kumar, Deepak             Expires May 4, 2016                   [Page 8]
Internet Draft               TRILL PM YANG              November 1, 2015

   <CODE BEGINS> file "ietf-gen-oam.yang"
   module ietf-trill-oam {
        namespace "urn:cisco:params:xml:ns:yang:ietf-tril-oam";
        prefix trilloam;

        import ietf-gen-oam {
          prefix goam;
        }
        import ietf-inet-types {
          prefix inet;
        }
        import ietf-interfaces {
          prefix if;
        }
        organization "IETF TRILL Working Group";
        contact
          "Deepak Kumar dekumar@cisco.com";
        description
          "This YANG module defines the configuration for TRILL,
           OAM Fault Management statistics and rpc";

        revision 2015-11-01 {
          description
            "Initial revision.";
          reference "RFC 7455";
        }

       identity trill {
          base goam:technology-types;
          description
            "trill type";
        }

        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 {
 

Kumar, Deepak             Expires May 4, 2016                   [Page 9]
Internet Draft               TRILL PM YANG              November 1, 2015

          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
            "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.";
              }
            }
            case ipv6-address {
              leaf ipv6-address {
                type inet:ipv6-address;
                description
                  "ip version 6 address.";
              }
 

Kumar, Deepak             Expires May 4, 2016                  [Page 10]
Internet Draft               TRILL PM YANG              November 1, 2015

            }
            case trill-nickname {
              leaf trill-nickname {
                type tril-rb-nickname;
                description
                  "TRILL Rbridge Nickname.";
              }
            }
            description
              "presence of this node indicate out of band request needed";
          }
          leaf diagnostic-vlan {
            type boolean;
            description
              "indicates whether to include diagnostic VLAN/fgl TLV or not
               in the request.  actual value is the VLAN/FGL specified
               in the command";
          }
        }

        augment "/goam:domains/goam:domain/goam:MAs/goam:MA/goam:MEP/goam:mp-address" {
          case mep-address-trill {
            leaf mep-address-trill {
              when "/goam:domains/goam:domain/goam:technology='trill'" {
                description
                 "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
 

Kumar, Deepak             Expires May 4, 2016                  [Page 11]
Internet Draft               TRILL PM YANG              November 1, 2015

               "connectivity context Fine Grain Label.";
            }
          }
          description
            "Extends connectivity context.";
        }

        augment "/goam:domains/goam:domain/goam:MAs/goam:MA/goam:flow-entropy" {
          case flow-entropy-trill {
            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/goam:flow-entropy" {
          case flow-entropy-trill {
            leaf flow-entropy-trill {
              type flow-entropy-trill;
              description
                "Flow Entropy TRILL";
            }
          }
          description
            "Extends Flow Entropy defined under Generic OAM MEP.";
        }

        augment
      "/goam:domains/goam:domain/goam:MAs/goam:MA/goam:MEP/goam:session/goam:flow-entropy" {
          case flow-entropy-trill {
            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.";
 

Kumar, Deepak             Expires May 4, 2016                  [Page 12]
Internet Draft               TRILL PM YANG              November 1, 2015

        }

        augment "/goam:continuity-check/goam:input/goam:flow-entropy" {
          case flow-entropy-trill {
            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:path-discovery/goam:input" {
          uses command-ext-trill;
          description
             "Extends path disovery Input.";
        }

        augment "/goam:path-discovery/goam:input/goam:flow-entropy" {
          case flow-entropy-trill {
            leaf flow-entropy-trill {
              type flow-entropy-trill;
              description
                "Flow entropy TRILL.";
            }
          }
          description
            "Extends path discovery input flow entropy.";
        }

        augment "/goam:path-discovery/goam:output/goam:response" {
          description
 

Kumar, Deepak             Expires May 4, 2016                  [Page 13]
Internet Draft               TRILL PM YANG              November 1, 2015

            "adds trill specific items on the response";
          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 May 4, 2016                  [Page 14]
Internet Draft               TRILL PM YANG              November 1, 2015

              }
              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 goam:ecmp-choices;
              description
                "0 means use the specified interface
                 1 means use round robin";
            }

            list outgoing-interfaces {
              key "interface";
              leaf interface {
                type if:interface-ref;
                description
                  "Interface";
              }
              description
                "List of Outgoing Interface.";
            }
            container source-mep {
              uses goam:mp-address;
              description
 

Kumar, Deepak             Expires May 4, 2016                  [Page 15]
Internet Draft               TRILL PM YANG              November 1, 2015

                "Source MEP Container.";
              leaf mep-id {
                type tril-rb-nickname;
                description
                  "Trill Rbridge Nickname";
              }
            }
            container destination-mep {
              uses goam:mp-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;
                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 {
 

Kumar, Deepak             Expires May 4, 2016                  [Page 16]
Internet Draft               TRILL PM YANG              November 1, 2015

                type uint32;
                description
                  "number of ports that are interested in this multicast
      stream";
              }
              uses goam:monitor-stats;
              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].

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:TBD

 

Kumar, Deepak             Expires May 4, 2016                  [Page 17]
Internet Draft               TRILL PM YANG              November 1, 2015

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.

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.

   [TRLOAMFRM] Salam, S., et.al., "TRILL OAM Framework", draft-ietf-
              trill-oam-framework, Work in Progress, November, 2012.

   [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.

Authors' Addresses
 

Kumar, Deepak             Expires May 4, 2016                  [Page 18]
Internet Draft               TRILL PM YANG              November 1, 2015

   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 May 4, 2016                  [Page 19]