OpenDaylight Controller:Config:Design
Contents
Config subsystem
This page contains documented design for the config subsystem.
Core
Config subsystem core consists of 2 modules:
- config-api - containing base API definition for config subsystem.
- config-manager - implementation of config-api that uses JMX as its registry/storage.
More information on config subsystem can be found at Config Subsystem and Configuration process.
UML Component Diagram
Config persister
Config persister modules in config subsystem contain:
- API for config persister
- XML file based storage adapter
- XML directory based storage adapter
Detailed information as well as component diagram can be found at Config Persister.
Yang JMX generator
Yang JMX generator is responsible for generating Java classes (binding) that allow a module to be managed by config subsystem. These classes serve as an interface between resources and config subsystem.
Generator consists of 2 modules:
- Yang-jmx-generator - contains metamodel for config subsystem binding. This metamodel is built on top of parsed SchemaContext from yangtools. This metamodel is also used by config-netconf-connector from netconf subsystem when transformation between XML and Open type objects is performed.
- Yang-jmx-generator-plugin - contains an implementation of CodeGenerator for yang-maven-plugin and generates the actual files from parsed metamodel.
UML Component Diagram
Config module archetype
There is a prototype of maven archetype for bundles with configurable modules. It should make the process of building "config subsystem aware" bundles easier.
Managed modules
Managed modules are config-subsystem aware components, that provide configurable modules into the config subsystem. Some of them are split into api and one or more implementations.
Threadpools
Config subsystem wrapper over java threadpools.
Netty
Wrapper over netty's utils such as Timers, EventExecutors etc.
Logback
Wrapper over slf4j logging api. This wrapper allows logback configuration over netconf/config subsystem.
Shutdown
Wrapper over a simple shutdown utility for controller. Shutdown is performed by stopping the system bundle in OSGi environment or exiting the JVM if OSGi stop fails.
Netconf config dispatcher
Thin wrapper over netconf dispatchers. (This should be probably moved to netconf)
Testing modules
Used for unit/integration testing of config and netconf subsystem.