x
/
fuel-plugin-mellanox
Code Issues Proposed changes
RETIRED, Fuel plugin for Mellanox support
130 Commits 1 Branch 10 Tags 3 MiB
Go to file
Rawan Herzallah 8b30f4cb75 Set VFs MAC addresses 
Added mac address assignment for created mellanox vfs

Change-Id: Ia4045b0799eacbfc01ceebf8d0d23c8db36f8197
 		2016-05-29 11:24:10 +00:00
bootstrap/sync Move FW burn to discovery stage 2016-04-24 08:18:09 +00:00
deployment_scripts Set VFs MAC addresses 2016-05-29 11:24:10 +00:00
doc Fixing User Guide 2016-03-31 19:18:24 +03:00
repositories Initial commit 2015-03-25 10:40:57 +02:00
scripts Adding script name to bootstrap creation usage 2016-05-17 11:59:16 +03:00
specs Changing plugin version to 8.0 2016-02-04 14:02:11 +02:00
.gitignore Changing plugin version to 8.0 2016-02-04 14:02:11 +02:00
.gitreview Update .gitreview for new namespace 2015-10-17 22:24:24 +00:00
.version Changing plugin version to 8.0 2016-02-04 14:02:11 +02:00
LICENSE Initial commit 2015-03-25 10:40:57 +02:00
README.md Fixing readme.md file 2016-04-04 13:08:49 +00:00
build.sh Changing plugin version to 8.0 2016-02-04 14:02:11 +02:00
deployment_tasks.yaml Implement ConnectX-4 configurations 2016-04-21 14:06:07 +00:00
environment_config.yaml Add UI restriction for intel_iommu kernel params 2016-04-26 06:48:08 +00:00
metadata.yaml Set VFs MAC addresses 2016-05-29 11:24:10 +00:00
post_install.sh Enhanced create_mellanox_bootstrap script 2016-05-10 06:40:49 +00:00
pre_build_hook Set VFs MAC addresses 2016-05-29 11:24:10 +00:00
requirements-bootstrap.txt Added bootstrap replacement support 2015-04-01 16:55:30 +03:00
uninstall.sh Enhanced create_mellanox_bootstrap script 2016-05-10 06:40:49 +00:00

README.md

Mellanox Plugin for Fuel

Mellanox plugin overview

The Mellanox Fuel plugin is a bundle of scripts, packages and metadata that will extend Fuel and add Mellanox features such as SR-IOV for networking and iSER protocol for storage. Fuel can configure Mellanox ConnectX-3 Pro network adapters to accelerate the performance of compute and storage traffic. This implements the following performance enhancements:

  • Compute nodes network enhancements:
    • SR-IOV based networking
    • QoS for VM traffic
    • VXLAN traffic offload
  • Cinder nodes use iSER block storage as the iSCSI transport rather than the default iSCSI over TCP.

These features reduce CPU overhead, boost throughput, reduce latency, and enable network traffic to bypass the software switch layer (e.g. Open vSwitch). Mellanox Plugin integration with Mellanox NEO SDN Controller enables switch VLAN auto provisioning and port configuration for Ethernet and SM PKey auto provisioning for InfiniBand networks, over private VLAN networks.

Developer's specification

Please refer to: HowTo Install Mellanox OpenStack Plugin for Mirantis Fuel 8.0

Requirements

Requirement Version/Comment
Mirantis OpenStack compatibility 8.0

The Mellanox ConnectX-3 Pro adapters family supports up to 40/56 Gb. To reach 56 Gb speed in your network with ConnectX-3 Pro adapters, you must use Mellanox Ethernet / Infiniband switches supporting 56 Gb (e.g. SX1710, SX6710). The switch ports should be configured specifically to use 56 Gb speed. No additional configuration is required on the adapter side. For additional information about how to run in 56GbE speed, see HowTo Configure 56GbE Link on Mellanox Adapters and Switches.

Limitations

  • Mellanox SR-IOV is supported only when choosing Neutron with VLAN segmentation.
  • ConnectX-3 Pro adapters are required in order to enable VXLAN HW offload over Ethernet networks.
  • QoS feature is implemented only for Ethernet VLAN SR-IOV ports using ConnectX-3 Pro adapters.
  • Infiniband is configured by using OpenSM only.

Mellanox plugin configuration

For detailed setup configuration of Ethernet or Infiniband networks, please refer to Mellanox plugin configuration section in HowTo Install Mellanox OpenStack Plugin for Mirantis Fuel 8.0

Installation Guide

To install Mellanox plugin, follow these steps:

  1. Install Fuel Master node. For more information on how to create a Fuel Master node, please see Mirantis Fuel 8.0 documentation

  2. Download the plugin rpm file for MOS 8.0 from Fuel Plugin Catalog

  3. Copy the plugin on already installed Fuel Master. scp can be used for that:

    # scp mellanox-plugin-3.0-3.0.0-1.noarch.rpm root@<Fuel_Master_ip>:/tmp

  4. Install the plugin:

    # cd /tmp
# fuel plugins --install mellanox-plugin-3.0-3.0.0-1.noarch.rpm

  5. Verify the plugin was installed successfully by having it listed using fuel plugins command:

    # fuel plugins
#  id | name              | version | package_version
#  ---|-------------------|---------|----------------
#  1  | mellanox-plugin   | 3.0.0   | 3.0.0

  6. Create new bootstrap image for supporting infiniband networks create_mellanox_vpi_bootstrap can be used

    [root@fuel ~]# create_mellanox_vpi_bootstrap
   Try to build image with data:
   bootstrap:
   certs: null
   container: {format: tar.gz, meta_file: metadata.yaml}
   . . .
   . . .
   . . .
   Bootstrap image f790e9f8-5bc5-4e61-9935-0640f2eed949 has been activated.

  7. In case of using the customized bootstrap image, you must reboot your target nodes with the new bootstrap image you just created. If you already have discovered nodes you can either reboot them manually or use reboot_bootstrap_nodes command. Run reboot_bootstrap_nodes -h for help.

User Guide

Please read the Mellanox Plugin User Guide.

Reporting Bugs

Bugs should be Reported for Fuel Plugin Mellanox.

Contributors