A YANG Data Model for Retrieval Methods for the Management of Operations, Administration, and Maintenance (OAM) Protocols That Use Connectionless Communications
RFC 8533

Document Type RFC - Proposed Standard (April 2019; No errata)
Last updated 2019-04-16
Stream IETF
Formats plain text pdf html bibtex
Yang Validation 0 errors, 0 warnings.
Reviews
Additional URLs
- Yang catalog entry for ietf-connectionless-oam-methods@2017-09-06.yang
- Yang impact analysis for draft-ietf-lime-yang-connectionless-oam-methods
- Mailing list discussion
Stream WG state Submitted to IESG for Publication
Document shepherd Carlos Pignataro
Shepherd write-up Show (last changed 2017-10-04)
IESG IESG state RFC 8533 (Proposed Standard)
Consensus Boilerplate Yes
Telechat date
Responsible AD Ignas Bagdonas
Send notices to Carlos Pignataro <cpignata@cisco.com>, Ron Bonica <rbonica@juniper.net>
IANA IANA review state Version Changed - Review Needed
IANA action state RFC-Ed-Ack
Internet Engineering Task Force (IETF)                          D. Kumar
Request for Comments: 8533                                         Cisco
Category: Standards Track                                        M. Wang
ISSN: 2070-1721                                               Q. Wu, Ed.
                                                                  Huawei
                                                               R. Rahman
                                                             S. Raghavan
                                                                   Cisco
                                                              April 2019

     A YANG Data Model for Retrieval Methods for the Management of
      Operations, Administration, and Maintenance (OAM) Protocols
                 That Use Connectionless Communications

Abstract

   This document presents a retrieval method YANG data model for
   connectionless Operations, Administration, and Maintenance (OAM)
   protocols.  It provides technology-independent RPC operations for OAM
   protocols that use connectionless communication.  The retrieval
   methods model herein presented can be extended to include technology-
   specific details.  There are two key benefits of this approach:
   First, it leads to uniformity between OAM protocols.  Second, it
   supports both nested OAM workflows (i.e., performing OAM functions at
   different or the same levels through a unified interface) as well as
   interactive OAM workflows (i.e., performing OAM functions at the same
   levels through a unified interface).

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
   https://www.rfc-editor.org/info/rfc8533.

Kumar, et al.                Standards Track                    [Page 1]
RFC 8533         YANG Model for CL OAM Retrieval Methods      April 2019

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  . . . . . . . . . . . . . . . . . . . . . . . .   3
   2.  Conventions Used in This document . . . . . . . . . . . . . .   3
     2.1.  Terminology . . . . . . . . . . . . . . . . . . . . . . .   4
     2.2.  Tree Diagrams . . . . . . . . . . . . . . . . . . . . . .   4
   3.  Overview of the Connectionless OAM Retrieval Methods Model  .   4
     3.1.  RPC Operation Definitions . . . . . . . . . . . . . . . .   4
     3.2.  OAM Retrieval Methods Hierarchy . . . . . . . . . . . . .   7
   4.  OAM Retrieval Methods YANG Module . . . . . . . . . . . . . .  16
   5.  Security Considerations . . . . . . . . . . . . . . . . . . .  26
   6.  IANA Considerations . . . . . . . . . . . . . . . . . . . . .  26
   7.  References  . . . . . . . . . . . . . . . . . . . . . . . . .  27
     7.1.  Normative References  . . . . . . . . . . . . . . . . . .  27
     7.2.  Informative References  . . . . . . . . . . . . . . . . .  28
   Appendix A.  Extending Connectionless OAM Method Module Example .  29
     A.1.  Example of New Retrieval Procedures Model . . . . . . . .  29
   Acknowledgements  . . . . . . . . . . . . . . . . . . . . . . . .  40
   Authors' Addresses  . . . . . . . . . . . . . . . . . . . . . . .  41

Kumar, et al.                Standards Track                    [Page 2]
RFC 8533         YANG Model for CL OAM Retrieval Methods      April 2019

1.  Introduction

   Operations, Administration, and Maintenance (OAM) are important
   networking functions that allow operators to:

   1.  monitor network communications (i.e., reachability verification
       and Continuity Check)

   2.  troubleshoot failures (i.e., fault verification and localization)

   3.  monitor service-level agreements and performance (i.e.,
       performance management)

   An overview of OAM tools is presented in [RFC7276].

   Ping and Traceroute [RFC4443], as well as Bidirectional Forwarding
Show full document text