neutron-vpp-mapper/src/main/java/org/opendaylight/groupbasedpolicy/neutron/vpp/mapper/processors/PortHandler.java

   1 /*\r
   2  * Copyright (c) 2016 Cisco Systems, Inc. and others. All rights reserved.\r
   3  *\r
   4  * This program and the accompanying materials are made available under the\r
   5  * terms of the Eclipse Public License v1.0 which accompanies this distribution,\r
   6  * and is available at http://www.eclipse.org/legal/epl-v10.html\r
   7  */\r
   8 \r
   9 package org.opendaylight.groupbasedpolicy.neutron.vpp.mapper.processors;\r
  10 \r
  11 import java.util.Collections;\r
  12 import java.util.List;\r
  13 \r
  14 import javax.annotation.Nullable;\r
  15 \r
  16 import org.opendaylight.controller.md.sal.binding.api.BindingTransactionChain;\r
  17 import org.opendaylight.controller.md.sal.binding.api.DataBroker;\r
  18 import org.opendaylight.controller.md.sal.binding.api.ReadOnlyTransaction;\r
  19 import org.opendaylight.controller.md.sal.binding.api.WriteTransaction;\r
  20 import org.opendaylight.controller.md.sal.common.api.data.AsyncTransaction;\r
  21 import org.opendaylight.controller.md.sal.common.api.data.LogicalDatastoreType;\r
  22 import org.opendaylight.controller.md.sal.common.api.data.TransactionChain;\r
  23 import org.opendaylight.controller.md.sal.common.api.data.TransactionChainListener;\r
  24 import org.opendaylight.groupbasedpolicy.util.DataStoreHelper;\r
  25 import org.opendaylight.yang.gen.v1.urn.ietf.params.xml.ns.yang.ietf.inet.types.rev130715.IpPrefix;\r
  26 import org.opendaylight.yang.gen.v1.urn.ietf.params.xml.ns.yang.ietf.inet.types.rev130715.Ipv4Prefix;\r
  27 import org.opendaylight.yang.gen.v1.urn.ietf.params.xml.ns.yang.ietf.yang.types.rev130715.PhysAddress;\r
  28 import org.opendaylight.yang.gen.v1.urn.ietf.params.xml.ns.yang.ietf.yang.types.rev130715.Uuid;\r
  29 import org.opendaylight.yang.gen.v1.urn.opendaylight.groupbasedpolicy.common.rev140421.UniqueId;\r
  30 import org.opendaylight.yang.gen.v1.urn.opendaylight.groupbasedpolicy.neutron.gbp.mapper.rev150513.Mappings;\r
  31 import org.opendaylight.yang.gen.v1.urn.opendaylight.groupbasedpolicy.neutron.gbp.mapper.rev150513.mappings.GbpByNeutronMappings;\r
  32 import org.opendaylight.yang.gen.v1.urn.opendaylight.groupbasedpolicy.neutron.gbp.mapper.rev150513.mappings.gbp.by.neutron.mappings.BaseEndpointsByPorts;\r
  33 import org.opendaylight.yang.gen.v1.urn.opendaylight.groupbasedpolicy.neutron.gbp.mapper.rev150513.mappings.gbp.by.neutron.mappings.base.endpoints.by.ports.BaseEndpointByPort;\r
  34 import org.opendaylight.yang.gen.v1.urn.opendaylight.groupbasedpolicy.neutron.gbp.mapper.rev150513.mappings.gbp.by.neutron.mappings.base.endpoints.by.ports.BaseEndpointByPortKey;\r
  35 import org.opendaylight.yang.gen.v1.urn.opendaylight.groupbasedpolicy.vpp_renderer.rev160425.Config;\r
  36 import org.opendaylight.yang.gen.v1.urn.opendaylight.groupbasedpolicy.vpp_renderer.rev160425._interface.attributes._interface.type.choice.LoopbackCase;\r
  37 import org.opendaylight.yang.gen.v1.urn.opendaylight.groupbasedpolicy.vpp_renderer.rev160425._interface.attributes._interface.type.choice.LoopbackCaseBuilder;\r
  38 import org.opendaylight.yang.gen.v1.urn.opendaylight.groupbasedpolicy.vpp_renderer.rev160425._interface.attributes._interface.type.choice.TapCase;\r
  39 import org.opendaylight.yang.gen.v1.urn.opendaylight.groupbasedpolicy.vpp_renderer.rev160425._interface.attributes._interface.type.choice.TapCaseBuilder;\r
  40 import org.opendaylight.yang.gen.v1.urn.opendaylight.groupbasedpolicy.vpp_renderer.rev160425._interface.attributes._interface.type.choice.VhostUserCaseBuilder;\r
  41 import org.opendaylight.yang.gen.v1.urn.opendaylight.groupbasedpolicy.vpp_renderer.rev160425.config.VppEndpoint;\r
  42 import org.opendaylight.yang.gen.v1.urn.opendaylight.groupbasedpolicy.vpp_renderer.rev160425.config.VppEndpointBuilder;\r
  43 import org.opendaylight.yang.gen.v1.urn.opendaylight.groupbasedpolicy.vpp_renderer.rev160425.config.VppEndpointKey;\r
  44 import org.opendaylight.yang.gen.v1.urn.opendaylight.neutron.binding.rev150712.PortBindingExtension;\r
  45 import org.opendaylight.yang.gen.v1.urn.opendaylight.neutron.binding.rev150712.binding.attributes.VifDetails;\r
  46 import org.opendaylight.yang.gen.v1.urn.opendaylight.neutron.l3.rev150712.routers.attributes.Routers;\r
  47 import org.opendaylight.yang.gen.v1.urn.opendaylight.neutron.l3.rev150712.routers.attributes.routers.Router;\r
  48 import org.opendaylight.yang.gen.v1.urn.opendaylight.neutron.l3.rev150712.routers.attributes.routers.RouterKey;\r
  49 import org.opendaylight.yang.gen.v1.urn.opendaylight.neutron.ports.rev150712.port.attributes.FixedIps;\r
  50 import org.opendaylight.yang.gen.v1.urn.opendaylight.neutron.ports.rev150712.ports.attributes.Ports;\r
  51 import org.opendaylight.yang.gen.v1.urn.opendaylight.neutron.ports.rev150712.ports.attributes.ports.Port;\r
  52 import org.opendaylight.yang.gen.v1.urn.opendaylight.neutron.ports.rev150712.ports.attributes.ports.PortKey;\r
  53 import org.opendaylight.yang.gen.v1.urn.opendaylight.neutron.rev150712.Neutron;\r
  54 import org.opendaylight.yang.gen.v1.urn.opendaylight.neutron.subnets.rev150712.subnets.attributes.Subnets;\r
  55 import org.opendaylight.yang.gen.v1.urn.opendaylight.neutron.subnets.rev150712.subnets.attributes.subnets.Subnet;\r
  56 import org.opendaylight.yang.gen.v1.urn.opendaylight.neutron.subnets.rev150712.subnets.attributes.subnets.SubnetKey;\r
  57 import org.opendaylight.yang.gen.v1.urn.tbd.params.xml.ns.yang.network.topology.rev131021.NodeId;\r
  58 import org.opendaylight.yangtools.yang.binding.InstanceIdentifier;\r
  59 import org.opendaylight.yangtools.yang.binding.InstanceIdentifier.InstanceIdentifierBuilder;\r
  60 import org.slf4j.Logger;\r
  61 import org.slf4j.LoggerFactory;\r
  62 \r
  63 import com.google.common.annotations.VisibleForTesting;\r
  64 import com.google.common.base.Optional;\r
  65 \r
  66 import javax.annotation.Nonnull;\r
  67 public class PortHandler implements TransactionChainListener {\r
  68 \r
  69     private static final Logger LOG = LoggerFactory.getLogger(PortHandler.class);\r
  70 \r
  71     private static final String COMPUTE_OWNER = "compute";\r
  72     private static final String DHCP_OWNER = "dhcp";\r
  73     static final String ROUTER_OWNER = "network:router_interface";\r
  74     private static final String[] SUPPORTED_DEVICE_OWNERS = {COMPUTE_OWNER, DHCP_OWNER, ROUTER_OWNER};\r
  75     private static final String VHOST_USER = "vhostuser";\r
  76     private static final String UNBOUND = "unbound";\r
  77     private static final String VPP_INTERFACE_NAME_PREFIX = "neutron_port_";\r
  78     private static final String TAP_PORT_NAME_PREFIX = "tap";\r
  79     private static final String RT_PORT_NAME_PREFIX = "qr-";\r
  80     private static final String VHOST_SOCKET_KEY = "vhostuser_socket";\r
  81     static final String DEFAULT_NODE = "default";\r
  82 \r
  83     private final NodeId routingNode;\r
  84     private BindingTransactionChain transactionChain;\r
  85     private DataBroker dataBroker;\r
  86 \r
  87     PortHandler(DataBroker dataBroker, NodeId routingNodeId) {\r
  88         this.dataBroker = dataBroker;\r
  89         this.routingNode = routingNodeId;\r
  90         transactionChain = this.dataBroker.createTransactionChain(this);\r
  91     }\r
  92 \r
  93     void processCreated(Port port) {\r
  94         ReadOnlyTransaction rTx = transactionChain.newReadOnlyTransaction();\r
  95         Optional<BaseEndpointByPort> optBaseEpByPort = DataStoreHelper.readFromDs(LogicalDatastoreType.OPERATIONAL,\r
  96                 createBaseEpByPortIid(port.getUuid()), rTx);\r
  97         rTx.close();\r
  98         if (!optBaseEpByPort.isPresent()) {\r
  99             return;\r
 100         }\r
 101         processCreatedData(port, optBaseEpByPort.get());\r
 102     }\r
 103 \r
 104     void processCreated(BaseEndpointByPort bebp) {\r
 105         ReadOnlyTransaction rTx = transactionChain.newReadOnlyTransaction();\r
 106         Optional<Port> optPort = DataStoreHelper.readFromDs(LogicalDatastoreType.CONFIGURATION,\r
 107                 createPortIid(bebp.getPortId()), rTx);\r
 108         rTx.close();\r
 109         if (!optPort.isPresent()) {\r
 110             return;\r
 111         }\r
 112         processCreatedData(optPort.get(), bebp);\r
 113     }\r
 114 \r
 115     @VisibleForTesting\r
 116     void processCreatedData(Port port, BaseEndpointByPort bebp) {\r
 117         if (isValidVhostUser(port)) {\r
 118             VppEndpoint vppEp = buildVppEndpoint(port, bebp);\r
 119             writeVppEndpoint(createVppEndpointIid(vppEp.getKey()), vppEp);\r
 120             LOG.debug("Created vpp-endpoint {}", vppEp);\r
 121         }\r
 122     }\r
 123 \r
 124     private boolean isValidVhostUser(Port port) {\r
 125         PortBindingExtension portBindingExt = port.getAugmentation(PortBindingExtension.class);\r
 126         if (portBindingExt != null) {\r
 127             String vifType = portBindingExt.getVifType();\r
 128             String deviceOwner = port.getDeviceOwner();\r
 129             if (vifType != null && deviceOwner != null) {\r
 130                 if (vifType.contains(VHOST_USER)) {\r
 131                     for (String supportedDeviceOwner : SUPPORTED_DEVICE_OWNERS) {\r
 132                         if (deviceOwner.contains(supportedDeviceOwner)) {\r
 133                             return true;\r
 134                         }\r
 135                     }\r
 136                 }\r
 137             }\r
 138         }\r
 139         return false;\r
 140     }\r
 141 \r
 142     void processUpdated(Port original, Port delta) {\r
 143         if (!isUpdateNeeded(original, delta)){\r
 144             LOG.trace("Port update skipped, port didn`t change. before {}, after: {}" , original, delta);\r
 145             return;\r
 146         }\r
 147 \r
 148         LOG.trace("Updating port before: {}, after: {}" , original, delta);\r
 149         if (isValidVhostUser(original)) {\r
 150             ReadOnlyTransaction rTx = transactionChain.newReadOnlyTransaction();\r
 151             Optional<BaseEndpointByPort> optBebp = DataStoreHelper.readFromDs(LogicalDatastoreType.OPERATIONAL,\r
 152                     createBaseEpByPortIid(original.getUuid()), rTx);\r
 153             rTx.close();\r
 154             if (!optBebp.isPresent()) {\r
 155                 return;\r
 156             }\r
 157             LOG.trace("Updating port - deleting old port {}" , optBebp.get().getPortId());\r
 158             processDeleted(optBebp.get());\r
 159         }\r
 160         LOG.trace("Updating port - creating new port {}" , delta.getUuid());\r
 161         processCreated(delta);\r
 162     }\r
 163 \r
 164     private boolean isUpdateNeeded(final Port oldPort, final Port newPort) {\r
 165         //TODO fix this to better support update of ports for VPP\r
 166         final PortBindingExtension oldPortAugmentation = oldPort.getAugmentation(PortBindingExtension.class);\r
 167         final PortBindingExtension newPortAugmentation = newPort.getAugmentation(PortBindingExtension.class);\r
 168 \r
 169         if (newPortAugmentation == null) {\r
 170             LOG.trace("Port {} is no longer a vhost type port, updating port...");\r
 171             return true;\r
 172         }\r
 173 \r
 174         final String oldDeviceOwner = oldPort.getDeviceOwner();\r
 175         final String oldVifType = oldPortAugmentation.getVifType();\r
 176         final String newDeviceOwner = newPort.getDeviceOwner();\r
 177         final String newVifType = newPortAugmentation.getVifType();\r
 178 \r
 179         // TODO potential bug here\r
 180         // Temporary change for Openstack Mitaka: If old neutron-binding:vif-type is vhost, new one is unbound and\r
 181         // device owner is ROUTER_OWNER, skip update. Openstack (or ml2) sometimes sends router update messages in\r
 182         // incorrect order which causes unwanted port removal\r
 183         if (oldVifType.equals(VHOST_USER) && newVifType.equals(UNBOUND) && oldDeviceOwner != null &&\r
 184                 ROUTER_OWNER.equals(oldDeviceOwner) && ROUTER_OWNER.equals(newDeviceOwner)) {\r
 185             LOG.warn("Port vif-type was updated from vhost to unbound. This update is currently disabled and will be skipped");\r
 186             return false;\r
 187         }\r
 188 \r
 189         if (newVifType != null && !newVifType.equals(oldVifType)) {\r
 190             LOG.trace("Vif type changed, old: {} new {}", oldVifType, newVifType);\r
 191             return true;\r
 192         }\r
 193 \r
 194         final List<VifDetails> vifDetails = oldPortAugmentation.getVifDetails();\r
 195 \r
 196         if (!oldPortAugmentation.getHostId().equals(newPortAugmentation.getHostId()) ||\r
 197             nullToEmpty(vifDetails).size() != nullToEmpty(newPortAugmentation.getVifDetails()).size()) {\r
 198             return true;\r
 199         }\r
 200 \r
 201         for (VifDetails vifDetail : nullToEmpty(vifDetails)) {\r
 202             //check if vhostuser_socket, vhostuser_mode and port_filter are changed\r
 203             if (!newPortAugmentation.getVifDetails().contains(vifDetail))\r
 204                 return true;\r
 205         }\r
 206         return false;\r
 207     }\r
 208 \r
 209     void processDeleted(BaseEndpointByPort bebp) {\r
 210         LOG.trace("Deleting vpp-endpoint by BaseEndpointByPort {}" , bebp);\r
 211         VppEndpointKey vppEpKey = new VppEndpointKey(bebp.getAddress(), bebp.getAddressType(), bebp.getContextId(),\r
 212                 bebp.getContextType());\r
 213         InstanceIdentifier<VppEndpoint> vppEpIid = createVppEndpointIid(vppEpKey);\r
 214         ReadOnlyTransaction rTx = transactionChain.newReadOnlyTransaction();\r
 215         Optional<VppEndpoint> readVppEp = DataStoreHelper.readFromDs(LogicalDatastoreType.CONFIGURATION, vppEpIid, rTx);\r
 216         rTx.close();\r
 217         if (readVppEp.isPresent()) {\r
 218             writeVppEndpoint(vppEpIid, null);\r
 219             LOG.debug("Deleted vpp-endpoint {}", vppEpKey);\r
 220         }\r
 221     }\r
 222 \r
 223     private synchronized void writeVppEndpoint(InstanceIdentifier<VppEndpoint> vppEpIid, VppEndpoint vppEp) {\r
 224         WriteTransaction wTx = transactionChain.newWriteOnlyTransaction();\r
 225         if (vppEp != null) {\r
 226             wTx.put(LogicalDatastoreType.CONFIGURATION, vppEpIid, vppEp, true);\r
 227         } else {\r
 228             wTx.delete(LogicalDatastoreType.CONFIGURATION, vppEpIid);\r
 229         }\r
 230         wTx.submit();\r
 231     }\r
 232 \r
 233     @VisibleForTesting\r
 234     VppEndpoint buildVppEndpoint(Port port, BaseEndpointByPort bebp) {\r
 235         PortBindingExtension portBinding = port.getAugmentation(PortBindingExtension.class);\r
 236         VppEndpointBuilder vppEpBuilder = new VppEndpointBuilder().setDescription("neutron port")\r
 237             .setContextId(bebp.getContextId())\r
 238             .setContextType(bebp.getContextType())\r
 239             .setAddress(bebp.getAddress())\r
 240             .setAddressType(bebp.getAddressType())\r
 241             .setVppInterfaceName(VPP_INTERFACE_NAME_PREFIX + bebp.getPortId().getValue())\r
 242             .setVppNodeId(new NodeId(portBinding.getHostId()));\r
 243         if (port.getDeviceOwner().contains(COMPUTE_OWNER)) {\r
 244             vppEpBuilder.setInterfaceTypeChoice(\r
 245                 new VhostUserCaseBuilder().setSocket(getSocketFromPortBinding(portBinding)).build());\r
 246         } else if (port.getDeviceOwner().contains(DHCP_OWNER) && port.getMacAddress() != null) {\r
 247             TapCase tapCase = new TapCaseBuilder().setPhysicalAddress(new PhysAddress(port.getMacAddress().getValue()))\r
 248                 .setName(createPortName(port.getUuid()))\r
 249                 .build();\r
 250             vppEpBuilder.setInterfaceTypeChoice(tapCase);\r
 251         } else if (isValidQRouterPort(port)) {\r
 252             TapCase tapCase = new TapCaseBuilder().setPhysicalAddress(new PhysAddress(port.getMacAddress().getValue()))\r
 253                     .setName(createQRouterPortName(port.getUuid()))\r
 254                     .build();\r
 255             vppEpBuilder.setInterfaceTypeChoice(tapCase);\r
 256         } else if (isValidVppRouterPort(port)) {\r
 257             if (!DEFAULT_NODE.equals(routingNode.getValue())) {\r
 258                 LOG.warn(\r
 259                         "Host-id changed by ODL for port {}. This is a supplementary workaround for choosing a routing node.",\r
 260                         port);\r
 261                 vppEpBuilder.setVppNodeId(routingNode);\r
 262             }\r
 263             vppEpBuilder.setInterfaceTypeChoice(getLoopbackCase(port));\r
 264         }\r
 265         return vppEpBuilder.build();\r
 266     }\r
 267 \r
 268     private String getSocketFromPortBinding(@Nonnull PortBindingExtension portBindingExtension) {\r
 269         List<VifDetails> vifDetails = nullToEmpty(portBindingExtension.getVifDetails());\r
 270 \r
 271         for (VifDetails detail : vifDetails) {\r
 272             if (VHOST_SOCKET_KEY.equalsIgnoreCase(detail.getDetailsKey())) {\r
 273                 return detail.getValue();\r
 274             }\r
 275         }\r
 276         return null;\r
 277     }\r
 278 \r
 279     private LoopbackCase getLoopbackCase(Port port) {\r
 280         LoopbackCaseBuilder loopbackCase = new LoopbackCaseBuilder()\r
 281             .setPhysAddress(new PhysAddress(port.getMacAddress().getValue()));\r
 282         Optional<FixedIps> fixedIpsOptional = resolveFirstFixedIps(port);\r
 283         if(fixedIpsOptional.isPresent() && fixedIpsOptional.get().getIpAddress() != null){\r
 284             loopbackCase.setIpAddress(fixedIpsOptional.get().getIpAddress());\r
 285             ReadOnlyTransaction rTx = transactionChain.newReadOnlyTransaction();\r
 286             Optional<Subnet> subnetOptional =\r
 287                 DataStoreHelper.readFromDs(LogicalDatastoreType.CONFIGURATION,\r
 288                     InstanceIdentifier.builder(Neutron.class)\r
 289                         .child(Subnets.class)\r
 290                         .child(Subnet.class, new SubnetKey(fixedIpsOptional.get().getSubnetId()))\r
 291                         .build(), rTx);\r
 292             if (subnetOptional.isPresent()) {\r
 293                 Ipv4Prefix ipv4Prefix = subnetOptional.get().getCidr().getIpv4Prefix();\r
 294                 loopbackCase.setIpPrefix(new IpPrefix(ipv4Prefix));\r
 295             } else {\r
 296                 LOG.warn("IpPrefix for loopback port: {} was not set.", port);\r
 297             }\r
 298             if (loopbackCase.getIpAddress() != null && loopbackCase.getIpPrefix() != null) {\r
 299                 loopbackCase.setBvi(true);\r
 300                 LOG.trace("Creating loopback BVI interface: {} for VPP router port: {}.", loopbackCase, port);\r
 301             }\r
 302 \r
 303         } else {\r
 304             LOG.warn("IpAddress for loopback port: {} was not set.", port);\r
 305         }\r
 306         return loopbackCase.build();\r
 307     }\r
 308 \r
 309     /**\r
 310      * If Qrouter (L3 Agent) is in use, any of Openstack neutron routers is not going be mapped\r
 311      * to ODL neutron.\r
 312      */\r
 313     private boolean isValidQRouterPort(Port port) {\r
 314         Optional<Router> optRouter = getRouterOptional(port);\r
 315         return !optRouter.isPresent() && port.getDeviceOwner().contains(ROUTER_OWNER)\r
 316                 && port.getMacAddress() != null;\r
 317     }\r
 318 \r
 319     private boolean isValidVppRouterPort(Port port) {\r
 320         Optional<Router> optRouter = getRouterOptional(port);\r
 321         return optRouter.isPresent() && port.getDeviceOwner().contains(ROUTER_OWNER)\r
 322             && port.getMacAddress() != null;\r
 323     }\r
 324 \r
 325     private Optional<Router> getRouterOptional(Port port) {\r
 326         ReadOnlyTransaction rTx = transactionChain.newReadOnlyTransaction();\r
 327         InstanceIdentifier<Router> routerIid = InstanceIdentifier.builder(Neutron.class)\r
 328             .child(Routers.class)\r
 329             .child(Router.class, new RouterKey(new Uuid(port.getDeviceId())))\r
 330             .build();\r
 331         Optional<Router> optRouter = DataStoreHelper.readFromDs(LogicalDatastoreType.CONFIGURATION, routerIid, rTx);\r
 332         rTx.close();\r
 333         return optRouter;\r
 334     }\r
 335 \r
 336     public static Optional<FixedIps> resolveFirstFixedIps(Port port) {\r
 337         List<FixedIps> fixedIps = port.getFixedIps();\r
 338         if (fixedIps != null && !fixedIps.isEmpty()) {\r
 339             return Optional.of(fixedIps.get(0));\r
 340         }\r
 341         return Optional.absent();\r
 342     }\r
 343 \r
 344     private String createPortName(Uuid portUuid) {\r
 345         String tapPortName;\r
 346         String uuid = portUuid.getValue();\r
 347         if (uuid != null && uuid.length() >= 12) {\r
 348             tapPortName = TAP_PORT_NAME_PREFIX + uuid.substring(0, 11);\r
 349         } else {\r
 350             tapPortName = TAP_PORT_NAME_PREFIX + uuid;\r
 351         }\r
 352         return tapPortName;\r
 353     }\r
 354 \r
 355     private String createQRouterPortName(Uuid portUuid) {\r
 356         String tapPortName;\r
 357         String uuid = portUuid.getValue();\r
 358         if (uuid != null && uuid.length() >= 12) {\r
 359             tapPortName = RT_PORT_NAME_PREFIX + uuid.substring(0, 11);\r
 360         } else {\r
 361             tapPortName = RT_PORT_NAME_PREFIX + uuid;\r
 362         }\r
 363         return tapPortName;\r
 364     }\r
 365 \r
 366     private InstanceIdentifier<VppEndpoint> createVppEndpointIid(VppEndpointKey vppEpKey) {\r
 367         return InstanceIdentifier.builder(Config.class).child(VppEndpoint.class, vppEpKey).build();\r
 368     }\r
 369 \r
 370     private InstanceIdentifier<BaseEndpointByPort> createBaseEpByPortIid(Uuid uuid) {\r
 371         return createBaseEpByPortIid(new UniqueId(uuid.getValue()));\r
 372     }\r
 373 \r
 374     private InstanceIdentifier<BaseEndpointByPort> createBaseEpByPortIid(UniqueId uuid) {\r
 375         return InstanceIdentifier.builder(Mappings.class)\r
 376             .child(GbpByNeutronMappings.class)\r
 377             .child(BaseEndpointsByPorts.class)\r
 378             .child(BaseEndpointByPort.class, new BaseEndpointByPortKey(uuid))\r
 379             .build();\r
 380     }\r
 381 \r
 382     InstanceIdentifier<Port> createWildcartedPortIid() {\r
 383         return portsIid().child(Port.class).build();\r
 384     }\r
 385 \r
 386     private InstanceIdentifier<Port> createPortIid(UniqueId uuid) {\r
 387         return portsIid().child(Port.class, new PortKey(new Uuid(uuid.getValue()))).build();\r
 388     }\r
 389 \r
 390     private InstanceIdentifierBuilder<Ports> portsIid() {\r
 391         return InstanceIdentifier.builder(Neutron.class).child(Ports.class);\r
 392     }\r
 393 \r
 394     @Override\r
 395     public void onTransactionChainFailed(TransactionChain<?, ?> chain, AsyncTransaction<?, ?> transaction,\r
 396             Throwable cause) {\r
 397         LOG.error("Transaction chain failed. {} \nTransaction which caused the chain to fail {}", cause.getMessage(),\r
 398                 transaction, cause);\r
 399         transactionChain.close();\r
 400         transactionChain = dataBroker.createTransactionChain(this);\r
 401     }\r
 402 \r
 403     @Override\r
 404     public void onTransactionChainSuccessful(TransactionChain<?, ?> chain) {\r
 405         LOG.trace("Transaction chain was successful. {}", chain);\r
 406     }\r
 407 \r
 408     private <T> List<T> nullToEmpty(@Nullable List<T> list) {\r
 409         return list == null ? Collections.emptyList() : list;\r
 410     }\r
 411 }\r