starlingx/docs
Code Issues Proposed changes
docs/doc/source/node_management/openstack/exposing-a-generic-pci-device-for-use-by-vms.rst
Ron Stone 2b62f49a9d Fix symlinks 
Changed paths to avoid '..', which breaks symlinks in newer versions of sphinx.
Consolidated installation include files under /_includes. Prefixed r5 versions with 'r5_'
Moved files that are used up/down, but at different paths under /shared/_includes
and /shared/figures
Move two include files to /_includes
Moved addtional images to /shared/figures/... Required for DS platform builds.

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: Ia38f4205c5803b3d1fc043e6c59617c34a4e5cbd
Signed-off-by: Ron Stone <ronald.stone@windriver.com>
2021-09-02 13:31:45 +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>.