Bug 1561110

Summary:	[Doc][Sahara] CLI for Plugin-Declared Image Generation
Product:	Red Hat OpenStack	Reporter:	Luigi Toscano <ltoscano>
Component:	documentation	Assignee:	Laura Marsh <lmarsh>
Status:	CLOSED CURRENTRELEASE	QA Contact:	RHOS Documentation Team <rhos-docs>
Severity:	high	Docs Contact:	Laura Marsh <lmarsh>
Priority:	high
Version:	13.0 (Queens)	CC:	dcadzow, lmarsh, srevivo
Target Milestone:	---	Keywords:	Documentation, Triaged
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2019-01-03 16:49:53 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:
Embargoed:

Description Luigi Toscano 2018-03-27 16:00:32 UTC

Description of problem:

Bug #1337661 describes a new way for building Sahara images, in addition to the existing sahara-image-elements command described in 
https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/12/html-single/openstack_data_processing/#createhadoopimg

That section of the documentation should describe also this new way of building images. Relevant details (more will be added):
- the command is sahara-image-pack, provided in the package openstack-sahara-image-pack;
- sahara-image-pack does not create a new disk image like sahara-image-elements, but changes directly the disk image specified as parameter;
- sahara-image-pack does not register the disk image to RHSM, but it assumes that the repositories are already configured. A way to achieve this is the usage of virt-customize (check the upstream documentation)

More details are available in the upstream documentation:
https://docs.openstack.org/sahara/queens/contributor/image-gen.html
(see also the paragraph "Note: In case of a RHEL 7 images...")