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.
17 package httpmsghandlers
20 "e2mgr/e2managererrors"
25 "gerrit.o-ran-sc.org/r/ric-plt/nodeb-rnib.git/common"
26 "gerrit.o-ran-sc.org/r/ric-plt/nodeb-rnib.git/entities"
27 "github.com/go-ozzo/ozzo-validation"
28 "github.com/go-ozzo/ozzo-validation/is"
32 X2SetupActivityName = "X2_SETUP"
33 EndcSetupActivityName = "ENDC_SETUP"
36 type SetupRequestHandler struct {
37 rNibDataService services.RNibDataService
39 ranSetupManager *managers.RanSetupManager
40 protocol entities.E2ApplicationProtocol
41 e2tInstancesManager managers.IE2TInstancesManager
44 func NewSetupRequestHandler(logger *logger.Logger, rNibDataService services.RNibDataService,
45 ranSetupManager *managers.RanSetupManager, protocol entities.E2ApplicationProtocol, e2tInstancesManager managers.IE2TInstancesManager) *SetupRequestHandler {
46 return &SetupRequestHandler{
48 rNibDataService: rNibDataService,
49 ranSetupManager: ranSetupManager,
51 e2tInstancesManager: e2tInstancesManager,
55 func (handler *SetupRequestHandler) Handle(request models.Request) (models.IResponse, error) {
57 setupRequest := request.(models.SetupRequest)
59 err := handler.validateRequestDetails(setupRequest)
64 nodebInfo, err := handler.rNibDataService.GetNodeb(setupRequest.RanName)
67 _, ok := err.(*common.ResourceNotFoundError)
69 handler.logger.Errorf("#SetupRequestHandler.Handle - failed to get nodeB entity for ran name: %v from RNIB. Error: %s",
70 setupRequest.RanName, err.Error())
71 return nil, e2managererrors.NewRnibDbError()
74 result := handler.connectNewRan(&setupRequest, handler.protocol)
78 if len(nodebInfo.AssociatedE2TInstanceAddress) != 0 {
79 result := handler.connectExistingRanWithAssociatedE2TAddress(nodebInfo)
83 result := handler.connectExistingRanWithoutAssociatedE2TAddress(nodebInfo)
87 func createInitialNodeInfo(requestDetails *models.SetupRequest, protocol entities.E2ApplicationProtocol, e2tAddress string) (*entities.NodebInfo, *entities.NbIdentity) {
89 nodebInfo := &entities.NodebInfo{
90 Ip: requestDetails.RanIp,
91 Port: uint32(requestDetails.RanPort),
92 ConnectionStatus: entities.ConnectionStatus_CONNECTING,
93 E2ApplicationProtocol: protocol,
94 RanName: requestDetails.RanName,
95 ConnectionAttempts: 0,
96 AssociatedE2TInstanceAddress: e2tAddress,
99 nbIdentity := &entities.NbIdentity{
100 InventoryName: requestDetails.RanName,
103 return nodebInfo, nbIdentity
106 func (h *SetupRequestHandler) connectExistingRanWithoutAssociatedE2TAddress(nodebInfo *entities.NodebInfo) error {
107 e2tAddress, err := h.e2tInstancesManager.SelectE2TInstance()
114 err = h.e2tInstancesManager.AssociateRan(nodebInfo.RanName, e2tAddress)
117 h.logger.Errorf("#SetupRequestHandler.connectExistingRanWithoutAssociatedE2TAddress - RAN name: %s - failed associating ran to e2t address %s. error: %s", nodebInfo.RanName, e2tAddress, err)
118 return e2managererrors.NewRnibDbError()
121 nodebInfo.AssociatedE2TInstanceAddress = e2tAddress
122 nodebInfo.ConnectionAttempts = 0
124 err = h.rNibDataService.UpdateNodebInfo(nodebInfo)
127 h.logger.Errorf("#SetupRequestHandler.connectExistingRanWithoutAssociatedE2TAddress - RAN name: %s - failed updating nodeb in rNib. error: %s", nodebInfo.RanName, err)
128 return e2managererrors.NewRnibDbError()
131 h.logger.Infof("#SetupRequestHandler.connectExistingRanWithoutAssociatedE2TAddress - RAN name: %s - successfully updated nodeb in rNib", nodebInfo.RanName)
133 result := h.ranSetupManager.ExecuteSetup(nodebInfo, entities.ConnectionStatus_CONNECTING)
137 func (h *SetupRequestHandler) connectExistingRanWithAssociatedE2TAddress(nodebInfo *entities.NodebInfo) error {
139 if nodebInfo.ConnectionStatus == entities.ConnectionStatus_SHUTTING_DOWN {
140 h.logger.Errorf("#SetupRequestHandler.connectExistingRanWithAssociatedE2TAddress - RAN: %s in wrong state (%s)", nodebInfo.RanName, entities.ConnectionStatus_name[int32(nodebInfo.ConnectionStatus)])
141 return e2managererrors.NewWrongStateError(h.getActivityName(h.protocol), entities.ConnectionStatus_name[int32(nodebInfo.ConnectionStatus)])
144 status := entities.ConnectionStatus_CONNECTING
145 if nodebInfo.ConnectionStatus == entities.ConnectionStatus_CONNECTED {
146 status = nodebInfo.ConnectionStatus
149 nodebInfo.ConnectionAttempts = 0
151 err := h.rNibDataService.UpdateNodebInfo(nodebInfo)
154 h.logger.Errorf("#SetupRequestHandler.connectExistingRanWithAssociatedE2TAddress - RAN name: %s - failed updating nodeb in rNib. error: %s", nodebInfo.RanName, err)
155 return e2managererrors.NewRnibDbError()
158 h.logger.Infof("#SetupRequestHandler.connectExistingRanWithAssociatedE2TAddress - RAN name: %s - successfully updated nodeb in rNib", nodebInfo.RanName)
160 result := h.ranSetupManager.ExecuteSetup(nodebInfo, status)
164 func (h *SetupRequestHandler) connectNewRan(request *models.SetupRequest, protocol entities.E2ApplicationProtocol) error {
166 e2tAddress, err := h.e2tInstancesManager.SelectE2TInstance()
173 err = h.e2tInstancesManager.AssociateRan(request.RanName, e2tAddress)
176 h.logger.Errorf("#SetupRequestHandler.connectNewRan - RAN name: %s - failed associating ran to e2t address %s. error: %s", request.RanName, e2tAddress, err)
177 return e2managererrors.NewRnibDbError()
180 nodebInfo, nodebIdentity := createInitialNodeInfo(request, protocol, e2tAddress)
182 err = h.rNibDataService.SaveNodeb(nodebIdentity, nodebInfo)
185 h.logger.Errorf("#SetupRequestHandler.connectNewRan - RAN name: %s - failed to save initial nodeb entity in RNIB. error: %s", request.RanName, err)
186 return e2managererrors.NewRnibDbError()
189 h.logger.Infof("#SetupRequestHandler.connectNewRan - RAN name: %s - initial nodeb entity was saved to rNib", request.RanName)
191 result := h.ranSetupManager.ExecuteSetup(nodebInfo, entities.ConnectionStatus_CONNECTING)
196 func (handler *SetupRequestHandler) validateRequestDetails(request models.SetupRequest) error {
198 if request.RanPort == 0 {
199 handler.logger.Errorf("#SetupRequestHandler.validateRequestDetails - validation failure: port cannot be zero")
200 return e2managererrors.NewRequestValidationError()
202 err := validation.ValidateStruct(&request,
203 validation.Field(&request.RanIp, validation.Required, is.IP),
204 validation.Field(&request.RanName, validation.Required),
208 handler.logger.Errorf("#SetupRequestHandler.validateRequestDetails - validation failure, error: %v", err)
209 return e2managererrors.NewRequestValidationError()
215 func (handler *SetupRequestHandler) getActivityName(protocol entities.E2ApplicationProtocol) string {
216 if protocol == entities.E2ApplicationProtocol_X2_SETUP_REQUEST {
217 return X2SetupActivityName
219 return EndcSetupActivityName