YANG Modules for IPv4-in-IPv6 Address plus Port (A+P) Softwires
RFC 8676

Document Type RFC - Proposed Standard (November 2019; No errata)
Authors Ian Farrer  , Mohamed Boucadair 
Last updated 2019-11-26
Replaces draft-sun-softwire-yang
Stream IETF
Formats plain text html xml pdf htmlized bibtex
Yang Validation 0 errors, 0 warnings.
Additional Resources
- Yang catalog entry for ietf-softwire-br@2019-01-11.yang
- Yang catalog entry for ietf-softwire-ce@2019-01-11.yang
- Yang catalog entry for ietf-softwire-common@2019-01-11.yang
- Yang impact analysis for draft-ietf-softwire-yang
- Mailing list discussion
Stream WG state Submitted to IESG for Publication
Document shepherd Sheng Jiang
Shepherd write-up Show (last changed 2018-08-21)
IESG IESG state RFC 8676 (Proposed Standard)
Consensus Boilerplate Yes
Telechat date
Responsible AD Éric Vyncke
Send notices to Sheng Jiang <jiangsheng@huawei.com>
IANA IANA review state Version Changed - Review Needed
IANA action state RFC-Ed-Ack

Internet Engineering Task Force (IETF)                    I. Farrer, Ed.
Request for Comments: 8676                           Deutsche Telekom AG
Category: Standards Track                              M. Boucadair, Ed.
ISSN: 2070-1721                                                   Orange
                                                           November 2019

    YANG Modules for IPv4-in-IPv6 Address plus Port (A+P) Softwires


   This document defines YANG modules for the configuration and
   operation of IPv4-in-IPv6 softwire Border Relays and Customer
   Premises Equipment for the Lightweight 4over6, Mapping of Address and
   Port with Encapsulation (MAP-E), and Mapping of Address and Port
   using Translation (MAP-T) softwire mechanisms.

Status of This Memo

   This is an Internet Standards Track document.

   This document is a product of the Internet Engineering Task Force
   (IETF).  It represents the consensus of the IETF community.  It has
   received public review and has been approved for publication by the
   Internet Engineering Steering Group (IESG).  Further information on
   Internet Standards is available in Section 2 of RFC 7841.

   Information about the current status of this document, any errata,
   and how to provide feedback on it may be obtained at

Copyright Notice

   Copyright (c) 2019 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   This document is subject to BCP 78 and the IETF Trust's Legal
   Provisions Relating to IETF Documents
   (https://trustee.ietf.org/license-info) in effect on the date of
   publication of this document.  Please review these documents
   carefully, as they describe your rights and restrictions with respect
   to this document.  Code Components extracted from this document must
   include Simplified BSD License text as described in Section 4.e of
   the Trust Legal Provisions and are provided without warranty as
   described in the Simplified BSD License.

Table of Contents

   1.  Introduction
   2.  Terminology
   3.  Overview of the Modules
     3.1.  Overall Structure
     3.2.  Configuration for Additional Components
   4.  Softwire CE YANG Tree Diagram
     4.1.  CE Tree Diagram
     4.2.  Softwire CE Tree Diagram Description
   5.  Softwire BR YANG Tree Diagram
     5.1.  BR Tree Diagram
     5.2.  Softwire BR Tree Diagram Description
   6.  Softwire CE YANG Module
   7.  BR Softwire YANG Module
   8.  Common Softwire Element Groups YANG Module
   9.  Security Considerations
   10. IANA Considerations
   11. References
     11.1.  Normative References
     11.2.  Informative References
   Appendix A.  Configuration Examples
     A.1.  Configuration Example for a lw4o6 BR Binding-Table
     A.2.  Configuration Example for a MAP-E BR
     A.3.  lw4o6 CE Configuration Example
   Authors' Addresses

1.  Introduction

   The IETF Softwire Working Group has developed several IPv4-in-IPv6
   softwire mechanisms to address various deployment contexts and
   constraints.  As a companion to the architectural specification
   documents, this document focuses on the provisioning of Address plus
   Port (A+P) softwire functional elements: Border Routers (BRs) and
   Customer Edge (CE) (called "Customer Premises Equipment (CPE)" in
   [RFC7596]).  The softwire mechanisms covered in this document are
   Lightweight 4over6 (lw4o6) [RFC7596], Mapping of Address and Port
   with Encapsulation (MAP-E) [RFC7597], and Mapping of Address and Port
   using Translation (MAP-T) [RFC7599].

   This document focuses on A+P mechanisms [RFC6346]; the reader can
   refer to [RFC8513] for a YANG module for Dual-Stack Lite (DS-Lite)

   This document defines YANG modules [RFC7950] that can be used to
   configure and manage A+P softwire elements using the NETCONF
   [RFC6241] or RESTCONF [RFC8040] protocols for:

   *  Configuration

   *  Operational State

   *  Notifications

2.  Terminology

   The reader should be familiar with the concepts and terms defined in
   [RFC7596], [RFC7597], [RFC7599], and the YANG data modeling language
   defined in [RFC7950].

   The YANG modules in this document adopt the Network Management
   Datastore Architecture (NMDA) [RFC8342].  The meanings of the symbols
   used in tree diagrams are defined in [RFC8340].

   The document uses the abbreviation 'BR' as a general term for
   softwire tunnel concentrators, including both MAP Border Routers
   [RFC7597] and Lightweight 4over6 lwAFTRs [RFC7596].

   For brevity, "algorithm" is used to refer to the "mapping algorithm"
   defined in [RFC7597].

   A network element may support one or multiple instances of a softwire
   mechanism; each of these instances (i.e., binding instances, MAP-E
   instances, or MAP-T instances) may have its own configuration and
   parameters.  The term 'algo-instance' is used to denote both MAP-E
   and MAP-T instances.
Show full document text