Jump to: navigation, search


< Neutron‎ | ML2
Revision as of 17:51, 26 March 2014 by Rcurran (talk | contribs) (Configuring Devstack for the Cisco Nexus Mechanism Driver)

Neutron ML2 Driver For Cisco Nexus Devices


The Cisco Nexus ML2 Mechanism Driver implements the ML2 Plugin Mechanism Driver API. This driver manages multiple types of Cisco Nexus switches.

Note: The initial version of this driver supports only the VLAN network type on a single physical network.


The following NX-OS version and packages to enable Nexus switch support:

  • NX-OS 5.2.1 (Delhi) Build 69 or above.
  • paramiko library - SSHv2 protocol library for python
  • ncclient v0.3.1 - Python library for NETCONF clients
    • You need a version of ncclient modified by Cisco Systems. To get it, from your shell prompt do:
git clone git@github.com:CiscoSystems/ncclient.git
sudo python ./setup.py install
  • For more information of ncclient, see: http://schmizz.net/ncclient/
  • OS supported:
  • RHEL 6.1 or above
  • Ubuntu 11.10 or above
  • Package: python-configobj-4.6.0-3.el6.noarch (or newer)
  • Package: python-routes-1.12.3-2.el6.noarch (or newer)
  • Package: pip install mysql-python

Directory Structure

The Cisco Nexus mechanism driver can be found here:



Using the syntax template found here, etc/neutron/plugins/ml2/ml2_conf_cisco.ini, add the Nexus switch information to a configuration file included on the command line when the neutron-server is started. The format should include the IP address of the switch, a host that's connected to the switch and the port on the switch that host is connected to. Also, add the Nexus switch credential username and password. You can configure multiple switches as well as multiple hosts per switch as shown in the example below:

# Use section header 'ml2_mech_cisco_nexus:' followed by the IP address of the Nexus switch.
# Hostname and port used on the switch for this compute host.
# Port number where the SSH will be running at the Nexus Switch, e.g.: 22 (Default)
# Provide the Nexus log in information

Configuring Devstack for the Cisco Nexus Mechanism Driver

See the ML2 main page for general Devstack configuration - https://wiki.openstack.org/wiki/Neutron/ML2

To add Cisco Nexus Mechanism Driver (MD) support add the following to the devstack localrc file.

# Where CONF_PATH can be any valid directory path on the devstack system.

Create the file /home/openstack/ml2_conf_cisco.ini and add the nexus switch information. Syntax is described in the "Configuration" section above.