/* * Copyright (c) 2013 Cisco Systems, Inc. and others. All rights reserved. * * This program and the accompanying materials are made available under the * terms of the Eclipse Public License v1.0 which accompanies this distribution, * and is available at http://www.eclipse.org/legal/epl-v10.html */ package org.opendaylight.bgpcep.programming.impl; import static java.util.Objects.requireNonNull; import com.google.common.util.concurrent.FutureCallback; import com.google.common.util.concurrent.Futures; import com.google.common.util.concurrent.ListenableFuture; import com.google.common.util.concurrent.ListeningExecutorService; import com.google.common.util.concurrent.MoreExecutors; import com.google.common.util.concurrent.SettableFuture; import io.netty.util.Timeout; import io.netty.util.Timer; import java.math.BigInteger; import java.util.ArrayList; import java.util.Collections; import java.util.HashMap; import java.util.Iterator; import java.util.List; import java.util.Map; import java.util.concurrent.TimeUnit; import org.opendaylight.bgpcep.programming.NanotimeUtil; import org.opendaylight.bgpcep.programming.impl.InstructionDeployerImpl.WriteConfiguration; import org.opendaylight.bgpcep.programming.spi.ExecutionResult; import org.opendaylight.bgpcep.programming.spi.Instruction; import org.opendaylight.bgpcep.programming.spi.InstructionScheduler; import org.opendaylight.bgpcep.programming.spi.SchedulerException; import org.opendaylight.bgpcep.programming.spi.SuccessfulRpcResult; import org.opendaylight.controller.md.sal.binding.api.DataBroker; import org.opendaylight.controller.md.sal.binding.api.NotificationPublishService; import org.opendaylight.controller.md.sal.binding.api.WriteTransaction; import org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType; import org.opendaylight.controller.sal.binding.api.BindingAwareBroker.RpcRegistration; import org.opendaylight.controller.sal.binding.api.RpcProviderRegistry; import org.opendaylight.mdsal.singleton.common.api.ClusterSingletonService; import org.opendaylight.mdsal.singleton.common.api.ClusterSingletonServiceProvider; import org.opendaylight.mdsal.singleton.common.api.ClusterSingletonServiceRegistration; import org.opendaylight.mdsal.singleton.common.api.ServiceGroupIdentifier; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.CancelInstructionInput; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.CancelInstructionOutput; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.CancelInstructionOutputBuilder; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.CleanInstructionsInput; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.CleanInstructionsOutput; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.CleanInstructionsOutputBuilder; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.DeadOnArrival; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.DuplicateInstructionId; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.InstructionId; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.InstructionStatus; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.InstructionStatusChangedBuilder; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.InstructionsQueue; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.InstructionsQueueBuilder; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.InstructionsQueueKey; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.Nanotime; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.ProgrammingService; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.SubmitInstructionInput; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.UnknownInstruction; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.UnknownPreconditionId; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.instruction.queue.InstructionBuilder; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.instruction.queue.InstructionKey; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.instruction.status.changed.Details; import org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.submit.instruction.output.result.failure._case.FailureBuilder; import org.opendaylight.yangtools.yang.binding.InstanceIdentifier; import org.opendaylight.yangtools.yang.binding.KeyedInstanceIdentifier; import org.opendaylight.yangtools.yang.common.RpcResult; import org.osgi.framework.ServiceRegistration; import org.slf4j.Logger; import org.slf4j.LoggerFactory; public final class ProgrammingServiceImpl implements AutoCloseable, ClusterSingletonService, InstructionScheduler, ProgrammingService { private static final Logger LOG = LoggerFactory.getLogger(ProgrammingServiceImpl.class); private final Map insns = new HashMap<>(); private final InstanceIdentifier qid; private final NotificationPublishService notifs; private final ListeningExecutorService executor; private final DataBroker dataProvider; private final Timer timer; private final String instructionId; private final ServiceGroupIdentifier sgi; private final ClusterSingletonServiceRegistration csspReg; private final RpcProviderRegistry rpcProviderRegistry; private final WriteConfiguration writeConfiguration; private RpcRegistration reg; private ServiceRegistration serviceRegistration; private final class InstructionPusher implements QueueInstruction { private final InstructionBuilder builder = new InstructionBuilder(); InstructionPusher(final InstructionId id, final Nanotime deadline) { this.builder.setDeadline(deadline); this.builder.setId(id); this.builder.setKey(new InstructionKey(id)); this.builder.setStatus(InstructionStatus.Queued); } @Override public void instructionUpdated(final InstructionStatus status, final Details details) { if (!status.equals(this.builder.getStatus())) { this.builder.setStatus(status); final WriteTransaction t = ProgrammingServiceImpl.this.dataProvider.newWriteOnlyTransaction(); t.put(LogicalDatastoreType.OPERATIONAL, ProgrammingServiceImpl.this.qid.child( org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming .rev150720.instruction.queue.Instruction.class, new InstructionKey(this.builder.getId())), this.builder.build()); Futures.addCallback(t.submit(), new FutureCallback() { @Override public void onSuccess(final Void result) { LOG.debug("Instruction Queue {} updated", ProgrammingServiceImpl.this.qid); } @Override public void onFailure(final Throwable t) { LOG.error("Failed to update Instruction Queue {}", ProgrammingServiceImpl.this.qid, t); } }, MoreExecutors.directExecutor()); } try { ProgrammingServiceImpl.this.notifs.putNotification(new InstructionStatusChangedBuilder() .setId(this.builder.getId()).setStatus(status).setDetails(details).build()); } catch (final InterruptedException e) { LOG.debug("Failed to publish notification", e); } } @Override public void instructionRemoved() { final WriteTransaction t = ProgrammingServiceImpl.this.dataProvider.newWriteOnlyTransaction(); t.delete(LogicalDatastoreType.OPERATIONAL, ProgrammingServiceImpl.this.qid.child( org.opendaylight.yang.gen.v1.urn.opendaylight.params.xml.ns.yang.programming.rev150720.instruction .queue.Instruction.class, new InstructionKey(this.builder.getId()))); Futures.addCallback(t.submit(), new FutureCallback() { @Override public void onSuccess(final Void result) { LOG.debug("Instruction Queue {} removed", ProgrammingServiceImpl.this.qid); } @Override public void onFailure(final Throwable t) { LOG.error("Failed to remove Instruction Queue {}", ProgrammingServiceImpl.this.qid, t); } }, MoreExecutors.directExecutor()); } } ProgrammingServiceImpl(final DataBroker dataProvider, final NotificationPublishService notifs, final ListeningExecutorService executor, final RpcProviderRegistry rpcProviderRegistry, final ClusterSingletonServiceProvider cssp, final Timer timer, final String instructionId, final WriteConfiguration writeConfiguration) { this.dataProvider = requireNonNull(dataProvider); this.instructionId = requireNonNull(instructionId); this.notifs = requireNonNull(notifs); this.executor = requireNonNull(executor); this.rpcProviderRegistry = requireNonNull(rpcProviderRegistry); this.timer = requireNonNull(timer); this.qid = KeyedInstanceIdentifier.builder(InstructionsQueue.class, new InstructionsQueueKey(this.instructionId)).build(); this.writeConfiguration = writeConfiguration; this.sgi = ServiceGroupIdentifier.create("programming-" + this.instructionId + "-service-group"); this.csspReg = cssp.registerClusterSingletonService(this); } @Override public void instantiateServiceInstance() { LOG.info("Instruction Queue service {} instantiated", this.sgi.getValue()); if (this.writeConfiguration != null) { this.writeConfiguration.create(); } this.reg = this.rpcProviderRegistry.addRpcImplementation(ProgrammingService.class, this); final WriteTransaction t = this.dataProvider.newWriteOnlyTransaction(); t.put(LogicalDatastoreType.OPERATIONAL, this.qid, new InstructionsQueueBuilder() .setKey(new InstructionsQueueKey(this.instructionId)).setInstruction(Collections.emptyList()).build()); Futures.addCallback(t.submit(), new FutureCallback() { @Override public void onSuccess(final Void result) { LOG.debug("Instruction Queue {} added", ProgrammingServiceImpl.this.qid); } @Override public void onFailure(final Throwable t) { LOG.error("Failed to add Instruction Queue {}", ProgrammingServiceImpl.this.qid, t); } }, MoreExecutors.directExecutor()); } @Override public ServiceGroupIdentifier getIdentifier() { return this.sgi; } @Override public ListenableFuture> cancelInstruction(final CancelInstructionInput input) { return this.executor.submit(() -> realCancelInstruction(input)); } @Override public ListenableFuture> cleanInstructions(final CleanInstructionsInput input) { return this.executor.submit(() -> realCleanInstructions(input)); } private synchronized RpcResult realCancelInstruction(final CancelInstructionInput input) { final InstructionImpl i = this.insns.get(input.getId()); if (i == null) { LOG.debug("Instruction {} not present in the graph", input.getId()); final CancelInstructionOutput out = new CancelInstructionOutputBuilder() .setFailure(UnknownInstruction.class).build(); return SuccessfulRpcResult.create(out); } return SuccessfulRpcResult.create(new CancelInstructionOutputBuilder().setFailure(i.tryCancel(null)).build()); } private synchronized RpcResult realCleanInstructions(final CleanInstructionsInput input) { final List failed = new ArrayList<>(); for (final InstructionId id : input.getId()) { // Find the instruction final InstructionImpl i = this.insns.get(id); if (i == null) { LOG.debug("Instruction {} not present in the graph", input.getId()); failed.add(id); continue; } // Check its status switch (i.getStatus()) { case Cancelled: case Failed: case Successful: break; case Executing: case Queued: case Scheduled: case Unknown: LOG.debug("Instruction {} cannot be cleaned because of it's in state {}", id, i.getStatus()); failed.add(id); continue; default: break; } // The instruction is in a terminal state, we need to just unlink // it from its dependencies and dependents i.clean(); this.insns.remove(id); LOG.debug("Instruction {} cleaned successfully", id); } final CleanInstructionsOutputBuilder ob = new CleanInstructionsOutputBuilder(); ob.setUnflushed(failed); return SuccessfulRpcResult.create(ob.build()); } private List checkDependencies(final SubmitInstructionInput input) throws SchedulerException { final List dependencies = collectDependencies(input); // Check if all dependencies are non-failed final List unmet = checkIfUnfailed(dependencies); /* * Some dependencies have failed, declare the request dead-on-arrival * and fail the operation. */ if (!unmet.isEmpty()) { throw new SchedulerException("Instruction's dependencies are already unsuccessful", new FailureBuilder() .setType(DeadOnArrival.class).setFailedPreconditions(unmet).build()); } return dependencies; } private List collectDependencies(final SubmitInstructionInput input) throws SchedulerException { final List dependencies = new ArrayList<>(); for (final InstructionId pid : input.getPreconditions()) { final InstructionImpl i = this.insns.get(pid); if (i == null) { LOG.info("Instruction {} depends on {}, which is not a known instruction", input.getId(), pid); throw new SchedulerException("Unknown dependency ID specified", new FailureBuilder().setType(UnknownPreconditionId.class).build()); } dependencies.add(i); } return dependencies; } private static List checkIfUnfailed(final List dependencies) { final List unmet = new ArrayList<>(); for (final InstructionImpl d : dependencies) { switch (d.getStatus()) { case Cancelled: case Failed: case Unknown: unmet.add(d.getId()); break; case Executing: case Queued: case Scheduled: case Successful: break; default: break; } } return unmet; } @Override public synchronized ListenableFuture scheduleInstruction(final SubmitInstructionInput input) throws SchedulerException { final InstructionId id = input.getId(); if (this.insns.get(id) != null) { LOG.info("Instruction ID {} already present", id); throw new SchedulerException("Instruction ID currently in use", new FailureBuilder().setType(DuplicateInstructionId.class).build()); } // First things first: check the deadline final Nanotime now = NanotimeUtil.currentTime(); final BigInteger left = input.getDeadline().getValue().subtract(now.getValue()); if (left.compareTo(BigInteger.ZERO) <= 0) { LOG.debug("Instruction {} deadline has already passed by {}ns", id, left); throw new SchedulerException("Instruction arrived after specified deadline", new FailureBuilder().setType(DeadOnArrival.class).build()); } // Resolve dependencies final List dependencies = checkDependencies(input); /* * All pre-flight checks done are at this point, the following * steps can only fail in catastrophic scenarios (OOM and the * like). */ // Schedule a timeout for the instruction final Timeout t = this.timer.newTimeout(timeout -> timeoutInstruction(input.getId()), left.longValue(), TimeUnit.NANOSECONDS); // Put it into the instruction list final SettableFuture ret = SettableFuture.create(); final InstructionImpl i = new InstructionImpl(new InstructionPusher(id, input.getDeadline()), ret, id, dependencies, t); this.insns.put(id, i); // Attach it into its dependencies for (final InstructionImpl d : dependencies) { d.addDependant(i); } /* * All done. The next part is checking whether the instruction can * run, which we can figure out after sending out the acknowledgement. * This task should be ingress-weighed, so we reinsert it into the * same execution service. */ this.executor.submit(() -> tryScheduleInstruction(i)); return ret; } @Override public String getInstructionID() { return this.instructionId; } private synchronized void timeoutInstruction(final InstructionId id) { final InstructionImpl i = this.insns.get(id); if (i == null) { LOG.warn("Instruction {} timed out, but not found in the queue", id); return; } i.timeout(); } private synchronized void tryScheduleDependants(final InstructionImpl i) { // Walk all dependants and try to schedule them final Iterator it = i.getDependants(); while (it.hasNext()) { tryScheduleInstruction(it.next()); } } private synchronized void tryScheduleInstruction(final InstructionImpl i) { final ListenableFuture> f = i.ready(); if (f != null) { Futures.addCallback(f, new FutureCallback>() { @Override public void onSuccess(final ExecutionResult
result) { tryScheduleDependants(i); } @Override public void onFailure(final Throwable t) { LOG.error("Instruction {} failed to execute", i.getId(), t); } }, MoreExecutors.directExecutor()); } } @Override public synchronized ListenableFuture closeServiceInstance() { LOG.info("Closing Instruction Queue service {}", this.sgi.getValue()); ListenableFuture writeConfigurationFuture = null; if (this.writeConfiguration != null) { writeConfigurationFuture = this.writeConfiguration.remove(); } this.reg.close(); for (final InstructionImpl i : this.insns.values()) { i.tryCancel(null); } // Workaround for BUG-2283 final WriteTransaction t = this.dataProvider.newWriteOnlyTransaction(); t.delete(LogicalDatastoreType.OPERATIONAL, this.qid); final SettableFuture future = SettableFuture.create(); if (writeConfigurationFuture != null) { writeConfigurationFuture.addListener(() -> submitRemoval(t, future), executor); } else { submitRemoval(t, future); } return future; } private void submitRemoval(WriteTransaction t, SettableFuture futureSetable) { final ListenableFuture future = t.submit(); Futures.addCallback(future, new FutureCallback() { @Override public void onSuccess(final Void result) { LOG.debug("Instruction Queue {} removed", ProgrammingServiceImpl.this.qid); futureSetable.set(null); } @Override public void onFailure(final Throwable t) { LOG.error("Failed to shutdown Instruction Queue {}", ProgrammingServiceImpl.this.qid, t); futureSetable.setException(t); } }, MoreExecutors.directExecutor()); } @Override public synchronized void close() { if (this.csspReg != null) { try { this.csspReg.close(); } catch (final Exception e) { LOG.debug("Failed to close Instruction Scheduler service", e); } } if (this.serviceRegistration != null) { this.serviceRegistration.unregister(); this.serviceRegistration = null; } } void setServiceRegistration(final ServiceRegistration serviceRegistration) { this.serviceRegistration = serviceRegistration; } }