bb0d78516b
Specification for ML2 mechanism driver for SR-IOV capable NIC based switching. Change-Id: Ie7839da8f29b8666eeb8cb80e0a687dbd62b9f13
3.6 KiB
ML2 Mechanism Driver for embedded switch SR-IOV NIC
Launchpad blueprint:
https://blueprints.launchpad.net/neutron/+spec/ml2-sriov-nic-switch
This blueprint is to add ML2 Mechanism Driver for SR-IOV capable NIC based switching (HW VEB), such as Mellanox ConnectX Family.
Problem description
SR-IOV capable NIC, such as Mellanox ConnectX Family cards, provide embedded switching capability. As part of the both nova and neutron enchacements to support SR-IOV ports, the mechanism driver proposed by this blueprinht will initially support VLAN network type. Nova VIF Driver will take care of setting VLAN ID via libvirt network interface XML. The mechanism driver will require L2 agent to make run time networking setting updates on SR-IOV ports.
Proposed change
The Ml2 mechanism driver will be based on Simple Agent Mechanism Driver. The Ml2 mechanism driver will be capable to bind ports that match supported criteria listed below. It will support DIRECT and MACVTAP vnic types. It will support PCI VENDOR INFO initially matching Mellanox ConnectX Family. There will be an option to load the list of supported PCI VENDOR INFO from configuration file. The mechanism driver will include vlan_id attribute in port vif_details dictionary to provide nova vif driver with vlan id details. The mechanism driver will expect to get port binding:profile populated with physical_network and pci_vendor_info to identify if should bind the port and on which physical network to bind. To support L2 agent rpc calls, _device_to_port_id method of ml2 rpc module should be modified to service devices that are not prefixed by tap.
Alternatives
An alternative solution would be to develop a monolithic plugin. Since SR-IOV resources are limited and support less flexible configuration options as virtual ports, it makes sense to provide SR-IOV ports aside with virtual ports.
Data model impact
None
REST API impact
None
Security impact
None
Notifications impact
None
Other end user impact
None
Performance Impact
Possible impact on performance may be due to pci_vendor_info match check during the attemt to bind port.
Other deployer impact
The deployer must configure the following configuration variables:
- VLAN namespace and ranges to be used for OpenStack.
- Supported pci vendor info records if different from default list.
Developer impact
None
Implementation
Assignee(s)
Primary assignee: Irena Berezovsky <irenab>
Work Items
- Ml2 Mechanism Driver for NIC based switch
- Ml2 Agent for NIC based switch
- ML2 RPC support for SR-IOV devices require by L2 agent
Dependencies
Nova vif driver is required to support SR-IOV NIC based virtual interface. This functionality is added following the nova blueprint: https://blueprints.launchpad.net/nova/+spec/pci-passthrough-sriov
Testing
The code will be covered with unit tests. For tempest test coverage, third party testing is provided. The tests are run in devstack setup on physical server with SR-IOV ConnectX Family card.
Documentation Impact
Configuration Reference guide will be updated from the code.
References
SR-IOV support discussion details are here: