starlingx/docs
Code Issues Proposed changes
66ddb603c7
docs/doc/source/node_management/openstack/generic-pci-passthrough.rst
Juanita-Balaraj 63cd4f5fdc CephFS RWX Support in Host-based Ceph 
Incorporated patchset 1 review comments
Updated patchset 5 review comments
Updated patchset 6 review comments
Fixed merge conflicts
Updated patchset 8 review comments

Change-Id: Icd7b08ab69273f6073b960a13cf59905532f851a
Signed-off-by: Juanita-Balaraj <juanita.balaraj@windriver.com>
2021-05-03 16:39:45 -04:00

2.3 KiB
Raw Blame History

Generic PCI Passthrough

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 Alias must be configured with vendor-id, product-id and alias name.

You can use the following command from the , 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 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 , do the following:

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

  1. Enable the device.

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

  2. Add a alias.

    For more information, see Configuring a PCI Alias in Nova <configuring-a-pci-alias-in-nova>.

Refer to Configuring a Flavor to Use a Generic PCI Device <configuring-a-flavor-to-use-a-generic-pci-device> for details on how to launch the with a interface to this Generic Device.