Difference between revisions of "Pci-api-support"

Revision as of 02:54, 20 November 2013

PCI passthrough support in nova enables assigning a PCI device to an instance in openstack. Currently all the core functionality is merged into nova upstream. With this support, it's ok to create instances with devices assignment. However, the API support is still not pushed out, because of time reason.

Contents

Use case

List an show PCI devices on VMs

• The use case starts with User logging in as Administrator using CLI, Web GUI or Management application.
• User issues 'nova show or nova list ' command, User can know which PCI device used by VM.
• System retrieves the VM information form the database.
• System outputs the list of the devices to CLI, Web GUI or Management Application. The description in the list consists of the following:

1. PCI device UUID

List an show PCI stats on hypervisors

• The use case starts with User logging in as Administrator using CLI, Web GUI or Management application.
• User issues 'nova hypervisor-show or nova hypervisor-list ' command, User can know PCI device stats on hypervisor.
• System retrieves the hypervisor information form the database.
• System outputs the list of the devices to CLI, Web GUI or Management Application. The description in the list consists of the following:

1. PCI device stats

List PCI devices on the nodes

• The use case starts with User logging in as Administrator using CLI, Web GUI or Management application.
• User issues 'list PCI devices' command .
• System retrieves the list of devices form the database.
• System outputs the list of the devices to CLI, Web GUI or Management Application. The PCI device description in the list consists of the following:

1. device UUID
2. device name
3. Device PCI ID (Vendor ID/Device ID)
4. Node ID

Get PCI device detailed information

• The use case starts with User logging in as Administrator using CLI, Web GUI or Management application.
• User follows List PCI devices on the nodes use-case to obtain the PCI device UUID or the PCI device name.
• User issues 'show PCI device details' command using either the device UUID or the device name using CLI, Web GUI or Management Application.
• System retrieves device information from the database.
• System outputs the details of the PCI device to CLI, Web GUI or Management Application. The details contain:

1. device Name
2. device UUID
3. device PCI ID (Vendor ID/Device ID)
4. device type
5. device allocation status
6. extra_info
7. instance UUID
8. other infomation