Revision as of 07:14, 15 July 2013

Mellanox Quantum Plugin Installation (for Havana)

On the Quantum Server Node

1. Select Mellanox eSwitch plugin as core plugin for Quantum server.

2. Modify the /etc/quantum/plugins/mlnx/mlnx_conf.ini file to reflect your environment.

3. If you run the Quantum server using init script - change the quantum server configuration to point to Mellanox Quantum Plugin

For example, In Ubuntu change /etc/default/quantum-server

QUANTUM_PLUGIN_CONFIG="/etc/quantum/plugins/mlnx/mlnx_conf.ini"

4. Run the server.

  #quantum-server --config-file /etc/quantum/quantum.conf --config-file /etc/quantum/plugins/mlnx/mlnx_conf.ini

or

  #/etc/init.d/quantum-server start

On Compute Nodes

Nova-compute

1. Copy the Nova Mellanox VIF driver.

   #cp -a mellanox-quantum-plugin/nova/nova/virt/libvirt/mlnx /usr/lib/python2.6/site-packages/nova/virt/libvirt

2. Modify nova.conf.

   compute_driver=nova.virt.libvirt.driver.LibvirtDriver
   libvirt_vif_driver=nova.virt.libvirt.mlnx.vif.MlxEthVIFDriver
   fabric=default - specifies physical network for vNICs (currently support one fabric per node)

3. Restart Nova.

The eswitchd Daemon

The eswitchd source files are located in the mellanox-eswitchd repository eSwitchd source repository 1. Clone and install the eSwitchd

#git clone https://github.com/mellanox-openstack/mellanox-eswitchd 
#cd mellanox-eswitchd 
#python setup.py install 

2. Copy the configuration and init files of the eSwitchd.

#mkdir /etc/eswitchd
#cp etc/eswitchd/eswitchd.conf /etc/eswitchd
#cp etc/init.d/eswitchd /etc/init.d

3. Modify the configuration file according to your environment

# cat /etc/eswitchd/eswitchd.conf
[DEFAULT] 
default_log_levels="eswitchd=DEBUG"
verbose=False
debug=False
log_file=/var/log/eswitchd.log
[DAEMON]
fabrics='mlx1:eth4' --> Important line  '<fabric_name>:<PF Name>'.
                    --> The fabric name should match the name in quantum agent and/or openFlow agent.
default_timeout=4000

3. Run the daemon:

# /etc/init.d/eswitchd start

Quantum Agent

1. Modify the Quantum Agent configuration at /etc/quantum/plugins/mlnx/mlnx_conf.ini.

2. Run the agent.

   #python /usr/lib/python2.6/site-packages/quantum/plugins/mlnx/agent/eswitch_quantum_agent.py --config-file /etc/quantum/quantum.conf  --config-file /etc/quantum/plugins/mlnx/mlnx_conf.ini

For a plugin configuration file example (master), please refer to Mellanox config *ini file.