VNF Package Requirements

43 VNF requirements referring to "package"

Note there is some overlap with those referring "document" as well.



ID

Content

Target

Keyword

Section Name

R-842258

The VNF **MUST** include a   configuration, e.g., a heat template or CSAR package, that specifies the   targetted parameters, e.g. a limited set of ports, over which the VNF will   communicate (including internal, external and management communication).

VNF

MUST

VNF General Security Requirements

R-384337

The VNF documentation **MUST**   contain a list of the files within the VNF package that are static during the   VNF's runtime.

VNF

MUST

Resource Description

R-98191

The xNF **MUST** vary the   frequency that asynchronous data is delivered based on the content and how   data may be aggregated or grouped together.      Note:      - For example, alarms and alerts are   expected to be delivered as       soon   as they appear. In contrast, other content, such as performance       measurements, KPIs or reported network   signaling may have various       ways   of packaging and delivering content. Some content should be       streamed immediately; or content may   be monitored over a time         interval, then packaged as collection of records and delivered       as block; or data may be collected   until a package of a certain       size   has been collected; or content may be summarized statistically       over a time interval, or computed as a   KPI, with the summary or KPI         being delivered.     - We expect   the reporting frequency to be configurable depending on       the virtual network functions needs   for management. For example,         Service Provider may choose to vary the frequency of collection       between normal and trouble-shooting   scenarios.     - Decisions about the   frequency of data reporting will affect         the size of delivered data sets, recommended delivery method,       and how the data will be interpreted   by ONAP. These considerations         should not affect deserialization and decoding of the data, which       will be guided by the accompanying   JSON schema or GPB definition         files.

XNF

MUST

Reporting Frequency

R-97102

The VNF Package **MUST** include   VM requirements via a Heat template that provides the necessary data for VM   specifications for all VNF components - for hypervisor, CPU, memory, storage.

VNF

MUST

Compute, Network, and Storage Requirements

R-90632

The xNF Package **MUST** include   documentation about KPIs and metrics that need to be collected at each VM for   capacity planning and performance management purposes.

XNF

MUST

Resource Control Loop

R-87234

The VNF package provided by a   VNF vendor **MAY** be either with TOSCA-Metadata directory (CSAR Option 1) or   without TOSCA-Metadata directory (CSAR Option 2) as specified in ETSI GS   NFV-SOL004. On-boarding entity (ONAP SDC) must support both options.  **Note:** SDC supports only the CSAR Option   1 in Casablanca. The Option 2 will be considered in future ONAP releases,

VNF

MAY

VNF Package Structure and Format

R-86235

The xNF Package **MUST** include   documentation about the monitoring parameters that must include latencies,   success rates, retry rates, load and quality (e.g., DPM) for the key   transactions/functions supported by the xNF and those that must be exercised by   the xNF in order to perform its function.

XNF

MUST

Resource Control Loop

R-84366

The xNF Package **MUST** include   documentation describing xNF Functional APIs that are utilized to build   network and application services. This document describes the externally   exposed functional inputs and outputs for the xNF, including interface format   and protocols supported.

XNF

MUST

Resource Description

R-77707

The xNF provider **MUST**   include a Manifest File that contains a list of all the components in the xNF   package.

XNF

MUST

Resource Description

R-73560

The xNF Package **MUST** include   documentation about monitoring parameters/counters exposed for virtual   resource management and xNF application management.

XNF

MUST

Resource Control Loop

R-69877

The xNF Package **MUST** include   documentation for each KPI, identify the suggested actions that need to be   performed when a threshold crossing alert event is recorded.

XNF

MUST

Resource Control Loop

R-69565

The xNF Package **MUST** include   documentation describing xNF Management APIs, which must include information   and tools for ONAP to deploy and configure (initially and ongoing) the xNF   application(s) (e.g., NETCONF APIs) which includes a description of configurable   parameters for the xNF and whether the parameters can be configured after xNF   instantiation.

XNF

MUST

Resource Description

R-67709

The VNF **MUST** be designed,   built and packaged to enable deployment across multiple fault zones (e.g.,   VNFCs deployed in different servers, racks, OpenStack regions, geographies)   so that in the event of a planned/unplanned downtime of a fault zone, the   overall operation/throughput of the VNF is maintained.

VNF

MUST

All Layer Redundancy

R-66070

The xNF Package **MUST** include   xNF Identification Data to uniquely identify the resource for a given xNF   provider. The identification data must include: an identifier for the xNF,   the name of the xNF as was given by the xNF provider, xNF description, xNF   provider, and version.

XNF

MUST

Resource Description

R-58775

The xNF provider **MUST**   provide software components that can be packaged with/near the xNF, if   needed, to simulate any functions or systems that connect to the xNF system   under test. This component is necessary only if the existing testing   environment does not have the necessary simulators.

XNF

MUST

Testing

R-56815

The xNF Package **MUST** include   documentation describing supported xNF scaling capabilities and capacity   limits (e.g., number of users, bandwidth, throughput, concurrent calls).

XNF

MUST

Resource Control Loop

R-55802

The VNF Package **MUST** include   VM requirements via a Heat template that provides the necessary data for   scaling/growth VM specifications.    Note: Must comply with the *Heat requirements in 5.b*.

VNF

MUST

Compute, Network, and Storage Requirements

R-53598

The xNF Package **MUST** include   documentation to, when relevant, provide a threshold crossing alert point for   each KPI and describe the significance of the threshold crossing.

XNF

MUST

Resource Control Loop

R-51347

The VNF package **MUST** be   arranged as a CSAR archive as specified in TOSCA Simple Profile in YAML 1.2.

VNF

MUST

VNF Package Structure and Format

R-48596

The xNF Package **MUST** include   documentation describing the characteristics for the xNF reliability and high   availability.

XNF

MUST

Resource Control Loop

R-46567

The xNF Package **MUST** include   configuration scripts for boot sequence and configuration.

XNF

MUST

Configuration Management via Ansible

R-44896

The VNF Package **MUST** include   VM requirements via a Heat template that provides the necessary data for high   availability redundancy model.

VNF

MUST

Compute, Network, and Storage Requirements

R-43958

The xNF Package **MUST** include   documentation describing the tests that were conducted by the xNF provider   and the test results.

XNF

MUST

Testing

R-42018

The xNF Package **MUST** include   documentation which must include all events (fault, measurement for xNF   Scaling, Syslogs, State Change and Mobile Flow), that need to be collected at   each VM, VNFC (defined in `VNF Guidelines <https://onap.readthedocs.io/en/latest/submodules/vnfrqts/guidelines.git/docs/vnf_guidelines/vnf_guidelines.html>`__   ) and for the overall xNF.

XNF

MUST

Resource Control Loop

R-35960

The xNF Package **MUST** include   documentation which must include all events, severity level (e.g.,   informational, warning, error) and descriptions including causes/fixes if   applicable for the event.

XNF

MUST

Resource Control Loop

R-35851

The xNF Package **MUST** include   xNF topology that describes basic network and application connectivity   internal and external to the xNF including Link type, KPIs, Bandwidth,   latency, jitter, QoS (if applicable) for each interface.

XNF

MUST

Compute, Network, and Storage Requirements

R-33904

The xNF Package **MUST** include   documentation for each KPI, provide lower and upper limits.

XNF

MUST

Resource Control Loop

R-33694

The xNF Package **MUST** include   documentation to when applicable, provide calculators needed to convert raw   data into appropriate reporting artifacts.

XNF

MUST

Resource Control Loop

R-30654

The xNF Package **MUST** have   appropriate cookbooks that are designed to automatically 'rollback' to the   original state in case of any errors for actions that change state of the xNF   (e.g., configure).

XNF

MUST

Chef Roles/Requirements

R-27310

The xNF Package **MUST** include   all relevant Chef artifacts (roles/cookbooks/recipes) required to execute xNF   actions requested by ONAP for loading on appropriate Chef Server.

XNF

MUST

Chef Roles/Requirements

R-26567

The xNF Package **MUST** include   a run list of roles/cookbooks/recipes, for each supported xNF action, that   will perform the desired xNF action in its entirety as specified by ONAP (see   Section 7.c, APPC/SDN-C APIs and Behavior, for list of xNF actions and   requirements), when triggered by a chef-client run list in JSON file.

XNF

MUST

Chef Roles/Requirements

R-25238

The xNF PACKAGE **MUST**   validated YANG code using the open source pyang [#7.3.1]_ program using the   following commands:  .. code-block::   text    $ pyang --verbose --strict   <YANG-file-name(s)> $ echo $!

VNF

MUST

NETCONF Server Requirements

R-22680

The xNF Package **MUST** include   documentation that describes any requirements for the monitoring component of   tools for Network Cloud automation and management to provide these records to   components of the xNF.

XNF

MUST

Resource Control Loop

R-22346

The VNF package MUST provide   :doc:`VES Event Registration   <../../../../vnfsdk/module.git/files/VESEventRegistration_3_0>` for all   VES events provided by that xNF.

VNF PACKAGE

MUST

Resource Description

R-20204

The VNF Package **MUST** include   VM requirements via a Heat template that provides the necessary data for   network connections, interface connections, internal and external to VNF.

VNF

MUST

Compute, Network, and Storage Requirements

R-16875

The xNF Package **MUST** include   documentation which must include a unique identification string for the   specific xNF, a description of the problem that caused the error, and steps   or procedures to perform Root Cause Analysis and resolve the issue.

XNF

MUST

Resource Control Loop

R-12678

The xNF Package **MUST** include   documentation which includes a description of runtime lifecycle events and   related actions (e.g., control responses, tests) which can be performed for   the xNF.

XNF

MUST

Resource Description

R-10087

The VNF package **MUST** contain   all standard artifacts as specified in ETSI GS NFV-SOL004 including Manifest   file, VNFD (or Main TOSCA/YAML based Service Template) and other optional   artifacts. CSAR Manifest file as per SOL004 - for example ROOT\\ **MainServiceTemplate.mf**

VNF

MUST

VNF Package Contents

R-01556

The xNF Package **MUST** include   documentation describing the fault, performance, capacity events/alarms and   other event records that are made available by the xNF.

XNF

MUST

Resource Control Loop

R-01478

The xNF Package **MUST** include   documentation describing all parameters that are available to monitor the xNF   after instantiation (includes all counters, OIDs, PM data, KPIs, etc.) that   must be collected for reporting purposes.

XNF

MUST

Resource Control Loop

R-01123

The VNF package Manifest file   **MUST** contain: VNF package meta-data, a list of all artifacts (both   internal and external) entry's including their respected URI's, an algorithm   to calculate a digest and a digest result calculated on the content of each artifacts,   as specified in ETSI GS NFV-SOL004. The VNF Package MUST include VNF   Identification Data to uniquely identify the resource for a given VNF   provider. The identification data must include: an identifier for the VNF,   the name of the VNF as was given by the VNF provider, VNF description, VNF   provider, and version.

VNF

MUST

VNF Package Contents

R-00156

The xNF Package **MUST** include   documentation describing xNF Management APIs, which must include information   and tools for ONAP to monitor the health of the xNF (conditions that require   healing and/or scaling responses).

XNF

MUST

Resource Description

R-00068

The xNF Package **MUST** include   documentation which includes a description of parameters that can be   monitored for the xNF and event records (status, fault, flow, session, call,   control plane, etc.) generated by the xNF after instantiation.

XNF

MUST

Resource Description