[Docs] [txt|pdf] [Tracker] [WG] [Email] [Nits]

Versions: 00 01 02 03 04 draft-ietf-bier-bier-yang

BIER WG                                                        Ran. Chen
Internet-Draft                                               Fangwei. Hu
Intended status: Standards Track                            Zheng. Zhang
Expires: January 7, 2016                                    Xianxia. Dai
                                                         ZTE Corporation
                                                            July 6, 2015


                   YANG Data Model for BIER Protocol
                    draft-chh-bier-bier-yang-00.txt

Abstract

   This document defines a YANG data model for BIER configuration and
   operation.

Status of This Memo

   This Internet-Draft is submitted in full conformance with the
   provisions of BCP 78 and BCP 79.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF).  Note that other groups may also distribute
   working documents as Internet-Drafts.  The list of current Internet-
   Drafts is at http://datatracker.ietf.org/drafts/current/.

   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 January 7, 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
   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.




Chen, et al.             Expires January 7, 2016                [Page 1]


Internet-Draft                  BIER YANG                      July 2015


Table of Contents

   1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   2
   2.  Design of the Data Model  . . . . . . . . . . . . . . . . . .   2
   3.  Configuration . . . . . . . . . . . . . . . . . . . . . . . .   4
   4.  Control plane configuration . . . . . . . . . . . . . . . . .   4
   5.  States  . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
   6.  Notification  . . . . . . . . . . . . . . . . . . . . . . . .   5
   7.  BIER YANG Data Model  . . . . . . . . . . . . . . . . . . . .   5
   8.  Security Considerations . . . . . . . . . . . . . . . . . . .  11
   9.  Acknowledgements  . . . . . . . . . . . . . . . . . . . . . .  11
   10. IANA Considerations . . . . . . . . . . . . . . . . . . . . .  11
   11. Normative references  . . . . . . . . . . . . . . . . . . . .  11
   Authors' Addresses  . . . . . . . . . . . . . . . . . . . . . . .  12

1.  Introduction

   This document defines a YANG data model for BIER configuration and
   operation.

2.  Design of the Data Model



module: ietf-bier
augment /rt:routing/rt:routing-instance:
   +--rw bier
      +--rw transport-type?           identityref
      +--rw af
      |  +--rw ipv4
      |  |  +--rw bfr-prefix          inet:ipv4-prefix
      |  +--rw ipv6
      |     +--rw bfr-prefix          inet:ipv6-prefix
      |
      +--rw mt *[mt-id]
      |  +--rw mt-id                  uint16
      |  +--rw sub-domain *[sub-domain-id]
      |  |  +--rw sub-domain-id       uint16
      |  |  +--rw bfr-id              uint16
      |  |  +--rw label               uint32
      |  |  +--rw label-range-size    uint16
      |  |  +--rw bitstringlength     uint16
      |  |  +--rw frr                 boolean
      |  +--rw rpf-enable?            boolean
      +--rw interfaces
          +--rw interface* [name]
             +--rw name               if:interface-ref
             +--bfd                   boolean



Chen, et al.             Expires January 7, 2016                [Page 2]


Internet-Draft                  BIER YANG                      July 2015


augment /rt:routing/rt:routing-instance/rt:routing-protocols/rt:routing-protocol/isis:isis/isis:instance:
   +--rw bier
      +--rw enabled?         boolean
      +--rw mt
         +--rw advertise?    boolean
         +--rw receive?      boolean

augment /rt:routing/rt:routing-instance/rt:routing-protocols/rt:routing-protocol/ospf:ospf/ospf:instance:
   +--rw bier
      +--rw enabled?        boolean
      +--rw mt
         +--rw advertise?   boolean
         +--rw receive?     boolean



 augment /rt:routing-state/rt:routing-instance:
   +--ro bier
      +--ro bfr-prefix                inet:ip-prefix
      +--ro bier-infomation
      |  +--ro mt-id                   uint16
      |  +--ro sub-domain *[sub-domain-id]
      |  |  +--ro sub-domain-id        uint16
      |  |  +--ro bfr-id               uint16
      |  |  +--ro label uint32
      |  |  +--ro label-range-size     uint16
      |  |  +--ro bitstringlength      uint16
      |  |  +--ro bitstring            uint32
      |  +--ro bier-mapping-infomation
      |     +--ro label?               uint32
      |     +--ro label-range-size     uint16
      |
      +--ro birts
      |  +--ro birt *[name]
      |     +--ro name
      |     +--ro address-family
      |        +--ro ipv4
      |        |  +--ro bfr-id       uint16
      |        |  +--ro bfr-prefix   uint16
      |        |  +--ro bfr-nbr      uint16
      |        +--ro ipv6
      |           +--ro bfr-id       uint16
      |           +--ro bfr-prefix   uint16
      |           +--ro bfr-nbr      uint16
      +--ro bifts
         +--ro bift *[name]
            +--ro name
            +--ro address-family



Chen, et al.             Expires January 7, 2016                [Page 3]


Internet-Draft                  BIER YANG                      July 2015


               +--ro ipv4
               |  +--ro bfr-id     uint16
               |  +--ro f-bm       uint16
               |  +--ro bfr-nbr    uint16
               +--ro ipv6
                  +--ro bfr-id     uint16
                  +--ro f-bm       uint16
                  +--ro bfr-nbr    uint16

notifications:
   +---n bfr-id-collision?
   |   +--ro bfr-id?             uint16
   +---n bfr-zero?
   |   +--ro bfr-id?             uint16
   +---n sub-domain-id-collision
       +--ro sub-domain-id?      uint16
          +--ro mt-id?           uint16


3.  Configuration

   This Module augments the "/rt:routing/rt:routing-instance:" with a
   BIER container.  This Container defines all the configuration
   parameters related to BIER for this particular routing-instance.

   The BIER configuration contains global routing-instance configuration
   and interface configuration.

   The global routing-instance configuration includes BIER transport
   type, AF, MT.

   The interface configuration includes name and bfd.

4.  Control plane configuration

   This Module augments routing-protocol configuration with BIER.

   This Module supports ISIS ([I-D.ietf-bier-isis-extensions])and OSPF
   ([I-D.ietf-bier-ospf-bier-extensions]) as control plane for BIER.

5.  States

   It proposes mt-id, subdomain and other information, such as bier-
   mapping-information.







Chen, et al.             Expires January 7, 2016                [Page 4]


Internet-Draft                  BIER YANG                      July 2015


6.  Notification

   This Module includes bfr-id-collision, bfr-zero, sub-domain-id-
   collision.

7.  BIER YANG Data Model


 module ietf-bier {

     namespace "urn:ietf:params:xml:ns:yang:ietf-bier";

     prefix "bier";

     import ietf-routing {
       prefix "rt";
     }

     import ietf-inet-types {
       prefix "inet";
     }

     import ietf-interfaces {
       prefix "if";
     }

     import ietf-ip {
       prefix "ip";
     }

     import ietf-isis{
       prefix "isis";
     }

     import ietf-ospf  {
       prefix "ospf";
     }
     organization
       "IETF BIER(Bit Indexed Explicit Replication ) Working Group";

     contact
        WG List:  <mailto:bier@ietf.org>

        WG Chair: Tony Przygienda
                  <mailto:tonysietf@gmail.com>

        WG Chair: Greg Shepherd
                  <mailto:gjshep@gmail.com>



Chen, et al.             Expires January 7, 2016                [Page 5]


Internet-Draft                  BIER YANG                      July 2015


        Editor:   Ran Chen
                   <mailto:chen.ran@zte.com.cn>
        Editor:   Fangwei Hu
                   <mailto:hu.fangwei@zte.com.cn>
            Editor:   Zheng Zhang
                   <mailto:zhang.zheng@zte.com.cn>
        Editor:   Xianxian Dai
                   <mailto:dai.xianxian@zte.com.cn>

     description
       " The YANG module defines a generic configuration model for BIER.";


     revision 2015-06-22 {
       description
         "Initial revision.";
       reference
         "reference "draft-chen-bier-bier-yang-00";
     }

     /* Identities */

     identity transport-type {
       description
         "Base identity for BIER transport.";
     }
     identity Bier-transport-mpls {
       base Bier-transport;
       description
         "This identity represents MPLS transport for bier";
     }

     /* Configuration Data */
     augment "/rt:routing/rt:routing-instance" {
       description
         "This augments routing-instance configuration with bier.";
       container bier {
         leaf transport-type {
           type identityref {
             base bier-transport;
                }
           default "bier-transport-mpls";
           description "Dataplane to be used.";
                                      }

         container af {
           container ipv4 {
             list mapping-entry {



Chen, et al.             Expires January 7, 2016                [Page 6]


Internet-Draft                  BIER YANG                      July 2015


               key "bfr-prefix";
               leaf bfr-prefix {
                    type  inet:ipv4-prefix;
                    }
               leaf label {
                    type uint32;
                    }
               leaf label-range-size {
                    type uint16;
                    }
                }
            }
           container ipv6 {
             list mapping-entry {
               key "bfr-prefix";
               leaf bfr-prefix {
                    type  inet:ipv6-prefix;
                    }
               leaf label {
                    type uint32;
                    }
               leaf label-range-size {
                    type uint16;
                    }
                }
            }
          }

         list mt {
           key "mt-id";
           leaf mt-id{
             type uint16;
            }
           list sub-domain {
             key "sub-domain-id"
           leaf sub-domain-id {
               type unit16;
                    }
                }
           leaf bfr-id {
               type unit16;
                    }
           leaf label {
             type uint32;
                }
           leaf label-range-size {
             type uint16;
                }



Chen, et al.             Expires January 7, 2016                [Page 7]


Internet-Draft                  BIER YANG                      July 2015


           leaf bitstringlength {
             type uint16;
                }
           leaf frr {
               type boolean;
                }
         leaf rpf-enable{
                    type boolean;
                }

         container interfaces {
            list interface{
              key "name";
              leaf name {
                type if:interface-ref
                        }
              leaf bfd {
                type boolean;
                        }
                    }
                }

            }
          }
                }
  augment "/rt:routing/rt:routing-instance/rt:routing-protocols/rt:routing-protocol/isis:isis/isis:instance" {
    description
          "This augments ISIS protocol configuration with bier";
    container bier {
      leaf enable {
        type boolean;
        default false;
        description
          "Enables bier protocol extensions.";
         }
      container mt{
         leaf advertise {
            type boolean;
                        default true;
                }
         leaf receive {
            type boolean;
                        default true;
                }
            }
                }
            }
 augment "/rt:routing/rt:routing-instance/rt:routing-protocols/rt:routing-protocol/ospf:ospf/ospf:instance" {



Chen, et al.             Expires January 7, 2016                [Page 8]


Internet-Draft                  BIER YANG                      July 2015


    description
      "This augments ISIS protocol configuration with bier";
    container bier {
      leaf enable {
        type boolean;
        default false;
        description
          "Enables bier protocol extensions.";
         }
      container mt{
         leaf advertise {
            type boolean;
                        default true;
                }
         leaf receive {
            type boolean;
                        default true;
                }
            }
                }
            }

  /* Operational  data */
    augment "/rt:routing-state/rt:routing-instance" {
        description
          "This augments the operational states with bier.";

        container bier {
          leaf bfr-prefix {
            type  inet:ipv4-prefix;
            }
          container bier-infomation{
            leaf mt-id{
              type uint16;
                }
            list sub-domain{
              key "sub-domain-id"
              leaf sub-domain-id{
                type uint16;
                        }
            leaf bfr-id{
                  type uint16;
                        }
            leaf label {
              type uint32;
                        }
            leaf label-range-size {
              type uint16;



Chen, et al.             Expires January 7, 2016                [Page 9]


Internet-Draft                  BIER YANG                      July 2015


                                        }
            leaf bitstringlength{
               type uint16;
                        }
            leaf bitstring{
                          type uint32;
                        }
                }
            container bier-mapping-infomation{
              leaf label {
                type uint32;
                        }
              leaf label-range-size {
                type uint16;
                        }
                }
            }
        }

        container birts{
          list birt{
                        key "name"
                        leaf name{
              type string;
                }
            container address-family{
              container ipv4{
                leaf bfr-id{
                  type uint16;
                                }
                leaf f-bm{
                  type uint16;
                                }
                leaf bfr-nbr{
                  type uint16;
                                }
                        }
              container ipv6{
                leaf bfr-id{
                  type uint16;
                                }
                leaf f-bm{
                  type uint16;
                                }
                leaf bfr-nbr{
                  type uint16;
                                }
                        }



Chen, et al.             Expires January 7, 2016               [Page 10]


Internet-Draft                  BIER YANG                      July 2015


                }
                }
        }
    }
    /* Notifications */
    notification bfr-id-collision{
      leaf bfr-id{
        type uint16;
        }
    }

    notification bfr-zero{
      leaf bfr-id{
        type uint16;
        }
    }

    notification sub-domain-id-collision{
      leaf sub-domain-id{
        type uint16;
        }

      leaf mt-id{
        type uint16;
        }
    }
}


8.  Security Considerations

   TBD.

9.  Acknowledgements

   TBD.

10.  IANA Considerations

   This document requires no IANA Actions.  Please remove this section
   before RFC publication.

11.  Normative references








Chen, et al.             Expires January 7, 2016               [Page 11]


Internet-Draft                  BIER YANG                      July 2015


   [I-D.ietf-bier-architecture]
              Wijnands, I., Rosen, E., Dolganow, A., Przygienda, T., and
              S. Aldrin, "Multicast using Bit Index Explicit
              Replication", draft-ietf-bier-architecture-01 (work in
              progress), June 2015.

   [I-D.ietf-bier-isis-extensions]
              Ginsberg, L., Aldrin, S., Zhang, J., and T. Przygienda,
              "BIER support via ISIS", draft-ietf-bier-isis-
              extensions-00 (work in progress), April 2015.

   [I-D.ietf-bier-mpls-encapsulation]
              Wijnands, I., Rosen, E., Dolganow, A., Tantsura, J., and
              S. Aldrin, "Encapsulation for Bit Index Explicit
              Replication in MPLS Networks", draft-ietf-bier-mpls-
              encapsulation-01 (work in progress), June 2015.

   [I-D.ietf-bier-ospf-bier-extensions]
              Psenak, P., Kumar, N., Wijnands, I., Dolganow, A.,
              Przygienda, T., Zhang, J., and S. Aldrin, "OSPF Extensions
              For BIER", draft-ietf-bier-ospf-bier-extensions-00 (work
              in progress), April 2015.

   [RFC6020]  Bjorklund, M., "YANG - A Data Modeling Language for the
              Network Configuration Protocol (NETCONF)", RFC 6020,
              October 2010.

   [RFC6241]  Enns, R., Bjorklund, M., Schoenwaelder, J., and A.
              Bierman, "Network Configuration Protocol (NETCONF)", RFC
              6241, June 2011.

   [RFC6991]  Schoenwaelder, J., "Common YANG Data Types", RFC 6991,
              July 2013.

   [RFC7223]  Bjorklund, M., "A YANG Data Model for Interface
              Management", RFC 7223, May 2014.

Authors' Addresses

   Ran Chen
   ZTE Corporation
   No.50 Software Avenue,Yuhuatai District
   Nanjing, Jiangsu Province  210012
   China

   Phone: +86 025 88014636
   Email: chen.ran@zte.com.cn




Chen, et al.             Expires January 7, 2016               [Page 12]


Internet-Draft                  BIER YANG                      July 2015


   Fangwei Hu
   ZTE Corporation
   No.889 Bibo Rd
   Shanghai  201203
   China

   Phone: +86 21 68896273
   Email: hu.fangwei@zte.com.cn


   Zheng Zhang
   ZTE Corporation
   No.50 Software Avenue,Yuhuatai District
   Nanjing, Jiangsu Province  210012
   China

   Email: zhang.zheng@zte.com.cn


   Xianxian Dai
   ZTE Corporation
   No.50 Software Avenue,Yuhuatai District
   Nanjing, Jiangsu Province  210012
   China

   Email: Dai.xianxian@zte.com.cn

























Chen, et al.             Expires January 7, 2016               [Page 13]


Html markup produced by rfcmarkup 1.129b, available from https://tools.ietf.org/tools/rfcmarkup/