SDNC R9 Istanbul Architecture Review

Project Overview

SDNC is a network controller based on CCSDK, which provides most of the base functionality used to implement the network controller. The SDNC project assembles those components, adding real-time configurable service logic (aka directed graphs) to implement network controller instances or "personas".

New component capabilities for Istanbul, i.e. the functional enhancements.

The following table lists the new functional requirements CCSDK/SDNC is committing to support for the Istanbul Release:

Minimum Viable Product

The following epics represent the minimum viable product of the CCSDK/SDNC Istanbul Release:

The following epics are also in scope for Istanbul, but are not considered of the minimum viable product.  In the event of unanticipated resource constraints, these could be reduced in scope or deferred without impacting any functionality deemed by the TSC as critical for Istanbul.

These requirements require enhancements to existing CCSDK/SDNC functionality, as opposed to new interfaces. 

New or modified interfaces

For Istanbul, we plan to provide 2 implementations of GENERIC-RESOURCE-API:

• The current implementation, implemented as an OSGi feature deployed in the OpenDaylight karaf container.
• A new springboot-based microservice, which runs in a pod outside of OpenDaylight

We plan to test both versions in the Istanbul release to validate that the springboot-based implementation is a fully backward compatible replacement.  If successful, the ODL version of GENERIC-RESOURCE-API will be deprecated in the Istanbul release and removed in Jakarta.

If they are modified, are they backwards compatible?

Yes.  Care is taken to ensure backwards compatiblity:

• Any new fields added are declared as optional, with reasonable defaults assigned, so that version N of CCSDK/SDNC can be used with version N-1 of its interface peers.

Interface naming (point to an example)

CCSDK provides the following APIs which are exposed by SDNC:

• ASDC-API : RESTCONF interface used to process certain non-TOSCA artifacts distributed by SDC (license model updates).
• dataChange : RESTCONF interface pub/sub interface that allows controller to be notified on data change events (note: not currently used in ONAP use cases)
• LCM : RESTCONF interface used to handle LifeCycle Management events
• SLI-API : RESTCONF interface to service logic interpreter.  Used primarily for health check.
• selfservice-api : gRPC interface used with CDS
• oofpcipoc-api : RESTCONF interface used for OOF/PCI integration

SDNC itself also provides the following interfaces, not found in CCSDK:

• GENERIC-RESOURCE-API : supports assignment of network resources, via automation and preloaded data]

Reference to the interfaces.

All APIs have Swagger documentation, which is referenced in readthedocs

What are the system limits?

Due to limitations inherent in OpenDaylight clustering - which is based on akka - SDNC should always be run with an odd number of replicas. This is needed to guarantee there can be no "ties" in the akka leader election procedure.

Involved use cases, architectural capabilities or functional requirements.

SDNC is used in the following use cases:

• vFW
• vDNS
• vCPE
• VoLTE
• CCVPN
• 5G
• BBS

Listing of new or impacted models used by the project (for information only).

None