Bug 1057181

Summary:	Outdated information in Section 8.3. Preparing Hypervisor Installation Media
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Matt Reid <mreid>
Component:	Documentation	Assignee:	Andrew Dahms <adahms>
Status:	CLOSED CURRENTRELEASE	QA Contact:	ecs-bugs
Severity:	high	Docs Contact:
Priority:	unspecified
Version:	3.3.0	CC:	fdeutsch, gklein, jbiddle, mreid, rbalakri, sclark, yeylon
Target Milestone:	---
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2014-09-19 01:32:32 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:
Bug Depends On:
Bug Blocks:	1099562

Description Matt Reid 2014-01-23 15:21:58 UTC

Title: Preparing USB Installation Media Using livecd-iso-to-disk

Describe the issue:
The information contained in 8.3.1.2 is no longer correct. The summary reads:
"The livecd-iso-to-disk command will install a Hypervisor onto a USB storage device. The livecd-iso-to-disk command is included in the rhev-hypervisor-tools package. Devices which have the Hypervisor image written to them with this command are able to boot the Hypervisor on systems which support booting via USB."

There is no such package anymore as rhev-hypervisor-tools. The livecd-iso-to-disk command is contained in livecd-tools, which should be installed according to the previous section.

I was linked to 8.1.3 from https://access.redhat.com/site/articles/438763
which bypassed the section that mentioned I had to install livecd-tools. I spent awhile trying to figure out why I didn't seem to have access to the rhev-hypervisor-tools package that contained the command I needed to proceed with my installation and had to ask a developer for help. 


Suggestions for improvement:
This section should be updated to say that the livecd-iso-to-disk command is contained in the livecd-tools package.

And it would be useful to update the https://access.redhat.com/site/articles/438763 to either mention which packages need to be installed to set up the hypervisor, or possibly have it link to the previous section, so they know they aren't missing any packages and don't hit the same issue I did.


Additional information:.
This affects the 3.2 version of the Install guide as well (that's the version I was looking at, but it's still present in the most current version).

Comment 1 Andrew Dahms 2014-02-13 23:51:21 UTC

Documentation Link
------------------------------
http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.3/html-single/Installation_Guide/index.html#Preparing_USB_Installation_Media_using_rhevh-iso-to-disk

What Changed
------------------------------
The following topic was revised to change the package name 'rhev-hypervisor-tools' to 'livecd-tools'.

Preparing USB Installation Media Using livecd-iso-to-disk [ 7527-588858 ]

Updated revision history [ 21134-588876 ]

NVR
------------------------------
Red_Hat_Enterprise_Virtualization-Installation_Guide-3.3-en-US-3.3-36

Comments
------------------------------
I will also follow up on the customer portal link and see if it is possible to introduce the change there as well.

Moving to ON_QA.

Comment 2 Jodi Biddle 2014-07-14 14:53:43 UTC

Hi Matt

Can you please provide quick QE on this bug at the above link, and if it's fixed to your satisfaction, can you change the bug status to verified? Thanks

Comment 3 Matt Reid 2014-07-14 15:50:45 UTC

Looks good to me, although the change may have already been pulled in? I'm not noticing any difference between the docbuilder version for that section, and what's in the 3.3/3.4 guide on Portal. The 3.2 version says the wrong thing, but livecd-tools is mentioned in "8.3.1.2. Preparing USB Installation Media Using livecd-iso-to-disk" of the 3.3 guide.

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.3/html-single/Installation_Guide/index.html#Preparing_USB_Installation_Media_using_rhevh-iso-to-disk

Comment 4 Jodi Biddle 2014-07-14 23:37:18 UTC

Unfortunately we don't usually have the resources to backport more than once or twice per release, and never to older guides unless it's a critical issue or a particular customer complaint. 

I'll move this conversation to email and loop in Brett to find out more about your intentions for the review.