{"type":"doc","content":[{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"outline":{"value":"true"}},"macroMetadata":{"macroId":{"value":"9248dff1-530b-473b-8241-bf30946411e1"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}}}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Introduction and Approach","type":"text"}]},{"type":"paragraph","content":[{"text":"In ","type":"text"},{"text":"BBS","type":"text","marks":[{"type":"link","attrs":{"href":"https://lf-onap.atlassian.net/wiki/pages/viewpage.action?pageId=16324107"}}]},{"text":", notifications generated by the domain specific M&C (Access, Edge) into ONAP using the capabilities provided by ONAP's DCAE component and supported collectors that map the notifications into VES events for processing within ONAP.","type":"text"}]},{"type":"paragraph","content":[{"text":"For this release, BBS uses Restconf Collector to collect the notifications, converting the notification into the requisite VES event by the VES Mapper uS. The VES event placed on the DMaaP bus with a topic that can be consumed by the associated DCAE uS for processing. In many cases the DCAE uS uses ONAP's Policy capabilities to implement the function specific to the notification. The specific interactions are documented within the corresponding notification as identified below.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Supported Notifications","type":"text"}]},{"type":"paragraph","content":[{"text":"The primary scenarios for notifications within BBS are to support:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Registration and Re-registration of CPE PNFs","type":"text","marks":[{"type":"link","attrs":{"href":"https://lf-onap.atlassian.net/wiki/spaces/DW/pages/16334863"}}]},{"text":" (e.g., ONT) used to support the Nomadic ONT scenario","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Authentication state change of the gatewa","type":"text","marks":[{"type":"link","attrs":{"href":"https://lf-onap.atlassian.net/wiki/spaces/DW/pages/16342245"}}]},{"text":"y","type":"text","marks":[{"type":"link","attrs":{"href":"https://wiki.onap.org/pages/resumedraft.action?draftId=51283265&draftShareId=bc04dbb6-f761-4ced-95f0-f3b227a46b9d"}}]},{"text":" (e.g., residential) functionality associated with CPE PNFs that updates the operational state of the HSIA CFS.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Common Functionality","type":"text"}]},{"type":"paragraph","content":[{"text":"BBS Notifications have functionality provided by ONAP components that is used by multiple BBS Notifications","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"DCAE","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Restconf Collector","type":"text"}]},{"type":"paragraph","content":[{"text":"Notifications from domain specific controllers (Access, Edge) can be transmitted to ONAP using ONAP's Restconf collector leveraging the APIs specified in ","type":"text"},{"text":"CCVPN Closed Loop","type":"text","marks":[{"type":"link","attrs":{"href":"https://lf-onap.atlassian.net/wiki/display/DW/CCVPN+Closed+Loop"}}]},{"text":". ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":55.0},"content":[{"type":"media","attrs":{"width":640,"id":"ffb2d7b2-ddd2-4042-9509-680d9a49628c","collection":"contentId-16342241","type":"file","height":360}}]},{"type":"paragraph","content":[{"text":"Figure 2. Domain Controller ↔ Restconf Collector Interfacing Diagram","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"For BBS Notifications, the Restconf collector subscribes to notifications to the requisite domain controller (Access, Edge) for the notifications that ONAP is interested and the domain controller supports. For subscribed notifications, the Restconf Collector establishes a persistent connection with the domain controller through which the notifications are pushed by the domain controller to the Restconf Collector. The Restconf Collector then adds an OID for the Restconf2VES,xml file which is used to translate the event to the standard VES format by the VES Mapper and is published using the topic associated with the VES Event.","type":"text"}]},{"type":"paragraph","content":[{"text":"The association happens at design time to build JSON message with different topics of the Restconf_Notification with a certain Restconf2VES XML file indicator. In addition, the domain controller's IP/port, authentication information and produced topic could be assigned at design time at blue print creation through DCAE-DS and configurable at control loop creation time from CLAMP.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":55.0},"content":[{"type":"media","attrs":{"width":640,"id":"c7c8276f-0c57-4355-bebe-963daddedb78","collection":"contentId-16342241","type":"file","height":360}}]},{"type":"paragraph","content":[{"text":"VES","type":"text","marks":[{"type":"strong"}]},{"text":"=VES Collector ","type":"text"},{"text":" RCC","type":"text","marks":[{"type":"strong"}]},{"text":"=Restconf Collector thread ","type":"text"},{"text":"UVA","type":"text","marks":[{"type":"strong"}]},{"text":"=Universal VES Adaptor thread ","type":"text"},{"text":"SSE","type":"text","marks":[{"type":"strong"}]},{"text":"=SSE Connection","type":"text"}]},{"type":"paragraph","content":[{"text":"ORN","type":"text","marks":[{"type":"strong"}]},{"text":"=ONT Registration Notification ","type":"text"},{"text":"RN","type":"text","marks":[{"type":"strong"}]},{"text":"=Restconf Notification topic ","type":"text"},{"text":"PNF_R","type":"text","marks":[{"type":"strong"}]},{"text":"=PNF Registration Event","type":"text"}]},{"type":"paragraph","content":[{"text":"CPE_A","type":"text","marks":[{"type":"strong"}]},{"text":"=CPE Authentication Event ","type":"text"},{"text":"PRH","type":"text","marks":[{"type":"strong"}]},{"text":"=PNF Registration Handler ","type":"text"},{"text":"BBS MS","type":"text","marks":[{"type":"strong"}]},{"text":"= BBS Micro-service ","type":"text"}]},{"type":"paragraph","content":[{"text":"Figure 3. Logic flow of Restconf Collector through the VES Mapper","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example Domain Controller Notifications","type":"text"}]},{"type":"paragraph","content":[{"text":"The following provides examples of various notifications that are generated by the domain controllers (Access or Edge SDN M&C).","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"ONT Registration Notification","type":"text"}]},{"type":"paragraph","content":[{"text":"Following is an example of ONT Registration notification received from Access SDN M&C.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"ONT Registration Notification","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"{\n\t“notification”:\t{\n\t\t“event-time”: ”2018-03-15T08:15:32.000Z”,\n\t\t“notification-id”: ”2541256”,\n “message”:\t{\n\t\t\t“topic”：“resource”,\n “object-type”：“onu”, \n\t\t\t“version”: ”v1”, \n\t\t\t“operation”: “create”, \n\t\t\t“target”: ”ont/ont=23hk1231231232”, \n\t\t\t“content”:\t{\n\t\t\t\t“onu”:\t{\n\t\t\t\t\t\"sn\":\t\"48575443FA637D1A\",\n\t\t\t\t\t\"refParentNE\":\t\"550e8400-e29b-41d4-a716-446655440000\",\n \t\"refParentNeNativeId\":\t\"FDN\",\n\t\t\t\t\t\"refParentLTP\":\t\"8c0db89e-218c-4e18-b0de-7a6788b3dda4\",\n\t\t\t\t\t\"refParentLTPNativeId\":\t\"FDN\",\n \t\t\t\t\"onuId\": \"213\",\n \"accessID\":\t\"HG65875420001\"\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n}\n\n","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"The output of Restconf Collector for the ONT Registration is the above JSON message with certain rule_id being published on DMAAP with topic of restConf_Notification.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"ONT Registration RCC Output","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"{\n \"rule-id\": \"12121\",\n\t“notification”:\t{\n\t\t“event-time”: ”2018-03-15T08:15:32.000Z”,\n\t\t“notification-id”: ”2541256”,\n “message”:\t{\n\t\t\t“topic”：“resource”,\n “object-type”：“onu”, \n\t\t\t“version”: ”v1”, \n\t\t\t“operation”: “create”, \n\t\t\t“target”: ”ont/ont=23hk1231231232”, \n\t\t\t“content”:\t{\n\t\t\t\t“onu”:\t{\n\t\t\t\t\t\"sn\":\t\"48575443FA637D1A\",\n\t\t\t\t\t\"refParentNE\":\t\"550e8400-e29b-41d4-a716-446655440000\",\n \t\"refParentNeNativeId\":\t\"FDN\",\n\t\t\t\t\t\"refParentLTP\":\t\"8c0db89e-218c-4e18-b0de-7a6788b3dda4\",\n\t\t\t\t\t\"refParentLTPNativeId\":\t\"FDN\",\n \t\t\t\t\"onuId\": \"213\",\n \"accessID\":\t\"HG65875420001\"\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n}","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"RG Activation Notification","type":"text"}]},{"type":"paragraph","content":[{"text":"Following is an example of RG Activation notification received from Edge SDN M&C domain controller if the interface between DCAE and the domain controller is RestConf/Yang. In Dublin release, an Edge SDN M&C simulator is provided by SwissCom development team, which will interfacing with DCAE through VES Rest API and ","type":"text"},{"text":"VES CPE Authentication event","type":"text","marks":[{"type":"link","attrs":{"href":"https://lf-onap.atlassian.net/wiki/display/DW/CPE+Authentication+Notification#CPEAuthenticationNotification-CPEAuthenticationVESEvent"}}]},{"text":" will be delivered to DCAE directly. ","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"RG Activation Notification","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":" [\n {\n “notification”\n {\n “event-time”: ”2018-04-15T08:15:32.000Z”,\n “notification-id”: ”2541256”,\n “message”:\n {\n “topic”：“resource”,\n “object-type”：“Gateway”,\n “version”: ”v1”,\n “operation”: “Create”,\n “target”: \"Gateway/sn=83575443FA637D1A”,\n “content” :\n {\n “Gateway”:\n {\n “gatewaySN”：“83575443FA637D1A”, \n “mac”：“28-6E-D4-89-34-DD”, \n “pppoeUserName”: ”587564@163.com”, \n “ip”: \"10.68.52.158”,\n “state”:”Online”,\n “ontSN”：“48575443FA637D1A” \n } \n }\n }\n }\n } \n ]","type":"text"}]},{"type":"paragraph","content":[{"text":"The output of Restconf Collector for the RG Activation could be the above JSON message with certain rule_id being published on DMAAP with topic of restConf_Notification. ","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"RG Activation RCC Output","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"[\n\t {\n\t \"rule_id\" : \"example id\" \n\n },\n {\n “notification”\n {\n “event-time”: ”2018-04-15T08:15:32.000Z”,\n “notification-id”: ”2541256”,\n “message”:\n {\n “topic”：“resource”,\n “object-type”：“Gateway”,\n “version”: ”v1”,\n “operation”: “Create”,\n “target”: \"Gateway/sn=83575443FA637D1A”,\n “content” :\n {\n “Gateway”:\n {\n “gatewaySN”：“83575443FA637D1A”, \n “mac”：“28-6E-D4-89-34-DD”, \n “pppoeUserName”: ”587564@163.com”, \n “ip”: \"10.68.52.158”,\n “state”:”Online”,\n “ontSN”：“48575443FA637D1A” \n } \n }\n }\n }\n } \n ]","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"VES Mapper","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Restconf2VES Mapping","type":"text"}]},{"type":"paragraph","content":[{"text":"The Restconf2VES mapping rule (*.xml) is provided by the vendor for certain type of notification for ONT and defined as the following: ","type":"text"}]},{"type":"paragraph","content":[{"text":"The ONT Registration Notification is mapped to VES ","type":"text"},{"text":"PNF Registration Event","type":"text","marks":[{"type":"link","attrs":{"href":"https://lf-onap.atlassian.net/wiki/display/DW/PNF+Registration+and+Re-registration+Notification#PNFRegistrationandRe-registrationNotification-PNFRegistrationEvent"}}]},{"text":" .","type":"text"}]},{"type":"paragraph","content":[{"text":"The default mapping artifact (xml file) name is specified at the design time in VES Mapper micro-service blueprint at DCAE-DS and it is configurable through CLAMP at control loop creation time. The pre-condition is that the mapping file with correct naming convention should be available or on-boarded and stored in ONAP at design time. When the Nomadic ONT control loop is deployed, the mapping files retrievable and loaded to VES Mapper working space.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Mapping File for ONT Registration","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \"3.0\"\n \"pnfRegistration\"\n \"7.0\"\n \"registration_\"+commonEventHeader.ts1\n \"VESMapper\"\n \"pnfRegistration\"\n commonEventHeader.domain\n \n commonEventHeader.ts1\n commonEventHeader.ts1\n \"Normal\"\n \n \n \n \"2.0\"\n \n \n","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Below is the VES event for ONT Registration :","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"VES Event for ONT Registration","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"{\n \"event\":{\n \"commonEventHeader\":{\n \"domain\":\"pnfRegistration\",\n \"eventId\":\"registration_1550146312489\",\n \"eventName\":\"pnfRegistration\",\n \"lastEpochMicrosec\":1.550146312489E12,\n \"priority\":\"Normal\",\n \"reportingEntityName\":\"VESMapper\",\n \"sequence\":0,\n \"sourceName\":\"ont/ont=23hk1231231232\",\n \"startEpochMicrosec\":1.550146312489E12,\n \"version\":3.0,\n \"eventType\":\"pnfRegistration\",\n \"vesEventListenerVersion\":\"7.0\"\n },\n \"pnfRegistrationFields\":{\n \"pnfRegistrationFieldsVersion\":\"2.0\",\n \"serialNumber\":\"48575443FA637D1A\"\n }\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Test Cases","type":"text"}]},{"type":"paragraph","content":[{"text":"High Level Test Cases and Status:","type":"text"}]},{"type":"table","content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"#","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Sub Module","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Test Cases","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Status","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":7},"content":[{"type":"paragraph","content":[{"text":"Restconf Collector","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://lf-onap.atlassian.net/browse/DCAEGEN2-1142"}}]},{"type":"paragraph","content":[{"text":"PTL","type":"text"},{"type":"mention","attrs":{"id":"557058:b367c252-4683-46ef-a8d2-11b7a3f018f9","text":"@Vijay Kumar"}}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"SSE connection per notification type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#e0f0ff","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"NOT YET TESTED","type":"text","marks":[{"type":"textColor","attrs":{"color":"#253858"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"2","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Connection authentication run time configuration","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#e0f0ff","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"NOT YET TESTED","type":"text","marks":[{"type":"textColor","attrs":{"color":"#253858"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"3","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"VES mapping index run time configuration","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#e0f0ff","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"NOT YET TESTED","type":"text","marks":[{"type":"textColor","attrs":{"color":"#253858"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"4","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"ONT Registration notification Receiving/Processing","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#e0f0ff","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"NOT YET TESTED","type":"text","marks":[{"type":"textColor","attrs":{"color":"#253858"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"5","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"RCC MS on boarding at design time","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#e0f0ff","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"NOT YET TESTED","type":"text","marks":[{"type":"textColor","attrs":{"color":"#253858"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"6","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Instantiation of RCC MS with CL from CLAMP","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#e0f0ff","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"NOT YET TESTED","type":"text","marks":[{"type":"textColor","attrs":{"color":"#253858"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"7","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Configure RCC parameters at run time through CLAMP GUI","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#e0f0ff","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"NOT YET TESTED","type":"text","marks":[{"type":"textColor","attrs":{"color":"#253858"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"VES Mapper","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported