The CBA and Data Dictionary are explained in the Modelling Concepts page here: Modeling Concepts
CDS will require a main components to be able to build a service instance, Following the instructions below in the following order to onboard the Data Dictionary and CBA Package.
- Load the latest DD.json and run the . dd.sh script in rancher.
- Once this is step is completed, access the CDS UI and upload the latest CBA and execute in the following sequence:
- Enrich
- Save
- Deploy
- if upload via SDC: Click on Download and use the Enriched CBA Package to onboard via SDC Artifact Deployment for the VF Model.
Controller Blueprint Package [Deploy the cba using CDS UI by following the steps of Enrich, Save, Deploy] | Data Dictionary |
|---|---|
NOTE:
| dd UPDATES IN cds ui with processor-db1.zip |
In ONAP Dublin release, those components need to be built manually.
After building the CBA and Data Dictionary, we can use the CDS UI to add the Data Dictionary to CDS, and to deploy the CBA in CDS.
First, we logon to CDS UI using the url http://<onap_ip_address>:30497.
Choose Controller Blueprint, select file, and update Metadata, the NEXT.
Notes:
- The UI currently doesn't throw exception on failures so please have the inspection network view enable.
Enrich, Save, Publish, and finally Deploy, and you should receive a success notification.
In ONAP Dublin release, if an error happens, there's no error shown to the user, so we need to show the browser console, in order to see if there's an error while deploying the CBA.
Notes:
- There are workarounds that we need. — "Naming" - resource-assignment content in the definition file and that needs to be removed.
If we want to add one Dictionary item, we start in the CDS UI home screen, select New Resource.
Paste the Dictionary Definition JSON string and submit.
If we want to add many Dictionary items, we can create a JSON list of all the dictionary items and save them in a file called dd.json, and then run the dd.sh script below in the same folder where dd.json is located.
#!/bin/bash # Author: abdelmuhaimen.seaudi@orange.com # Usage: name this script as dd.sh, and put the data dictionaries list JSON as dd.json in the same directory, and run dd.sh # dd.sh will read the dictionary list JSON from dd.json, will output to stdout the number of Defintions found, and will start pushing them one by one to CDS DB l=`jq '.|length' dd.json` echo "Found $l Dictionary Definition Entries" i=0 while [ $i -lt $l ] do echo "i = $i" d=`jq ".[$i]" dd.json` echo $d #REPLACE <cds-ui> with the IP Address of ONAP curl 'http://<cds-ui>:30497/resourcedictionary/save' -v -X POST -H 'Content-type: application/json' -d"$d" sleep 1 echo -e "\n*****************************************\n" i=$(( $i + 1 )) done
Introduction
The purpose of this article is to describe the vDNS use case distribution in Dublin Release.
What's new
The Controller Blueprint Archive CBA is a zip archive that hosts all the service model related artifacts (heat templates, blueprints, vtl templates, workflows, etc ... ) that can enable ONAP to assign and instantiate the service.
Controller Design Studio CDS should receive a notification when a new service model is distributed by SDC, and then CDS will download the CBA CSAR file and deploy it.
Distribution of a VNF CBA
Login to ONAP as Designer (cs0008/demo123456!), and click on SDC application.
Part 1 - Create a New Virtual Software Product
In SDC, select the ONBOARD button > click on Create New VSP button > fill in the Name, Vendor, Category , Description and select the Network Package for on-boarding procedure as illustrated below.
Once the forum is populated for New Software Product click on Create.
In Software Product Details Screen in SDC, the users must populate the license information and the software product. For the vLB CDS use case the software product for the heat package is obtain from the following link: vLB CDS HEAT PACKAGE.
Once the for License and Software Product Attachment is populated then click on the Submit button.
Part 2 - Create VF Model and Certify
Click on the Import VSP from the HOME page.
From the list of VSP, select the Specific vLB CDS VSP for IMPORT to create the VF in SDC.
We fill in the VF name and description, etc ..., and click "Create".
Click on "Deployment Artifact", then "Add other arifacts", and select the vDNS.zip CBA.
Check the artifact is uploaded OK, and click on "Certify".
Add a comment, and submit, you should receive a success notification, and we are back in SDC Home Screen.
Part 3 - Create Service Model, Certify and Distribute
Now, let's create a new service model, and add the newly created VF (including CBA artifact) to the new service model. Click on "Add Service"
Add service name and description, and click on "Create". Choose Instantiation Type: Macro.
Click on "Composition", and drag the VF we created from the palette on the left onto the canvas in the middle.
Then, click on "Submit for Testing".
Click on Properties Assignments, then click on the service name, e.g. "CDS-VNF-TEST" from the right bar.
Type "sdnc" in the filter box, and add the sdnc_model_name, sdnc_model_version, and sdnc_artifact_version, and click "Save".
Type "skip" in the filter box, and set "skip post instantiation" to FALSE, then click "Save".
Login as Tester (jm0007/demo123456!) and accept the new service.
Login as Governor (gv0001/demo123456!) and approve for distribution.
Login as Operator (op0001/demo123456!) and click on "Distribute".
Click on "Monitor" to check the progress of the distribution, and check that all ONAP components were notified, and downloaded the artifacts, and deployed OK.
