|NihuiPeter Lee||HuaweiTechnologiesClearPath Networks||nihui@huawei|
|JiangchunchengJiang ChunCheng||HuaweiTechnologiesHuawei Technologiesfirstname.lastname@example.org|
|ZhaokexueLu kai||HuaweiTechnologiesHuawei Technologies||zhaokexue@email@example.com|
|kalyana@huaweiLi shuai||Huawei Technologiesfirstname.lastname@example.org|
Vinod Kumar S
|Vinods.kumar@huaweiZhou bo||Huawei Technologiesemail@example.com|
|Gaurav.agrawal@huaweiZhao ying||Huawei Technologiesfirstname.lastname@example.org|
|bharat.saraswal@huaweiYan lin||Huawei Technologiesemail@example.com|
YANG is a data modeling language, used to model configuration & state data.
Modeling languages such as SMI (SNMP), UML, XML Schema, and others already existed. However, none of these languages were specifically targeted to the needs of configuration management. They lack critical capabilities like being easily read and understood by human implementer's, and fell short in providing mechanisms to validate models of configuration data for semantics and syntax.
YANG is a preferred choice to represent interface and behavior semantics (of device/ controller/ component) because of following reason:
Human readable, easy to learn representation.
Hierarchical configuration data models.
Reusable types and groupings (structured types).
Extensible through augmentation mechanisms.
Supports the definition of operations (RPCs).
Formal constraints for configuration validation.
Data modularity through modules and submodules.
YANG modeled interfaces needs to be implemented by corresponding application /component.
There are 2 parts in implementing the interface:
a) Syntax/ Semantics processing of the request/response being exchanged.
b) the business logic to compute the request.
Implementation of syntax/ semantics processing is required. This implementation can be a manual approach wherein the data structures are manually implemented in target language. In this approach there is a scope for human error while implementation also it requires considerable efforts for implementation. Alternatively the implementation can be automated wherein these data structure are automatically generated thereby avoiding manual errors and improving efficiency.
We intend to abstract the applications from syntactical processing of information encoding with external world and provide a framework in which the applications only need to implement the business logic and seamlessly support any interface language like REST, NETCONF etc. As a part of this goal following work is proposed in Falcon and Golden Eye release.
Proposed Falcon Deliverable:
Basic YANG Utils supporting:
Basic built-In data type.
Individual YANG file support.
Sample application (with manual REST implementation)
Proposed Golden Eye Release Deliverable:
Advanced YANG Utils supporting:
Derived data types.
NBI REST framework automation including:
Automated APP URI registration.
Automated JSON CODEC implementation.
Sample application (with automated REST implementation)
YANG Utils Translator Details:
YANG Utils are the basic building block to achieve the final goal of abastracting the language based Syntax/Semantics processing by APPs. These UTILS intend to have following:
- YANG Parser for parsing YANG file.
- Translator tool for auto-generation of JAVA corresponding to a given YANG.
- Metadata generation which will be an input for NBI/SBI automation.
REST NBI Automation Details:
With the current REST mechanism, every APP must perform the Manual Rest Registration and implement the manual CODEC function, thereby slowing down the APP development and increasing chances for manual error. Current REST NBI Mechanism is depicted in below figure:
As a part of this project we intend to model the NBI Interface and augment the REST NBI Framework to Automate the URI Registration and CODEC Implementation, thereby reducing manual error and faster application development. Proposed REST NBI Mechanism is depicted in below figure:
Benefit & Impact Analysis:
Benefit to Service Provider
Modeled based Services/Network Visibility
YANG based Standard Interface Representation.
Seamless Standard YANG based Application Adaptation.
Benefit to ONOS Developers
Smaller Learning Curve
Provides Faster APP Development.
Better Quality due to Automation.
Modeled based application interface.
Impact on Existing System
Augments the existing work.
No impact on existing system.
Long Term Objective:
Abstraction and Automation of:
- NBI framework where in application's can seamlessly support any NBI interface.
- NETCONF SBI framework. (Extend support to ONOS NETCONF team with metadata and class generation).
- Driver Behavior.
High Level Architecture Overview
You can visit YangFore github repository.
It is a internal application in ONOS.
L3VPN Demo Application
The demo application is actualized using YangForge and based on following IETF YANG models:
- https://www.ietf.org/id/draft-ietf-l3sm-l3vpn-service-model-01.txt (published August 2015)
L3VPN YANG Model Sample
Requirements for YANG Utils