Launch Windows as the Guest VM on ACRN¶
This tutorial describes how to launch Windows as a Guest (WaaG) VM on the ACRN hypervisor.
ACRN Service VM Setup¶
Follow the steps in this Getting Started Guide for ACRN Industry Scenario with Ubuntu Service VM to set up ACRN based on Ubuntu and launch the Service VM.
Setup for Using Windows as the Guest VM¶
In the following steps, you’ll first create a Windows image in the Service VM, and then launch that image as a Guest VM.
- Windows 10 Version:
- Microsoft Windows 10 Enterprise, 10.0.17134 Build 17134
- Microsoft Windows 10 Enterprise LTSC Evaluation, 10.0.17763 Build 17763
- Windows graphics driver:
Create a Windows 10 image in the Service VM¶
Create a Windows 10 image to install Windows 10 onto a virtual disk.
Download Win10 ISO and drivers¶
- Download Windows 10 LTSC ISO.
- Select ISO-LTSC and click Continue.
- Complete the required info. Click Continue.
- Select the language and x86 64-bit. Click Download ISO and save as
- Download the Intel DCH Graphics Driver.
- Download the Oracle Windows driver.
- Sign in. If you do not have an Oracle account, register for one.
- Select Download Package. Key in Oracle Linux 7.6 and click Search.
- Click DLP: Oracle Linux 7.6 to add to your Cart.
- Click Checkout, which is located at the top-right corner.
- Under Platforms/Language, select x86 64-bit. Click Continue.
- Check I accept the terms in the license agreement. Click Continue.
- From the list, right check the item labeled Oracle VirtIO Drivers
Version for Microsoft Windows 1.x.x, yy MB, and then Save link as
…. Currently, it is named
- Click Download. When the download is complete, unzip the file. You
will see an ISO named
Create a raw disk¶
Run these commands on the Service VM:
$ sudo apt-get install qemu-utils $ mkdir /home/acrn/img $ cd /home/acrn/img $ qemu-img create -f raw win10-ltsc.img 30G
Prepare the script to create an image¶
$ cp /usr/share/acrn/samples/nuc/launch_win.sh /home/acrn/img/install_win.sh
acrn-dmcommand line in
Make sure you use GVT-g
-s 2,pci-gvt -G "$2"in the
acrn-dmcommand line. Currently, we do not support creating a windows image by GVT-d.
-s 3,virtio-blk,./win10-ltsc.imgto your path to the Windows 10 image.
-s 6,xhci,1-5:1-9. You may need to change 1-5:1-9 to match the ports of the USB keyboard/mouse and flash on your platform.
-s 8,ahci,cd:./windows10-LTSC-17763.isoto point to the Win10 ISO.
-s 9,ahci,cd:./winvirtio.isoto point to your path to the winvirtio iso.
Install Windows 10 by GVT-g¶
Make sure you have configured your monitor and display according to 3 of Boot Windows with GVT-g on ACRN.
install_win.sh. When you see the UEFI shell, input exit.
Select Boot Manager and boot from Win10 ISO.
When the display reads Press any key to boot from CD or DVD on the monitor, press any key in the terminal on the Host side.
Click Load driver.
Click Browser and go to the drive that includes the virtio Windows drivers. Select all under vio\w10\amd64. Install the following drivers into the image:
Be sure to unselect Hide Drivers that aren’t compatible with this computer’s hardware near the bottom of the page.
Continue with the installation.
Verify that the system restarts.
Configure your system when Windows completes its restart cycle.
Verify that the Windows desktop displays after the Windows installation is complete.
Copy the Intel DCH Graphics Driver into Windows and install in safe mode. The display driver is updated to 7212.
Boot Windows on ACRN with a default configuration¶
/usr/share/acrn/samples/nuc/launch_win.shscript to specify the Windows image that is generated above.
launch_win.sh. The WaaG desktop displays on the HDMI monitor.
We support GVT-g and GVT-d while launching Windows guest. If you use GVT-g, you can set up Weston in the Service VM, and set up Weston as the desktop environment in the Service VM in order to experience Windows with the AcrnGT local display feature. If you use GVT-d, set DVMT Pre-Allocated to 64MB and set PM Support to Enabled in the BIOS. Then, only Windows displays.
ACRN Windows verified feature list¶
|IO Devices||Virtio block as the boot device||Working|
|AHCI as the boot device||Working|
|Virtio input - mouse||Working|
|Virtio input - keyboard||Working|
|GVT-g GOP & VNC remote display||Working|
|GVT-g||GVT-g without local display||Working with 3D benchmark|
|GVT-g with local display||Working with 3D benchmark|
|GVT-d||GVT-d with local display||Working|
|Test cases||Install Windows 10 from scratch||OK|
|Built-in Apps||Microsoft Edge||OK|
- The cursor is not visible with the GVT-g local display.
Explanation for acrn-dm popular command lines¶
Use these acrn-dm command line entries according to your real requirements.
-s 2,passthru,0/2/0,gpu: This is GVT-d to passthrough the VGA controller to Windows. You may need to change 0/2/0 to match the bdf of the VGA controller on your platform.
-s 3,ahci,hd:/root/img/win10.img: This is the hard disk where Windows 10 should be installed.. Make sure that the slot ID 3 points to your win10 img path.
-s 4,virtio-net,tap0: This is for the network virtualization.
-s 5,fbuf,tcp=0.0.0.0:5900,w=800,h=600: This opens port 5900 on the Service VM, which can be connected to via
-s 6,virtio-input,/dev/input/event4: This is to passthrough the mouse/keyboard to Windows via virtio. Change
event4accordingly. Use the following command to check the event node on your Service VM:
<To get the input event of mouse> # cat /proc/bus/input/devices | grep mouse
-s 7,ahci,cd:/root/img/Windows10.iso: This is the IOS image used to install Windows 10. It appears as a CD-ROM device. Make sure that the slot ID 7 points to your win10 ISO path.
-s 8,ahci,cd:/root/img/winvirtio.iso: This is CD-ROM device to install the virtio Windows driver. Make sure it points to your VirtIO ISO path.
-s 9,passthru,0/14/0: This is to passthrough the USB controller to Windows. You may need to change
0/14/0to match the BDF of the USB controller on your platform.
--ovmf /usr/share/acrn/bios/OVMF.fd: Make sure it points to your OVMF binary path.
Activate Windows 10¶
If you use a trial version of Windows 10, you might find that some apps and features do not work or that Windows 10 automatically gets shut down by the Windows licensing monitoring service. To avoid these issues, obtain a licensed version of Windows.
For Windows 10 activation steps, refer to Activate Windows 10.