RHEL Engineering is moving the tracking of its product development work on RHEL 6 through RHEL 9 to Red Hat Jira (issues.redhat.com). If you're a Red Hat customer, please continue to file support cases via the Red Hat customer portal. If you're not, please head to the "RHEL project" in Red Hat Jira and file new tickets here. Individual Bugzilla bugs in the statuses "NEW", "ASSIGNED", and "POST" are being migrated throughout September 2023. Bugs of Red Hat partners with an assigned Engineering Partner Manager (EPM) are migrated in late September as per pre-agreed dates. Bugs against components "kernel", "kernel-rt", and "kpatch" are only migrated if still in "NEW" or "ASSIGNED". If you cannot log in to RH Jira, please consult article #7032570. That failing, please send an e-mail to the RH Jira admins at rh-issues@redhat.com to troubleshoot your issue as a user management inquiry. The email creates a ServiceNow ticket with Red Hat. Individual Bugzilla bugs that are migrated will be moved to status "CLOSED", resolution "MIGRATED", and set with "MigratedToJIRA" in "Keywords". The link to the successor Jira issue will be found under "Links", have a little "two-footprint" icon next to it, and direct you to the "RHEL project" in Red Hat Jira (issue links are of type "https://issues.redhat.com/browse/RHEL-XXXX", where "X" is a digit). This same link will be available in a blue banner at the top of the page informing you that that bug has been migrated.
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:
Embargoed:

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.