Skip to content

Commit e8f48d2

Browse files
committed
F OpenNebula/one#6841: Add documentation for new vGPU framework
(cherry picked from commit 99fac53)
1 parent 23af6c0 commit e8f48d2

File tree

1 file changed

+37
-1
lines changed
  • source/open_cluster_deployment/kvm_node

1 file changed

+37
-1
lines changed

source/open_cluster_deployment/kvm_node/vgpu.rst

Lines changed: 37 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -139,4 +139,40 @@ Finally, add the following udev rule:
139139
Using the vGPU
140140
--------------------------------------------------------------------------------
141141

142-
Once everything is set up, you can follow :ref:`these steps <pci_config>`.
142+
Once the setup is complete, you can follow the :ref:`general steps <pci_config>` for adding PCI devices to a VM. For NVIDIA GPUs, please consider the following:
143+
144+
- OpenNebula supports both the legacy mediated device interface and the new vendor-specific interface introduced with Ubuntu 24.04. The vGPU device configuration is handled automatically by the virtualization and monitoring drivers. The monitoring process automatically sets the appropriate mode for each device using the ``MDEV_MODE`` attribute.
145+
146+
- NVIDIA vGPUs can be configured using different profiles, which define the vGPU's characteristics and hardware capabilities. These profiles are retrieved from the drivers by the monitoring process, allowing you to easily select the one that best suits your application's requirements.
147+
148+
The following example shows the monitoring information for a NVIDIA vGPU device:
149+
150+
.. prompt:: bash $ auto
151+
152+
$ onehost show -j 13
153+
...
154+
"PCI_DEVICES": {
155+
"PCI": [
156+
{
157+
"ADDRESS": "0000:41:00:4",
158+
"BUS": "41",
159+
"CLASS": "0302",
160+
"CLASS_NAME": "3D controller",
161+
"DEVICE": "2236",
162+
"DEVICE_NAME": "NVIDIA Corporation GA102GL [A10]",
163+
"DOMAIN": "0000",
164+
"FUNCTION": "4",
165+
"MDEV_MODE": "nvidia",
166+
"NUMA_NODE": "-",
167+
"PROFILES": "588 (NVIDIA A10-1B),589 (NVIDIA A10-2B),590 (NVIDIA A10-1Q),591 (NVIDIA A10-2Q),592 (NVIDIA A10-3Q),593 (NVIDIA A10-4Q),594 (NVIDIA A10-6Q),595 (NVIDIA A10-8Q),596 (NVIDIA A10-12Q),597 (NVIDIA A10-24Q),598 (NVIDIA A10-1A),599 (NVIDIA A10-2A),600 (NVIDIA A10-3A),601 (NVIDIA A10-4A),602 (NVIDIA A10-6A),603 (NVIDIA A10-8A),604 (NVIDIA A10-12A),605 (NVIDIA A10-24A)",
168+
"SHORT_ADDRESS": "41:00.4",
169+
"SLOT": "00",
170+
"TYPE": "10de:2236:0302",
171+
"UUID": "e4042b96-e63d-56cf-bcc8-4e6eecccc12e",
172+
"VENDOR": "10de",
173+
"VENDOR_NAME": "NVIDIA Corporation",
174+
"VMID": "-1"
175+
}
176+
177+
.. important::
178+
When using NVIDIA cards, ensure that only the GPU (for PCI passthrough) or vGPUs (for SR-IOV) are exposed through the PCI monitoring probe. Do not mix both types of devices in the same configuration.

0 commit comments

Comments
 (0)