openstack/net-virt/src/main/java/org/opendaylight/ovsdb/openstack/netvirt/api/BridgeConfigurationManager.java

   1 /*
   2  * Copyright (C) 2014 Red Hat, Inc.
   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  *  Authors : Dave Tucker
   9  */
  10
  11 package org.opendaylight.ovsdb.openstack.netvirt.api;
  12
  13 import org.opendaylight.neutron.spi.NeutronNetwork;
  14 import org.opendaylight.yang.gen.v1.urn.tbd.params.xml.ns.yang.network.topology.rev131021.network.topology.topology.Node;
  15
  16 import java.util.List;
  17
  18 /**
  19  * OpenStack Neutron with the Open vSwitch plugin relies on a typical bridge configuration that
  20  * consists of br-int (Integration Bridge), br-net (Network bridge), br-ex (External bridge).
  21  *
  22  * This class ensures that the bridges on each {@link Node}
  23  * are correctly configured for OpenStack Neutron
  24  *
  25  */
  26 public interface BridgeConfigurationManager {
  27
  28     /**
  29      * A helper function to get the UUID of a given Bridge
  30      * @param node the {@link Node} where the bridge is configured
  31      * @param bridgeName the name of the bridge
  32      * @return the UUID of the bridge
  33      */
  34     public String getBridgeUuid(Node node, String bridgeName);
  35
  36     /**
  37      * Checks for the existence of the Integration Bridge on a given Node
  38      * @param node the {@link Node} where the bridge should be configured
  39      * @return True if the bridge exists, False if it does not
  40      */
  41     public boolean isNodeNeutronReady(Node node);
  42
  43     /**
  44      * Checks for the existence of the Network Bridge on a given Node
  45      * @param node the {@link Node} where the bridge should be configured
  46      * @return True if the bridge exists, False if it does not
  47      */
  48     public boolean isNodeOverlayReady(Node node);
  49
  50     /**
  51      * Checks for the existence of the Network Bridge on a given Node
  52      * @param node the {@link Node} where the bridge should be configured
  53      * @return True if the bridge exists, False if it does not
  54      */
  55
  56     /**
  57      * Checks that a Node is ready for a Tunnel Network Provider
  58      * For OpenFlow 1.0 the Integration, Network Bridge and corresponding patch ports are required
  59      * For OpenFlow 1.3 only the Integration Bridge is required
  60      * @param bridgeNode the {@link Node} that represents bridge
  61      * @param ovsdbNode the {@link Node} where the bridge is configured
  62      * @return True or False
  63      */
  64     public boolean isNodeTunnelReady(Node bridgeNode, Node ovsdbNode);
  65
  66     /* Determine if internal network is ready for vlan network types.
  67      * - OF 1.0 requires br-int, br-net, a patch connecting them and
  68      * physical device added to br-net.
  69      * - OF 1.3 requires br-int and physical device added to br-int.
  70      */
  71
  72     /**
  73      * Checks that a Node is ready for a VLAN Network Provider for the given Network
  74      * For OpenFlow 1.0 the Integration Bridge, Network Bridge, patch ports and a physical device connected to the
  75      * Network Bridge are required.
  76      * For OpenFlow 1.3 the Integration Bridge is required and must have a physical device connected.
  77      * @param bridgeNode the {@link Node} that represents bridge
  78      * @param ovsdbNode the {@link Node} where the bridge is configured
  79      * @param network the {@link org.opendaylight.neutron.spi.NeutronNetwork}
  80      * @return True or False
  81      */
  82     public boolean isNodeVlanReady(Node bridgeNode, Node ovsdbNode, NeutronNetwork network);
  83
  84     /**
  85      * A helper function to determine if a port exists on a given bridge
  86      * @param node the {@link Node} where the bridge is configured
  87      * @param portName the name of the port to search for
  88      * @return True if the port exists, otherwise False
  89      */
  90     public boolean isPortOnBridge (Node node, String portName);
  91
  92
  93     /**
  94      * Returns true if the bridges required for the provider network type are created
  95      * If the bridges are not created, this method will attempt to create them
  96      * @param node the {@link Node} to query
  97      * @param network the {@link org.opendaylight.neutron.spi.NeutronNetwork}
  98      * @return True or False
  99      */
 100     public boolean createLocalNetwork(Node node, NeutronNetwork network);
 101
 102     /**
 103      * Prepares the given Node for Neutron Networking by creating the Integration Bridge
 104      * @param node the {@link Node} to prepare
 105      */
 106     public void prepareNode(Node node);
 107
 108     /**
 109      * Returns the physical interface mapped to the given neutron physical network.
 110      * @param node
 111      * @param physicalNetwork
 112      * @return
 113      */
 114     public String getPhysicalInterfaceName (Node node, String physicalNetwork);
 115
 116     /** Returns all physical interfaces configured in the bridge mapping
 117      * Bridge mappings will be of the following format:
 118      * @param node the {@link Node} to query
 119      * @return a List in the format {eth1, eth2} given bridge_mappings=physnet1:eth1,physnet2:eth2
 120      */
 121     public List<String> getAllPhysicalInterfaceNames(Node node);
 122 }