Revision as of 22:13, 17 January 2013

Brocade Quantum Plugin

Overview

Brocade Quantum Plugin implements the Quantum v2.0 API. Switches running NOS (e.g. VDX 67xx, VDX 87xx) are supported. It uses NETCONF at the backend to configure the Brocade switch.

Directory Structure

(this paragraph is relevant ONLY if you have download the Brocade Quantum Plugin from: http://www.github.com/brocade/brocade )

Normally you will have your Openstack directory structure as follows:

/opt/stack/nova/
/opt/stack/horizon/
/opt/stack/quantum/quantum/plugins/

This repository represents code that will be put into the brocade directory as:

/opt/stack/quantum/quantum/plugins/brocade

Configuration

1. Specify to Quantum that you will be using the Brocade Plugin - this is done by setting the parameter core_plugin in Quantum:

core_plugin = quantum.plugins.brocade.QuantumPlugin.BrcdPluginV2

2. Physical switch configuration parameters and Brocade specific database configuration is specified in the configuration file specified in the brocade.ini files:

% cat /etc/quantum/plugins/brocade/brocade.ini

[SWITCH]
username = admin
password = password
address  = <switch mgmt ip address>
ostype   = NOS

[DATABASE]
sql_connection = mysql://root:pass@localhost/brcd_quantum?charset=utf8

       (please see list of more configuration parameters in the brocade.ini file)

Running Setup.py

Running setup.py with appropriate permissions will copy the default configuration file to /etc/quantum/plugins/brocade/brocade.ini. This file MUST be edited to suit your setup/environment.

% cd /opt/stack/quantum/quantum/plugins/brocade
% python setup.py

Devstack

Please see special notes for devstack at: http://wiki.openstack.org/brocade-quantum-plugin

In order to use Brocade Quantum Plugin, add the following lines in localrc, if localrc file does not exist you may have to create one:

ENABLED_SERVICES=g-api,g-reg,key,n-api,n-crt,n-obj,n-cpu,n-net,n-cond,cinder,c-sch,c-api,c-vol,n-sch,n-novnc,n-xv\
nc,n-cauth,horizon,rabbit,quantum,q-svc,q-agt
Q_PLUGIN=BrcdQuantumPlugin

As part of using devstack, the files above are copied over from quantum to their final destination. So it will be advisable to edit the files appropriately.

/opt/stack/quantum/etc/quantum.conf -> /etc/quantum/quantum.conf
/opt/stack/quantum/etc/quantum/plugins/brocade/brocade.ini -> /etc/quantum/plugins/brocade/brocade.ini

hence it is important to make any changes to the configuration in:

/opt/stack/quantum/etc/quantum/plugins/brocade/brocade.ini

@@ Line 7: / Line 7: @@
 ----------------------
-== OVERVIEW ==
+== Overview ==
-Brocade Quantum Plugin implements the Quantum v2.0 API. Switches running NOS  [http://www.brocade.com/products/all/switches/index.page   (e.g. VDX 67xx, VDX 87xx)] are supported.
+Brocade Quantum Plugin implements the Quantum v2.0 API. Switches running NOS  [http://www.brocade.com/products/all/switches/index.page   (e.g. VDX 67xx, VDX 87xx)] are supported. It uses NETCONF at the backend to configure the Brocade switch.
-== HOW TO CONFIGURE ==
+== Directory Structure ==
-=== Quantum Configuration: ===
+(this paragraph is relevant ONLY if you have download the Brocade Quantum Plugin from: http://www.github.com/brocade/brocade )
-Modify your Quantum configuration (/etc/quantum/quantum.conf) for using the Brocade Plugin:
+Normally you will have your Openstack directory structure as follows:
-        core_plugin = quantum.plugins.brocade.[[QuantumPlugin]].[[BrcdPluginV2]]
-=== Brocade Configuration: ===
+<pre><nowiki>
+/opt/stack/nova/
+/opt/stack/horizon/
+/opt/stack/quantum/quantum/plugins/
+</nowiki></pre>
-Make a backup copy of /etc/quantum/plugins/brocade/brocade.ini. Edit this file to
-configure the IP address of the management interface of the switch. The port need
-not be configured as the port number used will be NETCONF over SSHv2.
-=== Specical note when using devstack: ===
+This repository represents code that will be put into the brocade directory as:
-If you are using devstack, the files above are copied over from quantum to their
+<pre><nowiki>
+/opt/stack/quantum/quantum/plugins/brocade
+</nowiki></pre>
+== Configuration ==
+. Specify to Quantum that you will be using the Brocade Plugin - this is done
+by setting the parameter core_plugin in Quantum:
+<pre><nowiki>
+core_plugin = quantum.plugins.brocade.QuantumPlugin.BrcdPluginV2
+</nowiki></pre>
+. Physical switch configuration parameters and Brocade specific database configuration is specified in
+the configuration file specified in the brocade.ini files:
+<pre><nowiki>
+% cat /etc/quantum/plugins/brocade/brocade.ini
+[SWITCH]
+username = admin
+password = password
+address  = <switch mgmt ip address>
+ostype   = NOS
+[DATABASE]
+sql_connection = mysql://root:pass@localhost/brcd_quantum?charset=utf8
+</nowiki></pre>
+        (please see list of more configuration parameters in the brocade.ini file)
+== Running Setup.py ==
+Running setup.py with appropriate permissions will copy the default configuration
+file to /etc/quantum/plugins/brocade/brocade.ini. This file MUST be edited to
+suit your setup/environment.
+<pre><nowiki>
+% cd /opt/stack/quantum/quantum/plugins/brocade
+% python setup.py
+</nowiki></pre>
+== Devstack ==
+Please see special notes for devstack at:
+http://wiki.openstack.org/brocade-quantum-plugin
+In order to use Brocade Quantum Plugin, add the following lines in localrc, if localrc
+file does not exist you may have to create one:
+<pre><nowiki>
+ENABLED_SERVICES=g-api,g-reg,key,n-api,n-crt,n-obj,n-cpu,n-net,n-cond,cinder,c-sch,c-api,c-vol,n-sch,n-novnc,n-xv\
+nc,n-cauth,horizon,rabbit,quantum,q-svc,q-agt
+Q_PLUGIN=BrcdQuantumPlugin
+</nowiki></pre>
+As part of using devstack, the files above are copied over from quantum to their
 final destination. So it will be advisable to edit the files appropriately.
+<pre><nowiki>
 /opt/stack/quantum/etc/quantum.conf -> /etc/quantum/quantum.conf
+/opt/stack/quantum/etc/quantum/plugins/brocade/brocade.ini -> /etc/quantum/plugins/brocade/brocade.ini
+</nowiki></pre>
-/opt/stack/quantum/quantum/plugins/brocade/brocade.ini -> /etc/quantum/plugins/brocade/brocade.ini
+hence it is important to make any changes to the configuration in:
-----
+<pre><nowiki>
-[[Category:Homepage]]
+/opt/stack/quantum/etc/quantum/plugins/brocade/brocade.ini
+</nowiki></pre>

Difference between revisions of "Brocade-neutron-plugin"