Bug 1043235 - Section 5.4 "guestfish" refers to non-existent package "guestfish"
Summary: Section 5.4 "guestfish" refers to non-existent package "guestfish"
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise Linux 6
Classification: Red Hat
Component: doc-Virtualization_Getting_Started_Guide
Version: 6.5
Hardware: Unspecified
OS: Unspecified
unspecified
low
Target Milestone: rc
: ---
Assignee: Scott Radvan
QA Contact: ecs-bugs
URL:
Whiteboard:
Depends On:
Blocks: 1093568
TreeView+ depends on / blocked
 
Reported: 2013-12-15 09:30 UTC by Robert P. J. Day
Modified: 2015-04-07 03:21 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
: 1093568 (view as bug list)
Environment:
Last Closed: 2014-10-16 01:03:08 UTC
Target Upstream Version:


Attachments (Terms of Use)

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/.


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