docs/doc/source/node_management/openstack/exposing-a-generic-pci-device-for-use-by-vms.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.2 KiB

Expose a Generic PCI Device for Use by VMs

You can configure generic -passthrough or devices (i.e. not network interface devices/cards) so that they are accessible to .

Note

For network cards, you must use the network interface settings to configure VM access. You can do this from either the interface or the . For more information, see Configuring PCI Passthrough Ethernet Interfaces <configure-pci-passthrough-ethernet-interfaces>.

For generic -passthrough or SR-IOV devices, you must

  • on each host where an instance of the device is installed, enable the device For this, you can use the interface or the .
  • assign a system-wide alias to the device. For this, you must use the .

To enable devices and assign a alias using the , see Exposing a Generic PCI Device Using the CLI <exposing-a-generic-pci-device-using-the-cli>.

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

  1. Select the Devices tab on the Host Detail page for the host.

  2. Click Edit Device.

    image

  3. Update the information as required.

    Name

    Sets the system inventory name for the device.

    Enabled

    Controls whether the device is exposed for use by .

  4. Repeat the above steps for other hosts where the same type of device is installed.

  5. Assign a alias.

    The alias is a system-wide setting. It is used for all devices of the same type across multiple hosts.

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

After completing the steps above, unlock the host.

To access a device from a , you must configure a flavor with a reference to the alias. For more information, see Configuring a Flavor to Use a Generic PCI Device <configuring-a-flavor-to-use-a-generic-pci-device>.