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     private 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 \r
  82     private BindingTransactionChain transactionChain;\r
  83     private DataBroker dataBroker;\r
  84 \r
  85     PortHandler(DataBroker dataBroker) {\r
  86         this.dataBroker = dataBroker;\r
  87         transactionChain = this.dataBroker.createTransactionChain(this);\r
  88     }\r
  89 \r
  90     void processCreated(Port port) {\r
  91         ReadOnlyTransaction rTx = transactionChain.newReadOnlyTransaction();\r
  92         Optional<BaseEndpointByPort> optBaseEpByPort = DataStoreHelper.readFromDs(LogicalDatastoreType.OPERATIONAL,\r
  93                 createBaseEpByPortIid(port.getUuid()), rTx);\r
  94         rTx.close();\r
  95         if (!optBaseEpByPort.isPresent()) {\r
  96             return;\r
  97         }\r
  98         processCreatedData(port, optBaseEpByPort.get());\r
  99     }\r
 100 \r
 101     void processCreated(BaseEndpointByPort bebp) {\r
 102         ReadOnlyTransaction rTx = transactionChain.newReadOnlyTransaction();\r
 103         Optional<Port> optPort = DataStoreHelper.readFromDs(LogicalDatastoreType.CONFIGURATION,\r
 104                 createPortIid(bebp.getPortId()), rTx);\r
 105         rTx.close();\r
 106         if (!optPort.isPresent()) {\r
 107             return;\r
 108         }\r
 109         processCreatedData(optPort.get(), bebp);\r
 110     }\r
 111 \r
 112     @VisibleForTesting\r
 113     void processCreatedData(Port port, BaseEndpointByPort bebp) {\r
 114         if (isValidVhostUser(port)) {\r
 115             VppEndpoint vppEp = buildVppEndpoint(port, bebp);\r
 116             writeVppEndpoint(createVppEndpointIid(vppEp.getKey()), vppEp);\r
 117             LOG.debug("Created vpp-endpoint {}", vppEp);\r
 118         }\r
 119     }\r
 120 \r
 121     private boolean isValidVhostUser(Port port) {\r
 122         PortBindingExtension portBindingExt = port.getAugmentation(PortBindingExtension.class);\r
 123         if (portBindingExt != null) {\r
 124             String vifType = portBindingExt.getVifType();\r
 125             String deviceOwner = port.getDeviceOwner();\r
 126             if (vifType != null && deviceOwner != null) {\r
 127                 if (vifType.contains(VHOST_USER)) {\r
 128                     for (String supportedDeviceOwner : SUPPORTED_DEVICE_OWNERS) {\r
 129                         if (deviceOwner.contains(supportedDeviceOwner)) {\r
 130                             return true;\r
 131                         }\r
 132                     }\r
 133                 }\r
 134             }\r
 135         }\r
 136         return false;\r
 137     }\r
 138 \r
 139     void processUpdated(Port original, Port delta) {\r
 140         if (!isUpdateNeeded(original, delta)){\r
 141             LOG.trace("Port update skipped, port didn`t change. before {}, after: {}" , original, delta);\r
 142             return;\r
 143         }\r
 144 \r
 145         LOG.trace("Updating port before: {}, after: {}" , original, delta);\r
 146         if (isValidVhostUser(original)) {\r
 147             ReadOnlyTransaction rTx = transactionChain.newReadOnlyTransaction();\r
 148             Optional<BaseEndpointByPort> optBebp = DataStoreHelper.readFromDs(LogicalDatastoreType.OPERATIONAL,\r
 149                     createBaseEpByPortIid(original.getUuid()), rTx);\r
 150             rTx.close();\r
 151             if (!optBebp.isPresent()) {\r
 152                 return;\r
 153             }\r
 154             LOG.trace("Updating port - deleting old port {}" , optBebp.get().getPortId());\r
 155             processDeleted(optBebp.get());\r
 156         }\r
 157         LOG.trace("Updating port - creating new port {}" , delta.getUuid());\r
 158         processCreated(delta);\r
 159     }\r
 160 \r
 161     private boolean isUpdateNeeded(final Port oldPort, final Port newPort) {\r
 162         //TODO fix this to better support update of ports for VPP\r
 163         final PortBindingExtension oldPortAugmentation = oldPort.getAugmentation(PortBindingExtension.class);\r
 164         final PortBindingExtension newPortAugmentation = newPort.getAugmentation(PortBindingExtension.class);\r
 165 \r
 166         if (newPortAugmentation == null) {\r
 167             LOG.trace("Port {} is no longer a vhost type port, updating port...");\r
 168             return true;\r
 169         }\r
 170 \r
 171         final String oldDeviceOwner = oldPort.getDeviceOwner();\r
 172         final String oldVifType = oldPortAugmentation.getVifType();\r
 173         final String newDeviceOwner = newPort.getDeviceOwner();\r
 174         final String newVifType = newPortAugmentation.getVifType();\r
 175 \r
 176         // TODO potential bug here\r
 177         // Temporary change for Openstack Mitaka: If old neutron-binding:vif-type is vhost, new one is unbound and\r
 178         // device owner is ROUTER_OWNER, skip update. Openstack (or ml2) sometimes sends router update messages in\r
 179         // incorrect order which causes unwanted port removal\r
 180         if (oldVifType.equals(VHOST_USER) && newVifType.equals(UNBOUND) && oldDeviceOwner != null &&\r
 181                 ROUTER_OWNER.equals(oldDeviceOwner) && ROUTER_OWNER.equals(newDeviceOwner)) {\r
 182             LOG.warn("Port vif-type was updated from vhost to unbound. This update is currently disabled and will be skipped");\r
 183             return false;\r
 184         }\r
 185 \r
 186         if (newVifType != null && !newVifType.equals(oldVifType)) {\r
 187             LOG.trace("Vif type changed, old: {} new {}", oldVifType, newVifType);\r
 188             return true;\r
 189         }\r
 190 \r
 191         final List<VifDetails> vifDetails = oldPortAugmentation.getVifDetails();\r
 192 \r
 193         if (!oldPortAugmentation.getHostId().equals(newPortAugmentation.getHostId()) ||\r
 194             nullToEmpty(vifDetails).size() != nullToEmpty(newPortAugmentation.getVifDetails()).size()) {\r
 195             return true;\r
 196         }\r
 197 \r
 198         for (VifDetails vifDetail : nullToEmpty(vifDetails)) {\r
 199             //check if vhostuser_socket, vhostuser_mode and port_filter are changed\r
 200             if (!newPortAugmentation.getVifDetails().contains(vifDetail))\r
 201                 return true;\r
 202         }\r
 203         return false;\r
 204     }\r
 205 \r
 206     void processDeleted(BaseEndpointByPort bebp) {\r
 207         LOG.trace("Deleting vpp-endpoint by BaseEndpointByPort {}" , bebp);\r
 208         VppEndpointKey vppEpKey = new VppEndpointKey(bebp.getAddress(), bebp.getAddressType(), bebp.getContextId(),\r
 209                 bebp.getContextType());\r
 210         InstanceIdentifier<VppEndpoint> vppEpIid = createVppEndpointIid(vppEpKey);\r
 211         ReadOnlyTransaction rTx = transactionChain.newReadOnlyTransaction();\r
 212         Optional<VppEndpoint> readVppEp = DataStoreHelper.readFromDs(LogicalDatastoreType.CONFIGURATION, vppEpIid, rTx);\r
 213         rTx.close();\r
 214         if (readVppEp.isPresent()) {\r
 215             writeVppEndpoint(vppEpIid, null);\r
 216             LOG.debug("Deleted vpp-endpoint {}", vppEpKey);\r
 217         }\r
 218     }\r
 219 \r
 220     private synchronized void writeVppEndpoint(InstanceIdentifier<VppEndpoint> vppEpIid, VppEndpoint vppEp) {\r
 221         WriteTransaction wTx = transactionChain.newWriteOnlyTransaction();\r
 222         if (vppEp != null) {\r
 223             wTx.put(LogicalDatastoreType.CONFIGURATION, vppEpIid, vppEp, true);\r
 224         } else {\r
 225             wTx.delete(LogicalDatastoreType.CONFIGURATION, vppEpIid);\r
 226         }\r
 227         wTx.submit();\r
 228     }\r
 229 \r
 230     @VisibleForTesting\r
 231     VppEndpoint buildVppEndpoint(Port port, BaseEndpointByPort bebp) {\r
 232         PortBindingExtension portBinding = port.getAugmentation(PortBindingExtension.class);\r
 233         VppEndpointBuilder vppEpBuilder = new VppEndpointBuilder().setDescription("neutron port")\r
 234             .setContextId(bebp.getContextId())\r
 235             .setContextType(bebp.getContextType())\r
 236             .setAddress(bebp.getAddress())\r
 237             .setAddressType(bebp.getAddressType())\r
 238             .setVppInterfaceName(VPP_INTERFACE_NAME_PREFIX + bebp.getPortId().getValue())\r
 239             .setVppNodeId(new NodeId(portBinding.getHostId()));\r
 240 \r
 241         if (port.getDeviceOwner().contains(COMPUTE_OWNER)) {\r
 242             vppEpBuilder.setInterfaceTypeChoice(\r
 243                 new VhostUserCaseBuilder().setSocket(getSocketFromPortBinding(portBinding)).build());\r
 244         } else if (port.getDeviceOwner().contains(DHCP_OWNER) && port.getMacAddress() != null) {\r
 245             TapCase tapCase = new TapCaseBuilder().setPhysicalAddress(new PhysAddress(port.getMacAddress().getValue()))\r
 246                 .setName(createPortName(port.getUuid()))\r
 247                 .build();\r
 248             vppEpBuilder.setInterfaceTypeChoice(tapCase);\r
 249         } else if (isValidQRouterPort(port)) {\r
 250             TapCase tapCase = new TapCaseBuilder().setPhysicalAddress(new PhysAddress(port.getMacAddress().getValue()))\r
 251                     .setName(createQRouterPortName(port.getUuid()))\r
 252                     .build();\r
 253             vppEpBuilder.setInterfaceTypeChoice(tapCase);\r
 254         } else if (isValidVppRouterPort(port)) {\r
 255             vppEpBuilder.setInterfaceTypeChoice(getLoopbackCase(port));\r
 256         }\r
 257         return vppEpBuilder.build();\r
 258     }\r
 259 \r
 260     private String getSocketFromPortBinding(@Nonnull PortBindingExtension portBindingExtension) {\r
 261         List<VifDetails> vifDetails = nullToEmpty(portBindingExtension.getVifDetails());\r
 262 \r
 263         for (VifDetails detail : vifDetails) {\r
 264             if (VHOST_SOCKET_KEY.equalsIgnoreCase(detail.getDetailsKey())) {\r
 265                 return detail.getValue();\r
 266             }\r
 267         }\r
 268         return null;\r
 269     }\r
 270 \r
 271     private LoopbackCase getLoopbackCase(Port port) {\r
 272         LoopbackCaseBuilder loopbackCase = new LoopbackCaseBuilder()\r
 273             .setPhysAddress(new PhysAddress(port.getMacAddress().getValue()));\r
 274         Optional<FixedIps> fixedIpsOptional = resolveFirstFixedIps(port);\r
 275         if(fixedIpsOptional.isPresent() && fixedIpsOptional.get().getIpAddress() != null){\r
 276             loopbackCase.setIpAddress(fixedIpsOptional.get().getIpAddress());\r
 277             ReadOnlyTransaction rTx = transactionChain.newReadOnlyTransaction();\r
 278             Optional<Subnet> subnetOptional =\r
 279                 DataStoreHelper.readFromDs(LogicalDatastoreType.CONFIGURATION,\r
 280                     InstanceIdentifier.builder(Neutron.class)\r
 281                         .child(Subnets.class)\r
 282                         .child(Subnet.class, new SubnetKey(fixedIpsOptional.get().getSubnetId()))\r
 283                         .build(), rTx);\r
 284             if (subnetOptional.isPresent()) {\r
 285                 Ipv4Prefix ipv4Prefix = subnetOptional.get().getCidr().getIpv4Prefix();\r
 286                 loopbackCase.setIpPrefix(new IpPrefix(ipv4Prefix));\r
 287             } else {\r
 288                 LOG.warn("IpPrefix for loopback port: {} was not set.", port);\r
 289             }\r
 290             if (loopbackCase.getIpAddress() != null && loopbackCase.getIpPrefix() != null) {\r
 291                 loopbackCase.setBvi(true);\r
 292                 LOG.trace("Creating loopback BVI interface: {} for VPP router port: {}.", loopbackCase, port);\r
 293             }\r
 294 \r
 295         } else {\r
 296             LOG.warn("IpAddress for loopback port: {} was not set.", port);\r
 297         }\r
 298         return loopbackCase.build();\r
 299     }\r
 300 \r
 301     /**\r
 302      * If Qrouter (L3 Agent) is in use, any of Openstack neutron routers is not going be mapped\r
 303      * to ODL neutron.\r
 304      */\r
 305     private boolean isValidQRouterPort(Port port) {\r
 306         Optional<Router> optRouter = getRouterOptional(port);\r
 307         return !optRouter.isPresent() && port.getDeviceOwner().contains(ROUTER_OWNER)\r
 308                 && port.getMacAddress() != null;\r
 309     }\r
 310 \r
 311     private boolean isValidVppRouterPort(Port port) {\r
 312         Optional<Router> optRouter = getRouterOptional(port);\r
 313         return optRouter.isPresent() && port.getDeviceOwner().contains(ROUTER_OWNER)\r
 314             && port.getMacAddress() != null;\r
 315     }\r
 316 \r
 317     private Optional<Router> getRouterOptional(Port port) {\r
 318         ReadOnlyTransaction rTx = transactionChain.newReadOnlyTransaction();\r
 319         InstanceIdentifier<Router> routerIid = InstanceIdentifier.builder(Neutron.class)\r
 320             .child(Routers.class)\r
 321             .child(Router.class, new RouterKey(new Uuid(port.getDeviceId())))\r
 322             .build();\r
 323         Optional<Router> optRouter = DataStoreHelper.readFromDs(LogicalDatastoreType.CONFIGURATION, routerIid, rTx);\r
 324         rTx.close();\r
 325         return optRouter;\r
 326     }\r
 327 \r
 328     public static Optional<FixedIps> resolveFirstFixedIps(Port port) {\r
 329         List<FixedIps> fixedIps = port.getFixedIps();\r
 330         if (fixedIps != null && !fixedIps.isEmpty()) {\r
 331             return Optional.of(fixedIps.get(0));\r
 332         }\r
 333         return Optional.absent();\r
 334     }\r
 335 \r
 336     private String createPortName(Uuid portUuid) {\r
 337         String tapPortName;\r
 338         String uuid = portUuid.getValue();\r
 339         if (uuid != null && uuid.length() >= 12) {\r
 340             tapPortName = TAP_PORT_NAME_PREFIX + uuid.substring(0, 11);\r
 341         } else {\r
 342             tapPortName = TAP_PORT_NAME_PREFIX + uuid;\r
 343         }\r
 344         return tapPortName;\r
 345     }\r
 346 \r
 347     private String createQRouterPortName(Uuid portUuid) {\r
 348         String tapPortName;\r
 349         String uuid = portUuid.getValue();\r
 350         if (uuid != null && uuid.length() >= 12) {\r
 351             tapPortName = RT_PORT_NAME_PREFIX + uuid.substring(0, 11);\r
 352         } else {\r
 353             tapPortName = RT_PORT_NAME_PREFIX + uuid;\r
 354         }\r
 355         return tapPortName;\r
 356     }\r
 357 \r
 358     private InstanceIdentifier<VppEndpoint> createVppEndpointIid(VppEndpointKey vppEpKey) {\r
 359         return InstanceIdentifier.builder(Config.class).child(VppEndpoint.class, vppEpKey).build();\r
 360     }\r
 361 \r
 362     private InstanceIdentifier<BaseEndpointByPort> createBaseEpByPortIid(Uuid uuid) {\r
 363         return createBaseEpByPortIid(new UniqueId(uuid.getValue()));\r
 364     }\r
 365 \r
 366     private InstanceIdentifier<BaseEndpointByPort> createBaseEpByPortIid(UniqueId uuid) {\r
 367         return InstanceIdentifier.builder(Mappings.class)\r
 368             .child(GbpByNeutronMappings.class)\r
 369             .child(BaseEndpointsByPorts.class)\r
 370             .child(BaseEndpointByPort.class, new BaseEndpointByPortKey(uuid))\r
 371             .build();\r
 372     }\r
 373 \r
 374     InstanceIdentifier<Port> createWildcartedPortIid() {\r
 375         return portsIid().child(Port.class).build();\r
 376     }\r
 377 \r
 378     private InstanceIdentifier<Port> createPortIid(UniqueId uuid) {\r
 379         return portsIid().child(Port.class, new PortKey(new Uuid(uuid.getValue()))).build();\r
 380     }\r
 381 \r
 382     private InstanceIdentifierBuilder<Ports> portsIid() {\r
 383         return InstanceIdentifier.builder(Neutron.class).child(Ports.class);\r
 384     }\r
 385 \r
 386     @Override\r
 387     public void onTransactionChainFailed(TransactionChain<?, ?> chain, AsyncTransaction<?, ?> transaction,\r
 388             Throwable cause) {\r
 389         LOG.error("Transaction chain failed. {} \nTransaction which caused the chain to fail {}", cause.getMessage(),\r
 390                 transaction, cause);\r
 391         transactionChain.close();\r
 392         transactionChain = dataBroker.createTransactionChain(this);\r
 393     }\r
 394 \r
 395     @Override\r
 396     public void onTransactionChainSuccessful(TransactionChain<?, ?> chain) {\r
 397         LOG.trace("Transaction chain was successful. {}", chain);\r
 398     }\r
 399 \r
 400     private <T> List<T> nullToEmpty(@Nullable List<T> list) {\r
 401         return list == null ? Collections.emptyList() : list;\r
 402     }\r
 403 }\r