Bug 1294099

Summary:	[Docs] [Glance] When importing an big image in glance with --copy-from, image corruption happens
Product:	Red Hat OpenStack	Reporter:	David Hill <dhill>
Component:	documentation	Assignee:	Deepti Navale <dnavale>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Martin Lopes <mlopes>
Severity:	low	Docs Contact:
Priority:	medium
Version:	1.0 (Essex)	CC:	adahms, dhill, dnavale, eglynn, fpercoco, jruzicka, lbopf, mburns, mlopes, rbiba, sgotliv, srevivo
Target Milestone:	async	Keywords:	Documentation, Triaged, ZStream
Target Release:	7.0 (Kilo)
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2016-11-04 06:06:27 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:

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