E2Manager/managers/ran_connect_status_change_manager.go

   1 //
   2 // Copyright 2019 AT&T Intellectual Property
   3 // Copyright 2019 Nokia
   4 //
   5 // Licensed under the Apache License, Version 2.0 (the "License");
   6 // you may not use this file except in compliance with the License.
   7 // You may obtain a copy of the License at
   8 //
   9 //      http://www.apache.org/licenses/LICENSE-2.0
  10 //
  11 // Unless required by applicable law or agreed to in writing, software
  12 // distributed under the License is distributed on an "AS IS" BASIS,
  13 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14 // See the License for the specific language governing permissions and
  15 // limitations under the License.
  16
  17 //  This source code is part of the near-RT RIC (RAN Intelligent Controller)
  18 //  platform project (RICP).
  19
  20 package managers
  21
  22 import (
  23         "e2mgr/logger"
  24         "e2mgr/services"
  25         "gerrit.o-ran-sc.org/r/ric-plt/nodeb-rnib.git/entities"
  26 )
  27
  28 const (
  29         CONNECTED_RAW_EVENT    = "CONNECTED"
  30         DISCONNECTED_RAW_EVENT = "DISCONNECTED"
  31         NONE_RAW_EVENT         = "NONE"
  32 )
  33
  34 type IRanConnectStatusChangeManager interface {
  35         ChangeStatus(nodebInfo *entities.NodebInfo, nextStatus entities.ConnectionStatus) (bool, error)
  36 }
  37
  38 type RanConnectStatusChangeManager struct {
  39         logger          *logger.Logger
  40         rnibDataService services.RNibDataService
  41         ranListManager  RanListManager
  42         ranAlarmService services.RanAlarmService
  43 }
  44
  45 func NewRanConnectStatusChangeManager(logger *logger.Logger, rnibDataService services.RNibDataService, ranListManager RanListManager, ranAlarmService services.RanAlarmService) *RanConnectStatusChangeManager {
  46         return &RanConnectStatusChangeManager{
  47                 logger:          logger,
  48                 rnibDataService: rnibDataService,
  49                 ranListManager:  ranListManager,
  50                 ranAlarmService: ranAlarmService,
  51         }
  52 }
  53
  54 func (m *RanConnectStatusChangeManager) ChangeStatus(nodebInfo *entities.NodebInfo, nextStatus entities.ConnectionStatus) (bool, error) {
  55         m.logger.Infof("#RanConnectStatusChangeManager.ChangeStatus - RAN name: %s, currentStatus: %s, nextStatus: %s", nodebInfo.RanName, nodebInfo.GetConnectionStatus(), nextStatus)
  56
  57         var ranStatusChangePublished bool
  58
  59         // set the proper event
  60         event := m.setEvent(nodebInfo, nextStatus)
  61         isConnectivityEvent := event != NONE_RAW_EVENT
  62
  63         // only after determining event we set next status
  64         nodebInfo.ConnectionStatus = nextStatus;
  65         if !isConnectivityEvent {
  66                 err := m.updateNodebInfo(nodebInfo)
  67                 if err != nil {
  68                         return ranStatusChangePublished, err
  69                 }
  70         } else {
  71                 err := m.updateNodebInfoOnConnectionStatusInversion(nodebInfo, event)
  72                 if err != nil {
  73                         return ranStatusChangePublished, err
  74                 }
  75                 ranStatusChangePublished = true
  76         }
  77
  78         // in any case, update RanListManager
  79         connectionStatus := nodebInfo.GetConnectionStatus()
  80         m.logger.Infof("#RanConnectStatusChangeManager.ChangeStatus - RAN name: %s, updating RanListManager... status: %s", nodebInfo.RanName, connectionStatus)
  81         err := m.ranListManager.UpdateNbIdentityConnectionStatus(nodebInfo.GetNodeType(), nodebInfo.RanName, connectionStatus)
  82         if err != nil {
  83                 m.logger.Errorf("#RanConnectStatusChangeManager.ChangeStatus - RAN name: %s - Failed updating RAN's connection status by RanListManager. Error: %v", nodebInfo.RanName, err)
  84                 // log and proceed...
  85         }
  86
  87         if isConnectivityEvent {
  88                 m.logger.Infof("#RanConnectStatusChangeManager.ChangeStatus - RAN name: %s, setting alarm at RanAlarmService... event: %s", nodebInfo.RanName, event)
  89                 err := m.ranAlarmService.SetConnectivityChangeAlarm(nodebInfo)
  90                 if err != nil {
  91                         m.logger.Errorf("#RanConnectStatusChangeManager.ChangeStatus - RAN name: %s - Failed setting an alarm by RanAlarmService. Error: %v", nodebInfo.RanName, err)
  92                         // log and proceed...
  93                 }
  94         }
  95
  96         return ranStatusChangePublished, nil
  97 }
  98
  99 func (m *RanConnectStatusChangeManager) updateNodebInfoOnConnectionStatusInversion(nodebInfo *entities.NodebInfo, event string) error {
 100
 101         err := m.rnibDataService.UpdateNodebInfoOnConnectionStatusInversion(nodebInfo, event)
 102
 103         if err != nil {
 104                 m.logger.Errorf("#RanConnectStatusChangeManager.updateNodebInfoOnConnectionStatusInversion - RAN name: %s - Failed updating RAN's connection status in rNib. Error: %v", nodebInfo.RanName, err)
 105                 return err
 106         }
 107
 108         m.logger.Infof("#RanConnectStatusChangeManager.updateNodebInfoOnConnectionStatusInversion - RAN name: %s - Successfully updated rNib.", nodebInfo.RanName)
 109         return nil
 110 }
 111
 112 func (m *RanConnectStatusChangeManager) updateNodebInfo(nodebInfo *entities.NodebInfo) error {
 113
 114         err := m.rnibDataService.UpdateNodebInfo(nodebInfo)
 115
 116         if err != nil {
 117                 m.logger.Errorf("#RanConnectStatusChangeManager.updateNodebInfo - RAN name: %s - Failed updating RAN's connection status in rNib. Error: %v", nodebInfo.RanName, err)
 118                 return err
 119         }
 120
 121         m.logger.Infof("#RanConnectStatusChangeManager.updateNodebInfo - RAN name: %s - Successfully updated rNib.", nodebInfo.RanName)
 122         return nil
 123 }
 124
 125 func (m *RanConnectStatusChangeManager) setEvent(nodebInfo *entities.NodebInfo, nextState entities.ConnectionStatus) string {
 126         currentConnectionStatus := nodebInfo.GetConnectionStatus()
 127
 128         var event string
 129         if currentConnectionStatus != entities.ConnectionStatus_CONNECTED && nextState == entities.ConnectionStatus_CONNECTED {
 130                 event = nodebInfo.RanName + "_" + CONNECTED_RAW_EVENT
 131         } else if currentConnectionStatus == entities.ConnectionStatus_CONNECTED && nextState != entities.ConnectionStatus_CONNECTED {
 132                 event = nodebInfo.RanName + "_" + DISCONNECTED_RAW_EVENT
 133         } else {
 134                 event = NONE_RAW_EVENT
 135         }
 136
 137         m.logger.Infof("#RanConnectStatusChangeManager.setEvent - Connectivity Event for RAN %s is: %s", nodebInfo.RanName, event)
 138         return event
 139 }