o-ran-fm:alarm-notif to ves:fault

Objective

In order to process O-RU NetConf alarm-notif events in a common way on SMO level, the OAM controller converts such NetConf Notification into a VES:fault message..

Sequence Diagram

Implementation

It is assumed that the existing generic NetConf-Notification to ves:notification service could be enhanced for a specific fault notification implementation. 

A couple of VES fields needs to be filled with values from a an Ietf:hardware/component which does not have the leaf "parent". If more than one component would not have the leaf "parent" then the first component should be used for such fields (e.g. manufacture name). 

implementation of OpenDaylight Aluminium (link)

Static text "fault"

Value of 'nt:network-topology/nt:topology/nt:node/nt:node-id'.

Value of 'nt:network-topology/nt:topology/nt:node/nt:node-id'.

Static text: "O-RAN-RU-Fault"

not mapped

TimeStamp represented by <eventTime> field in NetConf notification header in unix time format - as microseconds elapsed since 1 Jan 1970 not including leap seconds.

always ""

always ""

The value of ietf-hardware (RFC8348) /hardware/component[not(parent)][1]/mfg-name or empty string if not found. 

Under discussion: how to identify the "root" component?

Answer: /ietf-hardware:hardware/component[not(parent)][1]/mfg-name

Static text "Normal"

The OAM-Controller identifier with in the SMO - e.g. the fully qualified domain name or IP-Address.

as configured by helm charts for the OpenDaylight cluster name

As per NetConf notification increasing sequence number as unsigned integer 32 bits. The value is reused in the eventId field.

Value of ietf-hardware (RFC8348) /hardware/component[not(parent)][1]/uuid or 'nt:network-topology/nt:topology/nt:node/nt:node-id' if ietf component not found.

Value of 'nt:network-topology/nt:topology/nt:node/nt:node-id'.

Current OAM-Controller Node timestamp in unix time format - as microseconds elapsed since 1 Jan 1970 not including leap seconds.

Static text: "+00:00" - Please note, the time format in all related OAM controller times is in UTC time format - a mapping to other time formats happens in presentation layer only (e.g. on user settings, bowser settings, ...)

Static text: "4.1"

Static text "7.2.1"

If an ieft-hardware component is not identified for the mapping into VES:fault or an optional leaf is not provided, then the VES:fault should be part of the message with its default value (e.g. empty string "") 

The ietf-hardware component must not have the 'parent' leaf.

not mapped

Value of "o-ran-fm:alarm-notif/fault-id"

Value of "o-ran-fm:alarm-notif/fault-source"

Static text "O-RU failure"

Value of "o-ran-fm:alarm-notif/fault-severity"

but if "o-ran-fm:alarm-notif/is-cleared" then "NORMAL"

The value of ietf-hardware (RFC8348) /hardware/component[not(parent)][1]/model-name or "O-RU" if not found. 

Static text: "4.0"

A mapping of the fault-id to its description according to O-RAN OpenFronthaul specification.

Static text: "Active"