Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Project Requirements

  • Build Code

    • Build nonrtric containersPolicy Management Service container

      • Configure policy-agentPolicy Management Service

      • Build the code and create docker imagesimage

    • Build near-rt-ric-simulator container

      • Create docker image

    • Build NONRTRIC / A1 Policy control panel container

      • Verify controlpanel configuration

      • Build the code and create docker image

  • Run A1 Controller Docker Container

    • Open Daylight GUI

  • Run Near-RT RIC A1 Simulator Docker Containers

  • Run Policy-agent Docker Container

    • policy-agent Swagger API

  • Run Non-RT RIC Control Panel Docker Container

    • Open NONRTRIC / A1 Policy Control Panel UI

...

  • Java 11 (make sure that JAVA_HOME environment variable points to correct Java version)

  • Maven 3.6

  • Docker and docker-compose (latest)

Build Code

Build

...

Policy Management Service container

  • Download the nonrtric ccsdk/oran repo, guilin branch: 

     git clone "https://gerrit.onap.org/r/ccsdk/oran" -b guilin

Configure

...

the Policy Management Service

To support local test with two separate Near-RT RIC simulator instances:  

  • Update the existing oran/a1-policy-management/config/application_configuration.json with the configuration below

  • The controller hostname and port values come from and must match those defined in nonrtric/sdnc-a1-controller/in in the sdnc/oam repo oam/installation/src/main/yaml/docker-compose.yml (see the step "Build A1 Controller" further below). The port for http is 8181 and for https XXXX.

  • Any defined ric host names (in the name and baseUrl for each ric) must match the given docker container names in Near-RT RIC simulator startup - port is always the simulator's internal 8085 for http or 8185 for https

application_configuration.yaml


Code Block
languageyml
titleapplication-_configuration.yamljson
{
   "config": {
      "//description": "Application configuration",
      "controller": [
         {
            "name": "controller1",
            "baseUrl": "http://a1-sdnc_controller-_container:8181",
            "userName": "admin",
            "password": "Kp8bJ4SXszM0WXlhak3eHlcse2gAw84vaoGGmJvUy2U"
         }
      ],
      "ric": [
         {
            "name": "ric1",
            "baseUrl": "http://ric1:8085/",
            "controller": "controller1",
            "managedElementIds": [
               "kista_1",
               "kista_2"
            ]
         },
                  {
            "name": "ric2",
            "baseUrl": "http://ric2:8085/",
            "controller": "controller1",
            "managedElementIds": [
               "kista_3",
               "kista_4"
            ]
         }
      ]
   }
}


Build the code and create docker

...

image

To build docker image of the policy management service:

Code Block
languagebash
cd oran/a1-policy-management/
mvn clean install -Dmaven.test.skip=true
docker images

If the build is successfull successful an image with following name and tag shall be built, use the command 'docker images' to view newly built the images image in the local docker registry.

onap/ccsdk-oran-a1policymanagementservice:1.0.2-SNAPSHOT

Note, the image for the a1-controller cannot be built locally unless all the images it depends on are built, so the latest nexus available image from the nexus repository is used instead.

Build near-rt-ric-simulator container

Download the near-rt-ric-simulator repo (defaults to master branch - no guilin branch exists): 

...

.

...

Create docker image

...

Code Block
languagebash
cd a1-interface/near-rt-ric-simulator
docker build -t near-rt-ric-simulator:latest .
docker images

If the build is successfull an image with following name and tag shall be built, use the command 'docker images' to view the images in the local docker registry.

near-rt-ric-simulator:latest

Build NONRTRIC / A1 Policy control panel container

Download the nonrtric repo (defaults to master branch - no guilin branch exists): 

     git clone "https://gerrit.o-ran-sc.org/r/portal/nonrtric-controlpanel"

Verify controlpanel configuration

(warning) Note that nonrtric-controlpanel/webapp-backend/src/main/resources/application.properties default property value policycontroller.url.prefix = http://policy-agent-container:8081 assumes that policy agent is started with name policy-agent-container and exposes port 8081 (as is done below)! 

Build the code and create docker image

Code Block
languagebash
cd nonrtric-controlpanel
mvn clean install -Dmaven.test.skip=true
docker images

If the build is successfull an image with following name and tag shall be built, use the command 'docker images' to view the images in the local docker registry.

...

themeMidnight
onap/ccsdk-oran-a1policymanagementservice 1.0.2-SNAPSHOT

Build A1 Controller

A1 Policy Adapter is a feature developed within CCSDK which is then installed in SDNC Karaf Server. To build & run the A1 Adapter, you need to build the ccsdk & sdnc repo's.

The A1 Policy provides a Northbound Interface for A1 operations to do policy management in Near-RealTime RICs.

After you download the ccsdk/oran repo, build the project.Use the downloaded repo 'ccsk/oran' as in the previous step, "Build Policy Management Service container"

Code Block
languagebash
cd a1-adapter

mvn clean install -Dmaven.test.skip=true

After you build the A1 adapter artefacts, down below CCSDK repo's and build it,

ProjectRepoGerrit LinkCommandNote
CCSDKccsdk/parentgit clone "https://gerrit.onap.org/r/ccsdk/parent"
 
-b guilinmvn clean install -Dmaven.test.skip=trueIf the parent artefacts are not release you need to build this repo in order to build other ccsdk repo's (Including ccsdk/oran/a1-adapter)
CCSDKccsdk/featuregit clone "https://gerrit.onap.org/r/ccsdk/features"
 
-b guilinmvn clean install -Dmaven.test.skip=true
CCSDKccsdk/distributiongit clone "https://gerrit.onap.org/r/ccsdk/distribution"
 
-b guilinmvn clean install -Dmaven.test.skip=true -PdockerCreates the CCSDK docker image
SDNCsdnc/northboundgit clone "https://gerrit.onap.org/r/sdnc/northbound"
 
-b guilinmvn clean install -Dmaven.test.skip=true
SDNCsdnc/oamgit clone "https://gerrit.onap.org/r/sdnc/oam"
 
-b guilinmvn clean install -Dmaven.test.skip=true -PdockerCreates the SDNC docker image. Make sure you refer the right docker image version the pom file.(eg: you may need to update ccsdk.docker.version for onap/ccsdk-ansible-server-image from 1.0-STAGING-latest to 1.0-SNAPSHOT-latest)

Once you build all the projects, you will see the CCSDK & SDNC docker images,If the build is successful an image with following name and tag shall be built, use the command 'docker images' to view newly built the image in the local docker registry.

Code Block
languagebash
themeMidnight
onap/sdnc-image 2.1-SNAPSHOT-latest f902a050eead 7 weeks ago 2.44GBlatest
onap/sdnc-ansible-server-image latest
onap/admportal-sdnc-image 2.1.0-SNAPSHOT-20200924T135831Z f902a050eead 7 weeks ago 2.44GBlatest
onap/ccsdk-dgbuilder-image latest
onap/sdnc-ueb-listener-image 2.1.0-SNAPSHOT-latest f902a050eead 7 weeks ago 2.44GB
onap/sdnc-dmaap-listener-image latest f902a050eead 7 weeks ago 2.44GB
:latest

Run A1 Policy Adapter

To view the A1 policy operations, you need to run the SDNC docker image. This image has few other docker image dependency but not all are important for A1 policy testing. To bring up the sdnc container for A1 Policy Management testing you can do below change to the docker compose file,

Code Block
languagebash
In sdnc/oam repo 
export MTU=1024
cd sdnc/oam/installation/src/main/yaml
docker-compose up 

Edit the docker compose file and keep only sdnc & , maria db and ansible images. Rest of the images are not necessary for A1 Policy testing. However if you want to change the DG and run your own DG, you may need to keep the Directed Graph image.

...

docker run -p 8080:8080 --network=nonrtric-docker-net nexus3.o-ran-sc.org:10004/o-ran-sc/nonrtric-controlpanel:2.0.0-SNAPSHOT

Open NONRTRIC / A1 Policy Control Panel UI

...