...
CPS Data Notifications
CM VES Message
https://www.rfc-editor.org/rfc/rfc8641
O1 CM Update Notification VES Message
DMi Data AVC Sample Message
SON Use Case Weekly Meeting Notes
Assumptions
| # | Issue | Notes | Decisions |
|---|
| 1 | VES Event is received via Strimzi/DMaap Kafka on DMI. |
| Yes. This is agreed. |
| 2 | Changes in CM data will result in CPS-Core sending a CPS Data AVC irrespective the origin of the change. | - See #4 in the Bigger Picture below.
- This could later be model controlled to be more granular.
| Agreed. |
Issues & Decisions
# | Issue | Notes | Decisions |
|---|
| 1 | CM VES Message format schema. Who will own it ? | In order to process the message DMI plugin / NCMP should be aware of the schema of the incoming message it is going to be consume. | VES format primary reference is here: [INT-2180] Define CM VES message aligned with 3GPP/O-RAN O1 - ONAP JIRA |
| 2 | Topic from where we will receive the CM VES Message. | Existing channel or channel owned by NCMP/DMI | Vishal Varvate to provide the topic details. Priyank Maheshwari ,please use below topic unauthenticated.SEC_3GPP_PROVISIONING_OUTPUT |
| 3 |
How do we retreive event.sourceId ( we can extract cmHandle details from the sourceId )moiChanges.operationmoiChanges.pathmoiChanges.valueThe fields which are of importance are :
Vishal Varvate to provide in few examples of the CM VES messages.
Sample CM VES event having href and path attribute.
More information is present in the meetings recording.
| Code Block |
|---|
| title | VES Event Sample |
|---|
| collapse | true |
|---|
| {
|
|
{
"eventId": "stnddefined000001", |
|
"eventName": "stnddefined_Metrics", |
|
"lastEpochMicrosec": 1670938742757000.0, |
|
"nfVendorName": "Capgemini Engineering", |
|
"reportingEntityId": "nearrtric-22_cucpserver2", |
|
"reportingEntityName": "honeycomb", |
|
"sourceId": "nearrtric-22_cucpserver2", |
|
"sourceName": "Capgemini Engineering", |
|
"startEpochMicrosec": 1670938742757000.0, |
|
"stndDefinedNamespace": "3GPP-Provisioning", |
|
"timeZoneOffset": "UTC+05:30", |
|
"vesEventListenerVersion": "7.2" |
|
"schemaReference": "https://forge.3gpp.org/rep/sa5/MnS/blob/Rel16/OpenAPI/provMnS.yaml#/components/schemas/NotifyMoiChanges", |
|
"href": "172.16.100.130", |
|
"notificationType": "notifyMOIChanges", |
|
"eventTime": "2021-08-23T11:52:10.6Z", |
|
"correlatedNotifications": [], |
|
"additionalText": "AdditionalTextDetails", |
|
"sourceIndicator": "MANAGEMENT_OPERATION", |
|
path="/restconf/data/ran-network:ran-network/NearRTRIC=22/GNBCUCPFunction=cucpserver2/NRCellCU=15549/NRCellRelation=14427/isHOAllowed", |
|
"stndDefinedFieldsVersion": "1.0" |
|
- Is CMNotify Message same as CM VES Message and notify more about this if this is relevant.
| DMI Data AVC Sample | | collapse | true |
|---|
| {
"eventId":"nearrtric-22_cucpserver2",
"eventCorrelationId":"nearrtric-22_cucpserver2",
"eventTime":"2023-02-28T16:42:25-04:00",
"eventSource":"ncmp-datastore:operational",
"eventType":"org.onap.ncmp.cm-network-avc-event",
"eventSchema":"org.onap.ncmp:cm-network-avc-event.rfc8641",
"eventSchemaVersion":"1.0",
"event":{
"push-change-update":{
"datastore-changes":{
"ietf-yang-patch:yang-patch":{
"patch-id":"34534ffd98",
"edit":[
{
"edit-id":"ded43434-1",
"operation":"replace",
"target":"ran-network:ran-network/NearRTRIC[@id='22']/GNBCUCPFunction[@id='cucpserver2']/NRCellCU[@id='15549']/NRCellRelation[@id='14427']",
"value":{
"attributes":[
{
"isHoAllowed":true
}
]
}
}
]
}
}
}
}
}
|
|
| 5 | Topic from NCMP-DMI-Plugin to NCMP | The producer is already configured. | Topic name : dmi-cm-events |
 Image Removed
| Yes. CMNotify and CM VES message are the same.
The Big(ger) Picture
| Gliffy Diagram |
|---|
| name | CPS Notifications Overview |
|---|
| pageid | 158040117 |
|---|
|
...
| Gliffy Diagram |
|---|
| size | 600 |
|---|
| displayName | CM_VES_PROCESSING CPS Side |
|---|
| name | CM_VES_PROCESSING |
|---|
| pagePin | 8 |
|---|
|
Analysis
VES Event → DMI Data AVC Mapping
| VES Event | DMI Data AVC | Notes |
|---|
| # | Part | Field | Source | Sample Value | Part | Field | Source | Sample Value |
|---|
| 1 | Header | eventId |
| 123435 | Header | eventId | DMI Plugin | 123435 | Has to be globally unique |
| 2 | Header | eventTime | device | 2021-11-16T16:42:25-04:00 | Header | eventTime | VES Event | 2021-11-16T16:42:25-04:00 | TO BE DISCUSSED see open issue # |
| 3 | Header | sourceId | device | nearrtric-22_cucpserver2 | Header | eventSource | VES Event | device-123 | Upto DMI plugin to send. where it came from etc. |
| 4 | Header | sourceId |
| nearrtric-22_cucpserver2 | Header | eventCorrelationId | VES Event & Conversion | nearrtric-22_cucpserver2 | DMI PLugin need to map TBC |
| 5 | Payload | path |
| ran-network:ran-network/NearRTRIC=22/GNBCUCPFunction=cucpserver2/
NRCellCU=15549/NRCellRelation=14427
ran-network:ran-network/NearRTRIC=11/GNBCUCPFunction=cucpserver2/
NRCellCU=15549/NRCellRelation=14427 | Payload | target | VES Event & Conversion | ManagedElement@[id='1']\Function[@id='SomeFunction']
ran-network:ran-network/NearRTRIC[@id="22"]/GNBCUCPFunction[@id="cucpserver2"]/
NRCellCU[@id="15549"]/NRCellRelation[@id="14427"] | DMI PLugin needs to convert FDN to XPath |
| 6 |
|
|
|
| Payload | patch-id | DMI Plugin | 329cb2e3-b41a-4347-9884-f15457f426a1 | Unique ID generated by DMI-Plugin |
| 7 | Payload | operation | device | 'replace' | Payload | operation | VES Event & Conversion | 'replace' | DMI PLugin needs to map |
The DMI Data AVC Payload is defined by https://www.rfc-editor.org/rfc/rfc8641
| Value Copied VES Event | Transformed VES Event Value | Value Generated by DMI-Plugin |
Analysis
- Dataspace : NFP-Operational
- Yang Resource : ran-network to be used. ( trimmed down version just like
- Dataspace : NFP-Operational , Schema-Set : cps-ran-schema-model , Anchor : ran-network-simulation
- Yang Resource : cps-ran-schema-model ( tree form : cps-ran-schema-model _tree.txt ) existing ran-schema will be used.
- We need to have a defined channel/topic where the VES messages are present , and NCMP should be able to listen , interpret/process and call the relevant CPS-Core APIs in order to publish the changes in the CPS DB.
Meetings
