Red Hat Training

A Red Hat training course is available for Red Hat OpenStack Platform

7.4. Configure the Plug-in Agent

Configure the agent associated with the plug-in used in your environment. If you are using the ML2 plug-in configure the Open vSwitch agent.

7.4.1. Configure the Open vSwitch Plug-in Agent

You must install and enable the ML2 plug-in before configuring it. See Section, “Enable the ML2 Plug-in”.
The Open vSwitch plug-in has a corresponding agent. When the Open vSwitch plug-in is in use, all nodes in the environment that handle data packets must have the agent installed and configured. This includes all Compute nodes and systems hosting the dedicated DHCP and L3 agents.


Open vSwitch support for TCP segmentation offload (TSO) and Generic Segmentation Offload (GSO) to VXLAN and GRE is enabled by default.

Procedure 7.11. Configuring the Open vSwitch Plug-in Agent

  1. Start the openvswitch service:
    # systemctl start openvswitch.service
  2. Configure the openvswitch service to start at boot time:
    # systemctl enable openvswitch.service
  3. Each host running the Open vSwitch agent requires an Open vSwitch bridge called br-int, which is used for private network traffic. This bridge is created automatically.


    The br-int bridge is required for the agent to function correctly. Once created, do not remove or otherwise modify the br-int bridge.
  4. Set the value of the bridge_mappings configuration key to a comma-separated list of physical networks and the network bridges associated with them:
    # openstack-config --set /etc/neutron/plugins/ml2/openvswitch_agent.ini \
       ovs bridge_mappings PHYSNET:BRIDGE
    Replace PHYSNET with the name of a physical network, and replace BRIDGE with the name of the network bridge.
  5. Start the neutron-openvswitch-agent service:
    # systemctl start neutron-openvswitch-agent.service
  6. Configure the neutron-openvswitch-agent service to start at boot time:
    # systemctl enable neutron-openvswitch-agent.service
  7. Configure the neutron-ovs-cleanup service to start at boot time. This service ensures that the OpenStack Networking agents maintain full control over the creation and management of tap devices:
    # systemctl enable neutron-ovs-cleanup.service