x
/
fuel-plugin-mellanox
Code Issues Proposed changes
RETIRED, Fuel plugin for Mellanox support
150 Commits 1 Branch 10 Tags 3 MiB
Go to file
Rawan Herzallah 8f8694dd97 Reload vfs after iser rename 
Vfs are gone after removing required kernel parameters and loading
them again causing sriov validae to fall back to 8 each time.

Change-Id: I73e7064dd3fc6547f3ebb71059af2ae63423e67d
 		2016-06-21 08:30:56 +00:00
bootstrap/sync Add support for ConnectX-4 LX FW configurations 2016-06-19 18:34:46 +03:00
deployment_scripts Reload vfs after iser rename 2016-06-21 08:30:56 +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 Dynamically set maximum number of VFs in bootstrap stage 2016-06-08 11:10:18 +00: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 Remove link_astute_file deployment task 2016-06-19 18:43:47 +03:00
environment_config.yaml Remove VXALN checkbox from UI 2016-06-13 07:58:54 +00:00
metadata.yaml Reload vfs after iser rename 2016-06-21 08:30:56 +00:00
post_install.sh Fixed post install script output message with MAX num vfs parameter 2016-06-19 18:48:32 +03:00
pre_build_hook Fixes to SRIOV VFs unbind 2016-06-13 17:17:24 +03: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