Skip to content

Commit

Permalink
docs: add vdpa section in ovs_offload docs
Browse files Browse the repository at this point in the history
vdpa is an addition on top of ovs_offload so it makes sense to document
it as part of it.

Signed-off-by: Adrian Moreno <amorenoz@redhat.com>
  • Loading branch information
amorenoz committed Dec 28, 2021
1 parent 131f732 commit d531392
Showing 1 changed file with 50 additions and 0 deletions.
50 changes: 50 additions & 0 deletions docs/ovs_offload.md
Original file line number Diff line number Diff line change
Expand Up @@ -210,3 +210,53 @@ tcpdump: verbose output suppressed, use -v or -vv for full protocol decode
17:12:56.106705 IP 0.0.0.0.68 > 255.255.255.255.67: BOOTP/DHCP, Request from 62:21:f0:89:40:73, length 30
```

## vDPA

vDPA (Virtio DataPath Acceleration) is a technology that enables the acceleration of virtIO devices while
allowing the implementations of such devices (e.g: NIC vendors) to use their own control plane.

vDPA can be combined with the SR-IOV OVS Hardware offloading setup to expose the workload to an
open standard interface such as virtio-net.

### Additional Prerequisites:
* Linux Kernel >= 5.12
* iproute >= 5.14

### Supported Hardware:
- Mellanox ConnectX-6DX NIC

### Additional configuration
In addition to all the steps listed above, insert the virtio-vdpa driver and the mlx-vdpa driver:

$ modprobe vdpa
$ modprobe virtio-vdpa
$ modprobe mlx5-vdpa

The the `vdpa` tool (part of iproute package) is used to create a vdpa device on top
of an existing VF:

$ vdpa mgmtdev show
pci/0000:65:00.2:
supported_classes net
$ vdpa dev add name vdpa2 mgmtdev pci/0000:65:00.2
$ vdpa dev list
vdpa2: type network mgmtdev pci/0000:65:00.2 vendor_id 5555 max_vqs 16 max_vq_size 256

After a device has been created, the SR-IOV Device Plugin plugin configuration has to be modified for it
to select and expose the vdpa device:

```json
{
"resourceList": [
{
"resourceName": "cx6_sriov_vpda_virtio",
"selectors": {
"vendors": ["15b3"],
"devices": ["101e"],
"vdpaType": "virtio"
}
}
]
}
```

0 comments on commit d531392

Please sign in to comment.