USE CASE

5G Service Modeling		REQ-320 - Getting issue details... STATUS
	Modeling STORY Jira	MODELING-369 - Getting issue details... STATUS
Architecture Sub-committee Jira tracker		ONAPARC-575 - Getting issue details... STATUS
Base 5G Svc Modeling		5G Use Cases in R6 Frankfurt

BUSINESS DRIVER

This section describes Business Drivers needs.

EXECUTIVE SUMMARY - This requirement introduces platform information model enhancements to document new ISOMII experimental classes from 3GPP TS28.541, the 5G Network Resource Model (NRM). The purpose of this use case is to introduce the necessary changes into the ONAP platform architecture so that it can be prepared to accept and work with a real live 5G RAN DU (for a gNB). Presently, this may mean introducing a generic application model defined in CDS. This model would then integrate the 3GPP 5G NRM so that ONAP components and micro-services could access the information in a 3GPP format without needing to overhaul the Platform Information Model.

BUSINESS IMPACT - The requirement, is a critical because it will serve to lay the ground-work for actually "turning on" a real 5G DU (PNF) that might be installed by a Vendor.

BUSINESS MARKETS - This project applies to any domain (wireless, transport, optical, and wireline) that ONAP may manage.

FUNDING/FINANCIAL IMPACTS - Without the groundwork laid down for information model management of a 5G Service, operators will not be able to "turn on" a real live 5G network using "live" PNF resources. No Network. No Business. High OPEX impact.

ORGANIZATION MGMT, SALES STRATEGIES - There is no additional organizational management or sales strategies for this use case outside of a service providers "normal" ONAP deployment and its attendant organizational resources from a service provider.

DEVELOPMENT STATUS

PROJECT	PTL	User Story / Epic	Requirement
A&AI	James Forsyth	NO IMPACT
AAF	Jonathan Gathman	NO IMPACT
APPC	Takamune Cho	NO IMPACT
CLAMP	Gervais-Martial Ngueko	NO IMPACT
CC-SDK	Dan Timoney	NO IMPACT
DCAE	Vijay Kumar	NO IMPACT
DMaaP	Mandar Sawant	NO IMPACT
External API	Matthieu Geerebaert	NO IMPACT
MODELING	Hui Deng	EPIC #1 Modeling work to adapt 3GPP TS28.541 NRM
Multi-VIM / Cloud	Bin Yang	NO IMPACT
OOF	Shankaranarayanan Puzhavakath Narayanan	NO IMPACT
POLICY	Pamela Dragosh	NO IMPACT
PORTAL	Manoop Talasila	NO IMPACT
SDN-C	Dan Timoney	NO IMPACT
SDC	Ofir Sonsino	NO IMPACT
SO	Seshu Kumar Mudiganti	NO IMPACT
VID	ittay	NO IMPACT
VNFRQTS	Steven wright	NO IMPACT
VNF-SDK	victor gao	NO IMPACT
CDS	Yuriy Malakov	NO IMPACT

List of PTLs:Approved Projects

*Each Requirement should be tracked by its own User Story in JIRA

USE CASE DIAGRAM

Use cases define how different users interact with a system under design. Each use case represents an action that may be performed by a user (defined in UML as an Actor with a user persona).

USE CASE FUNCTIONAL DEFINITIONS

Use Case Title	5G Service Modling
Actors (and System Components)	N/A, Modeling work
Description	This use case will lay the groundwork to introduce and open the discussion with the modeling sub-committee for the platform information modeling work to allow ONAP to integrate with a real "live" 5G DU Base station (PNF) The RAN (wireless) 5G base station network resource model is driven by the 3GPP standard: TS28.540 and TS28.541, the 5G NRM. This standard is used by all 5G vendors for their PNFs (DUs) which serves as a starting point to think about modeling work as it is common to all vendors. ONAP will not necessarily need to know or work with all of the ~300 parameters described in the standard, but rather should introduce a common "core" model into the ONAP platform release information model, so that other future use cases and applications can introduce model information in an orderly fashion. In R7, the OOF/SON/PCI and End-to-End Network Slicing use cases will leverage the work to introduce this common "core" model. Note that, these use cases ARE domain specific, to network wireless / radio access networks. So some thought should be given as to how to introduce domain-specific modeling into ONAP such that it can still serve many other domains with full functionality given to each of those domains.
Points of Contact	Benjamin Cheung , guochuyi
Preconditions	N/A - this use case is modeling work only
Triggers / Begins when	N/A - this use case is modeling work only
Steps / Flows (success)	N/A - this use case is modeling work only
Post-conditions	N/A - this use case is modeling work only
Alternate / Exception Paths	N/A - this use case is modeling work only
Related Use Cases	End-to-End Network Slicing Use Case: E2E Network Slicing Use Case in R7 Guilin OOF/SON/PCI Use Case:
Assumptions	N/A - this use case is modeling work only
Tools / References / Artifacts	N/A - this use case is modeling work only

3GPP MODELS

GENERIC INFORMATION MODEL FOR 5G SERVICE

This information is taken from this template: Generic Information Element Template

should be copied in the Parent Page (CNF Modeling Workspace) for each Information Element to be defined.

Information Element Template (one table for each Information Element)

Information Element Name

Name of the Information Element (to be determined) (Discuss with Modeling Team)

Points of Contact

Information Element Main Contact: Benjamin Cheung

Information Modeling Contact: Benjamin Cheung guochuyi Swaminathan Seetharaman

Schema Definition Contact: Benjamin Cheung

Related Use Cases

The E2E Network Slicing Use Case

WIKI: E2E Network Slicing Use Case in R7 Guilin

and OOF SON PCI Use Case are related use cases that all use the 3GPP TS28.541 5G NRM:

WIKI: R7 OOF SON Use Case

Participating ONAP Components

OOF SON PCI Handler Micro-Service, End to End Network Slicing (Micro services)

(With the Generic Application Model) in CDS

Related JIRA

The related Modeling JIRA is here: MODELING-369 - Getting issue details... STATUS

Description

The purpose of this use case is to introduce the necessary changes into the ONAP platform architecture so that it can be prepared to accept and work with a real live 5G RAN DU (for a gNB). Presently, this may mean introducing a generic application model defined in CDS. This model would then integrate the 3GPP 5G NRM so that ONAP components and micro-services could access the information in a 3GPP format without needing to overhaul the Platform Information Model.

Related Standards & Industry Activities

Related Industry Standards are here:

STANDARD	DESCRIPTION LINK
3GPP TS28	Main 3GPP TS28 series link: https://www.3gpp.org/DynaReport/28-series.htm
3GPP TS28.532	Management & Orchestration https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=3427 Document itself: 28532-g40.doc
3GPP TS28.540	This is the 3GPP Standard forum Management & Orchestration 5G Network Resource Model (NRM) Stage 1 The URL: https://itectec.com/archive/3gpp-specification-ts-28-540/
3GPP TS28.540	28540-g00.doc
3GPP TS28.541	This is the 3GPP Standard forum Management & Orchestration 5G Network Resource Model (NRM) Stage 2 and Stage 3 The URL: https://itectec.com/archive/3gpp-specification-ts-28-541/
3GPP TS28.541	5G NRM (document itself) 3GPPTS28541-f40.doc
3GPP TS28.620	Federated Network Information Model (FNIM) Umbrella Information Model (UIM) https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=1539
3GPP TS28.622	Generic NRM https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=1541 Document itself: 28622-g40.doc
3GPP APIs	https://forge.etsi.org/rep/3GPP/SA5/data-models

Attributes

There are hundreds of parameters in the 5G NRM from the above standards.

A spreadsheet of all of the parameters are compiled in this spreadsheet:

Relationships

RUN TIME - (SO, CDS, PRH). PNFs that need to be instantiated in 5G Services (associated resources for a service).

RUN TIME - (OOF SON PCI Use Case) - The PCI Micro-service will need the PCI values in the 5G NRM.

Originator

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

The PNF or VNF will generate (and own) the information. This information is created outside of ONAP.

The information is used by the micro-services. For example the OOF SON PCI Micro-service will use the repository of 5G Data from the C&PS Database.

Consumers

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

RUN TIME - (OOF SON PCI Use Case) - The PCI Micro-service will need the PCI values in the 5G NRM.

RUN TIME - (E2E Network Slicing Use Case) - Slicing models, objects and parameters from 5G NRM (TS28.541)

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

The following table shows the E2E NS parameters & classes needed:

Producers

Who updates this information inside of ONAP? ANSWER: A user would load the Generic Application Model. CDS would update this information inside of ONAP. A user would specify a domain specific model to use.

Under what conditions do they update it? ANSWER: In design time, if the designer determined that a resource will be using the Generic Application Model, they can choose to update it with a domain specific model. The detailed description of information (classes, attributes) can be obtained in the 3GPP TS28.541 standards that can be retrieved from the links above.

Steward

Where will this information stored and maintained? ANSWER: This model information would become a part of the CDS repository. During design time, CDS would be used to load a domain specific model

Impacted APIs & Schemas

ANSWER: With the Generic Application Model Solution, CDS Platform component will need to be updated and its APIs may be impacted.

CDS would load the Generic Application Model and populate it with a standard defined model, for example, the 3GPP 5G NRM.

CDS would have an impacted ONAP schemas & API updated

Information Modeling Status

This is scheduled in the R7 Modeling planning page. The Wiki page: ONAP R7 Modeling High Level Requirements

It is being tracked by the Modeling-369 Jira which can be found here: MODELING-369 - Getting issue details... STATUS

Status: It is active for the current release, this use case has been accepted. The model is being developed.

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

This use case is in the R7 Release planning. The Wiki Page is at: Guilin Release Requirements

It has a TSC Priority of 0 (Go)

PRESENTATIONS & RECORDINGS

The following are presentations made for the 5G Service Model

Presentation & Date	Recording	Forum
31 Aug 2020 R8 Presentation	R8_5GServiceModeling_202008Ag31.mp4	Honolulu release - functional requirements proposed list
31 Aug 2020 R8 Presentation	202006Jn25DDF-ConfigurationPersistencySvcOverview.m4a	Honolulu release - functional requirements proposed list
31 Aug 2020 Slides for R8	R8-5GServiceCreation_2020Ag31v4.pdf	Honolulu release - functional requirements proposed list

SUPPORTING FILES

Topic	File
5G Service Modeling (April 2020)	R7-5GServiceCreation.pptx
5G Service Modeling Slides Updated 20 Jul 2020	R7-5GServiceCreation_2020Jy20v2.pptx PDF Version: R7-5GServiceCreation_2020Jy20v2.pdf
3GPP TS28.541 5G NRM	3GPPTS28541-f40.doc
5G Service Modeling Slides Updated	R7-5GServiceCreation_2020Ag03v3.pptx R7-5GServiceCreation_2020Ag03v3.pdf
3GPP TS28.541 5G NRM Parameter Analysis	3GPPTS28541_01Jn022020.xlsx
5G Service Modeling Slides updated from 20 Aug 2020 call and 21 Aug 2020 C&PS call	R8-5GServiceCreation_2020Ag20v4.pptx R8-5GServiceCreation_2020Ag20v4.pdf
slides from Sept 14	R8-5GServiceCreation_2020Sp14v5.pdf

MEETINGS

Meetings	Attendees	Recording	Audio Only
16 Jul 2020	Benjamin Cheung Alessandro D'Alessandro guochuyi Swaminathan Seetharaman Anatoly Andrianov [Nokia] Ankit Chhimtwal Sangeeta Nitin Bellara Scott Mansfield Zu Qiang Kevin Mcdonnell Andy Mayer	zoom_202007Jy15.mp4	audio_only202007Jy15.m4a
20 Jul 2020	Modeling Sub-Committee call & discussion in Wiki: ONAP R7 Resource IM Call 2020-7-20	(recording at Wiki)	(recording at Wiki)
20 Aug 2020	Benjamin Cheung Jacqueline Beaulac [Ericsson]	zoom_202008Ag20.mp4	audio_only_202008Ag20.m4a
17 Sep 2020	Benjamin Cheung Tony Finnerty Steve Liu Timo Perala Andy Mayer N. K. Shankar Jacqueline Beaulac [Ericsson] Fernando Oliveira Xin Miao (Unlicensed) guochuyi Zu Qiang	202009Sp17-5GSvcModel.mp4	202009Sp17-5GSvcModelaudio_only.m4a
	AGENDA: 17 Sep 2020 Continued discussion about the C&PS Registry Service, Progress on an Application Model (potentially into the Platform Information Model), E2E Network Slicing & OOF/SON/PCI U/C & Base Modeling efforts. The R8 plan ahead & ONAP R8 Modeling High Level Requirements Action Items to Close for Modeling, VNF-RQTS, and SDC
15 Oct 2020	Benjamin Cheung

TESTING

Current Status

Testing Blockers
High visibility bugs
Other issues for testing that should be seen at a summary level
Where possible, always include JIRA links

END TO END FLOW TO BE TESTED

TEST CASES AND STATUS

1	There should be a test case for each item in the sequence diagram	NOT YET TESTED
2	create additional requirements as needed for each discreet step	COMPLETE
3	Test cases should cover entire Use Case	PARTIALLY COMPLETE
4	Test Cases should include enough detail for testing team to implement the test	FAILED

Browser not supported