- Created by Pamela Dragosh, last modified by James Hahn on Aug 28, 2018
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 35 Next »
vDNS (Auto Scale Out modifications)
Policy Creation
vDNS - TCA Configuration Policy Payload Expand source
tca_policy: "{ "domain": "measurementsForVfScaling", "metricsPerEventName": [{ "eventName": "vLoadBalancer", "controlLoopSchemaType": "VM", "policyScope": "DCAE", "policyName": "DCAE.Config_tca-hi-lo", "policyVersion": "v0.0.1", "thresholds": [{ "closedLoopControlName": "ControlLoop-vDNS-6f37f56d-a87d-4b85-b6a9-cc953cf779b3", "version": "1.0.2", "fieldPath": "$.event.measurementsForVfScalingFields.vNicUsageArray[*].receivedTotalPacketsDelta", "thresholdValue": 300, "direction": "GREATER_OR_EQUAL", "severity": "CRITICAL", "closedLoopEventStatus": "ONSET" }] }] }"
vDNS Create Config API Call Expand source
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{ "configBody": "{ \"service\": \"tca_policy\", \"location\": \"SampleServiceLocation\", \"uuid\": \"test\", \"policyName\": \"MicroServicevCPE\", \"description\": \"MicroService vCPE Policy\", \"configName\": \"SampleConfigName\", \"templateVersion\": \"OpenSource.version.1\", \"version\": \"1.1.0\", \"priority\": \"1\", \"policyScope\": \"resource=SampleResource,service=SampleService,type=SampleType,closedLoopControlName=ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e\", \"riskType\": \"SampleRiskType\", \"riskLevel\": \"1\", \"guard\": \"False\", \"content\": { \"tca_policy\": { \"domain\": \"measurementsForVfScaling\", \"metricsPerEventName\": [{ \"eventName\": \"Measurement_vGMUX\", \"controlLoopSchemaType\": \"VNF\", \"policyScope\": \"DCAE\", \"policyName\": \"DCAE.Config_tca-hi-lo\", \"policyVersion\": \"v0.0.1\", \"thresholds\": [{ \"closedLoopControlName\": \"ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e\", \"version\": \"1.0.2\", \"fieldPath\": \"$.event.measurementsForVfScalingFields.additionalMeasurements[*].arrayOfFields[0].value\", \"thresholdValue\": 0, \"direction\": \"EQUAL\", \"severity\": \"MAJOR\", \"closedLoopEventStatus\": \"ABATED\" }, { \"closedLoopControlName\": \"ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e\", \"version\": \"1.0.2\", \"fieldPath\": \"$.event.measurementsForVfScalingFields.additionalMeasurements[*].arrayOfFields[0].value\", \"thresholdValue\": 0, \"direction\": \"GREATER\", \"severity\": \"CRITICAL\", \"closedLoopEventStatus\": \"ONSET\" }] }] } } }", "policyConfigType": "MicroService", "policyName": "com.MicroServicevCPE", "onapName": "DCAE" }' 'http://pdp:8081/pdp/api/createPolicy'
TODO - Update requestParameters
vDNS - Operational Policy Expand source
controlLoop: version: 2.0.0 controlLoopName: ControlLoop-vDNS-6f37f56d-a87d-4b85-b6a9-cc953cf779b3 trigger_policy: unique-policy-id-1-scale-up timeout: 1200 abatement: false policies: - id: unique-policy-id-1-scale-up name: Scale out the VNF description: actor: SO recipe: scaleOut target: type: VNF payload: # Need to get from Marco requestParameters: '{"usePreload":true,"userParams":[{"name":"gtp_bind_addr","value":"vmme_private_ip_0"},{"name":"mmc","value":"001"},{"name":"mme_addr","value":"vmme_private_ip_0"},{"name":"mnc","value":"01"},{"name":"n_prob","value":"50"},{"name":"vnfHostIpAddress","value":"veb_private_ip_0"}]}' configurationParameters: '[{"availability-zone":"$.vnf-topology.vnf-resource-assignments.availability-zones.availability-zone[0]","xtz-123":"$.vnf-topology.vnf-resource-assignments.availability-zones.availability-zone[0]"}]' retry: 0 timeout: 1200 success: final_success failure: final_failure failure_timeout: final_failure_timeout failure_retries: final_failure_retries failure_exception: final_failure_exception failure_guard: final_failure_guard
TODO - Update the HTML escaped YAML
vDNS Create Operational API Call Expand source
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/html' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{ "policyConfigType": "BRMS_PARAM", "policyName": "com.BRMSParamvDNS", "policyDescription": "BRMS Param vDNS policy", "policyScope": "com", "attributes": { "MATCHING": { "controller" : "amsterdam" }, "RULE": { "templateName": "ClosedLoopControlName", "closedLoopControlName": "ControlLoop-vDNS-6f37f56d-a87d-4b85-b6a9-cc953cf779b3", "controlLoopYaml": "controlLoop%3A%0D%0A++version%3A+2.0.0%0D%0A++controlLoopName%3A+ControlLoop-vDNS-6f37f56d-a87d-4b85-b6a9-cc953cf779b3%0D%0A++trigger_policy%3A+unique-policy-id-1-scale-up%0D%0A++timeout%3A+1200%0D%0A++abatement%3A+false%0D%0Apolicies%3A%0D%0A++-+id%3A+unique-policy-id-1-scale-up%0D%0A++++name%3A+Create+a+new+VF+Module%0D%0A++++description%3A%0D%0A++++actor%3A+SO%0D%0A++++recipe%3A+VF+Module+Create%0D%0A++++target%3A%0D%0A++++++type%3A+VNF%0D%0A++++payload%3A%0D%0A++++++requestParameters%3A+%27%7B%22usePreload%22%3Atrue,%22userParams%22%3A%5B%7B%22name%22%3A%22gtp_bind_addr%22,%22value%22%3A%22vmme_private_ip_0%22%7D,%7B%22name%22%3A%22mmc%22,%22value%22%3A%22001%22%7D,%7B%22name%22%3A%22mme_addr%22,%22value%22%3A%22vmme_private_ip_0%22%7D,%7B%22name%22%3A%22mnc%22,%22value%22%3A%2201%22%7D,%7B%22name%22%3A%22n_prob%22,%22value%22%3A%2250%22%7D,%7B%22name%22%3A%22vnfHostIpAddress%22,%22value%22%3A%22veb_private_ip_0%22%7D%5D%7D%27%0D%0A++++++configurationParameters%3A+%27%5B%7B%22availability-zone%22%3A%22$.vnf-topology.vnf-resource-assignments.availability-zones.availability-zone%5B0%5D%22,%22xtz-123%22%3A%22$.vnf-topology.vnf-resource-assignments.availability-zones.availability-zone%5B0%5D%22%7D%5D%27%0D%0A++++retry%3A+0%0D%0A++++timeout%3A+1200%0D%0A++++success%3A+final_success%0D%0A++++failure%3A+final_failure%0D%0A++++failure_timeout%3A+final_failure_timeout%0D%0A++++failure_retries%3A+final_failure_retries%0D%0A++++failure_exception%3A+final_failure_exception%0D%0A++++failure_guard%3A+final_failure_guard" } } }' 'http://pdp:8081/pdp/api/createPolicy'
vDNS Guard - Min/Max Create API Call Expand source
# PROTOTYPE - development needs to be done first curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{ "policyClass": "Decision", "policyName": "com.vDNS.MinMax", "policyDescription": "Ensure number of instances within a range", "ecompName": "PDPD", "ruleProvider": "GUARD_YAML", "attributes": { "MATCHING": { "actor": "SO", "recipe": "scaleOut", "targets": ".*", "clname": "ControlLoop-vDNS-6f37f56d-a87d-4b85-b6a9-cc953cf779b3", "min": "1", "max": "5", "guardActiveStart": "00:00:01-05:00", "guardActiveEnd": "00:00:00-05:00" } } }' 'http://pdp:8081/pdp/api/createPolicy'
vDNS Guard - Frequency Limiter Create API Call Expand source
# DRAFT - this needs to be tested first curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{ "policyClass": "Decision", "policyName": "com.vDNS.Frequency", "policyDescription": "Limit vDNS Scale Up over time period", "ecompName": "PDPD", "ruleProvider": "GUARD_YAML", "attributes": { "MATCHING": { "actor": "SO", "recipe": "scaleOut", "targets": ".*", "clname": "ControlLoop-vDNS-6f37f56d-a87d-4b85-b6a9-cc953cf779b3", "limit": "1", "timeWindow": "10", "timeUnits": "minute", "guardActiveStart": "00:00:01-05:00", "guardActiveEnd": "00:00:00-05:00" } } }' 'http://pdp:8081/pdp/api/createPolicy'
vDNS Push Policies API call Expand source
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{ "pdpGroup": "default", "policyName": "com.BRMSParamvDNS", "policyType": "BRMS_Param" }' 'http://pdp:8081/pdp/api/pushPolicy' curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{ "pdpGroup": "default", "policyName": "com.vDNS.MinMax", "policyType": "DECISION" }' 'http://pdp:8081/pdp/api/pushPolicy' curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{ "pdpGroup": "default", "policyName": "com.vDNS.Frequency", "policyType": "DECISION" }' 'http://pdp:8081/pdp/api/pushPolicy' curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{ "pdpGroup": "default", "policyName": "com.MicroServicevDNS", "policyType": "MicroService" }' 'http://pdp:8081/pdp/api/pushPolicy'
DCAE Events and A&AI Enrichment (if necessary)
vDNS - DCAE Control Loop Event (TCA) - vDNS (NOT Enriched with A&AI) Expand source
{ "closedLoopEventClient": "DCAE_INSTANCE_ID.dcae-tca", "policyVersion": "1.0.0.5", "policyName": "vLoadBalancer", "policyScope": "resource=SampleResource,service=SampleService,type=SampleType,closedLoopControlName=SampleClosedLoop", "target_type": "VM", "AAI": { "vserver.vserver-name": "dfw1lb01lb01" }, "closedLoopAlarmStart": 1484677482204798, "closedLoopEventStatus": "ONSET", "closedLoopControlName": "ControlLoop-vDNS-6f37f56d-a87d-4b85-b6a9-cc953cf779b3", "version": "1.0.2", "target": "vserver.vserver-name", "requestID": "97964e10-686e-4790-8c45-bdfa61df770f", "from": "DCAE" }
vDNS - A&AI vserver query Expand source
#PLD find the vserver version https://{aai}/aai/v11/nodes/vservers?vserver-name=dfw1lb01lb01
vDNS - A&AI vserver query response Expand source
{ "vserver": [ { "in-maint": false, "is-closed-loop-disabled": true, "prov-status": "ACTIVE", "relationship-list": { "relationship": [ { "related-link": "/aai/v11/network/generic-vnfs/generic-vnf/807a3f02-f878-436b-870c-f0e91e81570d", "related-to": "generic-vnf", "related-to-property": [ { "property-key": "generic-vnf.vnf-name", "property-value": "vLoadBalancerMS-Vnf-0809-2" } ], "relationship-data": [ { "relationship-key": "generic-vnf.vnf-id", "relationship-value": "807a3f02-f878-436b-870c-f0e91e81570d" } ] }, { "related-link": "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/images/image/6e219e86-cd94-4989-9119-def29aa10b12", "related-to": "image", "related-to-property": [ { "property-key": "image.image-name", "property-value": "unknown" } ], "relationship-data": [ { "relationship-key": "cloud-region.cloud-owner", "relationship-value": "CloudOwner" }, { "relationship-key": "cloud-region.cloud-region-id", "relationship-value": "RegionOne" }, { "relationship-key": "image.image-id", "relationship-value": "6e219e86-cd94-4989-9119-def29aa10b12" } ] }, { "related-link": "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/flavors/flavor/764efb04-5a46-4806-a766-2bdd24559f39", "related-to": "flavor", "related-to-property": [ { "property-key": "flavor.flavor-name", "property-value": "m1.medium" } ], "relationship-data": [ { "relationship-key": "cloud-region.cloud-owner", "relationship-value": "CloudOwner" }, { "relationship-key": "cloud-region.cloud-region-id", "relationship-value": "RegionOne" }, { "relationship-key": "flavor.flavor-id", "relationship-value": "764efb04-5a46-4806-a766-2bdd24559f39" } ] } ] }, "resource-version": "1533850964910", "vserver-id": "1c94da3f-16f1-4fc7-9ed1-e018dfa62774", "vserver-name": "vlb-ms-0809-1", "vserver-name2": "vlb-ms-0809-7", "vserver-selflink": "http://localhost:8774/v2.1/4086f396c5e04caf9502c5fdeca575c4/servers/1c94da3f-16f1-4fc7-9ed1-e018dfa62774" } ] }
vDNS DCAE Control Loop Event - Enriched A&AI Expand source
{ "closedLoopEventClient": "DCAE_INSTANCE_ID.dcae-tca", "policyVersion": "1.0.0.5", "policyName": "vLoadBalancer", "policyScope": "resource=SampleResource,service=SampleService,type=SampleType,closedLoopControlName=SampleClosedLoop", "target_type": "VM", "AAI": { "vserver.vserver-name": "dfw1lb01lb01" # TODO - add in the enriched A&AI }, "closedLoopAlarmStart": 1484677482204798, "closedLoopEventStatus": "ONSET", "closedLoopControlName": "ControlLoop-vDNS-6f37f56d-a87d-4b85-b6a9-cc953cf779b3", "version": "1.0.2", "target": "vserver.vserver-name", "requestID": "97964e10-686e-4790-8c45-bdfa61df770f", "from": "DCAE" }
A&AI API Interaction
vDNS - A&AI vserver named query Expand source
#PLD find the vserver version https://{aai}/aai/search/named-query { "query-parameters": { "named-query": { "named-query-uuid": "4ff56a54-9e3f-46b7-a337-07a1d3c6b469" } }, "instance-filters": { "instance-filter": [ { "vserver": { "vserver-name": "vserver-71c978fb-29b8-437d-80e6-acf3a3a91e69" } } ] } }
TODO - Update with output containing valid VF Modules (other than "dummy")
vDNS - A&AI vserver named query response Expand source
{ "inventory-response-item": [ { "vserver": { "vserver-id": "6ed3642c-f7a1-4a7c-9290-3d51fe1531eb", "vserver-name": "zdfw1lb01lb02", "vserver-name2": "zdfw1lb01lb02", "prov-status": "ACTIVE", "vserver-selflink": "http://10.12.25.2:8774/v2.1/41d6d38489bd40b09ea8a6b6b852dcbd/servers/6ed3642c-f7a1-4a7c-9290-3d51fe1531eb", "in-maint": false, "is-closed-loop-disabled": false, "resource-version": "1510606403522" }, "extra-properties": { "extra-property": [] }, "inventory-response-items": { "inventory-response-item": [ { "model-name": "vLoadBalancer", "generic-vnf": { "vnf-id": "db373a8d-f7be-4d02-8ac8-6ca4c305d144", "vnf-name": "Vfmodule_vLB1113", "vnf-type": "vLoadBalancer-1106/vLoadBalancer 0", "service-id": "66f157fc-4148-4880-95f5-e120677e98d1", "prov-status": "PREPROV", "in-maint": false, "is-closed-loop-disabled": false, "resource-version": "1510604011851", "model-invariant-id": "cee050ed-92a5-494f-ab04-234307a846dc", "model-version-id": "fd65becc-6b2c-4fe8-ace9-cc29db9a3da2" }, "extra-properties": { "extra-property": [ { "property-name": "model-ver.model-version-id", "property-value": "fd65becc-6b2c-4fe8-ace9-cc29db9a3da2" }, { "property-name": "model-ver.model-name", "property-value": "vLoadBalancer" }, { "property-name": "model.model-type", "property-value": "resource" }, { "property-name": "model.model-invariant-id", "property-value": "cee050ed-92a5-494f-ab04-234307a846dc" }, { "property-name": "model-ver.model-version", "property-value": "1.0" } ] }, "inventory-response-items": { "inventory-response-item": [ { "model-name": "vLoadBalancer-1106", "service-instance": { "service-instance-id": "3b12f31f-8f2d-4f5c-b875-61ff1194b941", "service-instance-name": "vLoadBalancer-1113", "resource-version": "1510603936425", "model-invariant-id": "1321d60d-f7ff-4300-96c2-6bf0b3268b7a", "model-version-id": "732d4692-4b97-46f9-a996-0b3339e88c50" }, "extra-properties": { "extra-property": [ { "property-name": "model-ver.model-version-id", "property-value": "732d4692-4b97-46f9-a996-0b3339e88c50" }, { "property-name": "model-ver.model-name", "property-value": "vLoadBalancer-1106" }, { "property-name": "model.model-type", "property-value": "service" }, { "property-name": "model.model-invariant-id", "property-value": "1321d60d-f7ff-4300-96c2-6bf0b3268b7a" }, { "property-name": "model-ver.model-version", "property-value": "1.0" } ] } }, { "model-name": "Vloadbalancer..base_vlb..module-0", "vf-module": { "vf-module-id": "e6b3e3eb-34e1-4c00-b8c1-2a4fbe479b12", "vf-module-name": "Vfmodule_vLB1113-1", "heat-stack-id": "Vfmodule_vLB1113-1/3dd6d900-772f-4fcc-a0cb-e250ab2bb4db", "orchestration-status": "active", "is-base-vf-module": true, "resource-version": "1510604612557", "model-invariant-id": "6d760188-9a24-451a-b05b-e08b86cb94f2", "model-version-id": "93facad9-55f2-4fe0-9574-814c2bc2d071" }, "extra-properties": { "extra-property": [ { "property-name": "model-ver.model-version-id", "property-value": "93facad9-55f2-4fe0-9574-814c2bc2d071" }, { "property-name": "model-ver.model-name", "property-value": "Vloadbalancer..base_vlb..module-0" }, { "property-name": "model.model-type", "property-value": "resource" }, { "property-name": "model.model-invariant-id", "property-value": "6d760188-9a24-451a-b05b-e08b86cb94f2" }, { "property-name": "model-ver.model-version", "property-value": "1" } ] } }, { "model-name": "Vloadbalancer..dnsscaling..module-1", "vf-module": { "vf-module-id": "dummy_db373a8d-f7be-4d02-8ac8-6ca4c305d144", "vf-module-name": "dummy_db373a8d-f7be-4d02-8ac8-6ca4c305d144", "is-base-vf-module": false, "resource-version": "1510610079687", "model-invariant-id": "356a1cff-71f2-4086-9980-a2927ce11c1c", "model-version-id": "6b93d804-cfc8-4be3-92cc-9336d135859a" }, "extra-properties": { "extra-property": [ { "property-name": "model-ver.model-version-id", "property-value": "6b93d804-cfc8-4be3-92cc-9336d135859a" }, { "property-name": "model-ver.model-name", "property-value": "Vloadbalancer..dnsscaling..module-1" }, { "property-name": "model.model-type", "property-value": "resource" }, { "property-name": "model.model-invariant-id", "property-value": "356a1cff-71f2-4086-9980-a2927ce11c1c" }, { "property-name": "model-ver.model-version", "property-value": "1" } ] } }, { "model-name": "Vloadbalancer..dnsscaling..module-1", "vf-module": { "vf-module-id": "my_module_db373a8d-f7be-4d02-8ac8-6ca4c305d144", "vf-module-name": "my_module_1", "is-base-vf-module": false, "resource-version": "1510610079687", "model-invariant-id": "356a1cff-71f2-4086-9980-a2927ce11c1c", "model-version-id": "6b93d804-cfc8-4be3-92cc-9336d135859a" }, "extra-properties": { "extra-property": [ { "property-name": "model-ver.model-version-id", "property-value": "6b93d804-cfc8-4be3-92cc-9336d135859a" }, { "property-name": "model-ver.model-name", "property-value": "Vloadbalancer..dnsscaling..module-1" }, { "property-name": "model.model-type", "property-value": "resource" }, { "property-name": "model.model-invariant-id", "property-value": "356a1cff-71f2-4086-9980-a2927ce11c1c" }, { "property-name": "model-ver.model-version", "property-value": "1" } ] } }, { "model-name": "Vloadbalancer..dnsscaling..module-1", "vf-module": { "vf-module-id": "my_module_db373a8d-f7be-4d02-8ac8-6ca4c305d144", "vf-module-name": "my_module_2", "is-base-vf-module": false, "resource-version": "1510610079687", "model-invariant-id": "356a1cff-71f2-4086-9980-a2927ce11c1c", "model-version-id": "6b93d804-cfc8-4be3-92cc-9336d135859a" }, "extra-properties": { "extra-property": [ { "property-name": "model-ver.model-version-id", "property-value": "6b93d804-cfc8-4be3-92cc-9336d135859a" }, { "property-name": "model-ver.model-name", "property-value": "Vloadbalancer..dnsscaling..module-1" }, { "property-name": "model.model-type", "property-value": "resource" }, { "property-name": "model.model-invariant-id", "property-value": "356a1cff-71f2-4086-9980-a2927ce11c1c" }, { "property-name": "model-ver.model-version", "property-value": "1" } ] } } ] } }, { "tenant": { "tenant-id": "41d6d38489bd40b09ea8a6b6b852dcbd", "tenant-name": "Integration-SB-00", "resource-version": "1509587770200" }, "extra-properties": { "extra-property": [] }, "inventory-response-items": { "inventory-response-item": [ { "cloud-region": { "cloud-owner": "CloudOwner", "cloud-region-id": "RegionOne", "cloud-region-version": "v1", "resource-version": "1509587770092" }, "extra-properties": { "extra-property": [] } } ] } } ] } } ] }
SO API Interaction
vDNS - SO Request (TODO - Update) Expand source
https://{so}/serviceInstantiation/v7/3b12f31f-8f2d-4f5c-b875-61ff1194b941/vnfs/db373a8d-f7be-4d02-8ac8-6ca4c305d144/vfModules/scaleOut { "requestDetails": { "modelInfo": { "modelType": "vfModule", "modelInvariantId": "356a1cff-71f2-4086-9980-a2927ce11c1c", "modelVersionId": "6b93d804-cfc8-4be3-92cc-9336d135859a", "modelName": "Vloadbalancer..dnsscaling..module-1", "modelVersion": "1" }, "cloudConfiguration": { "lcpCloudRegionId": "RegionOne", "tenantId": "41d6d38489bd40b09ea8a6b6b852dcbd" }, "requestInfo": { "instanceName": "my_module_3", "source": "POLICY", "suppressRollback": false, "requestorId": "policy" }, "relatedInstanceList": [ { "relatedInstance": { "instanceId": "e6e99b38-7e3c-49ad-ad90-617c6c710a02", "instanceName": "my_module_3_vol", "modelInfo": { "modelType": "volumeGroup" } } }, { "relatedInstance": { "instanceId": "3b12f31f-8f2d-4f5c-b875-61ff1194b941", "modelInfo": { "modelType": "service", "modelInvariantId": "1321d60d-f7ff-4300-96c2-6bf0b3268b7a", "modelVersionId": "732d4692-4b97-46f9-a996-0b3339e88c50", "modelName": "vLoadBalancer-1106", "modelVersion": "1.0" } } }, { "relatedInstance": { "instanceId": "db373a8d-f7be-4d02-8ac8-6ca4c305d144", "modelInfo": { "modelType": "vnf", "modelInvariantId": "cee050ed-92a5-494f-ab04-234307a846dc", "modelVersionId": "fd65becc-6b2c-4fe8-ace9-cc29db9a3da2", "modelName": "vLoadBalancer", "modelVersion": "1.0", "modelCustomizationName": "vLoadBalancer 0" } } } ], "requestParameters": { "usePreload": true, "userParams": [ { "name": "gtp_bind_addr", "value": "vmme_private_ip_0" }, { "name": "mmc", "value": "001" }, { "name": "mme_addr", "value": "vmme_private_ip_0" }, { "name": "mnc", "value": "01" }, { "name": "n_prob", "value": "50" }, { "name": "vnfHostIpAddress", "value": "veb_private_ip_0" } ] }, "configurationParameters": [ { "availability-zone": "$.vnf-topology.vnf-resource-assignments.availability-zones.availability-zone[0]", "xtz-123": "$.vnf-topology.vnf-resource-assignments.availability-zones.availability-zone[0]" } ] } }
vDNS - SO Response ACCEPTED (TODO - Update) Expand source
{ "requestReferences": { "requestId": "60533ee3-814d-4949-be93-e6b26aace580" }, "request": { "requestId":"d5bc27f2-1d5c-405d-a985-3e3f544c1582", "requestStatus": { "percentProgress": 0, "requestState": "COMPLETE", "wasRolledBack": false } }, "httpResponseCode": 0 }
vDNS - SO Response SUCCESS (TODO - Add) Expand source
TODO - this is new work
vFirewall
Policy Creation
vFirewall - TCA Configuration Policy Payload Expand source
tca_policy: "{ "domain": "measurementsForVfScaling", "metricsPerEventName": [ { "eventName": "vFirewallBroadcastPackets", "controlLoopSchemaType": "VNF", "policyScope": "DCAE", "policyName": "DCAE.Config_tca-hi-lo", "policyVersion": "v0.0.1", "thresholds": [ { "closedLoopControlName": "ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a", "version": "1.0.2", "fieldPath": "$.event.measurementsForVfScalingFields.vNicUsageArray[*].receivedTotalPacketsDelta", "thresholdValue": 300, "direction": "LESS_OR_EQUAL", "severity": "MAJOR", "closedLoopEventStatus": "ONSET" }, { "closedLoopControlName": "ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a", "version": "1.0.2", "fieldPath": "$.event.measurementsForVfScalingFields.vNicUsageArray[*].receivedTotalPacketsDelta", "thresholdValue": 700, "direction": "GREATER_OR_EQUAL", "severity": "CRITICAL", "closedLoopEventStatus": "ONSET" } ] } ] }"
vFirewall - Create Config Policy Expand source
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{ "configBody": "{ \"service\": \"tca_policy\", \"location\": \"SampleServiceLocation\", \"uuid\": \"test\", \"policyName\": \"MicroServicevFirewall\", \"description\": \"MicroService vFirewall Policy\", \"configName\": \"SampleConfigName\", \"templateVersion\": \"OpenSource.version.1\", \"version\": \"1.1.0\", \"priority\": \"1\", \"policyScope\": \"resource=SampleResource,service=SampleService,type=SampleType,closedLoopControlName=ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a\", \"riskType\": \"SampleRiskType\", \"riskLevel\": \"1\", \"guard\": \"False\", \"content\": { \"tca_policy\": { \"domain\": \"measurementsForVfScaling\", \"metricsPerEventName\": [{ \"eventName\": \"vFirewallBroadcastPackets\", \"controlLoopSchemaType\": \"VNF\", \"policyScope\": \"DCAE\", \"policyName\": \"DCAE.Config_tca-hi-lo\", \"policyVersion\": \"v0.0.1\", \"thresholds\": [{ \"closedLoopControlName\": \"ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a\", \"version\": \"1.0.2\", \"fieldPath\": \"$.event.measurementsForVfScalingFields.vNicUsageArray[*].receivedTotalPacketsDelta\", \"thresholdValue\": 300, \"direction\": \"LESS_OR_EQUAL\", \"severity\": \"MAJOR\", \"closedLoopEventStatus\": \"ONSET\" }, { \"closedLoopControlName\": \"ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a\", \"version\": \"1.0.2\", \"fieldPath\": \"$.event.measurementsForVfScalingFields.vNicUsageArray[*].receivedTotalPacketsDelta\", \"thresholdValue\": 700, \"direction\": \"GREATER_OR_EQUAL\", \"severity\": \"CRITICAL\", \"closedLoopEventStatus\": \"ONSET\" } ] }] } } }", "policyConfigType": "MicroService", "policyName": "com.MicroServicevFirewall", "onapName": "DCAE" }' 'http://pdp:8081/pdp/api/createPolicy'
vFirewall - Operational Policy Expand source
controlLoop: version: 2.0.0 controlLoopName: ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a trigger_policy: unique-policy-id-1-modifyConfig timeout: 1200 abatement: false policies: - id: unique-policy-id-1-modifyConfig name: modify packet gen config description: actor: APPC recipe: ModifyConfig target: # TBD - Cannot be known until instantiation is done resourceID: Eace933104d443b496b8.nodes.heat.vpg type: VNF retry: 0 timeout: 300 success: final_success failure: final_failure failure_timeout: final_failure_timeout failure_retries: final_failure_retries failure_exception: final_failure_exception failure_guard: final_failure_guard
vFirewall - Create Operational Policy Expand source
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{ "configBody": "{ \"service\": \"tca_policy\", \"location\": \"SampleServiceLocation\", \"uuid\": \"test\", \"policyName\": \"MicroServicevFirewall\", \"description\": \"MicroService vFirewall Policy\", \"configName\": \"SampleConfigName\", \"templateVersion\": \"OpenSource.version.1\", \"version\": \"1.1.0\", \"priority\": \"1\", \"policyScope\": \"resource=SampleResource,service=SampleService,type=SampleType,closedLoopControlName=ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a\", \"riskType\": \"SampleRiskType\", \"riskLevel\": \"1\", \"guard\": \"False\", \"content\": { \"tca_policy\": { \"domain\": \"measurementsForVfScaling\", \"metricsPerEventName\": [{ \"eventName\": \"vFirewallBroadcastPackets\", \"controlLoopSchemaType\": \"VNF\", \"policyScope\": \"DCAE\", \"policyName\": \"DCAE.Config_tca-hi-lo\", \"policyVersion\": \"v0.0.1\", \"thresholds\": [{ \"closedLoopControlName\": \"ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a\", \"version\": \"1.0.2\", \"fieldPath\": \"$.event.measurementsForVfScalingFields.vNicUsageArray[*].receivedTotalPacketsDelta\", \"thresholdValue\": 300, \"direction\": \"LESS_OR_EQUAL\", \"severity\": \"MAJOR\", \"closedLoopEventStatus\": \"ONSET\" }, { \"closedLoopControlName\": \"ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a\", \"version\": \"1.0.2\", \"fieldPath\": \"$.event.measurementsForVfScalingFields.vNicUsageArray[*].receivedTotalPacketsDelta\", \"thresholdValue\": 700, \"direction\": \"GREATER_OR_EQUAL\", \"severity\": \"CRITICAL\", \"closedLoopEventStatus\": \"ONSET\" } ] }] } } }", "policyConfigType": "MicroService", "policyName": "com.MicroServicevFirewall", "onapName": "DCAE" }' 'http://pdp:8081/pdp/api/createPolicy'
vFirewall - Push Policies Expand source
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{ "pdpGroup": "default", "policyName": "com.BRMSParamvFirewall", "policyType": "BRMS_Param" }' 'http://pdp:8081/pdp/api/pushPolicy' curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{ "pdpGroup": "default", "policyName": "com.MicroServicevFirewall", "policyType": "MicroService" }' 'http://pdp:8081/pdp/api/pushPolicy'
DCAE Events and A&AI Enrichment (if necessary)
vFirewall - DCAE Control Loop Event (NOT enriched with A&AI) Expand source
{ "closedLoopEventClient": "DCAE_INSTANCE_ID.dcae-tca", "policyVersion": "1.0.0.5", "policyName": "vFirewall", "policyScope": "resource=SampleResource,service=SampleService,type=SampleType,closedLoopControlName=SampleClosedLoop", "target_type": "VNF", "AAI": { "generic-vnf.vnf-name": "zdfw1fwl01fwl02" }, "closedLoopAlarmStart": 1484855291527925, "closedLoopEventStatus": "ONSET", "closedLoopControlName": "ControlLoop-vFirewall-d0a1dfc6-94f5-4fd4-a5b5-4630b438850a", "version": "1.0.2", "target": "generic-vnf.vnf-name", "requestID": "8c1b8bd8-06f7-493f-8ed7-daaa4cc481bc", "from": "DCAE" }
vFirewall - A&AI generic-vnf query Expand source
https://{aai}/aai/v11/network/generic-vnfs/generic-vnf?vnf-name=zdfw1fwl01fwl02
vFirewall - A&AI generic-vnf query response Expand source
{ "vnf-id": "4e46ad6c-cebe-4460-858e-b5806883271b", "vnf-name": "vfw7f5a57d6", "vnf-type": "da818f33-97e1-4edf-98a5/5759f208-b75c-4b35-9599 0", "service-id": "a322c144-537c-4532-bf1b-0a4889083388", "prov-status": "PREPROV", "orchestration-status": "Created", "in-maint": false, "is-closed-loop-disabled": false, "resource-version": "1521467089262", "model-invariant-id": "a1efbbdd-2077-4b86-9fc0-244af99760f0", "model-version-id": "34c3221b-1326-4f35-9ed7-6f2f7e59d788", "model-customization-id": "1798c9a9-eaae-438f-bac3-b013599e8909", "nf-type": "", "nf-function": "", "nf-role": "", "nf-naming-code": "", "relationship-list": { "relationship": [ { "related-to": "service-instance", "related-link": "/aai/v11/business/customers/customer/DemoCust_7d454ef5-f5ea-4346-b2d3-e9797f5a57d6/service-subscriptions/service-subscription/vFW/service-instances/service-instance/7c45e4f7-aa7a-4130-9ee3-c5c1d81840df", "relationship-data": [ { "relationship-key": "customer.global-customer-id", "relationship-value": "DemoCust_7d454ef5-f5ea-4346-b2d3-e9797f5a57d6" }, { "relationship-key": "service-subscription.service-type", "relationship-value": "vFW" }, { "relationship-key": "service-instance.service-instance-id", "relationship-value": "7c45e4f7-aa7a-4130-9ee3-c5c1d81840df" } ], "related-to-property": [ { "property-key": "service-instance.service-instance-name", "property-value": "Service_Ete_Name7d454ef5-f5ea-4346-b2d3-e9797f5a57d6" } ] }, { "related-to": "vserver", "related-link": "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/tenants/tenant/50b190410b2a4c229d8a6044a80ab7c1/vservers/vserver/3f3f3c72-269d-45e6-8953-692424f2df1f", "relationship-data": [ { "relationship-key": "cloud-region.cloud-owner", "relationship-value": "CloudOwner" }, { "relationship-key": "cloud-region.cloud-region-id", "relationship-value": "RegionOne" }, { "relationship-key": "tenant.tenant-id", "relationship-value": "50b190410b2a4c229d8a6044a80ab7c1" }, { "relationship-key": "vserver.vserver-id", "relationship-value": "3f3f3c72-269d-45e6-8953-692424f2df1f" } ], "related-to-property": [ { "property-key": "vserver.vserver-name", "property-value": "demofwl01pgn" } ] }, { "related-to": "vserver", "related-link": "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/tenants/tenant/50b190410b2a4c229d8a6044a80ab7c1/vservers/vserver/4c45d0a4-a873-4d95-87ca-2a198322c9c4", "relationship-data": [ { "relationship-key": "cloud-region.cloud-owner", "relationship-value": "CloudOwner" }, { "relationship-key": "cloud-region.cloud-region-id", "relationship-value": "RegionOne" }, { "relationship-key": "tenant.tenant-id", "relationship-value": "50b190410b2a4c229d8a6044a80ab7c1" }, { "relationship-key": "vserver.vserver-id", "relationship-value": "4c45d0a4-a873-4d95-87ca-2a198322c9c4" } ], "related-to-property": [ { "property-key": "vserver.vserver-name", "property-value": "demofwl01snk" } ] }, { "related-to": "vserver", "related-link": "/aai/v11/cloud-infrastructure/cloud-regions/cloud-region/CloudOwner/RegionOne/tenants/tenant/50b190410b2a4c229d8a6044a80ab7c1/vservers/vserver/b96416ef-fc4e-49cb-8120-1d56686d2e90", "relationship-data": [ { "relationship-key": "cloud-region.cloud-owner", "relationship-value": "CloudOwner" }, { "relationship-key": "cloud-region.cloud-region-id", "relationship-value": "RegionOne" }, { "relationship-key": "tenant.tenant-id", "relationship-value": "50b190410b2a4c229d8a6044a80ab7c1" }, { "relationship-key": "vserver.vserver-id", "relationship-value": "b96416ef-fc4e-49cb-8120-1d56686d2e90" } ], "related-to-property": [ { "property-key": "vserver.vserver-name", "property-value": "vfw7f5a57d6" } ] } ] } }
APPC API Interaction
vFirewall - APPC Request Expand source
{ "CommonHeader": { "TimeStamp": 1500997725298, "APIver": "1.01", "RequestID": "664be3d2-6c12-4f4b-a3e7-c349acced200", "RequestTrack": [], "Flags": [] }, "Action": "ModifyConfig", "Payload": { "generic-vnf.vnf-id": "fw0001vm001fw001", "pg-streams": { "pg-stream": [ { "id": "fw_udp1", "is-enabled": "true" }, { "id": "fw_udp2", "is-enabled": "true" }, { "id": "fw_udp3", "is-enabled": "true" }, { "id": "fw_udp4", "is-enabled": "true" }, { "id": "fw_udp5", "is-enabled": "true" }] } } }
vFirewall - APPC Responses Expand source
ACCEPT response { "Status": { "Value": "ACCEPTED", "Code": "100" }, "Payload": { "pg-streams": "{\\\"pg-streams\\\": {\\\"pg-stream\\\":[{\\\"id\\\":\\\"fw_udp1\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp2\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp3\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp4\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp5\\\", \\\"is-enabled\\\":\\\"true\\\"}]}}", "generic-vnf.vnf-id": "fw0001vm001fw001" }, "CommonHeader": { "TimeStamp": "1493841850199", "APIver": "1.01", "RequestID": "664be3d2-6c12-4f4b-a3e7-c349acced200", "SubrequestID": null, "OriginatorID": null } } SUCCESS response { "Status": { "Value": "SUCCESS", "Code": "400" }, "Payload": { "pg-streams": "{\\\"pg-streams\\\": {\\\"pg-stream\\\":[{\\\"id\\\":\\\"fw_udp1\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp2\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp3\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp4\\\", \\\"is-enabled\\\":\\\"true\\\"},{\\\"id\\\":\\\"fw_udp5\\\", \\\"is-enabled\\\":\\\"true\\\"}]}}", "generic-vnf.vnf-id": "fw0001vm001fw001" }, "CommonHeader": { "TimeStamp": "1493841850199", "APIver": "1.01", "RequestID": "664be3d2-6c12-4f4b-a3e7-c349acced200", "SubrequestID": null, "OriginatorID": null } } TODO FAILED response
vCPE
Policy Creation and Pushing
vCPE - TCA Configuration Policy Payload Expand source
tca_policy: "{ "domain": "measurementsForVfScaling", "metricsPerEventName": [{ "eventName": "Measurement_vGMUX", "controlLoopSchemaType": "VNF", "policyScope": "DCAE", "policyName": "DCAE.Config_tca-hi-lo", "policyVersion": "v0.0.1", "thresholds": [{ "closedLoopControlName": "ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e", "version": "1.0.2", "fieldPath": "$.event.measurementsForVfScalingFields.additionalMeasurements[*].arrayOfFields[0].value", "thresholdValue": 0, "direction": "EQUAL", "severity": "MAJOR", "closedLoopEventStatus": "ABATED" }, { "closedLoopControlName": "ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e", "version": "1.0.2", "fieldPath": "$.event.measurementsForVfScalingFields.additionalMeasurements[*].arrayOfFields[0].value", "thresholdValue": 0, "direction": "GREATER", "severity": "CRITICAL", "closedLoopEventStatus": "ONSET" }] }] }"
vCPE - Create Config Policy Expand source
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{ "configBody": "{ \"service\": \"tca_policy\", \"location\": \"SampleServiceLocation\", \"uuid\": \"test\", \"policyName\": \"MicroServicevCPE\", \"description\": \"MicroService vCPE Policy\", \"configName\": \"SampleConfigName\", \"templateVersion\": \"OpenSource.version.1\", \"version\": \"1.1.0\", \"priority\": \"1\", \"policyScope\": \"resource=SampleResource,service=SampleService,type=SampleType,closedLoopControlName=ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e\", \"riskType\": \"SampleRiskType\", \"riskLevel\": \"1\", \"guard\": \"False\", \"content\": { \"tca_policy\": { \"domain\": \"measurementsForVfScaling\", \"metricsPerEventName\": [{ \"eventName\": \"Measurement_vGMUX\", \"controlLoopSchemaType\": \"VNF\", \"policyScope\": \"DCAE\", \"policyName\": \"DCAE.Config_tca-hi-lo\", \"policyVersion\": \"v0.0.1\", \"thresholds\": [{ \"closedLoopControlName\": \"ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e\", \"version\": \"1.0.2\", \"fieldPath\": \"$.event.measurementsForVfScalingFields.additionalMeasurements[*].arrayOfFields[0].value\", \"thresholdValue\": 0, \"direction\": \"EQUAL\", \"severity\": \"MAJOR\", \"closedLoopEventStatus\": \"ABATED\" }, { \"closedLoopControlName\": \"ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e\", \"version\": \"1.0.2\", \"fieldPath\": \"$.event.measurementsForVfScalingFields.additionalMeasurements[*].arrayOfFields[0].value\", \"thresholdValue\": 0, \"direction\": \"GREATER\", \"severity\": \"CRITICAL\", \"closedLoopEventStatus\": \"ONSET\" }] }] } } }", "policyConfigType": "MicroService", "policyName": "com.MicroServicevCPE", "onapName": "DCAE" }' 'http://pdp:8081/pdp/api/createPolicy'
vCPE Operational Policy Expand source
controlLoop: version: 2.0.0 controlLoopName: ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e trigger_policy: unique-policy-id-1-restart timeout: 3600 abatement: true policies: - id: unique-policy-id-1-restart name: Restart the VM description: actor: APPC recipe: Restart target: type: VM retry: 3 timeout: 1200 success: final_success failure: final_failure failure_timeout: final_failure_timeout failure_retries: final_failure_retries failure_exception: final_failure_exception failure_guard: final_failure_guard
vCPE - Create Operational Policy Expand source
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/html' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{ "policyConfigType": "BRMS_PARAM", "policyName": "com.BRMSParamvCPE", "policyDescription": "BRMS Param vCPE policy", "policyScope": "com", "attributes": { "MATCHING": { "controller" : "amsterdam" }, "RULE": { "templateName": "ClosedLoopControlName", "closedLoopControlName": "ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e", "controlLoopYaml": "controlLoop%3A%0D%0A++version%3A+2.0.0%0D%0A++controlLoopName%3A+ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e%0D%0A++trigger_policy%3A+unique-policy-id-1-restart%0D%0A++timeout%3A+3600%0D%0A++abatement%3A+true%0D%0A+%0D%0Apolicies%3A%0D%0A++-+id%3A+unique-policy-id-1-restart%0D%0A++++name%3A+Restart+the+VM%0D%0A++++description%3A%0D%0A++++actor%3A+APPC%0D%0A++++recipe%3A+Restart%0D%0A++++target%3A%0D%0A++++++type%3A+VM%0D%0A++++retry%3A+3%0D%0A++++timeout%3A+1200%0D%0A++++success%3A+final_success%0D%0A++++failure%3A+final_failure%0D%0A++++failure_timeout%3A+final_failure_timeout%0D%0A++++failure_retries%3A+final_failure_retries%0D%0A++++failure_exception%3A+final_failure_exception%0D%0A++++failure_guard%3A+final_failure_guard" } } }' 'http://pdp:8081/pdp/api/createPolicy'
vCPE - Push Policies Expand source
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{ "pdpGroup": "default", "policyName": "com.BRMSParamvCPE", "policyType": "BRMS_Param" }' 'http://pdp:8081/pdp/api/pushPolicy' curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{ "pdpGroup": "default", "policyName": "com.MicroServicevCPE", "policyType": "MicroService" }' 'http://pdp:8081/pdp/api/pushPolicy'
DCAE Events and A&AI Enrichment (if necessary)
vCPE - DCAE Control Loop Event (TCA) - NOT Enriched Expand source
{ "closedLoopControlName": "ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e", "version": "1.0.2", "requestID": "0abc0000-b032-4e4b-bd30-88260f444888", "closedLoopAlarmStart": 1478189220547, "closedLoopEventClient": "DCAE_INSTANCE_ID.dcae-tca", "target_type": "VNF", "target": "generic-vnf.vnf-name", "AAI": { "generic-vnf.vnf-name" : "vCPE_Infrastructure_vGMUX_demo_app" }, "from": "DCAE", "policyScope": "DCAE", "policyName": "DCAE.Config_tca-hi-lo", "policyVersion": "v0.0.1", "closedLoopEventStatus": "ONSET" }
vCPE - A&AI generic-vnf query Expand source
vCPE - A&AI generic-vnf query response Expand source
vCPE - DCAE Control Loop Event (TCA) - A&AI Enriched Expand source
DCAE ABATED Control Loop Event Expand source
{ "closedLoopControlName": "ControlLoop-vCPE-48f0c2c3-a172-4192-9ae3-052274181b6e", "version": "1.0.2", "requestID": "0abc0000-b032-4e4b-bd30-88260f444888", "closedLoopAlarmStart": 1478189220547, "closedLoopAlarmEnd": 1478589220547, "closedLoopEventClient": "DCAE_INSTANCE_ID.dcae-tca", "target_type": "VNF", "target": "generic-vnf.vnf-name", "AAI": { "generic-vnf.vnf-name" : "vCPE_Infrastructure_vGMUX_demo_app" }, "from": "DCAE", "policyScope": "DCAE", "policyName": "DCAE.Config_tca-hi-lo", "policyVersion": "v0.0.1", "closedLoopEventStatus": "ABATED" }
APPC API Interaction
APPC request Expand source
{ "body": { "input": { "common-header": { "timestamp": "2017-08-25T21:06:23.037Z", "api-ver": "2.00", "originator-id": "a20e2073-30b1-4357-893b-f5ed57b66ef0", "request-id": "a20e2073-30b1-4357-893b-f5ed57b66ef0", "sub-request-id": "1", "flags": {} }, "action": "Restart", "action-identifiers": { "vnf-id": "vCPE_Infrastructure_vGMUX_demo_app" } } }, "version": "2.0", "rpc-name": "restart", "correlation-id": "a20e2073-30b1-4357-893b-f5ed57b66ef0-1", "type": "request" }
APPC response Expand source
{ "body": { "output": { "common-header": { "timestamp": "2017-08-25T21:06:23.037Z", "api-ver": "2.00", "originator-id": "a20e2073-30b1-4357-893b-f5ed57b66ef0", "request-id": "a20e2073-30b1-4357-893b-f5ed57b66ef0", "sub-request-id": "1", "flags": {} }, "status": { "code": 400, "message": "Restart Successful" } } }, "version": "2.00", "rpc-name": "restart", "correlation-id": "a20e2073-30b1-4357-893b-f5ed57b66ef0-1", "type": "response" }
VOLTE
Policy Creation
NOTE: VOLTE Configuration Policy for Holmes does not exist. This gap should be addressed in the future.
VOLTE - Operational Policy Expand source
controlLoop: version: 2.0.0 controlLoopName: ControlLoop-VOLTE-2179b738-fd36-4843-a71a-a8c24c70c55b trigger_policy: unique-policy-id-1-restart timeout: 3600 abatement: false policies: - id: unique-policy-id-1-restart name: Restart the VM description: actor: VFC recipe: Restart target: type: VM retry: 3 timeout: 1200 success: final_success failure: final_failure failure_timeout: final_failure_timeout failure_retries: final_failure_retries failure_exception: final_failure_exception failure_guard: final_failure_guard
VOLTE - Create Operational Policy Expand source
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/html' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{ "policyConfigType": "BRMS_PARAM", "policyName": "com.BRMSParamVOLTE", "policyDescription": "BRMS Param VOLTE policy", "policyScope": "com", "attributes": { "MATCHING": { "controller" : "amsterdam" }, "RULE": { "templateName": "ClosedLoopControlName", "closedLoopControlName": "ControlLoop-VOLTE-2179b738-fd36-4843-a71a-a8c24c70c55b", "controlLoopYaml": "controlLoop%3A%0D%0A++version%3A+2.0.0%0D%0A++controlLoopName%3A+ControlLoop-VOLTE-2179b738-fd36-4843-a71a-a8c24c70c55b%0D%0A++trigger_policy%3A+unique-policy-id-1-restart%0D%0A++timeout%3A+3600%0D%0A++abatement%3A+false%0D%0A+%0D%0Apolicies%3A%0D%0A++-+id%3A+unique-policy-id-1-restart%0D%0A++++name%3A+Restart+the+VM%0D%0A++++description%3A%0D%0A++++actor%3A+VFC%0D%0A++++recipe%3A+Restart%0D%0A++++target%3A%0D%0A++++++type%3A+VM%0D%0A++++retry%3A+3%0D%0A++++timeout%3A+1200%0D%0A++++success%3A+final_success%0D%0A++++failure%3A+final_failure%0D%0A++++failure_timeout%3A+final_failure_timeout%0D%0A++++failure_retries%3A+final_failure_retries%0D%0A++++failure_exception%3A+final_failure_exception%0D%0A++++failure_guard%3A+final_failure_guard" } } }' 'http://pdp:8081/pdp/api/createPolicy'
VOLTE - Push Operational Policy Expand source
curl -v --silent -X PUT --header 'Content-Type: application/json' --header 'Accept: text/plain' --header 'ClientAuth: cHl0aG9uOnRlc3Q=' --header 'Authorization: Basic dGVzdHBkcDphbHBoYTEyMw==' --header 'Environment: TEST' -d '{ "pdpGroup": "default", "policyName": "com.BRMSParamVOLTE", "policyType": "BRMS_Param" }' 'http://pdp:8081/pdp/api/pushPolicy'
DCAE Events and A&AI Enrichment (if necessary)
DCAE Control Loop Event (HOLMES) - VOLTE Expand source
{ "closedLoopEventClient": "DCAE.HolmesInstance", "policyVersion": "1.0.0.5", "policyName": "vVOLTE", "policyScope": "resource=volte,service=VolteSErvice,type=SampleType,closedLoopControlName=CL-VOLTE-SIG-d925ed73-8231-4d02-9545-db4e101f88f8", "target_type": "VM", "AAI": { "vserver.vserver-name": "dfw1lb01lb01", "service-instance.service-instance-id" : "TBD", "generic-vnf.vnf-id" : "TBD", "generic-vnf.vnf-name" : "TBD" }, "closedLoopAlarmStart": 1484677482204798, "closedLoopEventStatus": "ONSET", "closedLoopControlName": "ControlLoop-VOLTE-2179b738-fd36-4843-a71a-a8c24c70c55b", "version": "1.0.2", "target": "vserver.vserver-name", "requestID": "97964e10-686e-4790-8c45-bdfa61df770f", "from": "DCAE" }
A&AI Call Expand source
This call is a simple GET in order to retrieve "is-closed-loop-diable" flag.
A&AI Response Expand source
Below is a sample GET response format. Field values are just examples. Will update to real values later. { "vnf-id": "5e49ca06-2972-4532-9ed4-6d071588d792", "vnf-name": "USUCP0PCOIL0110UJRT01", "vnf-type": "RT", "service-id": "d7bb0a21-66f2-4e6d-87d9-9ef3ced63ae4", "equipment-role": "UCPE", "orchestration-status": "created", "management-option": "ATT", "ipv4-oam-address": "32.40.68.35", "ipv4-loopback0-address": "32.40.64.57", "nm-lan-v6-address": "2001:1890:e00e:fffe::1345", "management-v6-address": "2001:1890:e00e:fffd::36", "in-maint": false, "is-closed-loop-disabled": false, "resource-version": "1493389458092", "relationship-list": {"relationship": [ { "related-to": "service-instance", "related-link": "https://aai-int1.test.att.com:8443/aai/v9/business/customers/customer/1610_Func_Global_20160817084727/service-subscriptions/service-subscription/uCPE-VMS/service-instances/service-instance/USUCP0PCOIL0110UJZZ01", "relationship-data": [ { "relationship-key": "customer.global-customer-id", "relationship-value": "1610_Func_Global_20160817084727" }, { "relationship-key": "service-subscription.service-type", "relationship-value": "uCPE-VMS" }, { "relationship-key": "service-instance.service-instance-id", "relationship-value": "USUCP0PCOIL0110UJZZ01" } ], "related-to-property": [{"property-key": "service-instance.service-instance-name"}] }, { "related-to": "vserver", "related-link": "https://aai-int1.test.att.com:8443/aai/v9/cloud-infrastructure/cloud-regions/cloud-region/att-aic/AAIAIC25/tenants/tenant/USUCP0PCOIL0110UJZZ01%3A%3AuCPE-VMS/vservers/vserver/3b2558f4-39d8-40e7-bfc7-30660fb52c45", "relationship-data": [ { "relationship-key": "cloud-region.cloud-owner", "relationship-value": "att-aic" }, { "relationship-key": "cloud-region.cloud-region-id", "relationship-value": "AAIAIC25" }, { "relationship-key": "tenant.tenant-id", "relationship-value": "USUCP0PCOIL0110UJZZ01::uCPE-VMS" }, { "relationship-key": "vserver.vserver-id", "relationship-value": "3b2558f4-39d8-40e7-bfc7-30660fb52c45" } ], "related-to-property": [ { "property-key": "vserver.vserver-name", "property-value": "USUCP0PCOIL0110UJZZ01-vsrx" }] } ]} }
VFC API Interaction
CCVPN
Policy Creation
CCVPN - Operational Policy Expand source
controlLoop: version: 2.0.0 controlLoopName: ControlLoop-CCVPN-2179b738-fd36-4843-a71a-a8c24c70c55b trigger_policy: unique-policy-id-16-receateE2EService timeout: 3600 abatement: false policies: - id: unique-policy-id-16-recreateE2EService name: Recreate E2E Service description: actor: SO recipe: Recreate_E2E_Service target: type: VM retry: 3 timeout: 1200 success: final_success failure: final_failure failure_timeout: final_failure_timeout failure_retries: final_failure_retries failure_exception: final_failure_exception failure_guard: final_failure_guard
DCAE Events and A&AI Enrichment (if necessary)
CCVPN - DCAE CL Event Expand source
{ "closedLoopEventClient": "DCAE.HolmesInstance", "policyVersion": "1.0.0.5", "policyName": "CCVPN", "policyScope": "service=SOTNService,type=SampleType,closedLoopControlName=CL-CCVPN-d925ed73-8231-4d02-9545-db4e101f88f8", "target_type": "VM", "AAI": { "vserver.vserver-name": "TBD", "service-instance.service-instance-id" : "service-instance-example-1,service-instance-example-2,service-instance-example-3", "service-instance-example-1.input-parameters" : "input-parameters-1", "service-instance-example-2.input-parameters" : "input-parameters-2", "service-instance-example-3.input-parameters" : "input-parameters-3" }, "closedLoopAlarmStart": 1484677482204798, "closedLoopEventStatus": "null", "closedLoopControlName": "ControlLoop-CCVPN-2179b738-fd36-4843-a71a-a8c24c70c55b", "version": "1.0.2", "target": "vserver.vserver-name", "requestID": "97964e10-686e-4790-8c45-bdfa61df770f", "from": "DCAE" }
Status Update
CCVPN - Update TP Status Expand source
URL: https://<AAI host>:<AAI port>/aai/v14/network/network-resources/network-resource/{networkId}/pnfs/pnf/{pnfName}/p-interfaces/p-interface/{ifName} Method: PATCH Request Body: { "operational-status": "some status" }
CCVPN - Update Logic-link Status Expand source
URL: https://<AAI host>:<AAI port>/aai/v14/network/logical-links/logical-link/{linkName} Method: PATCH Request Body: { "operational-status": "some status" }
Alarm Correlation
CCVPN - Query for Logical-links Expand source
URL: https://<AAI host>:<AAI port>/aai/v14/network/pnfs/pnf/{pnfName}/p-interfaces?interface-name={ifName}&operational-status={status} Method: GET Resquest Body: { } Response Body: { "results" : [ { "p-interface" : { "interface-name":{ifName}", "network-ref": "some ref", "transparent": "some blue", "operational-status":"[status}", "speed-value" : "some speed", "relationship-list": "relationship" : [ { "related-to" : "logic-link", "related-link" :'url of logical-link", "relationship-data":[ "relationship-key" : "logical-link.link.name", "relationship-value"; "some name" ] } ] } ] }
Service Instance Information Queries
CCVPN - Get vpn-binding from TP Expand source
URL: https://<AAI host>:<AAI port>/aai/v14/network/network-resources/network-resource/{networkId}/pnfs/pnf/{pnfName}/p-interfaces?interface-name={ifName}&operational-status={status} Method: GET Request Body: { } Response Body: { "results": [ { "p-interface": { "interface-name": "{ifName}", "network-ref": "some ref", "transparent": "some value", "operational-status ": "{status}", "speed-value": "some speed", "relationship-list": { "relationship" : [ { "related-to": "vpn-binding", "related-link": "url of vpn-binding", "relationship-data": [ "relationship-key": "vpn-binding.vpn-id", "relationship-value": "some id" ] } ] } } } ] }
CCVPN - Get connectivity from vpn-binding Expand source
URL: https://<AAI host>:<AAI port>/aai/v14/network/vpn-bindings?vpn-id={vpnId} Method: GET Request Body: { } Response Body: { "results": [ { "vpn-binding": { "vpn-id": "{vpnId}", "vpn-name": "some name", "access-provider-id": "provider id", "access-client-id": "client id", "access-topology-id": "topology id", "src-access-node-id": "src node id", "src-access-ltp-id": "src ltp id", "dst-access-node-id": "dst node id", "dst-access-ltp-id": "dst ltp id, "operational-status": "some status", "relationship-list": { "relationship" : [ { "related-to": "connectivity", "related-link": "url of connectivity", "relationship-data": [ "relationship-key": "connectivity. connectivity-id", "relationship-value": "some id" ] } ] } } } ] }
CCVPN - Query service instances by connectivity Expand source
URL: https://<AAI host>:<AAI port>/aai/v14/network/connectivities/connectivity/{connectivityId} Method: Get Request Body: { } Response Body: { "results": [ { "connectivity": { "connectivity-id": "{connectivityId}", "bandwidth-profile-name": "some profile", "vpn-type": "some type", "cir": "cir value", "eir": "eir value", "cbs": "cbs value", "ebs": "ebs value", "color-aware": "color value", "coupling-flag": "flag value", "etht-svc-name": "some name", "access-provider-id": "provider id", "access-client-id": "client id", "access-topology-id": "topology id", "access-node-id": "node id", "access-ltp-id": "ltp id", "connectivity-selflink": "some URL", "cvlan ": "some tag", "operational-status": "some status", "relationship-list": { "relationship" : [ { "related-to": "service-instance", "related-link": "url of service-instance", "relationship-data": [ "relationship-key": "service-instance.service-instance-id", "relationship-value": "some id" ] } ] } } ]
CCVPN - Get all 3 services instances from CCVPN Expand source
From service-instance URL: URL: https://<AAI host>:<AAI port>/aai/v14/business/customers/customer/{global-customer-id}/service-subscriptions/service-subscription/{service-type}/service-instances?service-instance-id={servId} Derive the service-subscription URL: URL: https://<AAI host>:<AAI port>/aai/v14/business/customers/customer/{global-customer-id}/service-subscriptions/service-subscription/{service-type} Method: GET Request Body: { } Response Body: { "results": [ { "service-subscription": { "service-type": "{service-type}", "temp-ub-sub-account-id": "some sub account", "service-instances": { "service-instance": [ { "service-instance-id": "some id 1", "service-instance-name": "some name 1", "environment-context": "some context 1", "workload-context": "some workload 1", "relationship-list": { "relationship" : [ ] } }, { "service-instance-id": "some id 2", "service-instance-name": "some name 2", "environment-context": "some context 2", "workload-context": "some workload 2", "relationship-list": { "relationship" : [ ] } }, { "service-instance-id": "some id 3", "service-instance-name": "some name 3", "environment-context": "some context 3", "workload-context": "some workload 3", "relationship-list": { "relationship" : [ ] } } ] }, "relationship-list": { "relationship" : [ ] } } } ] }
CCVPN - Query 'input-parameters' for 'service-instance' Expand source
URL: https://<AAI host>:<AAI port>/aai/v14/business/customers/customer/{global-custoner-id}/service-subscriptions/service-subscription/{service-type}/service-instances?service-instance-id={serviceId} Method: GET Request Body: { } Response Body: { "service-instance-id": "{service-instance-id}", "service-instance-name" : "instance name", "service-type": "some type", "service-role": "some role", "model-invariant-id": "model id", "model-version-id": "model version", "input-parameters:"request parameters", // ... This is the service instance recreation input looked up by CL. "resource-version": "some version" } Example of response body: { "service-instance-id": "176d9eba-1662-4289-8396-0097b50fd485", "service-type": "E2E Service", "service-role": "E2E Service", "model-invariant-id": "c22a9483-d2b6-49cc-b1f7-ef34c93572a1", "model-version-id": "71d0e396-e246-4c23-aa57-6da2043d6209", "input-parameters:".....;", // ... This is the service instance recreation input looked up by CL. "resource-version": "1528975017336" "relationship-list": { "relationship": [ { "related-to": "pnf", "related-link": "/aai/v11/network/pnfs/pnf/MME-0001", "relationship-data": [ { "relationship-key": "pnf.pnf-id", "relationship-value": "176d9eba-1662-4289-8396-0097b50fd466" } ], "related-to-property": [ { "property-key": "pnf.pnf-name", "property-value": "MME-0001" } ] } ] } }
SO API Interaction
- No labels