Revision as of 19:53, 24 September 2013

Neutron ML2 Driver For Cisco Nexus Devices

Overview

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.

Prerequisites

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:

/opt/stack/neutron/neutron/plugins/ml2/drivers/cisco

Configuration

Configure the Nexus switch information in /etc/neutron/plugins/ml2/ml2_conf_cisco.ini. 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:

[ml2_mech_cisco_nexus:1.1.1.1]
# Hostname and port used of the node
compute-1=1/1
# Hostname and port used of the node
compute-2=1/2
# Port number where the SSH will be running at the Nexus Switch, e.g.: 22 (Default)
ssh_port=22
# Provide the Nexus credentials, if you are using Nexus switches. If not this will be ignored.
username=admin
password=mySecretPasswordForNexus