Skip to content

Commit fd37398

Browse files
dann1mattrowe-opennebula
authored andcommitted
F OpenNebula/one#7679: Document feature (#677)
Add note abut using SR-IOV in switchdev mode. Co-authored-by: mattrowe-opennebula <mrowe@opennebula.io> (cherry picked from commit 609d576)
1 parent 23edea3 commit fd37398

1 file changed

Lines changed: 11 additions & 8 deletions

File tree

content/product/cluster_configuration/hosts_and_clusters/pci_passthrough.md

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,8 @@ It is possible to discover PCI devices in the Hosts and directly assign them to
1212

1313
The setup and environment information is taken from [here](https://stewartadam.io/howtos/fedora-20/create-gaming-virtual-machine-using-vfio-pci-passthrough-kvm). You can safely ignore all the VGA-related sections, those for PCI devices that are not graphics cards, or if you don’t want to output video signal from them.
1414

15-
{{< alert title="Warning" type="warning" >}}
16-
The overall setup state was extracted from a preconfigured Fedora 22 machine. **Configuration for your distro may be different.**{{< /alert >}}
15+
{{% alert title="Warning" type="warning" %}}
16+
The overall setup state was extracted from a preconfigured Fedora 22 machine. **Configuration for your distro may be different**.{{% /alert %}}
1717

1818
## Requirements
1919

@@ -138,7 +138,7 @@ cgroup_device_acl = [
138138
<a id="pci-config"></a>
139139

140140
{{< alert title="Note" type="info" >}}
141-
There may be permissions problems if `/dev/vfio` devices are not owned by `oneadmin:kvm`. In this cases, a udev rule like `SUBSYSTEM=="vfio", GROUP="kvm", OWNER="oneadmin"` will set up the necessary owner:group for them to work{{< /alert >}}
141+
There may be permissions problems if `/dev/vfio` devices are not owned by `oneadmin:kvm`. In this cases, a udev rule like `SUBSYSTEM=="vfio", GROUP="kvm", OWNER="oneadmin"` will set up the necessary owner:group for them to work.{{< /alert >}}
142142

143143
## Driver Configuration
144144

@@ -316,12 +316,15 @@ PCI = [
316316

317317
It is possible use a PCI device as an NIC interface directly in OpenNebula. In order to do so you will need to follow the configuration steps mentioned in this guide, namely changing the device driver.
318318

319-
For SR-IOV interfaces you can configure some parameters, in particular the following attributes can be defined for a SR-IOV interface:
319+
For SR-IOV interfaces, you can configure different parameters depending on whether the parent Physical Function (PF) of the Virtual Function (VF) is operating in legacy or switchdev mode:
320320

321-
> - `MAC`
322-
> - `VLAN_ID`
323-
> - `SPOOFCHK`
324-
> - `TRUST`
321+
* **Legacy Mode**: In the traditional SR-IOV mode, parameters are applied directly to the hardware VF. The following attributes can be defined:
322+
- `MAC`: Configures the MAC address of the VF interface.
323+
- `VLAN_ID`: Sets the VLAN tag for the interface.
324+
- `SPOOFCHK`: Enables or disables MAC/VLAN spoof checking.
325+
- `TRUST`: Enables or disables VF trust status.
326+
327+
* **Switchdev Mode**: In switchdev mode, VF parameters are controlled by host-side representor interfaces. These can then be attached to a virtual switch to establish port control. In this mode, only the `MAC` is applied directly in the VF interface. The rest of the control parameters are the same as those that are supported by the virtual switch driver of virtual network. As of now, only [Open vSwitch]({{% relref "product/cluster_configuration/networking_system/openvswitch#openvswitch" %}}) is supported for Switchdev Mode.
325328

326329
The [context packages]({{% relref "product/virtual_machines_operation/virtual_machines/vm_templates#context-overview" %}}) support the configuration of the following attributes:
327330

0 commit comments

Comments
 (0)