Red Hat Bugzilla – Bug 627468
[RFE]It's better to emphasize "libguestfs-winsupport" in V2V manpage or error output
Last modified: 2015-09-27 22:31:42 EDT
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@10.66.93.xx's password: root@10.66.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:
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.
Setting target to 6.1.
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'.
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'.
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.
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.
New text is fine, thanks.
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