Bug 1043235

Summary:	Section 5.4 "guestfish" refers to non-existent package "guestfish"
Product:	Red Hat Enterprise Linux 6	Reporter:	Robert P. J. Day <rpjday>
Component:	doc-Virtualization_Getting_Started_Guide	Assignee:	Scott Radvan <sradvan>
Status:	CLOSED CURRENTRELEASE	QA Contact:	ecs-bugs
Severity:	low	Docs Contact:
Priority:	unspecified
Version:	6.5	CC:	lnovich, ptoscano, rjones, rlandman
Target Milestone:	rc	Keywords:	Documentation
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:
Clones:	1093568 (view as bug list)		Environment:
Last Closed:	2014-10-16 01:03:08 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:	1093568

Description Robert P. J. Day 2013-12-15 09:30:32 UTC

Here:

https://access.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Linux/6/html/Virtualization_Getting_Started_Guide/ch05s04.html

one reads:

"guestfish is a command line tool for examining and modifying the file systems of the host. This tool uses libguestfs and exposes all functionality provided by the guestfs API. This tool ships in its own package entitled guestfish."

  First, it seems that the guestfish executable ships in the libguestfs-tools-c package -- yum doesn't show any package named "guestfish".

  Also, isn't that command for working with the filesystems of a *guest*, not the *host*? Or am I misreading this?

  I believe all of this applies to the RHEL 7 Beta doc as well.

Comment 1 Robert P. J. Day 2013-12-15 17:54:49 UTC

An additional note for the same document -- section 1.4 doesn't appear to list the RHEV "Hypervisor Deployment Guide" in the list of RHEV docs.

Comment 2 Robert P. J. Day 2013-12-15 18:14:48 UTC

I might as well add a more generic comment here, and you can do with it what you wish. Throughout the GSG, while there are numerous mentions of "hypervisor", it's never really defined clearly *what* part of the software stack represents the hypervisor.

Is it KVM? Is it QEMU? Is it the combination of the two? I think it would be tremendously useful to, very early, explain to the reader exactly what constitutes the hypervisor in this context.

Comment 3 Robert P. J. Day 2013-12-15 18:18:47 UTC

(In reply to Robert P. J. Day from comment #1)
> An additional note for the same document -- section 1.4 doesn't appear to
> list the RHEV "Hypervisor Deployment Guide" in the list of RHEV docs.

Crap, didn't notice that there is also no reference to the RHEV "V2V" Guide.

Comment 4 Robert P. J. Day 2013-12-15 19:07:38 UTC

OK, final set of comments on RHEL 6.5 Virt Getting Started Guide, if luck is on my side.

* Section 1.3, first hyperlink to RHEV page actually now redirects to a cloud-computing subpage -- I think all links should link directly to their final page, but that's just me.

* Section 4.2, "libvirt and libvirt tools", I was checking dependencies and noticed:

  # rpm -q --whatrequires libvirt
  no package requires libvirt
  #

I found this surprising -- checking further, it *seems* that this is because there are various implementations of that layer that could be used, but it might be confusing for people to read that "The libvirt package is designed as a building block for higher level management tools and applications" only to perhaps notice that no other package seems to depend on it. Perhaps a line or two expanding on that, if it's worth it?

  I *think* that's it but no guarantees ...

Comment 5 Robert P. J. Day 2013-12-15 22:44:27 UTC

OK, I lied ... Section 5.5, same doc, suggests that "guestmount" is part of package "libguestfs-mount" -- it appears to be part of libguestfs-tools-c, so you might want to check that entire section to make sure package references are correct. Oh, and some of those commands are part of libguestfs-tools as well.

Comment 7 Dayle Parker 2014-05-02 05:52:33 UTC

Hi Robert,

Thank you for the feedback. I've cloned this bug for the RHEL7 version of the guide, and will include this bug in the to-fix list for the RHEL6.6 Virt Getting Started Guide. Please let me know if you come across anything else needing attention in the guide.

Cheers,
Dayle

Comment 20 Dayle Parker 2014-10-16 01:03:08 UTC

This change is now available in the Red Hat Enterprise Linux 6.6 documentation at https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/.