{"type":"doc","content":[{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph","content":[{"text":"Table of Contents","type":"text","marks":[{"type":"strong"}]}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"2f986f20-381a-46dd-a6b3-8c48dd3d9387"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}}}}]},{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"Design Principals","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the entire communication between SDN-R and CPS is via DMaaP","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"an exception might be when SDN-R uses CPS as lookup DB to complete a request to the network (lookup)","type":"text"}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"ONAP internal data vs. Network Function specific data","type":"text"}]},{"type":"paragraph","content":[{"text":"For backup or Initial (startup) configuration CPS could store the configuration data according to the Network Function (VNP, PNF) specific data models. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Such data is most likely not abstracted to be used for multi-vendor, multi-layer, multi-technology use cases and should/could not be used by µServices addressing such use cases.","type":"text"}]},{"type":"paragraph","content":[{"text":"Multi-vendor, multi-layer, multi-technology µServices require an abstract view of the network. Therefore a translation service is required to translate between ONAP internal data models and Network Function specific data models.","type":"text"}]},{"type":"paragraph","content":[{"text":"The database technology for the ONAP internal data must be well defined and so that model-translation-functions can be implemented accordingly. SQL based on in the MariaDB implementation seems to be the right choice.","type":"text"}]},{"type":"paragraph","content":[{"text":"The database technology for Network Function specific data depends on the data and the Network Function specific data schema. If the data model schema bases on YANG, which usually describes a data tree, then a non-SQL database, could be the right choice. ","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"drawio","parameters":{"macroParams":{"border":{"value":"true"},"diagramName":{"value":"data models"},"simpleViewer":{"value":"false"},"links":{"value":"auto"},"tbstyle":{"value":"top"},"lbox":{"value":"true"},"diagramWidth":{"value":"522"},"revision":{"value":"1"}},"macroMetadata":{"macroId":{"value":"d63a2350-c11e-4831-a9ff-4923f4d763f3"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"image","data":{"url":"https://ac.draw.io/connectImage?border=true&diagramName=data+models&simpleViewer=false&links=auto&tbstyle=top&lbox=true&diagramWidth=522&revision=1"}}],"title":"draw.io Diagram"}}}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Commands to SDN-R to get yang modules","type":"text"}]},{"type":"paragraph","content":[{"text":"The RestConf commands are available as vsCode REST Client format: ","type":"text"},{"text":"https://lf-onap.atlassian.net/wiki/download/attachments/16412605/cps-sdn-r-interfaceing.http?api=v2","type":"text","marks":[{"type":"link","attrs":{"href":"https://lf-onap.atlassian.net/wiki/download/attachments/16412605/cps-sdn-r-interfaceing.http?api=v2"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"To get the yang modules learnt by SDN-R it is recommended to request the yang-capabilites for each node (NetworkFunction).","type":"text"}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Environment Variables","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"@","type":"text","marks":[{"type":"textColor","attrs":{"color":"#569cd6"}}]},{"text":"protocol","type":"text","marks":[{"type":"textColor","attrs":{"color":"#9cdcfe"}}]},{"text":" = ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"text":"https","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ce9178"}}]},{"type":"hardBreak"},{"text":"@","type":"text","marks":[{"type":"textColor","attrs":{"color":"#569cd6"}}]},{"text":"host","type":"text","marks":[{"type":"textColor","attrs":{"color":"#9cdcfe"}}]},{"text":" = ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"text":"odlux.oam.smo.indigo.cosmos-lab.org","type":"text","marks":[{"type":"link","attrs":{"href":"http://odlux.oam.smo.indigo.cosmos-lab.org"}},{"type":"textColor","attrs":{"color":"#ce9178"}}]},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"type":"hardBreak"},{"text":"### @host = 10.41.1.2","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6a9955"}}]},{"type":"hardBreak"},{"text":"@","type":"text","marks":[{"type":"textColor","attrs":{"color":"#569cd6"}}]},{"text":"port","type":"text","marks":[{"type":"textColor","attrs":{"color":"#9cdcfe"}}]},{"text":" = ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"text":"443","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ce9178"}}]},{"type":"hardBreak"},{"text":"@","type":"text","marks":[{"type":"textColor","attrs":{"color":"#569cd6"}}]},{"text":"sdnrUsername","type":"text","marks":[{"type":"textColor","attrs":{"color":"#9cdcfe"}}]},{"text":" = ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"text":"admin","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ce9178"}}]},{"type":"hardBreak"},{"text":"@","type":"text","marks":[{"type":"textColor","attrs":{"color":"#569cd6"}}]},{"text":"sdnrPassword","type":"text","marks":[{"type":"textColor","attrs":{"color":"#9cdcfe"}}]},{"text":" = ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"text":"Kp8bJ4SXszM0WXlhak3eHlcse2gAw84vaoGGmJvUy2U","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ce9178"}}]}]},{"type":"paragraph","content":[{"text":"@","type":"text","marks":[{"type":"textColor","attrs":{"color":"#569cd6"}}]},{"text":"baseUrl","type":"text","marks":[{"type":"textColor","attrs":{"color":"#9cdcfe"}}]},{"text":" = ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"text":"{{protocol}}://{{host}}:{{port}}","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ce9178"}}]}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"RestConf Request","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Response ","type":"text","marks":[{"type":"strong"}]},{"text":"(partial)","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"}]}]}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Step #1","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#003366"}}]},{"text":" is the command to request all known node-ids (network-function-names):","type":"text","marks":[{"type":"textColor","attrs":{"color":"#003366"}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"### ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6a9955"}}]},{"text":"@name","type":"text","marks":[{"type":"textColor","attrs":{"color":"#9cdcfe"}}]},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6a9955"}}]},{"text":"getAllNodeIds","type":"text","marks":[{"type":"textColor","attrs":{"color":"#4ec9b0"}}]},{"type":"hardBreak"},{"text":"GET","type":"text","marks":[{"type":"textColor","attrs":{"color":"#c586c0"}}]},{"text":" {{baseUrl}}/rests/data/network-topology:network-topology/topology=topology-netconf?content=nonconfig&fields=node(node-id)","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"type":"hardBreak"},{"text":"Authorization:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#569cd6"}}]},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"text":"Basic {{sdnrUsername}} {{sdnrPassword}}","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ce9178"}}]},{"type":"hardBreak"},{"text":"Accept:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#569cd6"}}]},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"text":"application/yang-data+json","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ce9178"}}]}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"HTTP/1.1 200 OK\nContent-Length: 166\nContent-Type: application/yang-data+json\nDate: Wed, 09 Aug 2023 16:47:56 GMT\nExpires: Thu, 01 Jan 1970 00:00:00 GMT\nServer: nginx\nSet-Cookie: JSESSIONID=node01ea9dc8np27jcw3vocehlwcwo90929.node0; Path=/,rememberMe=deleteMe; Path=/; Max-Age=0; Expires=Tue, 08-Aug-2023 16:47:56 GMT; SameSite=lax\nX-Frame-Options: SAMEORIGIN\nConnection: close\n\n{\n \"network-topology:topology\": [\n {\n \"node\": [\n {\n \"node-id\": \"O-RU-11222\"\n },\n {\n \"node-id\": \"O-DU-1122\"\n },\n[...]","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"In ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#003366"}}]},{"text":"Step #2","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#003366"}}]},{"text":" the code should iterate over the list of node-ids to request the available yang capabilities. Here the example for node-id=O-RU-11222:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#003366"}}]},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"### ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6a9955"}}]},{"text":"@name","type":"text","marks":[{"type":"textColor","attrs":{"color":"#9cdcfe"}}]},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6a9955"}}]},{"text":"getConnectionStatus","type":"text","marks":[{"type":"textColor","attrs":{"color":"#4ec9b0"}}]},{"type":"hardBreak"},{"text":"@","type":"text","marks":[{"type":"textColor","attrs":{"color":"#569cd6"}}]},{"text":"node-id","type":"text","marks":[{"type":"textColor","attrs":{"color":"#9cdcfe"}}]},{"text":"=","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"text":"O-RU-11222","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ce9178"}}]},{"type":"hardBreak"},{"text":"GET","type":"text","marks":[{"type":"textColor","attrs":{"color":"#c586c0"}}]},{"text":" {{baseUrl}}/rests/data/network-topology:network-topology/topology=topology-netconf/node={{node-id}}?content=nonconfig&fields=netconf-node-topology:available-capabilities/available-capability/capability","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"type":"hardBreak"},{"text":"Authorization:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#569cd6"}}]},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"text":"Basic {{sdnrUsername}} {{sdnrPassword}}","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ce9178"}}]},{"type":"hardBreak"},{"text":"Accept:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#569cd6"}}]},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"text":"application/yang-data+json","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ce9178"}}]}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"HTTP/1.1 200 OK\nContent-Type: application/yang-data+json\nDate: Wed, 09 Aug 2023 16:56:05 GMT\nExpires: Thu, 01 Jan 1970 00:00:00 GMT\nServer: nginx\nSet-Cookie: JSESSIONID=node0zsfdafr3nv0m1bi3uymdui3uw90955.node0; Path=/,rememberMe=deleteMe; Path=/; Max-Age=0; Expires=Tue, 08-Aug-2023 16:56:05 GMT; SameSite=lax\nX-Frame-Options: SAMEORIGIN\nConnection: close\nTransfer-Encoding: chunked\n\n{\n \"network-topology:node\": [\n {\n \"netconf-node-topology:available-capabilities\": {\n \"available-capability\": [\n {\n \"capability\": \"urn:ietf:params:netconf:capability:with-defaults:1.0?basic-mode=explicit&also-supported=report-all,report-all-tagged,trim,explicit\"\n },\n {\n \"capability\": \"urn:ietf:params:netconf:capability:notification:1.0\"\n },\n[...]","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"In ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#003366"}}]},{"text":"Step #3","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#003366"}}]},{"text":" the capability attribute values must be parsed to identify the yang module name and its revision date. SDN-R provides the latest yang revision of the module, if no revision date is given.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#003366"}}]},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Here an example for the yang module 'o-ran-hardware' without the revision date in the request.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#003366"}}]}]},{"type":"paragraph","content":[{"text":"### ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6a9955"}}]},{"text":"@name","type":"text","marks":[{"type":"textColor","attrs":{"color":"#9cdcfe"}}]},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6a9955"}}]},{"text":"getASingleYangModuleNoRevision","type":"text","marks":[{"type":"textColor","attrs":{"color":"#4ec9b0"}}]},{"type":"hardBreak"},{"text":"@","type":"text","marks":[{"type":"textColor","attrs":{"color":"#569cd6"}}]},{"text":"yangModuleNoRevision","type":"text","marks":[{"type":"textColor","attrs":{"color":"#9cdcfe"}}]},{"text":"=","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"text":"o-ran-hardware","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ce9178"}}]},{"type":"hardBreak"},{"text":"#### from \"capability\": \"(urn:o-ran:hardware:1.0?revision=2022-12-05)o-ran-hardware\"","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6a9955"}}]},{"type":"hardBreak"},{"text":"#### .split(')')[1]","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6a9955"}}]},{"type":"hardBreak"},{"text":"GET","type":"text","marks":[{"type":"textColor","attrs":{"color":"#c586c0"}}]},{"text":" {{baseUrl}}/yang-schema/{{yangModuleNoRevision}}","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"type":"hardBreak"},{"text":"Authorization:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#569cd6"}}]},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"text":"Basic {{sdnrUsername}} {{sdnrPassword}}","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ce9178"}}]},{"type":"hardBreak"},{"text":"Accept:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#569cd6"}}]},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"text":"application/yang-data+json","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ce9178"}}]}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"HTTP/1.1 200 OK\nContent-Encoding: gzip\nContent-Type: text/plain\nDate: Wed, 09 Aug 2023 16:56:36 GMT\nServer: nginx\nX-Frame-Options: SAMEORIGIN\nConnection: close\nTransfer-Encoding: chunked\n\nmodule o-ran-hardware {\n yang-version 1.1;\n namespace \"urn:o-ran:hardware:1.0\";\n prefix o-ran-hw;\n\n import ietf-hardware {\n prefix hw;\n }\n\n import iana-hardware {\n prefix ianahw;\n }\n\n import ietf-yang-types {\n[...]","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"text":"Here an example for the yang module 'o-ran-sync' and the revision '2022-08-15' - such request is recommended, to ensure that the revision implemented by the network-function is used . ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#003366"}}]}]},{"type":"paragraph","content":[{"text":"### ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6a9955"}}]},{"text":"@name","type":"text","marks":[{"type":"textColor","attrs":{"color":"#9cdcfe"}}]},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6a9955"}}]},{"text":"getASingleYangModule","type":"text","marks":[{"type":"textColor","attrs":{"color":"#4ec9b0"}}]},{"type":"hardBreak"},{"text":"@","type":"text","marks":[{"type":"textColor","attrs":{"color":"#569cd6"}}]},{"text":"yangModule","type":"text","marks":[{"type":"textColor","attrs":{"color":"#9cdcfe"}}]},{"text":"=","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"text":"o-ran-sync","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ce9178"}}]},{"type":"hardBreak"},{"text":"@","type":"text","marks":[{"type":"textColor","attrs":{"color":"#569cd6"}}]},{"text":"revision","type":"text","marks":[{"type":"textColor","attrs":{"color":"#9cdcfe"}}]},{"text":"=","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"text":"2022-08-15","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ce9178"}}]},{"type":"hardBreak"},{"text":"#### from \"capability\": \"(urn:o-ran:sync:1.0?revision=2022-08-15)o-ran-sync\"","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6a9955"}}]},{"type":"hardBreak"},{"text":"GET","type":"text","marks":[{"type":"textColor","attrs":{"color":"#c586c0"}}]},{"text":" {{baseUrl}}/yang-schema/{{yangModule}}/","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"type":"hardBreak"},{"text":"Authorization:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#569cd6"}}]},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"text":"Basic {{sdnrUsername}} {{sdnrPassword}}","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ce9178"}}]},{"type":"hardBreak"},{"text":"Accept:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#569cd6"}}]},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#cccccc"}}]},{"text":"application/yang-data+json","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ce9178"}}]},{"type":"hardBreak"},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"The entire RESTCONF APIs can be uploaded from SDN-R as OpenAPI specification:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GET {{baseUrl}}/apidoc/explorer/index.html","type":"text","marks":[{"type":"link","attrs":{"href":"https://odlux.oam.smo.indigo.cosmos-lab.org/apidoc/explorer/index.html"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GET {{baseUrl}}/apidoc/openapi3/18/apis/single","type":"text","marks":[{"type":"link","attrs":{"href":"https://wiki.onap.org/GET {{baseUrl}}/apidoc/openapi3/18/apis/single/apidoc/openapi3/18/apis/single"}}]}]}]}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"HTTP/1.1 200 OK\nContent-Encoding: gzip\nContent-Type: text/plain\nDate: Wed, 09 Aug 2023 16:57:08 GMT\nServer: nginx\nX-Frame-Options: SAMEORIGIN\nConnection: close\nTransfer-Encoding: chunked\n\nmodule o-ran-sync {\n yang-version 1.1;\n namespace \"urn:o-ran:sync:1.0\";\n prefix o-ran-sync;\n\n import ietf-interfaces {\n prefix if;\n }\n\n import o-ran-interfaces {\n prefix o-ran-int;\n[...]","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"paragraph","content":[{"text":"Sequence Diagram","type":"text"}]},{"type":"paragraph","content":[{"text":"Status: under discussion 2020-03-01","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"plantuml","parameters":{"macroParams":{"__bodyContent":{"value":"''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' \n' Copyright 2020 highstreet technologies GmbH\n' Licensed under the Apache License, Version 2.0 (the \"License\"); \n' you may not use this file except in compliance with the License. \n' You may obtain a copy of the License at \n' \n' http://www.apache.org/licenses/LICENSE-2.0 \n' \n' Unless required by applicable law or agreed to in writing, software \n' distributed under the License is distributed on an \"AS IS\" BASIS, \n' WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. \n' See the License for the specific language governing permissions and \n' limitations under the License. \n\n@startuml\n\n' Diagram \ntitle \n ONAP SDN-R\n Interfacing with Configuration & Persistency Service (CPS)\nend title\n\nbox \"ONAP CCSDK/SDNC/SDN-R cluster\" #lightpink\n participant \"NetConf Provider\" as ncs\nend box\n\nbox \"ONAP CCSDK/SDNC/SDN-R cluster\" #gold\n participant \"ODL NetConf Client\" as ncc\n database \"md-sal\\nfile-system\" as mdsal\n participant \"RestConf Server\" as rcs\n participant \"DMaaP Consumer\" as ctrldc\n participant \"DMaaP Provider\" as ctrldp\nend box\n\nparticipant \"DMaaP\" as mb\n\nbox “Configuration & Persistency Service (CPS)” #lightblue\n participant \"DMaaP Consumer\" as dbdc\n ' participant \"DMaaP Provider\" as dbdp\n participant \"YANG-to-SQL\" as y2s\n participant \"A1-REST-to-SQL (?)\" as a2s\n database SQL as sql\nend box\n\nautonumber 10 10 \"[000]\"\n\n== start, idling ==\ndbdc -> mb: subscribe for topic(s) - topic-names?\ny2s -> rcs: synch-request\ny2s <- rcs: synch-response (MountPoints, ConnectionStatus,YANG-Capabilities)\ny2s -> rcs: download of new intersting YANG modules\ny2s <- rcs: YANG modules\ny2s -> y2s: process YANG modules\ny2s -> sql: Create INDEX, TABLE, ASSOCCIATION\n\nctrldc -> mb: subscribe for topic(s) - topic-names?\n\nloop every 5s\n dbdc -> mb: poll for updates\n dbdc <- mb: response (empty or new message)\nend loop\n\nloop every 5s\n ctrldc -> mb: poll for updates\n ctrldc <- mb: response (empty or new message)\nend loop\n\n== New YANG revision (e.g. atfer xNF Software upgrade) ==\n\nncc <-> ncs: Establish NetConf session\nncc -> ncs: Hello Message\nncc <- ncs: Capabilites (yang modules)\nncc -> ncs: download new YANG revision\nncc <- ncs: new YANG module\nncc -> mdsal: new YANG module\nncc -> mdsal: mountpoint operation update\nmdsal -> ctrldp: mountpoint operation update \nctrldp -> mb: mountpoint operation update \nmb-> dbdc: mountpoint operation update \ndbdc -> y2s: mountpoint operation update \ny2s -> y2s: analyse new YANG capabilities \ny2s -> rcs: download new YANG revision\nrcs -> mdsal: read new YANG revision\nrcs <- mdsal: YANG module\ny2s <- rcs: YANG module\ny2s -> y2s: process YANG modules\ny2s -> sql: Create INDEX, TABLE, ASSOCCIATION\n\n== READ data from network (proposed, to be discussed) ==\ndbdc -> rcs: RESTCONF HTTP-GET data from network (pnf-id; filter)\nrcs -> ncc: trigger ro \nncc -> ncs: NetConf ro \nncc <- ncs: NetConf \nrcs <- ncc: forward data\ndbdc <- rcs: RESTCONF response\ndbdc -> y2s: forward data\ny2s -> sql: strore data\n\n== SET data on network (???) ==\ny2s <-> mb: TO BE DEFINED\n\n' End Diagram\n' Format\nheader\n License\n Apache 2.0\nend header\n\nright footer \n Thanks to plantUml! \n 2020-03-01 | wiki.onap.org\nend footer\n\nskinparam backgroundColor #fefefe\n'skinparam handwritten true\nskinparam roundcorner 15\nskinparam componentStyle uml2\n\nskinparam databaseBorderColor #444444\nskinparam databaseBackgroundColor #fefefe\nskinparam databaseFontColor #444444\n\nskinparam component {\n BorderColor #666666\n BackgroundColor #fefefe\n}\n\nskinparam database {\n BorderColor #666666\n BackgroundColor #ffffdd\n}\n\nskinparam interface {\n BorderColor #666666\n BackgroundColor #fefefe\n FontColor #fefefe\n}\n\nskinparam node {\n FontColor #ffffff\n}\n\nskinparam sequence {\n MessageAlign left\n ArrowColor #2277dd\n ArrowFontColor #444444\n ActorBorderColor #444444\n LifeLineBorderColor #444444\n LifeLineBackgroundColor #eeeeee\n \n BoxBorderColor #444444\n\n GroupBorderColor #444444\n GroupBackgroundColor #eeeeee\n\n ParticipantBorderColor #444444\n ParticipantBackgroundColor #ffffdd\n ParticipantFontColor #444444\n\n ActorBackgroundColor #ffffdd\n 'ActorFontColor DeepSkyBlue\n 'ActorFontSize 17\n 'ActorFontName Aapex\n}\n\n@enduml\n\n"},"atlassian-macro-output-type":{"value":"INLINE"}},"macroMetadata":{"macroId":{"value":"5eb4487c-1b86-408c-893e-786e26255ca5"},"schemaVersion":{"value":"1"},"title":"plantuml"}}}},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"References","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://lf-onap.atlassian.net/browse/SDNC-1094"}}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Configuration Persistence Service Project","type":"text","marks":[{"type":"link","attrs":{"href":"https://lf-onap.atlassian.net/wiki/spaces/DW/pages/16398157"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"https://lf-onap.atlassian.net/wiki/display/DW/ConfigDB+and+impact+on+SDN-R","type":"text","marks":[{"type":"link","attrs":{"href":"https://lf-onap.atlassian.net/wiki/display/DW/ConfigDB+and+impact+on+SDN-R"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Configuration & Persistency Service R7","type":"text","marks":[{"type":"link","attrs":{"href":"https://lf-onap.atlassian.net/wiki/spaces/DW/pages/16419577"}}]}]}]}]}]}]}],"version":1}