Internet DRAFT - draft-ietf-opsawg-model-automation-framework
draft-ietf-opsawg-model-automation-framework
OPSAWG Q. Wu, Ed.
Internet-Draft Huawei
Intended status: Informational M. Boucadair, Ed.
Expires: April 28, 2021 Orange
D. Lopez
Telefonica I+D
C. Xie
China Telecom
L. Geng
China Mobile
October 25, 2020
A Framework for Automating Service and Network Management with YANG
draft-ietf-opsawg-model-automation-framework-10
Abstract
Data models provide a programmatic approach to represent services and
networks. Concretely, they can be used to derive configuration
information for network and service components, and state information
that will be monitored and tracked. Data models can be used during
the service and network management life cycle, such as service
instantiation, provisioning, optimization, monitoring, diagnostic,
and assurance. Data models are also instrumental in the automation
of network management, and they can provide closed-loop control for
adaptive and deterministic service creation, delivery, and
maintenance.
This document describes a framework for service and network
management automation that takes advantage of YANG modeling
technologies. This framework is drawn from a network operator
perspective irrespective of the origin of a data model; it can thus
accommodate YANG modules that are developed outside the IETF.
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 https://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
Wu, et al. Expires April 28, 2021 [Page 1]
Internet-Draft Service and Network Management Automation October 2020
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 April 28, 2021.
Copyright Notice
Copyright (c) 2020 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. Terminology and Acronyms . . . . . . . . . . . . . . . . . . 5
2.1. Terminology . . . . . . . . . . . . . . . . . . . . . . . 5
2.2. Acronyms . . . . . . . . . . . . . . . . . . . . . . . . 7
3. Architectural Concepts and Goals . . . . . . . . . . . . . . 7
3.1. Data Models: Layering and Representation . . . . . . . . 7
3.2. Automation of Service Delivery Procedures . . . . . . . . 12
3.3. Service Fulfillment Automation . . . . . . . . . . . . . 13
3.4. YANG Modules Integration . . . . . . . . . . . . . . . . 13
4. Functional Blocks and Interactions . . . . . . . . . . . . . 14
4.1. Service Lifecycle Management Procedure . . . . . . . . . 15
4.1.1. Service Exposure . . . . . . . . . . . . . . . . . . 15
4.1.2. Service Creation/Modification . . . . . . . . . . . . 15
4.1.3. Service Assurance . . . . . . . . . . . . . . . . . . 16
4.1.4. Service Optimization . . . . . . . . . . . . . . . . 16
4.1.5. Service Diagnosis . . . . . . . . . . . . . . . . . . 16
4.1.6. Service Decommission . . . . . . . . . . . . . . . . 17
4.2. Service Fullfillment Management Procedure . . . . . . . . 17
4.2.1. Intended Configuration Provision . . . . . . . . . . 17
4.2.2. Configuration Validation . . . . . . . . . . . . . . 18
4.2.3. Performance Monitoring . . . . . . . . . . . . . . . 18
4.2.4. Fault Diagnostic . . . . . . . . . . . . . . . . . . 19
4.3. Multi-Layer/Multi-Domain Service Mapping . . . . . . . . 19
4.4. Service Decomposition . . . . . . . . . . . . . . . . . . 19
5. YANG Data Model Integration Examples . . . . . . . . . . . . 20
5.1. L2VPN/L3VPN Service Delivery . . . . . . . . . . . . . . 20
Wu, et al. Expires April 28, 2021 [Page 2]
Internet-Draft Service and Network Management Automation October 2020
5.2. VN Lifecycle Management . . . . . . . . . . . . . . . . . 22
5.3. Event-based Telemetry in the Device Self Management . . . 23
6. Security Considerations . . . . . . . . . . . . . . . . . . . 24
6.1. Service Level . . . . . . . . . . . . . . . . . . . . . . 25
6.2. Network Level . . . . . . . . . . . . . . . . . . . . . . 26
6.3. Device Level . . . . . . . . . . . . . . . . . . . . . . 26
7. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 26
8. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 26
9. Contributors . . . . . . . . . . . . . . . . . . . . . . . . 27
10. References . . . . . . . . . . . . . . . . . . . . . . . . . 27
10.1. Normative References . . . . . . . . . . . . . . . . . . 27
10.2. Informative References . . . . . . . . . . . . . . . . . 28
Appendix A. Layered YANG Modules Examples Overview . . . . . . . 37
A.1. Service Models: Definition and Samples . . . . . . . . . 37
A.2. Schema Mount . . . . . . . . . . . . . . . . . . . . . . 38
A.3. Network Models: Samples . . . . . . . . . . . . . . . . . 38
A.4. Device Models: Samples . . . . . . . . . . . . . . . . . 41
A.4.1. Model Composition . . . . . . . . . . . . . . . . . . 43
A.4.2. Device Management . . . . . . . . . . . . . . . . . . 43
A.4.3. Interface Management . . . . . . . . . . . . . . . . 43
A.4.4. Some Device Model Examples . . . . . . . . . . . . . 43
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 46
1. Introduction
Service management systems usually comprise service activation/
provision and service operation. Current service delivery
procedures, from the processing of customer requirements and orders
to service delivery and operation, typically assume the manipulation
of data sequentially into multiple Operations Support System (OSS) or
Business Support System (BSS) applications that may be managed by
different departments within the service provider's organization
(e.g., billing factory, design factory, network operation center).
Many of these applications have been developed in-house over the
years and operate in a silo mode:
o The lack of standard data input/output (i.e., data model) raises
many challenges in system integration and often results in manual
configuration tasks.
o Service fulfillment systems might have a limited visibility on the
network state and therefore have slow response to network changes.
Software Defined Networking (SDN) becomes crucial to address these
challenges. SDN techniques are meant to automate the overall service
delivery procedures and typically rely upon standard data models.
These models are used to not only reflect service providers' savoir-
faire, but also to dynamically instantiate and enforce a set of
Wu, et al. Expires April 28, 2021 [Page 3]
Internet-Draft Service and Network Management Automation October 2020
service-inferred policies that best accommodate what has been defined
and possibly negotiated with the customer. [RFC7149] provides a
first tentative attempt to rationalize that service provider's view
on the SDN space by identifying concrete technical domains that need
to be considered and for which solutions can be provided:
o Techniques for the dynamic discovery of topology, devices, and
capabilities, along with relevant information and data models that
are meant to precisely document such topology, devices, and their
capabilities.
o Techniques for exposing network services [RFC8309] and their
characteristics.
o Techniques used by service-derived dynamic resource allocation and
policy enforcement schemes, so that networks can be programmed
accordingly.
o Dynamic feedback mechanisms that are meant to assess how
efficiently a given policy (or a set thereof) is enforced from a
service fulfillment and assurance perspectives.
Models are key for each of the aforementioned four technical items.
Service and network management automation is an important step to
improve the agility of network operations. Models are also important
to ease integrating multi-vendor solutions.
YANG [RFC7950] module developers have taken both top-down and bottom-
up approaches to develop modules [RFC8199] and to establish a mapping
between a network technology and customer requirements at the top or
abstracting common constructs from various network technologies at
the bottom. At the time of writing this document (2020), there are
many YANG data models including configuration and service models that
have been specified or are being specified by the IETF. They cover
many of the networking protocols and techniques. However, how these
models work together to configure a function, manage a set of devices
involved in a service, or provide a service is something that is not
currently documented either within the IETF or other Standards
Development Organizations (SDOs).
Many of the YANG modules listed in this document are used to exchange
data between NETCONF/RESTCONF clients and servers [RFC6241][RFC8040].
Nevertheless, YANG is a transport-independent data modeling language.
It can thus be used independently of NETCONF/RESTONF. For example,
YANG can be used to define abstract data structures [RFC8791] that
can be manipulated by other protocols (e.g.,
[I-D.ietf-dots-rfc8782-bis]).
Wu, et al. Expires April 28, 2021 [Page 4]
Internet-Draft Service and Network Management Automation October 2020
This document describes an architectural framework for service and
network management automation (Section 3) that takes advantage of
YANG modeling technologies and investigates how YANG data models at
different layers interact with each other (e.g., service mapping,
model composition) in the context of service delivery and fulfillment
(Section 4). Concretely, the following benefits can be provided:
o Allow for vendor-agnostic interfaces to manage a service and the
underlying network.
o Move from deployment schemes where vendor-specific network
managers are required to a scheme where the entities that are
responsible for orchestrating and controlling services and network
resources provided by multi-vendor devices are unified.
o Ease data inheritance and reusability among the various
architecture layers thus promoting a network-wise provisioning
instead of device-specific configuration.
o Dynamically feed a decision-making process (e.g., Controllers,
Orchestrators) with notifications that will trigger appropriate
actions, allowing that decision-making process to continuously
adjust a network (and thus, the involved resources) to deliver the
service that conforms to the intended parameters (service
objectives).
This framework is drawn from a network operator perspective
irrespective of the origin of a data model; it can also accommodate
YANG modules that are developed outside the IETF. The document
covers service models that are used by an operator to expose its
services and capture service requirements from the customers
(including other operators). Nevertheless, the document does not
elaborate on the communication protocol(s) that makes use of these
service models in order to request and deliver a service. Such
considerations are out of scope.
The document identifies a list of use cases to exemplify the proposed
approach (Section 5), but it does not claim nor aim to be exhaustive.
Appendix A lists some examples to illustrate the layered YANG modules
view.
2. Terminology and Acronyms
2.1. Terminology
The following terms are defined in [RFC8309][RFC8199] and are not
redefined here:
Wu, et al. Expires April 28, 2021 [Page 5]
Internet-Draft Service and Network Management Automation October 2020
o Network Operator
o Customer
o Service
o Data Model
o Service Model
o Network Element Module
In addition, the document makes use of the following terms:
Network Model: Describes a network level abstraction (or a subset of
aspects of a network infrastructure), including devices and their
subsystems, and relevant protocols operating at the link and
network layers across multiple devices. This model corresponds to
the network configuration model discussed in [RFC8309].
It can be used by a network operator to allocate resources (e.g.,
tunnel resource, topology resource) for the service or schedule
resources to meet the service requirements defined in a service
model.
Network Domain: Refers to a network partitioning that is usually
followed by network operators to delimit parts of their network.
"access network" and "core network" are examples of network
domains.
Device Model: Refers to the Network Element YANG data model
described in [RFC8199] or the device configuration model discussed
in [RFC8309].
Device models are also used to refer to model a function embedded
in a device (e.g., Network Address Translation (NAT) [RFC8512],
Access Control Lists (ACLs) [RFC8519]).
Pipe: Refers to a communication scope where only one-to-one (1:1)
communications are allowed. The scope can be identified between
ingress and egress nodes, two service sites, etc.
Hose: Refers to a communication scope where one-to-many (1:N)
communications are allowed (e.g., one site to multiple sites).
Funnel: Refers to a communication scope where many-to-one (N:1)
communications are allowed.
Wu, et al. Expires April 28, 2021 [Page 6]
Internet-Draft Service and Network Management Automation October 2020
2.2. Acronyms
The following acronyms are used in the document:
ACL Access Control List
AS Autonomous System
AP Access Point
CE Customer Edge
DBE Data Border Element
E2E End-to-End
ECA Event Condition Action
L2VPN Layer 2 Virtual Private Network
L3VPN Layer 3 Virtual Private Network
L3SM L3VPN Service Model
L3NM L3VPN Network Model
NAT Network Address Translation
OAM Operations, Administration, and Maintenance
OWD One-Way Delay
PE Provider Edge
PM Performance Monitoring
QoS Quality of Service
RD Route Distinguisher
RT Route Target
SBE Session Border Element
SDN Software Defined Networking
SP Service Provider
TE Traffic Engineering
VN Virtual Network
VPN Virtual Private Network
VRF Virtual Routing and Forwarding
3. Architectural Concepts and Goals
3.1. Data Models: Layering and Representation
As described in Section 2 of [RFC8199], layering of modules allows
for better reusability of lower-layer modules by higher-level modules
while limiting duplication of features across layers.
Data models in the context of network management can be classified
into service, network, and device models. Different service models
may rely on the same set of network and/or device models.
Service models traditionally follow a top-down approach and are
mostly customer-facing YANG modules providing a common model
construct for higher level network services (e.g., Layer 3 Virtual
Private Network (L3VPN)). Such modules can be mapped to network
technology-specific modules at lower layers (e.g., tunnel, routing,
Wu, et al. Expires April 28, 2021 [Page 7]
Internet-Draft Service and Network Management Automation October 2020
Quality of Service (QoS), security). For example, service models can
be used to characterise the network service(s) to be ensured between
service nodes (ingress/egress) such as:
o the communication scope (pipe, hose, funnel, ...),
o the directionality (inbound/outbound),
o the traffic performance guarantees expressed using metrics such as
One-Way Delay (OWD) [RFC7679] or One-Way Loss [RFC7680]; a summary
of performance metrics maintained by IANA can be found in [IPPM],
o link capacity [RFC5136] [I-D.ietf-ippm-capacity-metric-method],
o etc.
Figure 1 depicts the example of a VoIP service that relies upon
connectivity services offered by a network operator. In this
example, the VoIP service is offered to the network operator's
customers by Service Provider (SP1). In order to provide global VoIP
reachability, SP1 service site interconnects with other Service
Providers service sites typically by interconnecting Session Border
Elements (SBEs) and Data Border Elements (DBEs) [RFC5486][RFC6406].
For other VoIP destinations, sessions are forwarded over the
Internet. These connectivity services can be captured in a YANG
service model that reflects the service attributes that are shown in
Figure 2. This example follows the IP Connectivity Provisioning
Profile template defined in [RFC7297].
In reference to Figure 2, "Full traffic performance guarantees class"
refers to a service class where all traffic performance metrics
included in the service model (OWD, loss, delay variation) are
guaranteed, while "Delay traffic performance guarantees class" refers
to a service class where only OWD is guaranteed.
Wu, et al. Expires April 28, 2021 [Page 8]
Internet-Draft Service and Network Management Automation October 2020
,--,--,--. ,--,--,--.
,-' SP1 `-. ,-' SP2 `-.
( Service Site ) ( Service Site )
`-. ,-' `-. ,-'
`--'--'--' `--'--'--'
x | o * * |
(2)x | o * * |
,x-,--o-*-. (1) ,--,*-,--.
,-' x o * * * * * * * * * `-.
( x o +----( Internet )
User---(x x x o o o o o o o o o o o o o o o o o o
`-. ,-' `-. ,-' (3)
`--'--'--' `--'--'--'
Network Operator
**** (1) Inter-SP connectivity
xxxx (2) Customer to SP connectivity
oooo (3) SP to any destination connectivity
Figure 1: An Example of Service Connectivity Components
Connectivity: Scope and Guarantees
(1) Inter-SP connectivity
- Pipe scope from the local to the remote SBE/DBE
- Full traffic performance guarantees class
(2) Customer to SP connectivity
- Hose/Funnel scope connecting the local SBE/DBE
to the customer access points
- Full traffic performance guarantees class
(3) SP to any destination connectivity
- Hose/Funnel scope from the local SBE/DBE to the
Internet gateway
- Delay traffic performance guarantees class
Flow Identification
* Destination IP address (SBE, DBE)
* DSCP marking
Traffic Isolation
* VPN
Routing & Forwarding
* Routing rule to exclude some ASes from the inter-domain
paths
Notifications (including feedback)
* Statistics on aggregate traffic to adjust capacity
* Failures
* Planned maintenance operations
* Triggered by thresholds
Figure 2: Sample Attributes Captured in a Service Model
Wu, et al. Expires April 28, 2021 [Page 9]
Internet-Draft Service and Network Management Automation October 2020
Network models are mainly network resource-facing modules; they
describe various aspects of a network infrastructure, including
devices and their subsystems, and relevant protocols operating at the
link and network layers across multiple devices (e.g., network
topology and traffic-engineering tunnel modules).
Device (and function) models usually follow a bottom-up approach and
are mostly technology-specific modules used to realize a service
(e.g., BGP, ACL).
Each level maintains a view of the supported YANG modules provided by
lower levels (see for example, Appendix A). Mechanisms such as YANG
library [RFC8525] can be used to expose which YANG modules are
supported by nodes in lower levels.
Figure 3 illustrates the overall layering model. The reader may
refer to Section 4 of [RFC8309] for an overview of "Orchestrator" and
"Controller" elements. All these elements (i.e., Orchestrator(s),
Controller(s), device(s)) are under the responsibility of the same
operator.
Wu, et al. Expires April 28, 2021 [Page 10]
Internet-Draft Service and Network Management Automation October 2020
+-----------------------------------------------------------------+
| Hierarchy Abstraction |
| |
| +-----------------------+ Service Model |
| | Orchestrator | (Customer Oriented) |
| |+---------------------+| Scope: "1:1" Pipe model |
| || Service Modeling || |
| |+---------------------+| |
| | | Bidirectional |
| |+---------------------+| +-+ Capacity, OWD +-+ |
| ||Service Orchestration|| | +----------------+ | |
| |+---------------------+| +-+ +-+ |
| +-----------------------+ Ingress Egress |
| |
| |
| +-----------------------+ Network Model |
| | Controller | (Operator Oriented) |
| |+---------------------+| +-+ +--+ +---+ +-+ |
| || Network Modeling || | | | | | | | | |
| |+---------------------+| | o----o--o----o---o---o | |
| | | +-+ +--+ +---+ +-+ |
| |+---------------------+| src dst |
| ||Network Orchestration|| L3VPN over TE |
| |+---------------------+| Instance Name/Access Interface |
| +-----------------------+ Protocol Type/Capacity/RD/RT/... |
| |
| |
| +-----------------------+ Device Model |
| | Device | |
| |+--------------------+ | |
| || Device Modeling | | Interface add, BGP Peer, |
| |+--------------------+ | Tunnel ID, QoS/TE, ... |
| +-----------------------+ |
+-----------------------------------------------------------------+
Figure 3: Layering and Representation Within a Network Operator
A composite service offered by a network operator may rely on
services from other operators. In such case, the network operator
acts as a customer to request services from other networks. The
operators providing these services will then follow the layering
depicted in Figure 3. The mapping between a composite service and a
third-party service is maintained at the orchestration level. From a
data plane perspective, appropriate traffic steering policies (e.g.,
Service Function Chaining [RFC7665]) are managed by the network
controllers to guide how/when a third party service is invoked for
flows bound to a composite service.
Wu, et al. Expires April 28, 2021 [Page 11]
Internet-Draft Service and Network Management Automation October 2020
The layering model depicted in Figure 3 does not make any assumption
about the location of the various entities (e.g., controller,
orchestrator) within the network. As such, the architecture does not
preclude deployments where, for example, the controller is embedded
on a device that hosts other functions that are controlled via YANG
modules.
In order to ease the mapping between layers and data reuse, this
document focuses on service models that are modelled using YANG.
Nevertheless, fully compliant with Section 3 of [RFC8309], Figure 3
does not preclude service models to be modelled using other data
modelling languages than YANG.
3.2. Automation of Service Delivery Procedures
Service models can be used by a network operator to expose its
services to its customers. Exposing such models allows to automate
the activation of service orders and thus the service delivery. One
or more monolithic service models can be used in the context of a
composite service activation request (e.g., delivery of a caching
infrastructure over a VPN). Such models are used to feed a decision-
making intelligence to adequately accommodate customer's needs.
Also, such models may be used jointly with services that require
dynamic invocation. An example is provided by the service modules
defined by the DOTS WG to dynamically trigger requests to handle
Distributed Denial-of-Service (DDoS) attacks [RFC8783]. The service
filtering request modelled using [RFC8783] will be translated into
device-specific filtering (e.g., ACLs defined in [RFC8519]) that
fulfils the service request.
Network models can be derived from service models and used to
provision, monitor, instantiate the service, and provide lifecycle
management of network resources. Doing so is meant to:
o expose network resources to customers (including other network
operators) to provide service fulfillment and assurance.
o allow customers (or network operators) to dynamically adjust the
network resources based on service requirements as described in
service models (e.g., Figure 2) and the current network
performance information described in the telemetry modules.
Note that it is out of the scope of this document to elaborate on the
communication protocols that are used to implement the interface
between the service ordering (customer) and service order handling
(provider).
Wu, et al. Expires April 28, 2021 [Page 12]
Internet-Draft Service and Network Management Automation October 2020
3.3. Service Fulfillment Automation
To operate a service, the settings of the parameters in the device
models are derived from service models and/or network models and are
used to:
o Provision each involved network function/device with the proper
configuration information.
o Operate the network based on service requirements as described in
the service model(s) and local operational guidelines.
In addition, the operational state including configuration that is in
effect together with statistics should be exposed to upper layers to
provide better network visibility and assess to what extent the
derived low level modules are consistent with the upper level inputs.
Filters are enforced on the notifications that are communicated to
Service layers. The type and frequency of notifications may be
agreed in the service model.
Note that it is important to correlate telemetry data with
configuration data to be used for closed loops at the different
stages of service delivery, from resource allocation to service
operation, in particular.
3.4. YANG Modules Integration
To support top-down service delivery, YANG modules at different
levels or at the same level need to be integrated together for proper
service delivery (including, proper network setup). For example, the
service parameters captured in service models need to be decomposed
into a set of configuration/notification parameters that may be
specific to one or more technologies; these technology-specific
parameters are grouped together to define technology-specific device
level models or network level models.
In addition, these technology-specific device or network models can
be further integrated with each other using the schema mount
mechanism [RFC8528] to provision each involved network function/
device or each involved network domain to support newly added modules
or features. A collection of device models integrated together can
be loaded and validated during implementation.
High-level policies can be defined at service or network models
(e.g., "Autonomous System Number (ASN) Exclude" in the example
depicted in Figure 2). Device models will be tweaked accordingly to
provide policy-based management. Policies can also be used for
Wu, et al. Expires April 28, 2021 [Page 13]
Internet-Draft Service and Network Management Automation October 2020
telemetry automation, e.g., policies that contain conditions to
trigger the generation and pushing of new telemetry data.
4. Functional Blocks and Interactions
The architectural considerations described in Section 3 lead to the
lifecycle management architecture illustrated in Figure 4 and
described in the following subsections.
+------------------+
................. | |
Service level | |
V |
E2E E2E E2E E2E
Service --> Service ---------> Service ------------> Service
Exposure Creation ^ Optimization ^ Diagnosis
/Modification | | |
^ | |Diff | |
E2E | | | E2E | |
Service ----+ | | Service | |
Decommission | +------ Assurance --+ |
| ^ |
Multi-layer | | |
Multi-domain | | |
Service Mapping| | |
................. |<-----------------+ | |
Network level | | +-------+ v
V | | Specific
Specific Specific | Service
Service --------> Service <--+ | Diagnosis
Creation ^ Optimization | | |
/Modification | | | |
| |Diff | | |
| | Specific --+ | |
Service | | Service | |
Decomposition | +----- Assurance ----+ |
| ^ |
................. | | Aggregation |
Device level | +------------+ |
V | |
Service Intent | v
Fulfillment Config ----> Config ----> Performance ----> Fault
Provision Validation Monitoring Diagnostic
Figure 4: Service and Network Lifecycle Management
Wu, et al. Expires April 28, 2021 [Page 14]
Internet-Draft Service and Network Management Automation October 2020
4.1. Service Lifecycle Management Procedure
Service lifecycle management includes end-to-end service lifecycle
management at the service level and technology specific network
lifecycle management at the network level.
The end-to-end service lifecycle management is technology-independent
service management and spans across multiple network domains and/or
multiple layers while technology specific service lifecycle
management is technology domain specific or layer specific service
lifecycle management.
4.1.1. Service Exposure
A service in the context of this document (sometimes called, Network
Service) is some form of connectivity between customer sites and the
Internet or between customer sites across the operator's network and
across the Internet.
Service exposure is used to capture services offered to customers
(ordering and order handling). One example is that a customer can
use a L3VPN Service Model (L3SM) to request L3VPN service by
providing the abstract technical characterization of the intended
service between customer sites.
Service model catalogs can be created along to expose the various
services and the information needed to invoke/order a given service.
4.1.2. Service Creation/Modification
A customer is usually unaware of the technology that the network
operator has available to deliver the service, so the customer does
not make requests specific to the underlying technology but is
limited to making requests specific to the service that is to be
delivered. This service request can be filled using a service model.
Upon receiving a service request, and assuming that appropriate
authentication and authorization checks have been made with success,
the service orchestrator/management system should verify whether the
service requirements in the service request can be met (i.e., whether
there are sufficient resources that can be allocated with the
requested guarantees).
If the request is accepted, the service orchestrator/management
system maps such service request to its view. This view can be
described as a technology specific network model or a set of
technology specific device models and this mapping may include a
Wu, et al. Expires April 28, 2021 [Page 15]
Internet-Draft Service and Network Management Automation October 2020
choice of which networks and technologies to use depending on which
service features have been requested.
In addition, a customer may require to change the underlying network
infrastructure to adapt to new customer's needs and service
requirements (e.g., service a new customer site, add a new access
link, provide disjoint paths). This service modification can be
issued following the same service model used by the service request.
Withdrawing a service is discussed in Section 4.1.6.
4.1.3. Service Assurance
The performance measurement telemetry (Section 4.2) can be used to
provide service assurance at Service and/or Network levels.
Performance measurement telemetry model can tie with service or
network models to monitor network performance or Service Level
Agreement.
4.1.4. Service Optimization
Service optimization is a technique that gets the configuration of
the network updated due to network changes, incident mitigation, or
new service requirements. One example is once a tunnel or a VPN is
setup, Performance monitoring information or telemetry information
per tunnel (or per VPN) can be collected and fed into the management
system. If the network performance doesn't meet the service
requirements, the management system can create new VPN policies
capturing network service requirements and populate them into the
network.
Both network performance information and policies can be modelled
using YANG. With Policy-based management, self-configuration and
self-optimization behavior can be specified and implemented.
The overall service optimization is managed at the service level,
while the network level is responsible for the optimization of the
specific network services it provides.
4.1.5. Service Diagnosis
Operations, Administration, and Maintenance (OAM) are important
networking functions for service diagnosis that allow network
operators to:
o monitor network communications (i.e., reachability verification
and Continuity Check)
Wu, et al. Expires April 28, 2021 [Page 16]
Internet-Draft Service and Network Management Automation October 2020
o troubleshoot failures (i.e., fault verification and localization)
o monitor service-level agreements and performance (i.e.,
performance management)
When the network is down, service diagnosis should be in place to
pinpoint the problem and provide recommendations (or instructions)
for the network recovery.
The service diagnosis information can be modelled as technology-
independent Remote Procedure Call (RPC) operations for OAM protocols
and technology-independent abstraction of key OAM constructs for OAM
protocols [RFC8531][RFC8533]. These models can be used to provide
consistent configuration, reporting, and presentation for the OAM
mechanisms used to manage the network.
Refer to Section 4.2.4 for the device-specific side.
4.1.6. Service Decommission
Service decommission allows a customer to stop the service by
removing the service from active status and thus releasing the
network resources that were allocated to the service. Customers can
also use the service model to withdraw the subscription to a service.
4.2. Service Fullfillment Management Procedure
4.2.1. Intended Configuration Provision
Intended configuration at the device level is derived from network
models at the network level or service model at the service level and
represents the configuration that the system attempts to apply. Take
L3SM as a service model example to deliver a L3VPN service, there is
a need to map the L3VPN service view defined in the service model
into a detailed intended configuration view defined by specific
configuration models for network elements; the configuration
information includes:
o Virtual Routing and Forwarding (VRF) definition, including VPN
policy expression
o Physical Interface(s)
o IP layer (IPv4, IPv6)
o QoS features such as classification, profiles, etc.
Wu, et al. Expires April 28, 2021 [Page 17]
Internet-Draft Service and Network Management Automation October 2020
o Routing protocols: support of configuration of all protocols
listed in a service request, as well as routing policies
associated with those protocols.
o Multicast support
o Address sharing
o Security (e.g., access control, authentication, encryption)
These specific configuration models can be used to configure Provider
Edge (PE) and Customer Edge (CE) devices within a site, e.g., a BGP
policy model can be used to establish VPN membership between sites
and VPN Service Topology.
Note that in networks with legacy devices (that support proprietary
modules or do not support YANG at all), an adaptation layer is likely
to be required at the network level so that these devices can be
involved in the delivery of the network services.
This interface is also used to handle service withdrawal
(Section 4.1.6).
4.2.2. Configuration Validation
Configuration validation is used to validate intended configuration
and ensure the configuration take effect.
For example, if a customer creates an interface "eth-0/0/0" but the
interface does not physically exist at this point, then configuration
data appears in the <intended> status but does not appear in the
<operational> datastore. More details about <intended> and
<operational> datastores can be found in Section 5.1 of [RFC8342].
4.2.3. Performance Monitoring
When a configuration is in effect in a device, <operational>
datastore holds the complete operational state of the device
including learned, system, default configuration, and system state.
However, the configurations and state of a particular device does not
have the visibility on the whole network or how packets are going to
be forwarded through the entire network. Therefore, it becomes more
difficult to operate the entire network without understanding the
current status of the network.
The management system should subscribe to updates of a YANG datastore
in all the network devices for performance monitoring purposes and
Wu, et al. Expires April 28, 2021 [Page 18]
Internet-Draft Service and Network Management Automation October 2020
build a full topological visibility of the network by aggregating
(and filtering) these operational state from different sources.
4.2.4. Fault Diagnostic
When configuration is in effect in a device, some devices may be mis-
configured (e.g., device links are not consistent in both sides of
the network connection) or network resources might be mis-allocated.
Therefore, services may be negatively affected without knowing the
root cause in the network.
Technology-dependent nodes and RPC commands are defined in
technology-specific YANG data models which can use and extend the
base model described in Section 4.1.5 to deal with these issues.
These RPC commands received in the technology-dependent node can be
used to trigger technology-specific OAM message exchanges for fault
verification and fault isolation. For example, TRILL Multicast Tree
Verification (MTV) RPC command [I-D.ietf-trill-yang-oam] can be used
to trigger Multi-Destination Tree Verification Message defined in
[RFC7455] to verify TRILL distribution tree integrity.
4.3. Multi-Layer/Multi-Domain Service Mapping
Multi-layer/Multi-domain Service Mapping allows to map an end-to-end
abstract view of the service segmented at different layers and/or
different network domains into domain-specific views.
One example is to map service parameters in the L3SM into
configuration parameters such as Route Distinguisher (RD), Route
Target (RT), and VRF in the L3VPN Network Model (L3NM).
Another example is to map service parameters in the L3SM into Traffic
Engineered (TE) tunnel parameters (e.g., Tunnel ID) in TE model and
Virtual Network (VN) parameters (e.g., Access Point (AP) list, VN
members) in the YANG data model for VN operation
[I-D.ietf-teas-actn-vn-yang].
4.4. Service Decomposition
Service Decomposition allows to decompose service models at the
service level or network models at the network level into a set of
device models at the device level. These device models may be tied
to specific device types or classified into a collection of related
YANG modules based on service types and features offered, and load at
the implementation time before configuration is loaded and validated.
Wu, et al. Expires April 28, 2021 [Page 19]
Internet-Draft Service and Network Management Automation October 2020
5. YANG Data Model Integration Examples
The following subsections provide some YANG data models integration
examples.
5.1. L2VPN/L3VPN Service Delivery
In reference to Figure 5, the following steps are performed to
deliver the L3VPN service within the network management automation
architecture defined in Section 4:
1. The Customer requests to create two sites (as per Service
Creation in Section 4.2.1) relying upon L3SM with each site
having one network access connectivity, for example:
* Site A: network-access A, link-capacity = 20 Mbps, class
"foo", guaranteed-capacity-percent = 10, average-one-way-delay
= 70 ms.
* Site B: network-access B, link-capacity = 30 Mbps, class
"foo1", guaranteed-capacity-percent = 15, average-one-way-
delay = 60 ms.
2. The Orchestrator extracts the service parameters from the L3SM.
Then, it uses them as input to the Service Mapping in Section 4.3
to translate them into an orchestrated configuration parameters
(e.g., RD, RT, VRF) that are part of the L3NM specified in
[I-D.ietf-opsawg-l3sm-l3nm].
3. The Controller takes the orchestrated configuration parameters in
the L3NM and translates them into orchestrated (Service
Decomposition in Section 4.4) configuration of network elements
that are part of, e.g., BGP, QoS, Network Instance, IP
management, and interface models.
[I-D.ogondio-opsawg-uni-topology] can be used for representing,
managing, and controlling the User Network Interface (UNI) topology.
Wu, et al. Expires April 28, 2021 [Page 20]
Internet-Draft Service and Network Management Automation October 2020
L3SM |
Service |
Model |
+------------------------+------------------------+
| +--------V--------+ |
| | Service Mapping | |
| +--------+--------+ |
| Orchestrator | |
+------------------------+------------------------+
L3NM | ^ UNI Topology Model
Network | |
Model | |
+------------------------+------------------------+
| +-----------V-----------+ |
| | Service Decomposition | |
| +--++---------------++--+ |
| || || |
| Controller || || |
+---------------++---------------++---------------+
|| ||
|| BGP, ||
|| QoS, ||
|| Interface, ||
+------------+| NI, |+------------+
| | IP | |
+--+--+ +--+--+ +--+--+ +--+--+
| CE1 +-------+ PE1 | | PE2 +-------+ CE2 |
+-----+ +-----+ +-----+ +-----+
Figure 5: L3VPN Service Delivery Example (Current)
L3NM inherits some of data elements from the L3SM. Nevertheless, the
L3NM as currently designed in [I-D.ietf-opsawg-l3sm-l3nm] does not
expose some information to the above layer such as the capabilities
of an underlying network (which can be used to drive service order
handling) or notifications (to notify subscribers about specific
events or degradations as per agreed SLAs). Some of this information
can be provided using, e.g., [I-D.www-opsawg-yang-vpn-service-pm]. A
target overall model is depicted in Figure 6.
Wu, et al. Expires April 28, 2021 [Page 21]
Internet-Draft Service and Network Management Automation October 2020
L3SM | ^
Service | | Notifications
Model | |
+------------------------+------------------------+
| +--------V--------+ |
| | Service Mapping | |
| +--------+--------+ |
| Orchestrator | |
+------------------------+------------------------+
L3NM | ^ UNI Topology Model
Network| | L3NM Notifications
Model | | L3NM Capabilities
+------------------------+------------------------+
| +-----------V-----------+ |
| | Service Decomposition | |
| +--++---------------++--+ |
| || || |
| Controller || || |
+---------------++---------------++---------------+
|| ||
|| BGP, ||
|| QoS, ||
|| Interface, ||
+------------+| NI, |+------------+
| | IP | |
+--+--+ +--+--+ +--+--+ +--+--+
| CE1 +-------+ PE1 | | PE2 +-------+ CE2 |
+-----+ +-----+ +-----+ +-----+
Figure 6: L3VPN Service Delivery Example (Target)
Note that a similar analysis can be performed for Layer 2 VPNs
(L2VPNs). A L2VPN Service Model (L2SM) is defined in [RFC8466],
while the L2VPN Network YANG Model (L2NM) is specified in
[I-D.ietf-opsawg-l2nm].
5.2. VN Lifecycle Management
In reference to Figure 7, the following steps are performed to
deliver the VN service within the network management automation
architecture defined in Section 4:
1. A customer makes a request (Service Exposure in Section 4.1.1) to
create a VN. The association between the VN, APs, and VN members
is defined in the VN YANG module [I-D.ietf-teas-actn-vn-yang].
2. The Orchestrator creates the single abstract node topology based
on the information captured in the request.
Wu, et al. Expires April 28, 2021 [Page 22]
Internet-Draft Service and Network Management Automation October 2020
3. The customer exchanges with the Orchestrator the connectivity
matrix on the abstract node topology and explicit paths using the
TE topology model [RFC8795]. This information can be used to
instantiate the VN and setup tunnels between source and
destination endpoints (Service Creation in Section 4.1.2).
4. In order to provide service assurance (Service Optimization in
Section 4.1.4), the telemetry model which augments the VN model
and corresponding TE tunnel model can be used by the Orchestrator
to subscribe to performance measurement data. The Controller
will then notify the Orchestrator with all the parameter changes
and network performance changes related to the VN topology and
the tunnels [I-D.ietf-teas-actn-pm-telemetry-autonomics].
|
VN |
Service |
Model |
+----------------------|--------------------------+
| Orchestrator | |
| +--------V--------+ |
| | Service Mapping | |
| +-----------------+ |
+----------------------+--------------------^-----+
TE | Telemetry |
Tunnel | Model |
Model | |
+----------------------V--------------------+-----+
| Controller |
| |
+-------------------------------------------------+
+-----+ +-----+ +-----+ +-----+
| CE1 +------+ PE1 | | PE2 +------+ CE2 |
+-----+ +-----+ +-----+ +-----+
Figure 7: A VN Service Delivery Example
5.3. Event-based Telemetry in the Device Self Management
In reference to Figure 8, the following steps are performed to
monitor state changes of managed resources in a network device and
provide device self-management within the network management
automation architecture defined in Section 4:
1. To control which state a network device should be in or is
allowed to be in at any given time, a set of conditions and
actions are defined and correlated with network events (e.g.,
Wu, et al. Expires April 28, 2021 [Page 23]
Internet-Draft Service and Network Management Automation October 2020
allow the NETCONF server to send updates only when the value
exceeds a certain threshold for the first time, but not again
until the threshold is cleared), which constitute an
Event/Condition/Action (ECA) policy or an event-driven policy
control logic that can be executed on the device (e.g.,
[I-D.wwx-netmod-event-yang]).
2. To provide rapid autonomic response that can exhibit self-
management properties, the Controller pushes the ECA policy to
the network device and delegates the network control logic to the
network device.
3. The network device uses the ECA model to subscribe to the event
source, e.g., an event stream or datastore state data conveyed to
the server via YANG Push subscription [RFC8641], monitors state
parameters, and takes simple and instant actions when an
associated event condition on state parameters is met. ECA
notifications can be generated as the result of actions based on
event stream subscription or datastore subscription (model-driven
telemetry operation discussed in Section 4.2.3).
+----------------+
| <----+
| Controller | |
+-------+--------+ |
| |
| |
ECA | | ECA
Model | | Notification
| |
| |
+------------V-------------+-----+
|Device | |
| +-------+ +---------+ +--+---+ |
| | Event +-> Event +->Event | |
| | Source| |Condition| |Action| |
| +-------+ +---------+ +------+ |
+--------------------------------+
Figure 8: Event-based Telemetry
6. Security Considerations
Many of the YANG modules cited in this document define schema for
data that are designed to be accessed via network management
protocols such as NETCONF [RFC6241] or RESTCONF [RFC8040]. The
lowest NETCONF layer is the secure transport layer, and the
mandatory-to-implement secure transport is Secure Shell (SSH)
Wu, et al. Expires April 28, 2021 [Page 24]
Internet-Draft Service and Network Management Automation October 2020
[RFC6242]. The lowest RESTCONF layer is HTTPS, and the mandatory-to-
implement secure transport is TLS [RFC8446].
The NETCONF access control model [RFC8341] provides the means to
restrict access for particular NETCONF or RESTCONF users to a
preconfigured subset of all available NETCONF or RESTCONF protocol
operations and content.
Security considerations specific to each of the technologies and
protocols listed in the document are discussed in the specification
documents of each of these protocols.
In order to prevent leaking sensitive information and the "confused
deputy" problem [Hardy] in general, special care should be considered
when translating between the various layers in Section 4 or when
aggregating data retrieved from various sources. Authorization and
authentication checks should be performed to ensure that a data is
available to an authorized entity. The network operator must enforce
means to protect privacy-related information included in customer-
facing models.
To detect misalignment between layers that might be induced by
misbehaving nodes, upper layers should continuously monitor the
perceived service (Section 4.1.4) and should proceed with checks to
assess that the provided service complies with the expected service
and that the data reported by an underlying layer is matching the
perceived service by the above layer. Such checks are the
responsibility of the service diagnosis (Section 4.1.5).
When a YANG module includes security-related parameters, it is
recommended to include the relevant information as part of the
service assurance to track the correct functioning of the security
mechanisms.
Additional considerations are discussed in the following subsections.
6.1. Service Level
A provider may rely on services offered by other providers to build
composite services. Appropriate mechanisms should be enabled by the
provider to monitor and detect a service disruption from these
providers. The characterization of a service disruption (including,
mean time between failures, mean time to repair), the escalation
procedure, and penalties are usually documented in contractual
agreements (e.g., as described in Section 2.1 of [RFC4176]).
Misbehaving peer providers will thus be identified and appropriate
countermeasures will be applied.
Wu, et al. Expires April 28, 2021 [Page 25]
Internet-Draft Service and Network Management Automation October 2020
The communication protocols that make use of a service model between
a customer and an operator are out of scope. Relevant security
considerations should be discussed in the specification documents of
these protocols.
6.2. Network Level
Security considerations specific to the network level are listed
below:
o A controller may create forwarding loops by mis-configuring the
underlying network nodes. It is recommended to proceed with tests
to check the status of forwarding paths regularly or whenever
changes are made to routing or forwarding processes. Such checks
may be triggered from the service level owing to the means
discussed in Section 4.1.5.
o Some service models may include a traffic isolation clause that is
passed down to the network level so that appropriate technology-
specific actions must be enforced at the underlying network (and
thus involved network devices) to avoid that such traffic is
accessible to non-authorized parties. In particular, network
models may indicate whether encryption is enabled and if so,
expose a list of supported encryption schemes and parameters.
Refer for example to the encryption feature defined in
[I-D.ietf-opsawg-vpn-common] and its use in
[I-D.ietf-opsawg-l3sm-l3nm].
6.3. Device Level
Network operators should monitor and audit their networks to detect
misbehaving nodes and abnormal behaviors. For example, OAM discussed
in Section 4.1.5 can be used for that purpose.
Access to some data requires specific access privilege levels.
Devices must check that a required access privilege is provided
before granting access to specific data or performing specific
actions.
7. IANA Considerations
There are no IANA requests or assignments included in this document.
8. Acknowledgements
Thanks to Joe Clark, Greg Mirsky, Shunsuke Homma, Brian Carpenter,
Adrian Farrel, Christian Huitema, Tommy Pauly, Ines Robles, and
Olivier Augizeau for the review.
Wu, et al. Expires April 28, 2021 [Page 26]
Internet-Draft Service and Network Management Automation October 2020
Many thanks to Robert Wilton for the detailed AD review.
Thanks to Eric Vyncke, Roman Danyliw, Erik Kline, and Benjamin Kaduk
for the IESG review.
9. Contributors
Christian Jacquenet
Orange
Rennes, 35000
France
Email: Christian.jacquenet@orange.com
Luis Miguel Contreras Murillo
Telifonica
Email: luismiguel.contrerasmurillo@telefonica.com
Oscar Gonzalez de Dios
Telefonica
Madrid
ES
Email: oscar.gonzalezdedios@telefonica.com
Weiqiang Cheng
China Mobile
Email: chengweiqiang@chinamobile.com
Young Lee
Sung Kyun Kwan University
Email: younglee.tx@gmail.com
10. References
10.1. Normative References
[RFC6241] Enns, R., Ed., Bjorklund, M., Ed., Schoenwaelder, J., Ed.,
and A. Bierman, Ed., "Network Configuration Protocol
(NETCONF)", RFC 6241, DOI 10.17487/RFC6241, June 2011,
<https://www.rfc-editor.org/info/rfc6241>.
[RFC6242] Wasserman, M., "Using the NETCONF Protocol over Secure
Shell (SSH)", RFC 6242, DOI 10.17487/RFC6242, June 2011,
<https://www.rfc-editor.org/info/rfc6242>.
Wu, et al. Expires April 28, 2021 [Page 27]
Internet-Draft Service and Network Management Automation October 2020
[RFC7950] Bjorklund, M., Ed., "The YANG 1.1 Data Modeling Language",
RFC 7950, DOI 10.17487/RFC7950, August 2016,
<https://www.rfc-editor.org/info/rfc7950>.
[RFC8040] Bierman, A., Bjorklund, M., and K. Watsen, "RESTCONF
Protocol", RFC 8040, DOI 10.17487/RFC8040, January 2017,
<https://www.rfc-editor.org/info/rfc8040>.
[RFC8341] Bierman, A. and M. Bjorklund, "Network Configuration
Access Control Model", STD 91, RFC 8341,
DOI 10.17487/RFC8341, March 2018,
<https://www.rfc-editor.org/info/rfc8341>.
[RFC8446] Rescorla, E., "The Transport Layer Security (TLS) Protocol
Version 1.3", RFC 8446, DOI 10.17487/RFC8446, August 2018,
<https://www.rfc-editor.org/info/rfc8446>.
10.2. Informative References
[Hardy] Hardy, N., "The Confused Deputy: (or why capabilities
might have been invented)", October 1988,
<https://dl.acm.org/doi/10.1145/54289.871709>.
[I-D.clacla-netmod-model-catalog]
Clarke, J. and B. Claise, "YANG module for
yangcatalog.org", draft-clacla-netmod-model-catalog-03
(work in progress), April 2018.
[I-D.ietf-bess-evpn-yang]
Brissette, P., Shah, H., Hussain, I., Tiruveedhula, K.,
and J. Rabadan, "Yang Data Model for EVPN", draft-ietf-
bess-evpn-yang-07 (work in progress), March 2019.
[I-D.ietf-bess-l2vpn-yang]
Shah, H., Brissette, P., Chen, I., Hussain, I., Wen, B.,
and K. Tiruveedhula, "YANG Data Model for MPLS-based
L2VPN", draft-ietf-bess-l2vpn-yang-10 (work in progress),
July 2019.
[I-D.ietf-bess-l3vpn-yang]
Jain, D., Patel, K., Brissette, P., Li, Z., Zhuang, S.,
Liu, X., Haas, J., Esale, S., and B. Wen, "Yang Data Model
for BGP/MPLS L3 VPNs", draft-ietf-bess-l3vpn-yang-04 (work
in progress), October 2018.
Wu, et al. Expires April 28, 2021 [Page 28]
Internet-Draft Service and Network Management Automation October 2020
[I-D.ietf-bess-mvpn-yang]
Liu, Y., Guo, F., Litkowski, S., Liu, X., Kebler, R., and
M. Sivakumar, "Yang Data Model for Multicast in MPLS/BGP
IP VPNs", draft-ietf-bess-mvpn-yang-04 (work in progress),
June 2020.
[I-D.ietf-bfd-yang]
Rahman, R., Zheng, L., Jethanandani, M., Pallagatti, S.,
and G. Mirsky, "YANG Data Model for Bidirectional
Forwarding Detection (BFD)", draft-ietf-bfd-yang-17 (work
in progress), August 2018.
[I-D.ietf-dots-rfc8782-bis]
Boucadair, M., Shallow, J., and T. Reddy.K, "Distributed
Denial-of-Service Open Threat Signaling (DOTS) Signal
Channel Specification", draft-ietf-dots-rfc8782-bis-01
(work in progress), September 2020.
[I-D.ietf-i2rs-yang-l2-network-topology]
Dong, J., Wei, X., WU, Q., Boucadair, M., and A. Liu, "A
YANG Data Model for Layer 2 Network Topologies", draft-
ietf-i2rs-yang-l2-network-topology-18 (work in progress),
September 2020.
[I-D.ietf-idr-bgp-model]
Jethanandani, M., Patel, K., Hares, S., and J. Haas, "BGP
YANG Model for Service Provider Networks", draft-ietf-idr-
bgp-model-09 (work in progress), June 2020.
[I-D.ietf-ippm-capacity-metric-method]
Morton, A., Geib, R., and L. Ciavattone, "Metrics and
Methods for One-way IP Capacity", draft-ietf-ippm-
capacity-metric-method-04 (work in progress), September
2020.
[I-D.ietf-ippm-stamp-yang]
Mirsky, G., Min, X., and W. Luo, "Simple Two-way Active
Measurement Protocol (STAMP) Data Model", draft-ietf-ippm-
stamp-yang-06 (work in progress), October 2020.
[I-D.ietf-ippm-twamp-yang]
Civil, R., Morton, A., Rahman, R., Jethanandani, M., and
K. Pentikousis, "Two-Way Active Measurement Protocol
(TWAMP) Data Model", draft-ietf-ippm-twamp-yang-13 (work
in progress), July 2018.
Wu, et al. Expires April 28, 2021 [Page 29]
Internet-Draft Service and Network Management Automation October 2020
[I-D.ietf-mpls-base-yang]
Saad, T., Raza, K., Gandhi, R., Liu, X., and V. Beeram, "A
YANG Data Model for MPLS Base", draft-ietf-mpls-base-
yang-16 (work in progress), October 2020.
[I-D.ietf-netmod-module-tags]
Hopps, C., Berger, L., and D. Bogdanovic, "YANG Module
Tags", draft-ietf-netmod-module-tags-10 (work in
progress), February 2020.
[I-D.ietf-opsawg-l2nm]
barguil, s., Dios, O., Boucadair, M., Munoz, L., Jalil,
L., and J. Ma, "A Layer 2 VPN Network YANG Model", draft-
ietf-opsawg-l2nm-00 (work in progress), July 2020.
[I-D.ietf-opsawg-l3sm-l3nm]
barguil, s., Dios, O., Boucadair, M., Munoz, L., and A.
Aguado, "A Layer 3 VPN Network YANG Model", draft-ietf-
opsawg-l3sm-l3nm-05 (work in progress), October 2020.
[I-D.ietf-opsawg-vpn-common]
barguil, s., Dios, O., Boucadair, M., and Q. WU, "A Layer
2/3 VPN Common YANG Model", draft-ietf-opsawg-vpn-
common-01 (work in progress), September 2020.
[I-D.ietf-pim-igmp-mld-snooping-yang]
Zhao, H., Liu, X., Liu, Y., Sivakumar, M., and A. Peter,
"A Yang Data Model for IGMP and MLD Snooping", draft-ietf-
pim-igmp-mld-snooping-yang-18 (work in progress), August
2020.
[I-D.ietf-pim-yang]
Liu, X., McAllister, P., Peter, A., Sivakumar, M., Liu,
Y., and f. hu, "A YANG Data Model for Protocol Independent
Multicast (PIM)", draft-ietf-pim-yang-17 (work in
progress), May 2018.
[I-D.ietf-rtgwg-policy-model]
Qu, Y., Tantsura, J., Lindem, A., and X. Liu, "A YANG Data
Model for Routing Policy Management", draft-ietf-rtgwg-
policy-model-26 (work in progress), October 2020.
[I-D.ietf-rtgwg-qos-model]
Choudhary, A., Jethanandani, M., Strahle, N., Aries, E.,
and I. Chen, "YANG Model for QoS", draft-ietf-rtgwg-qos-
model-02 (work in progress), July 2020.
Wu, et al. Expires April 28, 2021 [Page 30]
Internet-Draft Service and Network Management Automation October 2020
[I-D.ietf-spring-sr-yang]
Litkowski, S., Qu, Y., Lindem, A., Sarkar, P., and J.
Tantsura, "YANG Data Model for Segment Routing", draft-
ietf-spring-sr-yang-22 (work in progress), August 2020.
[I-D.ietf-teas-actn-pm-telemetry-autonomics]
Lee, Y., Dhody, D., Karunanithi, S., Vilata, R., King, D.,
and D. Ceccarelli, "YANG models for VN/TE Performance
Monitoring Telemetry and Scaling Intent Autonomics",
draft-ietf-teas-actn-pm-telemetry-autonomics-03 (work in
progress), July 2020.
[I-D.ietf-teas-actn-vn-yang]
Lee, Y., Dhody, D., Ceccarelli, D., Bryskin, I., and B.
Yoon, "A YANG Data Model for VN Operation", draft-ietf-
teas-actn-vn-yang-09 (work in progress), July 2020.
[I-D.ietf-teas-yang-path-computation]
Busi, I., Belotti, S., Lopez, V., Sharma, A., and Y. Shi,
"Yang model for requesting Path Computation", draft-ietf-
teas-yang-path-computation-10 (work in progress), July
2020.
[I-D.ietf-teas-yang-rsvp-te]
Beeram, V., Saad, T., Gandhi, R., Liu, X., Bryskin, I.,
and H. Shah, "A YANG Data Model for RSVP-TE Protocol",
draft-ietf-teas-yang-rsvp-te-08 (work in progress), March
2020.
[I-D.ietf-teas-yang-te]
Saad, T., Gandhi, R., Liu, X., Beeram, V., and I. Bryskin,
"A YANG Data Model for Traffic Engineering Tunnels, Label
Switched Paths and Interfaces", draft-ietf-teas-yang-te-25
(work in progress), July 2020.
[I-D.ietf-trill-yang-oam]
Kumar, D., Senevirathne, T., Finn, N., Salam, S., Xia, L.,
and H. Weiguo, "YANG Data Model for TRILL Operations,
Administration, and Maintenance (OAM)", draft-ietf-trill-
yang-oam-05 (work in progress), March 2017.
[I-D.ogondio-opsawg-uni-topology]
Dios, O., barguil, s., WU, Q., and M. Boucadair, "A YANG
Model for User-Network Interface (UNI) Topologies", draft-
ogondio-opsawg-uni-topology-01 (work in progress), April
2020.
Wu, et al. Expires April 28, 2021 [Page 31]
Internet-Draft Service and Network Management Automation October 2020
[I-D.www-opsawg-yang-vpn-service-pm]
Bo, W., WU, Q., Boucadair, M., Dios, O., Wen, B., Liu, C.,
and H. Xu, "A YANG Model for Network and VPN Service
Performance Monitoring", draft-www-opsawg-yang-vpn-
service-pm-01 (work in progress), July 2020.
[I-D.wwx-netmod-event-yang]
Bierman, A., WU, Q., Bryskin, I., Birkholz, H., Liu, X.,
and B. Claise, "A YANG Data model for ECA Policy
Management", draft-wwx-netmod-event-yang-09 (work in
progress), July 2020.
[IPPM] IANA, "Performance Metrics", March 2020,
<https://www.iana.org/assignments/performance-metrics/
performance-metrics.xhtml>.
[RFC4176] El Mghazli, Y., Ed., Nadeau, T., Boucadair, M., Chan, K.,
and A. Gonguet, "Framework for Layer 3 Virtual Private
Networks (L3VPN) Operations and Management", RFC 4176,
DOI 10.17487/RFC4176, October 2005,
<https://www.rfc-editor.org/info/rfc4176>.
[RFC4364] Rosen, E. and Y. Rekhter, "BGP/MPLS IP Virtual Private
Networks (VPNs)", RFC 4364, DOI 10.17487/RFC4364, February
2006, <https://www.rfc-editor.org/info/rfc4364>.
[RFC4664] Andersson, L., Ed. and E. Rosen, Ed., "Framework for Layer
2 Virtual Private Networks (L2VPNs)", RFC 4664,
DOI 10.17487/RFC4664, September 2006,
<https://www.rfc-editor.org/info/rfc4664>.
[RFC4761] Kompella, K., Ed. and Y. Rekhter, Ed., "Virtual Private
LAN Service (VPLS) Using BGP for Auto-Discovery and
Signaling", RFC 4761, DOI 10.17487/RFC4761, January 2007,
<https://www.rfc-editor.org/info/rfc4761>.
[RFC4762] Lasserre, M., Ed. and V. Kompella, Ed., "Virtual Private
LAN Service (VPLS) Using Label Distribution Protocol (LDP)
Signaling", RFC 4762, DOI 10.17487/RFC4762, January 2007,
<https://www.rfc-editor.org/info/rfc4762>.
[RFC5136] Chimento, P. and J. Ishac, "Defining Network Capacity",
RFC 5136, DOI 10.17487/RFC5136, February 2008,
<https://www.rfc-editor.org/info/rfc5136>.
Wu, et al. Expires April 28, 2021 [Page 32]
Internet-Draft Service and Network Management Automation October 2020
[RFC5486] Malas, D., Ed. and D. Meyer, Ed., "Session Peering for
Multimedia Interconnect (SPEERMINT) Terminology",
RFC 5486, DOI 10.17487/RFC5486, March 2009,
<https://www.rfc-editor.org/info/rfc5486>.
[RFC5880] Katz, D. and D. Ward, "Bidirectional Forwarding Detection
(BFD)", RFC 5880, DOI 10.17487/RFC5880, June 2010,
<https://www.rfc-editor.org/info/rfc5880>.
[RFC6406] Malas, D., Ed. and J. Livingood, Ed., "Session PEERing for
Multimedia INTerconnect (SPEERMINT) Architecture",
RFC 6406, DOI 10.17487/RFC6406, November 2011,
<https://www.rfc-editor.org/info/rfc6406>.
[RFC7149] Boucadair, M. and C. Jacquenet, "Software-Defined
Networking: A Perspective from within a Service Provider
Environment", RFC 7149, DOI 10.17487/RFC7149, March 2014,
<https://www.rfc-editor.org/info/rfc7149>.
[RFC7224] Bjorklund, M., "IANA Interface Type YANG Module",
RFC 7224, DOI 10.17487/RFC7224, May 2014,
<https://www.rfc-editor.org/info/rfc7224>.
[RFC7276] Mizrahi, T., Sprecher, N., Bellagamba, E., and Y.
Weingarten, "An Overview of Operations, Administration,
and Maintenance (OAM) Tools", RFC 7276,
DOI 10.17487/RFC7276, June 2014,
<https://www.rfc-editor.org/info/rfc7276>.
[RFC7297] Boucadair, M., Jacquenet, C., and N. Wang, "IP
Connectivity Provisioning Profile (CPP)", RFC 7297,
DOI 10.17487/RFC7297, July 2014,
<https://www.rfc-editor.org/info/rfc7297>.
[RFC7317] Bierman, A. and M. Bjorklund, "A YANG Data Model for
System Management", RFC 7317, DOI 10.17487/RFC7317, August
2014, <https://www.rfc-editor.org/info/rfc7317>.
[RFC7455] Senevirathne, T., Finn, N., Salam, S., Kumar, D., Eastlake
3rd, D., Aldrin, S., and Y. Li, "Transparent
Interconnection of Lots of Links (TRILL): Fault
Management", RFC 7455, DOI 10.17487/RFC7455, March 2015,
<https://www.rfc-editor.org/info/rfc7455>.
[RFC7665] Halpern, J., Ed. and C. Pignataro, Ed., "Service Function
Chaining (SFC) Architecture", RFC 7665,
DOI 10.17487/RFC7665, October 2015,
<https://www.rfc-editor.org/info/rfc7665>.
Wu, et al. Expires April 28, 2021 [Page 33]
Internet-Draft Service and Network Management Automation October 2020
[RFC7679] Almes, G., Kalidindi, S., Zekauskas, M., and A. Morton,
Ed., "A One-Way Delay Metric for IP Performance Metrics
(IPPM)", STD 81, RFC 7679, DOI 10.17487/RFC7679, January
2016, <https://www.rfc-editor.org/info/rfc7679>.
[RFC7680] Almes, G., Kalidindi, S., Zekauskas, M., and A. Morton,
Ed., "A One-Way Loss Metric for IP Performance Metrics
(IPPM)", STD 82, RFC 7680, DOI 10.17487/RFC7680, January
2016, <https://www.rfc-editor.org/info/rfc7680>.
[RFC8077] Martini, L., Ed. and G. Heron, Ed., "Pseudowire Setup and
Maintenance Using the Label Distribution Protocol (LDP)",
STD 84, RFC 8077, DOI 10.17487/RFC8077, February 2017,
<https://www.rfc-editor.org/info/rfc8077>.
[RFC8194] Schoenwaelder, J. and V. Bajpai, "A YANG Data Model for
LMAP Measurement Agents", RFC 8194, DOI 10.17487/RFC8194,
August 2017, <https://www.rfc-editor.org/info/rfc8194>.
[RFC8199] Bogdanovic, D., Claise, B., and C. Moberg, "YANG Module
Classification", RFC 8199, DOI 10.17487/RFC8199, July
2017, <https://www.rfc-editor.org/info/rfc8199>.
[RFC8299] Wu, Q., Ed., Litkowski, S., Tomotaki, L., and K. Ogaki,
"YANG Data Model for L3VPN Service Delivery", RFC 8299,
DOI 10.17487/RFC8299, January 2018,
<https://www.rfc-editor.org/info/rfc8299>.
[RFC8309] Wu, Q., Liu, W., and A. Farrel, "Service Models
Explained", RFC 8309, DOI 10.17487/RFC8309, January 2018,
<https://www.rfc-editor.org/info/rfc8309>.
[RFC8342] Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K.,
and R. Wilton, "Network Management Datastore Architecture
(NMDA)", RFC 8342, DOI 10.17487/RFC8342, March 2018,
<https://www.rfc-editor.org/info/rfc8342>.
[RFC8343] Bjorklund, M., "A YANG Data Model for Interface
Management", RFC 8343, DOI 10.17487/RFC8343, March 2018,
<https://www.rfc-editor.org/info/rfc8343>.
[RFC8345] Clemm, A., Medved, J., Varga, R., Bahadur, N.,
Ananthakrishnan, H., and X. Liu, "A YANG Data Model for
Network Topologies", RFC 8345, DOI 10.17487/RFC8345, March
2018, <https://www.rfc-editor.org/info/rfc8345>.
Wu, et al. Expires April 28, 2021 [Page 34]
Internet-Draft Service and Network Management Automation October 2020
[RFC8346] Clemm, A., Medved, J., Varga, R., Liu, X.,
Ananthakrishnan, H., and N. Bahadur, "A YANG Data Model
for Layer 3 Topologies", RFC 8346, DOI 10.17487/RFC8346,
March 2018, <https://www.rfc-editor.org/info/rfc8346>.
[RFC8348] Bierman, A., Bjorklund, M., Dong, J., and D. Romascanu, "A
YANG Data Model for Hardware Management", RFC 8348,
DOI 10.17487/RFC8348, March 2018,
<https://www.rfc-editor.org/info/rfc8348>.
[RFC8349] Lhotka, L., Lindem, A., and Y. Qu, "A YANG Data Model for
Routing Management (NMDA Version)", RFC 8349,
DOI 10.17487/RFC8349, March 2018,
<https://www.rfc-editor.org/info/rfc8349>.
[RFC8466] Wen, B., Fioccola, G., Ed., Xie, C., and L. Jalil, "A YANG
Data Model for Layer 2 Virtual Private Network (L2VPN)
Service Delivery", RFC 8466, DOI 10.17487/RFC8466, October
2018, <https://www.rfc-editor.org/info/rfc8466>.
[RFC8512] Boucadair, M., Ed., Sivakumar, S., Jacquenet, C.,
Vinapamula, S., and Q. Wu, "A YANG Module for Network
Address Translation (NAT) and Network Prefix Translation
(NPT)", RFC 8512, DOI 10.17487/RFC8512, January 2019,
<https://www.rfc-editor.org/info/rfc8512>.
[RFC8513] Boucadair, M., Jacquenet, C., and S. Sivakumar, "A YANG
Data Model for Dual-Stack Lite (DS-Lite)", RFC 8513,
DOI 10.17487/RFC8513, January 2019,
<https://www.rfc-editor.org/info/rfc8513>.
[RFC8519] Jethanandani, M., Agarwal, S., Huang, L., and D. Blair,
"YANG Data Model for Network Access Control Lists (ACLs)",
RFC 8519, DOI 10.17487/RFC8519, March 2019,
<https://www.rfc-editor.org/info/rfc8519>.
[RFC8525] Bierman, A., Bjorklund, M., Schoenwaelder, J., Watsen, K.,
and R. Wilton, "YANG Library", RFC 8525,
DOI 10.17487/RFC8525, March 2019,
<https://www.rfc-editor.org/info/rfc8525>.
[RFC8528] Bjorklund, M. and L. Lhotka, "YANG Schema Mount",
RFC 8528, DOI 10.17487/RFC8528, March 2019,
<https://www.rfc-editor.org/info/rfc8528>.
Wu, et al. Expires April 28, 2021 [Page 35]
Internet-Draft Service and Network Management Automation October 2020
[RFC8529] Berger, L., Hopps, C., Lindem, A., Bogdanovic, D., and X.
Liu, "YANG Data Model for Network Instances", RFC 8529,
DOI 10.17487/RFC8529, March 2019,
<https://www.rfc-editor.org/info/rfc8529>.
[RFC8530] Berger, L., Hopps, C., Lindem, A., Bogdanovic, D., and X.
Liu, "YANG Model for Logical Network Elements", RFC 8530,
DOI 10.17487/RFC8530, March 2019,
<https://www.rfc-editor.org/info/rfc8530>.
[RFC8531] Kumar, D., Wu, Q., and Z. Wang, "Generic YANG Data Model
for Connection-Oriented Operations, Administration, and
Maintenance (OAM) Protocols", RFC 8531,
DOI 10.17487/RFC8531, April 2019,
<https://www.rfc-editor.org/info/rfc8531>.
[RFC8532] Kumar, D., Wang, Z., Wu, Q., Ed., Rahman, R., and S.
Raghavan, "Generic YANG Data Model for the Management of
Operations, Administration, and Maintenance (OAM)
Protocols That Use Connectionless Communications",
RFC 8532, DOI 10.17487/RFC8532, April 2019,
<https://www.rfc-editor.org/info/rfc8532>.
[RFC8533] Kumar, D., Wang, M., Wu, Q., Ed., Rahman, R., and S.
Raghavan, "A YANG Data Model for Retrieval Methods for the
Management of Operations, Administration, and Maintenance
(OAM) Protocols That Use Connectionless Communications",
RFC 8533, DOI 10.17487/RFC8533, April 2019,
<https://www.rfc-editor.org/info/rfc8533>.
[RFC8632] Vallin, S. and M. Bjorklund, "A YANG Data Model for Alarm
Management", RFC 8632, DOI 10.17487/RFC8632, September
2019, <https://www.rfc-editor.org/info/rfc8632>.
[RFC8641] Clemm, A. and E. Voit, "Subscription to YANG Notifications
for Datastore Updates", RFC 8641, DOI 10.17487/RFC8641,
September 2019, <https://www.rfc-editor.org/info/rfc8641>.
[RFC8652] Liu, X., Guo, F., Sivakumar, M., McAllister, P., and A.
Peter, "A YANG Data Model for the Internet Group
Management Protocol (IGMP) and Multicast Listener
Discovery (MLD)", RFC 8652, DOI 10.17487/RFC8652, November
2019, <https://www.rfc-editor.org/info/rfc8652>.
[RFC8675] Boucadair, M., Farrer, I., and R. Asati, "A YANG Data
Model for Tunnel Interface Types", RFC 8675,
DOI 10.17487/RFC8675, November 2019,
<https://www.rfc-editor.org/info/rfc8675>.
Wu, et al. Expires April 28, 2021 [Page 36]
Internet-Draft Service and Network Management Automation October 2020
[RFC8676] Farrer, I., Ed. and M. Boucadair, Ed., "YANG Modules for
IPv4-in-IPv6 Address plus Port (A+P) Softwires", RFC 8676,
DOI 10.17487/RFC8676, November 2019,
<https://www.rfc-editor.org/info/rfc8676>.
[RFC8783] Boucadair, M., Ed. and T. Reddy.K, Ed., "Distributed
Denial-of-Service Open Threat Signaling (DOTS) Data
Channel Specification", RFC 8783, DOI 10.17487/RFC8783,
May 2020, <https://www.rfc-editor.org/info/rfc8783>.
[RFC8791] Bierman, A., Bjoerklund, M., and K. Watsen, "YANG Data
Structure Extensions", RFC 8791, DOI 10.17487/RFC8791,
June 2020, <https://www.rfc-editor.org/info/rfc8791>.
[RFC8795] Liu, X., Bryskin, I., Beeram, V., Saad, T., Shah, H., and
O. Gonzalez de Dios, "YANG Data Model for Traffic
Engineering (TE) Topologies", RFC 8795,
DOI 10.17487/RFC8795, August 2020,
<https://www.rfc-editor.org/info/rfc8795>.
Appendix A. Layered YANG Modules Examples Overview
This appendix lists a set of YANG data models that can be used for
the delivery of connectivity services. These models can be
classified as service, network, or device models.
It is not the intent of this appendix to provide an inventory of
tools and mechanisms used in specific network and service management
domains; such inventory can be found in documents such as [RFC7276].
The reader may refer to the YANG Catalog
(<https://www.yangcatalog.org>) or the public Github YANG repository
(<https://github.com/YangModels/yang>) to query existing YANG models.
The YANG Catalog includes some metadata to indicate the module type
('module-classification') [I-D.clacla-netmod-model-catalog]. Note
that the mechanism defined in [I-D.ietf-netmod-module-tags] allows to
associate tags with YANG modules in order to help classifying the
modules.
A.1. Service Models: Definition and Samples
As described in [RFC8309], the service is "some form of connectivity
between customer sites and the Internet and/or between customer sites
across the network operator's network and across the Internet". More
concretely, an IP connectivity service can be defined as the IP
transfer capability characterized by a (Source Nets, Destination
Nets, Guarantees, Scope) tuple where "Source Nets" is a group of
unicast IP addresses, "Destination Nets" is a group of IP unicast
Wu, et al. Expires April 28, 2021 [Page 37]
Internet-Draft Service and Network Management Automation October 2020
and/or multicast addresses, and "Guarantees" reflects the guarantees
(expressed in terms of QoS, performance, and availability, for
example) to properly forward traffic to the said "Destination"
[RFC7297].
For example:
o The L3SM [RFC8299] defines the L3VPN service ordered by a customer
from a network operator.
o The L2SM [RFC8466] defines the L2VPN service ordered by a customer
from a network operator.
o The Virtual Network (VN) model [I-D.ietf-teas-actn-vn-yang]
provides a YANG data model applicable to any mode of VN operation.
L2SM and L3SM are customer service models as per [RFC8309].
A.2. Schema Mount
Modularity and extensibility were among the leading design principles
of the YANG data modeling language. As a result, the same YANG
module can be combined with various sets of other modules and thus
form a data model that is tailored to meet the requirements of a
specific use case. [RFC8528] defines a mechanism, denoted schema
mount, that allows for mounting one data model consisting of any
number of YANG modules at a specified location of another (parent)
schema.
A.3. Network Models: Samples
L2NM [I-D.ietf-opsawg-l2nm] and L3NM [I-D.ietf-opsawg-l3sm-l3nm] are
examples of YANG network models.
Figure 9 depicts a set of additional network models such as topology
and tunnel models:
Wu, et al. Expires April 28, 2021 [Page 38]
Internet-Draft Service and Network Management Automation October 2020
+-------------------------------+-------------------------------+
| Topology YANG modules | Tunnel YANG modules |
+-------------------------------+-------------------------------+
| +------------------+ | |
| |Network Topologies| | +------+ +-----------+ |
| | Model | | |Other | | TE Tunnel | |
| +--------+---------+ | |Tunnel| +----+------+ |
| | +---------+ | +------+ | |
| +---+Service | | +----------+---------+ |
| | |Topology | | | | | |
| | +---------+ | | | | |
| | +---------+ |+----+---+ +----+---+ +---+---+|
| +---+Layer 3 | ||MPLS-TE | |RSVP-TE | | SR-TE ||
| | |Topology | || Tunnel | | Tunnel | |Tunnel ||
| | +---------+ |+--------+ +--------+ +-------+|
| | +---------+ | |
| +---+TE | | |
| | |Topology | | |
| | +---------+ | |
| | +---------+ | |
| +---+Layer 3 | | |
| |Topology | | |
| +---------+ | |
+-------------------------------+-------------------------------+
Figure 9: Sample Resource Facing Network Models
Examples of topology YANG modules are listed below:
o Network Topologies Model: [RFC8345] defines a base model for
network topology and inventories. Network topology data include
link, node, and terminate-point resources.
o TE Topology Model: [RFC8795] defines a YANG data model for
representing and manipulating TE topologies.
This module is extended from network topology model defined in
[RFC8345] with TE topologies related content. This model contains
technology-agnostic TE Topology building blocks that can be
augmented and used by other technology-specific TE topology
models.
o Layer 3 Topology Model:
[RFC8346] defines a YANG data model for representing and
manipulating Layer 3 topologies. This model is extended from the
network topology model defined in [RFC8345] with Layer 3
topologies specifics.
Wu, et al. Expires April 28, 2021 [Page 39]
Internet-Draft Service and Network Management Automation October 2020
o Layer 2 Topology Model:
[I-D.ietf-i2rs-yang-l2-network-topology] defines a YANG data model
for representing and manipulating Layer 2 topologies. This model
is extended from the network topology model defined in [RFC8345]
with Layer 2 topology specifics.
Examples of tunnel YANG modules are provided below:
o Tunnel identities: [RFC8675] defines a collection of YANG
identities used as interface types for tunnel interfaces.
o TE Tunnel Model:
[I-D.ietf-teas-yang-te] defines a YANG module for the
configuration and management of TE interfaces, tunnels, and LSPs.
o Segment Routing (SR) Traffic Engineering (TE) Tunnel Model:
[I-D.ietf-teas-yang-te] augments the TE generic and MPLS-TE
model(s) and defines a YANG module for SR-TE specific data.
o MPLS-TE Model:
[I-D.ietf-teas-yang-te] augments the TE generic and MPLS-TE
model(s) and defines a YANG module for MPLS-TE configurations,
state, RPC and notifications.
o RSVP-TE MPLS Model:
[I-D.ietf-teas-yang-rsvp-te] augments the RSVP-TE generic module
with parameters to configure and manage signaling of MPLS RSVP-TE
LSPs.
Other sample network models are listed hereafter:
o Path Computation API Model:
[I-D.ietf-teas-yang-path-computation] YANG module for a stateless
RPC which complements the stateful solution defined in
[I-D.ietf-teas-yang-te].
o OAM Models (including Fault Management (FM) and Performance
Monitoring):
[RFC8532] defines a base YANG module for the management of OAM
protocols that use Connectionless Communications. [RFC8533]
defines a retrieval method YANG module for connectionless OAM
Wu, et al. Expires April 28, 2021 [Page 40]
Internet-Draft Service and Network Management Automation October 2020
protocols. [RFC8531] defines a base YANG module for connection
oriented OAM protocols. These three models are intended to
provide consistent reporting, configuration, and representation
for connection-less OAM and Connection oriented OAM separately.
Alarm monitoring is a fundamental part of monitoring the network.
Raw alarms from devices do not always tell the status of the
network services or necessarily point to the root cause.
[RFC8632] defines a YANG module for alarm management.
A.4. Device Models: Samples
Network Element models (listed in Figure 10) are used to describe how
a service can be implemented by activating and tweaking a set of
functions (enabled in one or multiple devices, or hosted in cloud
infrastructures) that are involved in the service delivery. For
example, the L3VPN service will involve many PEs and require
manipulating the following modules:
o Routing management [RFC8349]
o BGP [I-D.ietf-idr-bgp-model]
o PIM [I-D.ietf-pim-yang]
o NAT management [RFC8512]
o QoS management [I-D.ietf-rtgwg-qos-model]
o ACLs [RFC8519]
Figure 10 uses IETF-defined data models as an example.
Wu, et al. Expires April 28, 2021 [Page 41]
Internet-Draft Service and Network Management Automation October 2020
+------------------------+
+-+ Device Model |
| +------------------------+
| +------------------------+
+---------------+ | | Logical Network |
| | +-+ Element Model |
| Architecture | | +------------------------+
| | | +------------------------+
+-------+-------+ +-+ Network Instance Model |
| | +------------------------+
| | +------------------------+
| +-+ Routing Type Model |
| +------------------------+
+-------+----------+----+------+------------+-----------+------+
| | | | | | |
+-+-+ +---+---+ +----+----+ +--+--+ +----+----+ +--+--+ |
|ACL| |Routing| |Transport| | OAM | |Multicast| | PM | Others
+---+ +-+-----+ +----+----+ +--+--+ +-----+---+ +--+--+
| +-------+ | +------+ | +--------+ | +-----+ | +-----+
+-+Core | +-+ MPLS | +-+ BFD | +-+IGMP | +-+TWAMP|
| |Routing| | | Base | | +--------+ | |/MLD | | +-----+
| +-------+ | +------+ | +--------+ | +-----+ | +-----+
| +-------+ | +------+ +-+LSP Ping| | +-----+ +-+OWAMP|
+-+ BGP | +-+ MPLS | | +--------+ +-+ PIM | | +-----+
| +-------+ | | LDP | | +--------+ | +-----+ | +-----+
| +-------+ | +------+ +-+MPLS-TP | | +-----+ +-+LMAP |
+-+ ISIS | | +------+ +--------+ +-+ MVPN| +-----+
| +-------+ +-+ MPLS | +-----+
| +-------+ |Static|
+-+ OSPF | +------+
| +-------+
| +-------+
+-+ RIP |
| +-------+
| +-------+
+-+ VRRP |
| +-------+
| +-------+
+-+SR/SRv6|
| +-------+
| +-------+
+-+ISIS-SR|
| +-------+
| +-------+
+-+OSPF-SR|
+-------+
Figure 10: Network Element Modules Overview
Wu, et al. Expires April 28, 2021 [Page 42]
Internet-Draft Service and Network Management Automation October 2020
A.4.1. Model Composition
o Logical Network Element Model
[RFC8530] defines a logical network element module which can be
used to manage the logical resource partitioning that may be
present on a network device. Examples of common industry terms
for logical resource partitioning are Logical Systems or Logical
Routers.
o Network Instance Model
[RFC8529] defines a network instance module. This module can be
used to manage the virtual resource partitioning that may be
present on a network device. Examples of common industry terms
for virtual resource partitioning are VRF instances and Virtual
Switch Instances (VSIs).
A.4.2. Device Management
The following list enumerates some YANG modules that can be used for
device management:
o [RFC8348]: defines a YANG module for the management of hardware.
o [RFC7317]: defines the "ietf-system" YANG module that provides
many features such as the configuration and the monitoring of
system or system control operations (e.g., shutdown, restart,
setting time) identification.
o [RFC8341]: defines a network configuration access control YANG
module.
A.4.3. Interface Management
The following provides some YANG modules that can be used for
interface management:
o [RFC7224]: defines a YANG module for interface type definitions.
o [RFC8343]: defines a YANG module for the management of network
interfaces.
A.4.4. Some Device Model Examples
The following provides an overview of some device models that can be
used within a network. This list is not comprehensive.
Wu, et al. Expires April 28, 2021 [Page 43]
Internet-Draft Service and Network Management Automation October 2020
L2VPN: [I-D.ietf-bess-l2vpn-yang] defines a YANG module for MPLS
based Layer 2 VPN services (L2VPN) [RFC4664] and includes
switching between the local attachment circuits. The
L2VPN model covers point-to-point VPWS and Multipoint VPLS
services. These services use signaling of Pseudowires
across MPLS networks using LDP [RFC8077][RFC4762] or BGP
[RFC4761].
EVPN: [I-D.ietf-bess-evpn-yang] defines a YANG module for
Ethernet VPN services. The model is agnostic of the
underlay. It applies to MPLS as well as to VxLAN
encapsulation. The module is also agnostic to the
services, including E-LAN, E-LINE, and E-TREE services.
L3VPN: [I-D.ietf-bess-l3vpn-yang] defines a YANG module that can
be used to configure and manage BGP L3VPNs [RFC4364]. It
contains VRF specific parameters as well as BGP specific
parameters applicable for L3VPNs.
Core Routing: [RFC8349] defines the core routing YANG data model,
which is intended as a basis for future data model
development covering more-sophisticated routing systems.
It is expected that other Routing technology YANG modules
(e.g., VRRP, RIP, ISIS, OSPF models) will augment the Core
Routing base YANG module.
MPLS: [I-D.ietf-mpls-base-yang] defines a base model for MPLS
which serves as a base framework for configuring and
managing an MPLS switching subsystem. It is expected that
other MPLS technology YANG modules (e.g., MPLS LSP Static,
LDP, or RSVP-TE models) will augment the MPLS base YANG
module.
BGP: [I-D.ietf-idr-bgp-model] defines a YANG module for
configuring and managing BGP, including protocol, policy,
and operational aspects based on data center, carrier, and
content provider operational requirements.
Routing Policy: [I-D.ietf-rtgwg-policy-model] defines a YANG module
for configuring and managing routing policies based on
operational practice. The module provides a generic
policy framework which can be augmented with protocol-
specific policy configuration.
SR/SRv6: [I-D.ietf-spring-sr-yang] a YANG module for segment
routing configuration and operation.
Wu, et al. Expires April 28, 2021 [Page 44]
Internet-Draft Service and Network Management Automation October 2020
BFD: Bidirectional Forwarding Detection (BFD) [RFC5880] is a
network protocol which is used for liveness detection of
arbitrary paths between systems. [I-D.ietf-bfd-yang]
defines a YANG module that can be used to configure and
manage BFD.
Multicast: [I-D.ietf-pim-yang] defines a YANG module that can be used
to configure and manage Protocol Independent Multicast
(PIM) devices.
[RFC8652] defines a YANG module that can be used to
configure and manage Internet Group Management Protocol
(IGMP) and Multicast Listener Discovery (MLD) devices.
[I-D.ietf-pim-igmp-mld-snooping-yang] defines a YANG
module that can be used to configure and manage Internet
Group Management Protocol (IGMP) and Multicast Listener
Discovery (MLD) Snooping devices.
[I-D.ietf-bess-mvpn-yang] defines a YANG data model to
configure and manage Multicast in MPLS/BGP IP VPNs
(MVPNs).
PM: [I-D.ietf-ippm-twamp-yang] defines a YANG data model for
client and server implementations of the Two-Way Active
Measurement Protocol (TWAMP).
[I-D.ietf-ippm-stamp-yang] defines the data model for
implementations of Session-Sender and Session-Reflector
for Simple Two-way Active Measurement Protocol (STAMP)
mode using YANG.
[RFC8194] defines a YANG data model for Large-Scale
Measurement Platforms (LMAPs).
ACL: Access Control List (ACL) is one of the basic elements
used to configure device forwarding behavior. It is used
in many networking technologies such as Policy Based
Routing, firewalls, etc. [RFC8519] describes a YANG data
model of ACL basic building blocks.
QoS: [I-D.ietf-rtgwg-qos-model] describes a YANG module of
Differentiated Services for configuration and operations.
NAT: For the sake of network automation and the need for
programming Network Address Translation (NAT) function in
particular, a YANG data model for configuring and managing
the NAT is essential.
Wu, et al. Expires April 28, 2021 [Page 45]
Internet-Draft Service and Network Management Automation October 2020
[RFC8512] defines a YANG module for the NAT function
covering a variety of NAT flavors such as Network Address
Translation from IPv4 to IPv4 (NAT44), Network Address and
Protocol Translation from IPv6 Clients to IPv4 Servers
(NAT64), customer-side translator (CLAT), Stateless IP/
ICMP Translation (SIIT), Explicit Address Mappings (EAM)
for SIIT, IPv6-to-IPv6 Network Prefix Translation (NPTv6),
and Destination NAT.
[RFC8513] specifies a DS-Lite YANG module.
Stateless Address Sharing: [RFC8676] specifies a YANG module for A+P
address sharing, including Lightweight 4over6, Mapping of
Address and Port with Encapsulation (MAP-E), and Mapping
of Address and Port using Translation (MAP-T) softwire
mechanisms.
Authors' Addresses
Qin Wu (editor)
Huawei
101 Software Avenue, Yuhua District
Nanjing, Jiangsu 210012
China
Email: bill.wu@huawei.com
Mohamed Boucadair (editor)
Orange
Rennes 35000
France
Email: mohamed.boucadair@orange.com
Diego R. Lopez
Telefonica I+D
Spain
Email: diego.r.lopez@telefonica.com
Wu, et al. Expires April 28, 2021 [Page 46]
Internet-Draft Service and Network Management Automation October 2020
Chongfeng Xie
China Telecom
Beijing
China
Email: xiechf@chinatelecom.cn
Liang Geng
China Mobile
Email: gengliang@chinamobile.com
Wu, et al. Expires April 28, 2021 [Page 47]
