openstack/openstack-manuals
Code Issues Proposed changes
d8e455ff0d
openstack-manuals/doc/image-guide/source/create-images-manually-example-windows-image.rst
Francesco Di Nucci 78179a67bf docs: review manual image creation 
* Add TOCs
* Divide Examples and Tools (make it easier to add others such as VBox,
	VMware etc.)
* Merge all libvirt related content as a tool
* Modify headers as per Contributor Guide [1]
* Move pages to clarify hierarchy
Note: further work will be needed to update examples

[1] https://docs.openstack.org/doc-contrib-guide/rst-conv/titles.html

Change-Id: I78970ef578020c7df7e35ca59a1c7b8aed19bb6f
2024-07-11 13:25:37 +02:00

3.6 KiB
Raw Blame History

Example: Microsoft Windows image

depth

2

This example creates a Windows Server 2012 qcow2 image, using the virt-install command and the KVM hypervisor.

Prerequisites

  1. Follow these steps to prepare the installation:

    1. Download a Windows Server 2012 installation ISO. Evaluation images are available on the Microsoft website <http://www.microsoft.com/en-us/evalcenter/ evaluate-windows-server-2012> (registration required).

    2. Download the signed VirtIO drivers ISO from the Fedora website.

    3. Create a 15 GB qcow2 image:

      $ qemu-img create -f qcow2 ws2012.qcow2 15G

Installation

  1. Start the Windows Server 2012 installation with the virt-install command:

    # virt-install --connect qemu:///system \
  --name ws2012 --ram 2048 --vcpus 2 \
  --network network=default,model=virtio \
  --disk path=ws2012.qcow2,format=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 win2k12 \
  --os-distro windows --os-version 2012

    Use virt-manager or virt-viewer to connect to the VM and start the Windows installation.

  2. Enable the VirtIO drivers. By default, the Windows installer does not detect the disk.

  3. Load VirtIO SCSI drivers and network drivers by choosing an installation target when prompted. Click Load driver and browse the file system.

  4. Select the E:\virtio-win-0.1XX\viostor\2k12\amd64 folder. The Windows installer displays a list of drivers to install.

  5. Select the VirtIO SCSI drivers.

  6. Click Load driver and browse the file system, and select the E:\NETKVM\2k12\amd64 folder.

  7. Select the network drivers, and continue the installation. Once the installation is completed, the VM restarts.

  8. Define a password for the administrator when prompted.

  9. Log in as administrator and start a command window.

  10. Complete the VirtIO drivers installation by running the following command:

    C:\pnputil -i -a E:\virtio-win-0.1XX\viostor\2k12\amd64\*.INF

  11. To allow the Cloudbase-Init to run scripts during an instance boot, set the PowerShell execution policy to be unrestricted:

    C:\powershell
C:\Set-ExecutionPolicy Unrestricted

  12. Download and install the Cloudbase-Init:

    C:\Invoke-WebRequest -UseBasicParsing https://cloudbase.it/downloads/CloudbaseInitSetup_Stable_x64.msi -OutFile cloudbaseinit.msi
C:\.\cloudbaseinit.msi

    In the configuration options window, change the following settings:

    • Username: Administrator
    • Network adapter to configure: Red Hat VirtIO Ethernet Adapter
    • Serial port for logging: COM1

    When the installation is done, in the Complete the Cloudbase-Init Setup Wizard window, select the Run Sysprep and Shutdown check boxes and click Finish.

    Wait for the machine shutdown.

Image ready

Your image is ready to upload to the Image service:

$ openstack image create --disk-format qcow2 --file ws2012.qcow2 WS2012