Bug 1294099 - [Docs] [Glance] When importing an big image in glance with --copy-from, image corruption happens
Summary: [Docs] [Glance] When importing an big image in glance with --copy-from, image...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat OpenStack
Classification: Red Hat
Component: documentation
Version: 1.0 (Essex)
Hardware: Unspecified
OS: Unspecified
medium
low
Target Milestone: async
: 7.0 (Kilo)
Assignee: Deepti Navale
QA Contact: Martin Lopes
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2015-12-24 17:33 UTC by David Hill
Modified: 2019-09-12 09:39 UTC (History)
12 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-11-04 06:06:27 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description David Hill 2015-12-24 17:33:56 UTC
Description of problem:
When importing an big image in glance with --copy-from, image corruption happens when it's bigger than swift_storage_large_object_size (in glance-api.conf) or max_file_size (in swift.conf).   By default , this size appears to be 5GB so if a Windows image is imported, it will almost always be corrupted


Version-Release number of selected component (if applicable):


How reproducible:
Always

Steps to Reproduce:
1. import image with --copy-from that is bigger than max_file_size
2. download it
3. checksum it

Actual results:
wrong checksum

Expected results:
same checksum

Additional info:
We have a workaround here:
Change: swift_storage_large_object_size in glance-api.conf to 20gb
and change: max_file_size in swift.conf to 20gb.  T

Comment 3 Flavio Percoco 2016-01-06 12:53:28 UTC
In Glance's newest API versions, the `copy-from` functionality doesn't exist anymore. Therefore, I think this should be documented as the version 1 of the API is under support mode only.

The upstream team is working hard on moving away from v1. If there are no objections, I'll proceed to move this bug under docs.

Comment 4 Sergey Gotliv 2016-01-24 09:07:45 UTC
Flavio,

Support case is already closed, let's move that BZ to docs.

Comment 5 Andrew Dahms 2016-05-04 22:45:45 UTC
Assigning to Deepti for review.

Deepti - looks like we need to add some guidance around the version of the API to which this command belongs, and possibly look into how this is handled in later versions of the API.

Comment 18 Martin Lopes 2016-11-04 05:11:32 UTC
Finished docs QE, looks good to me.

Comment 19 Deepti Navale 2016-11-04 05:39:59 UTC
Changing to VERIFIED as per comment 18.

Comment 20 Deepti Navale 2016-11-04 06:06:27 UTC
Updated guides are now available on the Customer portal:

CLI Ref - Includes a note to indicate that '--copy-from' option is deprecated for glance v2 API for OSP8 and v1 as well for future releases:

https://access.redhat.com/documentation/en/red-hat-openstack-platform/8/single/command-line-interface-reference/#glanceclient_subcommand_image-create_v1

and 

https://access.redhat.com/documentation/en/red-hat-openstack-platform/8/single/command-line-interface-reference/#glanceclient_subcommand_image-update_v1

Config Ref - Updated a command that used the '--copy-from' option to use the '--os-image-api-version 1' option:

https://access.redhat.com/documentation/en/red-hat-openstack-platform/8/single/configuration-reference/#iso-support

Changing status to CLOSED-CURRENT RELEASE


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