Versions Compared

Key

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

Authors: Ben Cheung , Michela Bevilacqua , Zu Qiang

...

PNF PRE-ONBOARDING & ONBOARDING OVERVIEW




Descriptor, Artifacts and Package Delivery

PNF Package

Pre-onboarding

ONAP onboarding process,

PNF Package onboarding

ONAP Design Time activitiesONAP Run Time activities
WHENPNF delivery timePre-Onboarding activitiesOnboarding ActivitiesONAP Design Time ActivitiesONAP Run Time
WHOVendorTechnology Specialist

Technology Specialist

Asset Manager

Service Designer

Operations Specialist

Operations Specialist
WHATDescriptor, Artifacts and Package delivery

PNF Package

NF validation Activities

PNF Package,

PNF Descriptor

PNF Onboarding

SDC Meta-data added (vendor onboarded CSAR to SDC onboarded CSAR)

ONAP Common Information Model

SDC Data Model

5G Service Definition

Service Design

SDC Model mapping

5G Service Instantiation

PNF Instance

A&AI PNF Instance

ETSI NFV reference

SOL001 PNFD

SOL004 Package

ETSI SOL004 Package

ETSI SOL001 PNFD,

SOL004 Package


-


PNF PRE-ONBOARDING & ONBOARDING DUBLIN WORK

...

Project / PTLJIRADescriptionStatus
  1. PNF package format
    • Identify current VNF package format constraints in SDC
    • Propose a PNF Package format
    • Evaluate VNF and PNF package alignment
  2. Onboarding PNF package to internal PNF package mapping
    • including adding the manifest file with new key words
    • including adding metadata file with new key words
    • non_Mano artifacts based on the public non_mano_artifact_sets key name
    • Package security to be supported (starting with option 2)
  3. Keep a copy of the original on boarding package under artifact folder (agreed in SDC weekly meeting)
  4. Onboarding PNFD to internal PNFD mapping
    • A new flow will be introduced in SDC to map ETSI SOL001 PNFD into SDC AID model.
  5. Artifact management
    • Design time catalog update to associate artifacts to a PNF
    • Run time catalog update to associate artifacts to a PNF


PTL notified (11/19 )

Code is ready for M4(11/04)

VNF SDK

victor gao

VNFSDK Model Package


  1. PNF package format verification

VNFSDK PTL notified (12/05)

VNF SDK Model, Package notified (11/30)

PNF package to ONAP.pptx

Scope planned for Dublin completed ...except from package security item:

Jira Legacy
serverSystem Jira
serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
keyVNFSDK-342

E2E work tracked in this Jira item:

Jira Legacy
serverSystem Jira
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
keyVNFSDK-337

RESOURCE DATA MODEL

Anatoly Katzman

No JIRA ticket required, project can help to identify the mappings required in SDC in Dublin timeframe
  • Onboarded PNFD to Platform PNFD mapping
PTL notified (11/26)
    1. Network Function requirements shall be updated to cover PNF package, descriptor and artifacts
    2. VNF requirements could be reviewed.
    3. Remove or modify the existing package / documentation requirements (some of them is from the RFP or heat template only)
PTL notified (01/16)

...

PACKAGE DELIVERYONBOARDING PROCESSDESIGN TIMERUN TIME
NF DescriptorNF Descriptor Model

SDC Data Model

A&AI PNF Data model, PNF instance

VES event registration file/
FM dictionary,

PM dictionary

artifactSDC Catalog

Run time Catalog


Informational ArtifactsartifactSDC CatalogRun time Catalog

Configuration Models and Files,

(including Ansible Playbooks)

artifactSDC CatalogRun time Catalog


Multiple artifacts can be provided by a vendor in the Package. A list of the supported artifacts by ONAP will be finalized during Dublin timeframe.

...

TASKVNF SDK S/W FUNCTION - DESCRIPTION

Release

Priority

#1: MANIFEST FILE (VNF SDK) vs FILE CHECK

(Test only)

Verifies the MANIFEST file (MainServiceTemplate.mf) and  checks that the defined directories of the PNF package against the manifest file. for example the manifest file might say a files should exist: "Measurements: source: Artifacts/Deployment/Measurements/PM_Dictionary.yaml", the VNF SDK would check that the file PM_Dictionary.yaml exists in the actual PNF package.

(Confirmed that VNF-SDK supports already Feb 14, 2019). Bogumil Zebek

There are two repositories: Java, Python. (investigate)

ASSOCIATED DEVELOPMENT:

Jira Legacy
serverSystem Jira
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
keyVNFSDK-340

  • Adapt unit tests to run in Local DCE
  • Extract common manifest logic to separate module
  • Create PNF Manifest file validator
  • Integrate PNF Manifest file validator in CSAR Reader
  • Add CSAR Type flag to CSAR Validation command line.

R4

HIGH

#2: TOSCA MetaFile LICENSE Term File Exists Check (VNF SDK)

(Test Only)

VNF SDK will check a License Term File Check in the PNF package. TOSCA meta file points to a License. Just a check that the file exists no content check at all.

Note: Related requirements standards from ETSI IFA011, SOL004

ASSOCIATED DEVELOPMENT:

QUESTION is the file is not there will the process abort or is a warning given?

(Already Supported, VNF-SDK already supports this confirmed Feb 14, 2019)

R4

HIGH

#3: TOSCA MetaFile CERTIFICATE Check (VNF SDK)

(Test Only)

(Test only) CERTIFICATE check. In the PNF package it is expected that there will be MainServiceTemplate.cert. This is mentioned in the TOSCA MetaFile. For example, in the TOSCA MetaFile, it could be mentioned "Entry-Certificate: Artifacts/resource-gnodeb-template.cert". And VNF SDK would check to make sure that the resource-gnodeb-template.cert file exists in the mentioned directory, the Artifacts in this case. VNF SDK does not look inside this file.

(Needs Investigation) SOL004 has option 1 (signing each artifact individually / individual digest) and option 2 (sign entire package). It would be nice if VNF SDK supported both Option 1 and Option 2.

(Needs Investigation) VNF-SDK option 1/2 support still needs investigation (as of Feb 18, 2019). Need to clarify how to do the test.

ASSOCIATED DEVELOPMENT:

Jira Legacy
serverSystem Jira
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
keyVNFSDK-342

QUESTION is the file is not there will the process abort or is a warning given?

R4

HIGH

#4: SOL004 PNF TAGS

Check keywords. needs VNF SDK to check the PNF keywords. in the MainServiceTemplate.mf there are new tags:

  • pnfd_name
  • pnfd_provider,
  • pnfd_archive_version,
  • pnfd_release_date_time

and the file list

and the NON ETSI MANO artifact tags public tags. These public tags are under the "non_mano_artifact_sets". This would be NEW development in VNF SDK. An example Manifest file is shown in this diagram:

metadata:                                                      
pnfd_name: gNB
pnfd_provider: Ericsson
pnfd_archive_version:1.0
pnfd_release_date_time:2018-12-03T08:44:00-05:00

source: Definitions/MainServiceTemplate.yaml    
source: Definitions/etsi_nfv_sol001_vnfd_2_5_1_types.yaml
source: Definitions/etsi_nfv_sol001_pnfd_2_5_1_types.yaml

non_mano_artifact_sets: 
onap_ves_events:
  source: Artifacts/Events/VES_registration.yaml
onap_pm_dictionary:
  source: Artifacts/Measurements/PM_Dictionary.yaml
onap_yang_module:
  source: Artifacts/Yang_module/Yang_module.yaml
onap_others:
  source: Artifacts/scripts/install.sh
  source: Artifacts/Informational/user_guide.txt
  source: Artifacts/Other/installation_guide.txt
  source: Artifacts/Other/review_log.txt

   which shows the use of some of these fields.

ASSOCIATED DEVELOPMENT:

Jira Legacy
serverSystem Jira
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
keyVNFSDK-339


R4

High

#5: VALIDATION FOR META DATA CHECK (ETSI SOL004)

Following ETSI SOL004 Validation for Meta-Data file and Manufacturer file, this is the TOSCA.meta file that is part of the PNF Package. Both VNF SDK implementing only meta-data option, in the package there is a meta file. Check TOSCA.meta, while this file is not mandatory, when it is included that it follows the SOL004 standard (ETSI). We expect that "TOSCA-Meta-Version" and "CSAR-Version" and "Created by" are already supported, and new checks for "Entry definition, ETSI-Entry-manifest, ETSI-Entry-change-log" would be new VNF SDK development work (needs to be verified).


TOSCA-Meta-File-Version: 1.0
CSAR-Version: 1.1
Created-By: Ericsson
Entry-Definitions: Definitions/MainServiceTemplate.yml     
ETSI-Entry-Manifest: MainServiceTemplate.mf
ETSI-Entry-Change-Log: Artifacts/ChangeLog.txt


VNF SDK does the check the TOSCA.meta file today, if a few keywords is there.

ASSOCIATED DEVELOPMENT:

Jira Legacy
serverSystem Jira
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
keyVNFSDK-339

R4

HIGH


#6: PACKAGE SECURITY

Driven from SOL004: Option 1 (Supported in R4 Dublin): TOSCA.meta (exists) Meta-directory based, XML based approach. Option 2 (NOT support in R4 Dublin): CSAR without TOSCA.meta. Manifest (.mf) file that has everything (so the TOSCA.meta is redundant). Yaml-based approach.

The Public Key a key to open the package. SOL004 Option 1, 2 and use key to open the package - X.509 certificates public key, private key to sign the package and private key correspond to the private key of the package also delivered with the package. a package, a signature, and public key certificate delivered together. There may be more than one signature. Option 1 there is a digest for every file. All of those digests are listed in the manifest file. The manifest file is signed, one signature on the manifest. One signature and one key/pair & 1 certificate. Still optional to sign other files. The signature is a file beside. myimage.iso myimage.xyz but the same file/directory. Every file signed should have a signature files. CSAR file signed in a .sm file, package signature. The public key is signed can be signed by a root certificate.

An X.509 certificate is a digital certificate that uses the widely accepted international X.509 public key infrastructure (PKI) standard to verify that a public key belongs to the user, computer or service identity contained within the certificate.

(investigate) if VNF-SDK would like to use AAF as the CA. Can AAF perform the CA functions.

To open the package need: (1) Public Key (to open the manifest file) (2) file input (3) certificate input. create a hash, the hash is verified against the signature. SHA-256

ASSOCIATED DEVELOPMENT:

Jira Legacy
serverSystem Jira
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
keySDC-2161


#7: PNF DESCRIPTOR

The descriptor. There is validation of the VNFD. PNF Descriptor: TOSCA descriptor, and validate the node type. Validation of TOSCA PNFD. Following TOSCA rules. Components required are there.  (NEEDS INVESTIGATION)

VNFSDK check the VNFD based on VNF requirements.

ASSOCIATED DEVELOPMENT:

Jira Legacy
serverSystem Jira
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
keyVNFSDK-341

R4

HIGH

#8: PNF PACKAGE TESTING

(Test Only)

Enhancement of Package Testing. A item to make sure that integration testing is performed and that VNF-SDK supports the functions as will be described in the Requirements work. Testing the package against the requirements (a user can enter a requirement#) VNF-RQTS project.

It would be ideal if the PNF Package used by the VNF-SDK work is shared by the rest of the PNF preonboarding/onboarding development & integration.

ASSOCIATED DEVELOPMENT:

Jira Legacy
serverSystem Jira
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
keyVNFSDK-343

R4

HIGH

LOW PRIORITY / PUSHED TO R5 EL ALTO
#F1: CREATE PACKAGE FUNCTION FOR PNFThe create package function creates the metadata files, and CSAR files. This needs to be modified to support SOL004. (NEEDS INVESTIGATION) [Low Priority]

R5 EL ALTO

LOW PRI

#F2: TOSCA Metafile License Content Check

SDC license model check. Potential ARTIFACTS: Vendor license model & agreement, features. VNF can have >1 features, entitlement pool, license key pools, actual keys.

[Low Priority] PUSH TO R5 EL ALTO.


R5 EL ALTO

LOW PRI




...

SDC supported artifact types

REQUIREMENTS


This section describes the requirements that are to be updated & added

(This section under development)


REQUIREMENTS CATEGORIESDESCRIPTION
CSAR structure

New requirements related to the CSAR structure for the PNF Onboarded package.

Section 5.1.6, VNF CSAR requirements based on SOL004 based only for VNFs.

Associated Tickets:

  • Jira Legacy
    serverSystem Jira
    serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
    keyVNFRQTS-497
  • Jira Legacy
    serverSystem Jira
    serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
    keyVNFRQTS-499

  • Jira Legacy
    serverSystem Jira
    serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
    keyVNFRQTS-505
PNFD Descriptor

New VNF-RQTS requirements related to the PNF Descriptor.

The requirements describe the VNF-Descriptor and new updates need to be made to support PNF Descriptors.

Associated Tickets:

  • Jira Legacy
    serverSystem Jira
    serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
    keyVNFRQTS-508
Onboarding Requirements

New VNF-RQTS onboarding requirements.

In the document 7.2, xNF onboarding requirements but aren't clear what is needed. These requirements were copied from RFP but are outdated and some requirements are irrelevant, so in R4 for this use case, these requirements needs to be reviewed, updated, and revised.

Associated Tickets:

(TBD)



...