...
The HPA requirements are captured in a VNF descriptor provided by a vendor. During the service-design phase, these requirements are extracted out from the VNF descriptor and captured in a service model. Some of the HPA requirements cannot be changed during the lifecycle of a service; while other optional requirements can be changed by a service designer or operator over time (e.g. the use of SR-IOV may be preferred by an operator if the SR-IOV capability is optionally provided by a vendor). Once a service model is designed and uploaded into the SDC repository, SDC notifies the policy service about the distribution of a new service model. The policy service then fetches the service model and extracts out the HPA requirements through model decomposition. Next, the policy service creates HPA policies for the homing service (OOF-HAS) by populating the HPA requirements in policy models provided by OOF, and stores the policies in a repository. When the homing service receives a homing request from SO, the homing service asks for the associated HPA policies from the policy platform. Finally, the homing service finds homing solutions based on the evaluation of the received HPA policies and returns the solutions to SO.
As per meeting minutes here: OOF 2018-02-19 Meeting Notes, it was understood that all HPA requirements for a given VM can be put in one policy or across different policies. Also, it was discussed that each HPA capability can be enhanced to include mandatory and score attributes. Keeping this in mind, HPA capabilities are defined here. As indicated, policy can have multiple capabilities.
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | HPA Hyper-Threading Policy ExampleTemplate for the HPA policies |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"service": "hpaHyperThreadingPolicy",
"policyName": "oofBeijing.hyperThreadingPolicy_vGMuxInfra",
"description{the model name of a policy}",
"policyName": "Hyper{policy threadingscope folder}.{policy for vGMuxInfraname; must be unique}",
"templateVersiondescription": "0.0.1",
"version": "oofBeijing"{description of a policy}",
"prioritytemplateVersion": "3{policy model version}",
"riskTypeversion": "test{policy version}",
"riskLevel": "2",
"guardpriority": "False",
"content": {{priority in 1-10; larger the number higher the priority is}",
"hyperThreadingPropertiesriskType": "{
the type of risk}",
"cpuCoresriskLevel": "{the "value": 4, "operator": "="}level of risk}",
"cpuThreadsguard": "{ "value": 2, "operator": "="},
True/False flag to indicate whether guard is applicable or not}",
"cpuThreadsPolicycontent": { "value": "dedicated", "operator
"resource": "={resource name}"},
"cpuSocketsidentity": "{policy "value": 2, "operatoridentity}",
"policyScope": "="}
}["{a tag representing policy scope}"],
"identitypolicyType": "hyperThreading_vGMuxInfra{policy type}",
"policyScopeflavorFeatures": {[
"serviceType": ["vCPE"], {
"geoRegionflavorLabel": ["US", "INTERNATIONAL"]"{VM/VFC id}",
"networkTypeflavorProperties": ["ip"],[
{
"resourceInstanceType" "hpa-feature" : ["vGMuxInfra"]"{HPA feature type}",
},
"typemandatory" : "hpaHyperThreadingPolicy{mandatoriness of the feature}",
"resourceInstanceTypescore" : ["vGMuxInfra"]
}
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: HPA Hyper-Threading Policy Example |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. This policy cannot be changed during the life-cycle of a service. |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | Distance Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"service": "distancePolicy",
"policyName": "oofBeijing.distancePolicy_vGMuxInfra",
"description": "Distance Policy for vGMuxInfra",
"templateVersion": "0.0.1",
"version": "oofBeijing",
"priority": "3",
"riskType": "test",
"riskLevel": "2",
"guard": "False",
"content": {
"distanceProperties": {
"locationInfo": { "value": "customer_location", "operator": "="},
"distance": { "value": "500", "operator": "<", "unit": "km" },"{priority of this feature if the feature is not mandatory for VM}"
"architecture": "{supported architecuture}",
"hpa-version": "{version for hpa capability}",
"hpa-feature-attributes": [
{
"resourceInstanceType": { "value": "vGMuxInfra", "operator": "="},
},
"identityhpa-attribute-key": "distance-vGMuxInfra{attribute name}",
"policyScope": {
"serviceTypehpa-attribute-value": ["vCPE{attribute value}"],
"geoRegion": ["US", "INTERNATIONAL"],
"networkTypeoperator": ["ip{comparison operator}"],
"resourceInstanceType": ["vGMuxInfra"]
},
"typeunit": "distancePolicy"
}
}{the unit of an attribute}"}
]
}
]
}
]
}
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: Distance HPA CPU Topology Policy |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. However, the policy can be updated over time by operators. |
|
|
Section |
---|
| Template for the HPA policies. |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | HPA AES Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"service": "hpaAesPolicyhpaPolicy",
"policyName": "oofBeijing.aesPolicyhpaPolicy_vGMuxInfra",
"description": "AESHPA policy for vGMuxInfra",
"templateVersion": "0.0.1",
"version": "oofBeijing1.0",
"priority": "3",
"riskType": "test",
"riskLevel": "2",
"guard": "False",
"content": {
"aesPropertiesresources": {"vGMuxInfra",
"version": { "valuesidentity": 1.0, "operator": "="},
"hpaPolicy_vGMuxInfra",
"hwArchpolicyScope": {["vCPE", "valuesUS":, "intel_64INTERNATIONAL", "operatorip":, "=vGMuxInfra"}],
"aesFeature": {"valuespolicyType": "truehpaPolicy","operator
"flavorFeatures": "="}[
},{
"identityflavorLabel": "aes_vGMuxInfraflavor_label_vm_01",
"policyScope": {
"serviceTypeflavorProperties": ["vCPE"],
"geoRegion": ["US", "INTERNATIONAL"],
{
"networkTypehpa-feature" : ["ipcpuTopology"],
"resourceInstanceTypemandatory" : ["vGMuxInfraTrue"],
},
"typearchitecture": "hpaAesPolicygeneric",
"resourceInstanceType "hpa-version": ["vGMuxInfrav1"],
}
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: HPA AES Policy |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. This policy cannot be changed during the life-cycle of a service. |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | HPA OCS_DPDK Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"service": "hpaOvsDpdkPolicy",
"policyName": "oofBeijing.hpaOvsDpdkPolicy_vGMuxInfra" "hpa-feature-attributes": [
{"hpa-attribute-key":"numCpuSockets", "hpa-attribute-value": "2","operator": ">=", "unit": ""},
"description": "HPA OVS DPDK policy for vGMuxInfra",
{"templateVersionhpa-attribute-key": "0.0.1numCpuSockets",
"version "hpa-attribute-value": "4","operator": "oofBeijing<=",
"priorityunit": "3"},
"riskType {"hpa-attribute-key": "testnumCpuCores",
"riskLevelhpa-attribute-value": "2",
"guard "operator":">=", "unit": "False"},
"content": {
{"ovsDpdkPropertieshpa-attribute-key": {
"version"numCpuCores", "hpa-attribute-value": {"4", "valuesoperator": 1.0"<=", "operatorunit": "="},
"hwArch": { "valueshpa-attribute-key": "*numCpuThreads", "operatorhpa-attribute-value": "=4"},
"OvsDpdkoperator": {"values": "true">=", "operatorunit": "="},
},
{"hpa-attribute-key":"numCpuThreads", "identityhpa-attribute-value": "ovsDpdk_vGMuxInfra8",
"policyScope "operator":"<=", "unit": {""}
"serviceType": ["vCPE"],
"geoRegion": ["US", "INTERNATIONAL"],
},
{
"networkType": ["ip"],
"resourceInstanceTypehpa-feature" : ["vGMuxInfrabasicCapabilities"],
},
"mandatory" : "True",
"type "architecture": "hpaOvsDpdkPolicygeneric",
"resourceInstanceType "hpa-version": ["vGMuxInfrav1"]
,
}
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: HPA OVS_DPDK Policy |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. This policy cannot be changed during the life-cycle of a service. |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | HPA CPU_Pinning Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"service": "hpaCpuPinningPolicy",
"policyName": "oofBeijing.hpaCpuPinningPolicy_vGMuxInfra",
"description": "CPU Pinning policy for vGMuxInfra",
"templateVersion": "0.0.1",
"version": "oofBeijing",
"priority": "3",
"riskType": "test",
"riskLevel": "2",
"guard": "False",
"content": {
"hpa-feature-attributes": [
{"hpa-attribute-key": "numVirtualCpu", "hpa-attribute-value": "6", "operator": "=", "unit": ""},
{"hpa-attribute-key": "virtualMemSize", "hpa-attribute-value":"6", "operator": "=", "unit": "GB"}
"cpuPinningProperties": {]
"pinning": { "values": "prefer", "operator": "="},
},
{
"identity": "cpuPinning_vGMuxInfra",
"policyScopehpa-feature" : {"ovsDpdk",
"serviceTypemandatory" : ["vCPEFalse"],
"geoRegionscore" : ["US3", "INTERNATIONAL"],
"networkTypearchitecture": ["ipgeneric"],
"resourceInstanceTypehpa-version": ["vGMuxInfrav1"],
},
"typehpa-feature-attributes": "hpaCpuPinning",
[
"resourceInstanceType": ["vGMuxInfra"]
}
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: HPA CPU_Pinning Policy |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. This policy cannot be changed during the life-cycle of a service. |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | HPA NUMA Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"service": "hpaNumaPolicy",
"policyName": "oofBeijing.hpaNumaPolicy_vGMuxInfra {"hpa-attribute-key":"dataProcessingAccelerationLibrary", "hpa-attribute-value":"ovsDpdk_version", "operator": "=", "unit":""}
]
},
{
"hpa-feature" : "cpuInstructionSetExtensions",
"description": "Hyper NUMA policy for vGMuxInfra",
"templateVersionmandatory" : "0.0.1True",
"version": "oofBeijing",
"priorityarchitecture": "3INTEL-64",]
"riskType": "test",
"riskLevel": "2",
"guardhpa-version": "Falsev1",
"content": {
"numaPropertieshpa-feature-attributes": {[
"version": { "values": 1.0, "operator": "="},
"hwArch": { "valueshpa-attribute-key": "*instructionSetExtensions", "operatorhpa-attribute-value": ["=<CPUINST>"},
"numaNodes": { "values "<CPUINST>"] "operator": 2"ALL", "operatorunit": "="},
"complexAttributes": [
{
"numaCpu": { "values": [0, 1], "operator": "="},
"numaMem": { "values": 2, "operator": "=", "unit": "GB"},
},
{
"numaCpu": { "values": [2, 3, 4, 5], "operator": "="},
"numaMem": { "values": 4, "operator": "=", "unit": "GB"},
]
}
]
},
{
"flavorLabel": "flavor_label_vm_02",
"flavorProperties":[
{
"hpa-feature" }
]
: "cpuPinningy",
},
"identitymandatory" : "numa_vGMuxInfraTrue",
"policyScope": {
"serviceTypearchitecture": ["vCPEgeneric"],
"geoRegionhpa-version": ["USv1", "INTERNATIONAL"],
"networkType": ["ip"],
"resourceInstanceTypehpa-feature-attributes": ["vGMuxInfra"]
},
{"typehpa-attribute-key": "hpaNumaPolicylogicalCpuThreadPinningPolicy",
"hpa-attribute-value":"<CPUTHREADPOLICY>", "operator": "=", "unit":""},
"resourceInstanceType": ["vGMuxInfra" {"hpa-attribute-key":"logicalCpuPinningPolicy", "hpa-attribute-value": "<CPUPOLICY>","operator": "=", "unit":""},
]
}
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: HPA NUMA Policy |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. This policy cannot be changed during the life-cycle of a service. |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | HPA SGX Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"service": "hpaSgxPolicy" },
"policyName": "oofBeijing.hpaSgxPolicy_vGMuxInfra", {
"description": "SGX policy for vGMuxInfra",
"templateVersionhpa-feature" : "0.0.1basicCapabilities",
"version": "oofBeijing",
"prioritymandatory" : "3True",
"riskType": "test",
"riskLevel": "2",
"guardarchitecture": "Falsegeneric",
"content": {
"sgxProperties": {
"hpa-version": "v1",
"versionhpa-feature-attributes": { "values": 1.0, "operator[
{"hpa-attribute-key": "=numVirtualCpu"},
"hwArch": { "valueshpa-attribute-value": "intel_646", "operator": "="},
"sgxMemSize": { "valuesunit": "128"},
"operator": "=", "unit": "MB"},
{"sgxPubkeyHashhpa-attribute-key": {"virtualMemSize", "valueshpa-attribute-value": "octect_string6", "operator": "=", "unit": "GB"}
},
]
"identity": "sgx_vGMuxInfra",
},
"policyScope": {
"serviceTypehpa-feature" : ["vCPElocalStorage"],
"geoRegionmandatory" : ["USFalse", "INTERNATIONAL"],
"networkTypescore" : ["ip5"],
"resourceInstanceTypearchitecture": ["vGMuxInfrageneric"],
},
"typehpa-version": "hpaSgxPolicyv1",
"resourceInstanceType "hpa-feature-attributes": ["vGMuxInfra"]
}
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: HPA SGX Policy |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. This policy cannot be changed during the life-cycle of a service. |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | Affinity Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"service": "affinityPolicy",
"policyName": "oofBeijing.affinityPolicy_vcpe",
"description": "Affinity policy for vCPE",
"templateVersion": "1702.03",
"version": "oofBeijing",
"priority": "5",
"riskType": "test",
"riskLevel": "2",
"guard": "False",
"content": {
{"hpa-attribute-key": "diskSize", "hpa-attribute-value": "2", "operator": "=", "unit": "GB"},
{"hpa-attribute-key": "ephemeralDiskSize", "hpa-attribute-value": "2", "operator": "=", "unit": "GB"},
{"hpa-attribute-key": "swapMemSize", "hpa-attribute-value":"16", "operator": "=", "unit": "MB"},
"identity": "affinity_vCPE",
]
"policyScope": { },
"serviceType": ["vCPE"],
{
"geoRegionhpa-feature" : ["USpcie", "INTERNATIONAL"],
"networkTypemandatory" : ["ipTrue"],
"resourceInstanceTypearchitecture": ["vGMuxInfrageneric", "vG"]
},
"affinityPropertyhpa-version": {"v1",
"qualifier "hpa-feature-attributes": {"value": "different", "operator": "="},
[
{"categoryhpa-attribute-key": {""pciCount", "hpa-attribute-value": "complex2", "operator": "=", "unit": ""},
},
{"typehpa-attribute-key": "affinityPolicypciVendorId",
"resourceInstanceType "hpa-attribute-value":"8086", "operator": ["vGMuxInfra=", "vGunit"]
}
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: Affinity Policy |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. This policy cannot be changed during the life-cycle of a service. |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | Capacity Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"service": "capacityPolicy",
"policyName": "oofBeijing.capacityPolicy_vGMuxInfra",
"description": "Capacity policy for vGMuxInfra",
"templateVersion": "1702.03",
"version": "oofBeijing",
"priority": "5",
"riskType": "test",
"riskLevel": "2",
"guard": "False",
"content": {: ""},
{"hpa-attribute-key": "pciDeviceId", "hpa-attribute-value": "2", "operator": "=", "unit": ""}
{"hpa-attribute-key": "functionType", "hpa-attribute-value": "<PCITYPEVALUE>","operator": "=", "unit": ""}
"identity": "capacity_vGMuxInfra", ]
"policyScope": {
}
"serviceType": ["VCPE"],
},
"geoRegion": ["US", "INTERNATIONAL"],
{
"networkTypeflavorLabel": ["ip"]"flavor_label_vm_03",
"resourceInstanceTypeflavorProperties": ["vGMuxInfra"]
}, {
"capacityProperty": {
"hpa-feature" : "numa",
"cpu": {"valuemandatory": 2, "operator": ">False"},
"memoryscore" : {"value": 4, "operator": ">", "unit5",
"architecture": "Gbgeneric"},
},
"typehpa-version": "capacityPolicyv1",
"resourceInstanceType "hpa-feature-attributes": ["vGMuxInfra"]
}
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: Capacity Policy |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. This policy cannot be changed during the life-cycle of a service. |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | Min Guarantee Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"service": "minGuaranteePolicy",
{"policyNamehpa-attribute-key": "oofBeijing.minGuaranee_vGMuxInfranumaNodes",
"description"hpa-attribute-value": "Min guarantee policy for vGMuxInfra2",
"templateVersionoperator": "1702.03=",
"versionunit": "oofBeijing"},
"priority": "5",
{"riskTypehpa-attribute-key": "testnumaCpu-0",
"riskLevel"hpa-attribute-value": "2",
"guardoperator": "False=",
"content": {
"identity""unit": "minGuarantee_vGMuxInfra"},
"policyScope": {
"serviceType{"hpa-attribute-key": ["vCPEnumaMem-0"],
"geoRegion"hpa-attribute-value": ["US2048", "operator": "INTERNATIONAL="],
"networkType"unit": ["ipMB"],}
"resourceInstanceType {"hpa-attribute-key": ["vGMuxInfra"]
},
"minGuaranteeProperty": {
"cpu": {"valuenumaCpu-1", "hpa-attribute-value":"4", "operator": "true=", "operatorunit": "="},
{"memoryhpa-attribute-key": {"numaMem-1", "value": "false4096", "operator": "=", "unit": "MB"}
},
]
},
"type" {
"hpa-feature" : "minGuaraneePolicybasicCapabilities",
"resourceInstanceType" "mandatory" : ["vGMuxInfraTrue"],
}
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: Min Guarantee Policy |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. This policy cannot be changed during the life-cycle of a service. |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | Optimization Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"architecture": "generic",
"servicehpa-version": "PlacementOptimizationPolicyv1",
"policyName": "oofBeijing.PlacementOptimizationPolicy_vGMuxInfra",
"descriptionhpa-feature-attributes": "Placement[
Optimization Policy for vGMuxInfra",
"templateVersion": "1702.03",
"version": "oofBeijing",
"priority{"hpa-attribute-key": "5numVirtualCpu",
"riskTypehpa-attribute-value": "test6",
"riskLeveloperator": "3=",
"guardunit": "False"},
"content": {
"objectiveParameter": {
{"hpa-attribute-key": "virtualMemSize", "hpa-attribute-value":"6", "operator": "parameterAttributes"=", "unit": ["GB"}
{]
},
"resource": ["vGMuxInfra"],
{
"customerLocationInfo""hpa-feature" : "customer_lochugePages",
"parametermandatory" : "distanceFalse",
"weightscore" : "17",
"operator": "product"="architecture": "generic",
}"hpa-version": "v1",
{"hpa-feature-attributes": [
{"hpa-attribute-key": "memoryPageSize", "hpa-attribute-value": "resource<MEMORYPAGESIZE>", "operator": ["vG="],
, "unit": ""}
]
"customerLocationInfo": "customer_loc",
}
]
"parameter": "distance", }
"weight": "1",]
"operator": "product"
}
],
"operator": "sum"
},
"identity": "optimization",
"policyScope": {
"serviceType": ["vCPE"],
"geoRegion": ["US", "INTERNATIONAL"],
}
}
|
|
Column |
---|
| Expand |
---|
title | Comments and Notes: HPA CPU Topology Policy Example |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. This policy cannot be changed during the life-cycle of a service.
CPUTHREADPOLICY = prefer, isolate, require CPUPOLICY = shared, dedicated PCIETYPEVALUE: SRIOV, PCI-PASSTHROUGH CPUINST = aes, avx, sha_ni, mpx, adcx, mpx, pclmulqdq, rdrand,sse, etc MEMORYPAGESIZE = 4KB (unit=KB), 2MB (unit=MB), 1GB(unit=GB), ANY, Other explicit Page size |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | Distance Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"service": "distancePolicy",
"policyName": "oofBeijing.distancePolicy_vGMuxInfra",
"description": "Distance Policy for vGMuxInfra",
"templateVersion": "0.0.1",
"version": "oofBeijing",
"priority": "3",
"riskType": "test",
"riskLevel": "2",
"guard": "False",
"content": {
"distanceProperties": {
"networkTypelocationInfo": ["ip"],
customer_location",
"distance": { "value": "500", "operator": "<", "unit": "km" }
},
"resourceInstanceTyperesources": ["vGMuxInfra", "vG"],
"applicableResources": "any",
}"identity": "distance-vGMuxInfra",
"policyScope": ["vCPE", "US", "INTERNATIONAL", "ip", "type": "placementOptimization",
"objective": "minimize"
}
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: Optimization Policy |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. This policy cannot be changed during the life-cycle of a service. |
|
|
...
vGMuxInfra"],
"policyType": "distancePolicy"
}
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: Distance Policy |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. However, the policy can be updated over time by operators. |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | HPA Basic Capabilities Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"hpa-feature" : "basicCapabilities",
"mandatory" : "False",
"score" : "5",
"architecture": "generic",
"hpa-version": "v1",
"hpa-feature-attributes": [
{"hpa-attribute-key": "numVirtualCpu", "hpa-attribute-value": "6", "operator": "=", "unit": ""},
{"hpa-attribute-key": "virtualMemSize", "hpa-attribute-value":"6", "operator": "=", "unit": "GB"}
]
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: HPA Basic Capabilities Policy |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. This policy cannot be changed during the life-cycle of a service. |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | HPA OVS DPDK Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"hpa-feature" : "ovsDpdk",
"mandatory" : "False",
"score" : "5",
"architecture": "INTEL-64",
"hpa-version": "v1",
"hpa-feature-attributes": [
{"hpa-attribute-key":"dataProcessingAccelerationLibrary", "hpa-attribute-value":"ovsDpdk_version", "operator": "=", "unit":""}
]
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: HPA OVS DPDK Policy |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. This policy cannot be changed during the life-cycle of a service. For this policy others architectures are also applicable. |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | HPA CPU Pinning Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"hpa-feature" : "cpuPinning",
"mandatory" : "False",
"score" : "5",
"architecture": "generic",
"hpa-version": "v1",
"hpa-feature-attributes": [
{"hpa-attribute-key":"logicalCpuThreadPinningPolicy", "hpa-attribute-value":"<CPUTHREADPOLICY>", "operator": "=", "unit":""},
{"hpa-attribute-key":"logicalCpuPinningPolicy", "hpa-attribute-value": "<CPUPOLICY>","operator": "=", "unit":""},
]
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: HPA CPU Pinning Policy |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. This policy cannot be changed during the life-cycle of a service.
CPUTHREADPOLICY = prefer, isolate, require CPUPOLICY = shared, dedicated
|
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | HPA NUMA Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"hpa-feature" : "numa",
"mandatory" : "False",
"score" : "5",
"architecture": "generic",
"hpa-version": "v1",
"hpa-feature-attributes": [
{"hpa-attribute-key": "numaNodes", "hpa-attribute-value": "2", "operator": "=", "unit": ""},
{"hpa-attribute-key": "numaCpu-0", "hpa-attribute-value":"2", "operator": "=", "unit": ""},
{"hpa-attribute-key": "numaMem-0", "hpa-attribute-value": "2048", "operator": "=", "unit": "MB"},
{"hpa-attribute-key": "numaCpu-1", "hpa-attribute-value":"4", "operator": "=", "unit": ""},
{"hpa-attribute-key": "numaMem-1", "hpa-attribute-value": "4096", "operator": "=", "unit": "MB"}
]
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: HPA NUMA Policy |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. This policy cannot be changed during the life-cycle of a service. |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | HPA CPU Topology Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"hpa-feature" : "cpuTopology",
"mandatory" : "False",
"score" : "5",
"architecture": "generic",
"hpa-version": "v1",
"hpa-feature-attributes": [
{"hpa-attribute-key":"numCpuSockets", "hpa-attribute-value": "2","operator": ">=", "unit": ""},
{"hpa-attribute-key":"numCpuSockets", "hpa-attribute-value": "4","operator": "<=", "unit": ""},
{"hpa-attribute-key":"numCpuCores", "hpa-attribute-value": "2", "operator":">=", "unit": ""},
{"hpa-attribute-key":"numCpuCores", "hpa-attribute-value": "4", "operator":"<=", "unit": ""},
{"hpa-attribute-key":"numCpuThreads", "hpa-attribute-value": "4", "operator":">=", "unit": ""},
{"hpa-attribute-key":"numCpuThreads", "hpa-attribute-value": "8", "operator":"<=", "unit": ""}
]
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: HPA CPU Topology Policy Example |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. This policy cannot be changed during the life-cycle of a service. |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | Affinity Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"service": "affinityPolicy",
"policyName": "oofBeijing.affinityPolicy_vcpe",
"description": "Affinity policy for vCPE",
"templateVersion": "1702.03",
"version": "oofBeijing",
"priority": "5",
"riskType": "test",
"riskLevel": "2",
"guard": "False",
"content": {
"identity": "affinity_vCPE",
"policyScope": ["vCPE", "US", "INTERNATIONAL", "ip", "vGMuxInfra"],
"affinityProperties": {
"qualifier": "different",
"category": "complex"
},
"policyType": "affinityPolicy",
"resources": ["vGMuxInfra", "vG"],
"applicableResources": "all"
}
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: Affinity Policy |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. This policy cannot be changed during the life-cycle of a service. |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | Capacity Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"service": "capacityPolicy",
"policyName": "oofBeijing.capacityPolicy_vGMuxInfra",
"description": "Capacity policy for vGMuxInfra",
"templateVersion": "1702.03",
"version": "oofBeijing",
"priority": "5",
"riskType": "test",
"riskLevel": "2",
"guard": "False",
"content": {
"identity": "capacity_vGMuxInfra",
"policyScope": ["vCPE", "US", "INTERNATIONAL", "ip", "vGMuxInfra"],
"controller": "multicloud",
"capacityProperties": {
"cpu": {"value": 2, "operator": ">"},
"memory": {"value": 4, "operator": ">", "unit": "GB"}
"storage": {"value": 80, "operator": ">", "unit": "GB"}
},
"policyType": "vim_fit",
"resources": ["vGMuxInfra"],
"applicableResources": "any"
}
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: Capacity Policy |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. This policy cannot be changed during the life-cycle of a service. |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | Min Guarantee Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"service": "minGuaranteePolicy",
"policyName": "oofBeijing.minGuaranee_vGMuxInfra",
"description": "Min guarantee policy for vGMuxInfra",
"templateVersion": "1702.03",
"version": "oofBeijing",
"priority": "5",
"riskType": "test",
"riskLevel": "2",
"guard": "False",
"content": {
"identity": "minGuarantee_vGMuxInfra",
"policyScope": ["vCPE", "US", "INTERNATIONAL", "ip", "vGMuxInfra"],
"minGuaranteeProperty": {
"cpu": "true",
"memory": "false",
},
"type": "minGuaranteePolicy",
"resources": ["vGMuxInfra"],
"applicableResources": "any"
}
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: Min Guarantee Policy |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. This policy cannot be changed during the life-cycle of a service. A min-guarantee policy can be specified using the HPA policy model. |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | Optimization Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"service": "PlacementOptimizationPolicy",
"policyName": "oofBeijing.PlacementOptimizationPolicy_vGMuxInfra",
"description": "Placement Optimization Policy for vGMuxInfra",
"templateVersion": "1702.03",
"version": "oofBeijing",
"priority": "5",
"riskType": "test",
"riskLevel": "3",
"guard": "False",
"content": {
"objectiveParameter": {
"parameterAttributes": [
{
"resources": ["vGMuxInfra"],
"customerLocationInfo": "customer_loc",
"parameter": "distance",
"weight": "1",
"operator": "product"=
},
{
"resources": ["vG"],
"customerLocationInfo": "customer_loc",
"parameter": "distance",
"weight": "1",
"operator": "product"
}
],
"operator": "sum"
},
"identity": "optimization",
"policyScope": ["vCPE", "US", "INTERNATIONAL", "ip", "vGMuxInfra"],
"policyType": "placementOptimization",
"objective": "minimize"
}
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: Optimization Policy |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. This policy cannot be changed during the life-cycle of a service. |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | HPA PCIe Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"hpa-feature" : "pcie",
"mandatory" : "False",
"score" : "5",
"architecture": "generic",
"hpa-version": "v1",
"hpa-feature-attributes": [
{"hpa-attribute-key": "pciCount", "hpa-attribute-value": "2", "operator": "=", "unit": ""},
{"hpa-attribute-key": "pciVendorId", "hpa-attribute-value":"8086", "operator": "=", "unit": ""},
{"hpa-attribute-key": "pciDeviceId", "hpa-attribute-value": "2", "operator": "=", "unit": ""}
{"hpa-attribute-key": "functionType", "hpa-attribute-value": "<PCIETYPEVALUE>","operator": "=", "unit": ""}
]
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: HPA PCIe Policy Example |
---|
| PCIETYPEVALUE: SRIOV, PCI-PASSTHROUGH |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | HPA Local Storage Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"hpa-feature" : "localStorage",
"mandatory" : "False",
"score" : "5",
"architecture": "generic",
"hpa-version": "v1",
"hpa-feature-attributes": [
{"hpa-attribute-key": "diskSize", "hpa-attribute-value": "2", "operator": "=", "unit": "GB"},
{"hpa-attribute-key": "ephemeralDiskSize", "hpa-attribute-value": "2", "operator": "=", "unit": "GB"},
{"hpa-attribute-key": "swapMemSize", "hpa-attribute-value":"16", "operator": "=", "unit": "MB"},
]
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: HPA Generic Attributes Policy Example |
---|
| The fields in this example policy are typically generated from a TOSCA service model specified by VNF vendors or service designers. This policy cannot be changed during the life-cycle of a service. |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | HPA CPU Instruction Set Extensions Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"hpa-feature" : "cpuInstructionSetExtensions",
"mandatory" : "False",
"score" : "5",
"architecture": "INTEL-64",
"hpa-version": "v1",
"hpa-feature-attributes": [
{"hpa-attribute-key":"instructionSetExtensions", "hpa-attribute-value":["<CPUINST>", "<CPUINST>"] "operator": "ALL", "unit":""}
]
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: HPA CPU Instruction Set Extensions Policy Example |
---|
| instructionSetExtensions attribute has a list of all instruction set extensions required. CPUINST = aes, avx, sha_ni, mpx, adcx, mpx, pclmulqdq, rdrand,sse, etc |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | HPA Huge Pages Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"hpa-feature" : "hugePages",
"mandatory" : "False",
"score" : "5",
"architecture": "generic",
"hpa-version": "v1",
"hpa-feature-attributes": [
{"hpa-attribute-key": "memoryPageSize", "hpa-attribute-value": "<MEMORYPAGESIZE>", "operator": "=", "unit": ""}
]
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: HPA Huge Pages Policy Example |
---|
| MEMORYPAGESIZE = 4KB (unit=KB), 2MB (unit=MB), 1GB(unit GB), ANY, Other explicit Page size |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | VNF Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"service": "vnfPolicy",
"policyName": "oofBeijing.vnfPolicy_vGMuxInfra",
"description": "vnfPolicy",
"templateVersion": "1702.03",
"version": "oofBeijing",
"priority": "6",
"riskType": "test",
"riskLevel": "3",
"guard": "False",
"content": {
"identity": "vnf_vGMuxInfra",
"policyScope": ["vCPE", "INTERNATIONAL", "ip", "vGMuxInfra"],
"policyType": "vnf_policy",
"resources": ["vGMuxInfra"],
"applicableResources": "any",
"vnfProperties": [
{
"inventoryProvider": "aai",
"serviceType": "",
"inventoryType": "cloudRegionId",
"customerId": ""
},
{
"inventoryProvider": "multicloud",
"serviceType": "HNGATEWAY",
"inventoryType": "serviceInstanceId",
"customerId": "21014aa2-526b-11e6-beb8-9e71128cae77"
}
]
}
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: HPA Huge Pages Policy Example |
---|
| VNF policy captures the location of inventories and customer information. |
|
|
Section |
---|
|
Column |
---|
| Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | Subscriber Role Policy Example |
---|
linenumbers | true |
---|
collapse | true |
---|
| {
"service": "SubscriberPolicy",
"policyName": "oofBeijing.SubscriberPolicy_v1",
"description": "Subscriber Policy",
"templateVersion": "0.0.1",
"version": "oofBeijing",
"priority": "1",
"riskType": "test",
"riskLevel": "3",
"guard": "False",
"content": {
"identity": "subscriber",
"policyScope": ["vCPE", "subscriber_x", "subscriber_y"],
"properties": {
"subscriberName": ["subscriber_x", "subscriber_y"],
"subscriberRole": ["Test"],
"provStatus": ["CAPPED"]
},
"policyType": "SubscriberPolicy"
}
} |
|
Column |
---|
| Expand |
---|
title | Comments and Notes: HPA Huge Pages Policy Example |
---|
| Subscriber role policy to capture the role of a subscriber and related provisioning states. |
|
|
Anchor |
---|
| OOF-CMSO Policies |
---|
| OOF-CMSO Policies |
---|
|
OOF-CMSO PoliciesTBD
Modes for Fetching Policies
OOF can fetch optimzation policies using the getConfig API of the policy system. The policies can be searched and filtered in two different modes; by-name and by-scope from the policy system.
By-name: OOF can send an explicite policy name or a regular expression matching a set of policy names as a part of the getConfig API payload. In return, OOF expects to receive a specific policy or a set of policies with name matching to the regular expression.
By-scope: A scope is the domain to which a policy is applicable. Scope information can be captured as a set of attribute-value pairs, which can be sent as a part of the getConfig API payload. In response, the policy system is expected to return a set of policies with the matching attribute-value pairs. A policy can only be included in the response if all the matching attribute-value pairs exist.
OOF can requerst prioritization by enabling a prioritization flag in the getConfig API call to the policy system, and expects to receive a single policy with the highest priority policy among the set of policies meeting the search criteria.
TOSCA Policy Models
The following TOSCA policy models need to be uploaded as a dictionary during the deployment-time of an optimization application. Currently, the model uploading porcess is manual since the policy system does not offer an interface to upload models programatically. Once the models are uploaded, policy templates are created in the policy portal/GUI using which optimization policies can be created. Alternatively, the policy system offers CRUD REST APIs using which the policies can be managed by the application.
HAS Policies for Testing
View file |
---|
name | Affinity_vCPE_1.json |
---|
height | 250 |
---|
|
View file |
---|
name | Capacity_vG_1.json |
---|
height | 250 |
---|
|
View file |
---|
name | Capacity_vGMuxInfra.json |
---|
height | 250 |
---|
|
View file |
---|
name | Distance_vG_1.json |
---|
height | 250 |
---|
|
View file |
---|
name | Distance_vGMuxInfra_1.json |
---|
height | 250 |
---|
|
View file |
---|
name | hpa_policy_vG_1.json |
---|
height | 250 |
---|
|
View file |
---|
name | hpa_policy_vGMuxInfra_1.json |
---|
height | 250 |
---|
|
View file |
---|
name | Placement_Optimization_1.json |
---|
height | 250 |
---|
|
View file |
---|
name | QueryPolicy_vCPE.json |
---|
height | 250 |
---|
|
View file |
---|
name | subscriber_policy.json |
---|
height | 250 |
---|
|
View file |
---|
name | vnfPolicy_vG.json |
---|
height | 250 |
---|
|
View file |
---|
name | vnfPolicy_vGMuxInfra.json |
---|
height | 250 |
---|
|
TBD
Modes for Fetching Policies
OOF can fetch optimzation policies using the getConfig API of the policy system. The policies can be searched and filtered in two different modes; by-name and by-scope from the policy system.
By-name: OOF can send an explicite policy name or a regular expression matching a set of policy names as a part of the getConfig API payload. In return, OOF expects to receive a specific policy or a set of policies with name matching to the regular expression.
By-scope: A scope is the domain to which a policy is applicable. Scope information can be captured as a set of attribute-value pairs, which can be sent as a part of the getConfig API payload. In response, the policy system is expected to return a set of policies with the matching attribute-value pairs. A policy can only be included in the response if all the matching attribute-value pairs exist.
OOF can requerst prioritization by enabling a prioritization flag in the getConfig API call to the policy system, and expects to receive a single policy with the highest priority policy among the set of policies meeting the search criteria.