Table of Contents |
---|
Use Case
...
- Package Management for SVNFM
- Granting Enhancement with HPA
- Query
- Modify (TBD)
- Policy-based Scaling (Stretch goal)
- Security between the Adapter and VNFMs
- Additional operations will be determined
Feature Descriptions
Feature | Description |
---|---|
SOL003 VNFM Adapter NBI Enhancement | SOL003 VNFM Adapter exposes its NBI to any VNFM Adapter Client.
|
SOL003 Adapter Package Management Support | SOL003 Adapter package management support based on SOL003 APIs
|
Granting Enhancement | Granting is enhanced to support HPA by leveraging OOF |
Additional of SOL003 operations | Support of additional SOL003 operations, such as Grant enhancement, Query, Modify, Scale, Operation Status, FM, PM, Heal, VNF Indicator, Retry, Rollback, Failing, Cancelling, Resource Quota Available Notification
|
Mapping between SOL001 VNFD and SDC AID DM | The VNFM Adapter needs to handle mapping between SOL001 VNFD and SDC AID DM
|
Policy-based Scaling | Policy-based Scaling with VNF Indicator and VES event handling
|
Secured communication and authentication and authorization support by SOL003 Adapter | Secured communication and authentication and authorization support
|
Epic and User Story
Epic | User Story | Description | In Guilin Plan? | JIRA | Size |
---|
Support of ETSI SOL003 v2.7.1 Or-Vnfm Interface from ONAP to external VNF Manager(s) | Epic: ETSI Alignment Support - SOL003 Adapter Enhancement for Guilin | Yes |
| ||||||||||
SOL003 Adapter NBI Enhancement | Expose the Adapter NBI to any SOL003 Adapter client in ONAP | Yes | SO-2407 - SOL003 Adapter NBI Enhancement OPEN | ||||||||||
|
| Yes | SO-2408 - SOL003 Adapter NBI - Create (Create/Instantiate) OPEN | ||||||||||
|
| Yes | SO-2409 - SOL003 Adapter NBI - Delete (Terminate/Delete) OPEN | ||||||||||
|
| Yes | SO-2410 - SOL003 Adapter NBI - Query OPEN | ||||||||||
|
| Yes | SO-2411 - SOL003 Adapter NBI - Get Operation Status OPEN | ||||||||||
|
| Yes | - | ||||||||||
|
| Yes | - | ||||||||||
|
| Yes | - | ||||||||||
|
| Yes | SO-2418 - SOL003 Adapter Package Management - Query Subscription Info CLOSED | ||||||||||
|
| Yes | SO-2420 - SOL003 Adapter Package Management - Notify SUBMITTED | ||||||||||
SOL003 Adapter Grant Enhancement that supports HPA by leveraging OOF | VNF Granting that supports HPA by leveraging OOF | Yes | SO-2422 - SOL003 Adapter - Grant Enhancement that supports HPA by leveraging OOF IN PROGRESS | ||||||||||
SOL003 Adapter Enhancement for VNF Query | To invoke VNF Query | No | SO-1636 - Add Support of Query OPEN | ||||||||||
SOL003 Adapter Enhancement for VNF Operation Status | To invoke Operation Status | No | SO-2423 - SOL003 Adapter - VNF Operation Status OPEN | ||||||||||
SOL003 Adapter Enhancement for VNF Modify | To invoke VNF Modify | No | - | ||||||||||
SOL003 Adapter Enhancement for VNF Heal | To invoke VNF Heal | No | - | ||||||||||
SOL003 Adapter Enhancement for VNF Scaling (Stretch goal) | to support Policy-based VNF Scaling support; Interface to DCAE for VES event | No | - | ||||||||||
Secured communication support between SOL003 Adapter and SVNFM | Secured communication between SOL003 Adapter and SVNFM | Yes (minimum) | SO-2424 - SOL003 Adapter - Secured communication between the Adapter and SVNFM OPEN | ||||||||||
Authentication and authorization support between between SOL003 Adapter and SVNFM | Authentication and authorization support between between SOL003 Adapter and SVNFM | Yes (minimum) | SO-2425 - SOL003 Adapter - Authentication and authorization support between the adapter and SVNFM OPEN | ||||||||||
SO BPPN Workflows & Java for SOL003 Operations | SO BPMN Workflows & Java for SOL003 Operations by leveraging the SOL003 Adapter NBIs | No | SO-2466 - SO BPMN Workflows and Java for SOL003 operations OPEN | ||||||||||
|
| No | SO-2467 - Enhance Create/Instantiate Workflows & Associated Java code OPEN | ||||||||||
|
| No | SO-2468 - Enhance Terminate/Delete Workflows & Associated Java code OPEN | ||||||||||
|
| No | SO-2469 - Create Query VNF Workflows & Associated Java code OPEN | ||||||||||
|
| No | SO-2470 - Create Get Operation Status Workflows & Associated Java code OPEN | ||||||||||
CSIT enhancement for testing SOL003 Adapter enhancement | CSIT enhancement for testing SOL003 Adapter enhancement | No | SO-2295 - CSIT of SOL003 ETSI Alignment for Frankfurt OPEN | ||||||||||
Documentation for SOL003 Adapter enhancement features | Documentation for SOL003 Adapter enhancement features | Yes | SO-2429 - documentation for SOL003 Adapter enhancement features OPEN |
SOL003 Adapter Architecture for Guilin
...
Operation Interfaces Requirements
API Action | Actor | Method | URI | Description |
---|---|---|---|---|
Grant Request | VNFM → SOL003 Adapter | POST | /grants/ (GrantRequest) | To get VNF granting |
Query VNF | SOL003 Adapter → VNFM | GET | /vnf_instances /vnf_instances/{vnfInstanceId} | To get VNF instances or a VNF instance |
Modify VNF | SOL003 Adapter → VNFM | PATCH | /vnf_instances/{vnfInstanceId} (VnfInfoModificationRequest) | To modify VNF instances |
Get Operation Status | SOL003 Adapter → VNFM | GET | /vnf_lcm_op_occs | To get VNF operation status |
Package Management
- Creating subscriptions for the package management (VNFM → SOL003 Adapter)
- Subscribe (SVNFM → SOL003 Adapter) : subscribe to notifications related to onboarding and/or changes of VNF package
- The SVNFM sends a POST request for the Subscriptions resource including PkgSubscriptionRequest to the SOL003 Adapter.
- The SOL003 Adapter returns with a data structure of PkgmSubscription to the SVNFM
...
- Method 2: If the above processing does not work for the vendor VNF HPA, OOF will be called from the SOL003 Adapter per VNF. The following describes the interactions between SOL003 Adapter and OOF.
- Note: current, OOF does NOT support the VNF Level Homing request. OOF API enhancement is under discussion. Otherwise, the method 1 (Service Level Homing) is used.
- VNFM Adapter sends out homing requests to OOF (OSDF) containing resource info
- OOF (OSDF) pulls all the related homing constraints from Policy
- OOF (HAS) checks AAI database to pull region (flavor) information
- OOF (HAS) communicates with Multi-Cloud to check cloud capacity (vims which fulfill the requirements)
- OOF (OSDF) returns homing allocation solution to VNFM Adapter
- OOF collects information as following:
- Service and Resource Info, from: AAI
- HPA Flavors/Capabilities/Capacity Info, from: AAI
- Policy Models (Homing, PCI) from: Policy
- Infrastructure Metrics Info (capacity), from: MultiCloud
- Cloud Agnostic Intent Info, from: MultiCloud
- PCI configuration data (not yet a part of SDC model)
- SOL003 Adapter Homing Request to OOF
- <describe the homing request API and contract here>
GrantRequest Structure
Attribute name | Data type | Cardinality | Description |
vnfInstanceId | Identifier | 1 | Identifier of the VNF instance which this grant request is related to. Shall also be provided for VNFs that not yet exist but are planned to exist in the future, i.e. if the grant is requested for InstantiateVNF. |
vnfLcmOpOccId | Identifier | 1 | The identifier of the VNF lifecycle management operation occurrence associated to the GrantRequest. |
vnfdId | Identifier | 1 | Identifier of the VNFD that defines the VNF for which the LCM operation is to be granted. |
flavourId | Identifier | 0..1 | Identifier of the VNF deployment flavour of the VNFD that defines the VNF for which the LCM operation is to be granted. |
operation | GrantedLcmOperationType | 1 | The lifecycle management operation for which granting is requested. See note 1. |
isAutomaticInvocation | Boolean | 1 | Set to true if this VNF LCM operation occurrence has been triggered by an automated procedure inside the VNFM (i.e. ScaleVnf / ScaleVnfToLevel triggered by auto-scale, or HealVnf triggered by auto- heal). Set to false otherwise. |
instantiationLevelId | Identifier | 0..1 | If operation=INSTANTIATE, the identifier of the instantiation level may be provided as an alternative way to define the resources to be added. This attribute shall only be used if operation=INSTANTIATE. See note 2. |
addResources | ResourceDefinition | 0..N | List of resource definitions in the VNFD for resources to be added by the LCM operation which is related to this grant request, with one entry per resource. See note 2. |
tempResources | ResourceDefinition | 0..N | List of resource definitions in the VNFD for resources to be temporarily instantiated during the runtime of the LCM operation which is related to this grant request, with one entry per resource. See note 3. |
removeResources | ResourceDefinition | 0..N | Provides the definitions of resources to be removed by the LCM operation which is related to this grant request, with one entry per resource. |
updateResources | ResourceDefinition | 0..N | Provides the definitions of resources to be modified by the LCM operation which is related to this grant request, with one entry per resource. |
placementConstraints | PlacementConstraint | 0..N | Placement constraints that the VNFM may send to the NFVO in order to influence the resource placement decision. If sent, the NFVO shall take the constraints into consideration when making resource placement decisions, and shall reject the grant if they cannot be honoured. See note 4 and note 5. |
vimConstraints | VimConstraint | 0..N | Used by the VNFM to require that multiple resources are managed through the same VIM connection. If sent, the NFVO shall take the constraints into consideration when making VIM selection decisions, and shall reject the grant if they cannot be honoured. This attribute shall be supported if VNF- related Resource Management in direct mode is applicable. The applicability and further details of this attribute for indirect mode are left for future specification. |
additionalParams | KeyValuePairs | 0..1 | Additional parameters passed by the VNFM, specific to the VNF and the LCM operation. |
_links | Structure (inlined) | 1 | Links to resources related to this request. |
>vnfLcmOpOcc | Link | 1 | Related lifecycle management operation occurrence. |
>vnfInstance | Link | 1 | Related VNF instance. |
NOTE 1: NOTE 2: NOTE 3: NOTE 4: NOTE 5: The VNF LCM operations CreateVnfIdentifier, DeleteVnfIdentifier, QueryVnf and ModifyVnfInformation can be executed by the VNFM without requesting granting. |
Grant Structure
Attribute name | Data type | Cardinality | Description |
id | Identifier | 1 | Identifier of the grant. |
vnfInstanceId | Identifier | 1 | Identifier of the related VNF instance. |
vnfLcmOpOccId | Identifier | 1 | Identifier of the related VNF lifecycle management operation occurrence. |
vimConnections | VimConnectionInfo | 0..N | Provides information regarding VIM connections that are approved to be used by the VNFM to allocate resources, and provides parameters of these VIM connections. The VNFM shall update the " vimConnectionInfo" attribute of the "VnfInstance" structure by adding unknown entries received in this attribute. This attribute is not intended for the modification of VimConnection entries passed earlier; for that, the VnfInfoModificationRequest structure shall be used. This attribute shall only be supported when VNF-related Resource Management in direct mode is applicable. In direct mode, this parameter shall be absent if the VIM information was configured to the VNFM in another way, present otherwise. See note 1. |
zones | ZoneInfo | 0..N | Identifies resource zones where the resources are approved to be allocated by the VNFM. |
zoneGroups | ZoneGroupInfo | 0..N | Information about groups of resource zones that are related and that the NFVO has chosen to fulfil a zoneGroup constraint in the GrantVnfLifecycleOperation request. This information confirms that the NFVO has honoured the zoneGroup constraints that were passed as part of "placementConstraints" in the GrantRequest. |
computeReservationId | IdentifierInVim | 0..1 | Information that identifies a reservation applicable to the compute resource requirements of the corresponding grant request. See note 2. |
networkReservationId | IdentifierInVim | 0..1 | Information that identifies a reservation applicable to the network resource requirements of the corresponding grant request. See note 2. |
storageReservationId | IdentifierInVim | 0..1 | Information that identifies a reservation applicable to the storage resource requirements of the corresponding grant request. See note 2. |
addResources | GrantInfo | 0..N | List of resources that are approved to be added, with one entry per resource. |
tempResources | GrantInfo | 0..N | List of resources that are approved to be temporarily instantiated during the runtime of the lifecycle operation, with one entry per resource. |
removeResources | GrantInfo | 0..N | List of resources that are approved to be removed, with one entry per resource. |
updateResources | GrantInfo | 0..N | List of resources that are approved to be modified, with one entry per resource. |
vimAssets | Structure (inlined) | 0..1 | Information about assets for the VNF that are managed by the NFVO in the VIM, such as software images and virtualised compute resource flavours. This attribute is not intended for the modification of vimAssets entries passed earlier. See note 3. |
>computeResourceFlavours | VimComputeResourceFlavour | 0..N | Mappings between virtual compute descriptors defined in the VNFD and compute resource flavours managed in the VIM. |
>softwareImages | VimSoftwareImage | 0..N | Mappings between software images defined in the VNFD and software images managed in the VIM. |
extVirtualLinks | ExtVirtualLinkData | 0..N | Information about external VLs to connect the VNF to. See note 5. |
extManagedVirtualLinks | ExtManagedVirtualLinkData | 0..N | Information about internal VLs that are managed by other entities than the VNFM. See note 4 and note 5. |
additionalParams | KeyValuePairs | 0..1 | Additional parameters passed by the NFVO, specific to the VNF and the LCM operation. |
_links | Structure (inlined) | 1 | Links to resources related to this resource. |
>self | Link | 1 | URI of this resource. |
>vnfLcmOpOcc | Link | 1 | Related VNF lifecycle management operation occurrence. |
>vnfInstance | Link | 1 | Related VNF instance. |
NOTE 1: NOTE 2: NOTE 3: NOTE 4: NOTE 5: This interface allows to signal the use of multiple VIMs per VNF. However, due to the partial support of this feature in the present release, it is recommended in the present document that the number of entries in the "vims" attribute in the Grant is not greater than 1. Modification of VIM assets during the lifetime of a VNF instance is not necessary, since it is expected that all applicable assets have been on boarded into the VIM before the VNF is instantiated. External and/or externally-managed internal VLs can be passed in VNF lifecycle management operation requests such as InstantiateVnf or ChangeVnfFlavor, and/or in the grant response. The NFVO may choose to override in the grant response external and/or externally-managed VL instances that have been passed previously in the associated VNF lifecycle management request, if the lifecycle management request has originated from the NFVO itself. |
Specifying HPA Capability Requirements using SOL001 VNFD
...