2 // Copyright 2019 AT&T Intellectual Property
3 // Copyright 2019 Nokia
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
9 // http://www.apache.org/licenses/LICENSE-2.0
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.
21 "e2mgr/e2managererrors"
24 "gerrit.o-ran-sc.org/r/ric-plt/nodeb-rnib.git/common"
25 "gerrit.o-ran-sc.org/r/ric-plt/nodeb-rnib.git/entities"
30 type E2TInstancesManager struct {
31 rnibDataService services.RNibDataService
36 type IE2TInstancesManager interface {
37 GetE2TInstance(e2tAddress string) (*entities.E2TInstance, error)
38 GetE2TInstances() ([]*entities.E2TInstance, error)
39 AddE2TInstance(e2tAddress string) error
40 RemoveE2TInstance(e2tInstance *entities.E2TInstance) error
41 SelectE2TInstance() (string, error)
42 AssociateRan(ranName string, e2tAddress string) error
43 DissociateRan(ranName string, e2tAddress string) error
46 func NewE2TInstancesManager(rnibDataService services.RNibDataService, logger *logger.Logger) *E2TInstancesManager {
47 return &E2TInstancesManager{
48 rnibDataService: rnibDataService,
53 func (m *E2TInstancesManager) GetE2TInstance(e2tAddress string) (*entities.E2TInstance, error) {
54 e2tInstance, err := m.rnibDataService.GetE2TInstance(e2tAddress)
58 _, ok := err.(*common.ResourceNotFoundError)
61 m.logger.Errorf("#GetE2TInstance - E2T Instance address: %s - Failed retrieving E2TInstance. error: %s", e2tAddress, err)
63 m.logger.Infof("#GetE2TInstance - E2T Instance address: %s not found on DB", e2tAddress)
67 return e2tInstance, err
70 func (m *E2TInstancesManager) GetE2TInstances() ([]*entities.E2TInstance, error) {
71 e2tAddresses, err := m.rnibDataService.GetE2TAddresses()
74 m.logger.Errorf("#E2TInstancesManager.GetE2TInstances - Failed retrieving E2T addresses. error: %s", err)
78 if len(e2tAddresses) == 0 {
79 m.logger.Warnf("#E2TInstancesManager.GetE2TInstances - Empty E2T addresses list")
80 return []*entities.E2TInstance{}, nil
83 e2tInstances, err := m.rnibDataService.GetE2TInstances(e2tAddresses)
86 m.logger.Errorf("#E2TInstancesManager.GetE2TInstances - Failed retrieving E2T instances list. error: %s", err)
87 return e2tInstances, err
90 if len(e2tInstances) == 0 {
91 m.logger.Warnf("#E2TInstancesManager.GetE2TInstances - Empty E2T instances list")
92 return e2tInstances, nil
95 return e2tInstances, nil
98 func findActiveE2TInstanceWithMinimumAssociatedRans(e2tInstances []*entities.E2TInstance) *entities.E2TInstance {
99 var minInstance *entities.E2TInstance
100 minAssociatedRanCount := math.MaxInt32
102 for _, v := range e2tInstances {
103 if v.State == entities.Active && len(v.AssociatedRanList) < minAssociatedRanCount {
104 minAssociatedRanCount = len(v.AssociatedRanList)
112 func (m *E2TInstancesManager) AddE2TInstance(e2tAddress string) error {
114 e2tInstance := entities.NewE2TInstance(e2tAddress)
115 err := m.rnibDataService.SaveE2TInstance(e2tInstance)
118 m.logger.Errorf("#AddE2TInstance - E2T Instance address: %s - Failed saving E2T instance. error: %s", e2tInstance.Address, err)
125 e2tAddresses, err := m.rnibDataService.GetE2TAddresses()
129 _, ok := err.(*common.ResourceNotFoundError)
132 m.logger.Errorf("#AddE2TInstance - E2T Instance address: %s - Failed retrieving E2T addresses list. error: %s", e2tInstance.Address, err)
137 e2tAddresses = append(e2tAddresses, e2tInstance.Address)
139 err = m.rnibDataService.SaveE2TAddresses(e2tAddresses)
142 m.logger.Errorf("#AddE2TInstance - E2T Instance address: %s - Failed saving E2T addresses list. error: %s", e2tInstance.Address, err)
146 m.logger.Infof("#AddE2TInstance - E2T Instance address: %s - successfully added E2T instance", e2tInstance.Address)
150 func (m *E2TInstancesManager) DissociateRan(ranName string, e2tAddress string) error {
155 e2tInstance, err := m.rnibDataService.GetE2TInstance(e2tAddress)
158 m.logger.Errorf("#DissociateRan - E2T Instance address: %s - Failed retrieving E2TInstance. error: %s", e2tAddress, err)
162 i := 0 // output index
163 for _, v := range e2tInstance.AssociatedRanList {
165 // copy and increment index
166 e2tInstance.AssociatedRanList[i] = v
171 e2tInstance.AssociatedRanList = e2tInstance.AssociatedRanList[:i]
173 err = m.rnibDataService.SaveE2TInstance(e2tInstance)
176 m.logger.Errorf("#DissociateRan - E2T Instance address: %s - Failed saving E2TInstance. error: %s", e2tAddress, err)
180 m.logger.Infof("#DissociateRan - successfully dissociated RAN %s from E2T %s", ranName, e2tInstance.Address)
184 func (m *E2TInstancesManager) RemoveE2TInstance(e2tInstance *entities.E2TInstance) error {
187 func (m *E2TInstancesManager) SelectE2TInstance() (string, error) {
189 e2tInstances, err := m.GetE2TInstances()
192 m.logger.Errorf("#E2TInstancesManager.SelectE2TInstance - failed retrieving E2T instances. error: %s", err)
193 return "", e2managererrors.NewRnibDbError()
196 if len(e2tInstances) == 0 {
197 m.logger.Errorf("#E2TInstancesManager.SelectE2TInstance - No E2T instance found")
198 return "", e2managererrors.NewE2TInstanceAbsenceError()
201 min := findActiveE2TInstanceWithMinimumAssociatedRans(e2tInstances)
204 m.logger.Errorf("#SelectE2TInstance - No active E2T instance found")
205 return "", e2managererrors.NewE2TInstanceAbsenceError()
208 m.logger.Infof("#SelectE2TInstance - successfully selected E2T instance. address: %s", min.Address)
209 return min.Address, nil
212 func (m *E2TInstancesManager) AssociateRan(ranName string, e2tAddress string) error {
217 e2tInstance, err := m.rnibDataService.GetE2TInstance(e2tAddress)
220 m.logger.Errorf("#AssociateRan - E2T Instance address: %s - Failed retrieving E2TInstance. error: %s", e2tAddress, err)
221 return e2managererrors.NewRnibDbError()
224 e2tInstance.AssociatedRanList = append(e2tInstance.AssociatedRanList, ranName)
226 err = m.rnibDataService.SaveE2TInstance(e2tInstance)
229 m.logger.Errorf("#AssociateRan - E2T Instance address: %s - Failed saving E2TInstance. error: %s", e2tAddress, err)
230 return e2managererrors.NewRnibDbError()
233 m.logger.Infof("#AssociateRan - successfully associated RAN %s with E2T %s", ranName, e2tInstance.Address)