Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


This page is intended to capture the ongoing study and discussion in the Ext-API project related to the inter-CSP interaction enabled through the MEF interlude specification. This is related to the JIRA item planned in the Casablanca cycle. While it is essential to carry out a detailed study on the inter-provider interactions and overall impact on ONAP as a solution, the scope of this page will be limited to the impact on External API. Additionally, while the focus is on the MEF interlude specification, there is some good amount of work being done in many SDOs to address the scope of inter-provider management interactions - notably TMForum, ETSI, NGMN, ONF, IETF etc. It is worth noting the scope and outcome of these SDOs and analyze some best practices that ONAP can incorporate. It is also worthwhile to note how other opensource communities like OSM, 5GPPP/5GEx etc tackled this issue. Further, the page also captures the short term and long term requirements to support Interlude like inter-provider interaction.

...

Expand
titleInter-Provider API Overview

Overview

MEF LSO defines a set of specifications and reference points aimed at providing end to end service orchestration across multiple network domains using standardized APIs. One of the reference points in this set is interlude which focuses on providing control related management interactions between service provider and partner (link). The other inter-provider reference point in LSO is SONATA which mainly focuses on the OSS/BSS level business interactions. As ONAP is not specifically on the SONATA level of interactions, the rest of the document focuses mainly on the interlude reference point in MEF and similar specifications in other standard organizations. While interlude is one of the reference point and specification which addresses inter-provider interaction, it is worthwhile to look at the broader scope considering typical operational, business use cases and aspects impacting such interactions in ONAP External API specifically and ONAP in general. MEF Interlude scope is covered in detail in a separate section.

MEF LSO Reference Points

5GExchange (link) as part of 5GPPP is one of the relevant project worth referring which focuses on "cross-domain orchestration of services over multiple administrations or over multi-domain single administrations" (link). 5GEx project defines a multi-domain logical interworking architecture which covers multi-operator interaction and multi-domain interaction within the same operator. As part of the 5GEx project a detailed study is being conducted around inter-domain and inter-provider interactions and results are published here. The 5GEx proposed system consists of multi-domain orchestrator (MdO), domain orchestrators and interactions between MdO (marked as #2 in the diagram below), the interaction between MdO and Domain orchestrators (marked as #3 in the diagram), the interaction between customer and MdO (marked as #1), interaction between Domain Orchestrators and controllers (marked as #5) and interaction between domain orchestrators (marked as #4). Each of these interactions is identified by different types of interfaces. There is also a classification based on business level interactions, management/orchestration level interaction, control level interactions, and data level interaction. Out of these #2 is the one which close matches the MEF interlude reference point, but the scope is slightly different because in 5GEx project business, management/orchestration related interactions are expected to be handled by the same interface (i.e #2). While #3 (between MdO and DO) is quite relevant in the case of External API, this may be an item for future study as domain orchestration concept is currently under discussion in ONAP Tiger team as of September 2018. For the sake of this document, MdO is functionally mapped to the External API component in ONAP as it is providing an end to end service management capability.

Image Modified


Following diagram captures the interface mapping to standards as defined by 5GEx in their functional model found here

Looking at the picture above, it can be observed that 5GEx mostly follows the ETSI MANO specific interfaces for interactions across MdOs or between MdO and DO. But the picture also includes some additional scope as listed below

  • Topology distribution across domains for exchanging network topology details that may be used by MLPCE.
  • Multi-domain path computation engine interaction across domains for exchanging path specific data
  • SLA Management interaction across domains for exchanging business agreement.
  • Service Catalogue interactions across domains for exchanging service specifications

Summarizing the scope in5GExproject, its key focus is in virtualized infrastructure with ETSI MANO building blocks with additional scope for exchanging the network topology, network path, business agreement and service specification across different domains. For ONAP Ext-API this may not be quite relevant as itfunctionsatalayer above the NFVO. However, if External API scope is expanded to have cross-layer interaction, i.e MdO of one operator domain interacting with DO of another operator domain 5GEx specific interfaces may be relevant. But what can be learned from the 5GEx project is the concept of SLA Management, Catalogue exchange, Security mechanisms and approaches for supporting use cases such as Slicing.

The topic of inter-provider/inter-domain interaction is being discussed in TMF ODA, ETSI ZSM, but these specifications are still in the early stages of development and may not be relevant in the near future of ONAP development.

Another specification worth referring is ETSI IFA 028 v3.1.1 - wherein MANO architectural options to support multiple administrative domains is being discussed. This specification introduces two concepts - MLPOC (Multiple Logical Point of Contact) andSLPOC (Single Logical Point of Contact) with varying degrees of cross-layer interaction and information abstraction across domains. This specification also defines an Or-Or interface across NFVOs in different administrative domains. Assescribed in the case of 5GEx, ETSI Or-Or level interaction may not be

ETSI IFA028 architecture option to support multiple administrative domains

Subsequent sections in this page cover a comparison of different SDO/OSSP activities around inter-provider APIs.

Multi-domain Interaction

As defined in 5GEx project multi-domain can be multiple network operators or it can be multiple subdomains within a single operator. The scope of interaction might be slightly different within single operator domains and across multiple operators because the latter will be governed by SLAs with strict policies and predefined trust/contract between the two operators. So security and trust are some of the key criteria for interaction across multiple parties. All interaction should be governed, policy controlled based on the trust agreement. Within the same operator domain, there can be multiple administrative domains which can be governed by SLO/OLOs and trust agreement as in the case of inter-provider interaction. But there can also be a model of distributed deployment which may not fit into the purview of multi-domain interaction. For example, geo-redundancy and HA deployments may not be classified as multi-domain interaction, but governed mostly by policies defined between two software components and interaction over internal APIs.

Federation and Delegation

Similar to multi-domain interaction, federation and delegation are two terminologies used for interaction between two logically separated endpoints. While there is no standard terminology defined at the ONAP level, we can assume federation to be the east-west interaction between systems/components at same logical domains- for example between Orchestrators in two administrative domains, or controller in two administrative domains. The delegation terminology can be associated with the interactions between systems/components at different logical domains- for example, an end to end orchestrator interacting with a domain orchestrator. Federation and Delegation can be classified with reference to the diagram above from 5GEx. Interactions marked 2 can be classified in federation and interaction marked 3 and 5 can be classified as delegation. Here the federation is across domains of different operators, whereas delegation is between the same operator domains. Another differentiator is that federation is between logical domains with similar scope whereas delegation is between logical domains with a different scope. The logical separation can be based on the technology abstraction, geographic abstraction or deployment model. One example of the federation model is the interactions in the CCVPN use case an example of the delegation model is interaction possible between the central site and edge site orchestrators in an edge automation use case.

In the ETSIIFA028there are two models of inter-administrative domain interactions -SLPOC (Single Logical Point of Contact) and MLPOC (Multi Logical Point of Contact). In SLPOC there is a single interaction point between two administrative domains whereas in MLPOC there are multiple interaction points between administrative domains. In simple terms, it is possible based on ETSI MLPOC model for NFVO in one administrative domain to interact with VNFM or VIM in another administrative domain over the ETSI interfaces. Since External API functions at a layer above NFVO, the current scope of interaction is limited to the federation model described above -i.einteraction between External API in two operator domains.

The delegation model support in External API requires further discussion based on specific use cases. There is also discussion around Recursive Orchestration, Orchestration Hierarchy and Domain Orchestration. The delegation model can be considered within the scope of External API once some concrete decision is made by the Architecture team. For the current scope, only the federation model is considered.

Business Agreement and Policy

MEF Interlude does not have a specific scope for managing the Business Agreement between SP and Partner, however, the interaction between the parties might be governed and controlled based on the predefined business agreement and associated policy rules, security mechanism. 5GEx document on Business and Economic Layer (link) elaborates this aspect in detail but limits the focus on the SLA between parties. Some interesting aspects to be considered for Interlude are as follows

  • Roles of the parties (SP and Partner) which will determine the mode of communication, specific controls required at either end, Policies to be enforced, the direction of communication (Some examples given for the 5G case are - Infrastructure Service Provider, Network Service Provider, Communication Service Provider, Over the top service provider, Exchange point service provider . The roles defined by 5GEx are mostly inspired by those defined by 3GPP 28.801.
  • Centralized vs Distributed Interaction: The interaction between parties can be centralized i.e coordinated by an aggregator provider acting as an exchange point between parties or it can be one to one. The aggregator model is better as it will avoidneedfor multiple business agreements while ensuring centralized enforcement SLA and policies
  • Coordination model: Consists of two phases - publishing phase where information is exchanged between parties on the offered services and service composition phase when the actual customer request for a service is forwarded from one party to other. In the case of Ext-API this will be translated to a query on the other parties Service Catalog and initiation of service Configuration/Control Request
  • Agreement Push vs Pull Model: In Pushmodelthe Business Agreement and policies are predetermined/agreed before any interaction between parties over the inter-provider APIwhere asin pull model business agreement is dynamically decided based on the customer request and required SLA, monitoring levels.

The 5GEx project defines Business Agreement in terms of SLA and the document referred at the beginning of this section also gives a template for defining SLA. For ONAP Ext-API this may not be useful as it currently does not have any referenceable entities for defining policies for interaction between parties, which is quite relevant at the interlude level.

Other relevant SDO References for adapting Business Agreement are as follows

  • TMF B2B2X Partnering Step by Step Guide (link): Lifecycle model for B2B partner management, templates for B2B agreement mostly focused on the business layer, but the operating agreement may be relevant for defining the interlude policies
  • Recent ONS presentation on BlockChain based inter-operator agreement implemented based on HyperLedger (link)

For External-API project a new set of APIs needs to be defined for the Business Application layer to push the policies for interacting with the partner. In the absence of this API, it may be assumed that Ext-API will consult the Policy Engine in ONAP for determining the control mechanisms that need to be established before interacting with the partner over the inter-provider API.


Cross-layer Interaction

IN MEF LSO, the interlude reference point is between SOF in Service Provider domain and Partner Domain. If this principle is strictly followed the interaction can be confined to External API level or External API+SO combined. i.e SOF functionality can be assumed to be fulfilled using Ext-API and SO as a unified block. However, in practical deployments, there may be scenarios which might require cross-layer interaction, for example, MLPOC proposed in ETSI IFA028 wherein the Orchestration function in one domain interacts with VIM or VNFM in another domain. The multilayer interaction might also be possible in a hybrid orchestration scenario wherein the Virtualization and Non-Virtualized domains might have to interact at different levels - for example, a MEF LSO compatible system needs to interact with a non-MEF LSO compatible system. One more practical case is the domain orchestration scenario wherein different logical domains interact with each other. This is a wider consideration and decision requiring input from architecture subcommittee and EUAG.

Another aspect of inter-operator cross-layer interaction is cross-layer data reconciliation say at the inventory level or at the assurance level assuming the cross-layer interaction is permissible as per the business agreement and requires for efficiency. But this aspect is outside the scope of the interlude and may be a topic for wider discussions across SDOs.

For the scope of External API in the short term it is assumed that the cross-layer interaction is limited to the interaction between two systems in SP and Partner domains at least one of those is Ext-API component and other one is the entity which is logically equivalent in functionality and having permissible scope and APIs as defined in the MEF interlude specification and compatible with the Agreement between the two parties (SP and Partner)

Design Time Impact

TBD

Representation of Partner in Inventory

TBD

Service Assurance

TBD

Connectivity to Partner

TBD (MSB extension, REST API Call, ESR)

S3P Requirements

TBD

Service Impact Assessment

As per the MEF 55 interlude scope of Service Configuration and control, there may be an impact on service if it is already in an Active state. There shall be a need to carry out a service impact assessment before initiating the Service Configuration and Control. This is typically done in operational environments by placing a work order and associated workflows will carry out the impact and corrective rerouting and roll back measure before actually initiating the Service Configuration or Control. This is very specific to the use case and it also depends on whether the service configuration and control is service impacting or not. In the current MEF 55 scope, a dedicated change management is not scoped. However, in the ONAPExt-API scope this may be one of the prerequisites that need to be initiated before or along with any operation over the inter-provider interface. Generally, in the traditional OSS environments, any request for partner services are initiated through a work order. The need for supporting inter-provider service request through a work order needs to be assessed based on the opinion of EUAG. For Ext-API, it is assumed that the inter-provider API request may be preceded by an optional change management request, or the Service Configuration/Control Request itself may be piggybacked in the change management request.

Standard APIs

MEF Interlude is a reference point which is expected to accommodate many APIs going forward based on the scope defined. Few examples of APIs that may be suitable as per the scope in MEF 55 are as follows

  • Service Provider controls aspects of the Service within the Partner domain (on behalf of the Customer) by requesting changes to dynamic parameters as permitted by service policies. - TMF 641 Service Order Management API or TMF 640 Service Configuration and Activation Management API
  • Service Provider queries the operational state of the Service - TMF 638 Service Inventory Management API (This may be restricted in some deployment scenarios)
  • Service Provider requests change to the administrative state of a service or service component (e.g. Service Interface) - TMF 640 Service Configuration and Activation API
  • Service Provider requests update to defaulted service parameters which are allowed to be customized (policy-controlled) - TMF 641 Service Order API or TMF 640 Service Configuration and Activation API
  • Service Provider requests the creation of connectivity between two Service Interfaces as permitted by established business arrangement - TMF 641 Service Order API or TMF 640 Service Configuration and Activation API
  • Service Provider provider queries the Partner's Service Inventory for services provided by the Partner to the Service Provider. - TMF 638 Service Inventory Management API
  • Service Provider receives Service specific event notifications from the Partner - TMF 642 Alarm Management API or TMF 640/641 Service Order API (ServiceOrderChangeNotification)
  • Service Provider receives Service specific performance information from the Partner - TMF 628 Performance Management API , TMF 649 Performance Management Threshold API
  • Service Provider requests test initiation and receive test results from the Partner. - TMF 653 Service Test Management API

List of TMF Open APIs can be found here

TMF Notification Patterns - link

Information/Data Model

There are multiple models found to be relevant for inter-provider API

  • MCM aligned E-Line Service Model defined in MEF Interlude Contribution - Access E-Line Service Control Classes - 5th Draft
  • Work in progress MEF Services Common Model (link) - Initial Proposal for Work Item
  • CFS/RFS being referenced by the TMF 641 (based on SID) (link) - Currently followed by CCVPN use case

The choice of a specific model will depend on the decision of EUAG, TOSCA Task Force in ONAP. From Ext-API point of view it is expected to leverage the CFS/RFS model being referred by the TMF 641 API or the Generic Resource Model used in TMF 655 .In future as Interludespecific model in MEF and MEF Services Common Model matures appropriate mapping can be incorporated to accommodate specific service characteristics to the TMF APIs. In MEF LSO there is also NRM model being used for the Presto interface (derived from ONF). The NRM model is assumed to be out of scope for Ext-API unless there is a cross-layer interaction between SOF in SP domain and ICM in Partner domain is required.


Expand
titleMEF Interlude Scope
Use Cases

Operational Threads

Referring to the MEF 55 Operational Threads as documented here, there are two levels of interactions between service provider and partner - at the Business Application level (over SONATA reference point) and SOF level (over Interlude). The SONATA reference point is out of scope for ONAP, however, the interactions over interlude will have some dependency over the interactions on Interlude reference point. As per the operational thread given above, following are the interactions at SONATA and Interlude reference point

SONATA (BUS<->BUS)

  • Serviceability Enquiry and Quote Request/Response
  • OPTION A: Product Order Request/Response
  • OPTION B: Product Order for interfaces, network functions or connectivity

Interlude (SOF<->SOF)

  • OPTION A: Service Request for configuration of interfaces, network functions or connectivity
  • Connectivity and Performance Testing for the Partner Service
  • Reconfigure Partner Service
  • Request Performance and Fault Information for Partner Service

There are two options of interactions between SP and Partner

Option A: A product order is placed on the SONATA Reference Point and a separate Service Configuration request is sent over Interlude Reference point

Option B: Product order is placed on the SP, the business application layer creates a separate Product Order over the SONATA interface to Partner for the creation of interfaces, NF and connectivity.

The first case may be more suitable when the Service fulfillment request needs to be controlled by the Business application layer and any dynamic control need to be handled by the SOF level. Second case is more suitable when the Business application layer needs to control all type of interactions between SP and Partner.

In Casablanca release in the absence of the SONATA interface in ONAP a variant of OPTION A is being implemented without the service configuration. Additionally, the interaction is at a service order level rather than product order level. While this can continue in future releases, the scope of interlude is more focused on Service Configuration than Service Creation.

Interlude Scope as per MEF55

Referring to MEF55 document the Interlude reference point is used by Service Orchestration Functionality to request initiation of technical operations or dynamic control behavior associated with a Service with a partner network domain. The dynamic control (Service Control Orchestration) behavior is elaborated in section 8.2.3 of MEF55 as

  • Scheduling, assigning and coordinating service control related activities;
  • Undertaking necessary tracking of the execution process of service control requests;
  • Adding additional information to an existing service control request under execution;
  • Modifying information in an existing service control request under execution;
  • Modifying the service control request status, and indicating completion of a service control request;
  • Canceling a service control request; - Monitoring the jeopardy status of service control requests, and escalating service control requests as necessary;
  • Instantiating, when appropriate, an event for the billing system to capture the policy-constrained change.

MEF55 also differentiates Order Fulfillment Orchestration, Service Configuration and Activation, Service Control Orchestration. While Order Fulfillment Orchestration deals with establishing or modifying a service through the ordering process, Service Control permits the service to be dynamically changed within specific bounds described in policies that are established at the time of ordering. After a service is provisioned and established, LSO may enable Service Control to Customers/parties, such as the ability to modify attributes subject to schedule policies and service constraint policies with for example specified ranges of valid values. Service Control relates to capabilities such as turning on or off connections, throttling bandwidth or other QoS characteristics, etc.

So considering the scope in MEF55, Interlude reference point is primarily used for Service Control Orchestration. Here Service Control Orchestration is considered to be an activity enabled after service is being provisioned. So service order management is not defined in the scope of MEF Interlude but expected to be carried over the SONATA interface (Product Order Management) and Legato (Service Order Management, Service Catalog Management).

MEF Interlude Interactions

The interactions factored in the MEF Interlude Reference point are as follows

  • Service Provider controls aspects of the Service within the Partner domain (on behalf of the Customer) by requesting changes to dynamic parameters as permitted by service policies.
  • Service Provider queries the operational state of the Service.
  • Service Provider requests change to the administrative state of a service or service component (e.g. Service Interface)
  • Service Provider requests update to defaulted service parameters which are allowed to be customized (policy-controlled)
  • Service Provider requests the creation of connectivity between two Service Interfaces as permitted by established business arrangement.
  • Service Provider provider queries the Partner's Service Inventory for services provided by the Partner to the Service Provider.
  • Service Provider receives Service specific event notifications from the Partner.
  • Service Provider receives Service specific performance information from the Partner.
  • Service Provider requests test initiation and receive test results from the Partner.

The green one's are interactions currently supported in External API across SP-Partner in the CCVPN use case. In addition to the above-listed capabilities Ext-API also supports following interactions

  • Service Provider Queries the Service Catalogue for the offered Services by Partner
  • Service Provider places Service Order for a Service offered by Partner

The last two interactions are not specifically scoped as part of Service Control Orchestration in MEF55, but being supported for CCVPN use case in the absence of a SONATA interface at the Business application layer. Additionally, while Interlude scope is limited to Service Configuration and Control, the API used for the interaction across the SP-Partner can be TMF 641 - Service Order Management as this API provides an option to include multiple Service request in a single API call, unlike in TMF 640 wherein each Service request need to be split as separate API invocations. Alternately partner domain Service Configuration and Control can also be initiated through a work order supported through the TMF 655 Change Management API. However, work order based change management is not considered to be a real-time process and incurs delay based on the SLAs agreed. For the Service Control requirements, which are mostly real-time in nature, TMF 655 may not be appropriate. The selection of right API will be based on directions by EUAG architecture subcommittee.

As per the guidelines in the document here, interlude should be used for

  • Service configuration
  • Service activation, de-activation, modification, deletion
  • Service testing
  • Service assurance

Out of this service configuration scope should include

  • Setting Schedule for Configuration
  • Configuration of User Interfaces
  • Configuration of Connection
  • Configuration of Connection End Points
  • Configuration of Redundancy

Interlude Related Work Items in MEF

Following documents give details of the current work items being developed as part of MEF Interlude.

Note: To be verified by MEHMET TOY


...

Expand
titleCurrent ONAP Capabilities to Support Interlude

Current capabilities in ONAP External API with respect to Interlude Reference point is elaborated in the presentation by Adrian here. To summarize the capabilities, currently Ext-API supports following types of interactions between Service Provider and Partner (specifically in the context of CCVPN use case, but can be applied in the case of other similar use cases as well

Note: To be verified by Adrian OSullivan

  • End to End Service is Designed in SDC on SP and Partner side and independently distributed to the respective runtime environments
  • SP or Partner details are prepopulated at respective inventories (A&AI) as customer of the service
  • A service order is placed on the SP side ONAP instance using the Ext-API Service Order API (TMF 641) - using the UUI portal
  • External API decomposes the service order to individual service order items and passes the service order items as a request for service creation to SO
  • SO check the resource requirements - on encountering the SPPartner resource, a new Service Order request is constructed with information available in the SPPartner identifier in the service instantiation request
  • SO places an order directly on the Ext-API of the partner and receives a Service Instance identifier in response
  • SO keeps polling the status of Service instance until service is created/failed on the partner side
  • SO update the SPPartner instance in inventory with the service instance details

Following are some of the shortcomings in the current capabilities

  • Services need to be independently designed and distributed on either both SP and Partner side
  • SP and Partner need to be aware of the Service Specification id to be used while placing the order from either side
  • SO from SP side directly invokes Ext-API on the partner side, not following the separation of concerns - i.e ideally the Service Order management should be limited at the Ext-API layer and Ext-API should act like a gateway between SP and Partner those are governed by contracts
  • There is no contract or policy based interaction control between SP and Partner
  • The scope of interaction is limited (Placing an Order and checking the status of the Order)


...

Expand
titleOpen Questions


Operator Input

  • Do we need to consider intraoperator multi-administrative domain interaction – i.e communication across different instances of domain orchestrators (ONAP or non-ONAP) belonging to the same operator?
  • Do we need to limit the scope of Interlude to Service Control, Activation, and Configuration or include Service Order Management?
  • Do we need to come up with ONAP specific terminology? Different SDOs follow different terminology e.g. operator interoperability, domain interoperability, administrative system interoperability etc. ?
  • Catalogue and Inventory Management – Strategy for 1) onboarding the catalog with service specification across interdomain boundaries 2) Reconciliation and aggregation of inventory at each domain – Pull vs Push model
  • Service Model Impact: Service hierarchy in the Service model – i.e Composite or Nested Service, Constituent Service – How the service model is decomposed and distributed to operator and partner domains? Any pattern to follow? Or based on request attributes?
  • Cross-layer access requirement for multi-domain interaction for example Orchestration layer of SP need to interact with VIM of Partner for resource instantiation – Is this model valid (MLPOC as per ETSI IFA028 )
  • Federation vs Delegation
  • Federation Actors and Roles: What type of provider roles we should consider – (NGMN Actor Roles ? 5GEx Actor Roles etc – Infrastructure provider, Connectivity SP, Partner SP, Master/Slave), Do we also need to consider different layers of partners – infrastructure, connectivity etc.
  • Use Cases: What use cases we should consider for the interlude specification? Generic Operational use cases (Service activation, query etc)  or Specific Business use case ? (NaaS, NFaaS, Access E-Line etc) – Short term and Long Term Target?
  • Consideration for interaction between ONAP and non-ONAP (Legacy) Management system across operator domains
  • Need for including the Business layer interactions within the scope of interlude (for example dependency on Service Policy)
  • Strategy for closed-loop control (Assurance) – Who will manage? Partner managed or SP managed
  • Resiliency requirements for inter-operator management connectivity – Failover mechanisms
  • Do we need to consider interdependency of Interlude and Legato/Sonata interface? (for example contract) 
  • Service Impact Assessment
  • Need for Service Change Management
  • Dynamic or Static workflows to be supported
  • Optimization framework dependency
  • Policy Dependency Use Cases: What use cases we should consider for the interlude specification? Generic Operational use cases (Service activation, query etc)  or Specific Business use case ? (NaaS, NFaaS, Access E-Line etc) – Short term and Long Term Target?
  • Consideration for interaction between ONAP and non-ONAP (Legacy) Management system across operator domains
  • Strategy for closed-loop control (Assurance) – Who will manage? Partner managed or SP managed
  • Resiliency requirements for inter-operator management connectivity – Failover mechanisms
  • Do we need to consider interdependency of Interlude and Legato/Sonata interface? (for example contract) 
  • Service Impact Assessment - Need for doing a Service impact analysis before any operation over interlude
  • Need for Service Change Management: Interlude operations to be initiated as work order through a Change management API (e.g. TMF 655) - Is this the practical mode of operation? Or expect a more dynamic service control operation ?
  • Dynamic or Static workflows to be supported to accommodate Interlude operations (SO and beyond)

Architecture Subcommittee

  • Onboarding and distribution model for SP and Partner Service Descriptors - Controlled by separate SDC instances or by common SDC instance.
  • Catalogue and Inventory Management – Strategy for 1) onboarding the catalog with service specification across interdomain boundaries 2) Reconciliation and aggregation of inventory at each domain – Pull vs Push model
  • ONAP specific terminology: Different SDOs follow different terminology e.g. operator interoperability, domain interoperability, administrative system interoperability etc.
  • Cross-layer interaction requirement and the need to accomodate this as part of interlude scope: for example OOF layer of SP need to interact with Multi-VIM of Partner for resource utilization, SDNC of partner sharing data to DCAE of SP (both not via Ext-API interlude but inter-component APIs) – Is this model valid (MLPOC as per ETSI IFA028 )
  • Federation vs Delegation
  • Federation actors and Roles : What type of provider roles we should consider ? Infrastructure provider, Connectivity SP, Partner SP, Master/Slave), Do we also need to consider different layers of partners – infrastructure, connectivity etc.
  • Need for including the Business layer interactions within the scope of interlude (for example dependency on Service Policy), Service Creation (in the absence of Business Application)

Modeling Subcommittee

  • Service Model Impact: Service hierarchy in the Service model – i.e Composite or Nested Service, Constituent Service – How the service model is decomposed and distributed to operator and partner domains? Any pattern to follow? Or based on request attributes?
  • Representation of Partner Service and Resources , Partner Registration data, Policy, Service associations between SP and Partner in Inventory
  • Use of Allotted Network Function vs SPPartner for representing Partner Service
  • Data Model Alignment for Ext-API : TMF vs MEF vs ONAP runtime model

Project team input

  • SO: Plan for supporting Service configuration, Service change - What REST APIs to use PUT or PATCH of Service or a dedicated action
  • Policy: Representation of confguration policies for cross operator interaction, representation of constraints for scheduling operations on Interlude
  • SDC : Modelling and managing Partner services, service access points, distribution of service
  • A&AI : Representation of partner resources and services
Expand
titleDerived Ext-API Interlude Requirements (WIP)

External API Requirements for supporting Inter-Provider API

Roles / Actors

    • SP A(ONAP deployment)
      • Administrator: Manages lifecycle of Services
      • Operation Engineer: Manages operational tasks like distribution of packages, manage/process work orders
      • Designer: Onboard VNF packages and designs Service Package
      • Tester: Verifies the Service package and approves the package for distribution
    • SP B (assuming anon-ONAP deployment)
      • Administrator: Manages the lifecycle of services
      • OperationEngineer:Managesoperational tasks
    • Partner A (assuming an ONAP deployment)
      • same as for ONAP SP
    • Partner B (assuming anonONAP deployment)
      • Administrator: Manages lifecycle of Services
      • OperationEngineer :Manages Operational

Types of Interactions

General User Stories

  1. As a Designer in SP A ONAP, I shall be able to design a hybrid service with constituent services that may be realized by SP and Partner, so that I can represent services in an abstract model which may be used by the ONAP runtime environment.
  2. As a designer of theSP A ONAP I shall be able to represent the policy and security credentials in the partner service abstract model to access the partner API gateway (the equivalent of Ext-API on the partner side) so that unauthorized access to partner domain can be avoided
  3. As a designer of SP AONAPI shall be able to represent the URL of the Partner API gateway in the partner service abstract model so that reachability to partner API gateway can be ensured.
  4. As an Operation engineer of SP A ONAP I shall be able to register Partner API gateway on the A&AI Inventory so that reachability information to Partner can be configured on demand
  5. As an administrator of SP A ONAP I shall be able to query onboarded Services in the Partner Service Catalog via theSP A External API exposed REST APIs so that the correct service specification can be verified with the abstract model maintained locally
  6. As an administrator of SP A ONAP I shall be able to query the instantiated services in the Partner Service Inventory via theSP A External API exposed REST APIs so that state, configured service characteristics of the instantiated services can be verified and reconciled with the local inventory.
  7. As an administrator ofSPA ONAP I shall be able to place a request for Service Configuration on Partner API gateway via theSP A External API exposed REST APIs with appropriate Service Characteristics associated and as defined in a Service Specification, so that desired end to end service requirement can be fulfilled.
  8. As an administrator of SP A ONAP I shall be able to control and enforce the policies for accessing the Partner API gateway from SP A External API so that I can manage the ongoing operational requirements.
  9. As an administrator of SP A ONAP I shall be able to filter the API requests on SP A External API and as needed and forwarded to Partner API Gateway so that SP A runtime components are not loaded andrealtimePartner Service state can be realized and reconciled.
  10. As an administrator of SP A ONAP I shall be able to register for Service notification on the Partner API gateway for receiving any notifications related to Service Configuration and Control Request so that requests placed on the Partner domain can be monitored in an asynchronous manner
  11. As an administrator of SP A ONAP I shall be able to manage life cycle of collectors for receiving the performance related statistics (this can be SLA update) from the Partner API gateway so that performance metrics associated with Partner Services can be collected on demand

Service Configuration and Control Stories

  1. As a designer of SP A or Partner A ONAP, I shall be able to identify and represent service characteristics that can be modified on demand so that any unnecessary service impacting changes can be avoided
  2. As a designer of SP A or Partner A ONAP, I shall be able to identify and represent service characteristics which are service impacting so that unnecessary service impacting changes can be avoided
  3. As an administrator of SP A ONAP I shall be able to schedule Service Configuration request through SP A External API to be executed and forwarded to Partner API gateway so that I can ensure optimal execution of request based on the desired condition.
  4. As an administrator of SP A ONAP I shall be able to lock or unlock a partner service configuration and control through SP A External API REST API so that any service impacting Service configurations can be avoided
  5. As an administrator of SP A ONAP I shall be able to assign ownership of the Partner Service (Partner owned, configured or SP owned configured) to SP A or Partner so that Service updates are not carried out in a consistent manner
  6. As an administrator of SPA ONAP Is hall be able to activate or deactivate a Service on the Partner domain via theSP A External API exposed REST APIs so that the partner services can be used during desired period and desired condition.
  7. As an administrator of SP A ONAP I shall be able to check the status of a Service Configuration and Control request placed on the Partner API gateway in an asynchronous manner so that state of the service can be updated in inventory
  8. As an administrator of SP A ONAP I shall be able to retry a Service Configuration and Control request on the Partner API gateway or recover from error by executing a predefined recovery logic so that Service jeopardy condition can be mitigated.

S3P Requirements


Component Specific Requirements
ONAP ComponentRequirement No




...