Port ELAN service to datastore-constrained txns
[netvirt.git] / elanmanager / impl / src / main / java / org / opendaylight / netvirt / elan / evpn / utils / EvpnUtils.java
1 /*
2  * Copyright © 2017 Ericsson India Global Services Pvt Ltd. and others.  All rights reserved.
3  *
4  * This program and the accompanying materials are made available under the
5  * terms of the Eclipse Public License v1.0 which accompanies this distribution,
6  * and is available at http://www.eclipse.org/legal/epl-v10.html
7  */
8 package org.opendaylight.netvirt.elan.evpn.utils;
9
10 import static org.opendaylight.genius.infra.Datastore.CONFIGURATION;
11
12 import com.google.common.base.Optional;
13 import com.google.common.util.concurrent.Futures;
14 import com.google.common.util.concurrent.MoreExecutors;
15 import com.google.common.util.concurrent.SettableFuture;
16 import java.math.BigInteger;
17 import java.util.ArrayList;
18 import java.util.Collections;
19 import java.util.List;
20 import java.util.concurrent.ExecutionException;
21 import java.util.concurrent.Future;
22 import java.util.function.BiConsumer;
23 import java.util.function.BiPredicate;
24 import java.util.function.Function;
25 import java.util.function.Predicate;
26 import javax.inject.Inject;
27 import javax.inject.Singleton;
28 import org.opendaylight.controller.md.sal.binding.api.DataBroker;
29 import org.opendaylight.controller.md.sal.binding.api.ReadOnlyTransaction;
30 import org.opendaylight.controller.md.sal.binding.api.WriteTransaction;
31 import org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType;
32 import org.opendaylight.controller.md.sal.common.api.data.ReadFailedException;
33 import org.opendaylight.genius.infra.ManagedNewTransactionRunner;
34 import org.opendaylight.genius.infra.ManagedNewTransactionRunnerImpl;
35 import org.opendaylight.genius.interfacemanager.globals.InterfaceInfo;
36 import org.opendaylight.genius.interfacemanager.interfaces.IInterfaceManager;
37 import org.opendaylight.genius.itm.globals.ITMConstants;
38 import org.opendaylight.genius.mdsalutil.FlowEntity;
39 import org.opendaylight.genius.mdsalutil.InstructionInfo;
40 import org.opendaylight.genius.mdsalutil.MDSALUtil;
41 import org.opendaylight.genius.mdsalutil.MatchInfo;
42 import org.opendaylight.genius.mdsalutil.NWUtil;
43 import org.opendaylight.genius.mdsalutil.NwConstants;
44 import org.opendaylight.genius.mdsalutil.instructions.InstructionGotoTable;
45 import org.opendaylight.genius.mdsalutil.instructions.InstructionWriteMetadata;
46 import org.opendaylight.genius.mdsalutil.matches.MatchTunnelId;
47 import org.opendaylight.genius.utils.ServiceIndex;
48 import org.opendaylight.infrautils.jobcoordinator.JobCoordinator;
49 import org.opendaylight.infrautils.utils.concurrent.ListenableFutures;
50 import org.opendaylight.netvirt.bgpmanager.api.IBgpManager;
51 import org.opendaylight.netvirt.elan.cache.ElanInstanceCache;
52 import org.opendaylight.netvirt.elan.l2gw.utils.SettableFutureCallback;
53 import org.opendaylight.netvirt.elan.utils.ElanConstants;
54 import org.opendaylight.netvirt.elan.utils.ElanUtils;
55 import org.opendaylight.netvirt.elanmanager.api.ElanHelper;
56 import org.opendaylight.netvirt.vpnmanager.api.IVpnManager;
57 import org.opendaylight.yang.gen.v1.urn.huawei.params.xml.ns.yang.l3vpn.rev140815.vpn.instances.VpnInstance;
58 import org.opendaylight.yang.gen.v1.urn.ietf.params.xml.ns.yang.ietf.inet.types.rev130715.IpAddress;
59 import org.opendaylight.yang.gen.v1.urn.opendaylight.flow.types.rev131026.instruction.list.Instruction;
60 import org.opendaylight.yang.gen.v1.urn.opendaylight.genius.interfacemanager.servicebinding.rev160406.service.bindings.services.info.BoundServices;
61 import org.opendaylight.yang.gen.v1.urn.opendaylight.genius.itm.op.rev160406.ExternalTunnelList;
62 import org.opendaylight.yang.gen.v1.urn.opendaylight.genius.itm.op.rev160406.external.tunnel.list.ExternalTunnel;
63 import org.opendaylight.yang.gen.v1.urn.opendaylight.genius.itm.rev160406.DcGatewayIpList;
64 import org.opendaylight.yang.gen.v1.urn.opendaylight.genius.itm.rev160406.dc.gateway.ip.list.DcGatewayIp;
65 import org.opendaylight.yang.gen.v1.urn.opendaylight.genius.itm.rpcs.rev160406.GetDpnEndpointIpsInputBuilder;
66 import org.opendaylight.yang.gen.v1.urn.opendaylight.genius.itm.rpcs.rev160406.GetDpnEndpointIpsOutput;
67 import org.opendaylight.yang.gen.v1.urn.opendaylight.genius.itm.rpcs.rev160406.ItmRpcService;
68 import org.opendaylight.yang.gen.v1.urn.opendaylight.netvirt.elan.rev150602.EvpnAugmentation;
69 import org.opendaylight.yang.gen.v1.urn.opendaylight.netvirt.elan.rev150602.elan.instances.ElanInstance;
70 import org.opendaylight.yang.gen.v1.urn.opendaylight.netvirt.elan.rev150602.forwarding.entries.MacEntry;
71 import org.opendaylight.yang.gen.v1.urn.opendaylight.netvirt.fibmanager.rev150330.VrfEntryBase;
72 import org.opendaylight.yang.gen.v1.urn.opendaylight.netvirt.neutronvpn.rev150602.neutron.vpn.portip.port.data.VpnPortipToPort;
73 import org.opendaylight.yangtools.yang.binding.DataObject;
74 import org.opendaylight.yangtools.yang.binding.InstanceIdentifier;
75 import org.opendaylight.yangtools.yang.common.RpcResult;
76 import org.slf4j.Logger;
77 import org.slf4j.LoggerFactory;
78
79 @Singleton
80 public class EvpnUtils {
81
82     private static final Logger LOG = LoggerFactory.getLogger(EvpnUtils.class);
83
84     private final BiPredicate<String, String> isNetAttach = (var1, var2) -> (var1 == null && var2 != null);
85     private final BiPredicate<String, String> isNetDetach = (var1, var2) -> (var1 != null && var2 == null);
86     private final Predicate<MacEntry> isIpv4PrefixAvailable = (macEntry) -> (macEntry != null
87         && macEntry.getIpPrefix() != null && macEntry.getIpPrefix().getIpv4Address() != null);
88     private final DataBroker broker;
89     private final ManagedNewTransactionRunner txRunner;
90     private final IInterfaceManager interfaceManager;
91     private final ElanUtils elanUtils;
92     private final ItmRpcService itmRpcService;
93     private final JobCoordinator jobCoordinator;
94     private final IBgpManager bgpManager;
95     private final IVpnManager vpnManager;
96     private final ElanInstanceCache elanInstanceCache;
97
98     @Inject
99     public EvpnUtils(DataBroker broker, IInterfaceManager interfaceManager, ElanUtils elanUtils,
100             ItmRpcService itmRpcService, IVpnManager vpnManager, IBgpManager bgpManager,
101             JobCoordinator jobCoordinator, ElanInstanceCache elanInstanceCache) {
102         this.broker = broker;
103         this.txRunner = new ManagedNewTransactionRunnerImpl(broker);
104         this.interfaceManager = interfaceManager;
105         this.elanUtils = elanUtils;
106         this.itmRpcService = itmRpcService;
107         this.vpnManager = vpnManager;
108         this.bgpManager = bgpManager;
109         this.jobCoordinator = jobCoordinator;
110         this.elanInstanceCache = elanInstanceCache;
111     }
112
113     public boolean isWithdrawEvpnRT2Routes(ElanInstance original, ElanInstance update) {
114         return isNetDetach.test(getEvpnNameFromElan(original), getEvpnNameFromElan(update));
115     }
116
117     public boolean isAdvertiseEvpnRT2Routes(ElanInstance original, ElanInstance update) {
118         return isNetAttach.test(getEvpnNameFromElan(original), getEvpnNameFromElan(update));
119     }
120
121     @SuppressWarnings("checkstyle:IllegalCatch")
122     public void advertiseEvpnRT2Routes(EvpnAugmentation evpnAugmentation, String elanName)  {
123         if (evpnAugmentation == null || evpnAugmentation.getEvpnName() == null) {
124             return;
125         }
126         String evpnName = evpnAugmentation.getEvpnName();
127         List<MacEntry> macEntries = elanUtils.getElanMacEntries(elanName);
128         if (macEntries == null || macEntries.isEmpty()) {
129             LOG.trace("advertiseEvpnRT2Routes no elan mac entries found for {}", elanName);
130             return;
131         }
132         String rd = vpnManager.getVpnRd(broker, evpnName);
133         ElanInstance elanInfo = elanInstanceCache.get(elanName).orNull();
134         macEntries.stream().filter(isIpv4PrefixAvailable).forEach(macEntry -> {
135             InterfaceInfo interfaceInfo = interfaceManager.getInterfaceInfo(macEntry.getInterface());
136             if (interfaceInfo == null) {
137                 LOG.debug("advertiseEvpnRT2Routes, interfaceInfo is null for interface {}", macEntry.getInterface());
138                 return;
139             }
140             advertisePrefix(elanInfo, rd, macEntry.getMacAddress().getValue(),
141                     macEntry.getIpPrefix().getIpv4Address().getValue(),
142                     interfaceInfo.getInterfaceName(), interfaceInfo.getDpId());
143         });
144     }
145
146     public String getEndpointIpAddressForDPN(BigInteger dpnId) {
147
148         Future<RpcResult<GetDpnEndpointIpsOutput>> result = itmRpcService.getDpnEndpointIps(
149                 new GetDpnEndpointIpsInputBuilder()
150                         .setSourceDpid(dpnId)
151                         .build());
152         RpcResult<GetDpnEndpointIpsOutput> rpcResult = null;
153         try {
154             rpcResult = result.get();
155         } catch (InterruptedException e) {
156             LOG.error("getnextHopIpFromRpcOutput : InterruptedException for dpnid {}", dpnId, e);
157             return null;
158         } catch (ExecutionException e) {
159             LOG.error("getnextHopIpFromRpcOutput : ExecutionException for dpnid {}", dpnId, e);
160             return null;
161         }
162         if (!rpcResult.isSuccessful()) {
163             LOG.warn("RPC Call to getDpnEndpointIps returned with Errors {}", rpcResult.getErrors());
164             return null;
165         }
166
167         List<IpAddress> nexthopIpList = rpcResult.getResult().getNexthopipList();
168         return nexthopIpList.get(0).getIpv4Address().getValue();
169     }
170
171     public Optional<String> getGatewayMacAddressForInterface(String vpnName,
172                                                                                     String ifName, String ipAddress) {
173         VpnPortipToPort gwPort = vpnManager.getNeutronPortFromVpnPortFixedIp(broker, vpnName, ipAddress);
174         return Optional.of(gwPort != null && gwPort.isSubnetIp()
175                 ? gwPort.getMacAddress()
176                 : interfaceManager.getInterfaceInfoFromOperationalDataStore(ifName).getMacAddress());
177     }
178
179     public String getL3vpnNameFromElan(ElanInstance elanInfo) {
180         if (elanInfo == null) {
181             LOG.debug("getL3vpnNameFromElan :elanInfo is NULL");
182             return null;
183         }
184         EvpnAugmentation evpnAugmentation = elanInfo.augmentation(EvpnAugmentation.class);
185         return evpnAugmentation != null ? evpnAugmentation.getL3vpnName() : null;
186     }
187
188     public static String getEvpnNameFromElan(ElanInstance elanInfo) {
189         if (elanInfo == null) {
190             LOG.debug("getEvpnNameFromElan :elanInfo is NULL");
191             return null;
192         }
193         EvpnAugmentation evpnAugmentation = elanInfo.augmentation(EvpnAugmentation.class);
194         return evpnAugmentation != null ? evpnAugmentation.getEvpnName() : null;
195     }
196
197     public String getEvpnRd(ElanInstance elanInfo) {
198         String evpnName = getEvpnNameFromElan(elanInfo);
199         if (evpnName == null) {
200             LOG.debug("getEvpnRd : evpnName is NULL for elanInfo {}", elanInfo);
201             return null;
202         }
203         return vpnManager.getVpnRd(broker, evpnName);
204     }
205
206     public void advertisePrefix(ElanInstance elanInfo, String macAddress, String prefix,
207                                  String interfaceName, BigInteger dpnId) {
208         String rd = getEvpnRd(elanInfo);
209         advertisePrefix(elanInfo, rd, macAddress, prefix, interfaceName, dpnId);
210     }
211
212     @SuppressWarnings("checkstyle:IllegalCatch")
213     public void advertisePrefix(ElanInstance elanInfo, String rd,
214                                  String macAddress, String prefix, String interfaceName, BigInteger dpnId) {
215         if (rd == null) {
216             LOG.debug("advertisePrefix : rd is NULL for elanInfo {}, macAddress {}", elanInfo, macAddress);
217             return;
218         }
219         String nextHop = getEndpointIpAddressForDPN(dpnId);
220         if (nextHop == null) {
221             LOG.debug("Failed to get the dpn tep ip for dpn {}", dpnId);
222             return;
223         }
224         int vpnLabel = 0;
225         long l2vni = elanUtils.getVxlanSegmentationId(elanInfo);
226         long l3vni = 0;
227         String gatewayMacAddr = null;
228         String l3VpName = getL3vpnNameFromElan(elanInfo);
229         if (l3VpName != null) {
230             VpnInstance l3VpnInstance = vpnManager.getVpnInstance(broker, l3VpName);
231             l3vni = l3VpnInstance.getL3vni();
232             com.google.common.base.Optional<String> gatewayMac = getGatewayMacAddressForInterface(l3VpName,
233                     interfaceName, prefix);
234             gatewayMacAddr = gatewayMac.isPresent() ? gatewayMac.get() : null;
235
236         }
237         LOG.info("Advertising routes with rd {},  macAddress {}, prefix {}, nextHop {},"
238                         + " vpnLabel {}, l3vni {}, l2vni {}, gatewayMac {}", rd, macAddress, prefix, nextHop,
239                 vpnLabel, l3vni, l2vni, gatewayMacAddr);
240         try {
241             bgpManager.advertisePrefix(rd, macAddress, prefix, nextHop,
242                     VrfEntryBase.EncapType.Vxlan, vpnLabel, l3vni, l2vni, gatewayMacAddr);
243         } catch (Exception e) {
244             LOG.error("Failed to advertisePrefix", e);
245         }
246     }
247
248     public void advertisePrefix(ElanInstance elanInfo, MacEntry macEntry) {
249         InterfaceInfo interfaceInfo = interfaceManager.getInterfaceInfo(macEntry.getInterface());
250         if (interfaceInfo == null) {
251             LOG.debug("advertisePrefix, interfaceInfo is null for interface {}", macEntry.getInterface());
252             return;
253         }
254
255         if (!isIpv4PrefixAvailable.test(macEntry)) {
256             LOG.debug("advertisePrefix macEntry does not have IPv4 prefix {}", macEntry);
257             return;
258         }
259         advertisePrefix(elanInfo, macEntry.getMacAddress().getValue(),
260                 macEntry.getIpPrefix().getIpv4Address().getValue(),
261                 interfaceInfo.getInterfaceName(), interfaceInfo.getDpId());
262     }
263
264     public void withdrawEvpnRT2Routes(EvpnAugmentation evpnAugmentation, String elanName) {
265         if (evpnAugmentation == null || evpnAugmentation.getEvpnName() == null) {
266             LOG.trace("withdrawEvpnRT2Routes, evpnAugmentation is null");
267             return;
268         }
269
270         String evpnName = evpnAugmentation.getEvpnName();
271         String rd = vpnManager.getVpnRd(broker, evpnName);
272         if (rd == null) {
273             LOG.debug("withdrawEvpnRT2Routes : rd is null for {}", elanName);
274             return;
275         }
276         List<MacEntry> macEntries = elanUtils.getElanMacEntries(elanName);
277         if (macEntries == null || macEntries.isEmpty()) {
278             LOG.debug("withdrawEvpnRT2Routes : macEntries  is empty for elan {} ", elanName);
279             return;
280         }
281         for (MacEntry macEntry : macEntries) {
282             if (!isIpv4PrefixAvailable.test(macEntry)) {
283                 LOG.debug("withdrawEvpnRT2Routes macEntry does not have IPv4 prefix {}", macEntry);
284                 continue;
285             }
286             String prefix = macEntry.getIpPrefix().getIpv4Address().getValue();
287             LOG.info("Withdrawing routes with rd {}, prefix {}", rd, prefix);
288             bgpManager.withdrawPrefix(rd, prefix);
289         }
290     }
291
292     public void withdrawPrefix(ElanInstance elanInfo, String prefix) {
293         String rd = getEvpnRd(elanInfo);
294         if (rd == null) {
295             return;
296         }
297         bgpManager.withdrawPrefix(rd, prefix);
298     }
299
300     public void withdrawPrefix(ElanInstance elanInfo, MacEntry macEntry) {
301         if (!isIpv4PrefixAvailable.test(macEntry)) {
302             LOG.debug("withdrawPrefix macEntry does not have IPv4 prefix {}", macEntry);
303             return;
304         }
305         withdrawPrefix(elanInfo, macEntry.getIpPrefix().getIpv4Address().getValue());
306     }
307
308     public static InstanceIdentifier<ExternalTunnelList> getExternaTunnelListIdentifier() {
309         return InstanceIdentifier
310                 .builder(ExternalTunnelList.class).build();
311     }
312
313     public Optional<ExternalTunnelList> getExternalTunnelList() {
314         InstanceIdentifier<ExternalTunnelList> externalTunnelListId = getExternaTunnelListIdentifier();
315         ExternalTunnelList externalTunnelList = null;
316         try {
317             externalTunnelList = elanUtils.read2(LogicalDatastoreType.CONFIGURATION,
318                     externalTunnelListId).orNull();
319         } catch (ReadFailedException e) {
320             LOG.error("getExternalTunnelList: unable to read ExternalTunnelList, exception ", e);
321         }
322         return Optional.fromNullable(externalTunnelList);
323     }
324
325     public static InstanceIdentifier<DcGatewayIpList> getDcGatewayIpListIdentifier() {
326         return InstanceIdentifier
327                 .builder(DcGatewayIpList.class).build();
328     }
329
330     public Optional<DcGatewayIpList> getDcGatewayIpList() {
331         InstanceIdentifier<DcGatewayIpList> dcGatewayIpListInstanceIdentifier = getDcGatewayIpListIdentifier();
332         DcGatewayIpList dcGatewayIpListConfig = null;
333         try {
334             dcGatewayIpListConfig = elanUtils.read2(LogicalDatastoreType.CONFIGURATION,
335                     dcGatewayIpListInstanceIdentifier).orNull();
336         } catch (ReadFailedException e) {
337             LOG.error("getDcGatewayTunnelInterfaceNameList: unable to read DcGatewayTunnelList, exception ", e);
338         }
339         return Optional.fromNullable(dcGatewayIpListConfig);
340     }
341
342     public List<String> getDcGatewayTunnelInterfaceNameList() {
343         final List<String> tunnelInterfaceNameList = new ArrayList<>();
344         Optional<DcGatewayIpList> dcGatewayIpListOptional = getDcGatewayIpList();
345         if (!dcGatewayIpListOptional.isPresent()) {
346             LOG.info("No DC gateways configured while programming the l2vni table.");
347             return tunnelInterfaceNameList;
348         }
349         List<DcGatewayIp> dcGatewayIps = dcGatewayIpListOptional.get().getDcGatewayIp();
350
351         Optional<ExternalTunnelList> externalTunnelListOptional = getExternalTunnelList();
352         if (!externalTunnelListOptional.isPresent()) {
353             LOG.info("No External Tunnel Configured while programming the l2vni table.");
354             return tunnelInterfaceNameList;
355         }
356         List<ExternalTunnel> externalTunnels = externalTunnelListOptional.get().getExternalTunnel();
357
358         dcGatewayIps
359                 .forEach(dcIp -> externalTunnels
360                 .stream()
361                 .filter(externalTunnel -> externalTunnel.getDestinationDevice()
362                         .contains(dcIp.getIpAddress().getIpv4Address().toString()))
363                 .forEach(externalTunnel -> tunnelInterfaceNameList.add(externalTunnel.getTunnelInterfaceName())));
364
365         return tunnelInterfaceNameList;
366     }
367
368     public void bindElanServiceToExternalTunnel(String elanName, String interfaceName) {
369         ListenableFutures.addErrorLogging(txRunner.callWithNewReadWriteTransactionAndSubmit(CONFIGURATION, tx -> {
370             int instructionKey = 0;
371             LOG.trace("Binding external interface {} elan {}", interfaceName, elanName);
372             List<Instruction> instructions = new ArrayList<>();
373             instructions.add(MDSALUtil.buildAndGetGotoTableInstruction(
374                     NwConstants.L2VNI_EXTERNAL_TUNNEL_DEMUX_TABLE, ++instructionKey));
375             short elanServiceIndex =
376                     ServiceIndex.getIndex(NwConstants.ELAN_SERVICE_NAME, NwConstants.ELAN_SERVICE_INDEX);
377             BoundServices serviceInfo = ElanUtils.getBoundServices(
378                     ElanUtils.getElanServiceName(elanName, interfaceName), elanServiceIndex,
379                     NwConstants.ELAN_SERVICE_INDEX, NwConstants.COOKIE_ELAN_INGRESS_TABLE, instructions);
380             InstanceIdentifier<BoundServices> bindServiceId = ElanUtils.buildServiceId(interfaceName, elanServiceIndex);
381             if (!tx.read(bindServiceId).get().isPresent()) {
382                 tx.put(bindServiceId, serviceInfo, WriteTransaction.CREATE_MISSING_PARENTS);
383             }
384         }), LOG, "Error binding an ELAN service to an external tunnel");
385     }
386
387     public void unbindElanServiceFromExternalTunnel(String elanName, String interfaceName) {
388         ListenableFutures.addErrorLogging(txRunner.callWithNewReadWriteTransactionAndSubmit(CONFIGURATION, tx -> {
389             LOG.trace("UnBinding external interface {} elan {}", interfaceManager, elanName);
390             short elanServiceIndex =
391                     ServiceIndex.getIndex(NwConstants.ELAN_SERVICE_NAME, NwConstants.ELAN_SERVICE_INDEX);
392             InstanceIdentifier<BoundServices> bindServiceId = ElanUtils.buildServiceId(interfaceName, elanServiceIndex);
393             if (tx.read(bindServiceId).get().isPresent()) {
394                 tx.delete(bindServiceId);
395             }
396         }), LOG, "Error binding an ELAN service to an external tunnel");
397     }
398
399     private List<InstructionInfo> getInstructionsForExtTunnelTable(Long elanTag) {
400         List<InstructionInfo> mkInstructions = new ArrayList<>();
401         mkInstructions.add(new InstructionWriteMetadata(ElanUtils.getElanMetadataLabel(elanTag, false),
402                 ElanHelper.getElanMetadataMask()));
403         mkInstructions.add(new InstructionGotoTable(NwConstants.ELAN_DMAC_TABLE));
404         return mkInstructions;
405     }
406
407     private String getFlowRef(long tableId, long elanTag, BigInteger dpnId) {
408         return new StringBuilder().append(tableId).append(elanTag).append(dpnId).toString();
409     }
410
411     private void programEvpnL2vniFlow(ElanInstance elanInfo, BiConsumer<BigInteger, FlowEntity> flowHandler) {
412         long elanTag = elanInfo.getElanTag();
413         List<MatchInfo> mkMatches = new ArrayList<>();
414         mkMatches.add(new MatchTunnelId(BigInteger.valueOf(elanUtils.getVxlanSegmentationId(elanInfo))));
415         NWUtil.getOperativeDPNs(broker).forEach(dpnId -> {
416             LOG.debug("Updating tunnel flow to dpnid {}", dpnId);
417             List<InstructionInfo> instructions = getInstructionsForExtTunnelTable(elanTag);
418             String flowRef = getFlowRef(NwConstants.L2VNI_EXTERNAL_TUNNEL_DEMUX_TABLE, elanTag, dpnId);
419             FlowEntity flowEntity = MDSALUtil.buildFlowEntity(
420                     dpnId,
421                     NwConstants.L2VNI_EXTERNAL_TUNNEL_DEMUX_TABLE,
422                     flowRef,
423                     5, // prio
424                     elanInfo.getElanInstanceName(), // flowName
425                     0, // idleTimeout
426                     0, // hardTimeout
427                     ITMConstants.COOKIE_ITM_EXTERNAL.add(BigInteger.valueOf(elanTag)),
428                     mkMatches,
429                     instructions);
430             flowHandler.accept(dpnId, flowEntity);
431         });
432     }
433
434     public void programEvpnL2vniDemuxTable(String elanName, final BiConsumer<String, String> serviceHandler,
435                                            BiConsumer<BigInteger, FlowEntity> flowHandler) {
436         ElanInstance elanInfo = elanInstanceCache.get(elanName).orNull();
437         List<String> tunnelInterfaceNameList = getDcGatewayTunnelInterfaceNameList();
438         if (tunnelInterfaceNameList.isEmpty()) {
439             LOG.info("No DC gateways tunnels while programming l2vni table for elan {}.", elanName);
440             return;
441         }
442
443         tunnelInterfaceNameList.forEach(tunnelInterfaceName -> serviceHandler.accept(elanName, tunnelInterfaceName));
444         programEvpnL2vniFlow(elanInfo, flowHandler);
445     }
446
447     @SuppressWarnings({ "unchecked", "rawtypes" })
448     public <T extends DataObject> void asyncReadAndExecute(final LogicalDatastoreType datastoreType,
449             final InstanceIdentifier<T> iid, final String jobKey, final Function<Optional<T>, Void> function) {
450         jobCoordinator.enqueueJob(jobKey, () -> {
451             SettableFuture<Optional<T>> settableFuture = SettableFuture.create();
452             List futures = Collections.singletonList(settableFuture);
453
454             try (ReadOnlyTransaction tx = broker.newReadOnlyTransaction()) {
455                 Futures.addCallback(tx.read(datastoreType, iid),
456                         new SettableFutureCallback<Optional<T>>(settableFuture) {
457                             @Override
458                             public void onSuccess(Optional<T> data) {
459                                 function.apply(data);
460                                 super.onSuccess(data);
461                             }
462                         }, MoreExecutors.directExecutor());
463
464                 return futures;
465             }
466         }, ElanConstants.JOB_MAX_RETRIES);
467     }
468 }