TABLE OF CONTENTS
Scope
Introduce PNF package support in ONAP for 5G and other use cases.
Proposed UC to focus on in Dublin :
- PNF Pre-Onboarding
- PNF Onboarding
Reference Presentation provided to 5G UC meeting (Nov 15th, 2018): ONAP Dublin_PNFOnboarding.pptx
Use Cases
PNF Pre-Onboarding
A vendor provided PNF package/ file archive shall be pre-onboarded in ONAP
The pre-onboarding step can be used to verify the PNF package format by VNF SDK tools
Use Case Notes
- This Use Case shall be aligned as much as possible to the ONAP VNF package pre-onboarding UC
- PNF archive is provided by a vendor and it will include PNFD (based on ETSI SOL004) and all the artifacts required by ONAP (non ETSI NFV artifacts provided managed as Non-MANO artifact (i.e. FM and PM dictionary))
PNF Onboarding
- A vendor provided PNF package/file archive can be on-boarded in ONAP
Use Case Notes
- ONAP SDC shall also continue to support PNF definition by UI as in Casablanca Release
- ONAP artifacts associated to a PNF can be stored in ONAP catalogues in order to be then utilized also at RT.
Development Status
Project | PTL | JIRA | Description | Status |
---|---|---|---|---|
SDC |
|
| PTL notified (11/19 ) Started discussions with SDC project | |
VNF SDK VNF SDK Model, Package | •VNFSDK-337: Supporting PNF package onboarding |
| VNFSDK PTL notified (12/05) VNF SDK Model, Package notified (11/30) | |
Resource Data Information Model |
| PTL notified (11/26) | ||
VNFRQTS |
|
| PTL to be notified (planned |
USE CASE ANALYSIS, SUPPORTING MATERIAL
The following material is used during Dublin timeframe as input for discussion. It is subject to updates during Dublin timeframe. A final version will be available by Dublin signoff.
PNF PRE-ONBOARDING & ONBOARDING OVERVIEW
Descriptor, Artifacts and Package Delivery | PNF Package Pre-onboarding | ONAP onboarding process, PNF Package onboarding | ONAP Design Time activities | ONAP Run Time activities | |
---|---|---|---|---|---|
WHEN | PNF delivery time | NF validation Activities | Onboarding Activities | ONAP Design Time Activities | ONAP Run Time |
WHO | Vendor | Technology Specialist | Technology Specialist Asset Manager | Service Designer Operations Specialist | Operations Specialist |
WHAT | Descriptor, Artifacts and Package delivery | PNF Package | PNF Package, PNF Descriptor PNF Onboarding | ONAP Common Information Model SDC Data Model 5G Service Definition | 5G Service Instantiation PNF Instance A&AI PNF Instance |
ETSI NFV reference | SOL001 PNFD SOL004 Package | SOL004 Package | SOL001 PNFD, SOL004 Package | - | - |
PRE-ONBOARDING: ARTIFACTS & PRODUCTS
PACKAGE DELIVERY | ONBOARDING PROCESS | DESIGN TIME | RUN TIME |
---|---|---|---|
NF Descriptor | NF Descriptor Model | SDC Data Model | A&AI PNF Data model, PNF instance |
VES event registration file/ PM dictionary | artifact | SDC Catalog | Run time Catalog |
Informational Artifacts | artifact | SDC Catalog | Run time Catalog |
Configuration Models and Files, (including Ansible Playbooks) | artifact | SDC Catalog | Run time Catalog |
Multiple artifacts can be provided by avendor in the Package. A list of the supported artifacts by ONAP will be finalized during Dublin timeframe.
Note about the picture: NF Registration stands for VES event registration file. Info model provided in the picture, just as example
DUBLIN ACTIVITIES FOR PNF PRE-ONBOARDING & ONBOARDING
DELIVERABLE | DESCRIPTION |
---|---|
NF Package | Producing and collecting NF artifacts for a NF package. Vendor provided. Dublin Priorities are the PNFD and NF Registration YAML File. |
PNF-SDK | Develop PNF-SDK (or enhance VNF-SDK) to be able to create a PNF onboarding Package. The SDK is a set of tool which can take the NF Package and create the PNF onboarding package the SDC will use. |
PNF Onboarding Package | Create a PNF onboarding package through PNF-SDK. This is the output of the PNF-SDK. |
Onboard the Package | SDC Enhancements need to be made to onboard the PNF Package and enter into the SDC Catalog |
Distribution of CSAR | SDC creates a CSAR package for the PNF including artifacts, and TOSCA definitions. This work will include the PNF artifacts into CSAR package. The CSAR package is distributed by SDC to ONAP Run-Time Components. Chances need to be made to verify the reception of the CSAR and use of the CSAR by the Components. |
PNF PRE-ONBOARDING: PACKAGE CREATION (VENDOR PROVIDED)
The NF Onboarding Package could contain the following things:
ARTIFACT | DESCRIPTION |
---|---|
PNF Descriptor | PNF Descriptor. The PNFD is a model which describes the requirements and capabilities of the PNF. The ETSI SOL 001 specification also suggests a model that can be used for a PNFD. This could be a TOSCA definition of the PNF. MANDATORY |
NF Registration | Definition of VES Events. The NF Registration is defined by the VES Registration specification. You can read about the VES Event Listener here: Service: VES Event Listener 7.0.1 MANDATORY |
Licensing | NF Licensing information that needs to be included in the Package MANDATORY |
Informational Artifacts | Informational artifacts include:
OPTIONAL |
Configuration Files | Configuration Files related to the NF for configuration management OPTIONAL |
Ansible Playbooks | Ansible Playbooks to interact with NF. These are anticipated to be used with the communication of the NF controller to the NF. This can be seen in the PNF Plug and Play Wiki: 5G - PNF Plug and Play OPTIONAL |
PNF PRE-ONBOARDING: PNF PACKAGE FILES & DIRECTORIES
The PNF Package files and directories is described in this section.
There are some "Basic" files that should be included with each PNF package. (?? what are they ??)
There (may) be some mandatory files/directories that SDC expects within each PNF package (?? to be investigated ??)
The following diagram illustrates a basic PNF package and some suggested file structure and content in the directories.
The PNF package is expected to be a CSAR package.
PNF PRE-ONBOARDING: LICENSING MANAGEMENT
The PNF package requires a license.
Similarly to the VNF package, there is a directory dedicated to License(s).
It is expected that the PNF package will also have a similar directory dedicated to Licenses.
This implies that the Service Provider has defined a licensing schema or has licensing management software to manage licenses.
It might also be possible that multiple licenses are needed for different functions or authentication.
Licensing schema is expected to be used to identify or authorize the existence a particular PNF into the network of the service provider.
It may also be important to provide a license during PNF Plug and Play.
The licensing schema could vary and be dependent upon the service provider.
For Dublin, we are expecting to put in place a simple licensing mechanism or schema as a proof of concept at least. TBD.
PNF PRE-ONBOARDING: PNF-SDK DEVELOPMENT
PNF SDK development is needed to take PNF artifacts and add them to a PNF Onboarding Package in Dublin.
We expect the PNF SDK development to be able to reuse much of the functionality from VNF SDK, format delivery, processing are all the same except HEAT deployments templates are not used (as they do not apply to PNFs).
The PNF SDK will be used to VALIDATE the PNF Onboarding Package
It is possible for a user to bring in the PNF Onboarding Package (provided by a vendor) without the use of the PNF SDK tools.
Some of the NF artifacts are created by the SDC tool.
[INVESTIGATE] What are artifacts that SDC adds during the Onboarding process, looking at SDC supported artifact types, possibly VENDOR LICENSE and MODEL INVENTORY (are there others?)
PNF ONBOARDING: PNF ONBOARDING PACKAGE LOADED
PNF Onboarding Package (vendor provided) is successfully loaded into ONAP.
PNF-D Information Model:
PNF ONBOARDING: SDC ONBOARDING PACKAGE MAPPING INTO INTERNAL PACKAGE
SDC is used to map the Vendor provided onboarding package & PNF descriptor into the Internal Package & Internal (Platform) Data Model
PNF ONBOARDING: SDC ONBOARDING PACKAGE INTO SDC CATALOG
SDC Design Studio is then used to define a Service, and the output of that is a CSAR package which defines the Service.
Enhancements to SDC to take PNF Onboarding Package into the SDC Catalog
SDC distributes services
NF CSAR package includes the artifacts and information for the resources for a service.
There is one CSAR file which includes all of the definition for that service.
The work-flows are created by SDC DS.
PNF ONBOARDING: CSAR INGESTION TO ONAP RT COMPONENTS
Inclusion of PNF artifacts into CSAR package, and ingestion of CSAR package by ONAP Run-Time Components and verification of reception and use.
The NF Package is composed of Artifacts, Definitions, TOSCA-MetaData.
SDC CSAR Package Structure
SDC Support Artifacts:
APPENDIX SUPPORTING DOCUMENTS
Supporting documents related to PNF Onboarding
ETSI SOL Standards
The following has the ETSI SOL standards for your convenience
STANDARD | FILE |
---|---|
ETSI SOL1 (PNF/VNF Descriptor) | |
ETSI SOL 4 (NF Package) | |
APPENDIX: PNF Onboarding Artifacts
The following are mock-ups of the PNF Onboarding Artifacts
PNF ONBOARDING ARTIFACTS | MOCK-UP |
---|---|
PNF Descriptor TOSCA | |
NF Registration (YAML) Defines records for NF events | |
Informational Artifacts |
APPENDIX: PNF ONBOARDING OVERVIEW SLIDE PACKS
Package | Slides |
---|---|
PNF Onboarding Package | |
PNF Packaging Discussion |
APPENDIX: VNF REQUIREMENTS
The PNF Package requirements need to be developed, and the VNF Package Requirements can be used as a guideline for what a PNF might need.
VNF Packaging Requirements - The appropriate Requirements page is at:
https://onap.readthedocs.io/en/beijing/submodules/vnfrqts/requirements.git/docs/Chapter7.html
Requirements Appendix:
https://onap.readthedocs.io/en/beijing/submodules/vnfrqts/requirements.git/docs/Chapter8.html
SDC Repository
https://gerrit.onap.org/r/#/admin/projects/sdc
(Click on BRANCHES, on the "MASTER" row, click on gitweb, click on TREE in the top navigation row)