Overview
This is page is being used to track the realization of the Hardware Platform Awareness (HPA) functional requirement defined in support of VoLTE, vCPE and 5G use cases. The requirement calls for enablement of hardware platform feature awareness (HPA) inside the ONAP management platform, or means by which knowledge about underlying compute hardware platform capabilities is exposed to VNFs running on top of the platform in order to optimize, accelerate and/or otherwise augment their execution. In ONAP, HPA enablement focuses on discovery, health monitoring and configuration of hardware platform capabilities within the NFV infrastructure, and their consumption by the virtual network functions and network services deployed on top of the infrastructure.
More Information (Intel-specific)...
- https://software.intel.com/en-us/articles/openstack-epa-feature-breakdown-and-analysis
- https://docs.openstack.org/nova/pike/admin/cpu-topologies.html
- https://networkbuilders.intel.com/network-technologies/enhancedplatformawareness
- http://events17.linuxfoundation.org/sites/events/files/slides/High%20performance%20VMs%20using%20OpenStack%20Nova.pdf
Business Requirements
This requirement is required in support of commercial VNF implementations, that are used as part of vCPE, VoLTE and 5G use cases, and require hardware assisted acceleration. This requirement is also needed by the ONAP Optimization Framework (OOF) project in order to optimize homing and placement of hardware assisted VNFs.
Scope
The scope of this requirement is limited to consumption of hardware platform capabilities for the purpose of VNF performance acceleration and optimization. Other uses of HPA are not in scope.
Participating Companies
- AT&T, Intel, Cloudify, China Mobile, Orange, ARM
Terminology Introduced
| Term | Definition |
|---|---|
| Hardware Platform Awareness (HPA) | The means by which the underlying NFV-I hardware platform capabilities are exposed to the network service orchestration and management functionality, for the purpose of fulfilling VNF instantiation-time hardware platform requirements. |
| HPA Enablement | The implementation of HPA awareness in ONAP. |
Discussion Pages
Projects that enable HPA
| Project | PTL | |
|---|---|---|
| 1 | VNFSDK | |
| 2 | SDC | |
| 3 | SO | |
| 4 | AAI (impact) | |
| 5 | Multi-Cloud | |
| 6 | Policy | |
| 7 | OOF |
Limitations
| 1 | Specification of VNF's hardware platform capability requirements is limited to TOSCA based VNFD's. |
| 2 | Specification of VNF's hardware platform capability requirements using HEAT is not supported. |
| 3 | Supported capabilities are limited to the ones discoverable via OpenStack APIs. |
| 4 | Use of container based VNF placement is not supported. |
| 5 | Specification of capability requirements is bounded by the set of capabilities discovered in #2. |
| 6 | Implementation of southbound (Multi-Cloud) facing SO workflows is limited to HEAT only. |
| 7 | Use of TOSCA based resource orchestration is a stretch goal. |
| 8 | There is no dynamic discozzzvery of HPA capabilities. |
| 9 | HPA capabilities are not under monitoring. |
Projects that make use of HPA
Project | PTL | Notes | |
|---|---|---|---|
| 1 | APP-C | There is no direct impact on APP-C, given that all instantiation actions are "outsourced" to the SO/OOF. | |
| 2 | VF-C | Changes to VF-C will be required in order to incorporate use of HPA into instantiation and operation. | |
| 3 | DCAE |
Internal HPA Documentation
Project | PTL | |
|---|---|---|
| 1 | VNFRQTS |
External HPA Documentation
Organization | Contact | |
|---|---|---|
| 1 | ETSI NFV SOL |
Enabled HPA Functionality
| Functionality | MVP | Projects Involved | Availability | Status | |
|---|---|---|---|---|---|
| 1 | Modeling of VNF hardware platform requirements and dependencies as part of the VNFD information model and TOSCA data models. | Yes | Modeling Subcommittee | R3 | COMMITTED |
| 2 | Specification and validation of VNF hardware platform requirements and dependencies as part of the VNF package (TOSCA). | Yes | VNFSDK | R3 | COMMITTED |
| 3 | Use of VNFD supplied hardware platform requirements at on-boarding time to verify that infrastructure is capable of supporting VNF instantiation and operation. | No | SDC | R3 | STRETCHR3 |
| 4 | Translation of VNFD supplied VNF hardware platform requirements into HPA related OOF homing and placement policies. | Yes | SDC, Policy | R3 | COMMITTED |
| 5 | Manual specification of HPA related OOF homing and placement policies based on hardware platform requirements. | Yes | Policy | R2 | DONE |
| 6 | Use of VNF hardware platform requirements as constraint policies for optimized homing and resource placement of VNF components during VNF instantiation. | Yes | OOF, SO, Policy | R2 | DONE |
| 7 | Use of hardware platform telemetry in determination of the VNF instance health. | No | AAI, DCAE | R4 | SCHEDULED |
| 8 | Use of hardware platform telemetry to enhance OOF homing and placement decisions. | No | Multi-Cloud, AAI, OOF | R3 | COMMITTED |
| 9 | Use of VNF hardware platform dependencies as constraints for operation and remediation of running VNF instances. | No | VF-C, APP-C | R3 | DELAYEDR4 |
| 10 | Use of VNF hardware platform dependencies as constraints for VNF autoscaling. | No | Scaling FR | R3 | DELAYEDR4 |
| 11 | Use of VNF hardware platform dependencies as constraints for VNF change management. | No | Change Management FR | R3 | DELAYEDR4 |
| 12 | Discovery of hardware platform capabilities exposed by different VIMs. | Yes | Multi-Cloud | R2 | DONE |
| 13 | Modeling and persistence of discovered platform capabilities in the AA&I database. | Yes | Multi-Cloud, AAI | R2 | DONE |
| 14 | SRIOV Discovery. | No | Multi-Cloud | R3 | COMMITED |
| 15 | SRIOV Day 0 Configuration. | No | TBD | R3 | COMMITTED |
| 16 | VF-C/HPA integration. | No | VF-C | R3 | COMMITTED |
Test Plan (DRAFT)
Assumptions
VolTE and vCPE use cases will be used to validate the function of HPA end-to-end. The HPA test plans for Casablanca make the following assumptions with respect to function of ONAP components affected by HPA enablement functional requirement.
- There are no changes to the HPA capability discovery process.
- There are no changes to how discovered HPA capabilities are persisted in AAI.
- There are no changes to specification of HPA constraint policies used by OOF.
- Existing VoLTE and vCPE tests are sufficient to perform the end-to-end HPA testing.
Based on the above assumptions, the scope of the testing effort is limited to the following:
VNF On-Boarding (VNFSDK/SDC)
| Test ID | Test Description | Status |
|---|---|---|
| 101 | Format and content of the VNFD, as supplied via the CSAR file are unaffected by VNF on-boarding. | TO BE DONE |
| 102 | HPA requirements are unaffected by VNF on-boarding. | TO BE DONE |
| 103 | On-boarding of VNFs with HPA requirements fails if appropriate ONAP components (e.g. HPA requirement interpreter plugin) are not found. | TO BE DONE |
| 104 | HPA requirement validation errors result in termination of the VNF on-boarding process. | TO BE DONE |
VNF Design (SDC)
| Test ID | Test Description | Status |
|---|---|---|
| 201 | VNFs with TOSCA-encoded VNFDs can be used to build network services. | TO BE DONE |
| 202 | VNFD and all of its content, HPA requirements included, remain immutable. | TO BE DONE |
VNF Distribution (SDC/SO/Policy)
| Test ID | Test Description | Status |
|---|---|---|
| 301 | Policy and SO components are able to register as SDC distribution clients. | TO BE DONE |
| 302 | VNFD can be distributed through the SDC distribution framework. | TO BE DONE |
| 303 | HPA requirement parsing errors result in termination of the VNF distribution process. | TO BE DONE |
VNF Instantiation (SO/VF-C/OOF)
| Test ID | Test Description | Status |
|---|---|---|
| 401 | VNFs with TOSCA-encoded VNFDs can be instantiated using VF-C. | TO BE DONE |
| 402 | VNFs with TOSCA-encoded VNFDs can be instantiated using SO. | TO BE DONE |
| 403 | The same VNF package can be used with all ONAP orchestrators. | TO BE DONE |
| 404 | HPA requirements are consistently interpreted by all orchestrators. | TO BE DONE |
SRIO-V Support
| Test ID | Test Description | Status |
|---|---|---|
| 501 | TO BE DONE |
HPA Service Assurance (Platform Telemetry)
| Test ID | Test Description | Status |
|---|---|---|
| 601 | TO BE DONE |