Versions Compared

Key

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

Page Status: 

Status
colourYellow
titleDraft
Table of Contents

Table of Contents
maxLevel4


VNF Requirements Project Overview


The intent of the VNF Requirement and Guidelines project is to inform VNF providers of the standards, specifications, and guidlines to which they should adhere when targeting the ONAP platform.  These requirements and guidelines will support the ONAP Architecture Principles, and ensure a consistent experience for VNF providers across the VNF lifecycle.  See the VNF Requirements Charter for more information.

...

RepoDescriptionDeliverable document Title(s) 
/guidelinesThis includes objectives and motivations for the VNF Requirements work as well as forward looking, narrative text for use in prototype RFP text.
/requirementsThis includes formalized, uniquely numbered requirements that outline the requirements and specifications to which a VNF provider should adhere. Requirements will strive to be discrete and testable where possible, and will follow the guidance of RFC 2119 of requirement key words (e.g. SHOULD, MAY, etc.) for all numbered requirements.
/usecasesDocuments VNF specific use cases in support of ONAP E2E use cases illustrating behavior, sequences of operation, variants, error conditions, etc. There may be multiple use cases associated with a single requirementNot every Use Case supported by ONAP will be documented in this section. Instead, key Use Cases that require specific coordination with the VNF can be added here to better describe the VNF's responsibilities as a participant in the Use Case.
/testcasesThis expands the use case template structure to supply the additional fields necessary to describe a test scenario. There may be multiple test case descriptions associated with a single use case

...

  • The requirement must be uniquely numbered (ex R-XXXXX).  Please refer to VNFRQTS How to Contribute for more information on how requirement numbers are assigned.
  • The requirement must use RFC 2119 keywords (MUST | MUST NOT | SHOULD | SHOULD NOT | MAY), and these keywords must be in uppercase and in bold.  In RST, bold is achieved by wrapping the text in double asterisks (ex: **MUST**) 
  • The requirement should generally start off with the subject of the requirement and refer to one of the following:, and then further refine from there
    • VNF VNFC

    • PNF

    • VNF or PNF
    • VNF Provider
    • PNF Provider
    • VNF or PNF Provider
    • VNF HEAT Orchestration TemplateHeat Package
    • VNF CSAR Package
    • PNF CSAR Package
    • VNF or PNF Package
    • VNF Documentation Package
    • PNF xNF (NOTE: xNF is a requirement that applies to both PNF and VNFs)Documentation Package
    • VNF or PNF Documentation Package
    • Example:  The VNF Heat Package's base module **MUST** contain...
  • The requirement should apply only to a single aspect of its intended requirements target, and not combine multiple independent statements into a single requirement.

...

Here is an example of a requirement that adheres to the standards.

You may use the VNFRQTS Requirement Generation Tool to generate properly RST formatted requirements with unique ID numbers.


Requirement Example

.. req::
    :id: R-01334
    :keyword: MUST
    :target: VNF
    :links: R-01335
 
 
    The VNF **MUST** conform to the NETCONF RFC 5717, Partial Lock Remote Procedure Call


The following table outlines the proposed standard metadata elements that will be associated with the requirements. This list may change over time.


Anchor
requirement_metadata
requirement_metadata
Table 2: Requirement Metadata

Short notes about the requirement

Field Name

Required

vs. Optional

Data Type

Valid Values/Format

Notes

idRequiredStringR-#####

The unique requirement ID for this requirement. See VNFRQTS How to Contribute for more details.

On a new requirement, this attribute can be left off and the tox -e docs or check.py script generate and ID and populate this field.

targetRequiredString

VNF, VNFC, VNF PROVIDER, VNF HEAT ORCHESTRATION TEMPLATE,

VNF PACKAGE, PNF, XNF

VNF
PNF
VNF or PNF
VNF DOCUMENTATION PACKAGE
PNF DOCUMENTATION PACKAGE
VNF or PNF DOCUMENTATION PACKAGE
VNF PROVIDER
PNF PROVIDER
VNF or PNF PROVIDER
VNF CSAR PACKAGE
PNF CSAR PACKAGE",
VNF or PNF CSAR PACKAGE",
VNF HEAT PACKAGE

The component to which the requirement applies.
keywordRequiredString

MUST

,

MUST NOT

,

SHOULD

,

SHOULD NOT

,

MAY

The RFC 2119 keyword for the requirement
introducedOptionalStringlower case release name (ex: bejing, casablanca)

The release the requirement was initially introduced. New requirements should always have this.

When adding a new requirement, this can be left off and  the tox -e docs or check.py script will add this for you.

updatedOptionalStringlower case release nameThe release the requirement was last modified. Any updated requirements going forward should have this.
impactsOptionalList of StringComma separated list of ONAP components (ex: so, sdc)The various ONAP components that need to be aware of any changes to the requirement
validation_modeOptionalStringstatic, stand_alone, in_service

How the requirement is validated:

static - validated by statically inspecting the VNF package data

stand_alone - validated by running tests against the VNF itself

in_service - validated in the context of a full or partial ONAP deployment

validated_byOptionalList of String

Comma separated list:

vvp, vnfsdk, sdc

Projects that implement validations of this requirement.test_caseOptionalRST Link

Status
titledeprecated
Link to source file that implement the test case. This is included temporarily. Traceability from test case to requirement is now being provided by the VVP project.

notesOptionalStringFree form text


Use Case Standards

The use case section of the document affords a way to provide a VNF Provider a VNF-centric view of certain  use cases.  It is not required that every use case supported by ONAP be documented in this section.  Instead, key use cases that require discrete actions and coordination with the VNF can be described here to provide a clearer understanding of potentially multi-step complex interactions.   

Formal requirements must not be defined in this section, but instead they should be defined in the appropriate requirements section of the document.  Those requirements should detail out the any specific management, monitoring, or other capabilities the VNF must provide to support a given use case.

The use case section can be referenced by the requirements to provide additional context and better illustrate the interactions.

At this stage the format for use cases is not rigid, but is should comprise of the following elements:

  • A sequence diagram that shows the API-level interactions between any users, ONAP components, and the VNF itself to effectively coordinate the use case.  Multiple diagrams can be provided if appropriate.
  • A description of the workflow
  • An enumerated list of VNF impacts that detail out the specific concerns for the VNF provider and provide references to key requirements


Test Case Standards

TODO