6363dffee3
This patch prepends a guide for building Windows images for KVM OpenStack to the guide and retains the previous notes at the bottom of the doc. Change-Id: I029a428055dab59ec0a09b12933d38cd4d209bc1
106 lines
4.9 KiB
XML
106 lines
4.9 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE chapter [
|
|
<!ENTITY % openstack SYSTEM "../common/entities/openstack.ent">
|
|
%openstack;
|
|
]>
|
|
<section xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
|
version="5.0"
|
|
xml:id="windows-image">
|
|
<title>Example: Microsoft Windows image</title>
|
|
<para>This example creates a Windows Server 2012 qcow2 image, using
|
|
<command>virt-install</command> and the KVM hypervisor.</para>
|
|
|
|
<procedure>
|
|
<step>
|
|
<para>Follow this steps to prepare the installation:</para>
|
|
<substeps>
|
|
<step>
|
|
<para>Download a Windows Server 2012 installation ISO. Evaluation
|
|
images are available on <link
|
|
xlink:href="http://www.microsoft.com/en-us/evalcenter/evaluate-windows-server-2012">the
|
|
Microsoft website</link> (registration required).</para>
|
|
</step>
|
|
<step>
|
|
<para>Download the signed VirtIO drivers ISO from the <link
|
|
xlink:href="http://alt.fedoraproject.org/pub/alt/virtio-win/latest/images/">Fedora
|
|
website</link>.</para>
|
|
</step>
|
|
<step>
|
|
<para>Create a 10 GB qcow2 image:</para>
|
|
<screen><prompt>$</prompt> <userinput>qemu-img create -f qcow2 ws2012.qcow2 10G</userinput></screen>
|
|
</step>
|
|
</substeps>
|
|
</step>
|
|
<step>
|
|
<para>Start the Windows Server 2012 installation with the
|
|
<command>virt-install</command> command:</para>
|
|
<screen><prompt>#</prompt> <userinput>virt-install --connect qemu:///system \
|
|
--name ws2012 --ram 2048 --vcpus 2 \
|
|
--network network=default,model=virtio \
|
|
--disk path=ws2012.qcow2,device=disk,bus=virtio \
|
|
--cdrom /path/to/en_windows_server_2012_x64_dvd.iso \
|
|
--disk path=/path/to/virtio-win-0.1-XX.iso,device=cdrom \
|
|
--vnc --os-type windows --os-variant win2k8</userinput></screen>
|
|
<para>Use <command>virt-manager</command> or
|
|
<command>virt-viewer</command> to connect to the VM and start the
|
|
Windows installation.</para>
|
|
</step>
|
|
<step>
|
|
<para>Enable the VirtIO drivers.</para>
|
|
<para>The disk is not detected by default by the Windows installer. When
|
|
requested to choose an installation target, click <guibutton>Load
|
|
driver</guibutton> and browse the file system to select the
|
|
<filename>E:\WIN8\AMD64</filename> folder. The Windows installer
|
|
displays a list of drivers to install. Select the VirtIO SCSI and
|
|
network drivers, and continue the installation.</para>
|
|
<para>Once the installation is completed, the VM restarts. Define a
|
|
password for the administrator when prompted.</para>
|
|
</step>
|
|
<step>
|
|
<para>Log in as administrator and start a command window.</para>
|
|
</step>
|
|
<step>
|
|
<para>Complete the VirtIO drivers installation by running the
|
|
following command:</para>
|
|
<screen><prompt>C:\</prompt><userinput>pnputil -i -a E:\WIN8\AMD64\*.INF</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>To allow <glossterm>Cloudbase-Init</glossterm> to run scripts
|
|
during an instance boot, set the PowerShell execution policy to be
|
|
unrestricted:</para>
|
|
<screen><prompt>C:\</prompt><userinput>powershell</userinput>
|
|
<prompt>C:\</prompt><userinput>Set-ExecutionPolicy Unrestricted</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>Download and install Cloudbase-Init:</para>
|
|
<screen><prompt>C:\</prompt><userinput>Invoke-WebRequest -UseBasicParsing http://www.cloudbase.it/downloads/CloudbaseInitSetup_Beta_x64.msi -OutFile cloudbaseinit.msi</userinput>
|
|
<prompt>C:\</prompt><userinput>.\cloudbaseinit.msi</userinput></screen>
|
|
<para>In the <guilabel>configuration options</guilabel> window, change the following settings:</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Username: <literal>Administrator</literal></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Network adapter to configure:
|
|
<literal>Red Hat VirtIO Ethernet Adapter</literal></para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Serial port for logging: <literal>COM1</literal></para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>When the installation is done, in the <guilabel>Complete the
|
|
Cloudbase-Init Setup Wizard</guilabel> window, select the
|
|
<guilabel>Run Sysprep</guilabel> and <guilabel>Shutdown</guilabel>
|
|
check boxes and click <guibutton>Finish</guibutton>.</para>
|
|
<para>Wait for the machine shutdown.</para>
|
|
</step>
|
|
</procedure>
|
|
|
|
<para>Your image is ready to upload to the Image Service:</para>
|
|
<screen><prompt>$</prompt> <userinput>glance image-create --name WS2012 --disk-format qcow2 \
|
|
--container-format bare --is-public \
|
|
--file ws2012.qcow2</userinput></screen>
|
|
</section>
|