Skip to content

ONOS configuration overview

Design Objectives

gNMI provides transactionality with respect to a single target; all configuration operations specified as part of a single batch are all applied or none of them are. The core capability of the configuration platform should build on this gNMI feature to:

  • Provide ability to apply a batch of operations (via NB gNMI API) targeted at multiple targets to be performed as a transaction; either all changes are applied to all targets or none of the changes are applied to any of the targets.
  • Track configuration change transactions applied to a set of targets over time and allow rollback (via NB admin API) to previous configuration checkpoints demarcated by the transactions.

The above features are the principal objectives for the configuration management platform. Second order objectives are as follows:

  • Support high-availability and distributed operation, including rolling upgrades
  • Support networks consisting of ~50 devices (configuration targets), ~5000 ports and rate of ~10K incremental configuration transactions per day

Additional Features (to be integrated with the above)

The following set of features will be required to support the real-world use-cases, but may not necessarily be part of the code configuration subsystem and instead can be provided as additional layers:

  • Ability to preload initial configuration about targets that have not yet been discovered - or even deployed
  • Dry run capability - validate configuration with respect to model, but also with respect to existing business constraints or policies
  • Import existing device configuration
  • Configuration Intents - ability to translate high-level (possibly network-wide) configuration specifications into lower-level (device-specific) operations

Key Tenets

  • Principal northbound API for the subsystem will be gNMI.
  • These interfaces are already accepted standards and are well-defined, low-profile interfaces with support for transaction semantics.
  • YANG models that will be exposed as part of the NB API are determined by the set of configuration model plugins configured as part of onos-config deployment.
  • Enhanced northbound API will be a gRPC service providing access to administrative functionality.
  • Applications can navigate the transaction log and roll-back various changes as they were previously submitted via gNMI
  • Southbound API for the subsystem will be gNMI.
  • This will allow direct use with Stratum-compliant switches without requiring an adaptation layer.
  • Adapters can be created for devices - or configurable targets in general - that do not directly support gNMI interfaces. Such adapters can be deployed either as proxy agents or potentially can be hosted on the devices themselves.
  • Administrative gRPC service will allow for roll-back, and interacting with onos-config internal state using various remote tools.
  • The subsystem will be designed as a separate entity to allow its use with the existing ONOS 2.0 architecture and to fit with the NG ONOS architecture.

High-Level Design


Additional Documentation

Additional Resources

µONOS talks at ONF Connect 2019