Generic PCI PassthroughΒΆ

Prerequisites

Before you can enable a device, you must lock the compute host.

If you want to enable a device that is in the inventory for pci-passthrough, the device must be enabled and a Nova PCI Alias must be configured with vendor-id, product-id and alias name.

You can use the following command from the CLI, to view devices that are automatically inventoried on a host:

~(keystone_admin)$ system host-device-list controller-0 --all

You can use the following command from the CLI to list the devices for a host, for example:

~(keystone_admin)$ system host-device-list --all controller-0
+-------------+----------+------+-------+-------+------+--------+--------+-------------+-------+
| name        | address  | class| vendor| device| class| vendor | device | numa_node   |enabled|
|             |          | id   | id    | id    |      | name   | name   |             |       |
+------------+----------+-------+-------+-------+------+--------+--------+-------------+-------+
| pci_0000_05.| 0000:05:.| 030. | 10de  | 13f2  | VGA. | NVIDIA.| GM204GL| 0           | True  |
| pci_0000_06.| 0000:06:.| 030. | 10de  | 13f2  | VGA. | NVIDIA.| GM204GL| 0           | True  |
+-------------+----------+------+-------+-------+------+--------+--------+-------------+-------+

The --alloption displays both enabled and disabled devices.

Note

Depending on the system, not all devices in this list can be accessed via pci-passthrough, based on hardware/driver limitations.

To enable or disable a device using the CLI, do the following:

Prerequisites

To edit a device, you must first lock the host.

Procedure

  1. Enable the device.

    ~(keystone_admin)$ system host-device-modify <compute_node>
<pci_address> --enable=True

  2. Add a PCI alias.

    For more information, see Configuring a PCI Alias in Nova.

Postrequisites

Refer to Configuring a Flavor to Use a Generic PCI Device for details on how to launch the VM with a PCI interface to this Generic PCI Device.