Versions Compared

Key

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

This page describes how to get the Istanbul release version of A1-Policy functions up and running using Docker.

...

  • Copy the default configuration file oran/a1-policy-management/config/application_configuration.json (Jakarta) to the current directory, then replace/amend the configuration with the sample demo configuration below.
    (Note the configuration below is just a sample, and should be updated to match particular deployments. 
    The deployment below assumes 4 near-RT-RICs exist - addressable at the URLs given. See the step "Run OSC Near-RT-RIC/A1 Simulator Docker Containers" below)

  • The controller URL (hostname, port), username and password values to access the A1 Controller (SDNC + A1 Adapter) must match the values configured for the SDNC-A1-Controller. (See the step "Run A1 Controller" further below). The port number for http is 8181.
    (Note the configuration below is just a sample, and should be updated to match particular deployments.  The deployment below assumes an A1 Controller function (SDNC) exists - addressable at the url given, using the authentication credentials given.)

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

  • The A1 Policy Management service can entirely by-pass the A1-Controller (SDNC + A1 Adapter) if desired - it is optional to access the near-RT-RIC through an A1-Controller.
    In the configuration the "controller" property is optional in the "ric" objects
    If all configured rics bypass the A1-Controller (do not have "controller" values) then the "controller" object at the top of the configuration can be omitted.
    If all configured rics bypass the A1-Controller there is no need to start an A1-Controller.

    title
    Info
    titleOptional: Bypass the A1-Controller - connect direct from A1-Policy Management Service

    There is no functional gain in accessing the near-RT-RIC through an A1-Controller.

    To bypass the  A1-Controller (SDNC + A1 Adapter), where the A1-Policy Management Service connects directly to the A1 Interface:

    • If all configured rics bypass the A1-Controller (do not have "controller" values) then the "controller" object at the top of the configuration can be omitted.
    • If all configured rics bypass the A1-Controller there is no need to start an A1-Controller.
    Expand


Sample application configuration

...

Code Block
languageyml
titleSample

...

: application_configuration.json
linenumberstrue

...

{
  "description": "Application configuration",
  "config": {    
    "

...

controller": [
      {
        "name": "

...

controller1",
        "baseUrl": "http://

...

sdnc_controller:8181",
        

...

"

...

userName": 

...

"admin",
        

...

"password": "Kp8bJ4SXszM0WXlhak3eHlcse2gAw84vaoGGmJvUy2U"
      }
    ],
    "ric": [
      {
        "name": "

...

ric1",
        "baseUrl": "http://

...

ric1:8085/",

...

 
        "managedElementIds": [
        ]
  

...

   

...

 

...

},
      

...

{
        "name": "

...

ric2",
        "baseUrl": "http://

...

ric2:8085/",  

...

     
        "managedElementIds": [
          "kista_

...

3",
          "kista_

...

4"
        ]
      },
       {
        "name": "

...

ric3",
        "baseUrl": "http://

...

ric3:8085/",
        "controller": "controller1", 
        "managedElementIds": [
          "kista_

...

5",
          "kista_

...

6"

...


        ]
 

...

     },
     

...

  {
        "

...

name": "ric4",
 

...

 

...

 

...

 

...

    "baseUrl": "http://ric4:8085/",
 

...

     

...

  

...

Sample application configuration

Code Block
languageyml
titleSample: application_configuration.json
linenumberstrue
{
  "description"controller": "Application configurationcontroller1", 
        "configmanagedElementIds": {[
          "controller": [kista_7",
         { "kista_8",
       "name": "controller1",
        "baseUrl": "http://sdnc_controller:8181",
        "userName": "admin",
        "password": "Kp8bJ4SXszM0WXlhak3eHlcse2gAw84vaoGGmJvUy2U"
      }
    ],
       "kista_9",
          "kista_10",
          "kista_11"
         ]
      }
    ]
  }
}


Info
titleOptional: Bypass the A1-Controller - connect direct from A1-Policy Management Service


Code Block
languageyml
titleSample Application Configuration - bypassing the A1-Controller
linenumberstrue
collapsetrue
{
  "description": "Application configuration",
  "config": {    
    "ric": [
      {
        "name": "ric1",
        "baseUrl": "http://ric1:8085/", 
        "managedElementIds": [
        ]
      },
      {
        "name": "ric2",
        "baseUrl": "http://ric2:8085/",       
        "managedElementIds": [
          "kista_3",
          "kista_4"
        ]
      },
       {
        "name": "ric3",
        "baseUrl": "http://ric3:8085/
", "controller":
"
controller1"
,
 
       "managedElementIds": [
          "kista_5",
          "kista_6"
        ]
      },
       {
        "name": "ric4",
        "baseUrl": "http://ric4:8085/",
"controller": "controller1",

        "managedElementIds": [
          "kista_7",
          "kista_8",
          "kista_9",
          "kista_10",
          "kista_11"
         ]
      }
    ]
  }
}



JSON Schema for the application configuration

...

ComponentRelease image and version tagStaging images and version tagManual snapshot (only available if manually built)
and version tag
A1 Policy Management Service

nexus3.onap.org:10002/onap/ccsdk-oran-a1policymanagementservice:1.3.1

nexus3.onap.org:10004/onap/ccsdk-oran-a1policymanagementservice:1.3.1-STAGING-latest

onap/ccsdk-oran-a1policymanagementservice:1.3.2-SNAPSHOT

SDNC imagenexus3.onap.org:10002/onap/sdnc-image:2.3.1nexus3.onap.org:10004/onap/sdnc-image:2.3.1-STAGING-latestonap/sdnc-image:2.3.2-SNAPSHOT

...