starlingx/docs
Code Issues Proposed changes
66ddb603c7
docs/doc/source/node_management/openstack/exposing-a-generic-pci-device-for-use-by-vms.rst
Ron Stone f125a8b892 Remove spurious escapes (r8,dsR8) 
This change addresses a long-standing issue in rST documentation imported from XML.
That import process added backslash escapes in front of various characters. The three
most common being '(', ')', and '_'.
These instances are removed.

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: Id43a9337ffcd505ccbdf072d7b29afdb5d2c997e
2023-03-01 11:19:04 +00:00

2.3 KiB
Raw Blame History

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>.