From 8f703276df07d7581b688d36b1e08ce8b8089ca0 Mon Sep 17 00:00:00 2001
From: Shuquan Huang <huang.shuquan@99cloud.net>
Date: Fri, 28 Aug 2015 15:14:42 +0000
Subject: [PATCH] Add an admonition about converting windows VM from vmdk to
 qcow2

In "7. Converting between image formats", people should know if
they convert windows VM, they should take care of the virtio driver.
Otherwise, they will get a blue screen when launching the VM without
installing virtio driver. Or you can set the hw_disk_bus image property
to ide which will avoid this issue, but it will have an significant
cost to performance.

Change-Id: I42e8e71b9c92d7a4514973aafdfcf50876b1758b
Closes-Bug: #1481229
---
 doc/image-guide/ch_converting.xml | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/doc/image-guide/ch_converting.xml b/doc/image-guide/ch_converting.xml
index 93b86ad6a3..1f367fab83 100644
--- a/doc/image-guide/ch_converting.xml
+++ b/doc/image-guide/ch_converting.xml
@@ -61,6 +61,12 @@
             <note>
                 <para>The <literal>-f <replaceable>format</replaceable></literal> flag is optional.
                     If omitted, <command>qemu-img</command> will try to infer the image format.</para>
+                <para>When converting an image file with Windows OS, ensure the virtio driver is
+                      installed. Otherwise, you will get a blue screen of death or BSOD when
+                      launching the image due to lack of the virtio driver. Another option is to
+                      set the image properties as below when you update the image in glance to
+                      avoid this issue, but it will reduce performance significantly.</para>
+                <screen><prompt>$</prompt> <userinput>glance image-update --property hw_disk_bus='ide' image_id</userinput></screen>
             </note>
         </para>
     </simplesect>