Note:

Compared to previous O-RAN-SC OAM release the AlarmLog and its interface was developed.


Message Flow

Diagram

''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 
' PlantUML for ONAP/O-RAN fault management
'
' Copyright 2020 highstreet technologies GmbH
' Licensed under the Apache License, Version 2.0 (the "License"); 
' you may not use this file except in compliance with the License. 
' You may obtain a copy of the License at 
' 
' http://www.apache.org/licenses/LICENSE-2.0 
' 
' Unless required by applicable law or agreed to in writing, software 
' distributed under the License is distributed on an "AS IS" BASIS, 
' WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
' See the License for the specific language governing permissions and 
' limitations under the License. 
'

@startuml

' Diagram 
title 
  O-RAN Fault management (VES)
end title

box “Radio Access Network” #lightpink
  participant "O-RAN Component" as ntsim
end box
box "Service Management and Orchestration (SMO) (e.g. ONAP)" #gold
  participant "Streaming Consumer\nONAP DCAE VES Collector" as ves
  participant "Message bus\nONAP DMaaP" as dmaap
  participant "O1-Controller\nONAP SDN-R" as sdnr
  participant "O1-Persistence\nONAP SDN-R" as sdnrdb
end box

autonumber 1 1 "<b>[00]"
ntsim -> ves: REST: VES:fault
ves -> dmaap: REST: Publish event \nunauthenticated.SEC_FAULT_OUTPUT
loop polling for VES pnfRegistration
sdnr -> dmaap: REST: Get topic \nunauthenticated.SEC_FAULT_OUTPUT
end loop
dmaap -> sdnr: REST: fault
sdnr ->sdnr: Processing by "DeviceManager"
sdnr -> sdnrdb: update network alarm log

' End Diagram
' Format
header
  <b><font color=#8888ff>License</font></b>
  <b><font color=#8888ff>Apache 2.0</font></b>
end header

right footer 
  Thanks to plantUml! 
  2019-12-03 | o-ran-sc.org
end footer

skinparam backgroundColor #fefefe

skinparam backgroundColor #fefefe
'skinparam handwritten true
skinparam roundcorner 15

skinparam databaseBorderColor #444444
skinparam databaseBackgroundColor #fefefe
skinparam databaseFontColor #444444

skinparam sequence {
  MessageAlign left
  ArrowColor #2277dd
  ArrowFontColor #444444
  ActorBorderColor #444444
  LifeLineBorderColor #444444
  LifeLineBackgroundColor #eeeeee
 
  BoxBorderColor #444444
    
  GroupBorderColor #444444
  GroupBackgroundColor #eeeeee
  
  ParticipantBorderColor #444444
  ParticipantBackgroundColor #ffffdd
  ParticipantFontColor #444444
    
  ActorBackgroundColor #ffffdd
  'ActorFontColor DeepSkyBlue
  'ActorFontSize 17
  'ActorFontName Aapex
}

@enduml



Description

  1. in case of failures an O1 device sends a VES event of domain 'fault' to the VES Collector on SMO
  2. The VES collector forwards the fault content to the Message Bus (DMaaP)
  3. The DeviceManager component on O1-Controller polls for fault events on DMaaP and ...
  4. ... receives its content
  5. The DeviceManager within the O1-Controller processes the fault event and ...
  6. ... updates the alarm log.


Verification Command

The following command should display the content within the O1-Controller Alarm Log:


HTTP-POST 
BasicAuth admin:Kp8bJ4SXszM0WXlhak3eHlcse2gAw84vaoGGmJvUy2UAccept: application/yang-data+json
Content-Type: application/yang-data+json

/rests/operations/data-provider:read-faultlog-list

{
      "input": {
            "filter": [],
            "sortorder": [
          {
                            "property": "node-id",
            "sortorder": "ascending"
          }
    ],
    "pagination": {
       "size": 1000,
       "page": 1
     }
  }
}