Bug 627468

Summary: [RFE]It's better to emphasize "libguestfs-winsupport" in V2V manpage or error output
Product: Red Hat Enterprise Linux 6 Reporter: Rita Wu <rwu>
Component: libguestfsAssignee: Richard W.M. Jones <rjones>
Status: CLOSED ERRATA QA Contact: Virtualization Bugs <virt-bugs>
Severity: medium Docs Contact:
Priority: low    
Version: 6.1CC: cwei, dallan, mshao
Target Milestone: rcKeywords: FutureFeature
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: libguestfs-1.7.17-8.el6 Doc Type: Enhancement
Doc Text:
The virt-inspector and virt-v2v tools did not work for Windows guests if an an additional package, libguestfs-winsupport, was not installed. The error message did not explicitly state that this missing package could be responsible for the error. An additional note has been added to make the error output more useful when attempting to use these tools with Windows guests.
Story Points: ---
Clone Of:
: 889536 (view as bug list) Environment:
Last Closed: 2011-05-19 11:45:32 UTC Type: ---
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: 889536    

Description Rita Wu 2010-08-26 06:28:47 UTC
Description of problem:

Although document has mentioned that "Ensure that the libguestfs-winsupport package is installed on the host running virt-v2v", is it possible for v2v to output something like that in its error output, or in v2v's manpage?

For currently, we could only get "...because the OS type is not understood by virt-inspector", but I guess we cannot expect users know what OS type can be understood by virt-inspector directly.


Version-Release number of selected component (if applicable):
virt-v2v-0.6.2-3.el6.x86_64

How reproducible:
always

Steps to Reproduce:
1. Make sure there is no intalled libguestfs-winsupport 
2. # virt-v2v -ic xen+ssh://10.66.xx.xx -o rhev -osd 10.66.90.xx:/vol/v2vrwu2/esx_export win2k3-32bit-raw
root.93.xx's password: 
root.93.xx's password: 
No operating system could be detected inside this disk image.

This may be because the file is not a disk image, or is not a virtual machine
image, or because the OS type is not understood by virt-inspector.

If you feel this is an error, please file a bug report including as much
information about the disk image as possible.
  
Actual results:
implicit manpage and error output

Expected results:
explicit manpage and error output


Additional info:

Comment 2 Richard W.M. Jones 2010-08-26 08:59:09 UTC
What's needed here is to change the inspection code so that:
if vfs_type is NTFS and NTFS is not available in the appliance
we print a better error message, telling people that NTFS support
is missing, and that one way to get this is to install libguestfs-
winsupport on RHEL 6.

Comment 3 Richard W.M. Jones 2010-08-26 09:08:46 UTC
Setting target to 6.1.

Comment 4 Richard W.M. Jones 2011-01-10 16:58:09 UTC
The revised error message says:

 No operating system could be detected inside this disk image.
    
 This may be because the file is not a disk image, or is not a virtual machine
 image, or because the OS type is not understood by virt-inspector.
    
 If you feel this is an error, please file a bug report including as much
 information about the disk image as possible.
    
 RHEL 6 notice
 -------------
 libguestfs will return this error for Microsoft Windows guests if the
 separate 'libguestfs-winsupport' package is not installed. If the
 guest is running Microsoft Windows, please try again after installing
 'libguestfs-winsupport'.

Comment 6 Rita Wu 2011-02-16 07:27:01 UTC
Verified with the following pkgs:


libguestfs-1.7.17-12.el6.x86_64
libguestfs-*-1.7.17-12.el6.x86_64
febootstrap-2.11-6.el6.x86_64
hivex-1.2.4-3.el6.x86_64
augeas-libs-0.7.2-4.el6.x86_64
virtio-win-1.1.16-1.el6.noarch


When libguestfs-winsupport pkg isn't installed, more clearer error msg will pop up: 
# rpm -e libguestfs-winsupport-1.0-5.el6.x86_64
# virt-v2v -ic xen+ssh://10.66.72.xxx -o rhev -osd 10.66.90.xxx:/vol/v2vrwu1/xen_export win7-32b-hv-raw-intel
win7-i386-xen.img: 100% [============================================]D 0h04m30s
No operating system could be detected inside this disk image.

This may be because the file is not a disk image, or is not a virtual machine
image, or because the OS type is not understood by virt-inspector.

If you feel this is an error, please file a bug report including as much
information about the disk image as possible.

RHEL 6 notice
-------------
libguestfs will return this error for Microsoft Windows guests if the
separate 'libguestfs-winsupport' package is not installed. If the
guest is running Microsoft Windows, please try again after installing
'libguestfs-winsupport'.

Comment 9 Laura Bailey 2011-04-19 01:16:07 UTC
    Technical note added. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    New Contents:
The virt-inspector and virt-v2v tools did not work for Windows guests without an additional package, libguestfs-winsupport, being installed. The error message did not explicitly state that this missing package could be responsible for the error. An additional note has been added to make the error output more useful for Windows guests.

Comment 10 Laura Bailey 2011-04-19 01:17:40 UTC
    Technical note updated. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    Diffed Contents:
@@ -1 +1 @@
-The virt-inspector and virt-v2v tools did not work for Windows guests without an additional package, libguestfs-winsupport, being installed. The error message did not explicitly state that this missing package could be responsible for the error. An additional note has been added to make the error output more useful for Windows guests.+The virt-inspector and virt-v2v tools did not work for Windows guests if an an additional package, libguestfs-winsupport, was not installed. The error message did not explicitly state that this missing package could be responsible for the error. An additional note has been added to make the error output more useful when attempting to use these tools with Windows guests.

Comment 11 Richard W.M. Jones 2011-04-19 07:38:19 UTC
New text is fine, thanks.

Comment 12 errata-xmlrpc 2011-05-19 11:45:32 UTC
An advisory has been issued which should help the problem
described in this bug report. This report is therefore being
closed with a resolution of ERRATA. For more information
on therefore solution and/or where to find the updated files,
please follow the link below. You may reopen this bug report
if the solution does not work for you.

http://rhn.redhat.com/errata/RHSA-2011-0586.html

Comment 13 errata-xmlrpc 2011-05-19 13:10:24 UTC
An advisory has been issued which should help the problem
described in this bug report. This report is therefore being
closed with a resolution of ERRATA. For more information
on therefore solution and/or where to find the updated files,
please follow the link below. You may reopen this bug report
if the solution does not work for you.

http://rhn.redhat.com/errata/RHSA-2011-0586.html