Skip to main content

OpenStack Networking ofagent

Project description

What’s this

This is OpenStack/Networking (Neutron) “ofagent” ML2 driver and its agent.


For how to install/set up ML2 mechanism driver for OpenFlow Agent, please refer to

Notes for updating from Icehouce

OVS.bridge_mappings is deprecated for ofagent. It was removed in Kilo. Please use AGENT.physical_interface_mappings instead. To mimic an existing setup with bridge_mapping, you can create a veth pair, link one side of it to the bridge, and then specify the other side in physical_interface_mappings. For example, if you have the following:


You can do:

# ip link add int-public type veth peer name phy-public
# ip link set int-public up
# ip link set phy-public up
# ovs-vsctl add-port br-ex phy-public

and then replace the bridge_mappings with:


After Icehouce, most of the functionality have been folded into a single bridge, the integration bridge. (aka. br-int) The integration bridge is the only bridge which would have an OpenFlow connection to the embedded controller in ofagent now.

  • ofagent no longer uses a separate bridge for tunneling. Please remove br-tun if you have one:

    # ovs-vsctl del-br br-tun
  • ofagent no longer acts as an OpenFlow controller for physical bridges. Please remove set-controller configuration from your physical bridges:

    # ovs-vsctl del-controller ${PHYSICAL_BRIDGE}

The support of ancillary bridges has been removed after Icehouce. While you can still use these bridges to provide connectivity, neutron-ofagent-agent no longer reports port state changes (up/down) for these bridges. If it is a problem for you, please consider tweaking your configuration to avoid using ancillary bridges. We recommend to use a provider network instead as the following:

  • Make l3-agent external_network_bridge configuration empty:

  • (Re-)create a network (and subnet) for public connectivity with a flat provider network:

    neutron net-create $PUBLIC_NETWORK -- \
      --router:external=True \
      --provider:network_type:flat \
  • Associate your neutron router to the above network:

    neutron router-gateway-clear $ROUTER_ID
    neutron router-gateway-set $ROUTER_ID $PUBLIC_NETWORK
  • Add the corresponding entry to bridge_mappings:


The port naming scheme for ofagent has been changed after Icehouce. If you are using security groups, you should switch firewall_driver accordingly.





External Resources

OFAgent documentation on ReadTheDocs

Neutron/OFAgent on OpenStack wiki


OFAgent uses Ryu ofproto library to communicate with the local switch.

For general Ryu stuff, please refer to

Ryu is available at github git://

The mailing is at


Project details

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
networking_ofagent-2015.1.6-py2.py3-none-any.whl (61.6 kB) Copy SHA256 hash SHA256 Wheel py2.py3 May 9, 2016
networking-ofagent-2015.1.6.tar.gz (73.0 kB) Copy SHA256 hash SHA256 Source None May 9, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page