adapters/mso-vnfm-adapter/mso-vnfm-etsi-adapter/src/main/java/org/onap/so/adapters/vnfmadapter/lifecycle/LifecycleManager.java

   1 /*-
   2  * ============LICENSE_START=======================================================
   3  *  Copyright (C) 2019 Nordix Foundation.
   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  * SPDX-License-Identifier: Apache-2.0
  18  * ============LICENSE_END=========================================================
  19  */
  20
  21 package org.onap.so.adapters.vnfmadapter.lifecycle;
  22
  23 import com.google.common.base.Optional;
  24 import java.util.Map;
  25 import org.onap.aai.domain.yang.EsrVnfm;
  26 import org.onap.aai.domain.yang.GenericVnf;
  27 import org.onap.so.adapters.vnfmadapter.extclients.SdcPackageProvider;
  28 import org.onap.so.adapters.vnfmadapter.extclients.aai.AaiHelper;
  29 import org.onap.so.adapters.vnfmadapter.extclients.aai.AaiServiceProvider;
  30 import org.onap.so.adapters.vnfmadapter.extclients.aai.OamIpAddressSource;
  31 import org.onap.so.adapters.vnfmadapter.extclients.aai.OamIpAddressSource.OamIpAddressType;
  32 import org.onap.so.adapters.vnfmadapter.extclients.vnfm.VnfmHelper;
  33 import org.onap.so.adapters.vnfmadapter.extclients.vnfm.VnfmServiceProvider;
  34 import org.onap.so.adapters.vnfmadapter.extclients.vnfm.model.InlineResponse201;
  35 import org.onap.so.adapters.vnfmadapter.extclients.vnfm.model.InstantiateVnfRequest;
  36 import org.onap.so.adapters.vnfmadapter.extclients.vnfm.model.LccnSubscriptionRequest;
  37 import org.onap.so.adapters.vnfmadapter.extclients.vnfm.model.TerminateVnfRequest;
  38 import org.onap.so.adapters.vnfmadapter.extclients.vnfm.model.TerminateVnfRequest.TerminationTypeEnum;
  39 import org.onap.so.adapters.vnfmadapter.jobmanagement.JobManager;
  40 import org.onap.so.adapters.vnfmadapter.rest.exceptions.VnfNotFoundException;
  41 import org.onap.so.adapters.vnfmadapter.rest.exceptions.VnfmNotFoundException;
  42 import org.onap.so.adapters.vnfmadapter.rest.exceptions.VnfmRequestFailureException;
  43 import org.onap.vnfmadapter.v1.model.CreateVnfRequest;
  44 import org.onap.vnfmadapter.v1.model.CreateVnfResponse;
  45 import org.onap.vnfmadapter.v1.model.DeleteVnfResponse;
  46 import org.slf4j.Logger;
  47 import org.slf4j.LoggerFactory;
  48 import org.springframework.beans.factory.annotation.Autowired;
  49 import org.springframework.stereotype.Component;
  50
  51 /**
  52  * Manages lifecycle operations towards the VNFMs.
  53  */
  54 @Component
  55 public class LifecycleManager {
  56     private static final Logger logger = LoggerFactory.getLogger(LifecycleManager.class);
  57     private final AaiServiceProvider aaiServiceProvider;
  58     private final VnfmServiceProvider vnfmServiceProvider;
  59     private final AaiHelper aaiHelper;
  60     private final VnfmHelper vnfmHelper;
  61     private final JobManager jobManager;
  62     private final SdcPackageProvider packageProvider;
  63
  64     @Autowired
  65     LifecycleManager(final AaiServiceProvider aaiServiceProvider, final AaiHelper aaiHelper,
  66             final VnfmHelper vnfmHelper, final VnfmServiceProvider vnfmServiceProvider, final JobManager jobManager,
  67             final SdcPackageProvider packageProvider) {
  68         this.aaiServiceProvider = aaiServiceProvider;
  69         this.vnfmServiceProvider = vnfmServiceProvider;
  70         this.aaiHelper = aaiHelper;
  71         this.vnfmHelper = vnfmHelper;
  72         this.jobManager = jobManager;
  73         this.packageProvider = packageProvider;
  74     }
  75
  76     /**
  77      * Create a VNF on a VNFM.
  78      *
  79      * @param vnfIdInAai the ID of the VNF in AAI
  80      * @param request the create request
  81      * @return the response to the request
  82      */
  83     public CreateVnfResponse createVnf(final String vnfIdInAai, final CreateVnfRequest request) {
  84         final GenericVnf genericVnf = getGenericVnfFromAai(vnfIdInAai);
  85         checkIfVnfAlreadyExistsInVnfm(genericVnf);
  86
  87         EsrVnfm vnfm = aaiHelper.getAssignedVnfm(genericVnf);
  88         if (vnfm == null) {
  89             vnfm = aaiHelper.selectVnfm(genericVnf);
  90             aaiHelper.addRelationshipFromGenericVnfToVnfm(genericVnf, vnfm.getVnfmId());
  91         }
  92         aaiHelper.addRelationshipFromGenericVnfToTenant(genericVnf, request.getTenant());
  93         final InlineResponse201 vnfmResponse =
  94                 sendCreateRequestToVnfm(request, genericVnf, vnfIdInAai, vnfm.getVnfmId());
  95
  96         logger.info("Create response: {}", vnfmResponse);
  97
  98         genericVnf.setSelflink(getSelfLink(vnfmResponse, vnfm));
  99         aaiServiceProvider.invokePutGenericVnf(genericVnf);
 100         final String vnfIdInVnfm = vnfmResponse.getId();
 101
 102         final OamIpAddressSource oamIpAddressSource = extractOamIpAddressSource(request);
 103         aaiHelper.setOamIpAddressSource(vnfIdInVnfm, oamIpAddressSource);
 104
 105         createNotificationSubscription(vnfm.getVnfmId(), vnfIdInVnfm);
 106         final String operationId = sendInstantiateRequestToVnfm(vnfm, genericVnf, request, vnfIdInAai, vnfIdInVnfm);
 107
 108         final String jobId = jobManager.createJob(vnfm.getVnfmId(), operationId, false);
 109         final CreateVnfResponse response = new CreateVnfResponse();
 110         response.setJobId(jobId);
 111         return response;
 112     }
 113
 114     private String getSelfLink(final InlineResponse201 vnfmResponse, final EsrVnfm vnfm) {
 115         if (vnfmResponse.getLinks() != null && vnfmResponse.getLinks().getSelf() != null
 116                 && vnfmResponse.getLinks().getSelf().getHref() != null) {
 117             return vnfmResponse.getLinks().getSelf().getHref().replaceAll("https", "http");
 118         }
 119         return vnfm.getEsrSystemInfoList().getEsrSystemInfo().iterator().next().getServiceUrl() + "/vnf_instances/"
 120                 + vnfmResponse.getId();
 121     }
 122
 123     private OamIpAddressSource extractOamIpAddressSource(final CreateVnfRequest request) {
 124         final Map<String, String> additionalParams = request.getAdditionalParams();
 125         try {
 126             final String sourceType = additionalParams.remove("oamIpAddressSourceType");
 127             final String sourceValue = additionalParams.remove("oamIpAddressSourceValue");
 128             final OamIpAddressType oamIpAddressType = OamIpAddressType.valueOf(sourceType.toUpperCase());
 129             return new OamIpAddressSource(oamIpAddressType, sourceValue);
 130         } catch (final NullPointerException | IllegalArgumentException exception) {
 131             logger.debug("Additional Params not set for OAM IP address source", exception);
 132             return null;
 133         }
 134     }
 135
 136     private void checkIfVnfAlreadyExistsInVnfm(final GenericVnf genericVnf) {
 137         if (genericVnf.getSelflink() != null && !genericVnf.getSelflink().isEmpty()) {
 138             Optional<InlineResponse201> response = Optional.absent();
 139             try {
 140                 response = vnfmServiceProvider.getVnf(genericVnf.getSelflink());
 141             } catch (final Exception exception) {
 142                 logger.debug("Ignoring invalid self link in generic vnf", exception);
 143             }
 144             if (response.isPresent()) {
 145                 throw new IllegalArgumentException("VNF " + genericVnf.getVnfId()
 146                         + " is already defined on the VNFM, self link: " + genericVnf.getSelflink());
 147             }
 148         }
 149     }
 150
 151     private InlineResponse201 sendCreateRequestToVnfm(final CreateVnfRequest aaiRequest, final GenericVnf genericVnf,
 152             final String vnfIdInAai, final String vnfmId) {
 153         logger.debug("Sending a create request to SVNFM " + aaiRequest);
 154         final org.onap.so.adapters.vnfmadapter.extclients.vnfm.model.CreateVnfRequest vnfmRequest =
 155                 new org.onap.so.adapters.vnfmadapter.extclients.vnfm.model.CreateVnfRequest();
 156
 157         final String vnfdId = packageProvider.getVnfdId(genericVnf.getModelVersionId());
 158         vnfmRequest.setVnfdId(vnfdId);
 159         vnfmRequest.setVnfInstanceName(aaiRequest.getName().replaceAll(" ", "_"));
 160         vnfmRequest.setVnfInstanceDescription(vnfIdInAai);
 161
 162         final Optional<InlineResponse201> optionalResponse = vnfmServiceProvider.createVnf(vnfmId, vnfmRequest);
 163
 164         try {
 165             return optionalResponse.get();
 166         } catch (final Exception exception) {
 167             final String errorMessage = "Unable to return response from VNFM";
 168             logger.error(errorMessage, exception);
 169             throw new VnfmRequestFailureException(errorMessage, exception);
 170         }
 171     }
 172
 173     private void createNotificationSubscription(final String vnfmId, final String vnfId) {
 174         try {
 175             final LccnSubscriptionRequest subscriptionRequest = vnfmHelper.createNotificationSubscriptionRequest(vnfId);
 176             vnfmServiceProvider.subscribeForNotifications(vnfmId, subscriptionRequest);
 177         } catch (final Exception exception) {
 178             logger.warn("Subscription for notifications to VNFM: " + vnfmId + " for VNF " + vnfId
 179                     + " failed. AAI will not be updated unless the VNFM is configured by other means to send notifications relating to this VNF",
 180                     exception);
 181         }
 182     }
 183
 184     private String sendInstantiateRequestToVnfm(final EsrVnfm vnfm, final GenericVnf genericVnf,
 185             final CreateVnfRequest createVnfRequest, final String vnfIdInAai, final String vnfIdInVnfm) {
 186
 187         final InstantiateVnfRequest instantiateVnfRequest =
 188                 vnfmHelper.createInstantiateRequest(createVnfRequest.getTenant(), createVnfRequest,
 189                         packageProvider.getFlavourId(genericVnf.getModelVersionId()));
 190         final String jobId = vnfmServiceProvider.instantiateVnf(genericVnf.getSelflink(), instantiateVnfRequest);
 191
 192         logger.info("Instantiate VNF request successfully sent to " + genericVnf.getSelflink());
 193         return jobId;
 194     }
 195
 196     /**
 197      * Delete a VNF on a VNFM.
 198      *
 199      * @param vnfIdInAai the ID of the VNF in AAI
 200      * @return the response to the request
 201      */
 202     public DeleteVnfResponse deleteVnf(final String vnfIdInAai) {
 203         final GenericVnf genericVnf = getGenericVnfFromAai(vnfIdInAai);
 204         final String vnfmId = getIdOfAssignedVnfm(genericVnf);
 205
 206         final String operationId = sendTerminateRequestToVnfm(genericVnf);
 207         final String jobId = jobManager.createJob(vnfmId, operationId, true);
 208
 209         return new DeleteVnfResponse().jobId(jobId);
 210     }
 211
 212     private String sendTerminateRequestToVnfm(final GenericVnf genericVnf) {
 213         final TerminateVnfRequest terminateVnfRequest = new TerminateVnfRequest();
 214         terminateVnfRequest.setTerminationType(TerminationTypeEnum.FORCEFUL);
 215         return vnfmServiceProvider.terminateVnf(genericVnf.getSelflink(), terminateVnfRequest);
 216     }
 217
 218     private GenericVnf getGenericVnfFromAai(final String vnfIdInAai) {
 219         final GenericVnf genericVnf = aaiServiceProvider.invokeGetGenericVnf(vnfIdInAai);
 220         if (genericVnf == null) {
 221             throw new VnfNotFoundException("VNF not found in AAI: " + vnfIdInAai);
 222         }
 223         logger.debug("Retrieved generic VNF from AAI: " + genericVnf);
 224         return genericVnf;
 225     }
 226
 227     private String getIdOfAssignedVnfm(final GenericVnf genericVnf) {
 228         final String vnfmId = aaiHelper.getIdOfAssignedVnfm(genericVnf);
 229         if (vnfmId == null) {
 230             throw new VnfmNotFoundException("No VNFM found in AAI for VNF " + genericVnf.getVnfId());
 231         }
 232         return vnfmId;
 233     }
 234 }