Network Modeling (netmod) Internet Drafts


      
 A YANG Data Model for Syslog Configuration
 
 draft-ietf-netmod-syslog-model-32.txt
 Date: 20/03/2024
 Authors: Joe Clarke, Mahesh Jethanandani, Clyde Wildes, Kiran Koushik
 Working Group: Network Modeling (netmod)
This document defines a YANG data model for the configuration of a syslog process. It is intended this model be used by vendors who implement syslog in their systems.
 Common Interface Extension YANG Data Models
 
 draft-ietf-netmod-intf-ext-yang-13.txt
 Date: 30/01/2024
 Authors: Robert Wilton, Scott Mansfield
 Working Group: Network Modeling (netmod)
This document defines two YANG modules that augment the Interfaces data model defined in the "YANG Data Model for Interface Management" with additional configuration and operational data nodes to support common lower layer interface properties, such as interface MTU. The YANG modules in this document conform to the Network Management Datastore Architecture (NMDA) defined in RFC 8342.
 Sub-interface VLAN YANG Data Models
 
 draft-ietf-netmod-sub-intf-vlan-model-10.txt
 Date: 30/01/2024
 Authors: Robert Wilton, Scott Mansfield
 Working Group: Network Modeling (netmod)
This document defines YANG modules to add support for classifying traffic received on interfaces as Ethernet/VLAN framed packets to sub-interfaces based on the fields available in the Ethernet/VLAN frame headers. These modules allow configuration of Layer 3 and Layer 2 sub-interfaces (e.g. L2VPN attachment circuits) that can interoperate with IETF based forwarding protocols; such as IP and L3VPN services; or L2VPN services like VPWS, VPLS, and EVPN. The sub-interfaces also interoperate with VLAN tagged traffic orignating from an IEEE 802.1Q compliant bridge. The model differs from an IEEE 802.1Q bridge model in that the configuration is interface/sub-interface based as opposed to being based on membership of an 802.1Q VLAN bridge. The YANG data models in this document conforms to the Network Management Datastore Architecture (NMDA) defined in RFC 8342.
 YANG Module Versioning Requirements
 
 draft-ietf-netmod-yang-versioning-reqs-09.txt
 Date: 14/01/2024
 Authors: Joe Clarke
 Working Group: Network Modeling (netmod)
This document describes the problems that can arise because of the YANG language module update rules, that require all updates to YANG module preserve strict backwards compatibility. It also defines the requirements on any solution designed to solve the stated problems. This document does not consider possible solutions, nor endorse any particular solution.
 Common YANG Data Types
 
 draft-ietf-netmod-rfc6991-bis-15.txt
 Date: 23/01/2023
 Authors: Juergen Schoenwaelder
 Working Group: Network Modeling (netmod)
This document defines a collection of common data types to be used with the YANG data modeling language. This version of the document adds several new type definitions and obsoletes RFC 6991.
 Updated YANG Module Revision Handling
 
 draft-ietf-netmod-yang-module-versioning-11.txt
 Date: 01/03/2024
 Authors: Robert Wilton, Reshad Rahman, Balazs Lengyel, Joe Clarke, Jason Sterne
 Working Group: Network Modeling (netmod)
This document refines the RFC 7950 module update rules. It specifies a new YANG module update procedure that can document when non- backwards-compatible changes have occurred during the evolution of a YANG module. It extends the YANG import statement with a minimum revision suggestion to help document inter-module dependencies. It provides guidelines for managing the lifecycle of YANG modules and individual schema nodes. This document updates RFC 7950, RFC 6020, RFC 8407 and RFC 8525.
 YANG Semantic Versioning
 
 draft-ietf-netmod-yang-semver-15.txt
 Date: 18/03/2024
 Authors: Joe Clarke, Robert Wilton, Reshad Rahman, Balazs Lengyel, Jason Sterne, Benoit Claise
 Working Group: Network Modeling (netmod)
This document specifies a YANG extension along with guidelines for applying an extended set of semantic versioning rules to revisions of YANG artifacts (e.g., modules and packages). Additionally, this document defines a YANG extension for controlling module imports based on these modified semantic versioning rules. This document updates RFCs 7950, 8407, and 8525.
 Node Tags in YANG Modules
 
 draft-ietf-netmod-node-tags-11.txt
 Date: 21/10/2023
 Authors: Qin WU, Benoit Claise, Mohamed Boucadair, Peng Liu, Zongpeng Du
 Working Group: Network Modeling (netmod)
This document defines a method to tag nodes that are associated with the operation and management data in YANG modules. This method for tagging YANG nodes is meant to be used for classifying either data nodes or instances of data nodes from different YANG modules and identifying their characteristic data. Tags may be registered as well as assigned during the definition of the module, assigned by implementations, or dynamically defined and set by users. This document also provides guidance to future YANG data model writers; as such, this document updates RFC 8407.
 System-defined Configuration
 
 draft-ietf-netmod-system-config-05.txt
 Date: 21/02/2024
 Authors: Qiufang Ma, Qin WU, Chong Feng
 Working Group: Network Modeling (netmod)
This document defines how a management client and server handle YANG- modeled configuration data that is defined by the server itself. The system-defined configuration can be referenced (e.g. leafref) by configuration explicitly created by a client. The Network Management Datastore Architecture (NMDA) defined in RFC 8342 is updated with a read-only conventional configuration datastore called "system" to hold system-defined configuration. As an alternative to clients explicitly copying referenced system- defined configuration into the target configuration datastore (e.g., ) so that the datastore is valid, a "resolve-system" parameter is defined to allow the server acting as a "system client" to copy referenced system nodes automatically. This solution enables clients manipulating the target configuration datastore (e.g., ) to reference nodes defined in , override system- provided values, and configure descendant nodes of system-defined configuration. This document updates RFC 8342, RFC 6241, RFC 8526 and RFC 8040.
 Extensions to the Access Control Lists (ACLs) YANG Model
 
 draft-ietf-netmod-acl-extensions-06.txt
 Date: 30/01/2024
 Authors: Oscar de Dios, Samier Barguil, Mohamed Boucadair, Qin WU
 Working Group: Network Modeling (netmod)
RFC 8519 defines a YANG data model for Access Control Lists (ACLs). This document discusses a set of extensions that fix many of the limitations of the ACL model as initially defined in RFC 8519. The document also defines IANA-maintained modules for ICMP types and IPv6 extension headers.
 Guidelines for Authors and Reviewers of Documents Containing YANG Data Models
 
 draft-ietf-netmod-rfc8407bis-09.txt
 Date: 28/02/2024
 Authors: Andy Bierman, Mohamed Boucadair, Qin WU
 Working Group: Network Modeling (netmod)
This memo provides guidelines for authors and reviewers of specifications containing YANG modules, including IANA-maintained modules. Recommendations and procedures are defined, which are intended to increase interoperability and usability of Network Configuration Protocol (NETCONF) and RESTCONF protocol implementations that utilize YANG modules. This document obsoletes RFC 8407. Also, this document updates RFC 8126 by providing additional guidelines for writing the IANA considerations for RFCs that specify IANA-maintained modules.
 YANG Metadata Annotation for Immutable Flag
 
 draft-ietf-netmod-immutable-flag-00.txt
 Date: 18/03/2024
 Authors: Qiufang Ma, Qin WU, Balazs Lengyel, Hongwei Li
 Working Group: Network Modeling (netmod)
This document defines a way to formally document existing behavior, implemented by servers in production, on the immutability of some system configuration nodes, using a YANG metadata annotation called "immutable" to flag which nodes are immutable. Clients may use "immutable" annotations provided by the server, to know beforehand why certain otherwise valid configuration requests will cause the server to return an error. The immutable flag is descriptive, documenting existing behavior, not proscriptive, dictating server behavior.


data-group-menu-data-url="/group/groupmenu.json"> Skip to main content

Network Modeling (netmod)

WG Name Network Modeling
Acronym netmod
Area Operations and Management Area (ops)
State Active
Charter charter-ietf-netmod-09 Approved
Document dependencies
Additional resources Issue tracker, Wiki, Zulip Stream
Personnel Chairs Kent Watsen, Lou Berger
Area Director Mahesh Jethanandani
Delegates Jason Sterne, Robert Wilton
Secretary Jason Sterne
Mailing list Address netmod@ietf.org
To subscribe https://www.ietf.org/mailman/listinfo/netmod
Archive https://mailarchive.ietf.org/arch/browse/netmod/
Chat Room address https://zulip.ietf.org/#narrow/stream/netmod

Charter for Working Group

The Network Modeling (NETMOD) working group is responsible for the YANG
data modeling language, which can be used to specify network management
data models that are transported over such protocols as NETCONF and
RESTCONF, and guidelines for developing YANG models. The NETMOD working
group addresses general topics related to the use of the YANG language
and YANG models, for example, the mapping of YANG modeled data into
various encodings. Finally, the NETMOD working group also defines core
YANG models used as basic YANG building blocks, and YANG models that do
not otherwise fall under the charter of any other IETF working group.
The NETMOD WG may include work on YANG modules device profiles that do
not otherwise fall under the charter of any other IETF working group.

The NETMOD WG is responsible for:

a) Maintaining the data modeling language YANG. This effort entails
periodically updating the specification to address new
requirements as they arise.

b) Maintaining the guidelines for developing YANG models. This effort
is primarily driven by updates made to the YANG specification.

c) Maintaining a conceptual framework in which YANG models are used.
This effort entails describing the generic context that in YANG
exists and how certain YANG statements interact in that context.
An example of this is YANG's relationship with datastores.

d) Maintaining encodings for YANG modeled data. This effort entails
updating encodings already defined by the NETMOD working group
(XML and JSON) to accommodate changes to the YANG specification,
and defining new YANG encodings that are needed, and yet do not
fall under the charter of any other active IETF working group.

e) Maintaining YANG models used as basic YANG building blocks. This
effort entails updating existing YANG models (ietf-yang-types and
ietf-inet-types) as needed, as well as defining additional core
YANG data models when necessary.

f) Defining and maintaining YANG models that do not fall under the
charter of any other active IETF working group.

The NETMOD working group consults with the NETCONF working group to
ensure that new requirements are understood and can be met by the
protocols (e.g., NETCONF and RESTCONF) developed within that working
group.

The NETMOD working group does not serve as a review team for YANG
modules developed by other working groups. Instead, the YANG doctors,
[1] as organized by the OPS area director responsible for network
management, will act as advisors for other working groups and provide
YANG reviews for the OPS area directors.

[1] http://www.ietf.org/iesg/directorate/yang-doctors.html

Milestones

Date Milestone Associated documents
Jan 2018 Submit draft-ietf-netmod-entity to IESG for publication (as Standards Track)
Jan 2018 Submit draft-ietf-netmod-acl-model to IESG for publication (as Standards Track)
Dec 2017 Submit draft-ietf-netmod-sub-intf-vlan-yang to IESG for publication (as Informational)
Dec 2017 Submit draft-ietf-netmod-intf-ext-yang to IESG for publication (as Standards Track)
Dec 2017 Submit draft-ietf-netmod-schema-mount to IESG for publication (as Standards Track)
Nov 2017 Submit draft-ietf-netmod-revised-datastores to IESG for publication (as Standards Track)
Jul 2017 Submit draft-ietf-netmod-rfc6087bis to IESG for publication (as Informational)
May 2017 Submit draft-ietf-netmod-syslog-model to IESG for publication (as Standards Track)
May 2017 Submit draft-ietf-netmod-yang-model-classification to IESG for publication (as Informational)