yahoo-eng-team team mailing list archive

[Matt Riedemann <mriedem.os@xxxxxxxxx>]

Public bug reported:

- [x] This is a doc addition request.

The useful image properties page does not document the "hw_cdrom_bus"
image property, but it's mentioned in a few docs:

https://docs.openstack.org/glance/rocky/admin/manage-images.html

https://docs.openstack.org/security-guide/compute/hardening-the-
virtualization-layers.html

Probably the easiest description is "Name of the CDROM bus to use.".

The values for the property are defined in nova:

https://github.com/openstack/nova/blob/48ad73e1faf966badab1f0344baad9f4f4055abf/nova/objects/fields.py#L320

class DiskBus(BaseNovaEnum):

    FDC = "fdc"
    IDE = "ide"
    SATA = "sata"
    SCSI = "scsi"
    USB = "usb"
    VIRTIO = "virtio"
    XEN = "xen"
    LXC = "lxc"
    UML = "uml"

ALL = (FDC, IDE, SATA, SCSI, USB, VIRTIO, XEN, LXC, UML)

However, not all libvirt virt types support all disk bus types, that's
defined here:

https://github.com/openstack/nova/blob/48ad73e1faf966badab1f0344baad9f4f4055abf/nova/virt/libvirt/blockinfo.py#L198

The only compute driver that uses hw_cdrom_bus is "libvirt".

-----------------------------------
Release:  on 2018-07-30 15:26:07
SHA: 3d52684346f3a7eb56b7d8836b4e0e8efafee647
Source: https://git.openstack.org/cgit/openstack/glance/tree/doc/source/admin/useful-image-properties.rst
URL: https://docs.openstack.org/glance/latest/admin/useful-image-properties.html

** Affects: glance
     Importance: Medium
         Status: Confirmed


** Tags: documentation

-- 
You received this bug notification because you are a member of Yahoo!
Engineering Team, which is subscribed to Glance.
https://bugs.launchpad.net/bugs/1808868

Title:
  Useful image properties in glance - hw_cdrom_bus is not documented

Status in Glance:
  Confirmed

Bug description:
  - [x] This is a doc addition request.

  The useful image properties page does not document the "hw_cdrom_bus"
  image property, but it's mentioned in a few docs:

  https://docs.openstack.org/glance/rocky/admin/manage-images.html

  https://docs.openstack.org/security-guide/compute/hardening-the-
  virtualization-layers.html

  Probably the easiest description is "Name of the CDROM bus to use.".

  The values for the property are defined in nova:

  https://github.com/openstack/nova/blob/48ad73e1faf966badab1f0344baad9f4f4055abf/nova/objects/fields.py#L320

  class DiskBus(BaseNovaEnum):

      FDC = "fdc"
      IDE = "ide"
      SATA = "sata"
      SCSI = "scsi"
      USB = "usb"
      VIRTIO = "virtio"
      XEN = "xen"
      LXC = "lxc"
      UML = "uml"

  ALL = (FDC, IDE, SATA, SCSI, USB, VIRTIO, XEN, LXC, UML)

  However, not all libvirt virt types support all disk bus types, that's
  defined here:

  https://github.com/openstack/nova/blob/48ad73e1faf966badab1f0344baad9f4f4055abf/nova/virt/libvirt/blockinfo.py#L198

  The only compute driver that uses hw_cdrom_bus is "libvirt".

  -----------------------------------
  Release:  on 2018-07-30 15:26:07
  SHA: 3d52684346f3a7eb56b7d8836b4e0e8efafee647
  Source: https://git.openstack.org/cgit/openstack/glance/tree/doc/source/admin/useful-image-properties.rst
  URL: https://docs.openstack.org/glance/latest/admin/useful-image-properties.html

To manage notifications about this bug go to:
https://bugs.launchpad.net/glance/+bug/1808868/+subscriptions