1. UUI Configuration
Configure CST template UUID and Invariant UUID in slicing.properties file of uui-server microservice
...
|
5.
...
- We need a KUD vm with kubernetes installed, please follow below link to setup a KUD VM.
https://wiki.onap.org/display/DW/Kubernetes+Baremetal+deployment+setup+instructions/
Please find below script with required data to be populated in AAI, provide the tenant id of the openstack project
...
title | populate-init-data-to-AAI |
---|
#!/bin/bash
echo "Enter NFS Server: "
read nfsServer
echo "======== RUNNING AAI Data Populate ======="
echo $nfsServer
echo "===== Populating Customer"
curl -k --location -g --request PUT 'https://'$nfsServer':30233/aai/v21/business/customers/customer/5GCustomer' \
--header 'X-TransactionId: 42d3461d-074e-400e-93b1-c7ab5f48ce89' \
--header 'X-FromAppId: jimmy-postman' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic QUFJOkFBSQ==' \
--data-raw '{
"global-customer-id": "5GCustomer",
"subscriber-name": "5GCustomer",
"subscriber-type": "INFRA"
}'
echo "===== Populating owningEntity"
...
echo "===== Populating Platforms"
curl -k --location -g --request PUT 'https://'$nfsServer':30233/aai/v16/business/platforms/platform/test' \
--header 'X-TransactionId: 3c215f06-6ca5-4de4-8b75-bb06d002c922' \
--header 'X-FromAppId: jimmy-postman' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic QUFJOkFBSQ==' \
--data-raw '{
"platform-name": "test"
}'
echo "===== Populating Projects"
curl -k --location -g --request PUT 'https://'$nfsServer':30233/aai/v16/business/projects/project/Project-5GCustomer' \
--header 'X-TransactionId: 40c3addb-c661-4bd2-bf80-5160e4223776' \
--header 'X-FromAppId: jimmy-postman' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic QUFJOkFBSQ==' \
--data-raw '{
"project-name": "Project-5GCustomer"
}'
...
Policy Creation Steps
Refer Optimization Policy Creation Steps for optimization policy creation and deployment steps
Please find the sample policies for Option1 below,
View file | ||||
---|---|---|---|---|
|
Copy the policy files
unzip policies.zip |
Refer Policy Models and Sample policies - NSI selection for sample policies
Updated slice/service profile mapping - https://gerrit.onap.org/r/gitweb?p=optf/osdf.git;a=blob;f=config/slicing_config.yaml;h=179f54a6df150a62afdd72938c2f33d9ae1bd202;hb=HEAD
NOTE:
- The service name given for creating the policy must match with the service name in the request
For NST Selection based on latency constraint, please make sure you have updated the latency constraint as property in the design time template of NST as below,
- The scope fields in the policies should match with the value in the resourceSharingLevel(non-shared/shared). Do modify the policy accordingly.
- Check the case of the attributes with the OOF request with the attribute map (camel to snake and snake to camel) in config/slicing_config.yaml, if any mismatch found modify the attribute map accordingly.
You need to restart the OOF docker container once you updated the slicing_config.yaml, you can do it using the following steps,
- Login to the worker VM where the OOF container is running. You can find the worker node by running (kubectl get pods -n onap -o wide | grep dev-oof)
- Find the container using docker ps | grep optf-osdf
- Restart the container using docker restart <container id>
6. Core NF Simulator Setup
- We need a KUD vm with kubernetes installed, please follow below link to setup a KUD VM.
https://wiki.onap.org/display/DW/Kubernetes+Baremetal+deployment+setup+instructions/
Please find below script with required data to be populated in AAI, provide the tenant id of the openstack project
Expand title populate-init-data-to-AAI #!/bin/bash
echo "Enter NFS Server: "
read nfsServerecho "======== RUNNING AAI Data Populate ======="
echo $nfsServerecho "===== Populating Customer"
curl -k --location -g --request PUT 'https://'$nfsServer':30233/aai/v16v21/business/lines-of-business/line-of-business/LOB-customers/customer/5GCustomer' \
--header 'X-TransactionId: ffed720142d3461d-15ab074e-41ab400e-896093b1-6db2cd16a264c7ab5f48ce89' \
--header 'X-FromAppId: jimmy-postman' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic QUFJOkFBSQ==' \
--data-raw '{
"lineglobal-of-businesscustomer-id": "5GCustomer",
"subscriber-name": "LOB-5GCustomer"
}'echo "==,
"subscriber-type": "INFRA"
}'echo "===== = Populating ComplexowningEntity"
curl -k --location -g --request PUT 'https://'$nfsServer':30233/aai/v16/business/cloudowning-infrastructureentities/complexes/complex/clli2owning-entity/67f2e84c-734d-4e90-a1e4-d2ffa2e75849' \
--header 'X-TransactionId: 79ec2b553656171c-0e1a3188-4a8a4a3d-904cb29a-02d87a43fdc5284d2ba97ede' \
--header 'X-FromAppId: jimmy-postman' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic QUFJOkFBSQ==' \
--data-raw '{
"physicalowning-locationentity-id": "clli267f2e84c-734d-4e90-a1e4-d2ffa2e75849",
"physicalowning-locationentity-typename": "officeOE-5GCustomer",
"street1": "Dummy 1",
"city": "Kraków",
"postal-code": "30-000",
"country": "Poland",
"region": "Smaller Poland"
}'echo "======== Populating Cloud Region"curl -k --location -g --
}'echo "===== Populating Platforms"
curl -k --location -g --request PUT 'https://'$nfsServer':30233/aai/v16/cloud-infrastructure/cloud-regions/cloud-region/k8scloudowner4/k8sregionfourbusiness/platforms/platform/test' \
--header 'X-TransactionId: 34cac9143c215f06-d32c6ca5-45234de4-ac758b75-008db129bcc6bb06d002c922' \
--header 'X-FromAppId: jimmy-postman' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic QUFJOkFBSQ==' \
--data-raw '{
"cloudplatform-ownername": "k8scloudowner4test",
"cloud-region-id": "k8sregionfour",
"cloud-type": "k8s",
"owner-defined-type": "t1",
"cloud-region-version": "1.0",
"complex-name": "clli2",
"cloud-zone": "CloudZone",
"sriov-automation": false
}'echo "======== Populating Complex Cloud Region Relationship"curl -k --location -
}'echo "===== Populating Projects"
curl -k --location -g --request PUT 'https://'$nfsServer':30233/aai/v16/cloud-infrastructure/cloud-regions/cloud-region/k8scloudowner4/k8sregionfour/relationship-list/relationshipbusiness/projects/project/Project-5GCustomer' \
--header 'X-TransactionId: 1d65169740c3addb-0c65c661-4d214bd2-bad5bf80-299f95e4ddb65160e4223776' \
--header 'X-FromAppId: jimmy-postman' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic QUFJOkFBSQ==' \
--data-raw '{
"relatedproject-toname": "complex",
"related-link": "Project-5GCustomer"
}'echo "====== Populating Line of Business"
curl -k --location -g --request PUT 'https://'$nfsServer':30233/aai/v16/business/cloudlines-of-infrastructure/complexes/complex/clli2",
"relationship-data": [
{
"relationship-key": "complex.physical-location-id",
"relationship-value": "clli2"
}
]
business/line-of-business/LOB-5GCustomer' \
--header 'X-TransactionId: ffed7201-15ab-41ab-8960-6db2cd16a264' \
--header 'X-FromAppId: jimmy-postman' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic QUFJOkFBSQ==' \
--data-raw '{
"line-of-business-name": "LOB-5GCustomer"
}'echo "======== Populating ServiceComplex"
curl -k --location -g --request PUT 'https://'$nfsServer':30233/aai/v16/service-design-and-creation/services/service/5Gcloud-infrastructure/complexes/complex/clli2' \
--header 'X-TransactionId: db58cf7379ec2b55-f4200e1a-4f074a8a-8cab904c-801474c9303c02d87a43fdc5' \
--header 'X-FromAppId: jimmy-postman' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic QUFJOkFBSQ==' \
--data-raw '{
"physical-location-id": "clli2",
"service-descriptionphysical-location-type": "office",
"street1": "5GCore on K8sDummy 1",
"city": "Kraków",
"service-idpostal-code": "30-000",
"country": "Poland",
"region": "5GSmaller Poland"
}'
echo "======== Populating Service SubscriptionCloud Region"curl -k --location -g --request PUT 'https://'$nfsServer':30233/aai/v16/business/customers/customer/5GCustomer/service-subscriptions/service-subscription/5Gcloud-infrastructure/cloud-regions/cloud-region/k8scloudowner4/k8sregionfour' \
--header 'X-TransactionId: c385a48c34cac914-cf4bd32c-4fcd4523-976cac75-2d9cad40b19e008db129bcc6' \
--header 'X-FromAppId: jimmy-postman' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic QUFJOkFBSQ==' \
--data-raw '{
"service-type": "5G"
}'echo "======== Populating Tenant"
curl -k --location -g --request PUT 'https://'$nfsServer':30233/aai/v16/cloud-infrastructure/cloud-regions/cloud-region/k8scloudowner4/k8sregionfour/tenants/tenant/3d5819f1542e4ef9a4ccb0bcb278ca10' \
echo "======== Populating availability zone name"
--header 'X-TransactionId: c229f2aa-ea0f-4057-a9dd-0144b6e0e72a' \
--header 'X-FromAppId: jimmy-postman' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic QUFJOkFBSQ==' \
--data-raw '{
"tenant-id": "3d5819f1542e4ef9a4ccb0bcb278ca10",
"tenant-name": "ONAP-tm",
"relationship-list": {
"relationship": [
{
"related-to": "service-subscription",
"relationship-label": "org.onap.relationships.inventory.Uses",
"related-link": "/aai/v16/business/customers/customer/5GCustomer/service-subscriptions/service-subscription/5G",
"relationship-data": [
{
"relationship-key": "customer.global-customer-id",
"relationship-value": "5GCustomer"
},
{
"relationship-key": "service-subscription.service-type",
"relationship-value": "5G"
}
]
}
]
}
}'curl -k --location -g --request PUT 'https://'$nfsServer':30233/aai/v16/cloud-infrastructure/cloud-regions/cloud-region/k8scloudowner4/k8sregionfour/availability-zones/availability-zone/k8savz' \
echo "=========================== Finished Populating AAI Data ============="
--header 'X-TransactionId: c229f2aa-ea0f-4057-a9dd-0144b6e0e72a' \
--header 'X-FromAppId: jimmy-postman' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic QUFJOkFBSQ==' \
--data-raw '{
"availability-zone-name": "k8savz",
"hypervisor-type": "k8s"
}'- After KUD setup and AAI data entries, update the connectivity Info: <port: msb-iag port>
curl -k -i -F "metadata=<post.json;type=application/json" -F file=@/root/.kube/config -X POST https://{{k8s}}:32330/api/multicloud-k8s/v1/v1/connectivity-info
Please find post.json below,
{
"cloud-region": "k8sregionfour",
"cloud-owner": "k8scloudowner4"
}
- We need to load the dictionary data using the dd.sh script,
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
#!/bin/bash
# Author: abdelmuhaimen.seaudi@...
# 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
result=$(curl 'http://cds-ui:8080/api/v1/dictionary' -v -X POST -H 'Content-type: application/json' -H 'Authorization: Basic Y2NzZGthcHBzOmNjc2RrYXBwcw==' -d"$d")
echo $result
sleep 1
echo -e "\n*****************************************\n"
i=$(( $i + 1 ))
done
|
...
title | dd.json |
---|
...
' \
--header 'Accept: application/json' \
--data-raw '{
"cloud-owner": "k8scloudowner4",
"cloud-region-id": "k8sregionfour",
"cloud-type": "k8s",
"owner-defined-type": "t1",
"cloud-region-version": "1.0",
"complex-name": "clli2",
"cloud-zone": "CloudZone",
"sriov-automation": false
}'
echo "======== Populating Complex Cloud Region Relationship"curl -k --location -g --request PUT 'https://'$nfsServer':30233/aai/v16/cloud-infrastructure/cloud-regions/cloud-region/k8scloudowner4/k8sregionfour/relationship-list/relationship' \
--header 'X-TransactionId: 1d651697-0c65-4d21-bad5-299f95e4ddb6' \
--header 'X-FromAppId: jimmy-postman' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic QUFJOkFBSQ==' \
--data-raw '{
"related-to": "complex",
"related-link": "/aai/v16/cloud-infrastructure/complexes/complex/clli2",
"relationship-data": [
{
"relationship-key": "complex.physical-location-id",
"relationship-value": "clli2"
}
]
}'echo "======== Populating Service"
curl -k --location -g --request PUT 'https://'$nfsServer':30233/aai/v16/service-design-and-creation/services/service/5G' \
--header 'X-TransactionId: db58cf73-f420-4f07-8cab-801474c9303c' \
--header 'X-FromAppId: jimmy-postman' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic QUFJOkFBSQ==' \
--data-raw '{
"service-description": "5GCore on K8s",
"service-id": "5G"
}'echo "======== Populating Service Subscription"
curl -k --location -g --request PUT 'https://'$nfsServer':30233/aai/v16/business/customers/customer/5GCustomer/service-subscriptions/service-subscription/5G' \
--header 'X-TransactionId: c385a48c-cf4b-4fcd-976c-2d9cad40b19e' \
--header 'X-FromAppId: jimmy-postman' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic QUFJOkFBSQ==' \
--data-raw '{
"service-type": "5G"
}'echo "======== Populating Tenant"
curl -k --location -g --request PUT 'https://'$nfsServer':30233/aai/v16/cloud-infrastructure/cloud-regions/cloud-region/k8scloudowner4/k8sregionfour/tenants/tenant/3d5819f1542e4ef9a4ccb0bcb278ca10' \
--header 'X-TransactionId: c229f2aa-ea0f-4057-a9dd-0144b6e0e72a' \
--header 'X-FromAppId: jimmy-postman' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic QUFJOkFBSQ==' \
--data-raw '{
"tenant-id": "3d5819f1542e4ef9a4ccb0bcb278ca10",
"tenant-name": "ONAP-tm",
"relationship-list": {
"relationship": [
{
"related-to": "service-subscription",
"relationship-label": "org.onap.relationships.inventory.Uses",
"related-link": "/aai/v16/business/customers/customer/5GCustomer/service-subscriptions/service-subscription/5G",
"relationship-data": [
{
"relationship-key": "customer.global-customer-id",
"relationship-value": "5GCustomer"
},
{
"relationship-key": "service-subscription.service-type",
"relationship-value": "5G"
}
]
}
]
}
}'
echo "======== Populating availability zone name"curl -k --location -g --request PUT 'https://'$nfsServer':30233/aai/v16/cloud-infrastructure/cloud-regions/cloud-region/k8scloudowner4/k8sregionfour/availability-zones/availability-zone/k8savz' \
--header 'X-TransactionId: c229f2aa-ea0f-4057-a9dd-0144b6e0e72a' \
--header 'X-FromAppId: jimmy-postman' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic QUFJOkFBSQ==' \
--data-raw '{
"availability-zone-name": "k8savz",
"hypervisor-type": "k8s"
}'
echo "=========================== Finished Populating AAI Data ============="- After KUD setup and AAI data entries, update the connectivity Info: <port: msb-iag port>
curl -k -i -F "metadata=<post.json;type=application/json" -F file=@/root/.kube/config -X POST https://{{k8s}}:32330/api/multicloud-k8s/v1/v1/connectivity-info
Please find post.json below,
{
"cloud-region": "k8sregionfour",
"cloud-owner": "k8scloudowner4"
}
- Load the dictionary data using the below dd.sh script,
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
#!/bin/bash
# Author: abdelmuhaimen.seaudi@...
# 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
result=$(curl 'http://cds-ui:8080/api/v1/dictionary' -v -X POST -H 'Content-type: application/json' -H 'Authorization: Basic Y2NzZGthcHBzOmNjc2RrYXBwcw==' -d"$d")
echo $result
sleep 1
echo -e "\n*****************************************\n"
i=$(( $i + 1 ))
done
|
Expand | ||
---|---|---|
| ||
[ |
...
value" |
Refer Core NF Simulator setup to setup Core NF Simulator.
7. RAN Simulator Setup
7a) RANSIM Controller
Refer RAN-Sim setup to setup RAN-simulator
Refer RAN-Sim for ransim impacts done for Guilin Release
7b) Honeycomb:
Repo URL: https://github.com/onap-oof-pci-poc/ran-sim
Pre-requisite: SDNC & Ransim controller should be up and running.
Build Steps:
If there is a new yang model, build the gnbsim-api with new yang model
Step 1: copy the new yang model to ~/ran-sim/hcsim-content/gnbsim/gnbsim-api/src/main/yang
Step 2: Go to directory ~/ran-sim/hcsim-content/gnbsim/gnbsim-api/
Step 3: Issue the build command "JAVA_HOME=/usr/lib/jvm/java-1.11.0-openjdk-amd64 mvn clean install -Dcheckstyle.skip"
For code changes in gnbsim-impl directory
Step 1: Do necessary code changes in gnbsim-impl
Step 2: Issue the build command "JAVA_HOME=/usr/lib/jvm/java-1.11.0-openjdk-amd64 mvn clean install -Dcheckstyle.skip"
Once the mvn build is done, build the docker image
Step 1: Go to directory ~/ran-sim/hcsim-content/gnbsim
Step 2: JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64/ mvn clean install -Dcheckstyle.skip
Step 3: cp -r gnbsim-distribution/jssecacerts gnbsim-distribution/target/gnbsim-distribution-1.19.08-SNAPSHOT-hc/gnbsim-distribution-1.19.08-SNAPSHOT/
Step 4: cp -r gnbsim-distribution/honeycomb gnbsim-distribution/target/gnbsim-distribution-1.19.08-SNAPSHOT-hc/gnbsim-distribution-1.19.08-SNAPSHOT/
Step 5: cp -r gnbsim-distribution/Dockerfile gnbsim-distribution/target/gnbsim-distribution-1.19.08-SNAPSHOT-hc/gnbsim-distribution-1.19.08-SNAPSHOT/
Step 6: docker build -t gn gnbsim-distribution/target/gnbsim-distribution-1.19.08-SNAPSHOT-hc/gnbsim-distribution-1.19.08-SNAPSHOT/
Cross check the docker image
docker images | grep gnbsim
To run the Netconf Servers:
- Update ransim and honeycom IP address at ~/ran-sim/hcsim-content/gnbsim/hc/config/gnbsim.json
2. Run the below command from ~/ran-sim/hcsim-content/gnbsim/hc directory.
docker-compose up -d
For slicing setup, 12 netconf servers are required. Copy the hc directory 11 more time and rename it.
Change the external port in the docker-compose files for every netconf server.
While running the docker-compose up -d command, these servers will be mounted in SDNC.
Setup SFPT:
- Run the below docker command in the VM where you have setup the netconf servers:
docker run -v /home/$USER/upload:/home/$USER/sftptest/upload -p 2222:22 -d atmoz/sftp $USER:pass:1001
2. Give chmod 777 to upload folder which will be created automatically in the home dir.
8. ConfigDB
Config DB is a spring boot application that works with mariaDB. DB schema details are available at Config DB.
Install config DB application in a separate VM. MariaDB container should be up and running to access the config DB APIs.
Refer https://wiki.onap.org/display/DW/Config+DB+setup for configDB setup. Latest source is available at Image versions, preparation steps and useful info-Config DB Preload Info Section.
Necessary RAN network functions data are preloaded in config DB while booting the maria DB container.
Note: Refer the latest templates from gerrit which are committed in June 2021. https://gerrit.onap.org/r/gitweb?p=ccsdk/distribution.git;a=commit;h=8b86f34f6ea29728e31c4f6799009e8562ef3b6f