Page Comparison

...

...

...

...

...

...

...

...

The objective of this page is to give you some basics about setting up ONAP PNF simulator and how to create a simple CDS blueprint model to perform DAY-N config-assign and config-deploy using CDS REST API interfaces.

• Setting up PNF simulator integration project

You can refer to PnP PNF Simulator -> NF Simulator wiki page to clone the GIT repo and start the required docker containers. We are interested in the sysrepo/sysrepo-netopeer2 docker container to load a simple YANG similar to vFW Packet Generator.

• You can also consider using the Netopeer docker container alone to bring up NETCONF server. You can download the docker compose file test-netopeer.tar.gz

• Start PNF simulator docker containers. You can consider changing the netopeer image verion to image: sysrepo/sysrepo-netopeer2:iop in docker-compose.yml file If you find any issues with the default image.

cd $HOME

git clone https://github.com/onap/integration.git

...

./simulator.sh stop

• Verify the that you have netopeer docker container are up and running. It will be mapped to host port 830

...

sysrepoctl -i -g /etc/sysrepo/yang/pg.yang

• Connect to netopeer docker container and execute the following commands to initialise the pg.yang model. You can leave this terminal up and running.

In the below steps we just initialise the Yang model with one pg-stream record. We will be using CDS to perform the day-1 configuration and day-2 configuration changes.

...

• You can use the attached either plain CBA  file (pnf-demo-pnf-bpunenriched.zip) or the enriched (PNF-DEMO-ENRICHED-WORKING.zip file ) file to enrich, save, publish and deploy from CDS UI.You can extract the above BP archive to find the Scripts/dd.json & Scripts/dd.sh. You execute the below command to populate the data dictionary (CDS_UI_PORT = 3000)using utility scripts under Scripts folder

• Setup CDS k8s environment by following Running CDS on Microk8s wiki page

• After Verify if you can see CDS k8s PODs

CDS Boot strap

The below script will load the CDS default model artifacts into CDS DB. You should get HTTP status 200 for the below command.

Get the default model "artifactName": "vFW-CDS"  loaded by bootstrap

Load PNF CDS blueprint model data dictionary

...

• CDS UI you should the all operation successful as shown below

Image Removed

Config-Assign

• The assumption is that all the below parameters for config-assign will sent as part of config-assing REST call

              Day-0 : config-assign parameters                          

                             pnf-ipv4-address, netconf-server-port, netconf-username, netconf-password, stream-count

...

curl --location --request POST 'http://localhost:30499/api/v1/execution-service/process' \
--header 'Content-Type: application/json;charset=UTF-8' \
--header 'Accept: application/json;charset=UTF-8,application/json' \
--header 'Authorization: Basic Y2NzZGthcHBzOmNjc2RrYXBwcw==' \
--header 'Host: cds-blueprints-processor-http:8080' \
--header 'Content-Type: text/plain' \
--data-raw '{
"actionIdentifiers": {
"mode": "sync",
"blueprintName": "pnf-netconf",
"blueprintVersion": "1.0.0",
"actionName": "config-assing"
},
"payload": {
"config-assign-request": {
"resolution-key": "day-0",
"config-assign-properties": {
"pnf-id": "abcd",
"pnf-ipv4-address": "192.168.122.20",
"netconf-password": "admin",
"netconf-username": "admin",
"netconf-server-port": "netconf-server-port",
"stream-count": "5"

}
}
},
"commonHeader": {
"subRequestId": "143748f9-3cd5-4910-81c9-a4601ff2ea58",
"requestId": "e5eb1f1e-3386-435d-b290-d49d8af8db4c",
"originatorId": "SDNC_DG"
}
}'

              Day-1 : config-assign parameters

                            pnf-ipv4-address, netconf-server-port, netconf-username, netconf-password, stream-count

Config-Deploy

• config-deploy request will send the Day-0 or Day-1 resolution key as part of the REST call.

            "resolution-key" : "day-1"    (OR)  "resolution-key" : "day-2"

• config-deploy should retrieve the Day-1 or Day-2 configuration based on the resolution-key and executes the NETCONF command processor Kotlin code

• TODO: REST API CURL Command for Day-1 configuration deployment

...

Check CDS database for PNF data dictionaries

You should see 6 rows as shown below

Create PNF CDS Blueprint archive pnf-demo.zip

Enrich PNF Bluerprint archive

Verify Enriched Blue pring archive /tmp/CBA/ENRICHED-CBA.zip

Deploy/Save the Blueprint into CDS database

Config-Assign

# The assumption is that we are using the same host to run PNF NETCONF simulator as well as CDS
# bash -x ./create-config-assing-data.sh day-1 LOCAL_HOST_IP_ADDRESS 5

• Create PNF configuration for resolution-key = day-1 (stream-count = 5)

You can verify the CURL command JSON pay load file  /tmp/day-n-pnf-config.json

Verify the day-1 NETCONF RPC payload in CDS DB you should see the NETCONF RPC with 5 streams (fw_udp_1 TO fw_udp_5)

• Create PNF configuration for resolution-key = day-2 (stream-count = 10)

You can verify the CURL command JSON pay load file  /tmp/day-n-pnf-config.json

Verify the day-2 NETCONF RPC payload in CDS DB you should see the NETCONF RPC with 5 streams (fw_udp_1 TO fw_udp_10)

Note:- Till this point CDS did not interact with the PNF simulator or device. We just created the day-1 and day-2 configurations and

stored in CDS database

Config-Deploy

This is to make CDS REST API calls to push the day-1 and day-2 configuration changes PNF simulator

• config-deploy  resoultion-key = day-1

Open a new terminal and tail CDS Blueprint processor logs and keep it running. We will need it to review the config-deploy actions

Push the NETCONF changes for day-1

# Command syntax
# bash -x ./process-config-deploy.sh RESOLUTION_KEY PNF_IP_ADDRESS
# resolution-key = day-1 you can look at the JSON payload /tmp/pnf-config-deploy.json

Verify the CDS blueprint processor logs and you should see NETCONF RPC OK response as shown below

Go back to PNF netopeer cli console and verify if you can  see 5 streams  fw_udp_1 to fw_udp_5 enabled

• config-deploy  resoultion-key = day-2

Push the NETCONF changes for day-2

# Command syntax
# bash -x ./process-config-deploy.sh RESOLUTION_KEY PNF_IP_ADDRESS
# resolution-key = day-1 you can look at the JSON payload /tmp/pnf-config-deploy.json

Verify the CDS blueprint processor logs and you should see NETCONF RPC OK response as shown below

Go back to PNF netopeer cli console and verify if you can  see 5 streams  fw_udp_1 to fw_udp_10 enabled