policy-agent/src/main/java/org/oransc/policyagent/tasks/RicSupervision.java

   1 /*-
   2  * ========================LICENSE_START=================================
   3  * O-RAN-SC
   4  * %%
   5  * Copyright (C) 2020 Nordix Foundation
   6  * %%
   7  * Licensed under the Apache License, Version 2.0 (the "License");
   8  * you may not use this file except in compliance with the License.
   9  * You may obtain a copy of the License at
  10  *
  11  *      http://www.apache.org/licenses/LICENSE-2.0
  12  *
  13  * Unless required by applicable law or agreed to in writing, software
  14  * distributed under the License is distributed on an "AS IS" BASIS,
  15  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  16  * See the License for the specific language governing permissions and
  17  * limitations under the License.
  18  * ========================LICENSE_END===================================
  19  */
  20
  21 package org.oransc.policyagent.tasks;
  22
  23 import java.util.Collection;
  24
  25 import org.oransc.policyagent.clients.A1Client;
  26 import org.oransc.policyagent.clients.A1ClientFactory;
  27 import org.oransc.policyagent.repository.Lock.LockType;
  28 import org.oransc.policyagent.repository.Policies;
  29 import org.oransc.policyagent.repository.PolicyTypes;
  30 import org.oransc.policyagent.repository.Ric;
  31 import org.oransc.policyagent.repository.Ric.RicState;
  32 import org.oransc.policyagent.repository.Rics;
  33 import org.oransc.policyagent.repository.Services;
  34 import org.slf4j.Logger;
  35 import org.slf4j.LoggerFactory;
  36 import org.springframework.beans.factory.annotation.Autowired;
  37 import org.springframework.scheduling.annotation.EnableScheduling;
  38 import org.springframework.scheduling.annotation.Scheduled;
  39 import org.springframework.stereotype.Component;
  40
  41 import reactor.core.publisher.Flux;
  42 import reactor.core.publisher.Mono;
  43
  44 /**
  45  * Regularly checks the existing rics towards the local repository to keep it
  46  * consistent. When the policy types or instances in the Near-RT RIC is not
  47  * consistent, a synchronization is performed.
  48  */
  49 @Component
  50 @EnableScheduling
  51 @SuppressWarnings("squid:S2629") // Invoke method(s) only conditionally
  52 public class RicSupervision {
  53     private static final Logger logger = LoggerFactory.getLogger(RicSupervision.class);
  54
  55     private final Rics rics;
  56     private final Policies policies;
  57     private final PolicyTypes policyTypes;
  58     private final A1ClientFactory a1ClientFactory;
  59     private final Services services;
  60
  61     @Autowired
  62     public RicSupervision(Rics rics, Policies policies, A1ClientFactory a1ClientFactory, PolicyTypes policyTypes,
  63         Services services) {
  64         this.rics = rics;
  65         this.policies = policies;
  66         this.a1ClientFactory = a1ClientFactory;
  67         this.policyTypes = policyTypes;
  68         this.services = services;
  69     }
  70
  71     /**
  72      * Regularly contacts all Rics to check if they are alive and synchronized.
  73      */
  74     @Scheduled(fixedRate = 1000 * 60)
  75     public void checkAllRics() {
  76         logger.debug("Checking Rics starting");
  77         createTask().subscribe( //
  78             ric -> logger.debug("Ric: {} checked", ric.ric.name()), //
  79             null, //
  80             () -> logger.debug("Checking Rics completed") //
  81         );
  82     }
  83
  84     private Flux<RicData> createTask() {
  85         synchronized (this.rics) {
  86             return Flux.fromIterable(rics.getRics()) //
  87                 .flatMap(this::createRicData) //
  88                 .flatMap(this::checkOneRic) //
  89                 .onErrorResume(throwable -> Mono.empty());
  90         }
  91     }
  92
  93     private Mono<RicData> checkOneRic(RicData ricData) {
  94         return checkRicState(ricData) //
  95             .flatMap(x -> ricData.ric.getLock().lock(LockType.EXCLUSIVE)) //
  96             .flatMap(x -> checkRicPolicies(ricData)) //
  97             .flatMap(x -> ricData.ric.getLock().unlock()) //
  98             .doOnError(throwable -> ricData.ric.getLock().unlockBlocking()) //
  99             .flatMap(x -> checkRicPolicyTypes(ricData)); //
 100     }
 101
 102     private static class RicData {
 103         RicData(Ric ric, A1Client a1Client) {
 104             this.ric = ric;
 105             this.a1Client = a1Client;
 106         }
 107
 108         final Ric ric;
 109         final A1Client a1Client;
 110     }
 111
 112     private Mono<RicData> createRicData(Ric ric) {
 113         return Mono.just(ric) //
 114             .flatMap(aRic -> this.a1ClientFactory.createA1Client(ric)) //
 115             .flatMap(a1Client -> Mono.just(new RicData(ric, a1Client)));
 116     }
 117
 118     private Mono<RicData> checkRicState(RicData ric) {
 119         if (ric.ric.getState() == RicState.UNDEFINED) {
 120             return startSynchronization(ric) //
 121                 .onErrorResume(t -> Mono.empty());
 122         } else if (ric.ric.getState() == RicState.SYNCHRONIZING) {
 123             return Mono.empty();
 124         } else {
 125             return Mono.just(ric);
 126         }
 127     }
 128
 129     private Mono<RicData> checkRicPolicies(RicData ric) {
 130         return ric.a1Client.getPolicyIdentities() //
 131             .flatMap(ricP -> validateInstances(ricP, ric));
 132     }
 133
 134     private Mono<RicData> validateInstances(Collection<String> ricPolicies, RicData ric) {
 135         synchronized (this.policies) {
 136             if (ricPolicies.size() != policies.getForRic(ric.ric.name()).size()) {
 137                 return startSynchronization(ric);
 138             }
 139
 140             for (String policyId : ricPolicies) {
 141                 if (!policies.containsPolicy(policyId)) {
 142                     return startSynchronization(ric);
 143                 }
 144             }
 145             return Mono.just(ric);
 146         }
 147     }
 148
 149     private Mono<RicData> checkRicPolicyTypes(RicData ric) {
 150         return ric.a1Client.getPolicyTypeIdentities() //
 151             .flatMap(ricTypes -> validateTypes(ricTypes, ric));
 152     }
 153
 154     private Mono<RicData> validateTypes(Collection<String> ricTypes, RicData ric) {
 155         if (ricTypes.size() != ric.ric.getSupportedPolicyTypes().size()) {
 156             return startSynchronization(ric);
 157         }
 158         for (String typeName : ricTypes) {
 159             if (!ric.ric.isSupportingType(typeName)) {
 160                 return startSynchronization(ric);
 161             }
 162         }
 163         return Mono.just(ric);
 164     }
 165
 166     private Mono<RicData> startSynchronization(RicData ric) {
 167         RicSynchronizationTask synchronizationTask = createSynchronizationTask();
 168         synchronizationTask.run(ric.ric);
 169         return Mono.error(new Exception("Syncronization started"));
 170     }
 171
 172     RicSynchronizationTask createSynchronizationTask() {
 173         return new RicSynchronizationTask(a1ClientFactory, policyTypes, policies, services);
 174     }
 175 }