Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
In order to convert a NetConf notification into a VES7.1.1 format a mapping between a specific YANG set of YANG modules and the VES:commonEventHeader and its domain "notification. In the example below we need the BBF-TR069 implemented in the OAM-TR069-Adapter for such mapping.
BBF-TR069 defines 4 kind of CM notifications: VALUECHANGE, BOOT, BOOTSTRAP and PERIODIC. However, the mapping to VES:notification is the same.
VES:commonEventHeader
implementation of TR069 yang
domain
Static text "notification"
eventId
Concatenation of:
- "ConfigurationChangeThe notification name (root-xml-tag) as specified in the YANG model, so one of the following values
- "VALUECHANGE"
- "BOOT"
- "BOOTSTRAP"
- "PERIODIC"
- "-"
- Value of: notification VALUECHANGEas discovered when NetConf connection is established: /device/device-info/serial-number
- "-"
- value of an increasing sequence number (int (uint6432 bits); even so, please implement wrap around)
eventName
Static text: "ConfigurationChangeThe notification name (root-xml-tag) as specified in the YANG model, so one of the following values
- "VALUECHANGE"
- "BOOT"
- "BOOTSTRAP"
- "PERIODIC"
eventType
Static text: "OAM-TR069_RAN_notification"
internalHeaderFields
not mapped
lastEpochMicrosec
TimeStamp represented by <eventTime> field in NetConf notification header in unix time format - as microseconds elapsed since 1 Jan 1970 not including leap seconds.
nfcNamingCode
not mappedalways ""
nfNamingCode
not mappedalways ""
nfVendorName
Value of: notification VALUECHANGEas discovered when NetConf connection is established: /device/device-info/manufacturer
priority
Static text "Normal"
reportingEntityId
not mapped
reportingEntityName
TODO add definition of as configured by helm charts for the ODL cluster name - default "ONAP SDN-R node id here (fqdn?)"
sequence
As per NetConf notification increasing sequence number as unsigned integer 64 32 bits. The value is reused in the eventId field.
sourceId
Value of: notification VALUECHANGEas discovered when NetConf connection is established: /device/device-info/serial-number
sourceName
startEpochMicrosec
TimeStamp represented by <eventTime> field in NetConf notification header in unix time format - as microseconds elapsed since 1 Jan 1970 not including leap seconds.
timeZoneOffset
Static text: "+00:00" - Please note that times from NetConf Notification Header may need to be converted to UTC.
version
Static text: "4.1"
vesEventListenerVersion
Static text "7.1.1"
VES:notificationFields
additionalFields
not mapped
arrayOfNamedHashMap
That field is used to transport the information which has changed, basically as key value pair. As key the xpath to the leaf should be used.
Example:
"/notification/VALUECHANGE[@xmlns=\"urn:org:onap:ccsdk:features:sdnr:northbound:onecell-notification\"]/device/services/fap-service[2]/fap-control/lte/rf-tx-status": "false",
changeContact
not mapped
changeIdentifier
ODL/node-id (mountpoint name)
changeType
Static text: "ValueChangeThe notification name (root-xml-tag) as specified in the YANG model, so one of the following values
- "VALUECHANGE"
- "BOOT"
- "BOOTSTRAP"
- "PERIODIC"
newState
not mapped
oldState
not mapped
notificationFieldsVersion
Static text: "2.0"
stateInterface
not mapped - alternative: the most common part of the keys of arrayOfNamedHashMap (would be redundant)