Bug 1628700 - [Docs] OSP10 and later needs more warning notes about raw image format being ONLY supported format with Ceph storage backend
Summary: [Docs] OSP10 and later needs more warning notes about raw image format being ...
Keywords:
Status: CLOSED WONTFIX
Alias: None
Product: Red Hat OpenStack
Classification: Red Hat
Component: documentation
Version: 10.0 (Newton)
Hardware: Unspecified
OS: Unspecified
low
high
Target Milestone: ---
: ---
Assignee: Laura Marsh
QA Contact: RHOS Documentation Team
URL:
Whiteboard:
Depends On:
Blocks: 1866082
TreeView+ depends on / blocked
 
Reported: 2018-09-13 18:17 UTC by Steven DuChene
Modified: 2020-08-04 19:41 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
: 1866082 (view as bug list)
Environment:
Last Closed: 2020-08-04 19:40:24 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Steven DuChene 2018-09-13 18:17:28 UTC
Description of problem: In a OSP deployment if Ceph storage is used as the backend storage for glance images, the ONLY supported image format is raw. A note about this needs to be added to the OSP Architecture Guide document in the glance storage section where supported image formats are discussed. The relevant section is here:  

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/10/html/architecture_guide/components#comp-image

The appropriate & relevant note contents can be seen can n the OSP Director Installation and Usage document here:

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/10/html-single/director_installation_and_usage/#sect-Planning_Storage

The exact text of the note says:

IMPORTANT
If you want to boot virtual machines in Ceph (ephemeral backend or boot from volume), the glance image format must be RAW format. Ceph does not support other image formats such as QCOW2 or VMDK for hosting a virtual machine disk.

This issue of supported image formats when using Ceph backend for glance image storage came up at a strategic NFV customer who had implemented their OSP deployment with qcow2 images even though they had a Ceph storage backend for glance images. So this note needs to have higher visability in the OSP documentation wherever image formats for glance are discussed.

Thanks

Version-Release number of selected component (if applicable): OSP10, OSP11, OSP12, OSP13, and beyond.


How reproducible:


Steps to Reproduce:
1.
2.
3.

Actual results:


Expected results:


Additional info:

Comment 1 John Fulton 2019-09-05 17:09:00 UTC
Perhaps we should mention that the conversion is possible as per the request in docbug 1610329:

If you want to boot virtual machines in Ceph (ephemeral backend or boot from volume), the Glance image format must be RAW format. Ceph does not support other image formats such as QCOW2 or VMDK for hosting a virtual machine disk. While it's possible to configure Glance to convert the QCOW2 image to RAW if a QCOW2 image is uploaded, the conversion will occur while booting the instance which will take time. Thus, there are benefits to converting the image to RAW before uploading.


Note You need to log in before you can comment on or make changes to this bug.