[Pkg-libvirt-commits] [libguestfs] 59/146: v2v: Add documentation about what to do about BSOD 0x0000007B (RHBZ#1161333).

[Hilko Bengen]

This is an automated email from the git hooks/post-receive script.

bengen pushed a commit to branch master
in repository libguestfs.

commit 97b20fe383603c1135550decf557774d94c0f712
Author: Richard W.M. Jones <rjones at redhat.com>
Date:   Fri Dec 5 15:04:03 2014 +0000

    v2v: Add documentation about what to do about BSOD 0x0000007B (RHBZ#1161333).
    
    After a very long and trying episode with a Windows guest that refused
    to boot after conversion, we managed to successfully boot it by
    disabling Windows Group Policy.  It appears that Group Policy
    prevented the virtio driver from being used.
    
    Document this in the manual.
    
    (cherry picked from commit be73b1750f3ce52ea137014083ed51d3b64f53a5)
---
 v2v/virt-v2v.pod | 59 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)

diff --git a/v2v/virt-v2v.pod b/v2v/virt-v2v.pod
index ed354a8..f075274 100644
--- a/v2v/virt-v2v.pod
+++ b/v2v/virt-v2v.pod
@@ -225,6 +225,9 @@ L<https://en.wikipedia.org/wiki/List_of_Microsoft_Windows_versions>
 Currently only NT 5.2 to NT 6.1 are supported, with support for later
 versions planned soon.
 
+See L</WINDOWS> below for additional notes on converting Windows
+guests.
+
 =back
 
 =head1 OPTIONS
@@ -706,6 +709,62 @@ below.
  Windows        Drivers are installed from /usr/share/virtio-win
                 if present
 
+=head1 WINDOWS
+
+=head2 Boot failure: 0x0000007B
+
+This boot failure is caused by Windows being unable to find or load
+the right disk driver (eg. C<viostor.sys>).  If you experience this
+error, here are some things to check:
+
+=over 4
+
+=item *
+
+First ensure that the guest boots on the source hypervisor before
+conversion.
+
+=item *
+
+Check you have the Windows virtio drivers available in
+C</usr/share/virtio-win>, and that virt-v2v did not print any warning
+about not being able to install virtio drivers.
+
+On S<Red Hat Enterprise Linux 7>, you will need to install the signed
+drivers available in the C<virtio-win> package.  If you do not have
+access to the signed drivers, then you will probably need to disable
+driver signing in the boot menus.
+
+=item *
+
+Check that you are presenting a virtio-blk interface (B<not>
+virtio-scsi and B<not> ide) to the guest.  On the qemu/KVM command
+line you should see something similar to this:
+
+ ... -drive file=windows-sda,if=virtio ...
+
+In libvirt XML, you should see:
+
+ <target dev='vda' bus='virtio'/>
+
+=item *
+
+Check that Windows Group Policy does not prevent the driver from being
+installed or used.  Try deleting Windows Group Policy before
+conversion.
+
+=item *
+
+Check there is no anti-virus or other software which implements Group
+Policy-like prohibitions on installing or using new drivers.
+
+=item *
+
+Enable boot debugging and check the C<viostor.sys> driver is being
+loaded.
+
+=back
+
 =head1 NETWORKS AND BRIDGES
 
 Guests are usually connected to one or more networks, and when

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-libvirt/libguestfs.git