ARC Service Orchestrator Component Description - Kohn-R11

Page Status: Updated for Istanbul - Dec 14, 2021 
Component Status: Pending PTL Updates and ArchCom Review

Last Reviewed: Dec 14, 2021 

Certified by: Dec 14, 2021 

1. High Level Component Definition and Architectural Relationships 





2. API Definitions

2a. Exposed APIs

Interface Name

Definition

Capabilities

Version

Status

Payload Model(s)

API Spec (Swagger)

Interface Name

Definition

Capabilities

Version

Status

Payload Model(s)

API Spec (Swagger)

SO-E-01

Service and Resource order requests

Service Instance management (Service, Volume Group, VF Module, VNF, PNF and CNF)

Health check, global and node.

Infrastructure provider management (Certificates, networks, sub-networks, security groups)

3.1.2

Production

Embedded in interface

Swagger,json

SO-E-02

SO maintenance requests

Monitoring of the SO BPMN flows.

Upload of new recipe war files.

8.0.0

Development and Evaluation

Embedded in interface

Monitoring_Swagger.json

2b. Consumed APIs

ONAP component wise details

Interface Name

Description

Interface Name

Description

SDCE-6

Service/Resource model notification

POE-5

Delegation of decision to policy logic

OOF-HAS

Delegation of placement decision

AAIE-1

Ingest/update state of services and resources

MCE-2

Assign and configure infrastructure resources

CONE-3

Assign and configure network resources

APPC

Assign and configure resources
(Using APPC library hosted in BPMN)
[Yang, REST, DMaaP]

VFCE-2 (SOL005)

Delegation of Network Service LCM

SOL003

Delegation of VNF LCM  to VNFM

SDCE-7

Service/Resource model query

etsicatalogAPIE-1

Catalog API

Provides catalog management interface:

  • fetch VNF package from SDC

  • fetch NS package from SDC

  • fetch Service package from SDC

  • search VNF/NS/Service

etsicatalogAPIE-2

NSD Management API

Provides NSD management interface (Align with ETSI SOL-005)

  • Create NSD Info

  • Upload NSD

  • Query NSD Info

  • Fetch NSD

  • Delete NSD

  • Create PNFD Info

  • Upload PNFD

  • Query PNFD Info

  • Fetch PNFD

  • Delete PNFD

  • Subscribe & Notify

etsicatalogAPIE-3

VNF Management API

Provides VNF management interface (Align with ETSI SOL-003)

  • Create VNF Package Info

  • Upload VNF Package

  • QueryVNF Package Info, include obtaining the VNFD

  • Fetch VNF Package

  • Fetch VNF Package Artifacts

  • Delete VNF Package

  • Subscribe & Notify

etsicatalogAPIE-4

Parser API

Provides Parse interface:

  • Parse VNF

  • Parse PNF

  • Parse NS

  • Parse Service

3. Component Description

Orchestration is the execution of various modules capabilities in harmony as a consolidated process to accomplish the desired tasks. The Service Orchestrator (SO) component of ONAP provides orchestration at a very high level, with an end to end view of the infrastructure, network, and applications.

SO's primary function is the automation of end-to-end service instance provisioning activities. SO is responsible for the instantiation and configuration of VNFs in support of overall end-to-end service instantiation, operations and management. SO executes well-defined processes to complete its objectives and is typically triggered by the receipt of service requests generated by other ONAP components or by Order Lifecycle Management in the BSS layer. The orchestration procedure is either created manually or obtained from the Service Design and Creation (SDC) component of ONAP, where all service designs are created and exposed/distributed for consumption

Internally, SO is organized as a set of modules with well defined responsibility. External adapters (SDNC, OpenStack, VFC and SOL003) encapsulate most communication with external systems. Persistence is exposed to other SO modules – not externally, by DB adapters (Catalog and Request). The underlying workflow component resides in the BPMN Execution Engine. The BPMN Execution Engine also interacts with other ONAP systems such as App controllers, AAI and OOF-HAS. Interactions with SNC are hosted by the SDC Controller. Likewise the API Request Handler exposes SOs API for interaction with clients. Finally there is also a monitoring component that allows insight into the execution state of workflows.

4. Known System Limitations

https://docs.onap.org/projects/onap-so/en/latest/release-notes.html#release-notes

5. System Deployment Architecture

https://docs.onap.org/projects/onap-so/en/latest/architecture/architecture.html



6. New Release Capabilities

The new enhancements proposed



SO deployment view



7. References

  1. Interfaces: https://docs.onap.org/projects/onap-so/en/latest/index.html#master-index