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)
|
|
Authors |
|
Deepak Kumar
,
Zitao Wang
,
Qin Wu
,
Reshad Rahman
,
Srihari Raghavan
|
|
Last updated |
|
2019-04-16
|
|
Stream |
|
IETF
|
|
Formats |
|
plain text
html
pdf
htmlized
bibtex
|
|
Yang Validation |
|
☯
0 errors, 0 warnings.
draft-ietf-lime-yang-connectionless-oam-methods-13.txt:
xym 0.4:
Extracting 'ietf-connectionless-oam-methods@2017-09-06.yang'
Removed 0 empty lines
Extracting 'example-cl-oam-persistent-methods'
Getting YANG file name from module name: example-cl-oam-persistent-methods.yang
ietf-connectionless-oam-methods@2017-09-06.yang:
pyang 1.7.8: pyang --verbose --ietf -p {libs} {model}:
# read ietf-connectionless-oam-methods@2017-09-06.yang (CL)
# read /a/www/ietf-datatracker/6.95.0/env/share/yang/modules/ietf/ietf-interfaces.yang
# read /a/www/ietf-ftp/yang/rfcmod/ietf-interfaces@2018-02-20.yang
# read /a/www/ietf-datatracker/6.95.0/env/share/yang/modules/ietf/ietf-yang-types.yang
# read /a/www/ietf-ftp/yang/draftmod/ietf-yang-types@2019-03-11.yang
# read /a/www/ietf-ftp/yang/draftmod/ietf-connectionless-oam@2017-09-06.yang
# read /a/www/ietf-ftp/yang/rfcmod/ietf-yang-schema-mount@2019-01-14.yang
# read /a/www/ietf-datatracker/6.95.0/env/share/yang/modules/ietf/ietf-inet-types.yang
# read /a/www/ietf-ftp/yang/draftmod/ietf-inet-types@2019-03-11.yang
# read /a/www/ietf-datatracker/6.95.0/env/share/yang/modules/ietf/ietf-network.yang
# read /a/www/ietf-ftp/yang/rfcmod/ietf-network@2018-02-26.yang
# read /a/www/ietf-ftp/yang/rfcmod/ietf-network-instance@2019-01-21.yang
# read /a/www/ietf-datatracker/6.95.0/env/share/yang/modules/ietf/ietf-ip.yang
# read /a/www/ietf-ftp/yang/rfcmod/ietf-ip@2018-02-22.yang
# read /a/www/ietf-datatracker/6.95.0/env/share/yang/modules/ietf/ietf-routing-types.yang
# read /a/www/ietf-ftp/yang/rfcmod/ietf-routing-types@2017-12-04.yang
# read /a/www/ietf-ftp/yang/draftmod/ietf-lime-time-types@2017-09-06.yang
yanglint 0.14.80: yanglint --verbose -p {rfclib} -p {draftlib} -p {tmplib} {model} -i:
No validation errors
|
|
Reviews |
|
|
|
Additional Resources |
|
|
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