Versions Compared

Key

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

...

TopicDescriptionWiki
Contacts

Requirements TrackingProject Management requirements Jira Ticket (clone++ of REQ-1)


Jira
serverONAP JIRA
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyREQ-322


OOF SON PCI for NFR

Jira
serverONAP JIRA
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyREQ-345

Architecture Sub-committee Jira trackerLink to Architecture Jira for Architecture sub-committee w/ presentation link

Jira
serverONAP JIRA
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyONAPARC-575

R7 Functional Requirements Page
Guilin release - functional requirements proposed list#Configuration&PersistencyServiceProject
Base Project PageCONFIGURATION & PERSISTENCY SERVICE R6
Meetings RegisterConfiguration & Persistency Service Meeting Notes & Recordings
PoC Jira REQModel Driven C&PS PoC

Jira
serverONAP JIRA
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyREQ-384

High Level Design PoCPage for the High Level Design of the Model Driven C&PS PoC (R7)High Level Design (PoC)
High Level Design PoCIssues decisions & assumptions for the C&PS PoC (R7)Issues decisions and assumptions

C&PS Portal PageConfiguration & Persistency Service Portal Page

R7 COMPONENT DESCRIPTIONARC Configuration & Persistency Service (CnPS) Component Description - Guilin (R7) Release

BUSINESS DRIVER

EXECUTIVE SUMMARY - The Data Persistency Service is a new platform component that is designed to serve as a data repository for Run-time data that needs to be persistent. As a stand-alone ONAP component, this project provides data layer services to other ONAP platform components and use cases that require persistent configuration or operational data. The R6 development will be enhanced as well.      

...

RELEASECONTENTWIKI
R6 Frankfurt
CONFIGURATION & PERSISTENCY SERVICE
R7 Guilin

Store Real-Time Configuration Data

Update Data

Access Control

Guilin release - functional requirements proposed list#RunTimeConfigurationDatabase/DataPersistencyServiceProject

Management framework (not mgmt policy to run network, ONAP mgmt policy)

Network Elements (config info, policy for NE, A1 for NE)

R8 Honolulu

Data Recovery

Model Adaptation (Dynamic Schema)


R-Future

Data Auditing

Topology Traversal

Data History

Roll-Back

Data Syncing

Performance Optimization (Scaling)


...


DEVELOPMENT STATUS (R6 Extension)

...

Use Case Functional Definitions

Use Case Title

CONFIGURATION & PERSISTENCY Configuration Persistence SERVICE

Actors (and System Components)

SDC, A&AI, C&PS, Use Cases (PCI, E2E NS, A1E, Mirror), DBMS, TSDB, xNF, DCAE, DMaaP

Description

Configuration & Persistency Persistence Service is a platform component that is designed to serve as a data repository for Run time data that needs to be persistent. It is characterized by the following.

    DATA REPOSITORY -  The types of data that is stored in the Run-Time data storage repository for:

  1.    CONFIGURATION PARAMETERS - These are configuration parameters that are used by xNFs during PnP, installation, commissioning.
  2.    OPERATIONAL PARAMETERS - These are parameters that are derived, discovered, computed that are used by xNFs during run time AFTER the xNF becomes operational i.e. AFTER it has "booted up", been installed, configured. These operational parameters are Exo-inventory information, meaning it is information that doesn't belong in A&AI.
  3.    NETWORK ELEMENT POLICY INFORMATION - NE policy type information used by micro-service.
  4.    APPLICATION INFORMATION - Information related to operational parameter.

    DATA LAKE - Architecturally, the Configuration & Persistency Persistence Service is designed to be a common services data layer which can serve as a data lake to other run time entities (ONAP components or external tools).

    C&PS FUNCTIONS - The Configuration & Persistency Persistence Service enables functionality to be performed by other entities. It will ENABLE the capability of another components or external tools within/or external to ONAP to perform the functions.

  •         CONFIGURATION MANAGEMENT FUNCTIONS - Enables OSS configuration, optimization, and LCM operations.
  •         SYNCING - The Configuration & Persistency Persistence Service enables the ability to sync data between initial and delta changes ONAP & the xNFs.
  •         DATA RECOVERY - It will allow for the recovery of data once a source of truth is defined.
  •         UPDATES - It will allow for updates, delta changes, and incremental updates to be performed.
  •         DATA HISTORY - See a history of changes in data including versioning of the data, updates, roll back, restoration, and time series management.
  •         AUDITING - Auditing of parameters against a "golden" template. It itself stores & provides the data for auditing. Consistency checks.
  •         ROLL BACK - It will allow for rollback back of entire DB to "save points" or recovery points.
  •         RESTORATION - It will allow for the recovery and restoration of data records to a fall back point.
  •         ACCESS CONTROL - A security topic, which allows the definition of policies, of who and what they can update.
  •         TOPOLOGY TRAVERSAL - It will enable the ability for something to traverse the relationship between data elements.
  •         MODEL ADAPTION - Allows for the adaptation or transformation of models from other sources (e.g. ORAN or 3GPP models).

Points of Contact

Use Case Lead: Benjamin Cheung  Tony Finnerty  Joanne Liu Rudel

Key Use Case Members: Toine Siebelink  Bruno Sakoto  theodore johnson

Code Contributors: (same as above)

Preconditions

DEPLOYMENT - The C&PS container/project is deployed and up and running.

AUTHENTICATION - Authentication is performed by C&PS to allow access and interaction with other ONAP platform components.

Triggers / Begins when

(See "Flow Step" for Design Time Activities, and Initial Database Setup below in the Steps/flows)

Steps / Flows (success)

Steps in Basic Operation and setup of C&PS.

SETUP FLOW STEPSETUP STEP DESCRIPTION
DESIGN TIME ACTIVITIES (SD&C) (SETUP)

(Design time), (Setup DB) Yang Model development E.g.: ORAN specification Yang Model in line with 3GPP. SQL structure.

SDC CSAR LISTENER (SETUP)The C&PS project listens for the Service CSAR packages which contain the schemas for resources associated with those services.

INITIAL DATABASE SETUP

(Run Time)

The C&PS Database is initially setup.
INITIAL A&AI GETALL (SETUP)Initial A&AI GetAll nodes is used to setup the existing xNFs that exist in the system
RUN-TIME OPERATIONRUN-TIME DESCRIPTION
(1) STND DEFINED VES UPDATE

(1) Standard defined VES event comes in through VES event, VES listener.

This is then published onto DMaaP and C&PS get for that topic, namespace 3GPP_Configuration to write updates to the C&PS Database.

Information coming into the C&PS via Stnd-Defined VES need to be "mapped" to the appropriate xNF and record.

(2) A&AI SYNCHRONIZATION

(2) A&AI Updates are made in order to update the existing xNF in the system

if a xNF is created or deleted the corresponding records in C&PS DB need to be created/deleted.

A&AI publishes onto DMaaP when an A&AI event occurs which updates the active xNFs available to the network.

(3) MICRO-SERVICE UPDATE(3) Micro-services can update information in C&PS DB

(4A) ONAP PLATFORM

COMPONENT INTERACTIONS

(4A) Other ONAP platform components such as the controllers might read or write information into the C&PS DB.


(4B) EXTERNAL ENTITIES(4B) External entities can interact with the C&PS DB through External API



Post-conditions

SETUP OF C&PS - C&PS database is setup with initial schema

RUN-TIME OPERATION OF C&PS - the above run-time types of actions/operations (1) - (4A/B) above in the flow steps results in updates of C&PS or the interacting entity successfully retrieving information from C&PS DB.

Alternate / Exception Paths

The following describes error cases or conditions for each of the flow steps above:

SETUP FLOW STEPEXCEPTIONS / ALTERNATE / CORNER CASES / ERRORS
DESIGN TIME ACTIVITIES (SD&C) (SETUP)Problems in SD&C
SDC CSAR LISTENER (SETUP)

If the SDC CSAR package is irretrievable from DMaaP.

If there is an Error in the SDC CSAR package

INITIAL DATABASE SETUP

(Run Time)

YANG models, schema setup problems

Setting up the C&PS DB errors.

INITIAL A&AI GETALL (SETUP)

Inability to perform A&AI GetAll

Errors in A&AI GetAll

RUN-TIME OPERATIONEXCEPTIONS / ALTERNATE / CORNER CASES / ERRORS
(1) STND DEFINED VES UPDATE

Inability to get VES event from namespace DMaaP Bus

Errors within the Stnd-Def VES event

(2) A&AI SYNCHRONIZATION

Inability to perform A&AI Event update

Errors in A&AI Event Update

(3) MICRO-SERVICE UPDATE

Inability of micro-service to update C&PS DB

Errors in C&PS DB Update

(4A) ONAP PLATFORM COMPONENT

Inability of component to update C&PS DB

Errors in C&PS DB Update

(4B) EXTERNAL ENTITIES

Inability of entity to update C&PS DB

Errors in C&PS DB Update

Errors in API/interface interaction problem.


Related Use Cases

These are associated use cases or requirements depending on C&PS

Use CaseLink or Description
OOF SON PCI Use Case

The OOF SON PCI is a 5G RAN Wireless use case spanning R3 through R7 and beyond:

R7 OOF SON Use Case

End to End Network Slicing

E2E Network slicing is a 5G RAN Wireless application

E2E Network Slicing Use Case in R7 Guilin


Assumptions

Describes any assumptions that are made for this use case

Tools / References / Artifacts

List of any tools or reference material associated with this Use Case as well as any JIRA trace-ability.

List of any associated diagrams or modelling artifacts associated with the Use Case

Configuration

...

Persistence Service Information Element

Information Element Name


Points of Contact

Authors and maintainers of the Information Element

Information Element Main Contact (typically Use Case SME)

Information Modeling Contact

Schema Definition Contact

Related Use Cases

Use Cases that have interactions using this Information Element.

Please provide a point of contact for each related Use Case.

Participating ONAP Components

The list of ONAP Components that are stakeholders for the Information Element

Related JIRAPlease provide link to related JIRA item

Description

How to inject model at onboarding.

Model-Driven Approach.

What's the minimum set that ONAP needs to know about a model in order to model & catalog.

Resource IM call and weekly C&PS

https://wiki.onap.org/download/attachments/84656758/CPS_PoC_IM_Support.pptx?version=1&modificationDate=1594025081000&api=v2


https://wiki.onap.org/display/DW/Support+for+CPS+Model+Driven+PoC


Related Standards & Industry Activities

Please refer to any standards or industry activities that should be taken into account when defining the Information Model related to this Information Element. Please provide links to relevant material.

Attributes

Attributes: Name and describe each attribute of this Information Element. Please include the datatype of the attribute if possible. Is this attribute read-only, read-write? Are there any default values?

Relationships

Relationships: Describe how this Information Element is related to other Information Elements. Also describe nature of the relationship: association, inheritance, dependency, etc. and multiplicity.

Originator

Where does this information come from? (What component initially creates it)

Consumers

Who uses this information inside & outside of ONAP?  How do they use it?

Includes description of information consumed (whole class, specific attributes, etc.)

Producers

Who updates this information inside & outside of ONAP? Under what conditions do they update it?

Includes description of information produced (whole class, specific attributes, etc.)

Steward

Where will this information stored and maintained in ONAP?

Impacted APIs & Schemas

Identify impacted ONAP schemas & APIs

Are there existing schemas be used or extended?

Information Modeling Status

What is the status of ONAP Information Modeling activities associated with this Information Element.

Please provide links to relevant wiki pages & JIRA.

Schema Definition Status

What is the status of ONAP Schema Definition activities associated with this Information Element.

Please provide links to relevant wiki pages & JIRA.

ONAP Release Priority

Prioritization for ONAP Releases

...

Link to the team's weekly discussion, attendees & Recordings

Configuration & Persistency Service Meeting Notes & Recordings


SUPPORTING FILES

ITEMDESCRIPTIONFILE

Project Proposal Presentation


TSC Project presentation

Present at TSC  


Project Proposal Presentation

Answers discussion updates

  Version)

C&PS Model Driven PoC

(Ericsson)

PoC demonstrating Model Driven management

using C&PS database

State DB (Bell Canada) PoCBell Canada Leading a PoC related to State management using the C&PS project.
Time series database mgmt

Time series database mgmt

Presented by theodore johnson

VIRTUAL DDF Presentations

C&PS Overview Presentation  

VIRTUAL DDF Presentations

Model-Driven C&PS PoC Presentation  

C&PS PoC Architecture OptionsC&PS PoC Architecture Options
C&PS V-DDF C&PS OverviewC&PS Overview Update
C&PS R8 Requirements

C&PS R8 Requirements Sub-committee proposal for  

C&PS R8 Requirements

C&PS R8 Requirements Sub-committee proposal for

  (updated 10:40 AM UTC)

C&PS R8 requirements presentation

C&PS R8 Requirements sub-committee presentation made  

C&PS R8 TSC Project proposalC&PS presentation to present at the TSC to request for a new project status
TSC Presentation

C&PS presentation to present at the TSC to request for a new project status, updated after presentation  







Testing

Current Status

...