Versions Compared

Key

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

...

Issues & Decisions

#IssueNotesDecisions
1What dataspace and anchor to use?

Dataspace: NCMP-Admin 

Anchor: AVC-Subscriptions

2How do we load the data ( not using cps-core / not using Liquibase )?

Options

  1. Liquibase steps in CPS-Core (not preferred, adds to Technical Debt)
  2. Add Liquibase to NCMP (possible but would make NMCP install aware/dependent on Postgres)
  3. Startup Hooks that trigger CPS-Admin (rest or Java) interface calls
    1. Helm 
    2. Springboot
  4. Use of native SQL in an init container that runs after Liquibase (assumption: Liquibase runs from an init container)

Need to discuss with stakeholders re. Priority and Cost


Tony: Preference over native SQL in an init container

3

Predicate details are unclear at the moment. Which component(s) processes the predicates?! Device, DMI-Plugin and or NCMP


Code Block
languagexml
titlePredicate Example
collapsetrue
"datastore": “passthrough-operational",  (O)
                "datastore-xpath-filter" : "//_3gpp-nr-nrm-nbdufunction:GNBDUFunction/ 
                       _3gpp-nr-nrm-nrcelldu:NRCellDU/ | //_3gpp-nr-nrm-gnbcuupfunction:GNBCUUPFunction// |
                      //_3gpp-nr-nrm-gnbcucpfunction:GNBCUCPFunction/_3gpp-nr-nrm-nrcelldu:NRCellCU// |
                     //_3gpp-nr-nrm-nrsectorcarrier:NRSectorCarrier//”



kieran mccarthy  confirmed that predicates is not to be included in the data infromation to be stored, hence not part of the YANG model to be defined.

Background

NCMP wil need to store which subscriptions are current for each cm-handle

...

The following yang model will be used to store the payload information of subscription data

Code Block
languagexml
titleSubscription YANG model
linenumberstrue
module subscription {
    yang-version 1.1;
    namespace "org:onap:ncmp:subscription";

    revision "2022-10-12" {
        description
        "NCMP subscription model";
    }

    container subscription-registry {
        
        list subscription {
            key "clientID clientName";

            leaf clientID {
                type string;
            }

            leaf clientName {
                type string;
            }

            leaf topic {
                type string;
            }

            leaf isTagged {
                type boolean;
            }
        }
    }
}


Image Added


Onboarding via docker container

Starting CPS requires running the project via a docker-compose file wherein the following services/containers are set up:

  • postgres database
  • cps-and-ncmp
  • zookeeper
  • kafka
  • ncmp-dmi-plugin

Adding a new container 'init-db' to run a script file that calls psql (postgres) and curl commands to upload the new YANG model:

  • docker-compose configuration of 'init-db' service
Code Block
  init-db:
    build: ./initfile
    environment:
      POSTGRES_USER: ${DB_USERNAME:-cps}
      POSTGRES_PASSWORD: ${DB_PASSWORD:-cps}
    volumes:
      - ./initfile:/docker-entrypoint-initdb.d/
      - ./model:/model/
    depends_on:
      db:
        condition: service_healthy
      cps-and-ncmp:
        condition: service_started
    • build - creates from the Dockerfile created which is based on postgres and added curl
    • environment - mandatory config values for postgres image; added same config values as the main Postgres DB used by cps
    • volumes : folders located inside cps project's docker-compose folder
      • -initfile: contains the bash script and Dockerfile
      • - model: contains the subscription model
    • depends_on: 
      • -db: healthcheck is added on the db container/service which leaves seconds after the database has started
      • -cps-and-ncmp: service should be started before init-db container is brought up
  •  
    • Service/Container 'init-db' is built from a customised image supported by a Dockerfile containing the following:
      • Image from Dockerfile is based from postgres image and added 'curl'

        Code Block
        # syntax=docker/dockerfile:1
        FROM postgres:14.1-alpine
        
        RUN apk --no-cache add curl




Image Added